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

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

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

کاربر نقطه مورد نظر خود را انتخاب میکند، که یکی از نقاط موجود در آرایه navigationPoints در بدنه پاسخ درخواست SearchDestinations است:
"navigationPoints": [ { "navigationPointToken": <encoded navigation point token>, "displayName": "South Entrance", "travelModes": ["DRIVE"], "usages": ["PICKUP","DROPOFF"], "location": { "lat": 37.3940894, "lng": -122.0788389 } } ]
توکن نقطه ناوبری از پاسخ به یک برنامه راننده موبایل منتقل میشود که از SDK ناوبری برای اندروید یا iOS استفاده میکند تا یک نقطه مسیر ایجاد کند و راننده را به نقطه صحیح تحویل خودرو هدایت کند.
- برای مستندات توکن نقطه ناوبری اندروید، به Navigation SDK مراجعه کنید .
- برای مستندات توکن نقطه ناوبری iOS، به SDK ناوبری مراجعه کنید .
- به مستندات توکن نقطه ناوبری API مسیرها مراجعه کنید .