Method: computeRoutes

מחזירה את המסלול הראשי יחד עם מסלולים חלופיים אופציונליים, בהינתן קבוצה של ציוני דרך בטרמינל ובנקודת ביניים.

הערה: השיטה הזו מחייבת לציין אנונימיזציה של שדות תגובה בקלט. אפשר לספק את המסכה של שדות התגובה באמצעות פרמטר של כתובת אתר $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.

גוף הבקשה

גוף הבקשה מכיל נתונים במבנה הבא:

ייצוג JSON
{
  "origin": {
    object (Waypoint)
  },
  "destination": {
    object (Waypoint)
  },
  "intermediates": [
    {
      object (Waypoint)
    }
  ],
  "travelMode": enum (RouteTravelMode),
  "routingPreference": enum (RoutingPreference),
  "polylineQuality": enum (PolylineQuality),
  "polylineEncoding": enum (PolylineEncoding),
  "departureTime": string,
  "arrivalTime": string,
  "computeAlternativeRoutes": boolean,
  "routeModifiers": {
    object (RouteModifiers)
  },
  "languageCode": string,
  "regionCode": string,
  "units": enum (Units),
  "optimizeWaypointOrder": boolean,
  "requestedReferenceRoutes": [
    enum (ReferenceRoute)
  ],
  "extraComputations": [
    enum (ExtraComputation)
  ],
  "trafficModel": enum (TrafficModel),
  "transitPreferences": {
    object (TransitPreferences)
  }
}
שדות
origin

object (Waypoint)

חובה. ציון דרך במקור.

destination

object (Waypoint)

חובה. ציון דרך ליעד.

intermediates[]

object (Waypoint)

זה שינוי אופציונלי. קבוצה של נקודות דרך לאורך המסלול (לא כולל נקודות סופיות), לעצירה או למעבר. יש תמיכה ב-25 ציוני דרך ברמת הביניים.

travelMode

enum (RouteTravelMode)

זה שינוי אופציונלי. מציין את אמצעי התחבורה.

routingPreference

enum (RoutingPreference)

זה שינוי אופציונלי. מציינת איך לחשב את המסלול. השרת מנסה להשתמש בהעדפת הניתוב שנבחרה כדי לחשב את הנתיב. אם העדפת הניתוב גורמת לשגיאה או לזמן אחזור ארוך במיוחד, תוחזר שגיאה. אפשר להגדיר את האפשרות הזו רק כאשר travelMode הוא DRIVE או TWO_WHEELER, אחרת הבקשה תיכשל.

polylineQuality

enum (PolylineQuality)

זה שינוי אופציונלי. מציין את ההעדפה שלך לאיכות של הקו הפוליגוני.

polylineEncoding

enum (PolylineEncoding)

זה שינוי אופציונלי. מציינת את הקידוד המועדף לקו הפוליגוני.

departureTime

string (Timestamp format)

זה שינוי אופציונלי. שעת היציאה. אם לא מגדירים את הערך הזה, ברירת המחדל של הערך הזה היא השעה שבה שלחתם את הבקשה. הערה: אפשר לציין departureTime בעבר רק כאשר RouteTravelMode מוגדר לערך TRANSIT. נסיעות בתחבורה ציבורית זמינות לתקופה של עד 7 ימים לפני התאריך הנוכחי או עד 100 ימים בעתיד.

חותמת זמן ב-RFC3339 UTC 'Zulu' בפורמט של רזולוציה של ננו-שנייה ועד תשע ספרות עשרוניות. דוגמאות: "2014-10-02T15:01:23Z" ו-"2014-10-02T15:01:23.045123456Z".

arrivalTime

string (Timestamp format)

זה שינוי אופציונלי. שעת ההגעה. הערה: ניתן להגדיר את הערך רק אם בשדה RouteTravelMode מוגדר הערך TRANSIT. אפשר לציין departureTime או arrivalTime, אבל לא את שניהם. נסיעות בתחבורה ציבורית זמינות לתקופה של עד 7 ימים לפני התאריך הנוכחי או עד 100 ימים בעתיד.

חותמת זמן ב-RFC3339 UTC 'Zulu' בפורמט של רזולוציה של ננו-שנייה ועד תשע ספרות עשרוניות. דוגמאות: "2014-10-02T15:01:23Z" ו-"2014-10-02T15:01:23.045123456Z".

computeAlternativeRoutes

boolean

זה שינוי אופציונלי. מציינת אם לחשב מסלולים חלופיים בנוסף למסלול. לא מוחזרים מסלולים חלופיים לבקשות עם ציוני דרך מתווכים.

routeModifiers

object (RouteModifiers)

זה שינוי אופציונלי. קבוצה של תנאים שמשפיעים על אופן החישוב של נתיבים.

