Google Maps Platform की सुरक्षा से जुड़े दिशा-निर्देश

Google Maps Platform API और एसडीके का इस्तेमाल करने वाले ऐप्लिकेशन और प्रोजेक्ट को अपनी पुष्टि करने के लिए, एपीआई पासकोड का इस्तेमाल करना होगा. अगर एपीआई पासकोड का इस्तेमाल नहीं किया जा सकता, तो OAuth 2.0 का इस्तेमाल करना होगा.

इन सबसे सही तरीकों से, आपको Maps Platform के ऐक्सेस को सुरक्षित करने का तरीका पता चलेगा.

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

ऐप्लिकेशन और एपीआई पासकोड पर पाबंदियां लगाने के साथ-साथ, सुरक्षा से जुड़ी उन सभी प्रक्रियाओं का पालन करें जो Google Maps Platform के किसी खास प्रॉडक्ट पर लागू होती हैं. उदाहरण के लिए, ऐप्लिकेशन और एपीआई से जुड़ी सुझाई गई पाबंदियां में, यहां दिया गया Maps JavaScript API देखें.

अगर आपके एपीआई पासकोड पहले से ही इस्तेमाल किए जा रहे हैं, तो अगर इस्तेमाल किए जा रहे एपीआई पासकोड पर पाबंदी लगाई जा रही है में दिए गए सुझाव देखें.

Maps Static API और Street View Static API के साथ काम करने वाले डिजिटल सिग्नेचर के बारे में ज़्यादा जानने के लिए, डिजिटल सिग्नेचर गाइड देखें.

सबसे सही तरीके के बारे में सुझाव

सुरक्षा बढ़ाने और बिना अनुमति के इस्तेमाल के लिए बिलिंग से बचने के लिए, Google Maps Platform के सभी एपीआई, एसडीके या सेवाओं के लिए, एपीआई की सुरक्षा से जुड़े इन सबसे सही तरीकों का पालन करें:

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

हर ऐप्लिकेशन के लिए अलग-अलग एपीआई पासकोड का इस्तेमाल करना

इस्तेमाल नहीं की जा रही एपीआई कुंजियां मिटाना

एपीआई पासकोड के इस्तेमाल की जानकारी देखना

एपीआई पासकोड बदलते समय सावधानी बरतें

क्लाइंट-साइड और सर्वर-साइड टैगिंग के इस्तेमाल को अलग-अलग प्रोजेक्ट में बांटना

जिन सेवाओं का इस्तेमाल नहीं किया जा रहा है उन्हें बंद करना

क्लाइंट-साइड ऐप्लिकेशन के लिए अन्य सुझाव

क्लाइंट-साइड एसडीके का इस्तेमाल करना

क्लाइंट-साइड वेब सेवा के कॉल सुरक्षित करना

स्टैटिक वेब एपीआई का इस्तेमाल करने वाली वेबसाइटों या क्लाइंट-साइड ऐप्लिकेशन के लिए अन्य सुझाव

Static Web API के इस्तेमाल को सुरक्षित रखना

वेब सेवाओं का इस्तेमाल करने वाले सर्वर-साइड ऐप्लिकेशन के लिए अन्य सुझाव

वेब सेवा के एपीआई पासकोड को सुरक्षित रखना

सर्वर-साइड ऐप्लिकेशन के लिए OAuth का इस्तेमाल करना

अगर इस्तेमाल की जा रही किसी एपीआई कुंजी पर पाबंदी लगाई जा रही है या उसे रोटेट किया जा रहा है

  • एपीआई पासकोड बदलने से पहले, देखें कि एपीआई पासकोड का इस्तेमाल कहां-कहां किया जा रहा है अगर आपको किसी ऐसे पासकोड पर पाबंदियां लगानी हैं जिसका इस्तेमाल प्रोडक्शन ऐप्लिकेशन में पहले से किया जा रहा है, तो यह चरण खास तौर पर ज़रूरी है.

  • कुंजी बदलने के बाद, ज़रूरत के मुताबिक अपने सभी ऐप्लिकेशन को नई एपीआई कुंजियों से अपडेट करें.

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

    ज़्यादा निर्देशों के लिए, एक से ज़्यादा एपीआई कुंजियों पर माइग्रेट करना लेख पढ़ें.

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

  • अगर आपकी एपीआई कुंजी से छेड़छाड़ की गई है, तो आपको अपनी एपीआई कुंजी को सुरक्षित करने और उसके गलत इस्तेमाल को रोकने के लिए, तुरंत कार्रवाई करनी होगी. Android और iOS ऐप्लिकेशन में, जब तक ग्राहक अपने ऐप्लिकेशन अपडेट नहीं करते, तब तक कुंजियां नहीं बदली जाती हैं. वेबपेजों या सर्वर साइड ऐप्लिकेशन में कुंजियों को अपडेट करना या बदलना ज़्यादा आसान होता है. हालांकि, इसके लिए अब भी सावधानी से प्लानिंग करने और तेज़ी से काम करने की ज़रूरत पड़ सकती है.

    ज़्यादा जानकारी के लिए, एपीआई कुंजी के अनधिकृत इस्तेमाल को मैनेज करना लेख पढ़ें.

ज़्यादा जानकारी

ऐप्लिकेशन और एपीआई के लिए सुझाई गई पाबंदियां

अपने एपीआई पासकोड को सीमित करें

सबसे सही तरीका यह है कि एपीआई पासकोड को हमेशा एक तरह के ऐप्लिकेशन से जुड़ी पाबंदियों और एक या उससे ज़्यादा एपीआई से जुड़ी पाबंदियों के साथ सीमित करें. एपीआई, एसडीके या JavaScript सेवा के हिसाब से सुझाई गई पाबंदियों के लिए, यहां ऐप्लिकेशन और एपीआई के लिए सुझाई गई पाबंदियां देखें.

  • ऐप्लिकेशन से जुड़ी पाबंदियां किसी एपीआई कुंजी के इस्तेमाल को कुछ प्लैटफ़ॉर्म तक सीमित किया जा सकता है. जैसे, Android या iOS ऐप्लिकेशन, क्लाइंट-साइड ऐप्लिकेशन के लिए कुछ वेबसाइटें या सर्वर-साइड ऐप्लिकेशन के लिए कुछ आईपी पते या CIDR सबनेट, जो वेब सेवा REST API कॉल जारी करते हैं.

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

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

