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

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

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

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

इस गाइड में, बिलिंग की सुविधा वाले Google Cloud खाते और Google Cloud प्रोजेक्ट को सेट अप करने का तरीका बताया गया है. आपको यह भी पता होना चाहिए कि Navigation Connect API का इस्तेमाल करने पर, आपसे शुल्क कैसे लिया जाता है.

  1. Navigation Connect के इस्तेमाल और बिलिंग की जानकारी देखने के लिए, Navigation Connect के इस्तेमाल और बिलिंग पर जाएं.
  2. पुष्टि करें कि आपके पास Google Cloud खाता है.

    Google Cloud Console में साइन इन करें
  3. पुष्टि करें कि आपके पास बिलिंग की सुविधा वाला Google Cloud प्रोजेक्ट है.

    बिलिंग पेज पर जाएं
    1. बिलिंग पेज खोलने के लिए, अपना प्रोजेक्ट चुनें.
    2. बिलिंग पेज पर:

      • अगर चुने गए प्रोजेक्ट के लिए बिलिंग पहले से चालू है और आपके पास सिर्फ़ एक बिलिंग खाता है, तो बिलिंग पेज खुलता है.
      • अगर आपके पास एक से ज़्यादा बिलिंग खाते हैं, तो प्रोजेक्ट से जुड़े बिलिंग खाते की जानकारी देखने के लिए, लिंक किए गए बिलिंग खाते पर जाएं को चुनें.
      • अगर कोई बिलिंग खाता मौजूद है, लेकिन वह प्रोजेक्ट से नहीं जुड़ा है, तो आपको प्रोजेक्ट के साथ बिलिंग खाता लिंक करने के लिए कहा जाएगा.
      • अगर कोई बिलिंग खाता मौजूद नहीं है या आपको नया बिलिंग खाता बनाना है, तो नया बिलिंग खाता बनाने के लिए, बिलिंग खाते मैनेज करें को चुनें. ज़्यादा जानकारी के लिए, सेल्फ़-सर्विस वाला नया Cloud Billing खाता बनाना लेख पढ़ें.

एपीआई को चालू करना और अपने ऐप्लिकेशन की पुष्टि करना

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

1. Navigation Connect API को चालू करना

अपने Google Cloud प्रोजेक्ट में Navigation Connect API को चालू करने के लिए, Google Cloud Console या gcloud कमांड का इस्तेमाल करें.

एपीआई को चालू करने के लिए, यह तरीका अपनाएं:

कंसोल

  1. Google Cloud Console में प्रॉडक्ट पेज खोलें:

    Navigation Connect API को चालू करना
  2. चालू करें बटन पर क्लिक करें.

gcloud

gcloud services enable \
    --project "PROJECT" \
    "navigationconnect.googleapis.com"

Google Cloud SDK, Cloud SDK को इंस्टॉल करने, और इन निर्देशों के बारे में ज़्यादा जानें:

2. ऐप्लिकेशन की पुष्टि की प्रक्रिया शुरू करना

एपीआई चालू करने के बाद, आपको Navigation Connect API को चालू करने के लिए, अपने ऐप्लिकेशन की पुष्टि करनी होगी. सिर्फ़ एपीआई को चालू करने से ऐक्सेस नहीं मिलता. Navigation Connect API का इस्तेमाल करने से पहले, आपको कारोबार और ऐप्लिकेशन की जानकारी देनी होगी, ताकि उसकी समीक्षा की जा सके.

पुष्टि की प्रक्रिया शुरू करने के लिए, इनमें से किसी एक तरीके का इस्तेमाल करें:

  • एपीआई मार्केटप्लेस:
    1. API Marketplace में जाकर, Navigation Connect API कार्ड ढूंढें.
    2. पुष्टि की प्रोसेस शुरू करने के लिए, नीले रंग के पुष्टि करना ज़रूरी है आइकॉन पर क्लिक करें.
  • Google Cloud console में कुंजियां और क्रेडेंशियल:
    1. Google Cloud console में, कुंजियां और क्रेडेंशियल पेज पर जाएं.
    2. Navigation Connect की कुंजियां और क्रेडेंशियल पर क्लिक करें.
    3. बैनर में, पुष्टि की प्रक्रिया शुरू करें पर क्लिक करें.

3. ऐप्लिकेशन, डेटा कलेक्शन, और निजता के बारे में जानकारी देना

इस टेबल में, ऐप्लिकेशन की पुष्टि करने के लिए ज़रूरी जानकारी के बारे में बताया गया है:

