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
}

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)

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

object (RouteTravelAdvisory)

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

integer

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

object (RouteLocalizedValues)

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

string

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

{
  "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). השדה הזה מאוכלס רק במסלולי TRANSIT.

{

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

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

string

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

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

object (TransitStop)

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

string (Timestamp format)

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

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

object (TransitStop)

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

string (Timestamp format)

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

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

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

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)

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

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

object (GeocodedWaypoint)

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

object (GeocodedWaypoint)

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

object (GeocodedWaypoint)

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

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

object (Status)

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

string

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

boolean

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

string

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

integer

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