يوضّح هذا المستند عملية إعداد Navigation Connect API ويسرد متطلبات جهاز السائق لاستخدام Navigation Connect API.
عملية إعداد Navigation Connect
قبل أن تتمكّن من استخدام Navigation Connect API، عليك إكمال خطوات الإعداد التالية:
- إنشاء مشروع على Google Cloud وضبط إعداداته
- تفعيل Navigation Connect API والتحقّق من تطبيقك
- إعداد OAuth لإنشاء رموز OAuth المميزة
- إعداد حساب الخدمة لتفعيل التواصل بين البنية الأساسية للواجهة الخلفية و"خرائط Google" أو Waze.
الحد الأدنى لمتطلبات الجهاز لاستخدام Navigation Connect
هذه المتطلبات ضرورية لتشغيل جهاز السائق لجلسة Navigation Connect بنجاح. تستخدم الجلسة Navigation Connect API لإرسال بيانات الرحلة في الوقت الفعلي، مثل الموقع الجغرافي والوقت المقدّر للوصول، إلى خادم الواجهة الخلفية.
إصدارات التطبيقات المتوافقة
يجب أن يكون الجهاز مثبّتًا عليه الإصدار 5.15.5 من Waze أو إصدار أحدث، أو الإصدار 26.14 من "خرائط Google" أو إصدار أحدث.
تفعيل الموقع الجغرافي الدقيق
اطلب من السائق تفعيل أذونات الموقع الجغرافي الدقيق على جهازه. يتطلّب تطبيق Waze و"خرائط Google" الموقع الجغرافي الدقيق لبدء التنقّل.
موافقة السائق
يتطلّب Navigation Connect موافقة السائق لمشاركة بيانات الرحلة. لست بحاجة إلى عرض مربّع حوار الموافقة، لأنّ "خرائط Google" أو Waze يتعاملان تلقائيًا مع واجهة المستخدم هذه.
في أول رحلة يتم بدؤها من تطبيقك، يطلب "خرائط Google" أو Waze من السائق مشاركة بيانات رحلته.
- إذا نقر السائق على السماح، يبدأ Navigation Connect بمشاركة بيانات الموقع الجغرافي في الوقت الفعلي والوقت المقدر للوصول مع الواجهة الخلفية.
- إذا نقر السائق على عدم السماح أو ألغى الموافقة لاحقًا، يقدّم "خرائط Google" أو Waze اتّجاهات مفصّلة، ولكن لا يرسل Navigation Connect أي بيانات. تتلقّى الواجهة الخلفية حالة
CLIENT_ERRORفي حمولة بيانات الرحلة.
على السائقين إعادة تأكيد هذه الموافقة كل 12 شهرًا.
الخطوات التالية
الخطوة الأولى لإعداد Navigation Connect API هي إنشاء مشروع على Google Cloud وضبط إعداداته.