किसी एपीआई कुंजी के लिए, ऐप्लिकेशन से जुड़ी पाबंदी सेट करना

  1. Google Cloud Console का Google Maps Platform क्रेडेंशियल पेज खोलें.

  2. वह एपीआई पासकोड चुनें जिसके इस्तेमाल पर पाबंदी लगानी है.

  3. एपीआई पासकोड में बदलाव करें पेज पर, पासकोड से जुड़ी पाबंदियां में जाकर, ऐप्लिकेशन से जुड़ी पाबंदी सेट करें को चुनें.

    एपीआई पासकोड में बदलाव करने वाला पेज

  4. पाबंदी का कोई टाइप चुनें और पाबंदी की सूची में दी गई जानकारी के मुताबिक, मांगी गई जानकारी दें.

    पाबंदी का टाइप ब्यौरा
    वेबसाइटें एक या उससे ज़्यादा रेफ़रर वेबसाइटें डालें.
    • रेफ़रर यूआरआई स्कीम के तौर पर, हर जगह इस्तेमाल की जा सकने वाली स्कीम ये हैं: https और http. अन्य स्कीम के सही तरीके से काम करने की गारंटी नहीं है. ऐसा इसलिए, क्योंकि आधुनिक वेब ब्राउज़र, निजता की वजहों से आउटगोइंग अनुरोधों में `Referer` हेडर नहीं भेजेंगे.
    • हमेशा रेफ़रर स्ट्रिंग का पूरा हिस्सा दें.इसमें प्रोटोकॉल स्कीम, होस्टनेम, और पोर्ट (वैकल्पिक) शामिल होना चाहिए. जैसे, https://google.com.
    • सभी सबडोमेन को अनुमति देने के लिए, वाइल्डकार्ड कैरेक्टर का इस्तेमाल किया जा सकता है. उदाहरण के लिए, https://*.google.com उन सभी साइटों को स्वीकार करता है जिनके आखिर में .google.com है.
    • पूरे पाथ वाले रेफ़रर को अनुमति देते समय सावधानी बरतें. उदाहरण के लिए, https://google.com/some/path. ऐसा इसलिए, क्योंकि ज़्यादातर वेब ब्राउज़र, निजता की वजहों से क्रॉस-ऑरिजिन अनुरोधों से पाथ हटा देंगे.
    आईपी पते सीआईडीआर नोटेशन का इस्तेमाल करके, एक या उससे ज़्यादा आईपीवी4 या आईपीवी6 पते या सबनेट डालें. आईपी पते, उस सोर्स पते से मेल खाने चाहिए जिसे Google Maps Platform के सर्वर देखते हैं. अगर नेटवर्क एड्रेस ट्रांसलेशन (एनएटी) का इस्तेमाल किया जाता है, तो यह पता आम तौर पर आपकी मशीन के सार्वजनिक आईपी पते से मेल खाता है.
    Android ऐप्लिकेशन

    आपको जिस Android ऐप्लिकेशन को अनुमति देनी है उसके लिए, Android पैकेज का नाम (AndroidManifest.xml फ़ाइल से) और SHA-1 साइनिंग सर्टिफ़िकेट का फ़िंगरप्रिंट जोड़ें.

    1. Android ऐप्लिकेशन को चुनें.
    2. + जोड़ें पर क्लिक करें.
    3. अपने पैकेज का नाम और SHA-1 सर्टिफ़िकेट फ़िंगरप्रिंट डालें. उदाहरण के लिए: 
      com.example.android.mapexample
       
      BB:0D:AC:74:D3:21:E1:43:67:71:9B:62:91:AF:A1:66:6E:44:5D:75
    4. सेव करें पर क्लिक करें.

    सर्टिफ़िकेट दो तरह के होते हैं:

    • डीबग सर्टिफ़िकेट: इस तरह के सर्टिफ़िकेट का इस्तेमाल सिर्फ़ उन ऐप्लिकेशन के साथ करें जिनकी टेस्टिंग की जा रही है. साथ ही, इसका इस्तेमाल ऐसे कोड के साथ करें जो प्रोडक्शन में नहीं है. डीबग सर्टिफ़िकेट से साइन किए गए ऐप्लिकेशन को पब्लिश करने की कोशिश न करें. जब कोई डीबग के लिए बिल्ड चलाया जाता है, तब Android SDK टूल इस सर्टिफ़िकेट को अपने-आप जनरेट करते हैं.
    • रिलीज़ सर्टिफ़िकेट: इस सर्टिफ़िकेट का इस्तेमाल तब करें, जब आपको ऐप्लिकेशन को किसी ऐप स्टोर पर रिलीज़ करना हो. रिलीज़ के लिए तैयार बिल्ड चलाने पर, Android SDK टूल इस सर्टिफ़िकेट को जनरेट करते हैं.

    Android ऐप्लिकेशन साइनिंग और सर्टिफ़िकेट के बारे में ज़्यादा जानने के लिए, ऐप्लिकेशन साइन करने से जुड़ी गाइड देखें.

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

    आपको जिन iOS ऐप्लिकेशन को अनुमति देनी है उनके बंडल आइडेंटिफ़ायर जोड़ें.

    1. iOS ऐप्लिकेशन को चुनें.
    2. + जोड़ें पर क्लिक करें.
    3. उस आईडी वाले iOS ऐप्लिकेशन से अनुरोध स्वीकार करने के लिए, बंडल आईडी जोड़ें.
    4. सेव करें पर क्लिक करें.

    किसी ऐप्लिकेशन पर पाबंदी लगाने से जुड़े सुझावों के लिए, ऐप्लिकेशन पर पाबंदी लगाने से जुड़े सुझाव लेख पढ़ें.

  5. सेव करें को चुनें.

किसी एपीआई पासकोड के लिए एपीआई से जुड़ी पाबंदियां सेट करना

  1. Google Cloud Console का Google Maps Platform क्रेडेंशियल पेज खोलें.

  2. वह एपीआई पासकोड चुनें जिसके इस्तेमाल पर पाबंदी लगानी है.

  3. एपीआई पासकोड में बदलाव करें पेज पर, एपीआई से जुड़ी पाबंदियां में जाकर:

    • कुंजी पर पाबंदी लगाएं को चुनें.

    • एपीआई चुनें खोलें. इसके बाद, वे एपीआई या एसडीके चुनें जिन्हें आपका ऐप्लिकेशन, एपीआई पासकोड का इस्तेमाल करके ऐक्सेस करेगा.

    अगर कोई एपीआई या एसडीके टूल सूची में नहीं है, तो आपको उसे चालू करना होगा. ज़्यादा जानकारी के लिए, एक या एक से ज़्यादा एपीआई या एसडीके चालू करने के लिए लेख पढ़ें.

    'एपीआई पासकोड में बदलाव करें' पेज पर जाकर, किसी एपीआई को सीमित करना

  4. सेव करें को चुनें.

    इस चरण के बाद, पाबंदी को एपीआई पासकोड की परिभाषा में शामिल कर दिया जाता है. पक्का करें कि आपने सही जानकारी दी हो. साथ ही, एपीआई कुंजी पर लगाई गई पाबंदियां सेव करने के लिए, सेव करें को चुनें. ज़्यादा जानकारी के लिए, जिस एपीआई या एसडीके में आपकी दिलचस्पी है उसके दस्तावेज़ में, एपीआई पासकोड पाना गाइड देखें.

एपीआई के इस्तेमाल पर पाबंदियां लगाने के बारे में सुझाव पाने के लिए, एपीआई के इस्तेमाल पर पाबंदियां लगाने के बारे में सुझाव लेख पढ़ें.

एपीआई पासकोड के इस्तेमाल की जानकारी देखना

अगर आपको एपीआई पासकोड बनाने के बाद उन पर पाबंदी लगानी है या आपको यह देखना है कि किसी पासकोड से कौनसे एपीआई इस्तेमाल किए जा रहे हैं, ताकि उन पर पाबंदी लगाई जा सके, तो आपको एपीआई पासकोड के इस्तेमाल की जांच करनी होगी. इन चरणों से पता चलता है कि किन सेवाओं और एपीआई के तरीकों में एपीआई कुंजी का इस्तेमाल किया जा रहा है. अगर आपको Google Maps Platform की सेवाओं के अलावा किसी और सेवा का इस्तेमाल दिखता है, तो इसकी जांच करें. इससे यह पता चलेगा कि आपको अनचाहे इस्तेमाल को रोकने के लिए, ज़्यादा पाबंदियां लगानी हैं या नहीं. Google Maps Platform Cloud Console Metrics Explorer का इस्तेमाल करके, यह तय किया जा सकता है कि आपको अपनी एपीआई कुंजी पर कौनसी एपीआई और ऐप्लिकेशन से जुड़ी पाबंदियां लगानी हैं:

यह पता लगाना कि कौनसे एपीआई आपके एपीआई पासकोड का इस्तेमाल करते हैं

यहां दी गई मेट्रिक रिपोर्ट से, यह पता लगाया जा सकता है कि आपके एपीआई पासकोड का इस्तेमाल कौनसे एपीआई कर रहे हैं. इन रिपोर्ट का इस्तेमाल, इन कामों के लिए करें:

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

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

  1. Google Cloud Console के Metrics explorer पर जाएं

  2. साइन इन करें और वह प्रोजेक्ट चुनें जिसके एपीआई पासकोड की जांच करनी है.

  3. अपने एपीआई के टाइप के लिए, मेट्रिक एक्सप्लोरर पेज पर जाएं:

    • Maps Embed API को छोड़कर किसी भी एपीआई का इस्तेमाल करने वाले एपीआई पासकोड के लिए: Metrics explorer पेज पर जाएं.

    • Maps Embed API का इस्तेमाल करने वाले एपीआई पासकोड के लिए: मेट्रिक एक्सप्लोरर पर जाएं.

  4. हर एपीआई पासकोड की जांच करें:

    1. फ़िल्टर जोड़ें को चुनें.

    2. लेबल credential_id को चुनें.

    3. आपको जिस कुंजी की जांच करनी है उससे जुड़ी वैल्यू चुनें.

    4. ध्यान दें कि इस एपीआई पासकोड का इस्तेमाल किन एपीआई के लिए किया जा रहा है. साथ ही, पुष्टि करें कि इसका इस्तेमाल सही तरीके से किया जा रहा है.

    5. इसके बाद, अतिरिक्त फ़िल्टर को मिटाने के लिए, चालू फ़िल्टर लाइन के आखिर में मौजूद फ़िल्टर हटाएं को चुनें.

  5. बची हुई कुंजियों के लिए भी यही तरीका अपनाएं.

  6. अपने एपीआई पासकोड को सिर्फ़ उन एपीआई तक सीमित रखें जिनका इस्तेमाल किया जा रहा है.

  7. अगर आपको बिना अनुमति के इस्तेमाल का पता चलता है, तो एपीआई कुंजी के बिना अनुमति के इस्तेमाल को रोकना लेख पढ़ें.

