בקשה של מטריצת מסלול מקבלת כמערך מערך של נקודות מוצא ויעד נקודות ציון. לאחר מכן, Routes API מחשב את המסלול מכל מקור ציון דרך לכל ציון דרך של יעד. לדוגמה, אם מציינים שני מקורות ציוני דרך ושתי ציוני דרך ליעד, ה-API מחשב לאחר מכן למסלולים.
תגובת ה-API מכילה מערך, שבו כל רכיב של מערך תואם מסלול מנקודת ציון של נקודת מוצא אחת לנקודת ציון אחת ביעד. לכן, אם לציין שתי ציוני דרך למקור ושתי ציוני דרך ליעד, מערך התגובות מכיל ארבעה רכיבים, אחד לכל מסלול מחושב.
באמצעות התגובה תוכלו לספק ללקוחות אפשרויות שונות למסלול. ואז לאפשר למשתמש לבחור את המסלול המתאים לדרישות שלו.
מידע על מסיכות שדות
כשקוראים לשיטה לחישוב מסלול, צריך לציין שדה מסכה שמגדירה אילו שדות רוצים להחזיר בתשובה. אין ברירת מחדל של השדות שהוחזרו. אם משמיטים את הרשימה הזו, השיטות מחזירות שגיאה.
בדוגמאות שבמסמך הזה אפשר לראות את אובייקט התשובה כולו, בלי לקחת מסכות של שדות. בסביבת ייצור, התשובה שלכם תהיה לכלול רק את השדות שמציינים במפורש במסכת השדות.
מידע נוסף זמין במאמר בחירת המידע שיוחזר.
מידע על הצגת זכויות יוצרים
כשמציגים את התוצאות למשתמשים, צריך לכלול את הצהרת זכויות היוצרים הבאה:
Powered by Google, ©YEAR Google
לדוגמה:
Powered by Google, ©2023 Google
זיהוי הנתיב בתשובה
צריך להשתמש במאפיינים של התגובה originIndex
ו-destinationIndex
כדי לזהות
לכל נתיב בתגובה. המאפיינים האלה מכילים את האינדקס מבוסס-אפס של
הקלט origin ונקודות הדרך destination ששימשו לחישוב
מסלול. כלומר, נקודת הציון הראשונה של היעד וציון הדרך הראשון ליעד
בבקשה נמצאים באינדקס 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) } } … ]