סוגים זמינים של כלי מטריצת מסלולים

אפשר לקבל מטריצת מסלולים לסוגים שונים של כלי רכב. כדי להגדיר את אמצעי התחבורה בבקשת HTTP POST ב-computeRouteMatrix, מעבירים את השדה travelMode בגוף הבקשה בפורמט JSON באמצעות ערך enum של RouteTravelMode. אם לא מציינים ערך ל-travelMode, ‏Routes API משתמש בערך ברירת המחדל DRIVE.

אתם יכולים לבחור נהיגה, רכב דו-גלגלי, תחבורה ציבורית, משאיות או הליכה. רכיבה על אופניים (BICYCLE) לא נתמכת במטריצות של מסלולים.

סוג הרכב	ערך של RouteTravelMode	תיאור
Drive	DRIVE	חישוב מטריצת מסלולי נסיעה. DRIVE היא ברירת המחדל אם לא מציינים סוג כלי רכב.
רכב דו-גלגלי	TWO_WHEELER	כדי לציין מטריצת מסלולים לרכב דו-גלגלי ממונע, משתמשים בשדה travelMode באותו אופן שבו מציינים אותה למסלול.
תחבורה ציבורית	TRANSIT	מקבלים מטריצת מסלולים של תחבורה ציבורית שמשתמשת באפשרויות התחבורה הציבורית שזמינות באזור. אפשרויות התחבורה הציבורית יכולות לכלול אוטובוסים, רכבות תחתיות, רכבות ועוד.
משאית	TRUCK	חישוב זמני הגעה ומרחקים למטריצה של נקודות מוצא ויעדים באמצעות ניתוב של כלי רכב גדולים. ציינו את המאפיינים הפיזיים של הרכבים שלכם ב-origins[].routeModifiers.vehicleInfo כדי לקבל אומדנים מדויקים שמביאים בחשבון את המשקל, הגובה וההגבלות על חומרים מסוכנים.
הליכה	WALK	חישוב מטריצת מסלול הליכה.

ציון אמצעי התחבורה בבקשה

כדי לציין אמצעי הגעה בבקשה ל-computeRouteMatrix, מגדירים את השדה travelMode בגוף הבקשה בפורמט JSON של HTTP POST וכוללים את הכותרת הנדרשת X-Goog-FieldMask כדי לבחור את שדות התגובה של RouteMatrixElement שאתם צריכים. אם אתם עוברים מהגרסה הקודמת של Distance Matrix API, השדה travelMode בגוף הבקשה בפורמט JSON של POST מחליף את הפרמטר mode של שאילתת ה-URL בגרסה הקודמת. מידע נוסף זמין במאמר מעבר ל-Routes API.

curl -X POST -d '{
  "origins": [
    {
      "waypoint": {
        "location": {
          "latLng": {
            "latitude": 37.420761,
            "longitude": -122.081356
          }
        }
      }
    }
  ],
  "destinations": [
    {
      "waypoint": {
        "location": {
          "latLng": {
            "latitude": 37.420999,
            "longitude": -122.086894
          }
        }
      }
    }
  ],
  "travelMode": "WALK"
}' \
-H 'Content-Type: application/json' -H 'X-Goog-Api-Key: YOUR_API_KEY' \
-H 'X-Goog-FieldMask: originIndex,destinationIndex,duration,distanceMeters,status,condition' \
'https://routes.googleapis.com/distanceMatrix/v2:computeRouteMatrix'