इस गाइड में, अपने वेब पेज पर इंटरैक्टिव मैप एम्बेड करने का तरीका बताया गया है.
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 एट्रिब्यूट की वैल्यू के तौर पर सेट करें. आईफ़्रेम के height और width एट्रिब्यूट का इस्तेमाल करके, मैप के साइज़ को कंट्रोल करें. उदाहरण के लिए:
<iframe
width="450"
height="250"
frameborder="0" style="border:0"
referrerpolicy="strict-origin-when-cross-origin"
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="strict-origin-when-cross-origin"प्रॉपर्टी यह पक्का करती है कि ब्राउज़र, आपकी वेबसाइट के डोमेन को Google परRefererहेडर के तौर पर भेजे. इससे एपीआई पासकोड से जुड़ी पाबंदियों को अनुरोध की पुष्टि करने की अनुमति मिलती है. साथ ही, आपके पेज के पाथ को निजी रखा जाता है.
आपके पास iframe का साइज़ बदलकर, उसे अपनी वेबसाइट के स्ट्रक्चर और डिज़ाइन के हिसाब से सेट करने का विकल्प होता है. हालांकि, हमारा मानना है कि आम तौर पर लोग बड़े मैप के साथ आसानी से इंटरैक्ट कर पाते हैं. ध्यान दें कि एम्बेड किए गए मैप, किसी भी डाइमेंशन में 200 पिक्सल से कम साइज़ के साथ काम नहीं करते.
रेफ़रर यूआरएल की जानकारी और एपीआई पासकोड से जुड़ी पाबंदियां
अगर होस्टिंग वेबसाइट पर referrer मेटा टैग को no-referrer या same-origin पर सेट किया गया है, तो ब्राउज़र, Google को Referer हेडर नहीं भेजेगा. इस वजह से, एपीआई पासकोड से जुड़ी पाबंदी की वजह से अनुरोध अस्वीकार किए जा सकते हैं. पाबंदी को ठीक से लागू करने के लिए, iframe में referrerpolicy प्रॉपर्टी जोड़ें. जैसा कि ऊपर दिए गए उदाहरण में दिखाया गया है. इससे Referer हेडर को Google को भेजने की अनुमति साफ़ तौर पर दी जा सकेगी.
strict-origin-when-cross-origin(सुझाया गया): यह विकल्प चुनने पर, Google को सिर्फ़ आपका बेस डोमेन (जैसे, https://example.com/) भेजा जाता है. इससे आपके पेज के पाथ की जानकारी निजी रहती है. साथ ही, एपीआई पासकोड पर लगाई गई पाबंदियां भी काम करती हैं.no-referrer-when-downgrade(लेगसी): यह पूरे यूआरएल को भेजता है.इसमें पेज के पाथ और क्वेरी पैरामीटर भी शामिल होते हैं. उदाहरण के लिए, https://example.com/contact?user=123.
Referrer-Policy हेडर के बारे में ज़्यादा जानें.
मैप मोड चुनना
अनुरोध यूआरएल में इस्तेमाल करने के लिए, इनमें से कोई एक मैप मोड चुना जा सकता है:
place: यह किसी जगह या पते पर मैप पिन दिखाता है. जैसे, कोई लैंडमार्क, कारोबार, भौगोलिक विशेषता या शहर.view: यह बिना मार्कर या दिशा-निर्देशों वाला मैप दिखाता है.directions: इससे मैप पर मौजूद दो या उससे ज़्यादा जगहों के बीच का रास्ता दिखता है. साथ ही, दूरी और यात्रा में लगने वाला समय भी दिखता है.streetview: इसमें चुनिंदा जगहों के इंटरैक्टिव पैनोरमिक व्यू दिखते हैं.search: इससे, मैप पर दिख रहे इलाके में की गई खोज के नतीजे दिखते हैं.
place मोड
नीचे दिए गए यूआरएल में, place मैप मोड का इस्तेमाल करके, आइफ़िल टॉवर पर मैप मार्कर दिखाया गया है:
https://www.google.com/maps/embed/v1/place
?key=YOUR_API_KEY
&q=Eiffel+Tower,Paris+Franceइन पैरामीटर का इस्तेमाल किया जा सकता है:
| पैरामीटर | टाइप | ब्यौरा | मंज़ूर की गई वैल्यू |
|---|---|---|---|
q |
ज़रूरी है | इससे मैप मार्कर की जगह तय होती है. | यूआरएल-एस्केप किया गया जगह का नाम, पता, प्लस कोड या जगह का आईडी.
Maps Embed API, स्पेस को एस्केप करने के लिए + और %20, दोनों का इस्तेमाल करता है. उदाहरण के लिए, "सिटी हॉल, न्यूयॉर्क, एनवाई" को City+Hall,New+York,NY में बदलें या प्लस कोड "849VCWC8+R9" को 849VCWC8%2BR9 में बदलें. |
center |
वैकल्पिक | इससे मैप व्यू का सेंटर तय होता है. | यह कॉमा लगाकर अलग किए गए अक्षांश और देशांतर की वैल्यू स्वीकार करता है. उदाहरण के लिए:
37.4218,-122.0840. |
zoom |
वैकल्पिक | इससे मैप का शुरुआती ज़ूम करने का लेवल सेट किया जाता है. | वैल्यू 0 (पूरा देश) से लेकर 21 (अलग-अलग इमारतें) तक होती हैं. चुनी गई जगह के लिए उपलब्ध मैप डेटा के आधार पर, ऊपरी सीमा अलग-अलग हो सकती है. |
maptype |
वैकल्पिक | इससे लोड की जाने वाली मैप टाइल का टाइप तय होता है. | roadmap (डिफ़ॉल्ट) या satellite |
language |
वैकल्पिक | यह कुकी, यूज़र इंटरफ़ेस (यूआई) एलिमेंट और मैप टाइल पर लेबल दिखाने के लिए इस्तेमाल की जाने वाली भाषा तय करती है. डिफ़ॉल्ट रूप से, वेबसाइट पर आने वाले लोगों को उनकी भाषा में मैप दिखेगा. यह पैरामीटर सिर्फ़ कुछ देशों की टाइलों के लिए काम करता है. अगर अनुरोध की गई भाषा, टाइल सेट के लिए काम नहीं करती है, तो उस टाइलसेट के लिए डिफ़ॉल्ट भाषा का इस्तेमाल किया जाएगा. | |
region |
वैकल्पिक | यह जियो-पॉलिटिकल संवेदनशीलता के आधार पर, दिखाने के लिए सही बॉर्डर और लेबल तय करता है. | यह दो वर्णों (गैर-संख्यात्मक) वाले यूनिकोड क्षेत्र के सबटैग के तौर पर तय किए गए क्षेत्र के कोड को स्वीकार करता है. यह कोड, जाने-पहचाने ccTLD ("टॉप-लेवल डोमेन") के दो वर्णों वाली वैल्यू से मैप होता है. जिन देशों/इलाकों में यह सुविधा काम करती है उनके बारे में जानने के लिए, Google Maps Platform की कवरेज की जानकारी देखें. |
view मोड
इस उदाहरण में, मैप का सैटलाइट व्यू दिखाने के लिए view मोड और वैकल्पिक maptype पैरामीटर का इस्तेमाल किया गया है:
https://www.google.com/maps/embed/v1/view
?key=YOUR_API_KEY
¢er=-33.8569,151.2152
&zoom=18
&maptype=satelliteइन पैरामीटर का इस्तेमाल किया जा सकता है:
| पैरामीटर | टाइप | ब्यौरा | मंज़ूर की गई वैल्यू |
|---|---|---|---|
center |
ज़रूरी है | इससे मैप व्यू का सेंटर तय होता है. | यह कॉमा लगाकर अलग किए गए अक्षांश और देशांतर की वैल्यू स्वीकार करता है. उदाहरण के लिए:
37.4218,-122.0840. |
zoom |
वैकल्पिक | इससे मैप का शुरुआती ज़ूम करने का लेवल सेट किया जाता है. | वैल्यू 0 (पूरा देश) से लेकर 21 (अलग-अलग इमारतें) तक होती हैं. चुनी गई जगह के लिए उपलब्ध मैप डेटा के आधार पर, ऊपरी सीमा अलग-अलग हो सकती है. |
maptype |
वैकल्पिक | इससे लोड की जाने वाली मैप टाइल का टाइप तय होता है. | roadmap (डिफ़ॉल्ट) या satellite |
language |
वैकल्पिक | यह कुकी, यूज़र इंटरफ़ेस (यूआई) एलिमेंट और मैप टाइल पर लेबल दिखाने के लिए इस्तेमाल की जाने वाली भाषा तय करती है. डिफ़ॉल्ट रूप से, वेबसाइट पर आने वाले लोगों को उनकी भाषा में मैप दिखेगा. यह पैरामीटर सिर्फ़ कुछ देशों की टाइलों के लिए काम करता है. अगर अनुरोध की गई भाषा, टाइल सेट के लिए काम नहीं करती है, तो उस टाइलसेट के लिए डिफ़ॉल्ट भाषा का इस्तेमाल किया जाएगा. | |
region |
वैकल्पिक | यह जियो-पॉलिटिकल संवेदनशीलता के आधार पर, दिखाने के लिए सही बॉर्डर और लेबल तय करता है. | यह दो वर्णों (गैर-संख्यात्मक) वाले यूनिकोड क्षेत्र के सबटैग के तौर पर तय किए गए क्षेत्र के कोड को स्वीकार करता है. यह कोड, जाने-पहचाने ccTLD ("टॉप-लेवल डोमेन") के दो वर्णों वाली वैल्यू से मैप होता है. जिन देशों/इलाकों में यह सुविधा काम करती है उनके बारे में जानने के लिए, Google Maps Platform की कवरेज की जानकारी देखें. |
directions मोड
नीचे दिए गए उदाहरण में, नॉर्वे के ओस्लो और टेलीमार्क के बीच का रास्ता, दूरी, और यात्रा में लगने वाला समय दिखाने के लिए directions मोड का इस्तेमाल किया गया है. इसमें टोल और हाइवे से बचने का विकल्प चुना गया है.
https://www.google.com/maps/embed/v1/directions
?key=YOUR_API_KEY
&origin=Oslo+Norway
&destination=Telemark+Norway
&avoid=tolls|highwaysइन पैरामीटर का इस्तेमाल किया जा सकता है:
| पैरामीटर | टाइप | ब्यौरा | मंज़ूर की गई वैल्यू |
|---|---|---|---|
origin |
ज़रूरी है | इससे, दिशा-निर्देश दिखाने के लिए शुरुआती जगह तय की जाती है. | यूआरएल कोड वाली जगह का नाम, पता, प्लस कोड, अक्षांश/देशांतर निर्देशांक या जगह का आईडी.
Maps Embed API, स्पेस को एस्केप करने के लिए + और %20, दोनों का इस्तेमाल करता है. उदाहरण के लिए, "सिटी हॉल, न्यूयॉर्क, एनवाई" को City+Hall,New+York,NY में बदलें या प्लस कोड "849VCWC8+R9" को 849VCWC8%2BR9 में बदलें. |
destination |
ज़रूरी है | रास्ते की जानकारी के आखिरी पॉइंट के बारे में बताता है. | यूआरएल कोड वाली जगह का नाम, पता, प्लस कोड, अक्षांश/देशांतर निर्देशांक या जगह का आईडी.
Maps Embed API, स्पेस को एस्केप करने के लिए + और %20, दोनों का इस्तेमाल करता है. उदाहरण के लिए, "सिटी हॉल, न्यूयॉर्क, एनवाई" को City+Hall,New+York,NY में बदलें या प्लस कोड "849VCWC8+R9" को 849VCWC8%2BR9 में बदलें. |
waypoints |
वैकल्पिक | यह विकल्प, शुरुआती जगह और मंज़िल के बीच के एक या उससे ज़्यादा इंटरमीडियरी प्लेस के बारे में बताता है. | जगह का नाम, पता या जगह का आईडी.
पाइप वर्ण (|) का इस्तेमाल करके, एक से ज़्यादा वेपॉइंट तय किए जा सकते हैं. इससे जगहों को अलग किया जा सकता है (जैसे, Berlin,Germany|Paris,France). ज़्यादा से ज़्यादा 20 वेपॉइंट तय किए जा सकते हैं. |
mode |
वैकल्पिक | यात्रा के तरीके के बारे में बताता है. अगर कोई मोड नहीं चुना जाता है, तो Maps Embed API, तय किए गए रास्ते के लिए सबसे सही एक या उससे ज़्यादा मोड दिखाएगा. | driving, walking (जो पैदल चलने वालों के लिए बने रास्तों और फ़ुटपाथों को प्राथमिकता देता है), bicycling (जो साइकल के लिए बने रास्तों और सड़कों को प्राथमिकता देता है), transit या flying. |
avoid |
वैकल्पिक | इससे रास्ते में आने वाली उन सुविधाओं के बारे में पता चलता है जिनसे बचना है. ध्यान दें कि इससे उन रास्तों को बाहर नहीं रखा जाता जिनमें प्रतिबंधित सुविधा(एं) शामिल हैं. इससे नतीजे, ज़्यादा फ़ायदेमंद रास्तों के हिसाब से मिलते हैं. | tolls, ferries, और/या highways.
एक से ज़्यादा वैल्यू को पाइप वर्ण (जैसे, avoid=tolls|highways) से अलग करें. |
units |
वैकल्पिक | नतीजों में दूरी दिखाते समय, मेज़रमेंट के तरीके, मेट्रिक या इंपीरियल के बारे में बताता है. अगर units नहीं दिए गए हैं, तो क्वेरी के origin देश के हिसाब से तय किया जाता है कि किन इकाइयों का इस्तेमाल करना है. |
metric या imperial |
center |
वैकल्पिक | इससे मैप व्यू का सेंटर तय होता है. | यह कॉमा लगाकर अलग किए गए अक्षांश और देशांतर की वैल्यू स्वीकार करता है. उदाहरण के लिए:
37.4218,-122.0840. |
zoom |
वैकल्पिक | इससे मैप का शुरुआती ज़ूम करने का लेवल सेट किया जाता है. | वैल्यू 0 (पूरा देश) से लेकर 21 (अलग-अलग इमारतें) तक होती हैं. चुनी गई जगह के लिए उपलब्ध मैप डेटा के आधार पर, ऊपरी सीमा अलग-अलग हो सकती है. |
maptype |
वैकल्पिक | इससे लोड की जाने वाली मैप टाइल का टाइप तय होता है. | roadmap (डिफ़ॉल्ट) या satellite |
language |
वैकल्पिक | यह कुकी, यूज़र इंटरफ़ेस (यूआई) एलिमेंट और मैप टाइल पर लेबल दिखाने के लिए इस्तेमाल की जाने वाली भाषा तय करती है. डिफ़ॉल्ट रूप से, वेबसाइट पर आने वाले लोगों को उनकी भाषा में मैप दिखेगा. यह पैरामीटर सिर्फ़ कुछ देशों की टाइलों के लिए काम करता है. अगर अनुरोध की गई भाषा, टाइल सेट के लिए काम नहीं करती है, तो उस टाइलसेट के लिए डिफ़ॉल्ट भाषा का इस्तेमाल किया जाएगा. | |
region |
वैकल्पिक | यह जियो-पॉलिटिकल संवेदनशीलता के आधार पर, दिखाने के लिए सही बॉर्डर और लेबल तय करता है. | यह दो वर्णों (गैर-संख्यात्मक) वाले यूनिकोड क्षेत्र के सबटैग के तौर पर तय किए गए क्षेत्र के कोड को स्वीकार करता है. यह कोड, जाने-पहचाने ccTLD ("टॉप-लेवल डोमेन") के दो वर्णों वाली वैल्यू से मैप होता है. जिन देशों/इलाकों में यह सुविधा काम करती है उनके बारे में जानने के लिए, Google Maps Platform की कवरेज की जानकारी देखें. |
streetview मोड
Maps Embed API की मदद से, Street View की इमेज को इंटरैक्टिव पैनोरामा के तौर पर दिखाया जा सकता है. ये इमेज, कवरेज एरिया में मौजूद जगहों की होती हैं. उपयोगकर्ताओं के योगदान से बने फ़ोटोस्फ़ियर और 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का इस्तेमाल सिर्फ़ तब किया जाता है, जब एपीआई को पैनोरमा आईडी नहीं मिलता है.
ये यूआरएल पैरामीटर देना ज़रूरी नहीं है:
| पैरामीटर | टाइप | ब्यौरा | मंज़ूर की गई वैल्यू |
|---|---|---|---|
heading |
वैकल्पिक | इससे पता चलता है कि कैमरे की कंपास हेडिंग, उत्तर से घड़ी की सुई की दिशा में कितने डिग्री पर है. | डिग्री में वैल्यू, -180° से 360° तक |
pitch |
वैकल्पिक | इससे कैमरे का ऐंगल पता चलता है. यह ऊपर या नीचे की ओर होता है. पॉज़िटिव वैल्यू से कैमरा ऊपर की ओर झुकेगा, जबकि नेगेटिव वैल्यू से कैमरा नीचे की ओर झुकेगा. इमेज कैप्चर करते समय कैमरे की पोज़िशन के आधार पर, डिफ़ॉल्ट पिच 0° पर सेट होती है. इस वजह से, 0° का पिच अक्सर हॉरिज़ॉन्टल होता है, लेकिन हमेशा ऐसा नहीं होता. उदाहरण के लिए, किसी पहाड़ी पर ली गई इमेज में डिफ़ॉल्ट पिच, हॉरिज़ॉन्टल नहीं होगी. | डिग्री में वैल्यू, -90° से 90° तक |
fov |
वैकल्पिक | इससे इमेज का हॉरिज़ॉन्टल फ़ील्ड ऑफ़ व्यू तय होता है. इसकी डिफ़ॉल्ट वैल्यू 90° होती है. फ़िक्स्ड साइज़ वाले व्यूपोर्ट के साथ काम करते समय, फ़ील्ड ऑफ़ व्यू को ज़ूम करने का लेवल माना जा सकता है. इसमें छोटी संख्याएं, ज़्यादा ज़ूम करने का लेवल दिखाती हैं. | डिग्री में वैल्यू, जिसकी रेंज 10° से 100° तक होती है |
center |
वैकल्पिक | इससे मैप व्यू का सेंटर तय होता है. | यह कॉमा लगाकर अलग किए गए अक्षांश और देशांतर की वैल्यू स्वीकार करता है. उदाहरण के लिए:
37.4218,-122.0840. |
zoom |
वैकल्पिक | इससे मैप का शुरुआती ज़ूम करने का लेवल सेट किया जाता है. | वैल्यू 0 (पूरा देश) से लेकर 21 (अलग-अलग इमारतें) तक होती हैं. चुनी गई जगह के लिए उपलब्ध मैप डेटा के आधार पर, ऊपरी सीमा अलग-अलग हो सकती है. |
maptype |
वैकल्पिक | इससे लोड की जाने वाली मैप टाइल का टाइप तय होता है. | roadmap (डिफ़ॉल्ट) या satellite |
language |
वैकल्पिक | यह कुकी, यूज़र इंटरफ़ेस (यूआई) एलिमेंट और मैप टाइल पर लेबल दिखाने के लिए इस्तेमाल की जाने वाली भाषा तय करती है. डिफ़ॉल्ट रूप से, वेबसाइट पर आने वाले लोगों को उनकी भाषा में मैप दिखेगा. यह पैरामीटर सिर्फ़ कुछ देशों की टाइलों के लिए काम करता है. अगर अनुरोध की गई भाषा, टाइल सेट के लिए काम नहीं करती है, तो उस टाइलसेट के लिए डिफ़ॉल्ट भाषा का इस्तेमाल किया जाएगा. | |
region |
वैकल्पिक | यह जियो-पॉलिटिकल संवेदनशीलता के आधार पर, दिखाने के लिए सही बॉर्डर और लेबल तय करता है. | यह दो वर्णों (गैर-संख्यात्मक) वाले यूनिकोड क्षेत्र के सबटैग के तौर पर तय किए गए क्षेत्र के कोड को स्वीकार करता है. यह कोड, जाने-पहचाने ccTLD ("टॉप-लेवल डोमेन") के दो वर्णों वाली वैल्यू से मैप होता है. जिन देशों/इलाकों में यह सुविधा काम करती है उनके बारे में जानने के लिए, Google Maps Platform की कवरेज की जानकारी देखें. |
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इन पैरामीटर का इस्तेमाल किया जा सकता है:
| पैरामीटर | टाइप | ब्यौरा | मंज़ूर की गई वैल्यू |
|---|---|---|---|
q |
ज़रूरी है | इससे खोज के लिए इस्तेमाल किए जाने वाले शब्द के बारे में पता चलता है. | इसमें भौगोलिक पाबंदी शामिल हो सकती है, जैसे कि in+Seattle या near+98033. |
center |
वैकल्पिक | इससे मैप व्यू का सेंटर तय होता है. | यह कॉमा लगाकर अलग किए गए अक्षांश और देशांतर की वैल्यू स्वीकार करता है. उदाहरण के लिए:
37.4218,-122.0840. |
zoom |
वैकल्पिक | इससे मैप का शुरुआती ज़ूम करने का लेवल सेट किया जाता है. | वैल्यू 0 (पूरा देश) से लेकर 21 (अलग-अलग इमारतें) तक होती हैं. चुनी गई जगह के लिए उपलब्ध मैप डेटा के आधार पर, ऊपरी सीमा अलग-अलग हो सकती है. |
maptype |
वैकल्पिक | इससे लोड की जाने वाली मैप टाइल का टाइप तय होता है. | roadmap (डिफ़ॉल्ट) या satellite |
language |
वैकल्पिक | यह कुकी, यूज़र इंटरफ़ेस (यूआई) एलिमेंट और मैप टाइल पर लेबल दिखाने के लिए इस्तेमाल की जाने वाली भाषा तय करती है. डिफ़ॉल्ट रूप से, वेबसाइट पर आने वाले लोगों को उनकी भाषा में मैप दिखेगा. यह पैरामीटर सिर्फ़ कुछ देशों की टाइलों के लिए काम करता है. अगर अनुरोध की गई भाषा, टाइल सेट के लिए काम नहीं करती है, तो उस टाइलसेट के लिए डिफ़ॉल्ट भाषा का इस्तेमाल किया जाएगा. | |
region |
वैकल्पिक | यह जियो-पॉलिटिकल संवेदनशीलता के आधार पर, दिखाने के लिए सही बॉर्डर और लेबल तय करता है. | यह दो वर्णों (गैर-संख्यात्मक) वाले यूनिकोड क्षेत्र के सबटैग के तौर पर तय किए गए क्षेत्र के कोड को स्वीकार करता है. यह कोड, जाने-पहचाने ccTLD ("टॉप-लेवल डोमेन") के दो वर्णों वाली वैल्यू से मैप होता है. जिन देशों/इलाकों में यह सुविधा काम करती है उनके बारे में जानने के लिए, Google Maps Platform की कवरेज की जानकारी देखें. |
जगह के आईडी के पैरामीटर
Maps Embed API में, किसी जगह का नाम या पता देने के बजाय, जगह के आईडी का इस्तेमाल किया जा सकता है. जगह के आईडी, किसी जगह की खास तौर पर पहचान करने का एक भरोसेमंद तरीका है. ज़्यादा जानकारी के लिए, Google Places API से जुड़ा दस्तावेज़ देखें.
Maps Embed API, जगह के आईडी को इन यूआरएल पैरामीटर के लिए स्वीकार करता है:
qorigindestinationwaypoints
प्लेस आईडी का इस्तेमाल करने के लिए, आपको पहले place_id: प्रीफ़िक्स जोड़ना होगा. यहां दिए गए कोड में, न्यूयॉर्क सिटी हॉल को दिशा-निर्देशों के लिए अनुरोध करने की जगह के तौर पर सेट किया गया है: origin=place_id:ChIJs--MqP1YwokRBwAhjXWIHn8.
radiusपैरामीटर, मीटर में एक दायरा सेट करता है. इस दायरे में, दिए गए अक्षांश और देशांतर के हिसाब से पैनोरमा खोजा जाता है. मान्य वैल्यू, शून्य से बड़ी होनी चाहिए. डिफ़ॉल्ट वैल्यू 50 है.sourceसे, Street View की खोज के नतीजे सिर्फ़ चुने गए सोर्स से मिलते हैं. मान्य मान हैं:defaultStreet View के लिए डिफ़ॉल्ट सोर्स का इस्तेमाल करता है. खोजें, किसी खास सोर्स तक सीमित नहीं होती हैं.outdoorसिर्फ़ आउटडोर कलेक्शन में खोज करता है. इंडोर कलेक्शन, खोज के नतीजों में शामिल नहीं किए जाते. ध्यान दें कि बताई गई जगह के लिए, आउटडोर पैनोरामा मौजूद नहीं हो सकते. यह भी ध्यान दें कि खोज के नतीजों में सिर्फ़ ऐसे पैनोरमा दिखते हैं जिनके बारे में यह पता लगाया जा सकता है कि वे घर के अंदर के हैं या बाहर के. उदाहरण के लिए, फ़ोटोस्फ़ियर नहीं दिखाए जाते, क्योंकि यह पता नहीं होता कि वे घर के अंदर के हैं या बाहर के.