फ़ील्ड ब्यौरा
ऐप्लिकेशन के बारे में जानकारी

यह पक्का करने के लिए कि आपका ऐप्लिकेशन, Google Maps और Waze में सही तरीके से दिखे, यहां दी गई जानकारी दें.

कारोबार या ऐप्लिकेशन का नाम Google Maps और Waze पर उपयोगकर्ताओं को दिखाने के लिए नाम डालें.
ऐप्लिकेशन आइडेंटिफ़ायर अपने Android पैकेज का नाम या iOS बंडल आईडी दें.
iOS यूनिवर्सल लिंक iOS का यूनिवर्सल लिंक दें, ताकि उपयोगकर्ता आपके ऐप्लिकेशन पर वापस आ सकें (यह सुविधा सिर्फ़ Waze पर उपलब्ध है).
ऐप्लिकेशन का लोगो (सिर्फ़ Waze के लिए) (ज़रूरी नहीं) PNG या JPG फ़ॉर्मैट में लोगो (32x32 से 128x128 पिक्सल) अपलोड करें, ताकि नेविगेशन सेशन के दौरान Waze में आपके ऐप्लिकेशन का लोगो दिखे.
डेटा कलेक्शन और निजता से जुड़ी जानकारी

पारदर्शिता, ड्राइवर का भरोसा, और डेटा की सुरक्षा पक्का करने के लिए, यह जानकारी डालें.

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

4. समीक्षा करें और सबमिट करें

अपने ऐप्लिकेशन को पुष्टि के लिए सबमिट करने से पहले, दी गई जानकारी की खास जानकारी देखें.

  1. अपने ऐप्लिकेशन के नाम, प्लैटफ़ॉर्म, आईडी, और लिंक की ध्यान से समीक्षा करें.

  2. सारी जानकारी सही है चेकबॉक्स को चुनें.
  3. सबमिट करें पर क्लिक करें.

पुष्टि के लिए ऐप्लिकेशन सबमिट करने के बाद, समीक्षा का चरण शुरू होता है.

  • समयसीमा: आम तौर पर, पुष्टि होने में एक से तीन कामकाजी दिन लगते हैं.
  • सूचना: पुष्टि की स्थिति बदलने पर, आपको ईमेल से सूचना मिलती है. आपको एक ईमेल भी मिलेगा. इसमें आपसे पेमेंट्स प्रोफ़ाइल आईडी या Android डेवलपर आईडी मांगा जाएगा. अगर आपको Android डेवलपर आईडी चाहिए, तो डेवलपर खाता बनाना लेख पढ़ें.
  • स्टेटस ट्रैकिंग: Google Cloud Console में कुंजियां और क्रेडेंशियल पेज पर जाकर, अपनी प्रोग्रेस को मॉनिटर करें.
  • सहायता: अनुमति मिलने के बाद, प्रोडक्शन पर असर डाले बिना कॉन्फ़िगरेशन को अपडेट करने के लिए, सहायता टिकट बनाएं.

पुष्टि होने के बाद, आपके ऐप्लिकेशन को Navigation Connect API का इस्तेमाल करने की अनुमति मिल जाती है. इससे यात्रा के टोकन जनरेट किए जा सकते हैं. इन टोकन से, नेविगेशन सेशन को ऐक्सेस करने की अनुमति मिलती है. साथ ही, Google Maps और Waze से यात्रा की जानकारी मिलती है.

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 की मदद से ऐक्सेस टोकन बनाने और उन्हें मैनेज करने के कई तरीके हैं.

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

  1. gcloud सीएलआई को इंस्टॉल करें और उसे शुरू करें. ज़्यादा जानकारी के लिए, gcloud सीएलआई इंस्टॉल करें लेख पढ़ें.

  2. gcloud सीएलआई की मदद से पुष्टि करें:

    gcloud auth application-default login
  3. एडीसी की इस्तेमाल की जाने वाली लोकल क्रेडेंशियल फ़ाइल में अपने क्रेडेंशियल सेव करने के लिए, साइन इन करने की प्रोसेस पूरी करें.

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

REST अनुरोध करना

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

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

    gcloud auth application-default print-access-token

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

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

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: पुष्टि किया गया वह टोकन जो Google Maps या Waze में, ट्रैक किए गए रास्ते के दिशा-निर्देशों को शुरू करने के लिए, createTrip तरीका दिखाता है

समस्या का हल

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

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

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

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