languageCode

string

זה שינוי אופציונלי. קוד השפה BCP-47, כמו 'en-US' או 'sr-Latn'. מידע נוסף זמין במאמר מזהה הלוקאל של Unicode. במאמר שפות תמיכה אפשר למצוא את רשימת השפות הנתמכות. אם לא מציינים את הערך הזה, המערכת מסיקה את שפת התצוגה מהמיקום של בקשת המסלול.

regionCode

string

זה שינוי אופציונלי. קוד האזור, שצוין כ-ccTLD ("דומיין ברמה העליונה") כערך בן שני תווים. מידע נוסף זמין במאמר דומיינים ברמה העליונה עם קוד מדינה.

units

enum (Units)

זה שינוי אופציונלי. מציינת את יחידות המידה של שדות התצוגה. השדות האלה כוללים את השדה instruction ב-NavigationInstruction. יחידות המדידה של המסלול, הרגל, מרחק הצעדים ומשך הזמן לא מושפעות מהערך הזה. אם לא תספקו את הערך הזה, המערכת תסיק את יחידות התצוגה מהמיקום של המקור הראשון.

optimizeWaypointOrder

boolean

זה שינוי אופציונלי. אם המדיניות מוגדרת כ-True, השירות ינסה לצמצם את העלות הכוללת של המסלול על ידי שינוי הסדר של נקודות הביניים שצוינו. הבקשה תיכשל אם אחד מציוני הביניים הוא via. כדי למצוא את ההזמנה החדשה, צריך להשתמש ב-ComputeRoutesResponse.Routes.optimized_intermediate_waypoint_index. אם אין בקשה ל-ComputeRoutesResponseroutes.optimized_intermediate_waypoint_index בכותרת X-Goog-FieldMask, הבקשה תיכשל. אם המדיניות optimizeWaypointOrder מוגדרת כ-False, ComputeRoutesResponse.optimized_intermediate_waypoint_index יהיה ריק.

requestedReferenceRoutes[]

enum (ReferenceRoute)

זה שינוי אופציונלי. מציינת אילו מסלולי הפניה יש לחשב כחלק מהבקשה, בנוסף למסלול ברירת המחדל. מסלול הפניה הוא מסלול עם יעד לחישוב מסלול ששונה מיעד ברירת המחדל. לדוגמה, חישוב מסלול הייחוס של FUEL_EFFICIENT כולל פרמטרים שונים ליצירת מסלול אופטימלי חסכוני בדלק.

extraComputations[]

enum (ExtraComputation)

זה שינוי אופציונלי. רשימה של חישובים נוספים שיכולים לשמש להשלמת הבקשה. הערה: החישובים הנוספים האלה עשויים להחזיר שדות נוספים בתשובה. צריך לציין את השדות הנוספים האלה גם במסכת השדות שתוחזר בתשובה.

trafficModel

enum (TrafficModel)

זה שינוי אופציונלי. מציין את ההנחות לשימוש בחישוב זמן בתנועה. ההגדרה הזו משפיעה על הערך המוחזר בשדה משך הזמן ב-Route וב-RouteLeg, שמכיל את משך הזמן החזוי בתנועה על סמך ממוצעים היסטוריים. התכונה TrafficModel זמינה רק לבקשות שהגדירו את RoutingPreference כ-TRAFFIC_AWARE_OPTIMAL ואת RouteTravelMode כ-DRIVE. ערך ברירת המחדל הוא BEST_GUESS אם תתקבל בקשה לתנועה ולא מציינים את הערך TrafficModel.

transitPreferences

object (TransitPreferences)

זה שינוי אופציונלי. מציינת את ההעדפות שמשפיעות על המסלול שמוחזר ב-TRANSIT מסלולים. הערה: אפשר לציין transitPreferences רק אם RouteTravelMode מוגדר לערך TRANSIT.

גוף התשובה

v2.computeRoutes את הודעת התשובה.

אם הפעולה בוצעה ללא שגיאות, גוף התגובה יכיל נתונים במבנה הבא:

ייצוג JSON
{
  "routes": [
    {
      object (Route)
    }
  ],
  "fallbackInfo": {
    object (FallbackInfo)
  },
  "geocodingResults": {
    object (GeocodingResults)
  }
}
שדות
routes[]

object (Route)

מכילה מערך של נתיבים מחושבים (עד שלושה) כשמציינים את compute_alternatives_routes, ומכילה רק נתיב אחד אם לא צוין אחרת. כאשר המערך הזה מכיל מספר רשומות, הראשונה היא הנתיב המומלץ ביותר. אם המערך ריק, המשמעות היא שלא נמצא מסלול.

fallbackInfo

object (FallbackInfo)

