मैप एम्बेड करना

इस गाइड में आपको अपने वेब पेज पर इंटरैक्टिव मैप जोड़ने का तरीका बताया गया है.

Maps Embed API का यूआरएल बनाना

नीचे उदाहरण के तौर पर एक यूआरएल दिया गया है, जो Maps Embed API को लोड करता है:

https://www.google.com/maps/embed/v1/MAP_MODE?key=YOUR_API_KEY&PARAMETERS

बदलें:

• MAP_MODE को आपके मैप मोड में इस्तेमाल किया जा सकता है.
• YOUR_API_KEY को अपने एपीआई पासकोड से ऐक्सेस करें. ज़्यादा जानकारी के लिए, एपीआई पासकोड पाना देखें.
• आपके मैप के लिए ज़रूरी और वैकल्पिक पैरामीटर वाला PARAMETERS मोड.

यूआरएल को iframe में जोड़ना

अपने वेब पेज पर Maps Embed API का इस्तेमाल करने के लिए, आपने जो यूआरएल दिया है उसे सेट करें को iframe की src एट्रिब्यूट की वैल्यू के तौर पर बनाया जाता है. इससे मैप का आकार कंट्रोल करें iframe की height और width एट्रिब्यूट का इस्तेमाल करती है. उदाहरण के लिए:

<iframe
  width="450"
  height="250"
  frameborder="0" style="border:0"
  referrerpolicy="no-referrer-when-downgrade"
  src="https://www.google.com/maps/embed/v1/MAP_MODE?key=YOUR_API_KEY&PARAMETERS"
  allowfullscreen>
</iframe>

ऊपर दिया गया iframe नमूना अतिरिक्त प्रॉपर्टी का उपयोग करता है:

• मैप के कुछ हिस्सों को फ़ुल स्क्रीन मोड में दिखाने के लिए, allowfullscreen प्रॉपर्टी.
• स्टैंडर्ड हटाने के लिए frameborder="0" और style="border:0" प्रॉपर्टी मैप के चारों ओर मौजूद iframe बॉर्डर.
• referrerpolicy="no-referrer-when-downgrade" प्रॉपर्टी, ब्राउज़र को अनुरोध के साथ Referer हेडर के तौर पर पूरा यूआरएल भेजना होगा, ताकि मुमकिन है कि एपीआई पासकोड की पाबंदियां सही तरीके से काम करें.

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

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

अगर होस्ट करने वाली वेबसाइट का referrer मेटा टैग, no-referrer पर सेट किया जा रहा है या same-origin, ब्राउज़र, Google को Referer हेडर नहीं भेजेगा. यह इनकी वजह से, एपीआई पासकोड पर पाबंदी लग सकती है पर जाएं. प्रतिबंध ठीक से काम करे, इसके लिए विज्ञापन में referrerpolicy प्रॉपर्टी को iframe में, जैसा कि ऊपर दिए गए उदाहरण में दिखाया गया है, Google को Referer हेडर भेजने की अनुमति दें.

मैप पर विज्ञापन

Maps Embed API में मैप पर विज्ञापन शामिल हो सकते हैं. विज्ञापन फ़ॉर्मैट और किसी भी मैप में दिखाए गए विज्ञापनों का सेट बिना किसी सूचना के बदल सकता है.

मैप के मोड चुने जा रहे हैं

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

• place: किसी खास जगह या पते पर मैप पिन दिखाता है, जैसे, कोई लैंडमार्क, कारोबार, भौगोलिक क्षेत्र या कस्बा.
• view: बिना मार्कर या निर्देश वाले मैप दिखाता है.
• directions: दो या ज़्यादा के बीच का पाथ दिखाता है बिंदु, दूरी, और यात्रा में लगने वाला समय दिखाता है.
• streetview: यहां से इंटरैक्टिव पैनोरामिक व्यू दिखाता है तय की गई जगहें.
• search: मैप पर किसी खोज के नतीजे दिखाता है क्षेत्र.

place मोड

निम्न URL place के मैप मोड का इस्तेमाल करके एफ़िल टावर:

https://www.google.com/maps/embed/v1/place
  ?key=YOUR_API_KEY
  &q=Eiffel+Tower,Paris+France

इन पैरामीटर का इस्तेमाल किया जा सकता है:

view मोड

इस उदाहरण में, view मोड और वैकल्पिक maptype पैरामीटर का इस्तेमाल किया गया है मैप का सैटलाइट व्यू दिखाएं:

https://www.google.com/maps/embed/v1/view
  ?key=YOUR_API_KEY
  &center=-33.8569,151.2152
  &zoom=18
  &maptype=satellite

इन पैरामीटर का इस्तेमाल किया जा सकता है:

directions मोड

इस उदाहरण में, ऑस्लो के बीच का पाथ दिखाने के लिए directions मोड का इस्तेमाल किया गया है और टेलीमार्क, नॉर्वे, और टोल और हाइवे से बचते हुए दूरी और यात्रा में लगने वाला समय शामिल करते हैं.

https://www.google.com/maps/embed/v1/directions
  ?key=YOUR_API_KEY
  &origin=Oslo+Norway
  &destination=Telemark+Norway
  &avoid=tolls|highways

इन पैरामीटर का इस्तेमाल किया जा सकता है:

streetview मोड

