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

בקשה למטריצה של מסלולים מקבלת כקלט מערך של נקודות ציון למקור וליעד. לאחר מכן, 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)
    }
  }
  …
]