इस गाइड में, अपने वेब पेज पर इंटरैक्टिव मैप को एम्बेड करने का तरीका बताया गया है.
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"
प्रॉपर्टी. referrerpolicy="no-referrer-when-downgrade"
प्रॉपर्टी, जिसकी मदद से ब्राउज़र, अनुरोध के साथReferer
हेडर के तौर पर पूरा यूआरएल भेज सकता है, ताकि एपीआई पासकोड की पाबंदियां सही तरीके से काम कर सकें.
अपनी वेबसाइट के स्ट्रक्चर और डिज़ाइन के हिसाब से, iframe का साइज़ बदला जा सकता है. हालांकि, हमें पता चला है कि आम तौर पर, वेबसाइट पर आने वाले लोगों को बड़े मैप के साथ इंटरैक्ट करना आसान लगता है. ध्यान दें कि एम्बेड किए गए मैप का साइज़, किसी भी डाइमेंशन में 200 पिक्सल से कम नहीं होना चाहिए.
एपीआई पासकोड से जुड़ी पाबंदियां
अगर होस्टिंग वेबसाइट का referrer
मेटा टैग no-referrer
या
same-origin
पर सेट है, तो ब्राउज़र Google को Referer
हेडर नहीं भेजेगा. इस वजह से, एपीआई पासकोड से जुड़ी पाबंदी, अनुरोधों को अस्वीकार कर सकती है. पाबंदी सही तरीके से काम करे, इसके लिए ऊपर दिए गए उदाहरण की तरह ही iframe में referrerpolicy
प्रॉपर्टी जोड़ें. इससे Google को Referer
हेडर भेजने की अनुमति मिलती है.
मैप पर विज्ञापन
Maps Embed API में, मैप पर विज्ञापन दिखाने की सुविधा शामिल हो सकती है. किसी भी मैप में दिखाए जाने वाले विज्ञापनों का फ़ॉर्मैट और विज्ञापनों का सेट, बिना किसी सूचना के बदल सकता है.
मैप मोड चुनना
अनुरोध के यूआरएल में इस्तेमाल करने के लिए, इनमें से किसी एक मैप मोड को चुना जा सकता है:
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 दोनों के साथ काम करता है. उदाहरण के लिए, "सिटी हॉल, न्यूयॉर्क, NY" को
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
पैरामीटर का इस्तेमाल किया गया है. हालांकि, 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 दोनों के साथ काम करता है. उदाहरण के लिए, "सिटी हॉल, न्यूयॉर्क, NY" को
City+Hall,New+York,NY में बदलें या प्लस कोड "849VCWC8+R9" को
849VCWC8%2BR9 में बदलें. |
destination |
ज़रूरी है | निर्देशों के आखिरी पॉइंट की जानकारी देता है. | यूआरएल-एस्केप की गई जगह का नाम, पता, प्लस कोड, अक्षांश/देशांतर के निर्देशांक या जगह का आईडी.
Maps Embed API, स्पेस को एस्केप करते समय + और %20 दोनों के साथ काम करता है. उदाहरण के लिए, "सिटी हॉल, न्यूयॉर्क, NY" को
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 का हर पैनोरमा, किसी एक जगह से 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, इन यूआरएल पैरामीटर के लिए प्लेस आईडी स्वीकार करता है:
q
origin
destination
waypoints
प्लेस आईडी का इस्तेमाल करने के लिए, आपको सबसे पहले प्रीफ़िक्स place_id:
जोड़ना होगा. यहां दिए गए कोड में, निर्देशों के अनुरोध के लिए ऑरिजिन के तौर पर न्यूयॉर्क सिटी हॉल की जानकारी दी गई है: origin=place_id:ChIJs--MqP1YwokRBwAhjXWIHn8
.
radius
, मीटर में दायरा सेट करता है. इस दायरे में, दिए गए अक्षांश और देशांतर के बीच पैनोरमा खोजा जाता है. मान्य वैल्यू, ऐसी पूर्ण संख्याएं होती हैं जो शून्य से बड़ी हों. डिफ़ॉल्ट वैल्यू 50 है.source
, Street View पर खोज के नतीजों को चुनिंदा सोर्स तक सीमित करता है. मान्य मान हैं:default
, Street View के लिए डिफ़ॉल्ट सोर्स का इस्तेमाल करता है. खोजें, किसी खास सोर्स तक सीमित नहीं होतीं.outdoor
, आउटडोर कलेक्शन तक खोज को सीमित करता है. इनडोर इकट्ठा किए गए आइटम, खोज के नतीजों में शामिल नहीं किए जाते. ध्यान दें कि बताई गई जगह के लिए, आउटडोर पैनोरमा मौजूद न हों. यह भी ध्यान दें कि खोज के नतीजों में सिर्फ़ ऐसे पैनोरमा दिखते हैं जिनसे यह पता चलता हो कि वे इनडोर हैं या आउटडोर. उदाहरण के लिए, फ़ोटोस्फ़ीर की जानकारी नहीं मिलती, क्योंकि यह पता नहीं चलता कि वे इनडोर हैं या आउटडोर.