Method: computeRoutes

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

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

הפורמט הוא RFC 3339, והפלט שנוצר תמיד יהיה בפורמט Z עם 0, 3, 6 או 9 ספרות אחרי הנקודה העשרונית. אפשר להשתמש גם בהיסטים אחרים, לא רק ב-Z. דוגמאות: "2014-10-02T15:01:23Z", ‏ "2014-10-02T15:01:23.045123456Z" או "2014-10-02T15:01:23+05:30".
arrivalTime

string (Timestamp format)

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

הפורמט הוא RFC 3339, והפלט שנוצר תמיד יהיה בפורמט Z עם 0, 3, 6 או 9 ספרות אחרי הנקודה העשרונית. אפשר להשתמש גם בהיסטים אחרים, לא רק ב-Z. דוגמאות: "2014-10-02T15:01:23Z", ‏ "2014-10-02T15:01:23.045123456Z" או "2014-10-02T15:01:23+05:30".
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 כדי למצוא את הסדר החדש. אם לא מציינים את ComputeRoutesResponse.routes.optimized_intermediate_waypoint_index בכותרת X-Goog-FieldMask, הבקשה תיכשל. אם המדיניות optimizeWaypointOrder מוגדרת כ-False, השדה ComputeRoutesResponse.optimized_intermediate_waypoint_index יהיה ריק.
requestedReferenceRoutes[]

enum (ReferenceRoute)

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

enum (ExtraComputation)

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

enum (TrafficModel)

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

מכיל מידע על תגובת המרת כתובות לקואורדינטות (geocoding) לנקודות ציון שצוינו ככתובות.

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

מסלול עם מרחק נסיעה קצר יותר. זו תכונה ניסיונית.

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

עבור בקשות BICYCLE ו-TWO_WHEELER, התכונה הזו מחזירה מסלולים דומים לאלה שמוחזרים כשלא מציינים requestedReferenceRoutes.

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

ExtraComputation

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

טיפוסים בני מנייה (enum)
EXTRA_COMPUTATION_UNSPECIFIED לא בשימוש. בקשות שמכילות את הערך הזה ייכשלו.
TOLLS מידע על אגרות בכבישים במסלולים.
FUEL_CONSUMPTION צריכת הדלק המשוערת במסלול או במסלולים.
TRAFFIC_ON_POLYLINE קווים פוליגוניים מודעים לתנועה עבור המסלולים.
HTML_FORMATTED_NAVIGATION_INSTRUCTIONS ‫NavigationInstruction מוצג כמחרוזת טקסט בפורמט HTML. התוכן הזה נועד לקריאה כמו שהוא. התוכן הזה מיועד לתצוגה בלבד. אל תנתחו אותו באופן פרוגרמטי.
FLYOVER_INFO_ON_POLYLINE מידע על מעבר מעל המסלול או המסלולים. כדי לקבל את המידע הזה, צריך לציין את routes.polyline_details.flyover_info fieldmask. בשלב הזה, הנתונים האלה יאוכלסו רק לגבי אזורי מטרופולין מסוימים בהודו. התכונה הזו ניסיונית, והמק"ט או החיוב עשויים להשתנות.
NARROW_ROAD_INFO_ON_POLYLINE מידע על כבישים צרים במסלול או במסלולים. כדי לקבל את המידע הזה, צריך לציין את routes.polyline_details.narrow_road_info fieldmask. בשלב הזה, הנתונים האלה יאוכלסו רק לגבי אזורי מטרופולין מסוימים בהודו. התכונה הזו ניסיונית, והמק"ט או החיוב עשויים להשתנות.
TUNNEL_INFO_ON_POLYLINE מידע על המנהרה במסלול. כדי לקבל את המידע הזה, צריך לציין את routes.polyline_details.tunnel_info fieldmask.
BRIDGE_INFO_ON_POLYLINE מידע על הגשרים במסלול או במסלולים. כדי לקבל את המידע הזה, צריך לציין את routes.polyline_details.bridge_info fieldmask.
SKYWAY_INFO_ON_POLYLINE מידע על נתיבי אוויר למסלולים. כדי לקבל את המידע הזה, צריך לציין את routes.polyline_details.skyway_info fieldmask.