במקרים מסוימים שבהם השרת לא יכול לחשב את תוצאות המסלול עם כל העדפות הקלט, הוא עשוי להשתמש בשיטת חישוב אחרת. כשמשתמשים במצב חלופי, השדה הזה מכיל מידע מפורט על התשובה החלופית. אחרת, השדה הזה לא מוגדר.

geocodingResults

object (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 מסלול חסכוני בדלק. מסלולים שמסומנים בתווית עם הערך הזה נקבעו כמסלולים שעברו אופטימיזציה לפרמטרים כמו צריכת דלק.

ExtraComputation

חישובים נוספים לבצע במהלך השלמת הבקשה.

טיפוסים בני מנייה (enum)
EXTRA_COMPUTATION_UNSPECIFIED לא בשימוש. לא יהיה ניתן להגיש בקשות שמכילות את הערך הזה.
TOLLS מידע על כבישי האגרה עבור המסלולים.
FUEL_CONSUMPTION צריכת הדלק המשוערת במסלולים.
TRAFFIC_ON_POLYLINE קווים פוליגוניים מודעים לתנועה עבור הנתיבים.
HTML_FORMATTED_NAVIGATION_INSTRUCTIONS התג NavigationInstructions מוצג כמחרוזת טקסט מעוצבת של HTML. יש לקרוא את התוכן הזה כפי שהוא. התוכן הזה הוא לתצוגה בלבד. אין לנתח אותו באופן פרוגרמטי.

נתיב

מסלול שמורכב מסדרה של מקטעי דרך מחוברים שמחברים בין נקודות התחלה, נקודות סיום וסיום.

ייצוג JSON
{
  "routeLabels": [
    enum (RouteLabel)
  ],
  "legs": [
    {
      object (RouteLeg)
    }
  ],
  "distanceMeters": integer,
  "duration": string,
  "staticDuration": string,
  "polyline": {
    object (Polyline)
  },
  "description": string,
  "warnings": [
    string
  ],
  "viewport": {
    object (Viewport)
  },
  "travelAdvisory": {
    object (RouteTravelAdvisory)
  },
  "optimizedIntermediateWaypointIndex": [
    integer
  ],
  "localizedValues": {
    object (RouteLocalizedValues)
  },
  "routeToken": string
}
שדות
routeLabels[]

enum (RouteLabel)

תוויות של Route שימושיות לזיהוי מאפיינים ספציפיים של המסלול לצורך השוואה לעומת אחרים.

legs[]

object (RouteLeg)

אוסף של רגליים (קטעי נתיב בין ציוני דרך) שמרכיבים את המסלול. כל רגל תואמת לנסיעה בין שתי Waypoints שאינן via. לדוגמה, למסלול ללא ציוני דרך באמצע יש רק רגל אחת. למסלול שכולל ציון דרך אחד שאינו via יש שתי רגליים. למסלול שכולל ציון דרך אחד ברמת ביניים via יש רגל אחת. סדר השלבים תואם את הסדר של ציוני הדרך מ-origin עד intermediates עד destination.

distanceMeters

integer

מרחק הנסיעה של המסלול, במטרים.

duration

string (Duration format)

משך הזמן שנדרש כדי לנווט במסלול. אם מגדירים את routingPreference לערך TRAFFIC_UNAWARE, הערך הזה יהיה זהה לערך staticDuration. אם מגדירים את הערך בשדה routingPreference לערך TRAFFIC_AWARE או לערך TRAFFIC_AWARE_OPTIMAL, הערך הזה מחושב על סמך מצב התנועה.

משך זמן בשניות עם עד תשע ספרות עשרוניות, שמסתיים ב-'s'. לדוגמה: "3.5s".

staticDuration

string (Duration format)

משך הנסיעה במסלול בלי להביא בחשבון את מצב התנועה.

משך זמן בשניות עם עד תשע ספרות עשרוניות, שמסתיים ב-'s'. לדוגמה: "3.5s".

polyline

object (Polyline)

הקו הפוליגוני של הנתיב הכולל. הקו הפוליגוני הזה הוא הקו הפוליגוני המשולב של כל legs.

description

string

תיאור של המסלול.

warnings[]

string

מערך אזהרות שיוצגו במהלך הצגת המסלול.

viewport

object (Viewport)

התיבה התוחמת של אזור התצוגה של הקו הפוליגוני.

travelAdvisory

object (RouteTravelAdvisory)

מידע נוסף על המסלול.

optimizedIntermediateWaypointIndex[]

integer

אם מגדירים את הערך של optimizeWaypointOrder כ-True, השדה הזה מכיל את הסדר האופטימלי של ציוני הדרך הביניים. אם לא, השדה הזה יהיה ריק. לדוגמה, אם מזינים קלט מהמקור: LA; נקודות דרך ביניים: Dallas, Bangor, Phoenix; יעד: תל אביב. והסדר של ציון הדרך שעבר אופטימיזציה הוא Phoenix, Dallas, Bangor, השדה הזה מכיל את הערכים [2, 0, 1]. האינדקס מתחיל ב-0 לציון ציון הביניים הראשון שצוין בקלט.

localizedValues

object (RouteLocalizedValues)

ייצוגי טקסט של המאפיינים של Route.

routeToken

string

אסימון מסלול בקידוד base64 שהוא בטוח לשימוש באינטרנט, שניתן להעביר ל-Navigation SDK, שמאפשר ל-Navigation SDK לשחזר את המסלול במהלך הניווט, ובמקרה של שינוי מסלול, מכבד את הכוונה המקורית כשיצרת את המסלול, על ידי קריאה אל v2.computeRoutes. הלקוחות צריכים להתייחס לאסימון הזה כאל blob אטום. אל תשוו את הערך שלו בבקשות שונות – האסימון עשוי להשתנות גם אם מוחזר אותו מסלול בדיוק. הערה: Route.route_token זמין רק לבקשות שבהן ComputeRoutesRequest.routing_preference מוגדר ל-TRAFFIC_AWARE או ל-TRAFFIC_AWARE_OPTIMAL. אין תמיכה ב-Route.route_token בבקשות עם ציוני דרך.

RouteLabel

תוויות של Route שימושיות לזיהוי מאפיינים ספציפיים של המסלול לצורך השוואה לעומת אחרים.

טיפוסים בני מנייה (enum)
ROUTE_LABEL_UNSPECIFIED ברירת מחדל – לא בשימוש.
DEFAULT_ROUTE ברירת המחדל 'הכי טוב' המוחזר עבור חישוב המסלול.
DEFAULT_ROUTE_ALTERNATE חלופה לברירת המחדל 'הכי טוב' מסלול. מסלולים כאלה יוחזרו כשמציינים computeAlternativeRoutes.
FUEL_EFFICIENT מסלול חסכוני בדלק. מסלולים שמסומנים בתווית הזו נקבעו כמסלולים שעברו אופטימיזציה לפרמטרים חסכוניים באנרגיה, כמו צריכת דלק.

RouteLeg

מכיל קטע בין נקודות ציון שאינן via.

ייצוג JSON
{
  "distanceMeters": integer,
  "duration": string,
  "staticDuration": string,
  "polyline": {
    object (Polyline)
  },
  "startLocation": {
    object (Location)
  },
  "endLocation": {
    object (Location)
  },
  "steps": [
    {
      object (RouteLegStep)
    }
  ],
  "travelAdvisory": {
    object (RouteLegTravelAdvisory)
  },
  "localizedValues": {
    object (RouteLegLocalizedValues)
  },
  "stepsOverview": {
    object (StepsOverview)
  }
}
שדות
distanceMeters

integer

המרחק של המסלול במטרים.

duration

string (Duration format)

משך הזמן שנדרש כדי לנווט בקטע. אם המדיניות route_preference מוגדרת לערך TRAFFIC_UNAWARE, הערך הזה זהה לערך staticDuration. אם הערך של route_preference הוא TRAFFIC_AWARE או TRAFFIC_AWARE_OPTIMAL, הערך הזה מחושב על סמך מצב התנועה.

משך זמן בשניות עם עד תשע ספרות עשרוניות, שמסתיים ב-'s'. לדוגמה: "3.5s".

staticDuration

string (Duration format)

משך הנסיעה במסלול, מחושב בלי להביא בחשבון את מצב התנועה.

משך זמן בשניות עם עד תשע ספרות עשרוניות, שמסתיים ב-'s'. לדוגמה: "3.5s".

polyline

object (Polyline)

הקו הפוליגוני הכולל של הרגל הזו שכולל את הקו הפוליגוני של כל step.

startLocation

object (Location)

מיקום ההתחלה של הקטע הזה. המיקום הזה עשוי להיות שונה מהמיקום origin שצוין. לדוגמה, אם ה-origin שצוין לא נמצא ליד כביש, זוהי נקודה על הכביש.

endLocation

object (Location)

מיקום הסיום של הרגל הזו. המיקום הזה עשוי להיות שונה מהמיקום destination שצוין. לדוגמה, אם ה-destination שצוין לא נמצא ליד כביש, זוהי נקודה על הכביש.

steps[]

object (RouteLegStep)

מערך של שלבים לסימון קטעים בתוך הקטע הזה. כל שלב מייצג הוראת ניווט אחת.

travelAdvisory

object (RouteLegTravelAdvisory)

מכיל את המידע הנוסף שצריך ליידע את המשתמש, כמו מגבלות אפשריות של אזורי תנועה, במסלול.

localizedValues

object (RouteLegLocalizedValues)

ייצוגי טקסט של המאפיינים של RouteLeg.

stepsOverview

object (StepsOverview)

סקירה כללית על השלבים במדריך RouteLeg. השדה הזה מאוכלס רק במסלולי TRANSIT.

מצולע פתוח

כוללת קו פוליגוני מקודד.

ייצוג JSON
{

  // Union field polyline_type can be only one of the following:
  "encodedPolyline": string,
  "geoJsonLinestring": {
    object
  }
  // End of list of possible types for union field polyline_type.
}
שדות
שדה איחוד polyline_type. כולל את סוג קו הפוליגוני. ברירת המחדל היא encoded_polyline. polyline_type יכול להיות רק אחת מהאפשרויות הבאות:
encodedPolyline

string

קידוד המחרוזת של הקו הפוליגוני באמצעות אלגוריתם הקידוד של קו פוליגוני

geoJsonLinestring

object (Struct format)

מציין קו פוליגוני באמצעות פורמט GeoJSON LineString.

RouteLegStep

מכיל פלח של RouteLeg. שלב תואם להוראת ניווט אחת. רגלי המסלול מורכבים ממדים.

ייצוג JSON
{
  "distanceMeters": integer,
  "staticDuration": string,
  "polyline": {
    object (Polyline)
  },
  "startLocation": {
    object (Location)
  },
  "endLocation": {
    object (Location)
  },
  "navigationInstruction": {
    object (NavigationInstruction)
  },
  "travelAdvisory": {
    object (RouteLegStepTravelAdvisory)
  },
  "localizedValues": {
    object (RouteLegStepLocalizedValues)
  },
  "transitDetails": {
    object (RouteLegStepTransitDetails)
  },
  "travelMode": enum (RouteTravelMode)
}
שדות
distanceMeters

integer

המרחק של השלב הזה במטרים. במקרים מסוימים יכול להיות שהשדה הזה לא מכיל ערך.

staticDuration

string (Duration format)

משך הנסיעה בשלב הזה בלי להביא בחשבון את מצב התנועה. במקרים מסוימים יכול להיות שהשדה הזה לא מכיל ערך.

משך זמן בשניות עם עד תשע ספרות עשרוניות, שמסתיים ב-'s'. לדוגמה: "3.5s".

polyline

object (Polyline)

הקו הפוליגוני המשויך לשלב הזה.

startLocation

object (Location)

מיקום ההתחלה של השלב הזה.

endLocation

object (Location)

מיקום הסיום של השלב הזה.

navigationInstruction

object (NavigationInstruction)

הוראות ניווט.

travelAdvisory

object (RouteLegStepTravelAdvisory)

מכיל את המידע הנוסף שהמשתמש צריך לקבל לגביו דיווח, למשל מגבלות אפשריות של אזורי תנועה, בשלב הצעדים.

localizedValues

object (RouteLegStepLocalizedValues)

ייצוגי טקסט של המאפיינים של RouteLegStep.

transitDetails

object (RouteLegStepTransitDetails)

פרטים שקשורים לשלב הזה אם מצב הנסיעה הוא TRANSIT.

travelMode

enum (RouteTravelMode)

מצב הנסיעה שנעשה בו שימוש בשלב הזה.

תמרון

קבוצת ערכים שמציינים את פעולת הניווט שיש לבצע בשלב הנוכחי (לדוגמה: פנייה שמאלה, מיזוג או ישר).

טיפוסים בני מנייה (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 (SpeedReadingInterval)
    }
  ]
}
שדות
speedReadingIntervals[]

