Method: computeRoutes

{
  "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)
  }
}

enum (RouteLabel)

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

object (RouteLeg)

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

integer

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

string (Duration format)

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

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

string (Duration format)

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

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

object (Polyline)

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

string

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

string

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

object (Viewport)

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

object (RouteTravelAdvisory)

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

integer

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

object (RouteLocalizedValues)

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

string

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

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

object (PolylineDetails)

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

{
  "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)
  }
}

integer

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

string (Duration format)

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

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

string (Duration format)

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

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

object (Polyline)

הקו המרובע הכולל של הקטע הזה, שכולל את הקו המרובע של כל step.

object (Location)

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

object (Location)

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

object (RouteLegStep)

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

object (RouteLegTravelAdvisory)

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

object (RouteLegLocalizedValues)

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

object (StepsOverview)

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

{

  // 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.
}

string

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

object (Struct format)

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

{
  "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)
}

integer

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

string (Duration format)

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

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

object (Polyline)

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

object (Location)

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

object (Location)

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

object (NavigationInstruction)

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

object (RouteLegStepTravelAdvisory)

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

object (RouteLegStepLocalizedValues)

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

object (RouteLegStepTransitDetails)

פרטים לגבי השלב הזה אם אופן הנסיעה הוא TRANSIT.

enum (RouteTravelMode)

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

{
  "maneuver": enum (Maneuver),
  "instructions": string
}

enum (Maneuver)

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

string

הוראות לניווט בשלב הזה.

{
  "speedReadingIntervals": [
    {
      object (SpeedReadingInterval)
    }
  ]
}

object (SpeedReadingInterval)

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

{
  "distance": {
    object (LocalizedText)
  },
  "staticDuration": {
    object (LocalizedText)
  }
}

object (LocalizedText)

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

object (LocalizedText)

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

{
  "stopDetails": {
    object (TransitStopDetails)
  },
  "localizedValues": {
    object (TransitDetailsLocalizedValues)
  },
  "headsign": string,
  "headway": string,
  "transitLine": {
    object (TransitLine)
  },
  "stopCount": integer,
  "tripShortText": string
}

object (TransitStopDetails)

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

object (TransitDetailsLocalizedValues)

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

string

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

string (Duration format)

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

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

object (TransitLine)

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

integer

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

stopCount

הפונקציה מחזירה את הערך 3.

string

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

{
  "arrivalStop": {
    object (TransitStop)
  },
  "arrivalTime": string,
  "departureStop": {
    object (TransitStop)
  },
  "departureTime": string
}

object (TransitStop)

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

string (Timestamp format)

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

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

object (TransitStop)

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

string (Timestamp format)

מועד המראה המשוער של השלב.

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

{
  "name": string,
  "location": {
    object (Location)
  }
}

string

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

object (Location)

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

{
  "arrivalTime": {
    object (LocalizedTime)
  },
  "departureTime": {
    object (LocalizedTime)
  }
}

object (LocalizedTime)

הזמן בפורמט טקסט עם אזור זמן תואם.

object (LocalizedTime)

הזמן בפורמט טקסט עם אזור זמן תואם.

{
  "time": {
    object (LocalizedText)
  },
  "timeZone": string
}

object (LocalizedText)

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

string

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

{
  "agencies": [
    {
      object (TransitAgency)
    }
  ],
  "name": string,
  "uri": string,
  "color": string,
  "iconUri": string,
  "nameShort": string,
  "textColor": string,
  "vehicle": {
    object (TransitVehicle)
  }
}

object (TransitAgency)

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

string

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

string

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

string

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

string

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

string

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

string

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

object (TransitVehicle)

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

{
  "name": string,
  "phoneNumber": string,
  "uri": string
}

string

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

string

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

string

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

{
  "name": {
    object (LocalizedText)
  },
  "type": enum (TransitVehicleType),
  "iconUri": string,
  "localIconUri": string
}

object (LocalizedText)

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

enum (TransitVehicleType)

סוג הרכב שבו נעשה שימוש.

string

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

string

ה-URI של הסמל המשויך לסוג הרכב הזה, על סמך סמלי התחבורה המקומית.

{
  "tollInfo": {
    object (TollInfo)
  },
  "speedReadingIntervals": [
    {
      object (SpeedReadingInterval)
    }
  ]
}

object (TollInfo)

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

object (SpeedReadingInterval)

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

דוגמה:

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

{
  "distance": {
    object (LocalizedText)
  },
  "duration": {
    object (LocalizedText)
  },
  "staticDuration": {
    object (LocalizedText)
  }
}

object (LocalizedText)

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

object (LocalizedText)

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

object (LocalizedText)

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

{
  "multiModalSegments": [
    {
      object (MultiModalSegment)
    }
  ]
}

object (MultiModalSegment)

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

{
  "navigationInstruction": {
    object (NavigationInstruction)
  },
  "travelMode": enum (RouteTravelMode),
  "stepStartIndex": integer,
  "stepEndIndex": integer
}

object (NavigationInstruction)

NavigationInstruction לפלח מרובה המצבים.

enum (RouteTravelMode)

אמצעי התחבורה של הפלח הרב-מודלי.

integer

האינדקס התואם של RouteLegStep, שהוא ההתחלה של פלח רב-מודלי.

integer

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

{
  "low": {
    object (LatLng)
  },
  "high": {
    object (LatLng)
  }
}

object (LatLng)

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

object (LatLng)

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

{
  "distance": {
    object (LocalizedText)
  },
  "duration": {
    object (LocalizedText)
  },
  "staticDuration": {
    object (LocalizedText)
  },
  "transitFare": {
    object (LocalizedText)
  }
}

object (LocalizedText)

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

object (LocalizedText)

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

object (LocalizedText)

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

object (LocalizedText)

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

{
  "flyoverInfo": [
    {
      object (FlyoverInfo)
    }
  ],
  "narrowRoadInfo": [
    {
      object (NarrowRoadInfo)
    }
  ]
}

object (FlyoverInfo)

פרטי מעבר בגובה נמוך לאורך הקו הפוליגוני.

object (NarrowRoadInfo)

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

{
  "flyoverPresence": enum (RoadFeatureState),
  "polylinePointIndex": {
    object (PolylinePointIndex)
  }
}

enum (RoadFeatureState)

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

object (PolylinePointIndex)

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

{
  "startIndex": integer,
  "endIndex": integer
}

integer

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

integer

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

{
  "narrowRoadPresence": enum (RoadFeatureState),
  "polylinePointIndex": {
    object (PolylinePointIndex)
  }
}

enum (RoadFeatureState)

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

object (PolylinePointIndex)

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

{
  "origin": {
    object (GeocodedWaypoint)
  },
  "destination": {
    object (GeocodedWaypoint)
  },
  "intermediates": [
    {
      object (GeocodedWaypoint)
    }
  ]
}

object (GeocodedWaypoint)

נקודת ציון במקור שהומרו לה קואורדינטות.

object (GeocodedWaypoint)

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

object (GeocodedWaypoint)

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

{
  "geocoderStatus": {
    object (Status)
  },
  "type": [
    string
  ],
  "partialMatch": boolean,
  "placeId": string,
  "intermediateWaypointRequestIndex": integer
}

object (Status)

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

string

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

boolean

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

string

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

integer

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