मेट्रिक एक्सप्लोरर का इस्तेमाल करके, ऐप्लिकेशन पर पाबंदी लगाने का सही टाइप चुनना

पुष्टि करने के बाद, ज़रूरी कार्रवाइयां करें. इससे यह पक्का किया जा सकेगा कि आपकी एपीआई कुंजी का इस्तेमाल सिर्फ़ उन Google Maps Platform सेवाओं के लिए किया जा रहा है जिनके लिए इसका इस्तेमाल किया जा रहा है. यह भी पुष्टि करें कि एपीआई कुंजी पर, ऐप्लिकेशन से जुड़ी पाबंदियां सही तरीके से लागू की गई हैं.

अगर आपके एपीआई पासकोड के लिए, एपीआई पासकोड से जुड़ी पाबंदियां लगाने का सुझाव दिया गया है, तो उन्हें लागू करें. ज़्यादा जानकारी के लिए, एपीआई पासकोड पर सुझाई गई पाबंदियां लागू करना लेख पढ़ें.

अगर आपके एपीआई पासकोड के लिए पाबंदी से जुड़े सुझाव नहीं दिख रहे हैं, तो तय करें कि आपको किस तरह की पाबंदी लगानी है. इसके लिए, मेट्रिक एक्सप्लोरर का इस्तेमाल करके, रिपोर्ट किए गए platform_type के आधार पर यह तय करें:

  1. Google Cloud Console के Metrics explorer पर जाएं

  2. साइन इन करें और उन एपीआई के लिए प्रोजेक्ट चुनें जिनकी आपको जांच करनी है.

  3. इस मेट्रिक्स एक्सप्लोरर पेज पर जाएं: मेट्रिक्स एक्सप्लोरर.

  4. हर एपीआई पासकोड की जांच करें:

    1. फ़िल्टर जोड़ें को चुनें.

    2. लेबल credential_id को चुनें.

    3. आपको जिस कुंजी की जांच करनी है उससे जुड़ी वैल्यू चुनें.

    4. इसके बाद, अतिरिक्त फ़िल्टर को मिटाने के लिए, चालू फ़िल्टर लाइन के आखिर में मौजूद फ़िल्टर हटाएं को चुनें.

  5. बची हुई कुंजियों के लिए भी यही तरीका अपनाएं.

  6. एपीआई कुंजियों के लिए प्लैटफ़ॉर्म टाइप तय करने के बाद, उस platform_type के लिए ऐप्लिकेशन से जुड़ी पाबंदी लागू करें:

    PLATFORM_TYPE_JS : कुंजी पर वेबसाइट से जुड़ी पाबंदियां लागू करें.

    PLATFORM_TYPE_ANDROID : कुंजी पर Android ऐप्लिकेशन से जुड़ी पाबंदियां लागू करें.

    PLATFORM_TYPE_IOS : इस विकल्प का इस्तेमाल करके, कुंजी पर iOS ऐप्लिकेशन से जुड़ी पाबंदियां लागू करें.

    PLATFORM_TYPE_WEBSERVICE : आपको कुंजी पर आईपी पते से जुड़ी पाबंदियां लगानी पड़ सकती हैं, ताकि इसे सही तरीके से प्रतिबंधित किया जा सके.

    Maps Static API और Street View Static API के लिए सुझाव पाने के लिए, Static Web API के इस्तेमाल को सुरक्षित रखें लेख पढ़ें.

    Maps Embed API के सुझावों के लिए, Maps Embed API का इस्तेमाल करने वाली वेबसाइटें देखें.

    मेरे एपीआई पासकोड का इस्तेमाल कई प्लैटफ़ॉर्म टाइप के लिए किया जा रहा है: सिर्फ़ एक एपीआई पासकोड से, आपके ट्रैफ़िक को सुरक्षित नहीं रखा जा सकता. आपको एक से ज़्यादा एपीआई पासकोड पर माइग्रेट करना होगा. ज़्यादा जानकारी के लिए, एक से ज़्यादा एपीआई पासकोड पर माइग्रेट करना लेख पढ़ें.

हर ऐप्लिकेशन के लिए अलग-अलग एपीआई पासकोड का इस्तेमाल करना

इस तरीके से, हर कुंजी का दायरा सीमित हो जाता है. अगर कोई एपीआई पासकोड खतरे में है, तो उस पासकोड को मिटाया जा सकता है या बदला जा सकता है. इसके लिए, आपको अपने अन्य एपीआई पासकोड अपडेट करने की ज़रूरत नहीं होगी. हर प्रोजेक्ट के लिए, ज़्यादा से ज़्यादा 300 एपीआई पासकोड बनाए जा सकते हैं. ज़्यादा जानकारी के लिए, एपीआई कुंजियों की सीमाएं लेख पढ़ें.

सुरक्षा के लिहाज़ से, हर ऐप्लिकेशन के लिए एक एपीआई पासकोड का इस्तेमाल करना सबसे सही होता है. हालांकि, एक से ज़्यादा ऐप्लिकेशन पर पाबंदियों वाले पासकोड का इस्तेमाल किया जा सकता है. इसके लिए, यह ज़रूरी है कि वे एक ही तरह की ऐप्लिकेशन पाबंदी का इस्तेमाल करते हों.

एपीआई पासकोड से जुड़ी सुझाई गई पाबंदियां लागू करना

Google Cloud Console, प्रोजेक्ट के कुछ मालिकों, संपादकों, और एपीआई पासकोड एडमिन को, एपीआई पासकोड पर पाबंदियां लगाने का सुझाव देता है. ये सुझाव, Google Maps Platform के इस्तेमाल और गतिविधि के आधार पर दिए जाते हैं.

अगर सुझाव उपलब्ध हैं, तो वे Google Maps Platform क्रेडेंशियल पेज पर, पहले से भरे गए विकल्पों के तौर पर दिखते हैं.

ऑटोमेटेड सुझावों के साथ काम करने वाले Google Maps Platform API और एसडीके

  • Maps JavaScript API. इसमें ये शामिल हैं: रास्ता बताने वाली सेवा (लेगसी), दूरी का मैट्रिक्स बताने वाली सेवा (लेगसी), ऊंचाई बताने वाली सेवा, जियोकोडिंग सेवा जगह की क्लास, किसी जगह के शुरुआती अक्षर लिखने पर पूरा नाम सुझाने की सुविधा वाला विजेट (नया), किसी जगह के शुरुआती अक्षर लिखने पर पूरा नाम सुझाने की सुविधा वाला डेटा एपीआई, जगहों की लाइब्रेरी, जगहों की सेवा, किसी जगह के शुरुआती अक्षर लिखने पर पूरा नाम सुझाने की सुविधा वाला विजेट, और जगहों की जानकारी देने वाली यूआई किट

  • Maps Static API और Street View Static API

  • Maps एंबेड एपीआई

  • Android के लिए Maps SDK, Android के लिए Navigation SDK, Android के लिए Places SDK, और Android पर जगहों की जानकारी देने वाली यूआई किट

  • iOS के लिए Maps SDK, iOS के लिए Navigation SDK, iOS के लिए Places SDK, iOS के लिए Places Swift SDK, और iOS पर जगहों की जानकारी देने वाली यूआई किट.

आपको सुझाव न दिखने या अधूरा सुझाव दिखने की वजहें