object (SpeedReadingInterval)

הערה: השדה הזה לא מאוכלס כרגע.

RouteLegStepLocalizedValues

ייצוגי טקסט של מאפיינים מסוימים.

ייצוג JSON
{
  "distance": {
    object (LocalizedText)
  },
  "staticDuration": {
    object (LocalizedText)
  }
}
שדות
distance

object (LocalizedText)

מרחק הנסיעה מיוצג בפורמט טקסט.

staticDuration

object (LocalizedText)

משך הזמן, מבלי להביא בחשבון את מצב התנועה, מיוצג בפורמט טקסט.

RouteLegStepTransitDetails

מידע נוסף לגבי RouteLegStep שקשור למסלולים של TRANSIT.

ייצוג JSON
{
  "stopDetails": {
    object (TransitStopDetails)
  },
  "localizedValues": {
    object (TransitDetailsLocalizedValues)
  },
  "headsign": string,
  "headway": string,
  "transitLine": {
    object (TransitLine)
  },
  "stopCount": integer,
  "tripShortText": string
}
שדות
stopDetails

object (TransitStopDetails)

מידע על שעת ההגעה והיציאה של השלב הזה.

localizedValues

object (TransitDetailsLocalizedValues)

ייצוגי טקסט של המאפיינים של RouteLegStepTransitDetails.

