مسیر با استفاده از توکن‌های نقطه ناوبری

توسعه‌دهندگان منطقه اقتصادی اروپا (EEA)

توکن‌های نقطه ناوبری به شما این امکان را می‌دهند که اطلاعات کلیدی و زمینه‌ای در مورد یک مقصد را به SDK ناوبری برای اندروید ارسال کنید تا مسیریابی و تجربه راننده بهبود یابد. این امر در مواردی مانند تحویل غذا یا سفر اشتراکی، که در آن نقطه تحویل یا پیاده شدن ممکن است بدون ورودی کاربر مبهم باشد، مفید است.

این تصویر نمونه‌هایی از یک اپلیکیشن همسفری مصرف‌کننده را نشان می‌دهد که در آن نقطه ناوبری انتخاب شده است، و یک اپلیکیشن راننده که از کیت توسعه نرم‌افزار ناوبری برای اندروید برای مسیریابی دقیق راننده استفاده می‌کند.

نمونه‌هایی از برنامه‌های مصرف‌کننده و راننده

برای ایجاد و ارسال یک توکن نقطه ناوبری، از نقطه پایانی مقصد (Destinations) در API Geocoding استفاده کنید تا به کاربران خود اجازه دهید مکان مورد نظر خود را از لیستی از نقاط ناوبری انتخاب کنند. انتخاب کاربر به یک نقطه ناوبری تبدیل می‌شود که توسط نقطه پایانی مقصد (Destinations) در API Geocoding برگردانده می‌شود. سپس می‌توانید توکن نقطه ناوبری را که شامل مختصات مقصد و همچنین اطلاعات زمینه‌ای است، به SDK ناوبری برای اندروید (Navigation SDK) ارسال کنید، جایی که یک نقطه مسیر برای مسیریابی دقیق ایجاد می‌شود. مقصد توسط SDK ناوبری بر اساس مکانی که توکن به آن مرتبط است، برای راننده برجسته می‌شود.

How a navigation point token is created and sent to the Nav SDK for routing

برای مثال، یک مورد استفاده از سرویس همسفری را تصور کنید که در آن یک اپلیکیشن برای رزرو سرویس توسط مشتری و یک اپلیکیشن دیگر برای دریافت اعلان‌های مربوط به سرویس و اطلاعات مسیریابی تا مقصد توسط راننده وجود دارد.

وقتی یک مصرف‌کننده برنامه‌ی مصرف‌کننده را باز می‌کند، برنامه نقطه‌ی پایانی مقصدها (Destinations) از API ژئوکدینگ (Geocoding API) را فراخوانی می‌کند و مجموعه‌ای از نقاط ناوبری بالقوه را در اختیار مصرف‌کننده قرار می‌دهد:

Consumer choosing a drop off point

کاربر نقطه مورد نظر خود را انتخاب می‌کند، که یکی از نقاط موجود در آرایه navigationPoints در بدنه پاسخ درخواست SearchDestinations است:

"navigationPoints": [
    {
      "navigationPointToken": <encoded navigation point token>,
      "displayName": "South Entrance",
      "travelModes": ["DRIVE"],
      "usages": ["PICKUP","DROPOFF"],
      "location": {
        "lat": 37.3940894,
        "lng": -122.0788389
      }
      }
    }
]

توکن نقطه ناوبری از پاسخ به یک برنامه راننده موبایل ارسال می‌شود که از SDK ناوبری برای اندروید برای ایجاد یک نقطه مسیر برای هدایت راننده به نقطه صحیح دریافت استفاده می‌کند.