- בקשת HTTP
- גוף הבקשה
- גוף התגובה
- PolylineQuality
- PolylineEncoding
- ReferenceRoute
- ExtraComputation
- Route
- RouteLabel
- RouteLeg
- Polyline
- RouteLegStep
- NavigationInstruction
- Maneuver
- RouteLegStepTravelAdvisory
- RouteLegStepLocalizedValues
- RouteLegStepTransitDetails
- TransitStopDetails
- TransitStop
- TransitDetailsLocalizedValues
- LocalizedTime
- TransitLine
- TransitAgency
- TransitVehicle
- TransitVehicleType
- RouteLegTravelAdvisory
- RouteLegLocalizedValues
- StepsOverview
- MultiModalSegment
- Viewport
- RouteLocalizedValues
- PolylineDetails
- FlyoverInfo
- RoadFeatureState
- PolylinePointIndex
- NarrowRoadInfo
- GeocodingResults
- GeocodedWaypoint
הפונקציה מחזירה את המסלול הראשי יחד עם מסלולים חלופיים אופציונליים, בהינתן קבוצה של נקודות ציון סופיות ונקודות ציון ביניים.
הערה: בשיטה הזו צריך לציין מסכת שדות של תשובה בקלט. אפשר לציין את מסכת שדות התגובה באמצעות פרמטר של כתובת URL $fields
או fields
, או באמצעות כותרת HTTP/gRPC X-Goog-FieldMask
(ראו פרמטרים וכותרות של כתובות URL שזמינים). הערך הוא רשימה של נתיבי שדות שמופרדים בפסיקים. כאן אפשר לקרוא תיעוד מפורט על בניית נתיבי השדות.
לדוגמה, בשיטה הזו:
- אנונימיזציה של שדות של כל השדות הזמינים (לבדיקה ידנית):
X-Goog-FieldMask: *
- אנונימיזציה של שדות של משך, מרחק וקו פוליגוני ברמת המסלול (דוגמה להגדרה בסביבת ייצור):
X-Goog-FieldMask: routes.duration,routes.distanceMeters,routes.polyline.encodedPolyline
Google לא ממליצה להשתמש בתו כללי (*
) באנונימיזציה של שדה התגובה, או לציין את האנונימיזציה של השדה ברמה העליונה (routes
), כי:
- בחירה רק של השדות שאתם צריכים עוזרת לשרת שלנו לחסוך במחזורי חישוב, וכך אנחנו יכולים להחזיר לכם את התוצאה עם זמן אחזור נמוך יותר.
- אם בוחרים רק את השדות שצריך בעבודת הייצור, אפשר להבטיח ביצועים יציבים של זמן האחזור. יכול להיות שנוסיף בעתיד עוד שדות תשובה, והשדות החדשים האלה עשויים לדרוש זמן חישוב נוסף. אם בוחרים את כל השדות, או את כל השדות ברמה העליונה, יכול להיות שתהיה ירידה בביצועים כי כל שדה חדש שנוסיף ייכלל אוטומטית בתגובה.
- בחירה רק של השדות שאתם צריכים מובילה לגודל תגובה קטן יותר, ולכן לתפוקת רשת גבוהה יותר.
בקשת HTTP
POST https://routes.googleapis.com/directions/v2:computeRoutes
כתובת ה-URL משתמשת בתחביר של gRPC Transcoding.
גוף הבקשה
גוף הבקשה מכיל נתונים עם המבנה הבא:
ייצוג ב-JSON |
---|
{ "origin": { object ( |
שדות | |
---|---|
origin |
חובה. ציון דרך של המוצא. |
destination |
חובה. נקודת ציון ליעד. |
intermediates[] |
אופציונלי. קבוצה של נקודות ציון לאורך המסלול (לא כולל נקודות קצה), לעצירה או למעבר. יש תמיכה בעד 25 נקודות עצירה במסלול. |
travelMode |
אופציונלי. מציינים את אמצעי התחבורה. |
routingPreference |
אופציונלי. מציין איך לחשב את המסלול. השרת מנסה להשתמש בהעדפת הניתוב שנבחרה כדי לחשב את המסלול. אם העדפת הניתוב מובילה לשגיאה או לזמן אחזור ארוך במיוחד, מוחזרת שגיאה. אפשר לציין את האפשרות הזו רק אם הערך של |
polylineQuality |
אופציונלי. מציין את ההעדפה שלכם לגבי איכות הקו המרובה. |
polylineEncoding |
אופציונלי. מציינת את הקידוד המועדף של הקו המקוקו. |
departureTime |
אופציונלי. שעת היציאה. אם לא מגדירים את הערך הזה, ערך ברירת המחדל הוא הזמן שבו שלחתם את הבקשה. הערה: אפשר לציין הפונקציה משתמשת ב-RFC 3339, והפלט שנוצר תמיד יהיה מנורמל ל-Z וישתמש ב-0, 3, 6 או 9 ספרות חלקיות. אפשר להשתמש גם בהיסטים אחרים מלבד Z. דוגמאות: |
arrivalTime |
אופציונלי. שעת ההגעה. הערה: המערכת מתעלמת מהשדה הזה אם בבקשות מצוין הפונקציה משתמשת ב-RFC 3339, והפלט שנוצר תמיד יהיה מנורמל ל-Z וישתמש ב-0, 3, 6 או 9 ספרות חלקיות. אפשר להשתמש גם בהיסטים אחרים מלבד Z. דוגמאות: |
computeAlternativeRoutes |
אופציונלי. מציין אם לחשב מסלולים חלופיים בנוסף למסלול. לא מוחזרים מסלולים חלופיים לבקשות שכוללות נקודות ציון ביניים. |
routeModifiers |
אופציונלי. קבוצת תנאים שצריך לעמוד בהם, שמשפיעים על אופן חישוב המסלולים. |
languageCode |
אופציונלי. קוד השפה בפורמט BCP-47, כמו en-US או sr-Latn. מידע נוסף זמין במאמר בנושא מזהה של לוקאל ב-Unicode. כאן אפשר לעיין ברשימת השפות הנתמכות. אם לא מספקים את הערך הזה, שפת התצוגה נקבעת לפי המיקום של בקשת המסלול. |
regionCode |
אופציונלי. קוד האזור, שמוגדר כערך של שני תווים של ccTLD (דומיין ברמה העליונה). מידע נוסף זמין במאמר דומיינים ברמה העליונה עם קוד מדינה. |
units |
אופציונלי. מציין את יחידות המידה של שדות התצוגה. השדות האלה כוללים את השדה |
optimizeWaypointOrder |
אופציונלי. אם הערך מוגדר כ-true, השירות מנסה למזער את העלות הכוללת של המסלול על ידי שינוי הסדר של נקודות הביניים שצוינו. הבקשה נכשלת אם אחת מנקודות הביניים היא נקודת ציון מסוג |
requestedReferenceRoutes[] |
אופציונלי. מציין אילו מסלולי הפניה לחשב כחלק מהבקשה בנוסף למסלול ברירת המחדל. מסלול ייחוס הוא מסלול עם יעד שונה לחישוב המסלול בהשוואה למסלול ברירת המחדל. לדוגמה, כשמחשבים מסלול ייחוס |
extraComputations[] |
אופציונלי. רשימה של חישובים נוספים שאפשר להשתמש בהם כדי להשלים את הבקשה. הערה: יכול להיות שהחישובים הנוספים האלה יחזירו שדות נוספים בתשובה. כדי שהשדות הנוספים האלה יוחזרו בתגובה, צריך לציין אותם גם באנונימיזציה של השדה. |
trafficModel |
אופציונלי. מציינת את ההנחות שמשמשות לחישוב הזמן בפקקים. ההגדרה הזו משפיעה על הערך שמוחזר בשדה משך הזמן ב- |
transitPreferences |
אופציונלי. ההגדרה הזו מציינת העדפות שמשפיעות על המסלול שמוחזר עבור |
גוף התשובה
v2.computeRoutes הודעת התגובה.
אם הפעולה מצליחה, גוף התגובה מכיל נתונים במבנה הבא:
ייצוג ב-JSON |
---|
{ "routes": [ { object ( |
שדות | |
---|---|
routes[] |
מכיל מערך של מסלולים מחושבים (עד שלושה) כשמציינים את |
fallbackInfo |
במקרים מסוימים, אם השרת לא מצליח לחשב את תוצאות המסלול עם כל העדפות הקלט, הוא עשוי לחזור לשימוש בדרך חישוב אחרת. כשמשתמשים במצב חזרה, השדה הזה מכיל מידע מפורט על תגובת החזרה. אחרת, השדה הזה לא מוגדר. |
geocodingResults |
מכיל מידע על תגובת גיאו-קידוד לנקודות ציון שצוינו ככתובות. |
PolylineQuality
קבוצת ערכים שמציינים את האיכות של הקו המקומקע.
טיפוסים בני מנייה (enum) | |
---|---|
POLYLINE_QUALITY_UNSPECIFIED |
לא צוינה העדפה לגבי איכות הקו המרוסקע. ברירת המחדל היא OVERVIEW . |
HIGH_QUALITY |
התנאי הזה מציין קו פוליגוני באיכות גבוהה – שמורכב מיותר נקודות מ-OVERVIEW , על חשבון הגדלת גודל התגובה. משתמשים בערך הזה כשצריך דיוק רב יותר. |
OVERVIEW |
מציין קו פוליגון של סקירה כללית – שמורכב ממספר קטן של נקודות. משתמשים בערך הזה כשמציגים סקירה כללית של המסלול. השימוש באפשרות הזו מאפשר זמן אחזור נמוך יותר של הבקשה בהשוואה לשימוש באפשרות HIGH_QUALITY . |
PolylineEncoding
מציין את סוג הקו המקוטע המועדף שיוחזר.
טיפוסים בני מנייה (enum) | |
---|---|
POLYLINE_ENCODING_UNSPECIFIED |
לא צוינה העדפה לסוג קו פוליגוני. ברירת המחדל היא ENCODED_POLYLINE . |
ENCODED_POLYLINE |
מציין קו שבור שמקודד באמצעות אלגוריתם קידוד הקו השבור. |
GEO_JSON_LINESTRING |
מגדירים קו שבור באמצעות הפורמט GeoJSON LineString |
ReferenceRoute
מסלול ייחוס נתמך ב-ComputeRoutesRequest.
טיפוסים בני מנייה (enum) | |
---|---|
REFERENCE_ROUTE_UNSPECIFIED |
לא בשימוש. בקשות שמכילות את הערך הזה נכשלות. |
FUEL_EFFICIENT |
מסלול חסכוני בדלק. |
SHORTER_DISTANCE |
מסלול עם מרחק נסיעה קצר יותר. זוהי תכונה ניסיונית. במקרה של בקשות ל עבור בקשות של התכונה הזו לא תואמת לאמצעי תחבורה אחרים, לא לנקודות עצירה בדרך ולא ל- |
ExtraComputation
חישובים נוספים שצריך לבצע כדי להשלים את הבקשה.
טיפוסים בני מנייה (enum) | |
---|---|
EXTRA_COMPUTATION_UNSPECIFIED |
לא בשימוש. בקשות שמכילות את הערך הזה ייכשלו. |
TOLLS |
מידע על אגרות בכבישים במסלול או במסלולים. |
FUEL_CONSUMPTION |
צריכת הדלק המשוערת במסלול או במסלולים. |
TRAFFIC_ON_POLYLINE |
קווי פוליגון של המסלולים עם נתוני מצב התנועה. |
HTML_FORMATTED_NAVIGATION_INSTRUCTIONS |
NavigationInstructions מוצג כמחרוזת טקסט בפורמט HTML. התוכן הזה נועד לקריאה כמו שהוא. התוכן הזה מיועד להצגה בלבד. אל תנתחו אותו באופן פרוגרמטי. |
FLYOVER_INFO_ON_POLYLINE |
מידע על מעבר מעל המסלול או המסלולים. כדי להחזיר את המידע הזה, צריך לציין את routes.polyline_details.flyover_info fieldmask. כרגע, הנתונים האלה מאוכלסים רק לגבי אזורים מטרופוליניים מסוימים בהודו. התכונה הזו ניסיונית, והמק"ט או החיוב עשויים להשתנות. |
NARROW_ROAD_INFO_ON_POLYLINE |
מידע על כבישים צרים במסלול או במסלולים. כדי להחזיר את המידע הזה, צריך לציין את routes.polyline_details.narrow_road_info fieldmask. כרגע, הנתונים האלה מאוכלסים רק לגבי אזורים מטרופוליניים מסוימים בהודו. התכונה הזו ניסיונית, והמק"ט או החיוב עשויים להשתנות. |
נתיב
מכיל מסלול, שמורכב מסדרה של קטעי כביש מחוברים שמצטרפים לנקודות ציון של התחלה, סיום וביניים.
ייצוג ב-JSON |
---|
{ "routeLabels": [ enum ( |
שדות | |
---|---|
routeLabels[] |
תוויות של |
legs[] |
אוסף של קטעים (קטעי נתיב בין נקודות ציון) שמרכיבים את המסלול. כל קטע טיסה מייצג את הטיסה בין שני |
distanceMeters |
מרחק הנסיעה במסלול, במטרים. |
duration |
משך הזמן שנדרש כדי לנווט במסלול. אם מגדירים את משך זמן בשניות עם עד תשע ספרות אחרי הנקודה העשרונית, שמסתיים ב-' |
staticDuration |
משך הנסיעה במסלול בלי להתחשב במצב התנועה. משך זמן בשניות עם עד תשע ספרות אחרי הנקודה העשרונית, שמסתיים ב-' |
polyline |
הקו הפוליגוני של המסלול כולו. הקו המקוטע הזה הוא הקו המקוטע המשולב של כל |
description |
תיאור של המסלול. |
warnings[] |
מערך של אזהרות שיוצגו כשמציגים את המסלול. |
viewport |
התיבה התוחמת של אזור התצוגה של הקו הפוליגוני. |
travelAdvisory |
מידע נוסף על המסלול. |
optimizedIntermediateWaypointIndex[] |
אם מגדירים את |
localizedValues |
ייצוגים של מאפיינים של |
routeToken |
טוקן אטום שאפשר להעביר אל Navigation SDK כדי לשחזר את המסלול במהלך הניווט, ובמקרה של שינוי מסלול, כדי לכבד את הכוונה המקורית כשנוצר המסלול. האסימון הזה הוא אובייקט אטום. אל תשוו את הערך שלו בין בקשות, כי הערך עשוי להשתנות גם אם השירות מחזיר את אותו מסלול בדיוק. הערה: |
polylineDetails |
מכיל מידע על פרטים לאורך הקו המרוסקע. |
RouteLabel
תוויות של
שיכולות לעזור לכם לזהות מאפיינים ספציפיים של המסלול כדי להשוות אותו למסלולים אחרים.Route
טיפוסים בני מנייה (enum) | |
---|---|
ROUTE_LABEL_UNSPECIFIED |
ברירת מחדל – לא בשימוש. |
DEFAULT_ROUTE |
מסלול ברירת המחדל שמוחזר כ'המסלול הטוב ביותר' בחישוב המסלול. |
DEFAULT_ROUTE_ALTERNATE |
מסלול חלופי למסלול ברירת המחדל 'הכי טוב'. מסלולים כאלה יוחזרו כשמציינים את . |
FUEL_EFFICIENT |
מסלול חסכוני בדלק. המסלולים שמסומנים בערך הזה נחשבים למסלולים אופטימליים מבחינת פרמטרים של חיסכון, כמו צריכת דלק. |
SHORTER_DISTANCE |
מסלול עם מרחק נסיעה קצר יותר. זוהי תכונה ניסיונית. |
RouteLeg
מכיל קטע בין נקודות ציון שאינן via
.
ייצוג ב-JSON |
---|
{ "distanceMeters": integer, "duration": string, "staticDuration": string, "polyline": { object ( |
שדות | |
---|---|
distanceMeters |
מרחק הנסיעה של קטע המסלול, במטרים. |
duration |
משך הזמן שנדרש כדי להגיע ליעד. אם הערך של משך זמן בשניות עם עד תשע ספרות אחרי הנקודה העשרונית, שמסתיים ב-' |
staticDuration |
משך הנסיעה בקטע, שמחושב בלי להתחשב בתנאי התנועה. משך זמן בשניות עם עד תשע ספרות אחרי הנקודה העשרונית, שמסתיים ב-' |
polyline |
הקו המרובה הכולל של הקטע הזה, שכולל את הקו המרובה של כל |
startLocation |
מיקום ההתחלה של הקטע הזה. יכול להיות שהמיקום הזה יהיה שונה מהמיקום שצוין ב |
endLocation |
מיקום הסיום של הקטע הזה. יכול להיות שהמיקום הזה יהיה שונה מהמיקום שצוין ב |
steps[] |
מערך של שלבים שמציינים פלחים בקטע הזה. כל שלב מייצג הוראת ניווט אחת. |
travelAdvisory |
מכיל את המידע הנוסף שהמשתמש צריך לקבל לגבי קטע מסוים במסלול, כמו הגבלות אפשריות באזור התנועה. |
localizedValues |
ייצוגים של מאפיינים של |
stepsOverview |
מידע כללי על השלבים ב |
מצולע פתוח
הפונקציה עוטפת קו מרובה מקודד.
ייצוג ב-JSON |
---|
{ // Union field |
שדות | |
---|---|
שדה איחוד polyline_type . התג הזה כולל את סוג הקו המרובה. ברירת המחדל היא encoded_polyline. הערך polyline_type יכול להיות רק אחד מהערכים הבאים: |
|
encodedPolyline |
קידוד המחרוזת של הקו המקומקע באמצעות אלגוריתם קידוד הקו המקומקע |
geoJsonLinestring |
מגדירים קו שבור באמצעות הפורמט GeoJSON LineString. |
RouteLegStep
מכיל פלח של
. שלב מתאים להוראת ניווט אחת. קטעי המסלול מורכבים משלבים.RouteLeg
ייצוג ב-JSON |
---|
{ "distanceMeters": integer, "staticDuration": string, "polyline": { object ( |
שדות | |
---|---|
distanceMeters |
מרחק הנסיעה בשלב הזה, במטרים. במקרים מסוימים, יכול להיות שלא יהיה ערך בשדה הזה. |
staticDuration |
משך הנסיעה בשלב הזה בלי להתחשב בתנאי התנועה. במקרים מסוימים, יכול להיות שלא יהיה ערך בשדה הזה. משך זמן בשניות עם עד תשע ספרות אחרי הנקודה העשרונית, שמסתיים ב-' |
polyline |
הקו הפוליגוני שמשויך לשלב הזה. |
startLocation |
מיקום ההתחלה של השלב הזה. |
endLocation |
מיקום הסיום של השלב הזה. |
navigationInstruction |
הוראות ניווט. |
travelAdvisory |
מכיל את המידע הנוסף שהמשתמש צריך לקבל לגבי שלב מסוים במסלול, כמו הגבלות אפשריות באזור התנועה. |
localizedValues |
ייצוגים של מאפיינים של |
transitDetails |
פרטים שקשורים לשלב הזה אם אמצעי התחבורה הוא |
travelMode |
אמצעי התחבורה שבו נעשה שימוש בשלב הזה. |
Maneuver
קבוצת ערכים שמציינים את פעולת הניווט שצריך לבצע בשלב הנוכחי (לדוגמה, פנייה שמאלה, השתלבות או המשך ישר).
טיפוסים בני מנייה (enum) | |
---|---|
MANEUVER_UNSPECIFIED |
לא בשימוש. |
TURN_SLIGHT_LEFT |
פנייה קלה שמאלה. |
TURN_SHARP_LEFT |
פנייה חדה שמאלה. |
UTURN_LEFT |
בצעו פניית פרסה שמאלה. |
TURN_LEFT |
פנייה שמאלה. |
TURN_SLIGHT_RIGHT |
פנייה קלה ימינה. |
TURN_SHARP_RIGHT |
פונים בחדות ימינה. |
UTURN_RIGHT |
פנו ימינה בפניית פרסה. |
TURN_RIGHT |
פנייה ימינה. |
STRAIGHT |
המשיכו ישר. |
RAMP_LEFT |
פנו ליציאה משמאל. |
RAMP_RIGHT |
צאו ביציאה שמימין. |
MERGE |
להשתלב בתנועה. |
FORK_LEFT |
פונים שמאלה במזלג. |
FORK_RIGHT |
פנו ימינה במזלג. |
FERRY |
עולים על המעבורת. |
FERRY_TRAIN |
עולים על הרכבת שמובילה למעבורת. |
ROUNDABOUT_LEFT |
פונים שמאלה בכיכר. |
ROUNDABOUT_RIGHT |
פונים ימינה בכיכר. |
DEPART |
תמרון ראשוני. |
NAME_CHANGE |
משמש לציון שינוי בשם רחוב. |
RouteLegStepTravelAdvisory
מכיל את המידע הנוסף שהמשתמש צריך לקבל, כמו הגבלות אפשריות על אזורי תנועה בשלב מסוים של המסלול.
ייצוג ב-JSON |
---|
{
"speedReadingIntervals": [
{
object ( |
שדות | |
---|---|
speedReadingIntervals[] |
הערה: השדה הזה לא מאוכלס כרגע. |
RouteLegStepLocalizedValues
ייצוגים של טקסט של מאפיינים מסוימים.
ייצוג ב-JSON |
---|
{ "distance": { object ( |
שדות | |
---|---|
distance |
מרחק הנסיעה שמוצג בטקסט. |
staticDuration |
משך הנסיעה בלי להתחשב בתנאי התנועה, שמוצג בפורמט טקסט. |
RouteLegStepTransitDetails
מידע נוסף על מסלולי TRANSIT
שקשור ל-RouteLegStep
.
ייצוג ב-JSON |
---|
{ "stopDetails": { object ( |
שדות | |
---|---|
stopDetails |
מידע על התחנות שבהן מגיעים ועוזבים בכל שלב. |
localizedValues |
ייצוגים של מאפיינים של |
headsign |
מציין את הכיוון שבו צריך לנסוע בקו הזה, כפי שמסומן בכלי הרכב או בתחנת היציאה. הכיוון הוא לרוב תחנת הקצה. |
headway |
מציין את הזמן הצפוי כמשך הזמן בין היציאות מאותה תחנה בשעה הזו. לדוגמה, אם הערך של headway seconds הוא 600, אפשר לצפות להמתנה של עשר דקות אם מפספסים את האוטובוס. משך זמן בשניות עם עד תשע ספרות אחרי הנקודה העשרונית, שמסתיים ב-' |
transitLine |
מידע על קו התחבורה הציבורית שבו משתמשים בשלב הזה. |
stopCount |
מספר התחנות מהתחנה שיוצאים ממנה ועד לתחנת ההגעה. הספירה הזו כוללת את תחנת ההגעה, אבל לא את תחנת היציאה. לדוגמה, אם המסלול יוצא מתחנה א', עובר דרך תחנות ב' ו-ג' ומגיע לתחנה ד',
החזרות 3. |
tripShortText |
הטקסט שמופיע בלוחות זמנים ובשלטים כדי לזהות נסיעה בתחבורה ציבורית לנוסעים. הטקסט צריך לזהות באופן ייחודי נסיעה ביום שירות. לדוגמה, '538' הוא |
TransitStopDetails
פרטים על תחנות התחבורה הציבורית של RouteLegStep
.
ייצוג ב-JSON |
---|
{ "arrivalStop": { object ( |
שדות | |
---|---|
arrivalStop |
מידע על תחנת ההגעה של השלב. |
arrivalTime |
זמן ההגעה המשוער לשלב. הפונקציה משתמשת ב-RFC 3339, והפלט שנוצר תמיד יהיה מנורמל ל-Z וישתמש ב-0, 3, 6 או 9 ספרות חלקיות. אפשר להשתמש גם בהיסטים אחרים מלבד Z. דוגמאות: |
departureStop |
מידע על תחנת היציאה של השלב. |
departureTime |
זמן היציאה המשוער של השלב. הפונקציה משתמשת ב-RFC 3339, והפלט שנוצר תמיד יהיה מנורמל ל-Z וישתמש ב-0, 3, 6 או 9 ספרות חלקיות. אפשר להשתמש גם בהיסטים אחרים מלבד Z. דוגמאות: |
TransitStop
מידע על תחנת מעבר.
ייצוג ב-JSON |
---|
{
"name": string,
"location": {
object ( |
שדות | |
---|---|
name |
שם תחנת התחבורה הציבורית. |
location |
המיקום של התחנה, שמבוטא בקואורדינטות של קו רוחב/אורך. |
TransitDetailsLocalizedValues
תיאורים מקומיים של ערכים של RouteTransitDetails
.
ייצוג ב-JSON |
---|
{ "arrivalTime": { object ( |
שדות | |
---|---|
arrivalTime |
הזמן בייצוג טקסט מעוצב עם אזור זמן תואם. |
departureTime |
הזמן בייצוג טקסט מעוצב עם אזור זמן תואם. |
LocalizedTime
תיאור של הזמן שמותאם לשוק המקומי.
ייצוג ב-JSON |
---|
{
"time": {
object ( |
שדות | |
---|---|
time |
השעה שצוינה כמחרוזת באזור זמן נתון. |
timeZone |
מכיל את אזור הזמן. הערך הוא שם אזור הזמן כפי שמוגדר במסד הנתונים של אזור זמן IANA, למשל America/New_York. |
TransitLine
מכיל מידע על קו התחבורה הציבורית שבו נעשה שימוש בשלב הזה.
ייצוג ב-JSON |
---|
{ "agencies": [ { object ( |
שדות | |
---|---|
agencies[] |
חברת התחבורה הציבורית (או חברות התחבורה הציבוריות) שמפעילה את קו התחבורה הציבורית הזה. |
name |
השם המלא של קו התחבורה הציבורית הזה, לדוגמה, '8 Avenue Local'. |
uri |
כתובת ה-URI של קו התחבורה הציבורית הזה, כפי שסופקה על ידי חברת התחבורה הציבורית. |
color |
הצבע שמשמש בדרך כלל בשילוט של הקו הזה. מוצג בפורמט הקסדצימלי. |
iconUri |
ה-URI של הסמל שמשויך לשורה הזו. |
nameShort |
השם הקצר של קו התחבורה הציבורית הזה. השם הזה יהיה בדרך כלל מספר שורה, כמו M7 או 355. |
textColor |
הצבע שמשמש בדרך כלל לטקסט בשילוט של הקו הזה. מוצג בפורמט הקסדצימלי. |
vehicle |
סוג כלי הרכב שפועל בקו התחבורה הציבורית הזה. |
TransitAgency
חברת תחבורה ציבורית שמפעילה קו תחבורה ציבורית.
ייצוג ב-JSON |
---|
{ "name": string, "phoneNumber": string, "uri": string } |
שדות | |
---|---|
name |
שם חברת התחבורה הציבורית. |
phoneNumber |
מספר הטלפון של רשות התחבורה הציבורית בפורמט שמתאים לאזור. |
uri |
ה-URI של חברת התחבורה הציבורית. |
TransitVehicle
מידע על כלי רכב שמשמש במסלולי תחבורה ציבורית.
ייצוג ב-JSON |
---|
{ "name": { object ( |
שדות | |
---|---|
name |
השם של הרכב הזה, באותיות רישיות. |
type |
סוג הרכב שבו נעשה שימוש. |
iconUri |
ה-URI של סמל שמשויך לסוג הרכב הזה. |
localIconUri |
ה-URI של הסמל שמשויך לסוג הרכב הזה, על סמך השילוט של התחבורה המקומית. |
TransitVehicleType
סוגי כלי הרכב במסלולי התחבורה הציבורית.
טיפוסים בני מנייה (enum) | |
---|---|
TRANSIT_VEHICLE_TYPE_UNSPECIFIED |
לא בשימוש. |
BUS |
אוטובוס. |
CABLE_CAR |
כלי רכב שפועל באמצעות כבל, בדרך כלל על הקרקע. רכבלים יכולים להיות מסוג GONDOLA_LIFT . |
COMMUTER_TRAIN |
רכבת פרברים. |
FERRY |
מעבורת. |
FUNICULAR |
רכב שנמשך במעלה שיפוע תלול באמצעות כבל. בדרך כלל, רכבת פוניקולר מורכבת משני קרונות, כאשר כל קרון משמש כמשקל נגדי לקרון השני. |
GONDOLA_LIFT |
רכבל. |
HEAVY_RAIL |
רכבת כבדה. |
HIGH_SPEED_TRAIN |
רכבת מהירה. |
INTERCITY_BUS |
אוטובוס בין-עירוני. |
LONG_DISTANCE_TRAIN |
רכבת למרחקים ארוכים. |
METRO_RAIL |
רכבת קלה. |
MONORAIL |
רכבת מונורייל. |
OTHER |
כל שאר כלי הרכב. |
RAIL |
רכבת. |
SHARE_TAXI |
מונית שיתופית היא סוג של אוטובוס שיכול להוריד ולאסוף נוסעים בכל מקום במסלול שלו. |
SUBWAY |
רכבת קלה תחתית. |
TRAM |
רכבת קלה מעל פני הקרקע. |
TROLLEYBUS |
טרוליבוס. |
RouteLegTravelAdvisory
מכיל את המידע הנוסף שהמשתמש צריך לקבל על שלב מסוים במסלול, כמו הגבלות אפשריות באזור תנועה.
ייצוג ב-JSON |
---|
{ "tollInfo": { object ( |
שדות | |
---|---|
tollInfo |
מכיל מידע על אגרות בכבישים ספציפיים |
speedReadingIntervals[] |
אינטרוולים של קריאה מהירה עם פרטים על צפיפות התנועה. רלוונטי במקרה של העדפות ניתוב של דוגמה:
|
RouteLegLocalizedValues
ייצוגים של טקסט של מאפיינים מסוימים.
ייצוג ב-JSON |
---|
{ "distance": { object ( |
שדות | |
---|---|
distance |
מרחק הנסיעה שמוצג בטקסט. |
duration |
משך, שמוצג בפורמט טקסט ומותאם לאזור של השאילתה. המסלול מחושב בהתאם למצב התנועה. הערה: אם לא ביקשתם מידע על תנועה, הערך הזה זהה לערך של staticDuration. |
staticDuration |
משך הנסיעה בלי להתחשב בתנאי התנועה, שמוצג בפורמט טקסט. |
StepsOverview
מספק מידע כללי על רשימה של RouteLegStep
s.
ייצוג ב-JSON |
---|
{
"multiModalSegments": [
{
object ( |
שדות | |
---|---|
multiModalSegments[] |
סיכום מידע על פלחים שונים של |
MultiModalSegment
מספק מידע מסוכם על פלחים שונים של RouteLeg.steps
עם כמה אופנים. פלח מולטי-מודאלי מוגדר כאחד או יותר מקטעי RouteLegStep
סמוכים עם אותו RouteTravelMode
. השדה הזה לא מאוכלס אם RouteLeg
לא מכיל פלחים מרובי-אופנים בשלבים.
ייצוג ב-JSON |
---|
{ "navigationInstruction": { object ( |
שדות | |
---|---|
navigationInstruction |
הוראות ניווט לקטע מרובה אמצעי תחבורה. |
travelMode |
אמצעי התחבורה של הקטע הרב-אמצעי. |
stepStartIndex |
האינדקס התואם |
stepEndIndex |
האינדקס התואם |
אזור התצוגה
אזור תצוגה עם קווי רוחב ואורך, שמיוצג כשתי נקודות low
ו-high
שממוקמות באלכסון זו מול זו. אזור התצוגה נחשב לאזור סגור, כלומר הוא כולל את הגבול שלו. הגבולות של קו הרוחב צריכים להיות בין 90- ל-90 מעלות כולל, והגבולות של קו האורך צריכים להיות בין 180- ל-180 מעלות כולל. דוגמאות לכיסויים כאלה:
אם
low
=high
, אזור התצוגה מורכב מהנקודה היחידה הזו.אם
low.longitude
>high.longitude
, טווח קווי האורך הפוך (אזור התצוגה חוצה את קו האורך 180 מעלות).אם
low.longitude
= -180 מעלות ו-high.longitude
= 180 מעלות, אז אזור התצוגה כולל את כל קווי האורך.אם
low.longitude
= 180 מעלות ו-high.longitude
= -180 מעלות, טווח קווי האורך ריק.אם
low.latitude
>high.latitude
, טווח קווי הרוחב ריק.
צריך למלא את הערכים של low
ושל high
, והתיבה שמיוצגת לא יכולה להיות ריקה (כפי שמצוין בהגדרות שלמעלה). אם אזור התצוגה יהיה ריק, תופיע שגיאה.
לדוגמה, אזור התצוגה הזה כולל את כל העיר ניו יורק:
{ "low": { "latitude": 40.477398, "longitude": -74.259087 }, "high": { "latitude": 40.91618, "longitude": -73.70018 } }
ייצוג ב-JSON |
---|
{ "low": { object ( |
שדות | |
---|---|
low |
חובה. הנקודה הנמוכה ביותר באזור התצוגה. |
high |
חובה. הנקודה הגבוהה ביותר באזור התצוגה. |
RouteLocalizedValues
ייצוגים של טקסט של מאפיינים מסוימים.
ייצוג ב-JSON |
---|
{ "distance": { object ( |
שדות | |
---|---|
distance |
מרחק הנסיעה שמוצג בטקסט. |
duration |
משך, שמוצג בפורמט טקסט ומותאם לאזור של השאילתה. המסלול מחושב בהתאם למצב התנועה. הערה: אם לא ביקשתם מידע על תנועה, הערך הזה זהה לערך של |
staticDuration |
משך הנסיעה בלי להתחשב בתנאי התנועה, שמוצג בפורמט טקסט. |
transitFare |
מחיר הנסיעה בתחבורה ציבורית, שמוצג בפורמט טקסט. |
PolylineDetails
פרטים שמתאימים לאינדקס נתון או לפלח רציף של קו פוליגוני. בהינתן קו פוליגוני עם נקודות P_0, P_1, ... , P_N (אינדקס מבוסס-אפס), המאפיין PolylineDetails
מגדיר מרווח ומטא-נתונים משויכים.
ייצוג ב-JSON |
---|
{ "flyoverInfo": [ { object ( |
שדות | |
---|---|
flyoverInfo[] |
פרטים על המעבר מעל קו הפוליגון. |
narrowRoadInfo[] |
פרטים על כבישים צרים לאורך הקו המקוקו. |
FlyoverInfo
כולל מידע על מעברים מעל קו הפוליגון.
ייצוג ב-JSON |
---|
{ "flyoverPresence": enum ( |
שדות | |
---|---|
flyoverPresence |
פלט בלבד. מציין אם יש מעוף מעל קטע נתון של הקו המקוקו. |
polylinePointIndex |
המיקום של מידע שקשור למעבר מעל קו הפוליגון. |
RoadFeatureState
האובייקט הזה מכיל את המצבים של מאפייני הכביש לאורך קטע של קו פוליגוני.
טיפוסים בני מנייה (enum) | |
---|---|
ROAD_FEATURE_STATE_UNSPECIFIED |
המצב של תכונת הכביש לא חושב (ערך ברירת מחדל). |
EXISTS |
מאפיין הכביש קיים. |
DOES_NOT_EXIST |
תכונת הכביש לא קיימת. |
PolylinePointIndex
המאפיין הזה כולל את אינדקס ההתחלה ואינדקס הסיום של פרטי קו פוליגוני. במקרים שבהם הנתונים מתאימים לנקודה אחת, הערכים של startIndex
ושל endIndex
יהיו שווים.
ייצוג ב-JSON |
---|
{ "startIndex": integer, "endIndex": integer } |
שדות | |
---|---|
startIndex |
אינדקס ההתחלה של הפרט הזה בקו הפוליגוני. |
endIndex |
אינדקס הסיום של הפרט הזה בקו המעוקל. |
NarrowRoadInfo
האובייקט הזה מכיל מידע על כבישים צרים לאורך הקו המקומפל.
ייצוג ב-JSON |
---|
{ "narrowRoadPresence": enum ( |
שדות | |
---|---|
narrowRoadPresence |
פלט בלבד. התנאי מציין אם קיים כביש צר בקטע מסוים של הקו הפוליגוני. |
polylinePointIndex |
המיקום של מידע שקשור לכביש צר לאורך הקו הפוליגוני. |
GeocodingResults
מכיל
לנקודת המוצא, ליעד ולנקודות הביניים. השדה הזה מאוכלס רק בנקודות ציון של כתובות.GeocodedWaypoints
ייצוג ב-JSON |
---|
{ "origin": { object ( |
שדות | |
---|---|
origin |
נקודת ציון גיאוגרפית של נקודת המוצא. |
destination |
נקודת ציון שמומרת לקואורדינטות גיאוגרפיות. |
intermediates[] |
רשימה של נקודות ציון גיאוקודיות ביניים, שכל אחת מהן מכילה שדה אינדקס שתואם למיקום של נקודת הציון בסדר שבו היא צוינה בבקשה (המיקום מתחיל מאפס). |
GeocodedWaypoint
פרטים על המיקומים שמשמשים כנקודות ציון. השדה הזה מאוכלס רק בנקודות ציון של כתובות. כולל פרטים על תוצאות הגיאו-קידוד לצורך קביעה של הכתובת שאליה בוצע הגיאו-קידוד.
ייצוג ב-JSON |
---|
{
"geocoderStatus": {
object ( |
שדות | |
---|---|
geocoderStatus |
מציין את קוד הסטטוס שמתקבל מפעולת הגיאוקודינג. |
type[] |
סוגי התוצאות, בצורה של אפס או יותר תגי סוג. סוגים נתמכים: סוגי כתובות וסוגי רכיבי כתובות. |
partialMatch |
מציין שהגיאוקודר לא החזיר התאמה מדויקת לבקשה המקורית, אבל הוא הצליח להתאים חלק מכתובת הבקשה. כדאי לבדוק את הבקשה המקורית כדי לוודא שאין בה שגיאות כתיב או שהכתובת לא מלאה. |
placeId |
מזהה המקום של התוצאה הזו. |
intermediateWaypointRequestIndex |
האינדקס של נקודת הביניים המתאימה בבקשה. השדה הזה מאוכלס רק אם ציון הדרך התואם הוא ציון דרך ביניים. |