דף זה תורגם על ידי Cloud Translation API.

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

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

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

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

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

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

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

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

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

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

Powered by Google, ©YEAR 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)
    }
  }
  …
]