این سند فرآیند راهاندازی رابط برنامهنویسی کاربردی ناوبری (Navigation Connect API) را توضیح میدهد و الزامات دستگاه راننده برای استفاده از رابط برنامهنویسی کاربردی ناوبری (Navigation Connect API) را فهرست میکند.
فرآیند راهاندازی اتصال ناوبری
قبل از اینکه بتوانید از API Navigation Connect استفاده کنید، باید مراحل راهاندازی زیر را انجام دهید:
- یک پروژه Google Cloud ایجاد و پیکربندی کنید.
- API اتصال ناوبری (Navigation Connect API) را فعال کنید و برنامه خود را تأیید کنید.
- برای ایجاد توکنهای OAuth، OAuth را تنظیم کنید.
- حساب کاربری سرویس خود را تنظیم کنید تا ارتباط بین زیرساخت بکاند و نقشههای گوگل یا ویز برقرار شود.
حداقل الزامات دستگاه برای استفاده از Navigation Connect
این الزامات برای اجرای موفقیتآمیز جلسه Navigation Connect توسط دستگاه راننده ضروری است. یک جلسه از API Navigation Connect برای ارسال دادههای سفر در لحظه، مانند مکان و زمان تخمینی رسیدن، به سرور backend شما استفاده میکند.
نسخههای برنامه پشتیبانیشده
دستگاه باید Waze نسخه ۵.۱۵.۵ یا بالاتر یا Google Maps نسخه ۲۶.۱۴ یا بالاتر را نصب کرده باشد.
مکان دقیق فعال شد
از راننده بخواهید مجوزهای موقعیت مکانی دقیق را در دستگاه خود فعال کند. ویز و گوگل مپس برای شروع ناوبری به موقعیت مکانی دقیق نیاز دارند.
رضایت نامه راننده
نویگیشن کانکت برای اشتراکگذاری دادههای سفر به رضایت راننده نیاز دارد. نیازی به فعال کردن کادر رضایت نیست؛ گوگل مپس یا ویز بهطور خودکار این رابط کاربری را مدیریت میکنند.
در اولین سفری که از طریق برنامه شما آغاز میشود، گوگل مپس یا ویز از راننده میخواهد که اطلاعات سفر خود را به اشتراک بگذارد.
- اگر راننده روی «اجازه دادن» ضربه بزند، Navigation Connect شروع به اشتراکگذاری دادههای موقعیت مکانی و ETA به صورت آنی با بخش مدیریت شما میکند.
- اگر راننده روی « اجازه ندهید» ضربه بزند یا بعداً رضایت را لغو کند، Google Maps یا Waze مسیرهای گام به گام را ارائه میدهند، اما Navigation Connect دادهای ارسال نمیکند. backend شما در دادههای سفر، وضعیت
CLIENT_ERRORرا دریافت میکند.
رانندگان باید هر ۱۲ ماه یکبار این رضایت را مجدداً تأیید کنند.
قدم بعدی چیست؟
اولین قدم برای راهاندازی API Navigation Connect، ایجاد و پیکربندی یک پروژه Google Cloud است.