Google Maps Platform पर जिन प्रॉडक्ट के लिए पुष्टि करने के ज़रूरी क्रेडेंशियल दिए गए हैं उन्हें एपीआई कॉल की सुविधा न देकर, उनका सुरक्षित तरीके से इस्तेमाल नहीं किया जा सकता. ये क्रेडेंशियल एपीआई कुंजी के रूप में होते हैं - यह अक्षरों और अंकों से बना एक यूनीक स्ट्रिंग होता है, जो आपके Google बिलिंग खाते को आपके प्रोजेक्ट और किसी खास एपीआई या SDK टूल के साथ जोड़ता है.
इस गाइड में Google Maps Platform के लिए, एपीआई पासकोड बनाने, इस्तेमाल करने पर पाबंदी लगाने, और उसे इस्तेमाल करने का तरीका बताया गया है.
शुरू करने से पहले
दूरी के मैट्रिक्स एपीआई का इस्तेमाल करने से पहले, आपको एक प्रोजेक्ट की ज़रूरत होगी जिसमें बिलिंग खाता हो और डिस्टेंस मैट्रिक्स एपीआई चालू हो. ज़्यादा जानने के लिए, 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 > क्रेडेंशियल पेज पर जाएं.
- वह एपीआई कुंजी चुनें जिस पर आप पाबंदी सेट करना चाहते हैं. इसके बाद, एपीआई कुंजी प्रॉपर्टी का पेज दिखेगा.
- मुख्य पाबंदियां में जाकर, ये पाबंदियां सेट करें:
- ऐप्लिकेशन से जुड़ी पाबंदियां:
- आप जो वेब सर्वर आईपी पते उपलब्ध कराते हैं उनकी सूची में से अनुरोध स्वीकार करने के लिए, ऐप्लिकेशन पाबंदियों की सूची में से आईपी पते (वेब सर्वर, क्रॉन जॉब वगैरह) चुनें. सीआईडीआर नोटेशन का इस्तेमाल करके, एक या एक से ज़्यादा IPv4 या IPv6 पता या सबनेट बताएं. आईपी पते, सोर्स के उस पते से मेल खाने चाहिए जिस पर Google Maps Platform के सर्वर काम करते हैं. अगर नेटवर्क ऐड्रेस ट्रांसलेशन (NAT) का इस्तेमाल किया जाता है, तो यह आम तौर पर आपकी मशीन के सार्वजनिक आईपी पते के हिसाब से होता है.
- एपीआई से जुड़ी पाबंदियां:
- कुंजी पर पाबंदी लगाएं पर क्लिक करें.
- एपीआई चुनें ड्रॉपडाउन से, दूरी का मैट्रिक्स एपीआई चुनें. अगर दूरी का मैट्रिक्स एपीआई सूची में नहीं है, तो आपको इसे चालू करना होगा.
- अपने बदलावों को पूरा करने के लिए, सेव करें पर क्लिक करें.
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="distance-matrix-backend.googleapis.com"
--allowed-ips="IP_ADDRESS"
Google Cloud SDK टूल, Cloud SDK टूल इंस्टॉल करने, और इन निर्देशों के बारे में ज़्यादा जानें:
आपके अनुरोध में एपीआई कुंजी जोड़ना
आपको हर डिस्टेंस मैट्रिक्स एपीआई अनुरोध के साथ एपीआई कुंजी शामिल करनी होगी. यहां दिए गए उदाहरण में,
YOUR_API_KEY को अपने एपीआई पासकोड से बदलें.
https://maps.googleapis.com/maps/api/distancematrix/json?origins=Seattle&destinations=San+Francisco&key=YOUR_API_KEY
एपीआई कुंजी का इस्तेमाल करने वाले अनुरोधों के लिए, एचटीटीपीएस ज़रूरी है.