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

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

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

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

CreateTripRequest मैसेज बनाना

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

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

यहां दिए गए उदाहरण में, 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 मैसेज में जाकर, इन सेटिंग में बदलाव करके यात्रा के डेटा को अपनी पसंद के मुताबिक बनाया जा सकता है:

सुविधा टाइप ब्यौरा
बाकी बचे रास्ते की रिपोर्टिंग (सिर्फ़ Waze के लिए) boolean

चालू रूट की पॉलीलाइन और रीयल-टाइम ट्रैफ़िक का हाल पाने के लिए, config.enableRemainingRouteReporting को true पर सेट करें.
यात्रा की जानकारी अपडेट का अंतराल 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 लॉन्च करें