مرور کلی API اتصال ناوبری

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

رابط برنامه‌نویسی کاربردی ناوبری (Navigation Connect API) سرویسی است که استفاده راننده شما از نقشه‌های گوگل و ناوبری ویز (Waze) را به سیستم‌های سازمانی شما متصل می‌کند. این سرویس از توکن‌های مجوز سفر به همراه یک لینک عمیق در برنامه شما استفاده می‌کند، به طوری که راننده می‌تواند با لمس یک لینک یا دکمه، ناوبری را در برنامه مصرفی مورد نظر خود آغاز کند. در حالی که راننده در حال پیمایش در سفر است، می‌توانید داده‌های مکانی لحظه‌ای مانند مکان‌های زنده، زمان‌های رسیدن به مقصد (ETA) بسیار دقیق و وضعیت چرخه عمر سفر را به صورت مداوم دریافت کنید.

رابط برنامه‌نویسی کاربردی ناوبری (Navigation Connect API) با استفاده از برنامه‌های مستقل نقشه‌های گوگل و ویز برای مسیریابی، به جای نیاز به ساخت و تعبیه یک رابط ناوبری سفارشی در برنامه شما، جایگزینی سبک برای Navigation SDK ارائه می‌دهد. این رابط، جلسه راننده را به طور ایمن به backend شما متصل می‌کند. وقتی راننده سفری را شروع می‌کند، رابط ناوبری آشنای خود را با دو مورد اضافی تجربه می‌کند: یک درخواست رضایت برای اشتراک‌گذاری داده‌های سفر (هر ۱۲ ماه یکبار الزامی است) و یک دکمه بازگشت برند برای بازگشت به برنامه شما.

چرا از API اتصال ناوبری استفاده کنیم؟

با استفاده از رابط برنامه‌نویسی کاربردی ناوبری (Navigation Connect API)، می‌توانید به‌روزرسانی‌های موقعیت مکانی سفر و زمان تقریبی رسیدن به مقصد (ETA) را از نقشه‌های گوگل یا ویز (Waze) مستقیماً در فرآیندهای پشتیبان خود ادغام کنید. این به شما کمک می‌کند تا در حالی که رانندگان از برنامه ناوبری مورد علاقه خود، نقشه‌های گوگل یا ویز (Waze)، استفاده می‌کنند، تصمیمات حیاتی کسب و کار خود را اتخاذ کرده و به‌روزرسانی‌های دقیق را با مشتریان خود به اشتراک بگذارید.

موارد استفاده به عنوان مثال شامل موارد زیر است:

  • افزایش شفافیت در سرویس‌های اشتراک سفر: به مشتریان و مسافران سرویس‌های اشتراک سفر، به‌روزرسانی‌های دقیق و به‌روز در مورد موقعیت مکانی راننده و زمان تقریبی رسیدن او ارائه دهید.
  • بهبود ردیابی تحویل: بر اساس داده‌های ترافیک زنده و مسیریابی، مشتریان را از زمان دقیق حمل و نقل یا تحویل غذا مطلع کنید.
  • بهبود مدیریت ناوگان و اعزام: با ردیابی موقعیت مکانی رانندگان به صورت زنده، تصمیمات آگاهانه‌ای برای اعزام ناوگان یا نیروی کار سیار که خدمات درخواستی (مانند کمک در مواقع خرابی، تعمیر و نگهداری یا حمل و نقل) ارائه می‌دهند، بگیرید.

کارهایی که می‌توانید با Navigation Connect API انجام دهید

