एक मैप जोड़ें

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

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="no-referrer-when-downgrade"
  src="https://www.google.com/maps/embed/v1/MAP_MODE?key=YOUR_API_KEY&PARAMETERS"
  allowfullscreen>
</iframe>

ऊपर दिए गए iframe के सैंपल में, इन अतिरिक्त प्रॉपर्टी का इस्तेमाल किया गया है:

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

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

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

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

मैप मोड चुनना

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

• 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
  &center=-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 के खास कलेक्शन भी उपलब्ध हैं.

हर स्ट्रीट व्यू पैनोरामा में, किसी एक जगह से 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 से, सिर्फ़ आउटडोर कलेक्शन खोजे जा सकते हैं. खोज के नतीजों में, इंडोर कलेक्शन शामिल नहीं किए जाते. ध्यान दें कि बताई गई जगह के लिए, आउटडोर पैनोरामा मौजूद नहीं हो सकते. यह भी ध्यान दें कि खोज के नतीजों में सिर्फ़ ऐसे पैनोरमा दिखते हैं जिनके बारे में यह पता लगाया जा सकता है कि वे घर के अंदर के हैं या बाहर के. उदाहरण के लिए, फ़ोटोस्फ़ियर नहीं दिखाए जाते, क्योंकि यह पता नहीं होता कि वे घर के अंदर की हैं या बाहर की.