Route

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

ייצוג JSON 
{
  "legs": [
    {
      object (RouteLeg)
    }
  ],
  "distanceMeters": integer,
  "duration": string,
  "staticDuration": string,
  "polyline": {
    object (Polyline)
  },
  "description": string,
  "warnings": [
    string
  ],
  "viewport": {
    object (Viewport)
  },
  "travelAdvisory": {
    object (RouteTravelAdvisory)
  },
  "optimizedIntermediateWaypointIndex": [
    integer
  ]
}
שדות
legs[]

object (RouteLeg)

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

אם השדה ComputeRoutesRequest.optimize_waypoint_order מוגדר כ-true, הוא מכיל את הסדר המותאם של נקודות הדרך הביניים. אחרת, השדה הזה ריק. לדוגמה, נניח שהקלט הוא: מוצא: LA; תחנות ביניים: Dallas,‏ Bangor,‏ Phoenix; יעד: New York, והסדר האופטימלי של נקודות הציון הביניים הוא: Phoenix,‏ Dallas,‏ Bangor. השדה הזה מכיל את הערכים [2, 0, 1]. האינדקס מתחיל ב-0 לציון ציון הביניים הראשון.

RouteLeg

רכיב שמכיל קטע בין נקודות דרך שאינן מסוג via.

ייצוג JSON 
{
  "distanceMeters": integer,
  "duration": string,
  "staticDuration": string,
  "polyline": {
    object (Polyline)
  },
  "startLocation": {
    object (Location)
  },
  "endLocation": {
    object (Location)
  },
  "steps": [
    {
      object (RouteLegStep)
    }
  ],
  "travelAdvisory": {
    object (RouteLegTravelAdvisory)
  }
}
שדות
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)

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

מצולע פתוח

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

ייצוג 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)
  }
}
שדות
distanceMeters

integer

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

string (Duration format)

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

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

object (Polyline)

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

object (Location)

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

object (Location)

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

object (NavigationInstruction)

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

object (RouteLegStepTravelAdvisory)

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

RouteLegStepTravelAdvisory

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

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

object (SpeedReadingInterval)

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

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