Navigation Connect को सेट अप करना

यूरोपियन इकनॉमिक एरिया (ईईए) के डेवलपर

इस दस्तावेज़ में, नेविगेशन कनेक्ट का इस्तेमाल शुरू करने का तरीका बताया गया है.

पक्का करें कि आपने ज़रूरी शर्तें पूरी की हों.

अपने Google Cloud प्रोजेक्ट में एपीआई चालू करें.

पुष्टि किए गए एपीआई अनुरोध करने के लिए, OAuth कॉन्फ़िगर करें.

Google Maps Platform के प्रॉडक्ट को बिना अनुमति के इस्तेमाल से सुरक्षित रखा जाता है. इसके लिए, एपीआई कॉल में OAuth टोकन शामिल करना ज़रूरी होता है.

OAuth टोकन बनाना

Navigation Connect, पुष्टि करने के लिए OAuth 2.0 का इस्तेमाल करने की सुविधा देता है. Google, OAuth 2.0 के सामान्य इस्तेमाल के उदाहरणों के साथ काम करता है. जैसे, वेब सर्वर के लिए OAuth 2.0 का इस्तेमाल.

इस दस्तावेज़ में बताया गया है कि डेवलपमेंट एनवायरमेंट में, Navigation Connect कॉल में OAuth टोकन कैसे पास किया जाता है. प्रोडक्शन एनवायरमेंट में OAuth का इस्तेमाल करने के निर्देशों के लिए, Google पर पुष्टि करने के तरीके देखें.

OAuth के बारे में जानकारी

OAuth की मदद से ऐक्सेस टोकन बनाने और उन्हें मैनेज करने के कई तरीके हैं. ये तरीके, आपके डिप्लॉयमेंट एनवायरमेंट पर निर्भर करते हैं.

उदाहरण के लिए, Google का OAuth 2.0 सिस्टम, सर्वर-टू-सर्वर इंटरैक्शन के साथ काम करता है. जैसे, आपके ऐप्लिकेशन और Google की किसी सेवा के बीच होने वाले इंटरैक्शन. इस स्थिति में, आपको एक सेवा खाते की ज़रूरत होगी. यह खाता, किसी असली उपयोगकर्ता के बजाय आपके ऐप्लिकेशन का होता है. आपका ऐप्लिकेशन, सेवा खाते की ओर से Google API को कॉल करता है. इसलिए, इसमें उपयोगकर्ता सीधे तौर पर शामिल नहीं होते. पुष्टि करने के तरीकों के बारे में ज़्यादा जानने के लिए, Google पर पुष्टि करने के तरीके लेख पढ़ें.

इसके अलावा, Android या iOS मोबाइल ऐप्लिकेशन के हिस्से के तौर पर, Navigation Connect का इस्तेमाल किया जा सकता है. Navigation Connect के साथ OAuth का इस्तेमाल करने के बारे में सामान्य जानकारी के लिए, OAuth 2.0 का इस्तेमाल करके, Google API को ऐक्सेस करना लेख पढ़ें. इसमें अलग-अलग डिप्लॉयमेंट एनवायरमेंट के लिए ऐक्सेस टोकन मैनेज करने के बारे में भी जानकारी दी गई है.

OAuth के दायरों के बारे में जानकारी

Navigation Connect के साथ OAuth का इस्तेमाल करने के लिए, OAuth टोकन को यह स्कोप असाइन किया जाना चाहिए:

https://www.googleapis.com/auth/cloud-platform

उदाहरण: अपने लोकल डेवलपमेंट एनवायरमेंट में REST API कॉल आज़माएं

अगर आपको OAuth टोकन का इस्तेमाल करके Navigation Connect आज़माना है, लेकिन आपके पास टोकन जनरेट करने के लिए एनवायरमेंट सेटअप नहीं है, तो कॉल करने के लिए इस सेक्शन में दिया गया तरीका इस्तेमाल करें.

इस उदाहरण में, कॉल करने के लिए ऐप्लिकेशन डिफ़ॉल्ट क्रेडेंशियल (एडीसी) से मिले OAuth टोकन का इस्तेमाल करने का तरीका बताया गया है. क्लाइंट लाइब्रेरी का इस्तेमाल करके Google API को कॉल करने के लिए, एडीसी का इस्तेमाल करने के बारे में जानकारी पाने के लिए, क्लाइंट लाइब्रेरी का इस्तेमाल करके पुष्टि करना लेख पढ़ें.