headsign

string

מציינת את כיוון הנסיעה בקו הזה כפי שמסומן ברכב או בתחנת היציאה. לרוב, הכיוון הוא תחנת הטרמינל.

headway

string (Duration format)

מציין את משך הזמן הצפוי בין היציאות מאותה תחנה כרגע. לדוגמה, עם ערך שניות מקדים של 600, אפשר לצפות להמתנה של עשר דקות אם תפספסו את האוטובוס.

משך זמן בשניות עם עד תשע ספרות עשרוניות, שמסתיים ב-'s'. לדוגמה: "3.5s".

transitLine

object (TransitLine)

מידע על קו התחבורה הציבורית שבו נעשה שימוש בשלב הזה.

stopCount

integer

מספר התחנות מנקודת היציאה עד לתחנת ההגעה. המספר הזה כולל את תחנת ההגעה, אבל לא כולל את תחנת היציאה. לדוגמה, אם המסלול יוצא מתחנה א', עובר דרך את עצירות ב' ו-ג' ומגיע לתחנה D, התחנה stopCount תחזיר את הערך 3.

tripShortText

string

הטקסט שמופיע בלוחות זמנים ובלוחות של חתימה כדי לזהות נסיעה בתחבורה ציבורית לנוסעים. הטקסט צריך לזהות את הנסיעה באופן ייחודי ביום השירות. לדוגמה, "538" הוא הtripShortText של הרכבת אמטרק שיוצאת מסן חוזה, קליפורניה בשעה 15:10 בימי חול אל סקרמנטו, קליפורניה.

