إعداد ميزة "التنقل المتصل"

المطوّرون في المنطقة الاقتصادية الأوروبية

يوضّح هذا المستند الخطوات اللازمة لبدء استخدام Navigation Connect.

تأكَّد من استيفاء الشروط الأساسية.

فعِّل واجهة برمجة التطبيقات في مشروعك على Google Cloud.

اضبط بروتوكول OAuth لإجراء طلب بيانات مصادق عليه من واجهة برمجة التطبيقات.

تفعيل واجهة برمجة التطبيقات وإثبات ملكية تطبيقك

يوضّح هذا الدليل عملية تفعيل Navigation Connect API وإثبات ملكية تطبيقك في Google Cloud Console، ما يتيح لتطبيقك التفاعل بشكل آمن مع "خرائط Google" وWaze. يجب إكمال هذه العملية لاستخدام Navigation Connect API.

1. تفعيل Navigation Connect API

استخدِم Google Cloud Console أو الأمر gcloud لتفعيل Navigation Connect API في مشروعك على السحابة الإلكترونية.

لتفعيل واجهة برمجة التطبيقات، اتّبِع الخطوات التالية:

وحدة التحكّم

  1. افتح صفحة المنتج في Google Cloud Console:

    تفعيل Navigation Connect API

  2. يمكنك النقر على الزر تمكين.

gcloud

gcloud services enable \
    --project "PROJECT" \
    "navigationconnect.googleapis.com"

يمكنك الاطّلاع على مزيد من المعلومات حول Google Cloud SDK و تثبيت Cloud SDK والأوامر التالية:

2. بدء عملية التحقّق من التطبيق

بعد تفعيل واجهة برمجة التطبيقات، عليك إثبات ملكية تطبيقك لتفعيل واجهة برمجة التطبيقات Navigation Connect API. لا يتيح تفعيل واجهة برمجة التطبيقات وحدها إمكانية الوصول إليها، بل يجب تقديم تفاصيل النشاط التجاري والتطبيق لمراجعتها قبل أن تتمكّن من استخدام Navigation Connect API.

لبدء عملية التحقّق، استخدِم إحدى الطريقتين التاليتين:

  • سوق واجهات برمجة التطبيقات:
    1. في API Marketplace، ابحث عن بطاقة Navigation Connect API.
    2. انقر على رمز مطلوب تأكيد الحساب الأزرق لبدء خطوات تأكيد الحساب.
  • المفاتيح وشهادات الاعتماد في Google Cloud Console:
    1. في Google Cloud Console، انتقِل إلى صفحة المفاتيح وبيانات الاعتماد.
    2. انقر على مفاتيح وبيانات اعتماد ربط التنقّل.
    3. في البانر، انقر على بدء عملية إثبات الملكية.

3- تقديم تفاصيل عن التطبيق وجمع البيانات والخصوصية

يوضّح الجدول التالي التفاصيل التي يجب تقديمها للتحقق من التطبيقات:

الحقل الوصف
تفاصيل التطبيق

قدِّم التفاصيل التالية لضمان عرض تطبيقك بشكل صحيح في "خرائط Google" وWaze.
اسم النشاط التجاري أو التطبيق أدخِل الاسم الذي تريد عرضه للمستخدمين في "خرائط Google" وWaze.
معرّف التطبيق أدخِل اسم حزمة Android أو معرّف حزمة iOS.
رابط عام لنظام التشغيل iOS قدِّم الرابط العام لنظام التشغيل iOS الذي يتيح للمستخدمين الرجوع إلى تطبيقك (متاح على Waze فقط).
شعار التطبيق (‫Waze فقط) (اختياري) حمِّل شعارًا بتنسيق PNG أو JPG (من 32x32 إلى 128x128 بكسل) لعرض شعار تطبيقك في Waze أثناء جلسة تنقّل.
تفاصيل جمع البيانات والخصوصية

أدخِل التفاصيل التالية لضمان الشفافية وثقة السائقين وأمان البيانات.
رابط سياسة الخصوصية قدِّم عنوان URL لسياسة الخصوصية في تطبيقك. يظهر هذا الرابط على شاشة طلب الموافقة.
جهات التحكّم الإضافية في البيانات (اختياري) يُرجى تقديم الاسم التجاري ورابط سياسة الخصوصية لأي مدراء بيانات تابعين لجهات خارجية، مثل مورّد البرامج المستقل. تظهر هذه التفاصيل على شاشة طلب الموافقة.
الامتثال لسياسات البيانات إذا كان تطبيقك يعمل في الولايات المتحدة، ضَع علامة في المربّع سيتم استخدام هذا التطبيق للرحلات التي تحدث في الولايات المتحدة لضمان الامتثال للوائح التنظيمية المحلية.

4. المراجعة والإرسال

راجِع ملخّص المعلومات المقدَّمة قبل إرسال تطبيقك لإثبات ملكيته.

  1. راجِع بعناية اسم تطبيقك والنظام الأساسي وأرقام التعريف والروابط.

  2. ضَع علامة في مربّع الاختيار كل المعلومات دقيقة.
  3. انقر على إرسال.

بعد إرسال تطبيقك لإثبات ملكيته، تبدأ مرحلة المراجعة.

  • المدة الزمنية: تستغرق عملية إثبات الملكية عادةً من يوم عمل واحد إلى 3 أيام عمل.
  • الإشعار: ستتلقّى رسالة إلكترونية عند تغيُّر حالة التحقّق. ستتلقّى أيضًا رسالة إلكترونية تطلب منك تقديم معرّف ملف الدفع أو معرّف مطوّر Android. إذا كنت بحاجة إلى معرّف مطوِّر على Android، اطّلِع على إنشاء حساب مطوِّر.
  • تتبُّع الحالة: يمكنك مراقبة مستوى تقدّمك في صفحة المفاتيح وبيانات الاعتماد في وحدة تحكّم Google Cloud.
  • الدعم: لتعديل إعداداتك بعد الموافقة عليها بدون التأثير في عملية الإنتاج، أنشئ تذكرة دعم.

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