Maps Embed API से आप स्ट्रीट व्यू इमेज को इस रूप में दिखा सकते हैं इसकी पूरी तस्वीर में, तय की गई जगहों से इंटरैक्टिव पैनोरामा कवरेज एरिया हो सकता है. उपयोगकर्ता फ़ोटोस्फ़ीयर का योगदान दिया और Street View के खास कलेक्शन भी उपलब्ध हैं.

हर Street View पैनोरामा, एक बार में पूरा 360-डिग्री व्यू देता है स्थान. इमेज में 360 डिग्री हॉरिज़ॉन्टल व्यू होता है (पूरी इमेज को कवर किया जाता है) और 180 डिग्री वर्टिकल व्यू (सीधे ऊपर से सीधे नीचे तक). कॉन्टेंट बनाने streetview मोड से ऐसा व्यूअर उपलब्ध होता है जो नतीजे को रेंडर करता है एक गोल आकार का पैनोरामा है, जिसके बीच में कैमरा मौजूद है. कैमरे में बदलाव किया जा सकता है कैमरे के ज़ूम और ओरिएंटेशन को कंट्रोल करने के लिए.

इस streetview मोड का पैनोरामा देखें:

https://www.google.com/maps/embed/v1/streetview
  ?key=YOUR_API_KEY
  &location=46.414382,10.013988
  &heading=210
  &pitch=10
  &fov=35

इनमें से कोई एक यूआरएल पैरामीटर ज़रूरी है:

• location में अक्षांश और देशांतर को कॉमा लगाकर अलग किए गए के तौर पर स्वीकार किया जाता है मान (46.414382,10.013988). एपीआई पैनोरामा दिखाएगा सबसे नज़दीकी से लिया गया फ़ोटो. Street View की तस्वीरें समय-समय पर रीफ़्रेश होता है और फ़ोटोग्राफ़ थोड़े अलग तरीके से लिए जा सकते हैं नहीं रखना चाहते, तो यह संभव है कि आपका स्थान किसी अलग स्थिति में आ जाए जब इमेजरी अपडेट की जाती है, तब पैनोरामा.

• pano एक खास पैनोरामा आईडी है. अगर आप pano के लिए, location भी तय किया जा सकता है. कॉन्टेंट बनाने location का इस्तेमाल सिर्फ़ तब किया जाएगा, जब एपीआई को पैनोरामा नहीं मिल पा रहा हो आईडी.

ये यूआरएल पैरामीटर ज़रूरी नहीं हैं:

search मोड

Search मोड, मैप वाले किसी इलाके में की गई खोज के नतीजे दिखाता है. यह सुझाव दिया जाता है कि खोज के लिए एक स्थान निर्धारित करें, या तो 'खोज के लिए शब्द' में जगह की जानकारी शामिल करना (record+stores+in+Seattle) या खोज को सीमित करने के लिए, center और zoom पैरामीटर शामिल करके.

https://www.google.com/maps/embed/v1/search
  ?key=YOUR_API_KEY
  &q=record+stores+in+Seattle

इन पैरामीटर का इस्तेमाल किया जा सकता है:

जगह के आईडी पैरामीटर

Maps Embed API, एपीआई की मदद से स्थान नाम या पता. जगह के आईडी, एक-दूसरे से अलग एक जगह की पहचान करें. ज़्यादा जानकारी के लिए, Google Places API दस्तावेज़ देखें.

Maps Embed API, नीचे दिए गए यूआरएल के लिए जगह के आईडी स्वीकार करता है पैरामीटर:

• q
• origin
• destination
• waypoints

जगह के आईडी का इस्तेमाल करने के लिए, आपको पहले प्रीफ़िक्स place_id: जोड़ना होगा. कॉन्टेंट बनाने नीचे दिया गया कोड, निर्देश देने के लिए न्यूयॉर्क सिटी हॉल का ऑरिजिन बताता है अनुरोध: origin=place_id:ChIJs--MqP1YwokRBwAhjXWIHn8.

• radius मीटर में एक दायरा सेट करता है, जिसमें पैनोरामा, दिए गए अक्षांश और देशांतर पर केंद्रित होता है. मान्य वैल्यू गैर-ऋणात्मक पूर्णांक होते हैं. डिफ़ॉल्ट वैल्यू 50 है.

• source, Street View में की गई खोजों को चुनिंदा सोर्स तक सीमित करता है. मान्य मान हैं:

  • default, Street View के लिए डिफ़ॉल्ट सोर्स का इस्तेमाल करता है; खोजें हैं यह कुछ ख़ास सोर्स तक सीमित नहीं है.
  • outdoor, खोजों को आउटडोर कलेक्शन तक सीमित करता है. घर के अंदर खोज के नतीजों में संग्रह शामिल नहीं किए जाते. ध्यान दें कि आउटडोर पैनोरामा निर्दिष्ट स्थान के लिए मौजूद नहीं हो सकता. यह भी ध्यान रखें कि खोज के लिए सिर्फ़ जहां यह पता लगाया जा सके कि वे घर के अंदर हैं या नहीं, पैनोरामा दिखाता है आस-पास हो सकते हैं. उदाहरण के लिए, PhotoSpheres का इस्तेमाल नहीं किया जा सकता, क्योंकि इसकी जानकारी नहीं है चाहे वे घर के अंदर हों या बाहर.