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

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

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

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