RouteMatrixElement

מבצעת אנקפסולציה של פרטי המסלול שמחושבים עבור צמד מקור/יעד ב-v1alpha.computeRouteMatrix API. ניתן לשדר את קובץ ה-proto ללקוח.

ייצוג JSON 
{
  "originIndex": integer,
  "destinationIndex": integer,
  "status": {
    object (Status)
  },
  "condition": enum (RouteMatrixElementCondition),
  "distanceMeters": integer,
  "duration": string,
  "staticDuration": string,
  "travelAdvisory": {
    object (RouteTravelAdvisory)
  },
  "fallbackInfo": {
    object (FallbackInfo)
  }
}
שדות
originIndex

integer

אינדקס מבוסס-אפס של המקור בבקשה.
destinationIndex

integer

אינדקס מבוסס-אפס של היעד בבקשה.
status

object (Status)

קוד מצב שגיאה של הרכיב הזה.
condition

enum (RouteMatrixElementCondition)

מציין אם המסלול נמצא או לא. אינו תלוי בסטטוס.
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".
travelAdvisory

object (RouteTravelAdvisory)

מידע נוסף על המסלול. לדוגמה: מידע על ההגבלות ומידע על כבישי אגרה
fallbackInfo

object (FallbackInfo)

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

סטטוס

הסוג Status מגדיר מודל שגיאה לוגית שמתאים לסביבות תכנות שונות, כולל ממשקי REST API ו-RPC API. הוא משמש את gRPC. כל הודעת Status מכילה שלושה קטעי נתונים: קוד שגיאה, הודעת שגיאה ופרטי שגיאה.

מידע נוסף על מודל השגיאה הזה והסבר על השימוש בו זמין במדריך לעיצוב API.

ייצוג JSON 
{
  "code": integer,
  "message": string,
  "details": [
    {
      "@type": string,
      field1: ...,
      ...
    }
  ]
}
שדות
code

integer

קוד הסטטוס, שצריך להיות ערך 'טיפוסים בני מנייה (enum)' google.rpc.Code.
message

string

הודעת שגיאה למפתחים, שאמורה להיות באנגלית. כל הודעת שגיאה שמוצגת למשתמש צריכה להיות מותאמת לשוק המקומי ולשלוח אותה בשדה google.rpc.Status.details, או לתרגם אותה על ידי הלקוח.
details[]

object

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

אובייקט שמכיל שדות מסוג שרירותי. שדה נוסף "@type" מכיל URI שמזהה את הסוג. דוגמה: { "id": 1234, "@type": "types.example.com/standard/id" }