توفّر واجهة برمجة التطبيقات Navigation Connect بديلاً خفيف الوزن لحزمة Navigation SDK من خلال استخدام تطبيقَي "خرائط Google" وWaze المستقلَّين لتحديد المسار بدلاً من مطالبتك بإنشاء واجهة تنقّل مخصّصة ودمجها في تطبيقك، كما تربط هذه الواجهة بشكل آمن جلسة السائق بخادمك الخلفي. عندما يبدأ السائق رحلة، تظهر له واجهة التنقّل المألوفة مع إضافة عنصرَين: طلب الموافقة على مشاركة بيانات الرحلة (يجب الموافقة كل 12 شهرًا) وزر رجوع يحمل علامتك التجارية للعودة إلى تطبيقك.
أسباب استخدام Navigation Connect API
باستخدام Navigation Connect API، يمكنك دمج الموقع الجغرافي للرحلة في الوقت الفعلي وأحدث المعلومات عن الوقت المقدّر للوصول من "خرائط Google" أو Waze مباشرةً في عمليات الخلفية، ما يساعدك في اتّخاذ قرارات تجارية مهمة ومشاركة أحدث المعلومات الدقيقة مع عملائك، بينما يستخدم السائقون تطبيق التنقّل المفضّل لديهم، أي "خرائط Google" أو Waze.
تشمل الأمثلة على حالات الاستخدام ما يلي:
- تعزيز الشفافية في خدمات مشاركة الرحلات: تقديم معلومات دقيقة وفي الوقت الفعلي لعملاء وراكبي خدمات مشاركة الرحلات حول أماكن تواجد السائقين وأوقات الوصول المقدّرة
- تحسين عملية تتبُّع عمليات التسليم: إطلاع العملاء على أوقات التسليم الدقيقة للشحنات أو الطعام استنادًا إلى بيانات حركة المرور والمسارات المباشرة
- تحسين إدارة أساطيل المركبات وإرسالها: اتّخاذ قرارات مدروسة بشأن إرسال أساطيل المركبات أو فِرق العمل المتنقلة التي تقدّم خدمات عند الطلب (مثل المساعدة في حالات الأعطال أو الصيانة أو النقل) من خلال تتبُّع المواقع الجغرافية للسائقين في الوقت الفعلي
الإجراءات التي يمكنك تنفيذها باستخدام Navigation Connect API
تتيح لك واجهة برمجة التطبيقات Navigation Connect تلقّي آخر المعلومات عن الموقع الجغرافي والوقت المقدّر للوصول في الوقت الفعلي من "خرائط Google" أو Waze مباشرةً في الخلفية.
- تتبُّع الرحلات بدون تطفّل: يمكنك تتبُّع الرحلات بدون تغيير خيار السائق بشأن استخدام "خرائط Google" أو Waze أو تعديل تجربة المستخدم.
- الوصول إلى بيانات الموقع الجغرافي في الوقت الفعلي: يمكنك الحصول على المواقع الجغرافية للسائقين في الوقت الفعلي والمسافات المتبقية والوقت المنقضي بشكل مستمر طوال الرحلة.
- تتبُّع مراحل نشاط الرحلة: يمكنك ضبط معدّل تكرار تعديل بيانات الرحلة لتتبُّع الحالة الدقيقة للرحلة ومعرفة ما إذا كان السائق في طريقه أو وصل أو علّق الرحلة.
- استخدام أوقات الوصول المقدَّرة ومشاركتها: يمكنك الحصول على معلومات دقيقة جدًا عن أوقات الوصول المقدَّرة بفضل خوارزميات التوجيه المباشر من Google.
- تتبُّع المسار المتبقي وحركة المرور (في Waze فقط): يمكنك تلقّي خطوط متعدّدة الأضلاع للمسار النشط ومعلومات عن حالة حركة المرور في الوقت الفعلي من الموقع الجغرافي الحالي للسائق إلى وجهته النهائية، تمامًا كما تظهر في Waze.
- التقليم الديناميكي: أثناء تحرّك المركبة، تعمل ميزة Navigation Connect تلقائيًا على تقليم خطوط مسار الرحلة النشطة لضمان تلقّي الجزء المتبقي من الرحلة فقط.
- معدّل التحديث: يتم تعديل المسار وأحوال حركة المرور تلقائيًا عند إعادة احتساب المسار أو إعادة التوجيه الاستباقية من جهة العميل أو حدوث تغييرات في أحوال حركة المرور.
- استيعاب البيانات بمرونة: يمكنك استهلاك بيانات الرحلات في الوقت الفعلي باستخدام طلبات مباشرة إلى REST API، أو بث التعديلات بكفاءة باستخدام اشتراكات Google Cloud Pub/Sub.
طريقة عمل Navigation Connect API
يقبل Navigation Connect API طلب 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 | التعامل مع بيانات الرحلة | تعرَّف على كيفية التعامل مع حالة الرحلة وبيانات الرحلة الأخرى. |