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

הקו הפוליגוני הכולל עבור קטע זה. כולל קו 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. מחזירה את סוג הקו polyline. ברירת המחדל היא code_polyline. הערך של polyline_type יכול להיות רק אחת מהאפשרויות הבאות:
encodedPolyline

string

קידוד המחרוזת של הקו מרובה באמצעות אלגוריתם הקידוד של polyline
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)

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

דוגמה:

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

RouteLegTravelAdvisory

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

ייצוג JSON 
{
  "tollInfo": {
    object (TollInfo)
  },
  "speedReadingIntervals": [
    {
      object (SpeedReadingInterval)
    }
  ]
}
שדות
tollInfo

object (TollInfo)

כולל מידע לגבי כבישי אגרה ב-RouteLeg הספציפי. השדה הזה יאוכלס רק אם אנחנו צופים שיהיו כבישי אגרה ב-RouteLeg. אם שדה זה מוגדר אך שדה המשנה ההודעה המשוערתPrice לא מאוכלס, אנו צופים שכביש זה יכיל כבישי אגרה, אך איננו יודעים מחיר משוער. אם השדה הזה לא קיים, לא יחול אגרה על RouteLeg.
speedReadingIntervals[]

object (SpeedReadingInterval)

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

דוגמה:

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