यात्रा बनाएं और यात्रा का टोकन पाएं

ड्राइवर के लिए, रास्ते के दिशा-निर्देशों वाला सेशन सुरक्षित तरीके से लॉन्च करने के लिए, आपके बैकएंड को एक यात्रा बनानी होगी. साथ ही, Navigation Connect API से यात्रा का पुष्टि किया गया टोकन पाना होगा.

नेविगेशन कनेक्ट में, यात्रा का मतलब किसी एक मंज़िल तक के नेविगेशन सेशन से है. यात्रा बनाने और पुष्टि किया गया यात्रा टोकन (authToken) पाने के लिए, CreateTrip तरीके को CreateTripRequest मैसेज भेजें. सेशन को अनुमति देने के लिए, यात्रा टोकन ज़रूरी है. यात्रा के टोकन को अपने मोबाइल ऐप्लिकेशन में पास करें, ताकि उसे Google Maps या Waze के लॉन्च यूआरएल में शामिल किया जा सके.

इस गाइड में, एक यूनीक ट्रिप आईडी जनरेट करके और एपीआई अनुरोध सबमिट करके, इस प्रोसेस को पूरा करने का तरीका बताया गया है.

CreateTripRequest मैसेज लिखें

यात्रा बनाने और यात्रा का टोकन पाने के लिए, CreateTripRequest मैसेज बनाने और भेजने के लिए यह तरीका अपनाएं:

  1. पुष्टि करना: अपने अनुरोध को अनुमति देने के लिए, ऐक्सेस टोकन पाने के लिए ऐप्लिकेशन के डिफ़ॉल्ट क्रेडेंशियल (एडीसी) का इस्तेमाल करें. ज़्यादा जानकारी के लिए, OAuth टोकन बनाना लेख पढ़ें.
  2. ट्रिप आईडी जनरेट करना: अपने सर्वर पर ट्रिप की पहचान करने के लिए, UUIDv4 फ़ॉर्मैट में एक यूनीक ट्रिप आईडी (tripId) बनाएं.
  3. पेलोड बनाना: एक JSON पेलोड बनाएं, जिसमें आपके ऐप्लिकेशन आईडी और कॉन्फ़िगरेशन सेटिंग शामिल हों.
  4. CreateTrip तरीके को कॉल करें: एपीआई को एक पोस्ट अनुरोध भेजें. इसमें हेडर में ऐक्सेस टोकन और मुख्य हिस्से में पेलोड शामिल होना चाहिए.

यहां दिए गए उदाहरण में, CreateTripRequest मैसेज भेजकर यात्रा बनाने का तरीका बताया गया है:

#!/bin/bash

# Authenticate with ADC
access_token="$(gcloud auth application-default login --impersonate-service-account=SERVICE_ACCOUNT_EMAIL)"

# Generate a unique Trip ID
trip_id="$(uuidgen)"

# Construct the payload
payload=$(cat <<EOF
{
  "androidAppId": "ANDROID_APP_ID",
  "iosAppId": "IOS_APP_ID",
  "config": {
    "enablePubsub": true
  }
}
EOF
)

# Call the CreateTrip method to request a trip token
curl -X POST "https://navigationconnect.googleapis.com/v1/projects/PROJECT_ID/trips?tripId=${trip_id}" \
-H "Authorization: Bearer ${access_token}" \
-H "Content-Type: application/json" \
-d "${payload}"

वैकल्पिक कॉन्फ़िगरेशन

CreateTripRequest मैसेज में जाकर, इन सेटिंग में बदलाव करके, यात्रा के डेटा को अपनी पसंद के मुताबिक बनाया जा सकता है:

सुविधा टाइप ब्यौरा
रास्ते की बाकी जानकारी देना boolean

ऐक्टिव रूट की पॉलीलाइन और रीयल-टाइम ट्रैफ़िक का हाल पाने के लिए, config.enableRemainingRouteReporting को true पर सेट करें.

ड्राइवर के पास Android पर Waze का 5.20.0.2 या इसके बाद का वर्शन, iOS पर 5.20.0.1 या इसके बाद का वर्शन या Android के लिए Google Maps का 26.27 या इसके बाद का वर्शन होना चाहिए.

