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

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

gcloud CLI

اسحب الرسائل من اشتراك (مثل my-sub) باستخدام الأمر التالي:

gcloud pubsub subscriptions pull my-sub --auto-ack

Google Cloud Console

في Google Cloud Console، اتّبِع الخطوات التالية:

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

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

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

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