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

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

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

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

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

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

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

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

קריאה נוספת