सैन फ़्रांसिस्को में दिसंबर में होने वाले, Google Maps Platform डेवलपर कम्यूनिटी डे में हमारे साथ शामिल हों! अभी आवेदन करें.

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

Maps Embed API क्विकस्टार्ट

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

लागत

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

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

अपने वेब पेज पर एम्बेड किया गया मैप बनाने के लिए, सेटअप करने के ये ज़रूरी चरण पूरे करें:

पहला चरण: अपना प्रोजेक्ट सेट अप करना

कंसोल

Google Cloud console में, प्रोजेक्ट चुनने वाले पेज पर, प्रोजेक्ट बनाएं पर क्लिक करें. इससे नया Cloud प्रोजेक्ट बनाने की प्रोसेस शुरू हो जाएगी.

प्रोजेक्ट चुनने वाले पेज पर जाएं
पक्का करें कि आपके क्लाउड प्रोजेक्ट के लिए बिलिंग की सुविधा चालू हो. पुष्टि करें कि आपके प्रोजेक्ट के लिए बिलिंग की सुविधा चालू है.

ध्यान दें: क्लाउड प्रोजेक्ट सेट अप करने के लिए, आपको बिलिंग खाता सेट अप करना होगा. हालांकि, Embed API का इस्तेमाल बिना किसी शुल्क के किया जा सकता है.

Google Cloud को बिना किसी शुल्क के आज़माया जा सकता है. बिना शुल्क के आज़माने की अवधि, 90 दिनों के बाद या खाते में 300 डॉलर का शुल्क जमा होने के बाद खत्म हो जाती है. इनमें से जो भी पहले हो. कभी भी रद्द करें. ज़्यादा जानकारी के लिए, बिलिंग खाते के क्रेडिट और बिलिंग देखें.

Cloud SDK

gcloud projects create "PROJECT"

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

gcloud projects create

दूसरा चरण: एपीआई या एसडीके चालू करना

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

कंसोल

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

Cloud SDK

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

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

तीसरा चरण: एपीआई पासकोड पाना

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

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

कंसोल

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

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

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

Cloud SDK

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

नई कुंजी बनाएं: यहां दिया गया निर्देश चलाएं और DISPLAY_NAME को कुंजी के नाम से बदलें.
```
gcloud services api-keys create \
    --project="PROJECT_ID" \
    --display-name="DISPLAY_NAME" \
    --api-target=service=maps-embed-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=maps-embed-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" चलाएं.

iframe जनरेट करना

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

iframe की जांच करना

एचटीएमएल ब्राउज़र विंडो में अपना iframe देखने के लिए:

अपना डिफ़ॉल्ट टेक्स्ट एडिटर खोलें. आपके डिवाइस पर, TextEdit या Microsoft Windows Notepad जैसे टेक्स्ट एडिटर डिफ़ॉल्ट रूप से इंस्टॉल होने चाहिए.
एक एचटीएमएल फ़ाइल बनाएं और उसे index.html नाम दें.
ऊपर जनरेट किए गए iframe के साथ यह कोड जोड़ें:
```
<html>
  
</html>
```
अपनी index.html एचटीएमएल फ़ाइल सेव करें.
एचटीएमएल फ़ाइल को वेब ब्राउज़र में लोड करने के लिए, उसे अपने डेस्कटॉप से ब्राउज़र पर खींचें और छोड़ें. इसके अलावा, ज़्यादातर ऑपरेटिंग सिस्टम पर फ़ाइल पर दो बार क्लिक करके भी ऐसा किया जा सकता है.

बधाई हो! आपने Maps Embed API का इस्तेमाल करके, मैप सेट अप और बिल्ड कर लिया है.

क्लीनअप करना

अपने Google Cloud प्रोजेक्ट को मिटाया जा सकता है, ताकि उस प्रोजेक्ट में इस्तेमाल किए गए सभी संसाधनों के लिए बिलिंग बंद की जा सके.

चेतावनी: किसी प्रोजेक्ट को मिटाने पर, ये असर होते हैं:

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

Google Cloud console में, संसाधन मैनेज करें पेज पर जाएं:
'संसाधन मैनेज करें' पेज पर जाएं
अगर आपको जो प्रोजेक्ट मिटाना है वह किसी संगठन से जुड़ा है, तो पेज पर सबसे ऊपर मौजूद संगठन की सूची को चुनें और उसे बड़ा करें.
प्रोजेक्ट की सूची में, वह प्रोजेक्ट चुनें जिसे मिटाना है. इसके बाद, मिटाएं पर क्लिक करें.
डायलॉग बॉक्स में, प्रोजेक्ट आईडी टाइप करें और प्रोजेक्ट को मिटाने के लिए, बंद करें पर क्लिक करें.

अगले चरण

Maps Embed API का इस्तेमाल करके, डेवलपमेंट शुरू करें. इसके लिए, अपना Google Cloud प्रोजेक्ट सेट अप करें:

Cloud Console में सेट अप करना
अपने iframe में जोड़े जा सकने वाले अन्य पैरामीटर और विकल्पों की सूची के लिए:

मैप एम्बेड करना
JavaScript API की मदद से, अपने Maps प्रोजेक्ट को बेहतर बनाएं:

Maps JavaScript API