Google Maps Platform के प्रॉडक्ट, बिना अनुमति के इस्तेमाल नहीं किए जा सकते. इसके लिए, हम एपीआई कॉल को उन प्रॉडक्ट के लिए सीमित कर देते हैं जो पुष्टि करने के लिए सही क्रेडेंशियल देते हैं. ये क्रेडेंशियल, एपीआई पासकोड के तौर पर होते हैं - अक्षरों और अंकों वाली एक यूनीक स्ट्रिंग, जो आपके Google बिलिंग खाते को आपके प्रोजेक्ट और किसी खास एपीआई या SDK टूल से जोड़ती है.
इस गाइड में, Google Maps Platform के लिए एपीआई पासकोड बनाने, उस पर पाबंदी लगाने, और उसे इस्तेमाल करने का तरीका बताया गया है.
शुरू करने से पहले
Maps Embed API का इस्तेमाल शुरू करने से पहले, आपको एक ऐसा प्रोजेक्ट बनाना होगा जिसमें बिलिंग खाता हो और Maps Embed एपीआई चालू हो. ज़्यादा जानने के लिए, Cloud Console में सेट अप करें देखें.
एपीआई कुंजियां बनाएं
एपीआई पासकोड एक यूनीक आइडेंटिफ़ायर होता है. इससे, आपके प्रोजेक्ट से जुड़े उन अनुरोधों की पुष्टि की जाती है जो इस्तेमाल और बिलिंग के मकसद से किए जाते हैं. आपके प्रोजेक्ट से कम से कम एक एपीआई पासकोड जुड़ा होना चाहिए.
एपीआई पासकोड बनाने के लिए:
Console
-
Google Maps Platform > क्रेडेंशियल पेज पर जाएं.
-
क्रेडेंशियल पेज पर जाकर, क्रेडेंशियल बनाएं > एपीआई पासकोड पर क्लिक करें.
एपीआई पासकोड बनाया गया डायलॉग, आपकी नई एपीआई पासकोड दिखाता है. -
बंद करें पर क्लिक करें.
नई एपीआई पासकोड को, एपीआई पासकोड में, क्रेडेंशियल पेज पर भी देखा जा सकता है.
(एपीआई) को प्रोडक्शन में इस्तेमाल करने से पहले, एपीआई पासकोड को सीमित करना न भूलें.
Cloud SDK
gcloud alpha services api-keys create \
--project "PROJECT" \
--display-name "DISPLAY_NAME"
Google Cloud SDK , Cloud SDK इंस्टॉलेशन , और इन निर्देशों के बारे में ज़्यादा जानें:
एपीआई कुंजियों पर पाबंदी लगाएं
Google का सुझाव है कि आप अपनी एपीआई कुंजियों के इस्तेमाल को सिर्फ़ उन एपीआई तक सीमित करें जो आपके ऐप्लिकेशन के लिए ज़रूरी हैं. API कुंजियों को प्रतिबंधित करने से आपके ऐप्लिकेशन को अनचाहे अनुरोधों से बचाकर उसे और भी सुरक्षित बनाया जाता है. ज़्यादा जानकारी के लिए, एपीआई की सुरक्षा से जुड़े सबसे सही तरीके देखें.
एपीआई पासकोड पर पाबंदी लगाने के लिए:
Console
-
Google Maps Platform > क्रेडेंशियल पेज पर जाएं.
- वह एपीआई पासकोड चुनें जिस पर पाबंदी सेट करनी है. एपीआई पासकोड प्रॉपर्टी का पेज दिखेगा.
- मुख्य पाबंदियां में जाकर, ये पाबंदियां सेट करें:
- ऐप्स प्रतिबंध:
- आपकी दी गई वेबसाइटों की सूची में से अनुरोध स्वीकार करने के लिए, ऐप्लिकेशन पर पाबंदियों की सूची से एचटीटीपी रेफ़रर (वेबसाइटें) चुनें.
- रेफ़रल देने वाली एक या उससे ज़्यादा वेबसाइट चुनें. सभी सबडोमेन को अनुमति देने के लिए, वाइल्डकार्ड वर्णों का इस्तेमाल किया जा सकता है (उदाहरण के लिए, एचटीटीपीएस पर ऐक्सेस करने पर,
https://*.google.comउन सभी साइटों को स्वीकार करता है जिनके आखिर में.google.comहै). ध्यान दें कि अगर www.domain.com की जानकारी दी जाती है, तो यह एक वाइल्डकार्ड www.domain.com/* की तरह काम करता है. साथ ही, उस होस्टनेम पर किसी भी सबपाथ को अनुमति देता है. सिर्फ़https://औरhttp://रेफ़रर स्कीम काम करती हैं. - एपीआई से जुड़ी पाबंदियां:
- कुंजी पर पाबंदी लगाएं पर क्लिक करें.
- एपीआई चुनें ड्रॉपडाउन से Maps Embed API चुनें. अगर Maps पर मौजूद एम्बेड किया गया एपीआई सूची में नहीं है, तो आपको उसे चालू करना होगा.
- अगर आपके प्रोजेक्ट में 'जगहें' लाइब्रेरी का इस्तेमाल किया जाता है, तो जगहें एपीआई भी चुनें. इसी तरह, अगर आपके प्रोजेक्ट में JavaScript API (निर्देश सेवा, डिस्टेंस मैट्रिक्स सेवा, एलिवेशन सेवा, और/या जियोकोडिंग सेवा) में दूसरी सेवाओं का इस्तेमाल किया जाता है, तो आपको इस सूची में उससे जुड़े एपीआई को भी चालू करना होगा और उसे चुनना होगा.
- अपने बदलावों को पूरा करने के लिए, सेव करें पर क्लिक करें.
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="maps-embed-backend.googleapis.com"
--allowed-referrers="referer"
Google Cloud SDK , Cloud SDK इंस्टॉलेशन , और इन निर्देशों के बारे में ज़्यादा जानें:
अपने अनुरोध में एपीआई पासकोड जोड़ें
आपको हर Maps Embed API अनुरोध के साथ एक एपीआई पासकोड शामिल करना होगा.
यहां दिए गए उदाहरण में, YOUR_API_KEY को अपनी एपीआई पासकोड से बदलें.
https://www.google.com/maps/embed/v1/MAP_MODE?key=YOUR_API_KEY¶meters