מסלול

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

ייצוג ב-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,
  "polylineDetails": {
    object (PolylineDetails)
  }
}
שדות
routeLabels[]

enum (RouteLabel)

תוויות ל-Route שימושיות לזיהוי מאפיינים ספציפיים של המסלול לצורך השוואה למסלולים אחרים.
legs[]

object (RouteLeg)

אוסף של קטעי מסלול (קטעי נתיב בין נקודות ציון) שמרכיבים את המסלול. כל קטע טיסה מתאים לנסיעה בין שני יעדים שאינם via Waypoints. לדוגמה, למסלול בלי נקודות ציון ביניים יש רק רגל אחת. מסלול שכולל נקודת ציון אחת שאינה 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, השדה הזה מכיל את הסדר האופטימלי של נקודות הביניים. אחרת, השדה הזה ריק. לדוגמה, אם נותנים קלט של מוצא: לוס אנג'לס; נקודות עצירה ביניים: דאלאס, בנגור, פיניקס; יעד: ניו יורק; וסדר נקודות העצירה האופטימלי הוא פיניקס, דאלאס, בנגור, אז השדה הזה מכיל את הערכים [2, 0, 1]. האינדקס מתחיל ב-0 עבור נקודת הביניים הראשונה שמופיעה בקלט.
localizedValues

object (RouteLocalizedValues)

ייצוגים של מאפיינים של Route.
routeToken

string

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

הערה: Route.route_token זמין רק לבקשות שבהן הערך של ComputeRoutesRequest.routing_preference הוא TRAFFIC_AWARE או TRAFFIC_AWARE_OPTIMAL. אין תמיכה בפרמטר Route.route_token בבקשות עם נקודות ציון למעבר.
polylineDetails

object (PolylineDetails)

מכיל מידע על פרטים לאורך הקו המרובה.

RouteLabel

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

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

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. השדה הזה מאוכלס רק במסלולים של תחבורה ציבורית.

מצולע פתוח

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

ייצוג ב-JSON 
{

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "encodedPolyline": string,
  "geoJsonLinestring": {
    object
  }
  // End of mutually exclusive fields.
}
שדות
מכיל את סוג הקו הפוליגוני. ברירת המחדל היא encoded_polyline. הרשימה הבאה כוללת שדות שאי אפשר להשתמש בהם בו-זמנית. בכל תשובה יוגדר לכל היותר אחד מהשדות:
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 משמש לציון שינוי בשם רחוב.
DESTINATION משמש לציון הגעה ליעד.

RouteLegStepTravelAdvisory

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

ייצוג ב-JSON 
{
  "speedReadingIntervals": [
    {
      object (SpeedReadingInterval)
    }
  ]
}
שדות
speedReadingIntervals[]

object (SpeedReadingInterval)

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

RouteLegStepLocalizedValues

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

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

object (LocalizedText)

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

object (LocalizedText)

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

RouteLegStepTransitDetails

מידע נוסף על מסלולי TRANSIT שרלוונטי ל-RouteLegStep.

ייצוג ב-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

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

string

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

TransitStopDetails

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

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

object (TransitStop)

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

string (Timestamp format)

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

הפורמט הוא RFC 3339, והפלט שנוצר תמיד יהיה בפורמט Z עם 0, 3, 6 או 9 ספרות אחרי הנקודה העשרונית. אפשר להשתמש גם בהיסטים אחרים, לא רק ב-Z. דוגמאות: "2014-10-02T15:01:23Z", ‏ "2014-10-02T15:01:23.045123456Z" או "2014-10-02T15:01:23+05:30".
departureStop

object (TransitStop)

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

string (Timestamp format)

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