ज़रूरी शर्तें

एडीसी का इस्तेमाल करके REST अनुरोध करने से पहले, Google Cloud CLI का इस्तेमाल करके एडीसी को क्रेडेंशियल दें:

  1. gcloud सीएलआई इंस्टॉल करें और इसका इस्तेमाल शुरू करें.

  2. अपनी लोकल मशीन पर, क्रेडेंशियल फ़ाइल बनाने के लिए यह gcloud कमांड चलाएं:

    gcloud auth application-default login
  3. आपको लॉगिन स्क्रीन दिखेगी. लॉग इन करने के बाद, आपके क्रेडेंशियल ADC इस्तेमाल करने वाली लोकल क्रेडेंशियल फ़ाइल में सेव हो जाते हैं.

ज़्यादा जानकारी के लिए, लोकल डेवलपमेंट एनवायरमेंट के लिए एडीसी सेट अप करना लेख पढ़ें.

REST अनुरोध करना

इस उदाहरण में, दो अनुरोध हेडर पास किए गए हैं:

  • टोकन जनरेट करने के लिए, यहां दी गई कमांड का इस्तेमाल करके Authorization हेडर में OAuth टोकन पास करें:

    gcloud auth application-default print-access-token

    वापस किए गए टोकन का स्कोप https://www.googleapis.com/auth/cloud-platform. है

  • X-Goog-User-Project हेडर में, उस Google Cloud प्रोजेक्ट का आईडी या नाम पास करें जिसमें बिलिंग की सुविधा चालू है.

इस उदाहरण में, OAuth टोकन का इस्तेमाल करके Navigation Connect को कॉल किया गया है.

  1. अपने Google Cloud प्रोजेक्ट का आईडी पास करने के लिए, PROJECT_ID फ़ील्ड में बदलाव करें.

    इसके अलावा, ज़रूरत के हिसाब से इनमें भी बदलाव करें:

    • ANDROID_APP_ID: आपके ऐप्लिकेशन का Android पैकेज का नाम.
    • IOS_APP_ID: यह आपके ऐप्लिकेशन का iOS बंडल आईडी है.
    #!/bin/bash

trip_id="$(uuidgen)"
access_token="$(gcloud auth application-default print-access-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 '{
  "androidAppId": "ANDROID_APP_ID",
  "iosAppId": "IOS_APP_ID",
}'
  2. curl निर्देश को कॉपी करने के लिए, कोड के सैंपल में मौजूद कॉपी करें आइकॉन, कॉपी करें आइकॉन को चुनें., पर क्लिक करें.
  3. कमांड को टर्मिनल विंडो में चिपकाएं और उसे चलाएं.

रिस्पॉन्स, एक JSON ऑब्जेक्ट है:

{
  "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: प्रोजेक्ट के लिए यूनीक लॉन्ग इंटिजर आइडेंटिफ़ायर.
  • TRIP_ID: यह ट्रिप आईडी है. इसे आपके बैकएंड ने UUIDv4 फ़ॉर्मैट में जनरेट किया है.
  • BASE64_ENCODED_TRIP_TOKEN: यह पुष्टि किया गया टोकन है. इसे createTrip तरीके से वापस लाया जाता है. इस टोकन को अपने मोबाइल ऐप्लिकेशन पर पास करें, ताकि Google Maps या Waze में ट्रैक किया गया मोड़-दर-मोड़ नेविगेशन शुरू किया जा सके.

समस्या का हल

अगर आपके अनुरोध पर, गड़बड़ी का ऐसा मैसेज मिलता है जिसमें बताया गया है कि इस एपीआई के साथ असली उपयोगकर्ता के क्रेडेंशियल काम नहीं करते, तो अपने एडीसी सेटअप से जुड़ी समस्या हल करें लेख पढ़ें.

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

Navigation Connect API सेट अप करने का अगला चरण, अपने सेवा खातों को सेट अप करना है. इससे आपके बैकएंड इन्फ़्रास्ट्रक्चर और Google Maps और Waze के बीच सुरक्षित तरीके से सर्वर से सर्वर कम्यूनिकेशन चालू किया जा सकेगा.

अपना सेवा खाता सेट अप करना