لتلقّي تعديلات على بيانات الرحلات من "خرائط Google" أو Waze، اضبط الخلفية باستخدام أحد الخيارات التالية:
- طريقة سحب باستخدام Navigation Connect API
- طريقة دفع مستندة إلى الأحداث باستخدام Google Cloud Pub/Sub
الخيار 1: استخدام Navigation Connect API
لجلب أحدث حالة للرحلة يدويًا، يمكنك استدعاء طريقة GetTrip باستخدام معرّف الرحلة الفريد.
يوضّح النموذج التالي كيفية طلب البيانات من واجهة برمجة التطبيقات من سطر الأوامر باستخدام "بيانات الاعتماد التلقائية للتطبيق" (ADC) من أجل السماح بالطلب من خادم إلى خادم.
#!/bin/bash
gcloud auth application-default login
access_token="$(gcloud auth application-default print-access-token)"
# Call the GetTrip method
curl -X GET "https://navigationconnect.googleapis.com/v1/projects/PROJECT_ID/trips/TRIP_ID" \
-H "Authorization: Bearer ${access_token}" \
-H "Content-Type: application/json"
تخصيص تنسيقات الخطوط المتعدّدة
إذا فعّلت إعداد تقارير المسار المتبقي أثناء إنشاء الرحلة، يمكنك تخصيص تمثيل الخطوط المتعدّدة للمسار المتبقي الذي يتم عرضه عند استدعاء طريقة GetTrip.
لاختيار تنسيق للخطوط المتعدّدة، أدرِج المَعلمة routePolylineFormat في طلبك. تشمل التنسيقات المتوافقة ما يلي:
-
ENCODED: سلسلة عادية من الخطوط المتعدّدة المرمّزة (5 نقاط عشرية) -
S2ENCODED: تمثّل S2Polyline مرمّزة. -
GEO_JSON: تنسيق LineString في GeoJSON
الخيار 2: استخدام Google Cloud Pub/Sub
لتلقّي تحديثات منتظمة عن الرحلات، اشترِك في موضوع Google Cloud Pub/Sub. بعد موافقة السائق، يرسل Navigation Connect التعديلات مباشرةً إلى موضوعك.
للحصول على مقدمة عن المراسلة، يُرجى الاطّلاع على دليل البدء السريع في Pub/Sub.
توضّح الأقسام التالية كيفية استخدام Google Cloud Pub/Sub لتلقّي البيانات من جلسة تنقّل باستخدام "خرائط Google" أو Waze.
1. إنشاء موضوع
أنشئ موضوعًا باسم navigation_connect_trip_notifications بالضبط في
مشروعك على Google Cloud، على النحو التالي:
- فعِّل Pub/Sub API.
- انتقِل إلى صفحة مواضيع Pub/Sub في وحدة تحكّم Google Cloud.
- انقر على إنشاء موضوع.
أدخِل
navigation_connect_trip_notificationsفي حقل رقم تعريف الموضوع.انقر على إنشاء.
تعرض وحدة التحكّم اسم الموضوع الكامل على النحو التالي: projects/project-number/topics/navigation_connect_trip_notifications، حيث يمثّل project-number رقم مشروعك الفريد.
2. منح إذن النشر لحساب خدمة Navigation Connect
تستخدم Google حساب خدمة لنشر تعديلات الرحلات في مواضيع Google Cloud Pub/Sub. لتلقّي آخر الأخبار في موضوعك، عليك منح إذن projects.topics.publish
لهذا الموضوع لحساب الخدمة التالي:
geo-navigation-connect-pubsub@system.gserviceaccount.com.
لمزيد من المعلومات، يُرجى الاطّلاع على مستندات Pub/Sub حول التحكّم في الوصول.
3- الدمج مع الخلفية
لمعالجة التعديلات، اكتب تطبيقًا من جهة الخادم يصادق على موضوعك ويشترك فيه. استخدِم مكتبات عملاء Pub/Sub لتبسيط عملية التطوير. لأغراض الاختبار، يمكنك أيضًا استخدام GCloud CLI و Google Console.
4. اختبار اشتراكك
تحقَّق من الإعداد باستخدام gcloud CLI أو وحدة تحكُّم Google Cloud.
gcloud CLI
اسحب الرسائل من اشتراك (على سبيل المثال، my-sub) باستخدام الأمر التالي:
gcloud pubsub subscriptions pull my-sub --auto-ack
Google Cloud Console
في Google Cloud Console، اتّبِع الخطوات التالية:
- افتح صفحة الاشتراكات.
- اختَر اشتراكك وانقر على علامة التبويب الرسائل.
- انقر على سحب.
الخطوات التالية
بعد بدء تلقّي بيانات الرحلات، يمكنك تحليل البيانات لاستخدامها في أنظمتك وتطبيقاتك.