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

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

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

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