Maps Static API सेट अप करना

इस दस्तावेज़ में, Maps Static API का इस्तेमाल शुरू करने का तरीका बताया गया है.

ज़रूरी शर्तें

इस प्रोसेस में, आपको Google Cloud खाता और बिलिंग की सुविधा वाला Google Cloud प्रोजेक्ट सेट अप करने का तरीका बताया गया है. आपको यह भी पता होना चाहिए कि Maps Static API का इस्तेमाल करने पर, आपसे शुल्क कैसे लिया जाता है.

1. Maps Static API के इस्तेमाल और बिलिंग पर जाकर, बिलिंग और इस्तेमाल की लागत की समीक्षा करें.

2. पुष्टि करें कि आपके पास Google Cloud खाता है.

   Google Cloud Console में साइन इन करना
   ध्यान दें: अगर आप नए उपयोगकर्ता हैं और आपके पास Google Cloud खाता नहीं है, तो इसका मतलब है कि कंसोल में साइन इन नहीं किया जा सकता. इसके लिए, Google Maps Platform का इस्तेमाल शुरू करना देखें.

3. पुष्टि करें कि आपके पास बिलिंग की सुविधा वाला Google Cloud प्रोजेक्ट है.

   बिलिंग पेज पर जाएं
   ध्यान दें: अगर आप नए उपयोगकर्ता हैं और आपके पास Google Cloud प्रोजेक्ट नहीं है, तो Google Maps Platform का इस्तेमाल शुरू करना लेख पढ़ें.
1. बिलिंग पेज खोलने के लिए, अपना प्रोजेक्ट चुनें.

2. बिलिंग पेज पर:

   • अगर चुने गए प्रोजेक्ट के लिए बिलिंग पहले से चालू है और आपके पास सिर्फ़ एक बिलिंग खाता है, तो बिलिंग पेज खुलता है.
   • अगर आपके पास एक से ज़्यादा बिलिंग खाते हैं, तो प्रोजेक्ट से जुड़े बिलिंग खाते की जानकारी देखने के लिए, लिंक किए गए बिलिंग खाते पर जाएं को चुनें.
   • अगर कोई बिलिंग खाता मौजूद है, लेकिन वह प्रोजेक्ट से नहीं जुड़ा है, तो आपको प्रोजेक्ट के साथ बिलिंग खाता लिंक करने के लिए कहा जाएगा.
   • अगर कोई बिलिंग खाता मौजूद नहीं है या आपको नया बिलिंग खाता बनाना है, तो नया बिलिंग खाता बनाने के लिए, बिलिंग खाते मैनेज करें को चुनें. ज़्यादा जानकारी के लिए, खुद से मैनेज किया जाने वाला नया Cloud Billing खाता बनाना लेख पढ़ें.

एपीआई को चालू करना

Maps Static API का इस्तेमाल करने से पहले, आपको Google Cloud console या gcloud कमांड का इस्तेमाल करके, इसे अपने Google Cloud प्रोजेक्ट में चालू करना होगा.

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

एपीआई को चालू करने के लिए:

कंसोल

1. Google Cloud Console में प्रॉडक्ट पेज खोलें:

   Maps Static API को चालू करना

2. चालू करें बटन पर क्लिक करें.

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

gcloud

gcloud services enable \
    --project "PROJECT" \
    "static-maps-backend.googleapis.com"

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

• gcloud services enable
• gcloud services disable

Maps Static API के साथ इस्तेमाल करने के लिए, एपीआई पासकोड पाना

Google Maps Platform के प्रॉडक्ट को बिना अनुमति के इस्तेमाल होने से बचाने के लिए, एपीआई कॉल में एपीआई पासकोड शामिल करना ज़रूरी है.

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

कंसोल

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

   कुंजियां और क्रेडेंशियल पेज पर जाएं

2. अगर कहा जाए, तो अपना प्रोजेक्ट चुनें.

