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