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

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

تخصيص تنسيقات الخطوط المتعددة (‫Waze فقط)

إذا فعّلت إعداد تقارير عن المسار المتبقي أثناء إنشاء الرحلة، يمكنك تخصيص طريقة عرض المضلّع الخطي للمسار المتبقي الذي تم عرضه عند استدعاء الطريقة GetTrip.

لاختيار تنسيق للخط المتعدد، أدرِج المَعلمة routePolylineFormat في طلبك. تشمل التنسيقات المتوافقة ما يلي:

  • ‫ENCODED: سلسلة خطوط متعدّدة مرمّزة عادية (5 نقاط عشرية)
  • ‫S2ENCODED: تمثّل هذه السمة خطًا متعدد الأضلاع من S2Polyline.
  • GEO_JSON: تنسيق GeoJSON LineString.

الخيار 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.

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. انقر على سحب.

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

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

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