نمای کلی و الزامات راه‌اندازی

این سند فرایند راه‌اندازی Navigation Connect API را توضیح می‌دهد و الزامات دستگاه راننده را برای استفاده از Navigation Connect API فهرست می‌کند.

فرایند راه‌اندازی Navigation Connect

قبل‌از اینکه بتوانید از Navigation Connect API استفاده کنید، باید مراحل راه‌اندازی زیر را تکمیل کنید:

  1. پروژه Google Cloud ایجاد و پیکربندی کنید.
  2. Navigation Connect API را فعال کنید و برنامه‌تان را به‌تأیید برسانید.
  3. برای ایجاد کردن کدهای OAuth،‏ OAuth را راه‌اندازی کنید.
  4. حساب سرویس خود را راه‌اندازی کنید تا ارتباط بین زیرساخت باطن خود و Google Maps یا Waze را فعال کنید.

حداقل شرایط لازم دستگاه برای استفاده از Navigation Connect

این الزامات برای اینکه دستگاه راننده بتواند جلسه Navigation Connect را با موفقیت اجرا کند ضروری است. جلسه از Navigation Connect API برای ارسال داده‌های هم‌زمان سفر، مانند مکان و زمان برآوردی ورود، به سرور زیرینه شما استفاده می‌کند.

نسخه‌های پشتیبانی‌شده برنامه

دستگاه باید Waze یا Google Maps ویژه Android را نصب کرده باشد. جدول زیر حداقل نسخه هر برنامه را برای Navigation Connect و برای ویژگی‌هایی که به نسخه جدیدتری نیاز دارند فهرست می‌کند.

برنامه حداقل نسخه گزارش کردن بقیه مسیر گزارش کردن انحراف از مسیر
Waze برای Android 5.15.5 5.20.0.2 ‫۵.۲۲
Waze برای iOS 5.15.5 5.20.0.1 ‫۵.۲۲
Google Maps ویژه Android ‫۲۶.۱۴ ۲۶.۲۷ پشتیبانی نمی‌شود

مکان دقیق فعال است

از راننده بخواهید اجازه‌های مکان دقیق را در دستگاهش روشن کند. Waze و Google Maps برای شروع ناوبری به مکان دقیق نیاز دارند.

کادر گفتگوی رضایت راننده.

Navigation Connect برای هم‌رسانی داده‌های سفر به رضایت راننده نیاز دارد. نیازی نیست کادر گفتگوی رضایت را راه‌اندازی کنید؛ Google Maps یا Waze به‌طور خودکار این میانای کاربر را مدیریت می‌کند.

در اولین سفری که از برنامه‌تان شروع می‌شود، Google Maps یا Waze از راننده درخواست می‌کند داده‌های سفرش را هم‌رسانی کند.

  • اگر راننده روی اجازه دادن تک‌ضرب بزند، Navigation Connect هم‌رسانی مکان هم‌زمان و داده‌های زمان تخمینی ورود را با پس‌بک شما شروع می‌کند.
  • اگر راننده روی اجازه داده نشود تک‌ضرب بزند یا بعداً رضایتش را لغو کند، Google Maps یا Waze مسیر گام‌به‌گام را ارائه می‌دهد، اما Navigation Connect داده‌ای ارسال نمی‌کند. بخش پشتی شما وضعیت CLIENT_ERROR را در بار داده‌های سفر دریافت می‌کند.

رانندگان باید هر ۱۲ ماه یک‌بار این رضایت را دوباره تأیید کنند.

قدم بعدی چیست

اولین قدم برای راه‌اندازی Navigation Connect API، ایجاد و پیکربندی پروژه Google Cloud است.