TransitStopDetails

פרטים על תחנות התחבורה הציבורית של RouteLegStep.

ייצוג JSON
{
  "arrivalStop": {
    object (TransitStop)
  },
  "arrivalTime": string,
  "departureStop": {
    object (TransitStop)
  },
  "departureTime": string
}
שדות
arrivalStop

object (TransitStop)

מידע על תחנת ההגעה של השלב.

arrivalTime

string (Timestamp format)

זמן ההגעה המשוער של השלב.

חותמת זמן ב-RFC3339 UTC 'Zulu' בפורמט של רזולוציה של ננו-שנייה ועד תשע ספרות עשרוניות. דוגמאות: "2014-10-02T15:01:23Z" ו-"2014-10-02T15:01:23.045123456Z".

departureStop

object (TransitStop)

מידע על תחנת היציאה של השלב.

departureTime

string (Timestamp format)

זמן היציאה המשוער של השלב.

חותמת זמן ב-RFC3339 UTC 'Zulu' בפורמט של רזולוציה של ננו-שנייה ועד תשע ספרות עשרוניות. דוגמאות: "2014-10-02T15:01:23Z" ו-"2014-10-02T15:01:23.045123456Z".

TransitStop

מידע על תחנת תחבורה ציבורית.

ייצוג JSON
{
  "name": string,
  "location": {
    object (Location)
  }
}
שדות
name

string

שם התחנה של התחבורה הציבורית.

location

object (Location)

מיקום העצירה מבוטא בקואורדינטות של קו אורך/רוחב.

TransitDetailsLocalizedValues

תיאורי ערכים מותאמים לשוק המקומי עבור RouteTransitDetails.

ייצוג JSON
{
  "arrivalTime": {
    object (LocalizedTime)
  },
  "departureTime": {
    object (LocalizedTime)
  }
}
שדות
arrivalTime

object (LocalizedTime)

שעה בייצוג הטקסט המעוצב עם אזור זמן תואם.

departureTime

object (LocalizedTime)

שעה בייצוג הטקסט המעוצב שלה עם אזור זמן תואם.

LocalizedTime

תיאור זמן מותאם לשוק המקומי.

ייצוג JSON
{
  "time": {
    object (LocalizedText)
  },
  "timeZone": string
}
שדות
time

object (LocalizedText)

השעה שצוינה כמחרוזת באזור זמן נתון.

timeZone

string

מכילה את אזור הזמן. הערך הוא שם אזור הזמן כפי שמוגדר במסד הנתונים של אזור זמן IANA, למשל. 'America/New_York'.

TransitLine

מכיל מידע על קו התחבורה הציבורית שבו נעשה שימוש בשלב הזה.

ייצוג JSON
{
  "agencies": [
    {
      object (TransitAgency)
    }
  ],
  "name": string,
  "uri": string,
  "color": string,
  "iconUri": string,
  "nameShort": string,
  "textColor": string,
  "vehicle": {
    object (TransitVehicle)
  }
}
שדות
agencies[]

