यात्रा का डेटा वापस पाना

Google Maps या Waze से यात्रा के डेटा के अपडेट पाने के लिए, अपने बैकएंड को कॉन्फ़िगर करें. इसके लिए, इनमें से कोई एक विकल्प इस्तेमाल करें:

  • Navigation Connect API का इस्तेमाल करके पुल करने का तरीका या
  • Google Cloud Pub/Sub का इस्तेमाल करके, इवेंट-ड्रिवन पुश करने का तरीका.

पहला विकल्प: Navigation Connect API का इस्तेमाल करना

यात्रा की स्थिति की नई जानकारी को मैन्युअल तरीके से फ़ेच करने के लिए, यूनीक ट्रिप आईडी के साथ GetTrip तरीके को कॉल करें.

यहां दिए गए सैंपल में, सर्वर से सर्वर के अनुरोध की पुष्टि करने के लिए, कमांड लाइन से एपीआई को कॉल करने का तरीका बताया गया है. इसके लिए, आपको अपने ऐप्लिकेशन के डिफ़ॉल्ट क्रेडेंशियल (एडीसी) का इस्तेमाल करना होगा.

#!/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: यह स्टैंडर्ड तौर पर कोड की गई पॉलीलाइन स्ट्रिंग है. इसमें पांच दशमलव बिंदु होते हैं.
  • S2ENCODED: यह एक कोड में बदला गया S2Polyline है.
  • GEO_JSON: यह GeoJSON LineString फ़ॉर्मैट है.

दूसरा विकल्प: Google Cloud Pub/Sub का इस्तेमाल करना

यात्रा के बारे में नियमित अपडेट पाने के लिए, Google Cloud Pub/Sub के किसी विषय की सदस्यता लें. ड्राइवर की सहमति मिलने के बाद, Navigation Connect सीधे आपके विषय पर अपडेट भेजता है.

मैसेजिंग के बारे में जानने के लिए, Pub/Sub क्विकस्टार्ट देखें.

यहां दिए गए सेक्शन में, Google Maps या Waze के साथ नेविगेशन सेशन से डेटा पाने के लिए, Google Cloud Pub/Sub का इस्तेमाल करने का तरीका बताया गया है.

1. कोई विषय बनाना

अपने Google Cloud प्रोजेक्ट में, navigation_connect_trip_notifications नाम का एक विषय बनाएं. इसके लिए, यह तरीका अपनाएं:

  1. Pub/Sub API को चालू करें.
  2. Google Cloud Console में, Pub/Sub के विषयों वाले पेज पर जाएं.
  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 सीएलआई या Google Cloud Console का इस्तेमाल करके, अपने सेटअप की पुष्टि करें.

gcloud सीएलआई

नीचे दिए गए निर्देश का इस्तेमाल करके, किसी सदस्यता (उदाहरण के लिए, my-sub) से मैसेज पाएं:

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

Google Cloud कंसोल

Google Cloud Console में जाकर, यह तरीका अपनाएं:

  1. सदस्यताएं पेज खोलें.
  2. अपनी सदस्यता चुनें और मैसेज टैब पर क्लिक करें.
  3. पुल करें पर क्लिक करें.

आगे क्या करना है

यात्रा का डेटा मिलना शुरू होने के बाद, उसे अपने सिस्टम और ऐप्लिकेशन में इस्तेमाल करने के लिए पार्स करें.

यात्रा के डेटा को मैनेज करना