نمای کلی Navigation Connect API

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

«میانای برنامه‌سازی کاربردی اتصال ناوبری» سرویسی است که استفاده راننده شما از ناوبری Google Maps و Waze را به سیستم‌های سازمانی شما متصل می‌کند. این ویژگی از کدهای مجوز سفر به‌همراه پیوند عمیق در برنامه شما استفاده می‌کند تا راننده بتواند روی پیوند یا دکمه‌ای تک‌ضرب بزند و پیمایش را در برنامه مصرف‌کننده دلخواه خود شروع کند. وقتی راننده درحال ناوبری در سفر است، می‌توانید داده‌های مکان هم‌زمان مستمر مثل مکان‌های زنده، زمان‌های تخمینی رسیدن بسیار دقیق، و وضعیت‌های چرخه عمر سفر دریافت کنید.

«میانای برنامه‌سازی کاربردی اتصال ناوبری» بااستفاده از برنامه‌های مستقل Google Maps و Waze برای مسیریابی، جایگزین سبکی برای «کیت توسعه نرم‌افزار ناوبری» ارائه می‌دهد و دیگر لازم نیست رابط ناوبری سفارشی را در برنامه‌تان بسازید و جاسازی کنید. این میانای برنامه‌سازی کاربردی جلسه راننده را به‌طور ایمن به زیرینه شما پیوند می‌دهد. وقتی راننده‌ای سفری را شروع می‌کند، رابط پیمایش آشنای خود را با دو افزودنی تجربه می‌کند: پیامک موافقت با هم‌رسانی داده‌های سفر (هر ۱۲ ماه یک‌بار الزامی است) و دکمه برگشت نشان‌دار برای بازگشت به برنامه شما.

چرا از Navigation Connect API استفاده کنیم

با Navigation Connect API، می‌توانید مکان سفر هم‌زمان و به‌روزرسانی‌های زمان تخمینی ورود را از Google Maps یا Waze مستقیماً در فرایندهای پسین خود ادغام کنید. این کار به شما کمک می‌کند تصمیمات مهم کسب‌وکار را اتخاذ کنید و به‌روزرسانی‌های دقیق را با مشتریانتان هم‌رسانی کنید، درحالی‌که رانندگان از برنامه ناوبری ترجیحی خود، Google Maps یا Waze، استفاده می‌کنند.

نمونه‌های مورد استفاده شامل موارد زیر است:

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

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

«میانای برنامه‌سازی کاربردی اتصال ناوبری» به شما امکان می‌دهد به‌روزرسانی‌های مکان هم‌زمان و «زمان تخمینی رسیدن» را مستقیماً در زیرینه خود از Google Maps یا Waze دریافت کنید.

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

نحوه عملکرد Navigation Connect API

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

منابع

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

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

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

ایجاد سفر را ببینید.

رمز سفر یکتایی که برای مقداردهی اولیه اتصال در Google Maps یا Waze استفاده می‌شود.

به راه‌اندازی Google Maps یا Waze مراجعه کنید.

شناسه سفر یکتا و روش کشیدن یا هل دادن در قالب JSON.

بازیابی داده‌های سفر را ببینید.

تله‌متری سفر بی‌درنگ شامل:

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

مدیریت داده‌های سفر را ببینید.

نحوه استفاده از Navigation Connect API

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