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

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

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

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

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

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