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

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

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

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

מידע על אנונימיזציה של שדות

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

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

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

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

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

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 במערך הקלט.

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

אובייקט ה-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)
    }
  }
  …
]