הפורמט הוא RFC 3339, והפלט שנוצר תמיד יהיה בפורמט Z עם 0, 3, 6 או 9 ספרות אחרי הנקודה העשרונית. אפשר להשתמש גם בהיסטים אחרים, לא רק ב-Z. דוגמאות: "2014-10-02T15:01:23Z", ‏ "2014-10-02T15:01:23.045123456Z" או "2014-10-02T15:01:23+05:30".

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 והפרמטר TOLLS נכלל בפרמטר ComputeRoutesRequest.extra_computations של הבקשה. אם השדה הזה מוגדר אבל שדה המשנה estimatedPrice לא מאוכלס, אנחנו מניחים שבכביש יש אגרה אבל אנחנו לא יודעים את המחיר המשוער. אם התג tollInfo לא קיים, לא חל תשלום על RouteLeg.
speedReadingIntervals[]

object (SpeedReadingInterval)

מרווחי קריאה מהירה שמציינים את צפיפות התנועה. השדה הזה מאוכלס רק בבקשות שבהן הערך של TRAFFIC_AWARE או TRAFFIC_AWARE_OPTIMAL הוא ComputeRoutesRequest.routing_preference, והערך TRAFFIC_ON_POLYLINE נכלל ב-ComputeRoutesRequest.extra_computations. המרווחים מכסים את כל הקו המקומפל של 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)

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

PolylineDetails

פרטים שמתאימים לאינדקס נתון או לפלח רציף של קו פוליגוני. בהינתן קו פוליגוני עם נקודות P_0, ‏ P_1,‏ ... , ‏ P_N (אינדקס מבוסס-אפס), PolylineDetails מגדיר מרווח ומטא-נתונים משויכים.

ייצוג ב-JSON 
{
  "tunnelInfo": [
    {
      object (TunnelInfo)
    }
  ],
  "restrictionInfo": [
    {
      object (RestrictionInfo)
    }
  ],
  "flyoverInfo": [
    {
      object (FlyoverInfo)
    }
  ],
  "narrowRoadInfo": [
    {
      object (NarrowRoadInfo)
    }
  ],
  "bridgeInfo": [
    {
      object (BridgeInfo)
    }
  ],
  "skywayInfo": [
    {
      object (SkywayInfo)
    }
  ]
}
שדות
tunnelInfo[]

object (TunnelInfo)

פרטי המנהרה לאורך הקו הפוליגוני. השדה הזה יאוכלס אם בבקשה מצוין משנה המסלול avoidTunnels והמסלול שמתקבל לא עוקף אותם, או אם TUNNEL_INFO_ON_POLYLINE מצוין ב-extraComputations והמסלול מכיל מנהרות.
restrictionInfo[]

object (RestrictionInfo)

פרטי ההגבלה לאורך הקו. השדה הזה מאוכלס רק אם בבקשה מצוין משנה המסלול vehicleInfo והמסלול שמתקבל מכיל הגבלה רלוונטית. בכל שאר המקרים, השדה הזה לא בשימוש.
flyoverInfo[]

object (FlyoverInfo)

פרטים על המעוף מעל האזור לאורך הקו הפוליגוני.
narrowRoadInfo[]

object (NarrowRoadInfo)

פרטים על כביש צר לאורך הקו הפוליגוני.
bridgeInfo[]

object (BridgeInfo)

פרטי הגשר לאורך הקו הפוליגוני.
skywayInfo[]

object (SkywayInfo)

פרטי Skyway לאורך הקו הפוליגוני.

TunnelInfo

האלמנט הזה מכיל מידע על מנהרות לאורך הקו הפוליגוני.

ייצוג ב-JSON 
{
  "tunnelPresence": enum (RoadFeatureState),
  "polylinePointIndex": {
    object (PolylinePointIndex)
  }
}
שדות
tunnelPresence

enum (RoadFeatureState)

מציין אם קיים מנהור עבור קטע נתון של הקו הפוליגוני.
polylinePointIndex

object (PolylinePointIndex)

המיקום של מידע שקשור למנהרה לאורך הקו הפוליגוני.

RoadFeatureState

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

