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

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

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

To create and pass a navigation point token, use the Destinations method of the Geocoding API to allow your users to select a preferred location from a list of navigation points . The user's selection becomes a navigation point returned by the Destinations method of the Geocoding API.

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

Example: Rideshare use case

نمای کلی

این مثال نشان می‌دهد که چگونه می‌توان API مربوط به Geocoding، API مربوط به Routes و SDK مربوط به Navigation را برای iOS یا اندروید ترکیب کرد تا یک اپلیکیشن rideshare ایجاد شود که قیمت مسیر را محاسبه کرده و رانندگان را به نقطه صحیح سوار شدن هدایت کند.

These are the steps at a high level:

  1. بازیابی توکن نقطه ناوبری از طریق API ژئوکدینگ.
  2. از API مسیرها برای محاسبه یک مسیر و کدگذاری آن در یک توکن مسیر استفاده کنید.
  3. هم توکن نقطه ناوبری و هم توکن مسیر را به SDK ناوبری (Navigation SDK) ارسال کنید.
  4. از کیت توسعه نرم‌افزار ناوبری (Navigation SDK) برای هدایت راننده به نقطه صحیح سوار شدن استفاده کنید.

برای پیوندهایی به مستندات مربوط به Routes API، Navigation SDK برای iOS و Navigation SDK برای اندروید، به بخش مطالعه بیشتر مراجعه کنید.

این نمودار نشان می‌دهد که چگونه یک اپلیکیشن هم‌سفری یا تحویل بار از API ژئوکدینگ، API مسیرها و SDK ناوبری برای iOS یا اندروید برای مسیریابی راننده با استفاده از توکن مسیر و توکن نقطه ناوبری استفاده می‌کند:

Rideshare or delivery use case diagram
Diagram of a rideshare or delivery use case

Rideshare example

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

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

Examples of consumer and driver apps

When a consumer opens the consumer app, the app calls the Destinations method of the Geocoding API and provides the consumer with a selection of potential navigation points:

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
      }
    }
]

بک‌اند برنامه، توکن نقطه ناوبری را در اختیار API مسیرها قرار می‌دهد تا مسیر را محاسبه کرده و توکن مسیر را بازیابی کند.

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

مطالعه بیشتر