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

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