जियोलोकेशन एपीआई के साथ एपीआई कुंजियों का इस्तेमाल करें

संग्रह की मदद से व्यवस्थित रहें अपनी प्राथमिकताओं के आधार पर, कॉन्टेंट को सेव करें और कैटगरी में बांटें.

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

इस गाइड में बताया गया है कि आप Google Maps Platform के लिए अपनी एपीआई कुंजी कैसे बनाएं, उस पर पाबंदी लगाएं, और उसका इस्तेमाल कैसे करें.

शुरू करने से पहले

जियोलोकेशन एपीआई का इस्तेमाल करने से पहले, आपको एक ऐसे प्रोजेक्ट की ज़रूरत होगी जिसमें बिलिंग खाता हो. साथ ही, जियोलोकेशन एपीआई भी चालू हो. ज़्यादा जानने के लिए, Cloud Console में सेट अप करना देखें.

एपीआई कुंजियां बनाना

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

एपीआई कुंजी बनाने के लिए:

कंसोल

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

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

  2. क्रेडेंशियल पेज पर, क्रेडेंशियल और gt; एपीआई कुंजी बनाएं पर क्लिक करें.
    एपीआई कुंजी बनाई गई डायलॉग, आपकी नई एपीआई कुंजी दिखाती है.
  3. बंद करें पर क्लिक करें.
    नई एपीआई कुंजी, एपीआई कुंजियों के तहत क्रेडेंशियल पेज पर दी गई है.
    (प्रोडक्शन में इस्तेमाल करने से पहले, एपीआई को प्रतिबंधित करना न भूलें.)

Cloud SDK

gcloud alpha services api-keys create \
    --project "PROJECT" \
    --display-name "DISPLAY_NAME"

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

एपीआई कुंजियों पर पाबंदी लगाना

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

एपीआई कुंजी को सीमित करने के लिए:

कंसोल

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

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

  2. वह एपीआई कुंजी चुनें जिस पर आप पाबंदी लगाना चाहते हैं. इसके बाद, एपीआई कुंजी की प्रॉपर्टी वाला पेज दिखेगा.
  3. मुख्य पाबंदियां में जाकर, ये पाबंदियां सेट करें:
    • ऐप्लिकेशन पर लगी पाबंदियां:
      1. दिए गए वेब सर्वर आईपी पतों की सूची से अनुरोध स्वीकार करने के लिए, ऐप्लिकेशन पाबंदियों की सूची में से, आईपी पते, वेब सर्वर, क्रॉन जॉब वगैरह) चुनें. सीआईडीआर नोटेशन (उदाहरण के लिए, 192.168.0.0/22) का इस्तेमाल करके, कोई IPv4 या IPv6 पता या कोई सबनेट बताएं. वेब सेवा के वेब अनुरोध में, बाहरी कुंजी की जांच करने के लिए, एपीआई कुंजी की पाबंदी से जांच की जाती है. इसलिए, सर्वर के सार्वजनिक आईपी पते का इस्तेमाल करें.
    • एपीआई की पाबंदियां:
      1. कुंजी पर पाबंदी लगाएं पर क्लिक करें.
      2. Choose API ड्रॉपडाउन से भौगोलिक स्थान एपीआई चुनें. अगर जियोलोकेशन एपीआई सूची में नहीं है, तो आपको इसे चालू करना होगा.
  4. अपने बदलावों को अंतिम रूप देने के लिए, सेव करें पर क्लिक करें.

Cloud SDK

मौजूदा कुंजियों की सूची बनाएं.

gcloud services api-keys list --project="PROJECT"

मौजूदा कुंजी पर लगी पाबंदियां हटाएं.

gcloud alpha services api-keys update "projects/PROJECT/keys/KEY_ID" \
    --clear-restrictions

मौजूदा कुंजी पर नई पाबंदियां सेट करें.

gcloud alpha services api-keys update "projects/PROJECT/keys/KEY_ID" \
    --api_target="geolocation.googleapis.com"
    --allowed-ips="IP_ADDRESS"

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

अपने अनुरोध में एपीआई कुंजी जोड़ना

आपको हर Geolocation API अनुरोध के साथ एपीआई कुंजी शामिल करनी होगी. नीचे दिए गए उदाहरण में, YOUR_API_KEY को अपनी एपीआई कुंजी से बदलें.

https://www.googleapis.com/geolocation/v1/geolocate?key=YOUR_API_KEY

एपीआई कुंजी का इस्तेमाल करने वाले अनुरोधों के लिए, एचटीटीपीएस ज़रूरी है.