सुझाव न दिखने की वजहें

  • आपने Google Maps Platform की सेवाओं के अलावा, किसी अन्य सेवा पर भी एपीआई पासकोड का इस्तेमाल किया हो. इसके अलावा, आपने Maps Platform की ऐसी सेवाओं पर एपीआई पासकोड का इस्तेमाल किया हो जिनके लिए, अपने-आप मिलने वाली सलाह की सुविधा अभी उपलब्ध नहीं है.

    अगर आपको अन्य सेवाओं पर इस्तेमाल दिखता है, तो यहां दी गई कार्रवाइयां पहले किए बिना, सुझाव को लागू न करें:

    1. पुष्टि करें कि Google Cloud Console के मेट्रिक एक्सप्लोरर में दिख रहा एपीआई इस्तेमाल सही है.

    2. अनुमति दी जाने वाली एपीआई की सूची में, मैन्युअल तरीके से उन सेवाओं को जोड़ें जो मौजूद नहीं हैं.

    3. एपीआई की सूची में जोड़ी गई सेवाओं के लिए, मैन्युअल तरीके से ऐप्लिकेशन से जुड़ी पाबंदियां जोड़ें. अगर आपको जोड़े गए दूसरे ऐप्लिकेशन के लिए, आवेदन पर पाबंदी लगाने के टाइप में बदलाव करना है, तो एक से ज़्यादा एपीआई पासकोड पर माइग्रेट करना लेख पढ़ें.

  • आपके एपीआई पासकोड का इस्तेमाल, क्लाइंट-साइड एसडीके या एपीआई में नहीं किया जाता.

  • आपने एपीआई कुंजी का इस्तेमाल ऐसे ऐप्लिकेशन या वेबसाइट में किया है जिसमें कम वॉल्यूम है. साथ ही, पिछले 60 दिनों में इसका इस्तेमाल नहीं किया गया है.

  • आपने हाल ही में कोई नई कुंजी बनाई है या आपने हाल ही में किसी नए ऐप्लिकेशन में मौजूदा कुंजी को डिप्लॉय किया है. अगर ऐसा है, तो सुझावों को अपडेट होने के लिए कुछ और दिन इंतज़ार करें.

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

अधूरा सुझाव दिखने की वजहें

  • आपने एपीआई कुंजी का इस्तेमाल ऐसे ऐप्लिकेशन या वेबसाइट में किया है जिसमें कम वॉल्यूम है. साथ ही, पिछले 60 दिनों में इसका इस्तेमाल नहीं किया गया है.

  • आपने हाल ही में किसी नए एपीआई या सेवा पर मौजूदा कुंजी का इस्तेमाल शुरू किया है. साथ ही, एपीआई कुंजी को अपने-आप सीमित करने की सुविधा से जुड़ी पाइपलाइन ने, इस्तेमाल से जुड़ी अपडेट की गई मेट्रिक को अब तक प्रोसेस नहीं किया है. इस्तेमाल से जुड़ी मेट्रिक को दिखने में कुछ दिन लग सकते हैं.

    अगर आपको अन्य सेवाओं पर इस्तेमाल दिखता है, तो यहां दी गई कार्रवाइयां पहले किए बिना, सुझाव को लागू न करें:

    1. पुष्टि करें कि Google Cloud Console के मेट्रिक एक्सप्लोरर में दिख रहा एपीआई इस्तेमाल सही है.

    2. अनुमति दी जाने वाली एपीआई की सूची में, मैन्युअल तरीके से उन सेवाओं को जोड़ें जो मौजूद नहीं हैं.

    3. एपीआई की सूची में जोड़ी गई सेवाओं के लिए, मैन्युअल तरीके से ऐप्लिकेशन से जुड़ी पाबंदियां जोड़ें. अगर आपको जोड़े गए दूसरे ऐप्लिकेशन के लिए, पाबंदियों के टाइप में बदलाव करना है, तो एक से ज़्यादा एपीआई पासकोड पर माइग्रेट करना लेख पढ़ें.

    4. अगर आपको किसी कुंजी को तुरंत प्रतिबंधित करने की ज़रूरत नहीं है, तो एक या दो दिन तक इंतज़ार करें. उदाहरण के लिए, अगर किसी कुंजी का इस्तेमाल बिना अनुमति के किया जा रहा है, तो उसे तुरंत प्रतिबंधित करें.

चार्ट में नहीं दिखने वाले सुझावों के दिखने की वजहें

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

  • आपका ट्रैफ़िक, Maps Embed API से आ रहा हो. निर्देशों के लिए, यह पता लगाना कि कौनसे एपीआई आपके एपीआई पासकोड का इस्तेमाल करते हैं लेख पढ़ें.

  • ऐप्लिकेशन या वेबसाइट से मिला ट्रैफ़िक, Google Cloud console के मेट्रिक एक्सप्लोरर में उपलब्ध तारीख की सीमा से बाहर है.

  1. Google Cloud Console का Google Maps Platform क्रेडेंशियल पेज खोलें.

  2. अगर उपलब्ध हो, तो सुझाई गई पाबंदियां लागू करें को चुनें.

    सुझाई गई पाबंदियां लागू करना

  3. एपीआई के इस्तेमाल की जांच करें को चुनकर यह पुष्टि करें कि एपीआई पासकोड का इस्तेमाल किन सेवाओं के लिए किया जा रहा है. अगर आपको Google Maps Platform की सेवाओं के अलावा कोई और सेवा दिखती है, तो ऊपर दिए गए सुझावों को मैन्युअल तरीके से देखने के लिए, रोकें. एपीआई पासकोड के इस्तेमाल पर सुझाई गई पाबंदियां लागू करना सेक्शन की शुरुआत में, समस्या हल करने का तरीका देखें.

  4. दोबारा जांच करें कि पहले से भरी गई पाबंदियां, उन वेबसाइटों और ऐप्लिकेशन से मेल खाती हों जहां आपको एपीआई पासकोड का इस्तेमाल करना है.

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

    • अगर आपको लगता है कि कोई ऐप्लिकेशन, वेबसाइट या एपीआई, आपके सुझाव में शामिल नहीं है, तो उसे मैन्युअल तरीके से जोड़ें. इसके अलावा, सुझाव को अपडेट होने के लिए कुछ दिन इंतज़ार करें.

    • अगर आपको सुझाई गई सलाह के बारे में ज़्यादा मदद चाहिए, तो सहायता टीम से संपर्क करें.

  5. लागू करें चुनें.

सुझाया गया प्रमोशन लागू करने के बाद, अगर आपका आवेदन अस्वीकार कर दिया जाता है, तो क्या करें

अगर आपको लगता है कि पाबंदी लगाने के बाद किसी ऐप्लिकेशन या वेबसाइट को अस्वीकार कर दिया गया है, तो एपीआई रिस्पॉन्स की गड़बड़ी के मैसेज में, ऐप्लिकेशन पर लगाई गई उस पाबंदी को ढूंढें जिसे आपको जोड़ना है.

क्लाइंट-साइड एसडीके और एपीआई

ब्राउज़र और वेबव्यू पर आधारित ऐप्लिकेशन

आम तौर पर, मॉडर्न ब्राउज़र निजता की वजहों से, क्रॉस-ऑरिजिन अनुरोध में Referer हेडर को हटा देते हैं. अक्सर, वे इसे Origin में बदल देते हैं. हालांकि, यह इस बात पर निर्भर करता है कि होस्टिंग साइट पर referrer-policy कौनसी सेटिंग लागू की गई है. साथ ही, यह उपयोगकर्ता के ब्राउज़र और वर्शन के हिसाब से भी अलग-अलग हो सकता है.

कॉन्टेंट लोड करने के लिए, अपारदर्शी या लोकल यूआरआई स्कीम का इस्तेमाल करने वाले वेब ऐप्लिकेशन, आम तौर पर रेंडरिंग ब्राउज़र या वेबव्यू से सभी आउटगोइंग कॉल से Referer हेडर को पूरी तरह से हटा देते हैं. इससे वेबसाइट पर पाबंदियों के साथ एपीआई कुंजियों का इस्तेमाल करने वाले अनुरोध पूरे नहीं हो पाते.

ज़्यादा जानकारी के लिए, ब्राउज़र पर काम करने वाले ऐप्लिकेशन को सर्वर पर होस्ट करना लेख पढ़ें.

ब्राउज़र और वेबव्यू पर आधारित ऐप्लिकेशन से जुड़ी समस्याओं को हल करने के लिए निर्देश:

  • Maps JavaScript API के लिए, ब्राउज़र डीबग कंसोल देखें. इसमें बताया गया है कि अपने ऐप्लिकेशन को अनुमति कैसे दें.

    एक्सॉटिक यूआरआई स्कीम, कुछ हद तक काम करती हैं. अगर आपके ऐप्लिकेशन के कुछ हिस्से, यूआरआई स्कीम पर काम नहीं करते हैं, तो आपको अपने ऐप्लिकेशन को किसी सर्वर पर रिमोटली होस्ट करना होगा. साथ ही, उसे एचटीटीपीएस (या एचटीटीपी) पर लोड करना होगा. ऐसा तब भी करना होगा, जब आपने ज़रूरी रेफ़रर को अनुमति दे दी हो.

    अगर आपको यूआरआई स्कीम से जुड़ी कोई मदद चाहिए, तो सहायता टीम से संपर्क करें.

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

    एक्सॉटिक यूआरआई स्कीम का इस्तेमाल नहीं किया जा सकता.