טיפוסים בני מנייה (enum)
ROAD_FEATURE_STATE_UNSPECIFIED המצב של מאפיין הכביש לא חושב (ערך ברירת המחדל).
EXISTS מאפיין הכביש קיים.
DOES_NOT_EXIST תכונת הכביש לא קיימת.

PolylinePointIndex

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

ייצוג ב-JSON 
{
  "startIndex": integer,
  "endIndex": integer
}
שדות
startIndex

integer

אינדקס ההתחלה של הפרט הזה בקו המעוקל.
endIndex

integer

אינדקס הסיום של הפרט הזה בקו הפוליגוני.

RestrictionInfo

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

ייצוג ב-JSON 
{
  "restrictionPresence": enum (RoadFeatureState),
  "polylinePointIndex": {
    object (PolylinePointIndex)
  },

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "restrictedHeightMm": string,
  "restrictedWeightKg": string,
  "hazardousGoods": boolean,
  "trucksProhibited": boolean
  // End of mutually exclusive fields.
}
שדות
restrictionPresence

enum (RoadFeatureState)

פלט בלבד. מציין אם קיימת הגבלה לקטע נתון של הקו הפוליגוני.
polylinePointIndex

object (PolylinePointIndex)

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

string (int64 format)

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

string (int64 format)

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

boolean

השדה הזה מוגדר כ-true אם יש הגבלה על הובלת סחורות מסוכנות.
trucksProhibited

boolean

השדה הזה מוגדר כ-true כשהכניסה למשאיות אסורה.
סוף השדות הבלעדיים.

FlyoverInfo

כולל מידע על מעברים מעל קו הפוליגון.

ייצוג ב-JSON 
{
  "flyoverPresence": enum (RoadFeatureState),
  "polylinePointIndex": {
    object (PolylinePointIndex)
  }
}
שדות
flyoverPresence

enum (RoadFeatureState)

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

object (PolylinePointIndex)

המיקום של מידע שקשור לטיסה מעל קו הפוליגון.

NarrowRoadInfo

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

ייצוג ב-JSON 
{
  "narrowRoadPresence": enum (RoadFeatureState),
  "polylinePointIndex": {
    object (PolylinePointIndex)
  }
}
שדות
narrowRoadPresence

enum (RoadFeatureState)

פלט בלבד. מציין אם קיים כביש צר בקטע מסוים של הקו המקוקו.
polylinePointIndex

object (PolylinePointIndex)

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

BridgeInfo

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

ייצוג ב-JSON 
{
  "bridgePresence": enum (RoadFeatureState),
  "polylinePointIndex": {
    object (PolylinePointIndex)
  }
}
שדות
bridgePresence

enum (RoadFeatureState)

מציין אם יש גשר בקטע מסוים של הקו הפוליגוני.
polylinePointIndex

object (PolylinePointIndex)

המיקום של מידע שקשור לגשר לאורך הקו הפוליגוני.

SkywayInfo

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

ייצוג ב-JSON 
{
  "skywayPresence": enum (RoadFeatureState),
  "polylinePointIndex": {
    object (PolylinePointIndex)
  }
}
שדות
skywayPresence

enum (RoadFeatureState)

מציין אם יש גשר עילי בקטע מסוים של הקו הפוליגוני.
polylinePointIndex

object (PolylinePointIndex)

המיקום של מידע שקשור לגשר עילי לאורך הקו הפוליגוני.

GeocodingResults

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

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

object (GeocodedWaypoint)

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

object (GeocodedWaypoint)

נקודת ציון גיאוגרפית של היעד.
intermediates[]

object (GeocodedWaypoint)

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

GeocodedWaypoint

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

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

object (Status)

קוד הסטטוס שמתקבל מפעולת הגיאו-קידוד.
type[]

string

סוג התוצאה, בצורה של תגי סוג אחד או יותר. סוגים נתמכים: סוגי כתובות וסוגי רכיבי כתובות.
partialMatch

boolean

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

string

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

integer

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