Method: computeRoutes

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

הערה: השיטה הזו מחייבת לציין אנונימיזציה של שדה תגובה בקלט. אפשר לספק את האנונימיזציה של שדות התגובה באמצעות הפרמטר $fields או fields של כתובת ה-URL, או באמצעות כותרת HTTP/gRPC X-Goog-FieldMask (מידע נוסף זמין בקטע הכותרות והפרמטרים הזמינים של כתובות אתרים). הערך הוא רשימה של נתיבי שדות שמופרדים בפסיקים. אפשר לקרוא הסבר מפורט על התהליך של בניית נתיבי השדות.

לדוגמה, בשיטה הזו:

  • אנונימיזציה של שדות בכל השדות הזמינים (לבדיקה ידנית): 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, עם רזולוציה של ננו-שנייה ועד תשע ספרות עשרוניות. דוגמאות: "2014-10-02T15:01:23Z" ו-"2014-10-02T15:01:23.045123456Z".
arrivalTime

string (Timestamp format)

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

חותמת זמן בפורמט "זולו" RFC3339 UTC, עם רזולוציה של ננו-שנייה ועד תשע ספרות עשרוניות. דוגמאות: "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

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

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

PolylineEncoding

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

טיפוסים בני מנייה (enums)
POLYLINE_ENCODING_UNSPECIFIED לא צוינה העדפה לסוג של קו פוליגוני. ברירת המחדל היא ENCODED_POLYLINE.
ENCODED_POLYLINE ההגדרה קובעת איזה קו פוליגוני מקודד באמצעות אלגוריתם הקידוד של קו פוליגוני.
GEO_JSON_LINESTRING מציין קו פוליגוני באמצעות פורמט GeoJSON LineString

ReferenceRoute

נתיב הפניה נתמך ב-ComputeRoutesRequest.

טיפוסים בני מנייה (enums)
REFERENCE_ROUTE_UNSPECIFIED לא בשימוש. בקשות שמכילות את הערך הזה נכשלות.
FUEL_EFFICIENT מסלול חסכוני בדלק. מסלולים שמסומנים בערך הזה מותאמים לפרמטרים כמו צריכת דלק.

ExtraComputation

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

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

object (RouteLocalizedValues)

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

string

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

RouteLabel

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

טיפוסים בני מנייה (enums)
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. כולל את סוג הקו הפוליגוני. ברירת המחדל היא coding_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)

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

תמרון

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

טיפוסים בני מנייה (enums)
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 הוא 600, הייתם מצפים להמתנה של עשר דקות אם אתם מפספסים את האוטובוס.

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

object (TransitLine)

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

integer

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

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

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

object (TransitStop)

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

string (Timestamp format)

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

חותמת זמן בפורמט "זולו" RFC3339 UTC, עם רזולוציה של ננו-שנייה ועד תשע ספרות עשרוניות. דוגמאות: "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

סוג כלי הרכב עבור מסלולי תחבורה ציבורית.

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

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