Android ऐप्लिकेशन

Android Debug Bridge (adb) या Logcat का इस्तेमाल करना

iOS ऐप्लिकेशन

लॉग मैसेज देखना लेख पढ़ें

वेब सेवाओं को सीधे कॉल करने वाले ऐप्लिकेशन

अगर कोई ऐप्लिकेशन, क्लाइंट-साइड Google Maps Platform SDK के बिना सीधे तौर पर Maps Platform HTTPS REST API या gRPC एंडपॉइंट को कॉल करता है, तो यहां दी गई जानकारी देखें:

Android और iOS ऐप्लिकेशन

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

अगर आपका ऐप्लिकेशन, Maps Platform API से जुड़ी गड़बड़ियों के जवाब लॉग करता है, तो क्लाइंट-साइड एसडीके के लिए ऊपर दिए गए निर्देश, पुष्टि करने से जुड़ी समस्याओं को हल करने में भी मददगार साबित हो सकते हैं.

सर्वर-साइड ऐप्लिकेशन

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

ब्राउज़र या वेबव्यू पर आधारित ऐप्लिकेशन

Maps Static API और Street View Static API के साथ-साथ, Google Maps Platform के नए एपीआई भी रेफ़रर से जुड़ी पाबंदियों के साथ काम करेंगे. हालांकि, ध्यान दें कि वेब ब्राउज़र या वेबव्यू, क्रॉस-ऑरिजिन अनुरोधों के लिए Referer हेडर को Origin तक सीमित कर देंगे. साथ ही, वे इसे पूरी तरह से भेजने से रोक सकते हैं. उदाहरण के लिए, स्थानीय तौर पर ऐक्सेस किए गए संसाधनों के लिए या एचटीटीपी या एचटीटीपीएस के अलावा अन्य प्रोटोकॉल पर उपलब्ध कराए गए संसाधनों के लिए.

अगर आपको अपने ऐप्लिकेशन में Maps JavaScript API का इस्तेमाल करने में समस्या आ रही है और वेबसाइट से जुड़ी पाबंदियां लागू नहीं हो रही हैं, तो क्लाइंट-साइड वेब सेवा के कॉल सुरक्षित करना लेख पढ़ें. इसमें, ब्राउज़र पर आधारित क्लाइंट-साइड ऐप्लिकेशन से, Maps Platform की वेब सेवा के कॉल सुरक्षित तरीके से करने का तरीका बताया गया है.

एपीआई से जुड़ी पाबंदियां देखने के लिए सलाह

एपीआई पासकोड पर लगाई जाने वाली ज़रूरी पाबंदियां देखने के लिए, यह पता लगाना कि आपके एपीआई पासकोड का इस्तेमाल कौनसे एपीआई करते हैं लेख पढ़ें.

अगर आपको यह तय करने में समस्या आ रही है कि कौनसी पाबंदियां लागू करनी हैं, तो:

  1. मौजूदा पाबंदियों को दस्तावेज़ में सेव करें, ताकि आने वाले समय में उनका इस्तेमाल किया जा सके.
  2. समस्या की जांच करते समय, उन्हें कुछ समय के लिए हटा दें. अपने एपीआई पासकोड के इस्तेमाल की जानकारी देखें में दिए गए चरणों का इस्तेमाल करके, समय के साथ अपने इस्तेमाल की जानकारी देखी जा सकती है.
  3. अगर ज़रूरत हो, तो सहायता टीम से संपर्क करें.

इस्तेमाल नहीं किए गए एपीआई पासकोड मिटाएं

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

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

  1. Google Cloud Console का Google Maps Platform क्रेडेंशियल पेज खोलें.

  2. वह एपीआई पासकोड चुनें जिसे मिटाना है.

  3. पेज पर सबसे ऊपर मौजूद, मिटाएं बटन को चुनें.

  4. क्रेडेंशियल मिटाएं पेज पर, मिटाएं को चुनें.

    एपीआई पासकोड को मिटाने में कुछ मिनट लगते हैं. प्रॉपगेशन पूरा होने के बाद, मिटाई गई एपीआई कुंजी का इस्तेमाल करने वाले किसी भी ट्रैफ़िक को अस्वीकार कर दिया जाता है.

एपीआई पासकोड बदलते समय सावधानी बरतें

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

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

  • सबसे पहले, अपने एपीआई पासकोड को सीमित करें में दिए गए तरीके से, अपने एपीआई पासकोड को सीमित करें.

  • अगर ऐप्लिकेशन के लिए पाबंदी के अलग-अलग टाइप की वजह से, एपीआई पासकोड पर पाबंदी नहीं लगाई जा सकती, तो एक से ज़्यादा एपीआई पासकोड पर माइग्रेट करना में बताए गए तरीके से, एक से ज़्यादा नए (पाबंदी वाले) पासकोड पर माइग्रेट करें. माइग्रेट करने से, आपको नई एपीआई कुंजियों पर माइग्रेट करने और उन्हें रोल आउट करने की समयसीमा को कंट्रोल करने की सुविधा मिलती है.

अगर ऊपर दिए गए सुझावों को लागू नहीं किया जा सकता और आपको एपीआई पासकोड को रोटेट करना है, ताकि उसका गलत इस्तेमाल न हो, तो यह तरीका अपनाएं:

  1. Google Cloud Console का Google Maps Platform क्रेडेंशियल पेज खोलें.

  2. वह एपीआई पासकोड खोलें जिसे रोटेट करना है.

  3. पेज में सबसे ऊपर, कुंजी घुमाएं को चुनें.

  4. एपीआई पासकोड का नाम बदलें. हालाँकि, ऐसा करना ज़रूरी नहीं है.

  5. बनाएं को चुनें.

  6. नई कुंजी का इस्तेमाल करने के लिए, अपने ऐप्लिकेशन अपडेट करें.

अपने ऐप्लिकेशन को नई कुंजी का इस्तेमाल करने के लिए अपडेट करने के बाद, पुरानी कुंजी को मिटाएं. इसके लिए, नई एपीआई कुंजी वाले पेज के 'पिछली कुंजी' सेक्शन में जाकर, पिछली कुंजी मिटाएं बटन पर क्लिक करें.

एक से ज़्यादा एपीआई पासकोड पर माइग्रेट करना

एक से ज़्यादा ऐप्लिकेशन के लिए एक ही एपीआई पासकोड इस्तेमाल करने के बजाय, हर ऐप्लिकेशन के लिए एक यूनीक एपीआई पासकोड इस्तेमाल करने के लिए, यह तरीका अपनाएं:

  1. पहचान करें कि किन ऐप्लिकेशन के लिए नई कुंजियों की ज़रूरत है:

    • वेब ऐप्लिकेशन को अपडेट करना सबसे आसान होता है, क्योंकि आपके पास पूरे कोड का कंट्रोल होता है. वेब पर काम करने वाले सभी ऐप्लिकेशन की कुंजियां अपडेट करने का प्लान बनाएं.
    • मोबाइल ऐप्लिकेशन के लिए, यह प्रोसेस ज़्यादा मुश्किल होती है. ऐसा इसलिए, क्योंकि नई कुंजियों का इस्तेमाल करने से पहले, आपके ग्राहकों को अपने ऐप्लिकेशन अपडेट करने होंगे.

  2. नई कुंजियां बनाएं और उन पर पाबंदियां लगाएं: ऐप्लिकेशन से जुड़ी पाबंदी और कम से कम एक एपीआई पाबंदी जोड़ें. ज़्यादा जानकारी के लिए, सुझाए गए सबसे सही तरीके लेख पढ़ें.

  3. अपने ऐप्लिकेशन में नई कुंजियां जोड़ें: मोबाइल ऐप्लिकेशन के लिए, इस प्रोसेस में महीनों लग सकते हैं. ऐसा तब तक होगा, जब तक आपके सभी उपयोगकर्ता नई एपीआई कुंजी के साथ ऐप्लिकेशन के नए वर्शन पर अपडेट नहीं कर लेते.