object (TransitAgency)

חברת התחבורה הציבורית שמפעילה את קו התחבורה הציבורית הזה.

name

string

השם המלא של קו התחבורה הציבורית הזה, לדוגמה, ' 8 Avenue Local'

uri

string

את ה-URI של קו התחבורה הציבורית הזה, כפי שסופק על ידי חברת התחבורה הציבורית.

color

string

הצבע הנפוץ בשילוט של הקו הזה. מיוצגת בהקסדצימלי.

iconUri

string

ה-URI של הסמל המשויך לשורה הזו.

nameShort

string

השם המקוצר של קו התחבורה הציבורית הזה. השם הזה יהיה בדרך כלל מספר שורה, כמו M7 או 355.

textColor

string

הצבע שבו משתמשים בדרך כלל בטקסט בשילוט של הקו הזה. מיוצגת בהקסדצימלי.

vehicle

object (TransitVehicle)

סוג כלי הרכב שפועל בקו התחבורה הציבורית הזה.

TransitAgency

חברת תחבורה ציבורית שמפעילה קו תחבורה ציבורית.

ייצוג JSON
{
  "name": string,
  "phoneNumber": string,
  "uri": string
}
שדות
name

string

השם של חברת התחבורה הציבורית הזו.

phoneNumber

string

מספר טלפון בפורמט הספציפי לאזור של חברת התחבורה הציבורית.

uri

string

ה-URI של חברת התחבורה הציבורית.

TransitVehicle

מידע על כלי רכב שמשמשים במסלולי תחבורה ציבורית.

ייצוג JSON
{
  "name": {
    object (LocalizedText)
  },
  "type": enum (TransitVehicleType),
  "iconUri": string,
  "localIconUri": string
}
שדות
name

object (LocalizedText)

שם הרכב הזה, באותיות רישיות.

type

enum (TransitVehicleType)

סוג כלי הרכב.

iconUri

string

ה-URI של סמל שמשויך לסוג הרכב הזה.

localIconUri

string

ה-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": [
    {
      object (SpeedReadingInterval)
    }
  ]
}
שדות
tollInfo

object (TollInfo)

מכילה מידע על כבישי אגרה בכביש RouteLeg הספציפי. השדה הזה יאוכלס רק אם אנחנו צופים שיהיו כבישי אגרה על RouteLeg. אם השדה הזה מוגדר אבל שדה המשנה לציון מחיר משוער לא מאוכלס, אנחנו צופים שהכביש מכיל כבישי אגרה, אבל אנחנו לא יודעים מה המחיר המשוער. אם השדה הזה לא קיים, אין כביש אגרה על RouteLeg.

speedReadingIntervals[]

object (SpeedReadingInterval)

מרווחי זמן לקריאה של מהירות המפרטים את צפיפות התנועה. רלוונטי להעדפות ניתוב TRAFFIC_AWARE ו-TRAFFIC_AWARE_OPTIMAL. המרווחים מכסים את כל הקו הפוליגוני של RouteLeg ללא חפיפה. נקודת ההתחלה של מרווח מוגדר זהה לנקודת הסיום של המרווח הקודם.

דוגמה:

polyline: A ---- B ---- C ---- D ---- E ---- F ---- G
speedReadingIntervals: [A,C), [C,D), [D,G).

RouteLegLocalizedValues

ייצוגי טקסט של מאפיינים מסוימים.

ייצוג JSON
{
  "distance": {
    object (LocalizedText)
  },
  "duration": {
    object (LocalizedText)
  },
  "staticDuration": {
    object (LocalizedText)
  }
}
שדות
distance

object (LocalizedText)

מרחק הנסיעה מיוצג בפורמט טקסט.

duration

object (LocalizedText)

משך הזמן שהמערכת מביאה בחשבון את מצב התנועה, מיוצגת בפורמט טקסט. הערה: אם לא ביקשתם מידע על תנועה, הערך הזה יהיה זהה לערך staticDuration.

staticDuration

object (LocalizedText)

משך הזמן, מבלי להביא בחשבון את מצב התנועה, מיוצג בפורמט טקסט.

StepsOverview

מספקת מידע כללי על רשימה של RouteLegStep.

ייצוג JSON
{
  "multiModalSegments": [
    {
      object (MultiModalSegment)
    }
  ]
}
שדות
multiModalSegments[]

object (MultiModalSegment)

סיכום של המידע על פלחים שונים במספר מצבים של RouteLeg.steps. השדה הזה לא יאוכלס אם ה-RouteLeg לא מכיל פלחים מרובי-מודאליים בשלבים.

MultiModalSegment

