نظرة عامة على الإعداد والمتطلبات

يشرح هذا المستند عملية إعداد Navigation Connect API ويسرد متطلبات جهاز السائق لاستخدام Navigation Connect API.

عملية إعداد Navigation Connect

قبل استخدام Navigation Connect API، عليك إكمال خطوات الإعداد التالية:

  1. إنشاء مشروع على Google Cloud وإعداده
  2. فعِّل Navigation Connect API وتحقَّق من تطبيقك.
  3. إعداد OAuth لإنشاء رموز OAuth المميّزة
  4. إعداد حساب الخدمة لتفعيل الاتصال بين البنية الأساسية للواجهة الخلفية و"خرائط Google" أو Waze

الحد الأدنى لمتطلبات الجهاز لاستخدام ميزة Navigation Connect

هذه المتطلبات ضرورية لكي يتمكّن جهاز السائق من تشغيل جلسة Navigation Connect بنجاح. تستخدم الجلسة واجهة Navigation Connect API لإرسال بيانات الرحلة في الوقت الفعلي، مثل الموقع الجغرافي والوقت المقدَّر للوصول، إلى خادم الخلفية.

إصدارات التطبيق المتوافقة

يجب أن يكون تطبيق Waze أو "خرائط Google" لأجهزة Android مثبّتًا على الجهاز. يسرد الجدول التالي الحد الأدنى لإصدار كل تطبيق من أجل استخدام Navigation Connect والميزات التي تتطلّب إصدارًا أحدث.

تطبيق الحد الأدنى للإصدار الإبلاغ عن المسار المتبقي الإبلاغ عن الانحراف عن المسار
‫Waze لأجهزة Android 5.15.5 5.20.0.2 5.22
‫Waze لنظام التشغيل iOS 5.15.5 5.20.0.1 5.22
خرائط Google لأجهزة Android 26.14 26.27 غير متاح

تم تفعيل الموقع الجغرافي الدقيق

اطلب من السائق تفعيل أذونات تحديد الموقع الجغرافي الدقيق على جهازه. يتطلّب تطبيقَا Waze و"خرائط Google" الموقع الجغرافي الدقيق لبدء التنقّل.

مربّع إفادة الموافقة للسائق

يتطلّب Navigation Connect موافقة السائق على مشاركة بيانات الرحلة. ليس عليك تفعيل مربّع إفادة الموافقة، لأنّ "خرائط Google" أو Waze يتعاملان تلقائيًا مع واجهة المستخدم هذه.

في الرحلة الأولى التي تبدأ من تطبيقك، يطلب تطبيق "خرائط Google" أو Waze من السائق مشاركة بيانات رحلته.

  • إذا نقر السائق على السماح، ستبدأ ميزة Navigation Connect بمشاركة بيانات الموقع الجغرافي في الوقت الفعلي والوقت المقدّر للوصول مع الخلفية.
  • إذا نقر السائق على عدم السماح أو ألغى الموافقة لاحقًا، ستقدّم "خرائط Google" أو Waze اتجاهات مفصّلة، ولكن لن ترسل ميزة Navigation Connect البيانات. تتلقّى الخلفية الحالة CLIENT_ERROR في حمولة بيانات الرحلة.

ويجب أن يعيد السائقون تأكيد هذه الموافقة كل 12 شهرًا.

الخطوات التالية

الخطوة الأولى لإعداد Navigation Connect API هي إنشاء مشروع على السحابة الإلكترونية على Google Cloud وضبط إعداداته.