मैप की नई स्टाइल, जल्द ही Google Maps Platform पर उपलब्ध होगी. मैप की स्टाइल में हुए इस अपडेट में, नया डिफ़ॉल्ट कलर पटल जोड़ा गया है. साथ ही, मैप के अनुभवों और उसे इस्तेमाल करने के तरीके में सुधार भी किए गए हैं. मार्च 2025 में, सभी मैप स्टाइल अपने-आप अपडेट हो जाएंगी. उपलब्धता और जल्दी ऑप्ट इन करने के तरीके के बारे में ज़्यादा जानकारी के लिए, Google Maps Platform के लिए नई मैप स्टाइल देखें.

इस पेज का अनुवाद Cloud Translation API से किया गया है.

मैप टाइल एपीआई के साथ एपीआई पासकोड का इस्तेमाल करना

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

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

शुरू करने से पहले: Map Tiles API का इस्तेमाल शुरू करने से पहले, आपके पास एक ऐसा प्रोजेक्ट होना चाहिए जिसमें बिलिंग खाता और Map Tiles API चालू हो. हमारा सुझाव है कि आप एक से ज़्यादा प्रोजेक्ट के मालिक और बिलिंग एडमिन बनाएं, ताकि आपकी टीम के पास इन भूमिकाओं के लिए हमेशा कोई व्यक्ति उपलब्ध रहे. ज़्यादा जानने के लिए, Cloud कंसोल में सेट अप करना लेख पढ़ें.

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

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

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

कंसोल

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) का इस्तेमाल किया जाता है, तो आम तौर पर यह आपकी मशीन के सार्वजनिक आईपी पते से जुड़ा होता है.

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

कुंजी पर पाबंदी लगाएं पर क्लिक करें.
एपीआई चुनें ड्रॉपडाउन से, Map Tiles API चुनें. अगर Map Tiles 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=tile.googleapis.com
    --allowed-ips="IP_ADDRESS"

Google Cloud SDK , Cloud SDK टूल इंस्टॉल करने , और इन निर्देशों के बारे में ज़्यादा पढ़ें:

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

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

https://tile.googleapis.com/v1/createSession?key=YOUR_API_KEY

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

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

आगे क्या करना है

2D टाइल पाना

एपीआई पासकोड मिलने के बाद, उसका इस्तेमाल सेशन टोकन बनाने के लिए किया जाता है. इसके बाद, आपको 2D मैप टाइल और Street View टाइल के अनुरोधों में, अपनी एपीआई कुंजी और सेशन टोकन, दोनों का इस्तेमाल करना होगा.

सेशन टोकन का इस्तेमाल करना

3D टाइल पाना

एपीआई कुंजी मिलने के बाद, इसका इस्तेमाल 3D टाइल पाने के लिए किया जा सकता है.

3D टाइल के बारे में खास जानकारी