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

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

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 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 (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, השדה הזה מכיל את הסדר האופטימלי של נקודות הביניים. אחרת, השדה הזה ריק. לדוגמה, אם הקלט הוא Origin: LA; Intermediate waypoints: Dallas, Bangor, Phoenix; Destination: New York;‎ והסדר האופטימלי של נקודות הביניים הוא Phoenix, Dallas, Bangor, אז השדה הזה מכיל את הערכים [2, 0, 1]. האינדקס מתחיל ב-0 עבור נקודת הביניים הראשונה שמופיעה בקלט.

localizedValues

object (RouteLocalizedValues)

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

routeToken

string

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

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

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
{

  // 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)

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

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 (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)

מציין את הזמן הצפוי כמשך הזמן בין היציאות מאותה תחנה בשעה הזו. לדוגמה, אם הערך של headway seconds הוא 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. אם השדה הזה מוגדר אבל שדה המשנה estimatedPrice לא מאוכלס, אנחנו מניחים שבכביש יש אגרה אבל אנחנו לא יודעים את המחיר המשוער. אם השדה הזה לא קיים, לא חל תשלום על 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

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

ייצוג ב-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
{
  "flyoverInfo": [
    {
      object (FlyoverInfo)
    }
  ],
  "narrowRoadInfo": [
    {
      object (NarrowRoadInfo)
    }
  ]
}
שדות
flyoverInfo[]

object (FlyoverInfo)

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

narrowRoadInfo[]

object (NarrowRoadInfo)

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

FlyoverInfo

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

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

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

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

NarrowRoadInfo

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

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

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

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

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

object (Status)

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

type[]

string

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

partialMatch

boolean

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

placeId

string

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

intermediateWaypointRequestIndex

integer

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