तय रास्ते में बदलाव की जानकारी देना (सिर्फ़ Waze के लिए) boolean

जब कोई ड्राइवर तय किए गए रास्ते से भटक जाए, तो उसे ट्रैक करने के लिए, config.enableRouteDeviationReporting को true पर सेट करें.

ड्राइवर के पास Waze का 5.22 या इसके बाद का वर्शन होना चाहिए.

यात्रा की जानकारी अपडेट का अंतराल boolean

डिफ़ॉल्ट रूप से, Navigation Connect हर 60 सेकंड में यात्रा का डेटा अपडेट करता है. हर पांच सेकंड में अपडेट पाने की सुविधा चालू करने के लिए, config.enableHighFrequencyUpdates को true पर सेट करें.

Google Cloud Pub/Sub इवेंट जनरेट करना boolean

Google Cloud Pub/Sub का इस्तेमाल करके, यात्रा से जुड़े इवेंट जनरेट करने की सुविधा चालू करने के लिए, config.enablePubsub को true पर सेट करें. यह सुविधा डिफ़ॉल्ट रूप से बंद रहती है.

Google Cloud Pub/Sub फ़ील्ड मास्क FieldMask

पेलोड के साइज़ को मैनेज करने और बैकएंड प्रोसेसिंग लोड या Google Cloud Pub/Sub के इस्तेमाल की लागत को कम करने के लिए, config.pubsubFieldMask का इस्तेमाल करें. इससे आपकी इवेंट स्ट्रीम से, ज़्यादा साइज़ वाले फ़ील्ड (जैसे कि execution.remainingRoute) को बाहर रखा जा सकेगा. बाकी बचे रूट डेटा के पेलोड साइज़ के बारे में ज़्यादा जानने के लिए, बाकी बचे रूट डेटा को मैनेज करना लेख पढ़ें.

जवाब से यात्रा का टोकन पाना

CreateTrip वाला तरीका, जवाब में यात्रा का वह टोकन दिखाता है जिसकी पुष्टि हो चुकी है. नेविगेशन सेशन को अनुमति देने के लिए, जवाब से यह टोकन निकालें और इसे अपने मोबाइल ऐप्लिकेशन को पास करें, ताकि इसे लॉन्च यूआरएल में शामिल किया जा सके.

यहां दिए गए कोड सैंपल में, जवाब का एक उदाहरण दिखाया गया है:

{
    "name": "projects/PROJECT_NUMBER/trips/TRIP_ID",
  "authToken": {
    "token": "BASE64_ENCODED_TRIP_TOKEN",
    "expireTime": "2026-03-06T11:09:47.476942Z"
  },
  "state": "NEW",
  "execution": {
    "traveledDistanceMeters": 0,
    "stopAddedInRoute": false
  },
  "createTime": "2026-03-05T23:09:50.768959Z",
  "updateTime": "2026-03-05T23:09:50.768959Z"
}

इस रिस्पॉन्स में ये वैल्यू शामिल होती हैं:

  • PROJECT_NUMBER: आपके प्रोजेक्ट का यूनीक न्यूमेरिक आइडेंटिफ़ायर. यह आपके अक्षरों और अंकों वाले प्रोजेक्ट आईडी से अलग होता है. हालांकि, यह उसी Google Cloud प्रोजेक्ट को दिखाता है.
  • TRIP_ID: आपके बैकएंड से जनरेट किया गया यात्रा आईडी. यह UUIDv4 फ़ॉर्मैट में होता है.
  • BASE64_ENCODED_TRIP_TOKEN: पुष्टि किया गया यात्रा टोकन (authToken.token), जिसे CreateTrip तरीके से दिखाया गया है. Google Maps या Waze में, ट्रैक किए गए रास्ते के दिशा-निर्देश की सुविधा शुरू करने के लिए, इस टोकन को अपने मोबाइल ऐप्लिकेशन को पास करें.

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

Google Maps या Waze को लॉन्च करने के लिए, यात्रा के टोकन का इस्तेमाल करें.

Google Maps या Waze लॉन्च करना