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

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

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

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

בנוסף למאפיינים originIndex ו-destinationIndex, כל רכיב מכיל רק מידע בסיסי שספציפי למסלול הזה, כמו distanceMeters, duration ו-travelAdvisory. כדי לקבל מידע מפורט יותר על מסלול, כמו קו פוליגוני, משתמשים ב-computeRoutes.

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

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