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

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

4. اختبار اشتراكك

تحقَّق من إعداداتك باستخدام gcloud CLI أو وحدة تحكّم Google Cloud.

gcloud CLI

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

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

Google Cloud Console

في وحدة تحكّم Google Cloud، اتّبِع الخطوات التالية:

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

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

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

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