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

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

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

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

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

مثال: مورد استفاده هم‌سفری

نمای کلی

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

این مراحل در سطح بالا هستند:

  1. یک کد نقطه ناوبری را ازطریق Geocoding API بازیابی کنید.
  2. از Routes API برای محاسبه مسیر و کدگذاری آن در یک کد مسیر استفاده کنید.
  3. هم کد نقطه ناوبری و هم کد مسیر را به Navigation SDK ارسال کنید.
  4. از «کیت توسعه نرم‌افزار پیمایش» برای مسیریابی راننده به نقطه سوار کردن صحیح استفاده کنید.

برای پیوندهای مربوط به Routes API، «کیت توسعه نرم‌افزار پیمایش» برای iOS، و اسناد «کیت توسعه نرم‌افزار پیمایش» برای Android، به بخش مطالعه بیشتر مراجعه کنید.

این نمودار نشان می‌دهد که چگونه یک برنامه هم‌سفری یا تحویل از Geocoding API، Routes API، و Navigation SDK برای iOS یا Android برای مسیریابی راننده بااستفاده از یک توکن مسیر و توکن نقطه ناوبری استفاده می‌کند:

نمودار مورد استفاده هم‌سفری یا تحویل
نمودار مورد استفاده سفر اشتراکی یا تحویل

نمونه هم‌پیمایی

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

این تصویر نمونه‌هایی از برنامه هم‌سفری مصرف‌کننده را نشان می‌دهد که در آن نقطه ناوبری انتخاب شده است، و برنامه راننده که از Navigation SDK for 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
      }
    }
]

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

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

مطالعه بیشتر