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

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

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

देखें कि आपने ज़रूरी शर्तें पूरी की हैं या नहीं.

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

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

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

OAuth टोकन बनाना

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

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

सर्वर को एपीआई अनुरोध भेजकर, Google Maps API को सीधे तौर पर कॉल किया जा सकता है. इसके अलावा, अपने कोड को आसान बनाने के लिए क्लाइंट लाइब्रेरी का इस्तेमाल किया जा सकता है. Google Maps, Go, Java, Node.js, और Python के लिए क्लाइंट लाइब्रेरी उपलब्ध कराता है. ज़्यादा जानकारी के लिए, Navigation Connect क्लाइंट लाइब्रेरी देखें.

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

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

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

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

OAuth के दायरे

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

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

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

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

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

नीचे दी गई REST प्रक्रिया का इस्तेमाल सिर्फ़ डेवलपमेंट या टेस्टिंग के लिए करें, प्रोडक्शन के लिए नहीं.

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

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

  1. gcloud सीएलआई को इंस्टॉल करें और इसका इस्तेमाल शुरू करें. ज़्यादा जानकारी के लिए, 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. यहां दिए गए कोड सैंपल में, प्लेसहोल्डर की जगह अपनी वैल्यू डालें:

    • PROJECT_ID: आपका Google Cloud प्रोजेक्ट आईडी
    • 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 के बीच सुरक्षित तरीके से सर्वर-टू-सर्वर कम्यूनिकेशन किया जा सकेगा.

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