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

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

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

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

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

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

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

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

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

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

Powered by Google, ©YEAR Google

למשל:

Powered by Google, ©2023 Google

זיהוי הנתיב בתשובה

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

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

"originIndex": 1,
"destinationIndex": 0

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

למסלול הבא:

"originIndex": 4,
"destinationIndex": 1

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

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

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

יחד עם המאפיינים originIndex ו-destinationIndex, כל מסלול מכיל מידע ספציפי לאותו מסלול, כמו distanceMeters, duration ו-travelAdvisory.

התשובה תיראה כך:

[
  // 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)
    }
  }
  …
]