Maps Embed API के बारे में खास जानकारी

Maps Embed API, किसी वेब पेज पर इंटरैक्टिव मैप या Street View पैनोरामा दिखाता है. इसके लिए, iframe src यूआरएल के तौर पर सेट किए गए एचटीटीपी अनुरोध का इस्तेमाल किया जाता है. इसमें JavaScript की ज़रूरत नहीं होती. इसमें place, view, directions, streetview, और search मैप मोड काम करते हैं.

Maps Embed API: मुख्य बातें

  • प्रॉडक्ट: Maps Embed API
  • इसे इस नाम से भी जाना जाता है: Google Maps Embed API, Maps Embed
  • कैटगरी: Maps
  • प्लैटफ़ॉर्म: JavaScript (ब्राउज़र)
  • इस पर काम करता है: क्लाइंट (ऐप्लिकेशन या ब्राउज़र कोड)
  • लॉन्च स्टेज: GA
  • लाइफ़साइकल: चालू है
  • खास जानकारी: Maps Embed API की खास जानकारी
  • क्षेत्र के हिसाब से उपलब्धता: दुनिया भर में. Street View मोड, Street View के कवरेज पर निर्भर करता है. region पैरामीटर, Maps Platform के कवरेज की जानकारी वाले पेज पर मौजूद इलाकों को स्वीकार करता है. (कवरेज की जानकारी)

Maps Embed API: इसका इस्तेमाल कब करना चाहिए

Maps Embed API का इस्तेमाल तब करें, जब:

  • आपको किसी वेब पेज पर इंटरैक्टिव मैप या Street View पैनोरमा की ज़रूरत है. इसके लिए, आपको सिर्फ़ एचटीएमएल iframe का इस्तेमाल करना है, JavaScript का नहीं.
  • आपको एम्बेड किए गए मैप में किसी जगह का पिन, मैप व्यू, दो जगहों के बीच के रास्ते की जानकारी या किसी इलाके के लिए खोज के नतीजे दिखाने हों.
  • आपको एम्बेड किया गया ऐसा मैप चाहिए जिसके लिए, हर अनुरोध पर कोई शुल्क न देना पड़े. साथ ही, हर सेकंड क्वेरी (क्यूपीएस) या हर दिन के अनुरोध की कोई सीमा न हो. हालांकि, इसके लिए एपीआई पासकोड की ज़रूरत अब भी होगी.

Maps Embed API का इस्तेमाल तब न करें, जब:

  • आपको अपने कॉन्टेंट और तस्वीरों का इस्तेमाल करके, वेब मैप को पसंद के मुताबिक बनाना होगा. इसके बजाय, Maps JavaScript API का इस्तेमाल करें.
  • आपको एम्बेड किए गए मैप को iframe यूआरएल पैरामीटर के अलावा, प्रोग्राम के हिसाब से काम करने वाली सुविधाओं के साथ इस्तेमाल करना है. इसके बजाय, Maps JavaScript API का इस्तेमाल करें.

Maps Embed API: सेटअप

Maps Embed API: सामान्य गलतियां

  • समस्या: अगर होस्ट पेज, referrer मेटा टैग को no-referrer या same-origin पर सेट करता है, तो ब्राउज़र Referer हेडर नहीं भेजता. साथ ही, एचटीटीपी रेफ़रर पर पाबंदी लगाने वाला एपीआई पासकोड, एम्बेड करने के अनुरोधों को अस्वीकार कर सकता है. ठीक करने का तरीका: iframe में referrerpolicy="strict-origin-when-cross-origin" जोड़ें, ताकि साइट का डोमेन Google को भेजा जा सके. /maps/documentation/embed/embedding-map देखें.
  • समस्या: एम्बेड किए गए मैप, किसी भी डाइमेंशन में 200 पिक्सल से कम होने पर काम नहीं करते. ठीक करने का तरीका: iframe width और height को कम से कम 200 पिक्सल पर सेट करें. /maps/documentation/embed/embedding-map देखें.
  • समस्या: भले ही, इस्तेमाल करने का कोई शुल्क नहीं लिया जाता, लेकिन अगर बिलिंग की सुविधा चालू नहीं है, पैसे चुकाने का तरीका अमान्य है, खुद से तय की गई रोज़ाना की सीमा पार हो गई है या रेफ़रर से जुड़ी पाबंदी वाली कुंजी का इस्तेमाल करते समय अनुरोध में एचटीटीपी रेफ़रर मौजूद नहीं है, तो "सिर्फ़ डेवलपमेंट के मकसद से" वॉटरमार्क वाला गहरा मैप दिखता है. ठीक करने का तरीका: प्रोजेक्ट पर, पेमेंट के मान्य तरीके से बिलिंग की सुविधा चालू करें. साथ ही, खुद से तय किए गए रोज़ के कोटे की सीमा को बढ़ाएं या हटाएं. इसके अलावा, पक्का करें कि रेफ़रर को रेफ़रर-प्रतिबंधित कुंजियों के लिए भेजा गया हो. उदाहरण के लिए, iframe पर referrerpolicy="strict-origin-when-cross-origin" के साथ. /maps/documentation/embed/error-messages देखें.
  • समस्या: अमान्य अनुरोधों के लिए, ब्राउज़र कंसोल में सिर्फ़ एचटीटीपी 4xx स्टेटस कोड दिखता है, न कि पूरी जानकारी देने वाला मैसेज. अमान्य अनुरोधों में ये शामिल हैं: गलत या मौजूद न होने वाले पैरामीटर, एपीआई पासकोड और कोटे से जुड़ी गड़बड़ियां, जैसे कि पासकोड का मौजूद न होना या अमान्य होना, Maps Embed API का चालू न होना या पासकोड से जुड़ी पाबंदी का उल्लंघन. गड़बड़ी का टेक्स्ट, मैप की जगह iframe में दिखता है. ठीक करने का तरीका: iframe में मौजूद गड़बड़ी का टेक्स्ट और कंसोल स्टेटस कोड पढ़ें. पैरामीटर से जुड़ी गड़बड़ियों के लिए 400, पासकोड मौजूद न होने के लिए 401, और अमान्य पासकोड के लिए 403 कोड होता है. इसके बाद, पुष्टि करें कि पैरामीटर और पासकोड मान्य हैं, Maps Embed API चालू है, और पासकोड से जुड़ी पाबंदियों के तहत अनुरोध की अनुमति है. /maps/documentation/embed/error-messages देखें.

Maps Embed API की मदद से क्या किया जा सकता है

हर टास्क के लिए, यहां लिंक की गई गाइड देखें या Capabilities Explorer में जाकर, अलग-अलग प्रॉडक्ट की तुलना करें.

Maps Embed API: निर्देश और रास्ता

Maps Embed API: Maps

Maps Embed API: Places

Maps Embed API: Street View