3. इनमें से कोई एक काम करें:

   • नई कुंजी बनाना:

     1. क्रेडेंशियल बनाएं > एपीआई पासकोड पर क्लिक करें.
     2. एपीआई पासकोड बनाएं पैनल में, एपीआई से जुड़ी पाबंदियां चुनें सूची खोलें.
     3. इस कुंजी के लिए जिन एपीआई की ज़रूरत नहीं है उन्हें हटाएं. साथ ही, पक्का करें कि Maps Static API चुना हुआ रहे.
     4. बनाएं पर क्लिक करें. पैनल में आपका नया एपीआई पासकोड दिखता है.

   • किसी मौजूदा कुंजी का इस्तेमाल करना:

     1. कुंजी के नाम पर क्लिक करें.
     2. एपीआई से जुड़ी पाबंदियां चुनें सूची में, Maps Static API चुनें.
     3. सेव करें पर क्लिक करें.

   यहां किसी एपीआई को चुनने से वह चालू नहीं होता. पक्का करें कि Maps Static API, इसके एपीआई लाइब्रेरी पेज पर चालू हो.

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

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

gcloud

यहां दिए गए कमांड में, PROJECT_ID की जगह अपना प्रोजेक्ट आईडी डालें.

• नई कुंजी बनाएं: यहां दिया गया निर्देश चलाएं और DISPLAY_NAME को कुंजी के नाम से बदलें.

  gcloud services api-keys create \
      --project="PROJECT_ID" \
      --display-name="DISPLAY_NAME" \
      --api-target=service=static-maps-backend.googleapis.com

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

  • gcloud services api-keys create

• किसी मौजूदा कुंजी का इस्तेमाल करना: यह कमांड चलाएं और KEY_ID को कुंजी के आईडी से बदलें. --append फ़्लैग, उन एपीआई को बनाए रखता है जिनकी अनुमति कुंजी पहले से देती है. इसके बिना, कमांड उन्हें बदल देता है.

  gcloud services api-keys update KEY_ID \
      --project="PROJECT_ID" \
      --append \
      --api-target=service=static-maps-backend.googleapis.com

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

  • gcloud services api-keys update
  • gcloud services api-keys list

  कुंजी का आईडी, कुंजी की स्ट्रिंग या डिसप्ले नेम नहीं होता. इसे ढूंढने के लिए, gcloud services api-keys list --project="PROJECT_ID" चलाएं. आईडी, name फ़ील्ड का आखिरी हिस्सा होता है: projects/PROJECT_NUMBER/locations/global/keys/KEY_ID.

की स्ट्रिंग देखने के लिए, gcloud services api-keys get-key-string KEY_ID --project="PROJECT_ID" चलाएं.

एपीआई अनुरोध करना

स्टैटिक मैप पाने के लिए, ब्राउज़र में Maps Static API का अनुरोध करें. आपको हर अनुरोध के साथ अपने एपीआई पासकोड की अक्षरों और अंकों वाली स्ट्रिंग शामिल करनी होगी. साथ ही, उन अनुरोधों के लिए एचटीटीपीएस का इस्तेमाल करना होगा जिनमें एपीआई पासकोड शामिल है.

1. कुंजी की अल्फ़ान्यूमेरिक स्ट्रिंग डालने के लिए, नीचे दिए गए यूआरएल में API_KEY पर क्लिक करें:

   https://maps.googleapis.com/maps/api/staticmap?center=Brooklyn+Bridge,New+York,NY&zoom=13&size=600x300&maptype=roadmap&markers=color:blue%7Clabel:S%7C40.702147,-74.015794&markers=color:green%7Clabel:G%7C40.711614,-74.012318&markers=color:red%7Clabel:C%7C40.718217,-73.998284&key=YOUR_API_KEY

2. यूआरएल कॉपी करने के लिए, कोड सैंपल में मौजूद कॉपी करें आइकॉन, , पर क्लिक करें.
3. यूआरएल को ब्राउज़र विंडो में चिपकाएं और लिंक खोलें.

इमेज इस तरह दिखती है:

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

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

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

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

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

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

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