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

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

טוקנים של נקודות ניווט מאפשרים לכם לשלוח מידע הקשרי חשוב על יעד אל Navigation SDK for Android כדי לשפר את הניתוב ואת חוויית הנהיגה. האפשרות הזו שימושית במקרים כמו משלוחי מזון או שיתוף נסיעות, שבהם נקודת האיסוף או ההורדה עשויה להיות לא ברורה בלי קלט מהמשתמש.

בתמונה הזו מוצגות דוגמאות לאפליקציה לצרכנים לשיתוף נסיעות שבה נבחרה נקודת הניווט, ולאפליקציה לנהגים שמשתמשת ב-Navigation SDK ל-Android כדי לתכנן מסלול מדויק לנהג.

דוגמאות לאפליקציות לצרכנים ולאפליקציות לנהגים

כדי ליצור ולהעביר אסימון של נקודת ניווט, משתמשים בנקודת הקצה Destinations של Geocoding API כדי לאפשר למשתמשים לבחור מיקום מועדף מתוך רשימה של נקודות ניווט. הבחירה של המשתמש הופכת לנקודת ניווט שמוחזרת על ידי נקודת הקצה Destinations של Geocoding API. לאחר מכן אפשר להעביר את טוקן נקודת הניווט, שמכיל גם את קואורדינטות היעד וגם מידע הקשרי, אל Navigation SDK ל-Android, שבו נוצרת נקודת ביניים לניתוב מדויק. היעד יודגש לנהג על ידי Navigation SDK על סמך המקום שאליו משויך האסימון.

איך נוצר טוקן של נקודת ניווט ונשלח אל Nav SDK לניתוב

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

כשצרכן פותח את אפליקציית הצרכן, האפליקציה קוראת לנקודת הקצה Destinations של Geocoding API ומספקת לצרכן מבחר של נקודות ניווט פוטנציאליות:

לקוח בוחר נקודת איסוף

המשתמש בוחר את הנקודה המועדפת מתוך מערך של navigationPoints בגוף התגובה של בקשת SearchDestinations:

"navigationPoints": [
    {
      "navigationPointToken": <encoded navigation point token>,
      "displayName": "South Entrance",
      "travelModes": ["DRIVE"],
      "usages": ["PICKUP","DROPOFF"],
      "location": {
        "lat": 37.3940894,
        "lng": -122.0788389
      }
      }
    }
]

טוקן נקודת הניווט מהתגובה מועבר לאפליקציית נהג לנייד שמשתמשת ב-Navigation SDK ל-Android כדי ליצור Waypoint לניתוב הנהג לנקודת האיסוף הנכונה.