Geolocation API सेट अप करना

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

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

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

1. Geolocation API के इस्तेमाल और बिलिंग पर जाकर, बिलिंग और इस्तेमाल की लागत की समीक्षा करें.

2. पुष्टि करें कि आपके पास Google Cloud खाता है.

   Google Cloud Console में साइन इन करना
   ध्यान दें: अगर आप नए उपयोगकर्ता हैं और आपके पास Google Cloud खाता नहीं है, तो इसका मतलब है कि कंसोल में साइन इन नहीं किया जा सकता. इसके लिए, Google Maps Platform का इस्तेमाल शुरू करना देखें.

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

   बिलिंग पेज पर जाएं
   ध्यान दें: अगर आप नए उपयोगकर्ता हैं और आपके पास Google Cloud प्रोजेक्ट नहीं है, तो Google Maps Platform का इस्तेमाल शुरू करना लेख पढ़ें.
1. बिलिंग पेज खोलने के लिए, अपना प्रोजेक्ट चुनें.

2. बिलिंग पेज पर:

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

एपीआई को चालू करना

Geolocation API का इस्तेमाल करने से पहले, आपको Google Cloud console या gcloud कमांड का इस्तेमाल करके, इसे अपने Google Cloud प्रोजेक्ट में चालू करना होगा.

ध्यान दें: किसी एपीआई को चालू करने के बाद, उससे अनुरोध करने के लिए आपको कुछ मिनट इंतज़ार करना पड़ सकता है.

एपीआई को चालू करने के लिए:

कंसोल

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

   जियोलोकेशन एपीआई को चालू करना

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

   ध्यान दें: अगर एपीआई पहले से चालू है, तो आपको चालू करें के बजाय मैनेज करें बटन दिखेगा.

gcloud

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

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

• gcloud services enable
• gcloud services disable

Geolocation API के साथ इस्तेमाल करने के लिए, एपीआई पासकोड पाना

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

एपीआई पासकोड, अक्षरों और अंकों से बनी एक यूनीक स्ट्रिंग होती है. यह आपके Cloud बिलिंग खाते और Google Cloud प्रोजेक्ट को उस अनुरोध से जोड़ती है जो आपका ऐप्लिकेशन, Google Maps Platform API या एसडीके को भेजता है. नई कुंजी बनाने या किसी मौजूदा कुंजी में एपीआई या SDK टूल जोड़ने के लिए, यह तरीका अपनाएं.

कंसोल

1. Google Maps Platform > कुंजियां और क्रेडेंशियल पेज पर जाएं.

   कुंजियां और क्रेडेंशियल पेज पर जाएं

2. अगर कहा जाए, तो अपना प्रोजेक्ट चुनें.

3. इनमें से कोई एक काम करें:

   • नई कुंजी बनाना:

     1. क्रेडेंशियल बनाएं > एपीआई पासकोड पर क्लिक करें.
     2. एपीआई पासकोड बनाएं पैनल में, एपीआई से जुड़ी पाबंदियां चुनें सूची खोलें.
     3. इस कुंजी के लिए जिन एपीआई की ज़रूरत नहीं है उन्हें हटाएं. साथ ही, पक्का करें कि Geolocation API चुना हुआ रहे.
     4. बनाएं पर क्लिक करें. पैनल में आपका नया एपीआई पासकोड दिखता है.

   • किसी मौजूदा कुंजी का इस्तेमाल करना:

     1. कुंजी के नाम पर क्लिक करें.
     2. एपीआई से जुड़ी पाबंदियां चुनें सूची में, Geolocation API चुनें.
     3. सेव करें पर क्लिक करें.

   यहां किसी एपीआई को चुनने से वह चालू नहीं होता. पक्का करें कि Geolocation API, इसके एपीआई लाइब्रेरी पेज पर चालू हो.

4. कुंजी की स्ट्रिंग को बाद में देखने के लिए, कुंजियां और क्रेडेंशियल पेज पर जाएं. इसके बाद, कुंजी के लिए कुंजी दिखाएं पर क्लिक करें.

अगर कंसोल इन चरणों से अलग दिखता है, तो Google Cloud के दस्तावेज़ में जाकर, एपीआई पासकोड बनाना और एपीआई से जुड़ी पाबंदियां जोड़ना लेख पढ़ें.

gcloud

यहां दिए गए कमांड में, PROJECT_ID की जगह अपना प्रोजेक्ट आईडी डालें.

• नई कुंजी बनाएं: यहां दिया गया निर्देश चलाएं और DISPLAY_NAME को कुंजी के नाम से बदलें.

  gcloud services api-keys create \
      --project="PROJECT_ID" \
      --display-name="DISPLAY_NAME" \
      --api-target=service=geolocation.googleapis.com

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

  • gcloud services api-keys create

