यह प्रॉडक्ट लेगसी स्टेटस में है. अक्टूबर 2026 से, Distance Matrix API (लेगसी) को नए Google Cloud प्रोजेक्ट के लिए चालू नहीं किया जा सकेगा. मौजूदा प्रोजेक्ट के लिए, सहायता जारी रहेगी. नई सुविधाओं और बेहतर परफ़ॉर्मेंस के लिए, Routes API पर माइग्रेट करें.

Google आपकी पसंदीदा भाषा में कॉन्टेंट का अनुवाद करने के लिए, एआई टेक्नोलॉजी का इस्तेमाल करता है. एआई से मिले अनुवादों में गलतियां हो सकती हैं.

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

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

इस गाइड में, 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 के सर्वर को दिखता है. नेटवर्क अड्रेस ट्रांसलेशन (NAT) का इस्तेमाल करने पर, यह आम तौर पर आपकी मशीन के सार्वजनिक आईपी पते से मेल खाएगा.

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

कुंजी पर पाबंदी लगाएं पर क्लिक करें.
एपीआई चुनें ड्रॉपडाउन से, 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

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

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