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

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

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

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

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

דוגמה: תרחיש לדוגמה של נסיעה משותפת

סקירה כללית

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

אלה השלבים העיקריים:

  1. אחזור של טוקן נקודת ניווט באמצעות Geocoding API.
  2. משתמשים ב-Routes API כדי לחשב מסלול ולקודד אותו באסימון מסלול.
  3. מעבירים גם את האסימון של נקודת הניווט וגם את האסימון של המסלול אל Navigation SDK.
  4. משתמשים ב-Navigation SDK כדי לנתב את הנהג לנקודת האיסוף הנכונה.

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

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

תרשים של תרחיש לדוגמה של נסיעה שיתופית או משלוח
תרשים של תרחיש לדוגמה של נסיעה שיתופית או משלוח

דוגמה לשיתוף נסיעות

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

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

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

כשהמשתמש פותח את האפליקציה למשתמשים, האפליקציה קוראת לשיטה 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
      }
    }
]

ה-backend של האפליקציה מספק את האסימון של נקודת הניווט ל-Routes API כדי לחשב את המסלול ולאחזר אסימון מסלול.

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

קריאה נוספת