यह प्रॉडक्ट या सुविधा, लेगसी स्टेटस में है. लेगसी स्टेज और लेगसी से नई सेवाओं पर माइग्रेट करने के तरीके के बारे में ज़्यादा जानने के लिए, लेगसी प्रॉडक्ट और सुविधाएं लेख पढ़ें.

Distance Matrix API (लेगसी) के साथ एपीआई पासकोड का इस्तेमाल करना

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

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

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

Distance Matrix API (लेगसी) का इस्तेमाल शुरू करने से पहले, आपके पास बिलिंग खाते वाला एक प्रोजेक्ट होना चाहिए. साथ ही, Distance Matrix API (लेगसी) चालू होना चाहिए. ज़्यादा जानने के लिए, Cloud Console में सेट अप करना लेख पढ़ें.

एपीआई पासकोड बनाना

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

एपीआई पासकोड बनाने के लिए:

कंसोल

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

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

Cloud SDK

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

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

gcloud services api-keys create

एपीआई कुंजियों को प्रतिबंधित करना

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

किसी एपीआई पासकोड पर पाबंदी लगाने के लिए:

कंसोल

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

क्रेडेंशियल पेज पर जाएं
वह एपीआई पासकोड चुनें जिस पर आपको पाबंदी लगानी है. आपको एपीआई कुंजी प्रॉपर्टी पेज दिखेगा.
कुंजी से जुड़ी पाबंदियां में जाकर, ये पाबंदियां सेट करें:

ऐप्लिकेशन से जुड़ी पाबंदियां:

आपके दिए गए वेब सर्वर के आईपी पतों की सूची से अनुरोध स्वीकार करने के लिए, ऐप्लिकेशन से जुड़ी पाबंदियां की सूची में से, आईपी पते (वेब सर्वर, क्रॉन जॉब वगैरह) को चुनें. एक या उससे ज़्यादा IPv4 या IPv6 पते डालें. इसके अलावा, सीआईडीआर नोटेशन का इस्तेमाल करके सबनेट भी डाला जा सकता है. आईपी पते, उस सोर्स पते से मेल खाने चाहिए जिसे Google Maps Platform के सर्वर देखते हैं. अगर नेटवर्क एड्रेस ट्रांसलेशन (एनएटी) का इस्तेमाल किया जाता है, तो यह आम तौर पर आपकी मशीन के पब्लिक आईपी पते से मेल खाएगा.

एपीआई से जुड़ी पाबंदियां:

कुंजी को सीमित करें पर क्लिक करें.
एपीआई चुनें ड्रॉपडाउन से, Distance Matrix API (लेगसी) चुनें. अगर Distance Matrix API (लेगसी) सूची में शामिल नहीं है, तो आपको इसे चालू करना होगा.

बदलावों को सेव करने के लिए, सेव करें पर क्लिक करें.

Cloud SDK

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

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

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

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

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

gcloud services api-keys update projects/PROJECT/locations/global/keys/KEY_ID \
    --api-target=service=distance-matrix-backend.googleapis.com
    --allowed-ips="IP_ADDRESS"

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

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

आपको Distance Matrix API (लेगसी) के हर अनुरोध में एक एपीआई पासकोड शामिल करना होगा. यहां दिए गए उदाहरण में, YOUR_API_KEY की जगह अपना एपीआई पासकोड डालें.

https://maps.googleapis.com/maps/api/distancematrix/json?origins=Seattle&destinations=San+Francisco&key=YOUR_API_KEY

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

ध्यान दें: वेब सेवाओं का इस्तेमाल करते समय, पैरामीटर में मौजूद सभी खास वर्णों को कोड में बदलना ज़रूरी है. यूआरएल मान्य होने के लिए, उन्हें सही तरीके से कोड में बदला जाना चाहिए. साथ ही, सभी वेब सेवाओं के लिए यूआरएल में ज़्यादा से ज़्यादा 2048 वर्ण होने चाहिए. यूआरएल बनाते समय, इस सीमा का ध्यान रखें. अलग-अलग ब्राउज़र, प्रॉक्सी, और सर्वर के लिए भी यूआरएल में वर्णों की सीमा अलग-अलग हो सकती है.