رابط برنامه‌نویسی کاربردی ناوبری (Navigation Connect API) به شما امکان می‌دهد به‌روزرسانی‌های موقعیت مکانی و زمان تقریبی رسیدن (ETA) را به‌صورت آنی از نقشه‌های گوگل یا ویز (Waze) مستقیماً در پنل مدیریت خود دریافت کنید.

  • پیگیری سفرها بدون مزاحمت: سفرها را بدون تغییر انتخاب راننده در استفاده از نقشه‌های گوگل یا ویز یا بدون تغییر تجربه کاربری آنها، پیگیری کنید.
  • دسترسی به داده‌های مکانی در لحظه: در طول سفر، مکان‌های راننده، مسافت‌های باقی‌مانده و زمان سپری‌شده را به‌صورت لحظه‌ای دریافت کنید.
  • نظارت بر چرخه عمر سفر: فرکانس به‌روزرسانی داده‌های سفر را پیکربندی کنید تا وضعیت دقیق سفر را ردیابی کنید و فوراً بدانید که راننده در مسیر است، رسیده است یا سفر را به حالت تعلیق درآورده است.
  • مصرف و اشتراک‌گذاری زمان‌های رسیدن به مقصد (ETA): به‌روزرسانی‌های بسیار دقیق زمان رسیدن به مقصد را که توسط الگوریتم‌های مسیریابی زنده گوگل ارائه می‌شوند، بازیابی کنید.
  • پیگیری مسیر و ترافیک باقیمانده (فقط Waze): دریافت چندخطی مسیر فعال و شرایط ترافیک در لحظه از موقعیت فعلی راننده تا مقصد نهایی او، دقیقاً همانطور که در Waze نمایش داده می‌شود.
    • برش پویا: همزمان با حرکت وسیله نقلیه، Navigation Connect به طور خودکار چندخطی مسیر فعال را برش می‌دهد تا مطمئن شود که شما فقط بخش باقی‌مانده از سفر را دریافت می‌کنید.
    • فرکانس به‌روزرسانی: شرایط مسیر و ترافیک به طور خودکار پس از محاسبه مجدد مسیر، تغییر مسیر فعال سمت کلاینت یا تغییرات شرایط ترافیک به‌روزرسانی می‌شوند.
  • داده‌ها را به صورت انعطاف‌پذیر دریافت کنید: داده‌های سفر را به صورت آنی با استفاده از فراخوانی‌های مستقیم REST API دریافت کنید، یا با استفاده از اشتراک‌های Google Cloud Pub/Sub، به‌روزرسانی‌ها را به طور کارآمد پخش کنید.

نحوه عملکرد API اتصال ناوبری

رابط برنامه‌نویسی کاربردی Navigation Connect یک درخواست CreateTrip حاوی شناسه‌های برنامه تلفن همراه و پیکربندی جلسه شما را می‌پذیرد. این سرویس یک نمونه سفر منحصر به فرد ایجاد می‌کند و یک توکن سفر برمی‌گرداند. سپس این توکن به یک لینک عمیق Google Maps یا Waze اضافه می‌شود. به محض اینکه راننده ناوبری را راه‌اندازی و رضایت خود را اعلام کند، سرویس داده‌های ناوبری را به صورت آنی پردازش کرده و به‌روزرسانی‌های تله‌متری، از جمله مکان، ETA و مسافت باقی‌مانده را برمی‌گرداند.

منابع

جدول زیر منابع موجود از طریق API Navigation Connect را به همراه داده‌هایی که برمی‌گرداند خلاصه می‌کند. برای جزئیات بیشتر، به مرجع API Navigation Connect مراجعه کنید.

منابع داده داده‌ها بازگردانده شدند

احراز هویت و شناسه‌های برنامه تلفن همراه در قالب JSON.

به ایجاد سفر مراجعه کنید.

یک توکن سفر منحصر به فرد که برای راه‌اندازی اولیه اتصال در گوگل مپ یا ویز استفاده می‌شود.

به راه‌اندازی نقشه‌های گوگل یا ویز مراجعه کنید.

شناسه منحصر به فرد سفر و یک متد pull یا push در قالب JSON.

به بازیابی اطلاعات سفر مراجعه کنید.

تله‌متری سفر در لحظه شامل:

  • وضعیت سفر و فراداده
  • مکان فعلی (عرض/طول)
  • زمان تخمینی رسیدن (ETA)
  • مسافت و زمان باقی مانده

به بخش مدیریت داده‌های سفر مراجعه کنید.

نحوه استفاده از API اتصال ناوبری

۱ راه‌اندازی شوید با راه‌اندازی پروژه Google Cloud خود شروع کنید و دستورالعمل‌های بعدی را تکمیل کنید.
۲ ایجاد یک سفر برای ایجاد یک سفر با یک شناسه منحصر به فرد، یک فراخوانی API مربوط به Navigation Connect ارسال کنید و توکن را ذخیره کنید.
۳ نقشه گوگل یا ویز را اجرا کنید توکن سفر را بدهید و برای فعال کردن اشتراک‌گذاری داده‌های سفر، گوگل مپ یا ویز را اجرا کنید .
۴ بازیابی اطلاعات سفر برای بازیابی داده‌های سفر، یک فراخوانی API مربوط به Navigation Connect ارسال کنید. در صورت تمایل، با استفاده از Google Cloud Pub/Sub در به‌روزرسانی‌ها مشترک شوید.
۵ مدیریت داده‌های سفر نحوه مدیریت وضعیت سفر و سایر داده‌های سفر را درک کنید.