क्लाइंट-साइड और सर्वर-साइड टैगिंग के इस्तेमाल को अलग-अलग प्रोजेक्ट में बांटना

अगर आपको Google Maps Platform की सेवाओं को सर्वर-साइड ऐप्लिकेशन और सीधे तौर पर क्लाइंट-साइड ऐप्लिकेशन, दोनों से कॉल करना है, तो Google का सुझाव है कि आप अपने इस्तेमाल को दो अलग-अलग प्रोजेक्ट में बांट लें. क्लाइंट-साइड ऐप्लिकेशन, एंड-यूज़र डिवाइसों पर चलते हैं.

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

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

इस्तेमाल नहीं की जा रही सेवाओं को बंद करना

किसी प्रोजेक्ट पर ऐसी सेवाओं को चालू न छोड़ें जिनका इस्तेमाल नहीं किया जा रहा है. ऐसा इसलिए, क्योंकि इस तरीके का गलत इस्तेमाल किया जा सकता है. खास तौर पर तब, जब आपने अपने सभी सार्वजनिक एपीआई पासकोड को सीमित नहीं किया है. सबसे सही तरीका यह है कि किसी प्रोजेक्ट पर किसी सेवा को सिर्फ़ तब चालू करें, जब आपके ऐप्लिकेशन को उसकी ज़रूरत हो.

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

क्लाइंट-साइड एसडीके का इस्तेमाल करना

Google Maps Platform के क्लाइंट-साइड एसडीके का इस्तेमाल करते समय, आपके पास अपनी सेवा के इस्तेमाल को सुरक्षित बनाने के लिए, एपीआई पासकोड पर पाबंदियां लगाने का विकल्प हमेशा रहेगा.

क्लाइंट-साइड SDK टूल का इस्तेमाल करने से, आपको ज़्यादा बेहतर सुरक्षा वाले तरीके अपनाने में भी मदद मिलेगी. जैसे, Maps Platform API के उन सर्फ़ेस पर Firebase App Check का इस्तेमाल करना जो इसे सपोर्ट करते हैं. ज़्यादा जानकारी के लिए, अपने एपीआई पासकोड को सुरक्षित रखने के लिए App Check का इस्तेमाल करना लेख पढ़ें.

अगर आपके प्लैटफ़ॉर्म के लिए क्लाइंट-साइड एसडीके उपलब्ध नहीं हैं, तो क्लाइंट-साइड वेब सेवा कॉल को सुरक्षित करें लेख पढ़ें.

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

Static Web API के इस्तेमाल को सुरक्षित रखें

Maps Static API और Street View Static API जैसे स्टैटिक वेब एपीआई, वेब सेवा के एपीआई कॉल की तरह होते हैं.

इन दोनों को एचटीटीपीएस REST API का इस्तेमाल करके कॉल किया जाता है. साथ ही, आम तौर पर एपीआई अनुरोध का यूआरएल सर्वर पर जनरेट किया जाता है. हालांकि, JSON रिस्पॉन्स देने के बजाय, स्टैटिक वेब एपीआई एक इमेज जनरेट करते हैं. इसे जनरेट किए गए एचटीएमएल कोड में एम्बेड किया जा सकता है. ज़्यादा अहम बात यह है कि Google Maps Platform सेवा को आम तौर पर सर्वर नहीं, बल्कि असली उपयोगकर्ता का क्लाइंट कॉल करता है.

डिजिटल हस्ताक्षर का इस्तेमाल करना

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

डिजिटल हस्ताक्षर के बारे में ज़्यादा जानने के लिए, डिजिटल हस्ताक्षर गाइड देखें.

साइनिंग सीक्रेट को सुरक्षित रखना

स्टैटिक वेब एपीआई को सुरक्षित रखने के लिए, अपने एपीआई साइनिंग सीक्रेट को सीधे तौर पर कोड या सोर्स ट्री में एम्बेड न करें. इसके अलावा, उन्हें क्लाइंट-साइड ऐप्लिकेशन में भी न दिखाएं. हस्ताक्षर करने के सीक्रेट की सुरक्षा के लिए, इन सबसे सही तरीकों को अपनाएं:

  • किसी वेब पेज को दिखाते समय या अपने मोबाइल ऐप्लिकेशन से मिले अनुरोध के जवाब में, सर्वर साइड पर Maps Static API और Street View Static API के लिए, हस्ताक्षर किए गए एपीआई अनुरोध वाले यूआरएल जनरेट करें.

    स्टैटिक वेब कॉन्टेंट के लिए, Cloud Console के Google Maps Platform क्रेडेंशियल पेज पर मौजूद, यूआरएल पर अभी हस्ताक्षर करें विजेट का इस्तेमाल किया जा सकता है.

    डाइनैमिक वेब कॉन्टेंट के लिए, यूआरएल के अनुरोध पर हस्ताक्षर करने वाले उपलब्ध कोड सैंपल देखें.

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

वेब सेवा के एपीआई पासकोड को सुरक्षित रखना

क्लाइंट-साइड ऐप्लिकेशन से Google Maps Platform API और सेवाओं का सुरक्षित तरीके से इस्तेमाल करने के लिए, क्लाइंट-साइड एसडीके का इस्तेमाल करना और क्लाइंट-साइड वेब सेवा के कॉल को सुरक्षित करना लेख पढ़ें.

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

Google का सुझाव है कि Maps Platform के लिए इस्तेमाल किए जाने वाले हर पासकोड पर एपीआई से जुड़ी पाबंदियां लागू करें. इससे आपकी वेब सेवा के एपीआई पासकोड को गलती से इस्तेमाल होने से बचाया जा सकेगा. इसके अलावा, अपनी वेब सेवा की कुंजी पर आईपी पते से जुड़ी पाबंदियां लागू करने से, इसे अन्य सोर्स आईपी पतों से बिना अनुमति के इस्तेमाल किए जाने से बचाया जा सकेगा. भले ही, कुंजी गलती से लीक हो गई हो.

सर्वर-साइड ऐप्लिकेशन के लिए OAuth का इस्तेमाल करना

OAuth 2.0, ऐक्सेस डेलिगेशन के लिए एक ओपन स्टैंडर्ड है.

OAuth 2.0 प्रोटोकॉल, ऐसे इस्तेमाल के उदाहरणों के साथ काम करता है जहां कोई व्यक्ति, किसी ऐप्लिकेशन को अपनी ओर से निजी डेटा ऐक्सेस करने की अनुमति देता है. हालांकि, Maps Platform के साथ OAuth 2.0 का इस्तेमाल करने का मकसद यह है कि डेवलपर, कुछ समय के लिए ऐक्सेस टोकन का इस्तेमाल करे. इससे वह अपने ऐप्लिकेशन को, अपने Google Cloud प्रोजेक्ट के सेवा खाते की ओर से किसी एपीआई को कॉल करने की अनुमति दे पाएगा. इसके लिए, सेवा खाते की अनुमतियों का इस्तेमाल किया जाएगा.

किसी सेवा खाते के पास बहुत ज़्यादा अनुमतियां हो सकती हैं. इसलिए, डेवलपर के भरोसेमंद सर्वर-साइड ऐप्लिकेशन और Google के Maps Platform सर्वर के बीच सर्वर-टू-सर्वर कॉल को अनुमति देने के लिए, OAuth 2.0 का इस्तेमाल करने का सुझाव दिया जाता है.

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

अगर आपको सर्वर-टू-सर्वर ट्रैफ़िक को अनुमति देने के लिए OAuth 2.0 का इस्तेमाल करना है, तो अपने एपीआई के दस्तावेज़ में OAuth विषय ढूंढें.

उदाहरण के लिए, यहां Address Validation API के लिए OAuth विषय दिया गया है.

क्लाइंट-साइड पर वेब सेवा के कॉल को सुरक्षित करना

अगर क्लाइंट-साइड एसडीके उपलब्ध नहीं हैं, तो यहां दिए गए सुझाव देखें.

प्रॉक्सी सर्वर का इस्तेमाल करना

सुरक्षित प्रॉक्सी सर्वर का इस्तेमाल करने से, क्लाइंट-साइड ऐप्लिकेशन से Google Maps Platform की वेब सेवा के एंडपॉइंट के साथ इंटरैक्ट करने के लिए एक भरोसेमंद सोर्स मिलता है. इससे, आपकी एपीआई कुंजी, हस्ताक्षर करने का सीक्रेट या Google Cloud सेवा खाते को अनधिकृत उपयोगकर्ताओं के लिए उपलब्ध नहीं कराया जाता.