הצגת סיכום של המידע על פלחים שונים במספר מצבים של RouteLeg.steps. מקטע מרובה מצבים מוגדר כ-RouteLegStep רציף אחד או יותר שיש להם אותו RouteTravelMode. השדה הזה לא יאוכלס אם ה-RouteLeg לא מכיל פלחים מרובי-מודאליים בשלבים.

ייצוג JSON
{
  "navigationInstruction": {
    object (NavigationInstruction)
  },
  "travelMode": enum (RouteTravelMode),
  "stepStartIndex": integer,
  "stepEndIndex": integer
}
שדות
navigationInstruction

object (NavigationInstruction)

הוראות ניווט לפלח מרובה מצבים.

travelMode

enum (RouteTravelMode)

מצב המעבר של הקטע מרובה המודלים.

stepStartIndex

integer

האינדקס התואם של RouteLegStep שהוא ההתחלה של מקטע מרובה מצבים.

stepEndIndex

integer

האינדקס המתאים RouteLegStep שהוא הסוף של קטע מרובה מצבים.

אזור התצוגה

אזור תצוגה של קו רוחב, מיוצג בשתי אלכסון מול 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 (LatLng)
  },
  "high": {
    object (LatLng)
  }
}
שדות
low

object (LatLng)

חובה. הנקודה הנמוכה של אזור התצוגה.

high

object (LatLng)

חובה. הנקודה הגבוהה של אזור התצוגה.

RouteLocalizedValues

ייצוגי טקסט של מאפיינים מסוימים.

ייצוג JSON
{
  "distance": {
    object (LocalizedText)
  },
  "duration": {
    object (LocalizedText)
  },
  "staticDuration": {
    object (LocalizedText)
  },
  "transitFare": {
    object (LocalizedText)
  }
}
שדות
distance

object (LocalizedText)

מרחק הנסיעה מיוצג בפורמט טקסט.

duration

object (LocalizedText)

משך הזמן, תוך התייחסות למצב התנועה, מיוצג בפורמט טקסט. הערה: אם לא ביקשתם מידע על תנועה, הערך הזה יהיה זהה לערך של staticDuration.

staticDuration

object (LocalizedText)

משך הזמן, מבלי להביא בחשבון את מצב התנועה, מיוצג בפורמט טקסט.

transitFare

object (LocalizedText)

מחיר הכרטיס לתחבורה הציבורית מיוצג בפורמט טקסט.

GeocodingResults

מכיל GeocodedWaypoints לציון נקודת המוצא, היעד וציוני הדרך הביניים. השדה הזה מאוכלס רק עבור ציוני דרך של כתובות.

ייצוג JSON
{
  "origin": {
    object (GeocodedWaypoint)
  },
  "destination": {
    object (GeocodedWaypoint)
  },
  "intermediates": [
    {
      object (GeocodedWaypoint)
    }
  ]
}
שדות
origin

object (GeocodedWaypoint)

ציון דרך שעבר קידוד גיאוגרפי של המקור.

destination

object (GeocodedWaypoint)

ציון דרך שעבר קידוד גיאוגרפי של היעד.

intermediates[]

object (GeocodedWaypoint)

רשימה של נקודות ציון מתווכות שעברו קידוד גיאוגרפי, שכל אחת מהן מכילה שדה אינדקס שתואם למיקום מבוסס האפס של ציון הדרך לפי הסדר שבו צוינו בבקשה.

GeocodedWaypoint

פרטים על המיקומים שמשמשים כציוני דרך. השדה הזה מאוכלס רק עבור ציוני דרך של כתובות. כולל פרטים על תוצאות הקידוד הגיאוגרפי כדי לקבוע מהי הכתובת שהועתקה לכתובת.

ייצוג JSON
{
  "geocoderStatus": {
    object (Status)
  },
  "type": [
    string
  ],
  "partialMatch": boolean,
  "placeId": string,
  "intermediateWaypointRequestIndex": integer
}
שדות
geocoderStatus

object (Status)

ציון קוד הסטטוס שנוצר מפעולת הקידוד הגיאוגרפי.

type[]

string

סוגי התוצאה, בצורת אפס תגי סוג או יותר. סוגים נתמכים: סוגי כתובות וסוגי רכיבי כתובת.

partialMatch

boolean

מציין שהמקודד הגיאוגרפי לא החזיר התאמה מדויקת לבקשה המקורית, למרות שהוא הצליח להתאים חלק מהכתובת המבוקשת. מומלץ לבדוק את הבקשה המקורית עם שגיאות כתיב ו/או כתובת חלקית.

placeId

string

מזהה המקום של התוצאה הזו.

intermediateWaypointRequestIndex

integer

האינדקס של ציון הדרך המתאים בבקשה. השדה הזה מאוכלס רק אם ציון הדרך המתאים הוא ציון ביניים.