जगह की जानकारी का ऑटोकंप्लीट विजेट, एक टेक्स्ट इनपुट फ़ील्ड बनाता है. साथ ही, यूज़र इंटरफ़ेस (यूआई) की चुनी गई सूची में जगह की जानकारी के सुझाव देता है. इसके बाद, उपयोगकर्ता के चुने गए विकल्प के हिसाब से, जगह की जानकारी दिखाता है. अपने वेब पेज पर, ऑटोकंप्लीट की सुविधा वाला यूज़र इंटरफ़ेस जोड़ने के लिए, जगह की जानकारी के लिए ऑटोकंप्लीट विजेट का इस्तेमाल करें.
ज़रूरी शर्तें
स् थान ऑटोकंप्लीट (झलक) का उपयोग करने के लिए, आपको " places API" को सक्षम करना होगा अपने Google Cloud पर
प्रोजेक्ट करें और अपने बूटस्ट्रैप लोडर में बीटा चैनल (v: "beta"
) बताएं. यहां जाएं:
ज़्यादा जानकारी के लिए, शुरू करें.
नया क्या है
जगह के शुरुआती अक्षर लिखने पर पूरा नाम सुझाने की सुविधा (झलक) को इन तरीकों से बेहतर बनाया गया है:
- ऑटोकंप्लीट विजेट के यूज़र इंटरफ़ेस (यूआई) में, टेक्स्ट इनपुट प्लेसहोल्डर, सुझावों की सूची के लोगो, और जगह के सुझावों के लिए, स्थानीय भाषाओं (इनमें आरटीएल भाषाएं भी शामिल हैं) का इस्तेमाल किया जा सकता है.
- सुलभता से जुड़ी बेहतर सुविधाएं. इनमें स्क्रीन रीडर और कीबोर्ड इंटरैक्शन की सुविधा भी शामिल है.
- ऑटोकंप्लीट विजेट, दिखाए गए ऑब्जेक्ट को मैनेज करने की प्रोसेस को आसान बनाने के लिए, नई जगह की कैटगरी दिखाता है.
- मोबाइल डिवाइसों और छोटी स्क्रीन के लिए बेहतर सहायता.
- इसकी परफ़ॉर्मेंस बेहतर होती है और यह ग्राफ़िक के तौर पर बेहतर दिखता है.
ऑटोकंप्लीट विजेट जोड़ना
किसी वेब पेज या Google मैप पर, अपने-आप पूरा होने वाला व्यूज़ेट जोड़ा जा सकता है. ऑटोकंप्लीट विजेट, एक टेक्स्ट इनपुट फ़ील्ड बनाता है. साथ ही, यूज़र इंटरफ़ेस (यूआई) की चुनी गई सूची में जगह के सुझाव देता है. इसके अलावा, gmp-placeselect
लिसनर की मदद से, उपयोगकर्ता के क्लिक के जवाब में जगह की जानकारी दिखाता है. इस सेक्शन में, आपको दिखाया गया है कि किसी वेब पेज या Google मैप में, ऑटोमैटिक भरने की सुविधा वाला विजेट कैसे जोड़ा जाता है.
किसी वेब पेज में ऑटोकंप्लीट विजेट जोड़ना
किसी वेब पेज में ऑटोकंप्लीट विजेट जोड़ने के लिए, नया google.maps.places.PlaceAutocompleteElement
बनाएं और उसे पेज में जोड़ें, जैसा कि यहां दिए गए उदाहरण में दिखाया गया है:
TypeScript
// Request needed libraries. //@ts-ignore await google.maps.importLibrary("places") as google.maps.PlacesLibrary; // Create the input HTML element, and append it. //@ts-ignore const placeAutocomplete = new google.maps.places.PlaceAutocompleteElement(); //@ts-ignore document.body.appendChild(placeAutocomplete);
JavaScript
// Request needed libraries. //@ts-ignore await google.maps.importLibrary("places"); // Create the input HTML element, and append it. //@ts-ignore const placeAutocomplete = new google.maps.places.PlaceAutocompleteElement(); //@ts-ignore document.body.appendChild(placeAutocomplete);
मैप में ऑटोकंप्लीट की सुविधा देने वाला विजेट जोड़ना
मैप में ऑटोकंप्लीट की सुविधा वाला विजेट जोड़ने के लिए, नया google.maps.places.PlaceAutocompleteElement
इंस्टेंस बनाएं. इसके बाद,
PlaceAutocompleteElement
को div
के लिए सेट करें और कस्टम के रूप में उसे मैप पर पुश करें
जैसा कि नीचे दिए गए उदाहरण में दिखाया गया है:
TypeScript
//@ts-ignore const placeAutocomplete = new google.maps.places.PlaceAutocompleteElement(); //@ts-ignore placeAutocomplete.id = 'place-autocomplete-input'; const card = document.getElementById('place-autocomplete-card') as HTMLElement; //@ts-ignore card.appendChild(placeAutocomplete); map.controls[google.maps.ControlPosition.TOP_LEFT].push(card);अभी तक किसी भी व्यक्ति ने चेक इन नहीं किया है
JavaScript
//@ts-ignore const placeAutocomplete = new google.maps.places.PlaceAutocompleteElement(); //@ts-ignore placeAutocomplete.id = "place-autocomplete-input"; const card = document.getElementById("place-autocomplete-card"); //@ts-ignore card.appendChild(placeAutocomplete); map.controls[google.maps.ControlPosition.TOP_LEFT].push(card);
ऑटोकंप्लीट सुविधा की मदद से मिलने वाले सुझावों को रोकें
डिफ़ॉल्ट रूप से, जगह की जानकारी अपने-आप भरने की सुविधा, जगह के सभी टाइप दिखाती है. यह सुविधा, उपयोगकर्ता की जगह के आस-पास के सुझावों पर फ़ोकस करती है. साथ ही, उपयोगकर्ता की चुनी गई जगह के लिए सभी उपलब्ध डेटा फ़ील्ड फ़ेच करती है. जगह के नाम के लिए अपने-आप पूरी होने वाले विकल्प सेट करें, ताकि आपको ज़्यादा काम के सुझाव मिल सकें. इसके लिए, नतीजों पर पाबंदी लगाएं या उन्हें अपने हिसाब से बनाएं.
नतीजों पर पाबंदी लगाने पर, अपने-आप पूरा होने वाला व्यूज़र्ड, पाबंदी वाले इलाके से बाहर के नतीजों को अनदेखा कर देता है. एक सामान्य तरीका, नतीजों को मैप की सीमाओं तक सीमित करना है. भेदभाव के नतीजे अपने-आप पूरा होने वाला विजेट, तय किए गए इलाके में नतीजे दिखाता है. हालांकि, कुछ मिलान बाहर रखा जाता है.
देश के हिसाब से जगह की खोज पर पाबंदी लगाना
स्थान खोज को एक या ज़्यादा विशिष्ट देशों तक सीमित करने के लिए, componentRestrictions
का उपयोग करें
प्रॉपर्टी का इस्तेमाल करें, जैसा कि नीचे दिए गए स्निपेट में दिखाया गया है:
const pac = new google.maps.places.PlaceAutocompleteElement({ componentRestrictions: {country: ['us', 'au']}, });
जगह की खोज को मैप के दायरे तक सीमित करना
जगह की खोज को मैप के बॉउंड तक सीमित करने के लिए, बॉउंड जोड़ने के लिए locationRestrictions
प्रॉपर्टी का इस्तेमाल करें, जैसा कि इस स्निपेट में दिखाया गया है:
const pac = new google.maps.places.PlaceAutocompleteElement({ locationRestriction: map.getBounds(), });
मैप के दायरे को सीमित करते समय, दायरे में बदलाव होने पर उसे अपडेट करने के लिए, एक लिसनर ज़रूर जोड़ें:
map.addListener('bounds_changed', () => { autocomplete.locationRestriction = map.getBounds(); });
locationRestriction
को हटाने के लिए, इसे null
पर सेट करें.
जगह के खोज नतीजों में पक्षपात
पूर्वाग्रह खोज नतीजों को किसी मंडली क्षेत्र में रखने के लिए locationBias
प्रॉपर्टी का इस्तेमाल करता है और
दायरा पार करना, जैसा कि यहां दिखाया गया है:
const autocomplete = new google.maps.places.PlaceAutocompleteElement({ locationBias: {radius: 100, center: {lat: 50.064192, lng: -130.605469}}, });
locationBias
को हटाने के लिए, इसे null
पर सेट करें.
जगह की खोज के नतीजों को कुछ खास टाइप पर सीमित करना
types
का उपयोग करके स्थान खोज परिणामों को कुछ खास प्रकार के स्थानों तक सीमित करें
प्रॉपर्टी में टाइप कर सकते हैं और एक या उससे ज़्यादा टाइप तय कर सकते हैं, जैसा कि यहां दिखाया गया है:
const autocomplete = new google.maps.places.PlaceAutocompleteElement({ types: ['establishment'], });
काम करने वाले टाइप की पूरी सूची देखने के लिए, टेबल 3: अपने-आप पूरे होने वाले अनुरोधों के साथ काम करने वाले टाइप देखें.
जगह की जानकारी पाना
चुनी गई जगह की जानकारी पाने के लिए, gmp-place-select
को लिसनर जोड़ें
PlaceAutocompleteElement
, जैसा कि इस उदाहरण में दिखाया गया है:
TypeScript
// Add the gmp-placeselect listener, and display the results. //@ts-ignore placeAutocomplete.addEventListener('gmp-placeselect', async ({ place }) => { await place.fetchFields({ fields: ['displayName', 'formattedAddress', 'location'] }); selectedPlaceTitle.textContent = 'Selected Place:'; selectedPlaceInfo.textContent = JSON.stringify( place.toJSON(), /* replacer */ null, /* space */ 2); });अभी तक किसी भी व्यक्ति ने चेक इन नहीं किया है
JavaScript
// Add the gmp-placeselect listener, and display the results. //@ts-ignore placeAutocomplete.addEventListener("gmp-placeselect", async ({ place }) => { await place.fetchFields({ fields: ["displayName", "formattedAddress", "location"], }); selectedPlaceTitle.textContent = "Selected Place:"; selectedPlaceInfo.textContent = JSON.stringify( place.toJSON(), /* replacer */ null, /* space */ 2, ); });
पिछले उदाहरण में, इवेंट लिसनर जगह की क्लास का ऑब्जेक्ट दिखाता है.
अपने ऐप्लिकेशन के लिए, जगह की जानकारी के डेटा फ़ील्ड पाने के लिए place.fetchFields()
पर कॉल करें.
अगले उदाहरण में, Listener किसी जगह की जानकारी का अनुरोध करता है और उसे मैप पर दिखाता है.
TypeScript
// Add the gmp-placeselect listener, and display the results on the map. //@ts-ignore placeAutocomplete.addEventListener('gmp-placeselect', async ({ place }) => { await place.fetchFields({ fields: ['displayName', 'formattedAddress', 'location'] }); // If the place has a geometry, then present it on a map. if (place.viewport) { map.fitBounds(place.viewport); } else { map.setCenter(place.location); map.setZoom(17); } let content = '<div id="infowindow-content">' + '<span id="place-displayname" class="title">' + place.displayName + '</span><br />' + '<span id="place-address">' + place.formattedAddress + '</span>' + '</div>'; updateInfoWindow(content, place.location); marker.position = place.location; });
JavaScript
// Add the gmp-placeselect listener, and display the results on the map. //@ts-ignore placeAutocomplete.addEventListener("gmp-placeselect", async ({ place }) => { await place.fetchFields({ fields: ["displayName", "formattedAddress", "location"], }); // If the place has a geometry, then present it on a map. if (place.viewport) { map.fitBounds(place.viewport); } else { map.setCenter(place.location); map.setZoom(17); } let content = '<div id="infowindow-content">' + '<span id="place-displayname" class="title">' + place.displayName + "</span><br />" + '<span id="place-address">' + place.formattedAddress + "</span>" + "</div>"; updateInfoWindow(content, place.location); marker.position = place.location; });
उदाहरण के तौर पर दिया गया पूरा कोड देखें
चुनी गई जगह के लिए जियोकोडिंग के नतीजे पाना
चुनी गई जगह के लिए जियोकोडिंग के नतीजे पाने के लिए, जगह की जानकारी पाने के लिए google.maps.Geocoder
का इस्तेमाल करें, जैसा कि इस स्निपेट में दिखाया गया है:
const map = new google.maps.Map(document.getElementById('map'), { center: {lat: 50.064192, lng: -130.605469}, zoom: 3, }); const marker = new google.maps.Marker({map}); const autocomplete = new google.maps.places.PlaceAutocompleteElement(); const geocoder = new google.maps.Geocoder(); autocomplete.addListener('gmp-placeselect', async ({prediction: place}) => { const results = await geocoder.geocode({place.id}); marker.setPlace({ placeId: place.id, location: results[0].geometry.location, }); });
मैप के उदाहरण
इस अनुभाग में इस पृष्ठ पर फ़ीचर किए गए मानचित्रों का पूरा कोड शामिल है.
ऑटोकंप्लीट एलिमेंट
इस उदाहरण में, किसी वेब पेज में अपने-आप पूरा होने वाला टेक्स्ट वाला विजेट जोड़ा गया है. साथ ही, चुने गए हर जगह के लिए नतीजे दिखाए गए हैं.
TypeScript
async function initMap(): Promise<void> { // Request needed libraries. //@ts-ignore await google.maps.importLibrary("places") as google.maps.PlacesLibrary; // Create the input HTML element, and append it. //@ts-ignore const placeAutocomplete = new google.maps.places.PlaceAutocompleteElement(); //@ts-ignore document.body.appendChild(placeAutocomplete); // Inject HTML UI. const selectedPlaceTitle = document.createElement('p'); selectedPlaceTitle.textContent = ''; document.body.appendChild(selectedPlaceTitle); const selectedPlaceInfo = document.createElement('pre'); selectedPlaceInfo.textContent = ''; document.body.appendChild(selectedPlaceInfo); // Add the gmp-placeselect listener, and display the results. //@ts-ignore placeAutocomplete.addEventListener('gmp-placeselect', async ({ place }) => { await place.fetchFields({ fields: ['displayName', 'formattedAddress', 'location'] }); selectedPlaceTitle.textContent = 'Selected Place:'; selectedPlaceInfo.textContent = JSON.stringify( place.toJSON(), /* replacer */ null, /* space */ 2); }); } initMap();
JavaScript
async function initMap() { // Request needed libraries. //@ts-ignore await google.maps.importLibrary("places"); // Create the input HTML element, and append it. //@ts-ignore const placeAutocomplete = new google.maps.places.PlaceAutocompleteElement(); //@ts-ignore document.body.appendChild(placeAutocomplete); // Inject HTML UI. const selectedPlaceTitle = document.createElement("p"); selectedPlaceTitle.textContent = ""; document.body.appendChild(selectedPlaceTitle); const selectedPlaceInfo = document.createElement("pre"); selectedPlaceInfo.textContent = ""; document.body.appendChild(selectedPlaceInfo); // Add the gmp-placeselect listener, and display the results. //@ts-ignore placeAutocomplete.addEventListener("gmp-placeselect", async ({ place }) => { await place.fetchFields({ fields: ["displayName", "formattedAddress", "location"], }); selectedPlaceTitle.textContent = "Selected Place:"; selectedPlaceInfo.textContent = JSON.stringify( place.toJSON(), /* replacer */ null, /* space */ 2, ); }); } initMap();अभी तक किसी भी व्यक्ति ने चेक इन नहीं किया है
सीएसएस
/* * Always set the map height explicitly to define the size of the div element * that contains the map. */ #map { height: 100%; } /* * Optional: Makes the sample page fill the window. */ html, body { height: 100%; margin: 0; padding: 0; } p { font-family: Roboto, sans-serif; font-weight: bold; }
एचटीएमएल
<html> <head> <title>Place Autocomplete element</title> <link rel="stylesheet" type="text/css" href="./style.css" /> <script type="module" src="./index.js"></script> </head> <body> <p style="font-family: roboto, sans-serif">Search for a place here:</p> <!-- prettier-ignore --> <script>(g=>{var h,a,k,p="The Google Maps JavaScript API",c="google",l="importLibrary",q="__ib__",m=document,b=window;b=b[c]||(b[c]={});var d=b.maps||(b.maps={}),r=new Set,e=new URLSearchParams,u=()=>h||(h=new Promise(async(f,n)=>{await (a=m.createElement("script"));e.set("libraries",[...r]+"");for(k in g)e.set(k.replace(/[A-Z]/g,t=>"_"+t[0].toLowerCase()),g[k]);e.set("callback",c+".maps."+q);a.src=`https://maps.${c}apis.com/maps/api/js?`+e;d[q]=f;a.onerror=()=>h=n(Error(p+" could not load."));a.nonce=m.querySelector("script[nonce]")?.nonce||"";m.head.append(a)}));d[l]?console.warn(p+" only loads once. Ignoring:",g):d[l]=(f,...n)=>r.add(f)&&u().then(()=>d[l](f,...n))}) ({key: "AIzaSyB41DRUbKWJHPxaFjMAwdrzWzbVKartNGg", v: "beta"});</script> </body> </html>
सैंपल आज़माएं
मैप पर ऑटोकंप्लीट की सुविधा
इस उदाहरण में, Google Maps में ऑटोकंप्लीट की सुविधा वाला विजेट जोड़ने का तरीका बताया गया है.
TypeScript
let map: google.maps.Map; let marker: google.maps.marker.AdvancedMarkerElement; let infoWindow: google.maps.InfoWindow; async function initMap(): Promise<void> { // Request needed libraries. //@ts-ignore const [{ Map }, { AdvancedMarkerElement }] = await Promise.all([ google.maps.importLibrary("marker"), google.maps.importLibrary("places") ]); // Initialize the map. map = new google.maps.Map(document.getElementById('map') as HTMLElement, { center: { lat: 40.749933, lng: -73.98633 }, zoom: 13, mapId: '4504f8b37365c3d0', mapTypeControl: false, }); //@ts-ignore const placeAutocomplete = new google.maps.places.PlaceAutocompleteElement(); //@ts-ignore placeAutocomplete.id = 'place-autocomplete-input'; const card = document.getElementById('place-autocomplete-card') as HTMLElement; //@ts-ignore card.appendChild(placeAutocomplete); map.controls[google.maps.ControlPosition.TOP_LEFT].push(card); // Create the marker and infowindow marker = new google.maps.marker.AdvancedMarkerElement({ map, }); infoWindow = new google.maps.InfoWindow({}); // Add the gmp-placeselect listener, and display the results on the map. //@ts-ignore placeAutocomplete.addEventListener('gmp-placeselect', async ({ place }) => { await place.fetchFields({ fields: ['displayName', 'formattedAddress', 'location'] }); // If the place has a geometry, then present it on a map. if (place.viewport) { map.fitBounds(place.viewport); } else { map.setCenter(place.location); map.setZoom(17); } let content = '<div id="infowindow-content">' + '<span id="place-displayname" class="title">' + place.displayName + '</span><br />' + '<span id="place-address">' + place.formattedAddress + '</span>' + '</div>'; updateInfoWindow(content, place.location); marker.position = place.location; }); } // Helper function to create an info window. function updateInfoWindow(content, center) { infoWindow.setContent(content); infoWindow.setPosition(center); infoWindow.open({ map, anchor: marker, shouldFocus: false, }); } initMap();
JavaScript
let map; let marker; let infoWindow; async function initMap() { // Request needed libraries. //@ts-ignore const [{ Map }, { AdvancedMarkerElement }] = await Promise.all([ google.maps.importLibrary("marker"), google.maps.importLibrary("places"), ]); // Initialize the map. map = new google.maps.Map(document.getElementById("map"), { center: { lat: 40.749933, lng: -73.98633 }, zoom: 13, mapId: "4504f8b37365c3d0", mapTypeControl: false, }); //@ts-ignore const placeAutocomplete = new google.maps.places.PlaceAutocompleteElement(); //@ts-ignore placeAutocomplete.id = "place-autocomplete-input"; const card = document.getElementById("place-autocomplete-card"); //@ts-ignore card.appendChild(placeAutocomplete); map.controls[google.maps.ControlPosition.TOP_LEFT].push(card); // Create the marker and infowindow marker = new google.maps.marker.AdvancedMarkerElement({ map, }); infoWindow = new google.maps.InfoWindow({}); // Add the gmp-placeselect listener, and display the results on the map. //@ts-ignore placeAutocomplete.addEventListener("gmp-placeselect", async ({ place }) => { await place.fetchFields({ fields: ["displayName", "formattedAddress", "location"], }); // If the place has a geometry, then present it on a map. if (place.viewport) { map.fitBounds(place.viewport); } else { map.setCenter(place.location); map.setZoom(17); } let content = '<div id="infowindow-content">' + '<span id="place-displayname" class="title">' + place.displayName + "</span><br />" + '<span id="place-address">' + place.formattedAddress + "</span>" + "</div>"; updateInfoWindow(content, place.location); marker.position = place.location; }); } // Helper function to create an info window. function updateInfoWindow(content, center) { infoWindow.setContent(content); infoWindow.setPosition(center); infoWindow.open({ map, anchor: marker, shouldFocus: false, }); } initMap();अभी तक किसी भी व्यक्ति ने चेक इन नहीं किया है
सीएसएस
/* * Always set the map height explicitly to define the size of the div element * that contains the map. */ #map { height: 100%; } /* * Optional: Makes the sample page fill the window. */ html, body { height: 100%; margin: 0; padding: 0; } #place-autocomplete-card { background-color: #fff; border-radius: 5px; box-shadow: rgba(0, 0, 0, 0.35) 0px 5px 15px; margin: 10px; padding: 5px; font-family: Roboto, sans-serif; font-size: large; font-weight: bold; } gmp-place-autocomplete { width: 300px; } #infowindow-content .title { font-weight: bold; } #map #infowindow-content { display: inline; }
एचटीएमएल
<html> <head> <title>Place Autocomplete map</title> <link rel="stylesheet" type="text/css" href="./style.css" /> <script type="module" src="./index.js"></script> </head> <body> <div class="place-autocomplete-card" id="place-autocomplete-card"> <p>Search for a place here:</p> </div> <div id="map"></div> <!-- prettier-ignore --> <script>(g=>{var h,a,k,p="The Google Maps JavaScript API",c="google",l="importLibrary",q="__ib__",m=document,b=window;b=b[c]||(b[c]={});var d=b.maps||(b.maps={}),r=new Set,e=new URLSearchParams,u=()=>h||(h=new Promise(async(f,n)=>{await (a=m.createElement("script"));e.set("libraries",[...r]+"");for(k in g)e.set(k.replace(/[A-Z]/g,t=>"_"+t[0].toLowerCase()),g[k]);e.set("callback",c+".maps."+q);a.src=`https://maps.${c}apis.com/maps/api/js?`+e;d[q]=f;a.onerror=()=>h=n(Error(p+" could not load."));a.nonce=m.querySelector("script[nonce]")?.nonce||"";m.head.append(a)}));d[l]?console.warn(p+" only loads once. Ignoring:",g):d[l]=(f,...n)=>r.add(f)&&u().then(()=>d[l](f,...n))}) ({key: "AIzaSyB41DRUbKWJHPxaFjMAwdrzWzbVKartNGg", v: "beta"});</script> </body> </html>
सैंपल आज़माएं
जगह चुनने वाले कॉम्पोनेंट का इस्तेमाल करना
प्लेस पिकर कॉम्पोनेंट एक टेक्स्ट इनपुट होता है. इसकी मदद से असली उपयोगकर्ता, पता या स्थान. यह एक्सटेंडेड कॉम्पोनेंट लाइब्रेरी का हिस्सा है. यह वेब कॉम्पोनेंट का एक सेट है, जिससे डेवलपर को बेहतर मैप और जगह की जानकारी से जुड़ी सुविधाओं को तेज़ी से बनाने में मदद मिलती है.
प्लेस पिकर कॉन्फ़िगरेशनर का इस्तेमाल करें कस्टम प्लेस पिकर कॉम्पोनेंट के लिए एम्बेड किया जा सकने वाला कोड बनाने के लिए, फिर एक्सपोर्ट करें इसे React और Angular जैसे लोकप्रिय फ़्रेमवर्क के साथ या बिना किसी फ़्रेमवर्क के इस्तेमाल किया जाना चाहिए.