मुख्य बातें:

  • प्रॉक्सी सर्वर पर, Google Maps Platform के अनुरोधों को कॉन्फ़िगर करें. क्लाइंट को प्रॉक्सी का इस्तेमाल करके, मनमाने एपीआई कॉल रिले करने की अनुमति न दें.

  • Google Maps Platform से मिले रिस्पॉन्स को अपने प्रॉक्सी सर्वर पर प्रोसेस करें. क्लाइंट के काम का डेटा फ़िल्टर करें.

प्रॉक्सी सर्वर का इस्तेमाल करने के बारे में ज़्यादा जानने के लिए, Living Vicariously: Using Proxy Servers with the Google Data API Client Libraries लेख पढ़ें.

मोबाइल वेब सेवा से सीधे किए जाने वाले कॉल को सुरक्षित करना

अगर आपको क्लाइंट-साइड ऐप्लिकेशन के लिए सुरक्षित प्रॉक्सी सर्वर सेट अप करने में समस्या आ रही है, तो यहां दिया गया तरीका अपनाकर अपने ऐप्लिकेशन को सुरक्षित करें:

  1. एचटीटीपी हेडर का इस्तेमाल करें:

    • Android: X-Android-Package और X-Android-Cert एचटीटीपी हेडर का इस्तेमाल करें.

    • iOS: X-Ios-Bundle-Identifier एचटीटीपी हेडर का इस्तेमाल करें.

  2. अपनी Android या iOS कुंजी में, ऐप्लिकेशन से जुड़ी पाबंदियां जोड़ें.

  3. अपने मोबाइल ऐप्लिकेशन से सीधे तौर पर Google Maps Platform REST API वेब सेवा को कॉल करने से पहले, पुष्टि करें कि गलत Android या iOS ऐप्लिकेशन आइडेंटिफ़ायर वाले अनुरोध अस्वीकार कर दिए गए हों.

    अगर Android और iOS ऐप्लिकेशन पर पाबंदियां लगाने की सुविधा, टेस्ट किए गए एंडपॉइंट पर मौजूद नहीं है, तो Google ज़ोरदार सुझाव देता है कि आप अपने मोबाइल क्लाइंट और Google Maps Platform की वेब सेवा के एंडपॉइंट के बीच, सुरक्षित प्रॉक्सी सर्वर का इस्तेमाल करें.

Android ऐप्लिकेशन के लिए सुझाव:

  • अपने Android ऐप्लिकेशन को Google Maps Platform सेवाओं के साथ इंटिग्रेट करने से पहले, पुष्टि करें कि आपका ऐप्लिकेशन आईडी (इसे पैकेज का नाम भी कहा जाता है) सही फ़ॉर्मैट में हो. ज़्यादा जानकारी के लिए, Android के दस्तावेज़ में ऐप्लिकेशन मॉड्यूल कॉन्फ़िगर करना लेख पढ़ें.

  • अपने ऐप्लिकेशन से सीधे X-Android-Package पास करने के लिए, Context.getPackageName() का इस्तेमाल करके प्रोग्राम के हिसाब से इसे खोजें.

  • अपने ऐप्लिकेशन से सीधे X-Android-Cert पास करने के लिए, अपने ऐप्लिकेशन के साइनिंग सर्टिफ़िकेट के लिए ज़रूरी SHA-1 फ़िंगरप्रिंट का हिसाब लगाएं. इसे PackageInfo.signingInfo से ऐक्सेस किया जा सकता है.

  • अगर Google Cloud Console का इस्तेमाल करके, अपने Android ऐप्लिकेशन को अनुमति दी जाती है, तो ध्यान दें कि यूज़र इंटरफ़ेस (यूआई) को SHA-1 फ़िंगरप्रिंट की ज़रूरत होती है.यह कोलन से अलग की गई स्ट्रिंग होनी चाहिए. उदाहरण के लिए, 00:11:22:33:44:55:66:77:88:99:AA:BB:CC:DD:EE:FF:00:11:22:33. हालांकि, gcloud टूल और एपीआई पासकोड एपीआई को, सीमांकक के बिना हेक्साडेसिमल स्ट्रिंग की ज़रूरत होती है.

iOS ऐप्लिकेशन के लिए सुझाव:

  • अपने iOS ऐप्लिकेशन को Google Maps Platform सेवाओं के साथ इंटिग्रेट करने से पहले, पुष्टि करें कि आपका बंडल आईडी सही फ़ॉर्मैट में हो.

  • अपने iOS ऐप्लिकेशन को अनुमति देते समय, आपको आम तौर पर X-Ios-Bundle-Identifier हेडर में अपने मुख्य बंडल का बंडल आईडी हमेशा पास करना चाहिए.

ज़्यादा जानकारी के लिए, एपीआई पासकोड मैनेज करना और एपीआई ऐक्सेस करने के लिए एपीआई पासकोड इस्तेमाल करना लेख पढ़ें.

ब्राउज़र पर काम करने वाले ऐप्लिकेशन को किसी सर्वर पर होस्ट करना

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

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

इसके अलावा, मोबाइल ऐप्लिकेशन के लिए, वेब पर आधारित एसडीके का इस्तेमाल करने के बजाय, Google Maps Platform के Android और iOS के लिए उपलब्ध नेटिव एसडीके का इस्तेमाल करें.

अपने एपीआई पासकोड को सुरक्षित रखने के लिए, App Check का इस्तेमाल करना

Maps SDK टूल और API की मदद से, Firebase App Check को इंटिग्रेट किया जा सकता है. App Check, Google Maps Platform को आपके ऐप्लिकेशन से किए जाने वाले कॉल को सुरक्षित रखता है. इसके लिए, यह ऐसे ट्रैफ़िक को ब्लॉक करता है जो भरोसेमंद ऐप्लिकेशन के अलावा अन्य सोर्स से आता है. इसके लिए, यह पुष्टि करने वाली सेवा देने वाली कंपनी से मिले टोकन की जांच करती है. अपने ऐप्लिकेशन को App Check के साथ इंटिग्रेट करने से, नुकसान पहुंचाने वाले अनुरोधों से सुरक्षा मिलती है. इससे आपको बिना अनुमति वाले एपीआई कॉल के लिए शुल्क नहीं देना पड़ता.

App Check को इंटिग्रेट करने के निर्देश:

एपीआई पासकोड के अनधिकृत इस्तेमाल को मैनेज करना

अगर आपको पता चलता है कि आपकी एपीआई कुंजी का इस्तेमाल बिना अनुमति के किया जा रहा है, तो समस्या को हल करने के लिए यह तरीका अपनाएं:

  1. अपनी कुंजियों पर पाबंदी लगाएं: अगर आपने एक ही कुंजी का इस्तेमाल कई ऐप्लिकेशन में किया है, तो कई एपीआई कुंजियों पर माइग्रेट करें. साथ ही, हर ऐप्लिकेशन के लिए अलग-अलग एपीआई कुंजियों का इस्तेमाल करें. ज़्यादा जानकारी के लिए, यह लेख पढ़ें:

  2. Places SDK या Maps Javascript API का इस्तेमाल करने पर, App Check का इस्तेमाल करके अपने एपीआई पासकोड को सुरक्षित किया जा सकता है.

  3. कुंजियों को सिर्फ़ तब बदलें या घुमाएं, जब ये शर्तें पूरी हों:

    • आपको ऐसी कुंजियों के अनधिकृत इस्तेमाल का पता चलता है जिन पर पाबंदी नहीं लगाई जा सकती या जिन पर पहले से ही पाबंदी लगी हुई है. साथ ही, App Check लागू नहीं होता.

    • आपको एपीआई पासकोड को सुरक्षित करने और उसके गलत इस्तेमाल को रोकने के लिए, तुरंत कार्रवाई करनी है. भले ही, इससे आपके ऐप्लिकेशन से मिलने वाले असली ट्रैफ़िक पर असर पड़े.

    आगे बढ़ने से पहले, एपीआई पासकोड बदलते समय सावधानी बरतें लेख पढ़ें.

  4. अगर आपको अब भी समस्याएं आ रही हैं या मदद चाहिए, तो सहायता टीम से संपर्क करें.

ऐप्लिकेशन और एपीआई के इस्तेमाल से जुड़ी पाबंदियां

यहां दिए गए सेक्शन में, Google Maps Platform के हर एपीआई, एसडीके या सेवा के लिए, ऐप्लिकेशन और एपीआई से जुड़ी पाबंदियों के बारे में बताया गया है.

