אחזור של טוקן מסלול

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

כדי לבקש שהשיטה Compute Routes תחזיר טוקנים של מסלולים שנוצרו, פועלים לפי השלבים הבאים:

  1. מגדירים את הפרמטרים הבאים שנדרשים כדי להחזיר טוקן מסלול:
    • מגדירים את travelMode לערך DRIVE או TWO_WHEELER.
    • מגדירים את routingPreference לערך TRAFFIC_AWARE או TRAFFIC_AWARE_OPTIMAL.
  2. מציינים את מיקומי המוצא והיעד. אתם יכולים לציין מיקומים שמתאימים לתרחיש לדוגמה שלכם, באמצעות: קואורדינטות של קו רוחב וקו אורך, מחרוזות של כתובות, אסימונים של נקודות ניווט או מזהי מקומות. אפשרויות לציון מיקום
  3. מוודאים שאף אחת מנקודות הדרך במסלול היא לא נקודת דרך מסוג Via.
  4. מציינים את מסכת השדות routes.routeToken כדי להחזיר טוקן מסלול:

    X-Goog-FieldMask: routes.routeToken
    

אתם יכולים להשתמש בטוקן המסלול למסלול המתוכנן ב-Navigation SDK. לפרטים נוספים:

דוגמה לטוקן של מסלול

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

curl -X POST -d
{"origin":{
    "location": {
        "latLng":{
            "latitude":  -37.8167,
            "longitude": 144.9619
        }
    }
},
"destination":{
    "location": {
        "latLng":{
            "latitude":-37.8155,
            "longitude": 144.9663
        }
    }
},
"routingPreference":"TRAFFIC_AWARE",
"travelMode":"DRIVE"
}
-H 'X-Goog-Api-Key: YOUR_API_KEY' \
-H X-Goog-FieldMask: routes.routeToken,routes.duration,routes.distanceMeters,routes.polyline.encodedPolyline
'https://routes.googleapis.com/directions/v2:computeRoutes'

לפרטים נוספים, עיינו במאמרי העזרה של Compute Routes API.