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

מפתחים באזור הכלכלי האירופי (EEA)

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

מידע על פרטי המסלול בתשובה

תגובת ה-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)
    }
  }
  …
]