• किसी मौजूदा कुंजी का इस्तेमाल करना: यह कमांड चलाएं और KEY_ID को कुंजी के आईडी से बदलें. --append फ़्लैग, उन एपीआई को बनाए रखता है जिनकी अनुमति कुंजी पहले से देती है. इसके बिना, कमांड उन्हें बदल देता है.

  gcloud services api-keys update KEY_ID \
      --project="PROJECT_ID" \
      --append \
      --api-target=service=geolocation.googleapis.com

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

  • gcloud services api-keys update
  • gcloud services api-keys list

  कुंजी का आईडी, कुंजी की स्ट्रिंग या डिसप्ले नेम नहीं होता. इसे ढूंढने के लिए, gcloud services api-keys list --project="PROJECT_ID" चलाएं. आईडी, name फ़ील्ड का आखिरी हिस्सा होता है: projects/PROJECT_NUMBER/locations/global/keys/KEY_ID.

की स्ट्रिंग देखने के लिए, gcloud services api-keys get-key-string KEY_ID --project="PROJECT_ID" चलाएं.

एपीआई अनुरोध करना

Geolocation API से अनुरोध करें, ताकि आपको JSON फ़ॉर्मैट में रिस्पॉन्स मिले. इसमें जगह की जानकारी, अक्षांश और देशांतर निर्देशांक के तौर पर मिलती है. आपको हर अनुरोध के साथ अपने एपीआई पासकोड की अक्षरों और अंकों वाली स्ट्रिंग शामिल करनी होगी. साथ ही, एपीआई पासकोड वाले अनुरोधों के लिए एचटीटीपीएस का इस्तेमाल करना होगा.

1. कुंजी की अक्षरों और अंकों वाली स्ट्रिंग डालने के लिए, नीचे दिए गए कोड में API_KEY पर क्लिक करें:

   curl -X POST -d '{
     "considerIp": "false",
     "wifiAccessPoints": [
       {
         "macAddress": "3c:37:86:5d:75:d4",
         "signalStrength": -35,
         "signalToNoiseRatio": 0
       },
       {
         "macAddress": "30:86:2d:c4:29:d0",
         "signalStrength": -35,
         "signalToNoiseRatio": 0
       }
     ]
   }' \
   -H 'Content-Type: application/json' \
   -H 'X-Goog-Api-Key:YOUR_API_KEY' \
   'https://www.googleapis.com/geolocation/v1/geolocate'
   

2. curl कमांड को कॉपी करने के लिए, कोड सैंपल में मौजूद कॉपी करें आइकॉन पर क्लिक करें.
3. कमांड को टर्मिनल विंडो में चिपकाएं और उसे चलाएं.

रिस्पॉन्स, इस फ़ॉर्म में एक JSON ऑब्जेक्ट होता है:

{
  "location": {
    "lat": 37.4241247,
    "lng": -122.0915703
  },
  "accuracy": 20
}

एपीआई पासकोड से जुड़ी पाबंदियां लागू करना

चेतावनी: बिना पाबंदी वाले एपीआई पासकोड का इस्तेमाल करके, Google Maps Platform की किसी भी सेवा के लिए अनुरोध किया जा सकता है. इसमें Geolocation API भी शामिल है. बिना पाबंदी वाले एपीआई पासकोड के गलत इस्तेमाल की वजह से लगने वाले शुल्क के लिए, आप ज़िम्मेदार हैं.

Google का सुझाव है कि आप अपने एपीआई पासकोड पर पाबंदियां लगाएं. इसके लिए, उनका इस्तेमाल सिर्फ़ उन एपीआई और ऐप्लिकेशन तक सीमित करें जिन्हें उनकी ज़रूरत है. एपीआई पासकोड पर पाबंदियां लगाने से, आपके ऐप्लिकेशन को सुरक्षा मिलती है. इससे ऐप्लिकेशन को बिना अनुमति वाले अनुरोधों से सुरक्षित रखा जा सकता है. एपीआई पासकोड पर दो तरह की पाबंदियां लगाई जा सकती हैं:

• एपीआई से जुड़ी पाबंदियों से पता चलता है कि एपीआई पासकोड का इस्तेमाल करके, किन एसडीके और एपीआई को कॉल किया जा सकता है. कुंजी बनाते समय, कंसोल और gcloud सीएलआई के लिए, एपीआई पर कम से कम एक पाबंदी लगाना ज़रूरी है.
• ऐप्लिकेशन से जुड़ी पाबंदियों से पता चलता है कि कौनसी वेबसाइटें, आईपी पते या ऐप्लिकेशन, एपीआई पासकोड का इस्तेमाल कर सकते हैं.

पाबंदियां लगाने के बारे में ज़्यादा जानकारी के लिए, एपीआई पासकोड पर पाबंदी लगाना लेख पढ़ें.

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

अब आपने Geolocation API को चालू कर लिया है और अनुरोध भी कर लिया है. एपीआई को इस्तेमाल करने के बारे में ज़्यादा जानने के लिए, जगह की जानकारी के अनुरोध और जवाब देखें.