בדיקת התגובה של מטריצת הנתיבים

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

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

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

מידע על מסיכות שדות

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

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

מידע נוסף זמין במאמר בחירת המידע שיוחזר.

מידע על הצגת זכויות יוצרים

כשמציגים את התוצאות למשתמשים, צריך לכלול את הצהרת זכויות היוצרים הבאה:

Powered by Google, ©YEAR Google

לדוגמה:

Powered by Google, ©2023 Google

זיהוי המסלול בתגובה

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

לדוגמה, מסלול בתשובה מכיל:

"originIndex": 1,
"destinationIndex": 0

המאפיינים האלה מציינים שהמסלול חושב מנקודת המוצא (ציון דרך באינדקס 1 במערך הקלט) ומנקודת היעד (ציון דרך באינדקס 0).

למסלול הבא:

"originIndex": 4,
"destinationIndex": 1

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

מידע על המסלול בתשובה

תשובת ה-API מכילה מערך, שכל רכיב בו מגדיר את המסלול מנקודת ציון אחת של מוצא לנקודת ציון אחת של יעד. הרכיבים האלה הם RouteMatrixElements בשיטת gRPC או בגוף התגובה בתגובת ה-HTTP.

בנוסף למאפיינים originIndex ו-destinationIndex, כל רכיב מכיל רק מידע בסיסי שספציפי למסלול הזה, כמו distanceMeters, duration ו-travelAdvisory. כדי לקבל מידע מפורט יותר על מסלול, כמו קו פוליגוני, משתמשים ב-computeRoutes.

התשובה תהיה בפורמט הבא:

[
  // One array element for each combination of origin and destination waypoints.
  {
    // The route for source waypoint 0 and destination waypoint 0.
    "originIndex": 0,
    "destinationIndex": 0,
    "status": {
      object (Status)
    },
    "condition": enum (RouteMatrixElementCondition),
    "distanceMeters": integer,
    "duration": string,
    "staticDuration": string,
    "travelAdvisory": {
      object (RouteTravelAdvisory)
    },
    "fallbackInfo": {
      object (FallbackInfo)
    }
  }
  {
    // The route for source waypoint 0 and destination waypoint 1.
    "originIndex": 0,
    "destinationIndex": 1,
    "status": {
      object (Status)
    },
    "condition": enum (RouteMatrixElementCondition),
    "distanceMeters": integer,
    "duration": string,
    "staticDuration": string,
    "travelAdvisory": {
      object (RouteTravelAdvisory)
    },
    "fallbackInfo": {
      object (FallbackInfo)
    }
  }
  …
]