استرداد بيانات الرحلة

لتلقّي تعديلات على بيانات الرحلات من "خرائط 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، على النحو التالي:

  1. فعِّل Pub/Sub API.
  2. انتقِل إلى صفحة مواضيع Pub/Sub في وحدة تحكّم Google Cloud.
  3. انقر على إنشاء موضوع.
  4. أدخِل navigation_connect_trip_notifications في حقل رقم تعريف الموضوع.

  5. انقر على إنشاء.

تعرض وحدة التحكّم اسم الموضوع الكامل على النحو التالي: 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، اتّبِع الخطوات التالية:

  1. افتح صفحة الاشتراكات.
  2. اختَر اشتراكك وانقر على علامة التبويب الرسائل.
  3. انقر على سحب.

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

بعد بدء تلقّي بيانات الرحلات، يمكنك تحليل البيانات لاستخدامها في أنظمتك وتطبيقاتك.

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