एक मैप जोड़ें

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

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