एपीआई से जुड़ी पाबंदियों के बारे में सुझाव

एपीआई के इस्तेमाल पर पाबंदियों से जुड़े ये दिशा-निर्देश, Google Maps Platform की सभी सेवाओं पर लागू होते हैं:

  • अपने एपीआई पासकोड को सिर्फ़ उन एपीआई तक सीमित करें जिनके लिए इसका इस्तेमाल किया जा रहा है. हालांकि, यहां दिए गए अपवादों के लिए ऐसा करना ज़रूरी नहीं है:

    • अगर आपका ऐप्लिकेशन, Android के लिए Places SDK या iOS के लिए Places SDK का इस्तेमाल करता है, तो अपने ऐप्लिकेशन को Places API (नया) या Places API के साथ काम करने की अनुमति दें. यह अनुमति, इस्तेमाल किए जा रहे एसडीके के वर्शन के हिसाब से दी जाती है. 1

    • अगर आपके ऐप्लिकेशन में Maps JavaScript API का इस्तेमाल किया जाता है, तो उसे अपने पासकोड पर हमेशा अनुमति दें.

    • अगर इनमें से किसी Maps JavaScript API सेवा का इस्तेमाल किया जाता है, तो आपको इनसे जुड़े एपीआई को भी अनुमति देनी होगी:

      सेवा एपीआई पर पाबंदी
      रास्ता दिखाने वाली सेवा (लेगसी) Directions API (लेगसी)
      Distance Matrix Service (लेगसी) Distance Matrix API (लेगसी)
      एलिवेशन सर्विस ऊंचाई से जुड़ा एपीआई
      जियोकोडिंग सेवा जियोकोडिंग एपीआई
      Place क्लास, किसी जगह के शुरुआती अक्षर लिखने पर पूरा नाम सुझाने की सुविधा वाला विजेट (नया) और किसी जगह के शुरुआती अक्षर लिखने पर पूरा नाम सुझाने की सुविधा वाला Data API Places API (नया प्रॉडक्ट)2
      Places Library, Places Service & Place Autocomplete Widget Places API2

1 ज़्यादा जानकारी के लिए, Places SDK for Android और Places SDK for iOS के दस्तावेज़ देखें.

2 अगर आपको यह पक्का नहीं है कि आपको Places API (नया) या Places API को अनुमति देनी है या नहीं, तो Maps JavaScript API का दस्तावेज़ देखें.

कुछ उदाहरण:

  • Maps SDK for Android और Places SDK for Android का इस्तेमाल किया जा रहा है. इसलिए, एपीआई के इस्तेमाल पर पाबंदियों के तौर पर, Android के लिए Maps SDK और Places API (नया) को शामिल करें.

  • आपकी वेबसाइट, Maps JavaScript API की एलिवेशन सेवा और Maps Static API का इस्तेमाल करती है. इसलिए, आपको यहां दिए गए सभी एपीआई के लिए, एपीआई के इस्तेमाल पर पाबंदियां लगानी होंगी:

    • Maps JavaScript एपीआई
    • ऊंचाई से जुड़ा एपीआई
    • Maps स्टैटिक एपीआई

सुझाए गए ऐप्लिकेशन पर पाबंदी लगाना

वेबसाइटें

Maps JavaScript API की सेवाओं, Maps Static API या Street View Static API का इस्तेमाल करने वाली वेबसाइटों के लिए, वेबसाइटें ऐप्लिकेशन पर पाबंदी लगाने की सुविधा का इस्तेमाल करें. इसके अलावा, सीधे तौर पर एचटीटीपीएस REST API या gRPC पर Google Maps Platform की हाल ही की सेवाओं को कॉल करने वाली वेबसाइटों के लिए भी इस सुविधा का इस्तेमाल करें:

1 मोबाइल ऐप्लिकेशन के लिए, नेटिव Android के लिए Maps SDK और iOS के लिए Maps SDK का इस्तेमाल करें.

2 मोबाइल ऐप्लिकेशन के लिए, नेटिव Places SDK for Android और Places SDK for iOS का इस्तेमाल करें.

3 यह भी देखें Static Web API के इस्तेमाल को सुरक्षित रखना.

Maps Embed API का इस्तेमाल करने वाली वेबसाइटें

Maps Embed API का इस्तेमाल करने के लिए कोई शुल्क नहीं लिया जाता. हालांकि, आपको इस्तेमाल किए गए किसी भी एपीआई पासकोड को सीमित करना चाहिए, ताकि अन्य सेवाओं का गलत इस्तेमाल न हो.

सबसे सही तरीका: Maps Embed API के इस्तेमाल के लिए, एक अलग एपीआई पासकोड बनाएं. साथ ही, इस पासकोड को सिर्फ़ Maps Embed API के लिए इस्तेमाल करने की अनुमति दें. इस पाबंदी से पासकोड सुरक्षित रहता है. साथ ही, इसे Google की किसी अन्य सेवा पर बिना अनुमति के इस्तेमाल करने से रोका जा सकता है. Google का सुझाव है कि Maps Embed API की कुंजी को इस्तेमाल करने की अनुमति देने के लिए, वेबसाइटों पर भी पाबंदियां लगाएं. इससे आपको यह कंट्रोल करने में मदद मिलेगी कि आपकी Maps Embed API की कुंजी का इस्तेमाल कहां किया जा सकता है.

अगर आपको Maps Embed API के इस्तेमाल को अलग एपीआई पासकोड से अलग नहीं करना है, तो वेबसाइटों पर ऐप्लिकेशन के इस्तेमाल से जुड़ी पाबंदी लगाकर, अपने मौजूदा पासकोड को सुरक्षित करें.

वेब सेवाओं का इस्तेमाल करने वाले ऐप्लिकेशन और सर्वर

भरोसेमंद कॉर्पोरेट इंटरनल नेटवर्क के सर्वर और क्लाइंट-साइड ऐप्लिकेशन के लिए, एपीआई पासकोड के साथ-साथ वेब सेवाओं का इस्तेमाल करें. इसके लिए, IP addresses ऐप्लिकेशन पर पाबंदी लगाने की सुविधा का इस्तेमाल करें.

इन एपीआई का इस्तेमाल करने वाले ऐप्लिकेशन और सर्वर के लिए:

4 मोबाइल ऐप्लिकेशन के लिए, Navigation SDK का इस्तेमाल करें.

5 मोबाइल का सुरक्षित तरीके से इस्तेमाल करने के लिए, सुरक्षित प्रॉक्सी सर्वर का इस्तेमाल करें.

6 क्लाइंट-साइड ऐप्लिकेशन के लिए, प्लैटफ़ॉर्म की ओर से दी जाने वाली नेटिव जियोलोकेशन सेवा का इस्तेमाल करें. उदाहरण के लिए, वेब ब्राउज़र के लिए W3C Geolocation, Android के लिए LocationManager या Fused Location Provider API या iOS के लिए Apple Core Location फ़्रेमवर्क.

7 मोबाइल ऐप्लिकेशन के लिए, नेटिव Places SDK for Android और Places SDK for iOS का इस्तेमाल करें.

8 क्लाइंट-साइड पर सुरक्षित तरीके से इस्तेमाल करने के लिए, सुरक्षित प्रॉक्सी सर्वर का इस्तेमाल करें.

Android ऐप्लिकेशन

Android पर मौजूद ऐप्लिकेशन के लिए, Android apps ऐप्लिकेशन पर पाबंदी लगाने की सुविधा का इस्तेमाल करें. इन एसडीके का इस्तेमाल करने वाले ऐप्लिकेशन के लिए:

इसके अलावा, Android मेनिफ़ेस्ट में एपीआई पासकोड सेव करने के बजाय, उन्हें किसी लोकल फ़ाइल से इंजेक्ट करने के लिए Secrets Gradle Plugin का इस्तेमाल करें. इससे, वर्शन कंट्रोल में एपीआई पासकोड की जांच करने से गलती से होने वाली गड़बड़ियों को रोका जा सकेगा.

iOS ऐप्लिकेशन

iOS पर मौजूद ऐप्लिकेशन के लिए, iOS apps ऐप्लिकेशन के इस्तेमाल पर पाबंदी लगाने की सुविधा का इस्तेमाल करें. इन एसडीके का इस्तेमाल करने वाले ऐप्लिकेशन और सर्वर के लिए:

इस बारे में और पढ़ें