نظرة عامة على Navigation Connect API

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

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

توفّر واجهة برمجة التطبيقات Navigation Connect API بديلاً خفيف الوزن لحزمة Navigation SDK من خلال استخدام تطبيقَي "خرائط Google" وWaze المستقلَّين لتحديد المسارات، بدلاً من مطالبتك بإنشاء واجهة تنقّل مخصّصة ودمجها في تطبيقك. وتربط هذه الواجهة بشكل آمن جلسة السائق بخادمك الخلفي. عندما يبدأ السائق رحلة، تظهر له واجهة التنقّل المألوفة مع إضافة عنصرَين: طلب الموافقة على مشاركة بيانات الرحلة (يجب الحصول على الموافقة كل 12 شهرًا) وزر رجوع يحمل علامتك التجارية للعودة إلى تطبيقك.

أهمية استخدام Navigation Connect API

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

تشمل الأمثلة على حالات الاستخدام ما يلي:

  • زيادة الشفافية في خدمات مشاركة الرحلات: تقديم معلومات دقيقة وفي الوقت الفعلي لعملاء وراكبي خدمات مشاركة الرحلات حول مكان السائقين وأوقات الوصول المقدّرة
  • تحسين عملية تتبُّع عمليات التسليم: إطلاع العملاء على أوقات التسليم الدقيقة للشحنات أو الطعام استنادًا إلى بيانات حركة المرور والمسارات في الوقت الفعلي
  • تحسين إدارة أسطول المركبات وإرسالها: اتّخاذ قرارات مدروسة بشأن إرسال أسطول المركبات أو القوى العاملة المتنقلة التي تقدّم خدمات عند الطلب (مثل المساعدة في حالات الأعطال أو الصيانة أو النقل) من خلال تتبُّع المواقع الجغرافية للسائقين في الوقت الفعلي

الإجراءات التي تتيح Navigation Connect API تنفيذها

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

  • تتبُّع الرحلات بدون تطفّل: تتبُّع الرحلات بدون تغيير خيار السائق باستخدام "خرائط Google" أو Waze أو تعديل تجربة المستخدم
  • الوصول إلى بيانات الموقع الجغرافي في الوقت الفعلي: يمكنك الحصول على المواقع الجغرافية للسائقين في الوقت الفعلي والمسافات المتبقية والوقت المنقضي بشكل مستمر طوال الرحلة.
  • مراقبة دورات حياة الرحلات: يمكنك ضبط معدل التحديثات لبيانات الرحلات لتتبُّع الحالة الدقيقة للرحلة ومعرفة ما إذا كان السائق في طريقه أو وصل أو علّق الرحلة.
  • تلقّي ومشاركة أوقات الوصول التقديرية: يمكنك تلقّي معلومات دقيقة جدًا عن أوقات الوصول التقديرية بفضل خوارزميات التوجيه المباشر من Google.
  • تتبُّع المسار المتبقي وحركة المرور: يمكنك تلقّي خطوط متعددة الأضلاع للمسار المتبقي وأحوال حركة المرور في الوقت الفعلي من الموقع الجغرافي الحالي للسائق إلى وجهته النهائية، تمامًا كما تظهر في "خرائط Google" أو Waze. تؤدي هذه الميزة إلى تفعيل رمز التخزين التعريفي Navigation Connect Enterprise.
    • التقليم الديناميكي: أثناء تحرّك المركبة، تعمل ميزة Navigation Connect تلقائيًا على تقليم خطوط متعدّدة الأضلاع لمسار السائق النشط (المسار الكامل الذي يتم التنقّل فيه في التطبيق) لضمان تلقّي المسار المتبقي فقط (الجزء من الموقع الحالي للسائق إلى الوجهة).
    • معدل التحديثات: يتم تحديث بيانات المسار وأحوال حركة المرور تلقائيًا عند إعادة احتساب المسار أو إعادة التوجيه الاستباقية من جهة العميل أو حدوث تغييرات في أحوال حركة المرور.
  • تتبُّع الانحرافات عن المسار (في Waze فقط): رصد الحالات التي ينحرف فيها السائق عن المسار، وتحديد الموقع الجغرافي الدقيق ووقت الانحراف، وتحديد ما إذا كان الانحراف ناتجًا عن قرار اتّخذه السائق (على سبيل المثال، انعطاف خاطئ) أو عن قرار اتّخذه النظام (على سبيل المثال، إعادة التوجيه لتجنُّب الازدحام المروري). تؤدي هذه الميزة إلى تفعيل رمز التخزين التعريفي Navigation Connect Enterprise.
  • استيعاب البيانات بمرونة: يمكنك استهلاك بيانات الرحلات في الوقت الفعلي باستخدام طلبات REST API المباشرة، أو بث التعديلات بكفاءة باستخدام اشتراكات Google Cloud Pub/Sub.

طريقة عمل Navigation Connect API

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

الموارد

يلخّص الجدول التالي الموارد المتاحة من خلال Navigation Connect API بالإضافة إلى البيانات التي تعرضها. للحصول على تفاصيل محدّدة، راجِع مرجع Navigation Connect API.

مراجع البيانات البيانات التي تم عرضها

المصادقة ومعرّفات التطبيقات على الأجهزة الجوّالة بتنسيق JSON

يُرجى الاطّلاع على إنشاء رحلة.

رمز مميّز فريد للرحلة يُستخدَم لتهيئة عملية الربط في "خرائط Google" أو Waze.

اطّلِع على مقالة تشغيل "خرائط Google" أو Waze.

المعرّف الفريد للرحلة وطريقة السحب أو الدفع بتنسيق JSON

يُرجى الاطّلاع على استرداد بيانات الرحلات.

بيانات قياس الرحلة في الوقت الفعلي، بما في ذلك:

  • حالة الرحلة وبياناتها الوصفية
  • الموقع الجغرافي الحالي (خط العرض/خط الطول)
  • الوقت المقدَّر للوصول
  • المسافة والوقت المتبقيان

التعامل مع بيانات الرحلات

كيفية استخدام Navigation Connect API

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