يوضّح هذا المستند عملية إعداد واجهة برمجة التطبيقات 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 من السائق مشاركة بيانات رحلته.
- إذا نقر السائق على السماح، ستبدأ ميزة "ربط التنقّل" بمشاركة بيانات الموقع الجغرافي في الوقت الفعلي والوقت المقدر للوصول مع الخلفية.
- إذا نقر السائق على عدم السماح أو ألغى الموافقة لاحقًا، ستوفّر "خرائط Google" أو Waze اتجاهات مفصّلة، ولكن لن يرسل تطبيق Navigation Connect أي بيانات. يتلقّى الخلفية حالة
CLIENT_ERRORفي حمولة بيانات الرحلة.
ويجب أن يعيد السائقون تأكيد هذه الموافقة كل 12 شهرًا.
الخطوات التالية
تتمثّل الخطوة الأولى في إعداد Navigation Connect API في إنشاء مشروع على Google Cloud وضبطه.