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

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

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

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

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

כשצרכן פותח את אפליקציית הצרכן, האפליקציה קוראת לשיטת היעדים של 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 כדי ליצור נקודת ציון לניתוב הנהג לנקודת האיסוף הנכונה.

• מידע נוסף על טוקן של נקודת ניווט ב-Navigation SDK ל-Android
• מידע נוסף על טוקן של נקודת ניווט ב-Navigation SDK ל-iOS
• מידע נוסף על אסימון נקודת הניווט של Routes API