Places Widgets

PlaceAutocompleteElement class

google.maps.places.PlaceAutocompleteElement क्लास

PlaceAutocompleteElement एक HTMLElement सबक्लास है, जो Places Autocomplete API के लिए यूज़र इंटरफ़ेस (यूआई) कॉम्पोनेंट उपलब्ध कराता है.

कस्टम एलिमेंट:
<gmp-place-autocomplete name="string" requested-language="string" requested-region="string" types="type1 type2 type3..."></gmp-place-autocomplete>

यह क्लास HTMLElement तक चलेगी.

इस क्लास में PlaceAutocompleteElementOptions लागू होता है.

const {PlaceAutocompleteElement} = await google.maps.importLibrary("places") को कॉल करके ऐक्सेस करें. Maps JavaScript API में लाइब्रेरी देखें.
PlaceAutocompleteElement
PlaceAutocompleteElement(options)
पैरामीटर: 
componentRestrictions
टाइप:  ComponentRestrictions optional
कॉम्पोनेंट से जुड़ी पाबंदियां. कॉम्पोनेंट की पाबंदियों का इस्तेमाल, सिर्फ़ पैरंट कॉम्पोनेंट में मौजूद प्रॉडक्ट के लिए अनुमान दिखाने के लिए किया जाता है. उदाहरण के लिए, देश.
locationBias
टाइप:  LocationBias optional
जगहें खोजते समय इस्तेमाल करने के लिए, सॉफ्ट बाउंड्री या हिंट.
locationRestriction
टाइप:  LocationRestriction optional
खोज के नतीजों को सीमित करने के लिए सीमाएं.
name
टाइप:  string optional
इनपुट एलिमेंट के लिए इस्तेमाल किया जाने वाला नाम. ज़्यादा जानकारी के लिए, https://developer.mozilla.org/en-US/docs/Web/HTML/Element/input#name पर जाएं. इनपुट के लिए नाम एट्रिब्यूट की तरह ही काम करता है. ध्यान दें कि फ़ॉर्म सबमिट करने पर, इस नाम का इस्तेमाल किया जाएगा. ज़्यादा जानकारी के लिए, https://developer.mozilla.org/en-US/docs/Web/HTML/Element/form देखें.
एचटीएमएल एट्रिब्यूट:
  • <gmp-placeautocomplete name="string"></gmp-placeautocomplete>
requestedLanguage
टाइप:  string optional
उस भाषा का आइडेंटिफ़ायर जिसमें नतीजे दिखाए जाने चाहिए. हालांकि, ऐसा ज़रूरी नहीं है. चुनी गई भाषा में मौजूद नतीजों को ज़्यादा रैंकिंग दी जा सकती है. हालांकि, सुझाव सिर्फ़ इस भाषा में नहीं मिलते. इस्तेमाल की जा सकने वाली भाषाओं की सूची देखें.
एचटीएमएल एट्रिब्यूट:
  • <gmp-place-autocomplete requested-language="string"></gmp-place-autocomplete>
requestedRegion
टाइप:  string optional
क्षेत्र का कोड, जिसका इस्तेमाल नतीजे को फ़ॉर्मैट करने और नतीजे को फ़िल्टर करने के लिए किया जाता है. इससे, सुझावों पर इस देश की पाबंदी नहीं होती. क्षेत्र कोड में, ccTLD ("टॉप लेवल डोमेन") की दो वर्णों वाली वैल्यू डाली जा सकती है. ccTLD के ज़्यादातर कोड, ISO 3166-1 कोड से मेल खाते हैं. हालांकि, कुछ कोड अलग होते हैं. उदाहरण के लिए, यूनाइटेड किंगडम का सीसीटीएलडी "uk" (.co.uk) है, जबकि इसका आईएसओ 3166-1 कोड "gb" है. तकनीकी तौर पर, यह कोड "यूनाइटेड किंगडम ऑफ़ ग्रेट ब्रिटेन ऐंड नॉर्दर्न आयरलैंड" की इकाई के लिए है.
एचटीएमएल एट्रिब्यूट:
  • <gmp-place-autocomplete requested-region="string"></gmp-place-autocomplete>
types
टाइप:  Array<string> optional
दिखाए जाने वाले अनुमान के टाइप. इस्तेमाल किए जा सकने वाले टाइप के बारे में जानने के लिए, डेवलपर गाइड देखें. अगर कोई टाइप नहीं दिया गया है, तो सभी टाइप दिखाए जाएंगे.
एचटीएमएल एट्रिब्यूट:
  • <gmp-place-autocomplete types="type1 type2 type3..."></gmp-place-autocomplete>
prediction-item
अनुमान के ड्रॉप-डाउन में मौजूद एक आइटम, जो एक अनुमान दिखाता है.
prediction-item-icon
सुझावों की सूची में हर आइटम की बाईं ओर दिखने वाला आइकॉन.
prediction-item-main-text
prediction-item का वह हिस्सा जो अनुमान का मुख्य टेक्स्ट होता है. भौगोलिक जगहों के लिए, इसमें जगह का नाम, जैसे कि 'सिडनी' या सड़क का नाम और नंबर, जैसे कि '10 किंग स्ट्रीट' शामिल होता है. डिफ़ॉल्ट रूप से, prediction-item-main-text का रंग काला होता है. अगर prediction-item में कोई अन्य टेक्स्ट है, तो वह prediction-item-main-text से बाहर होता है और उसकी स्टाइल, prediction-item से इनहेरिट होती है. यह डिफ़ॉल्ट रूप से स्लेटी रंग का होता है. आम तौर पर, अतिरिक्त टेक्स्ट कोई पता होता है.
prediction-item-match
अनुमान का वह हिस्सा जो उपयोगकर्ता के इनपुट से मेल खाता है. डिफ़ॉल्ट रूप से, मैच होने वाला यह टेक्स्ट बोल्ड टेक्स्ट में हाइलाइट किया जाता है. ध्यान दें कि मैच होने वाला टेक्स्ट, prediction-item में कहीं भी हो सकता है. यह ज़रूरी नहीं है कि यह prediction-item-main-text का हिस्सा हो.
prediction-item-selected
वह आइटम जिस पर उपयोगकर्ता कीबोर्ड की मदद से नेविगेट करता है. ध्यान दें: चुने गए आइटम पर, इस हिस्से की स्टाइल और अनुमानित आइटम के हिस्से की स्टाइल, दोनों का असर पड़ेगा.
prediction-list
विज़ुअल एलिमेंट, जिसमें जगह की जानकारी के लिए ऑटोकंप्लीट की सुविधा से मिले सुझावों की सूची होती है. यह सूची, PlaceAutocompleteElement के नीचे ड्रॉपडाउन सूची के तौर पर दिखती है.
BetaaddEventListener
addEventListener(type, listener[, options])
पैरामीटर: 
  • type:  string केस-सेंसिटिव स्ट्रिंग, जो उस इवेंट टाइप को दिखाती है जिसे सुनना है.
  • listener:  EventListener|EventListenerObject वह ऑब्जेक्ट जिसे सूचना मिलती है. यह handleEvent तरीके वाला कोई फ़ंक्शन या ऑब्जेक्ट होना चाहिए
  • options:  boolean|AddEventListenerOptions optional विकल्प देखें. कस्टम इवेंट सिर्फ़ capture और passive के साथ काम करते हैं.
रिटर्न वैल्यू:  void
यह एक फ़ंक्शन सेट अप करता है, जिसे टारगेट पर तय इवेंट डिलीवर होने पर कॉल किया जाएगा. addEventListener देखें
BetaremoveEventListener
removeEventListener(type, listener[, options])
पैरामीटर: 
  • type:  string वह स्ट्रिंग जो उस इवेंट टाइप के बारे में बताती है जिसके लिए इवेंट लिसनर को हटाना है.
  • listener:  EventListener|EventListenerObject इवेंट टारगेट से हटाने के लिए, इवेंट हैंडलर का इवेंट लिसनर.
  • options:  boolean|EventListenerOptions optional विकल्प देखें
रिटर्न वैल्यू:  void
टारगेट से, पहले से addEventListener के साथ रजिस्टर किए गए इवेंट लिसनर को हटाता है. removeEventListener देखें
gmp-placeselect
function(placeAutocompletePlaceSelectEvent)
आर्ग्युमेंट: 
यह इवेंट तब ट्रिगर होता है, जब कोई उपयोगकर्ता जगह का सुझाव चुनता है. इसमें जगह की जानकारी वाला ऑब्जेक्ट होता है.
gmp-requesterror
function(placeAutocompleteRequestErrorEvent)
आर्ग्युमेंट: 
यह इवेंट तब ट्रिगर होता है, जब बैकएंड के लिए किए गए अनुरोध को अस्वीकार कर दिया जाता है. जैसे, गलत एपीआई पासकोड. यह इवेंट बबल नहीं करता.

PlaceAutocompleteElementOptions इंटरफ़ेस

google.maps.places.PlaceAutocompleteElementOptions इंटरफ़ेस

PlaceAutocompleteElement बनाने के विकल्प.
componentRestrictions optional
टाइप:  ComponentRestrictions optional
PlaceAutocompleteElement.componentRestrictions देखें
locationBias optional
टाइप:  LocationBias optional
PlaceAutocompleteElement.locationBias देखें
locationRestriction optional
टाइप:  LocationRestriction optional
PlaceAutocompleteElement.locationRestriction देखें
requestedLanguage optional
टाइप:  string optional
PlaceAutocompleteElement.requestedLanguage देखें
requestedRegion optional
टाइप:  string optional
PlaceAutocompleteElement.requestedRegion देखें
types optional
टाइप:  Array<string> optional
PlaceAutocompleteElement.types देखें

PlaceAutocompletePlaceSelectEvent class

google.maps.places.PlaceAutocompletePlaceSelectEvent क्लास

यह इवेंट तब बनता है, जब उपयोगकर्ता किसी जगह के शुरुआती अक्षर लिखने पर पूरा नाम सुझाने की सुविधा का इस्तेमाल करके कोई जगह चुनता है. चुने गए टेक्स्ट को event.place से ऐक्सेस करें.

यह क्लास Event तक चलेगी.

const {PlaceAutocompletePlaceSelectEvent} = await google.maps.importLibrary("places") को कॉल करके ऐक्सेस करें. Maps JavaScript API में लाइब्रेरी देखें.
Betaplace
टाइप:  Place

PlaceAutocompleteRequestErrorEvent class

google.maps.places.PlaceAutocompleteRequestErrorEvent क्लास

नेटवर्क अनुरोध में कोई समस्या होने पर, PlaceAutocompleteElement से यह इवेंट उत्सर्जित होता है.

यह क्लास Event तक चलेगी.

const {PlaceAutocompleteRequestErrorEvent} = await google.maps.importLibrary("places") को कॉल करके ऐक्सेस करें. Maps JavaScript API में लाइब्रेरी देखें.

ऑटोकंप्लीट क्लास

google.maps.places.Autocomplete क्लास

ऐसा विजेट जो उपयोगकर्ता के टेक्स्ट इनपुट के आधार पर, जगह के सुझाव देता है. यह text टाइप के इनपुट एलिमेंट से जुड़ता है और उस फ़ील्ड में टेक्स्ट डालने पर सुनता है. अनुमान की सूची, ड्रॉप-डाउन सूची के तौर पर दिखाई जाती है. टेक्स्ट डालने पर, यह सूची अपडेट हो जाती है.

यह क्लास MVCObject तक चलेगी.

const {Autocomplete} = await google.maps.importLibrary("places") को कॉल करके ऐक्सेस करें. Maps JavaScript API में लाइब्रेरी देखें.
Autocomplete
Autocomplete(inputField[, opts])
पैरामीटर: 
  • inputField:  HTMLInputElement वह <input> टेक्स्ट फ़ील्ड जिसमें Autocomplete को अटैच करना है.
  • opts:  AutocompleteOptions optional विकल्प.
Autocomplete का एक नया इंस्टेंस बनाता है, जो दिए गए विकल्पों के साथ दिए गए इनपुट टेक्स्ट फ़ील्ड से जुड़ा होता है.
getBounds
getBounds()
पैरामीटर:  कोई नहीं
रिटर्न वैल्यू:  LatLngBounds|undefined बायसिंग बाउंड.
उन सीमाओं की जानकारी देता है जिनमें अनुमान पक्षपातपूर्ण हैं.
getFields
getFields()
पैरामीटर:  कोई नहीं
रिटर्न वैल्यू:  Array<string>|undefined
जानकारी वापस पाने के बाद, जगह की जानकारी वाले रिस्पॉन्स में शामिल किए जाने वाले फ़ील्ड दिखाता है. फ़ील्ड की सूची देखने के लिए, PlaceResult देखें.
getPlace
getPlace()
पैरामीटर:  कोई नहीं
रिटर्न वैल्यू:  PlaceResult उपयोगकर्ता की चुनी गई जगह.
अगर जगह की जानकारी मिल जाती है, तो उपयोगकर्ता की चुनी गई जगह की जानकारी दिखाता है. ऐसा न होने पर, यह एक स्टब प्लेस ऑब्जेक्ट दिखाता है. इसमें name प्रॉपर्टी, इनपुट फ़ील्ड की मौजूदा वैल्यू पर सेट होती है.
setBounds
setBounds(bounds)
पैरामीटर: 
रिटर्न वैल्यू:  कोई नहीं
जगह के नतीजे दिखाने के लिए, पसंदीदा इलाके को सेट करता है. नतीजे इस क्षेत्र के हिसाब से होते हैं. हालांकि, यह सिर्फ़ इस क्षेत्र तक ही सीमित नहीं है.
setComponentRestrictions
setComponentRestrictions(restrictions)
पैरामीटर: 
  • restrictions:  ComponentRestrictions optional इस्तेमाल से जुड़ी पाबंदियां.
रिटर्न वैल्यू:  कोई नहीं
कॉम्पोनेंट की पाबंदियां सेट करता है. कॉम्पोनेंट की पाबंदियों का इस्तेमाल, सिर्फ़ पैरंट कॉम्पोनेंट में मौजूद प्रॉडक्ट के लिए अनुमान दिखाने के लिए किया जाता है. उदाहरण के लिए, देश.
setFields
setFields(fields)
पैरामीटर: 
  • fields:  Array<string> optional
रिटर्न वैल्यू:  कोई नहीं
जगह की जानकारी पाने के बाद, उसमें शामिल किए जाने वाले फ़ील्ड सेट करता है. फ़ील्ड की सूची देखने के लिए, PlaceResult देखें.
setOptions
setOptions(options)
पैरामीटर: 
रिटर्न वैल्यू:  कोई नहीं
setTypes
setTypes(types)
पैरामीटर: 
  • types:  Array<string> optional शामिल किए जाने वाले सुझावों के टाइप.
रिटर्न वैल्यू:  कोई नहीं
यह सेटिंग, दिखाए जाने वाले अनुमान के टाइप तय करती है. इस्तेमाल किए जा सकने वाले टाइप के बारे में जानने के लिए, डेवलपर गाइड देखें. अगर कोई टाइप नहीं दिया गया है, तो सभी टाइप दिखाए जाएंगे.
इनहेरिट किया गया: addListener, bindTo, get, notify, set, setValues, unbind, unbindAll
place_changed
function()
आर्ग्युमेंट:  कोई नहीं
यह इवेंट तब ट्रिगर होता है, जब उपयोगकर्ता की चुनी गई जगह के लिए PlaceResult उपलब्ध कराया जाता है.
अगर उपयोगकर्ता ने किसी ऐसी जगह का नाम डाला है जिसका सुझाव कंट्रोल से नहीं मिला था और Enter दबाया है या जगह की जानकारी का अनुरोध पूरा नहीं हो पाया है, तो PlaceResult में name प्रॉपर्टी में उपयोगकर्ता का इनपुट शामिल होता है. इसमें कोई दूसरी प्रॉपर्टी तय नहीं होती.

AutocompleteOptions इंटरफ़ेस

google.maps.places.AutocompleteOptions इंटरफ़ेस

Autocomplete ऑब्जेक्ट पर सेट किए जा सकने वाले विकल्प.
bounds optional
टाइप:  LatLngBounds|LatLngBoundsLiteral optional
वह इलाका जहां जगहें खोजनी हैं.
componentRestrictions optional
टाइप:  ComponentRestrictions optional
कॉम्पोनेंट से जुड़ी पाबंदियां. कॉम्पोनेंट की पाबंदियों का इस्तेमाल, सिर्फ़ पैरंट कॉम्पोनेंट में मौजूद प्रॉडक्ट के लिए अनुमान दिखाने के लिए किया जाता है. उदाहरण के लिए, देश.
fields optional
टाइप:  Array<string> optional
जगह की जानकारी पाने के बाद, उसमें शामिल किए जाने वाले फ़ील्ड. इनके लिए शुल्क लिया जाएगा. अगर ['ALL'] को पास किया जाता है, तो सभी उपलब्ध फ़ील्ड दिखाए जाएंगे और उनका बिल भेजा जाएगा. हालांकि, प्रोडक्शन डिप्लॉयमेंट के लिए इसका सुझाव नहीं दिया जाता. फ़ील्ड की सूची देखने के लिए, PlaceResult देखें. नेस्ट किए गए फ़ील्ड को बिंदु-पाथ (उदाहरण के लिए, "geometry.location") से दिखाया जा सकता है. डिफ़ॉल्ट रूप से, ['ALL'] का इस्तेमाल किया जाता है.
placeIdOnly optional
टाइप:  boolean optional
सिर्फ़ जगह के आईडी वापस लाने हैं या नहीं. place_changed इवेंट ट्रिगर होने पर उपलब्ध कराए गए PlaceResult में सिर्फ़ place_id, टाइप, और नाम फ़ील्ड होंगे. इनमें, ऑटोमैटिक तरीके से जानकारी भरने की सुविधा से मिले place_id, टाइप, और ब्यौरा शामिल होगा. डिफ़ॉल्ट रूप से बंद रहता है.
strictBounds optional
टाइप:  boolean optional
बूलियन वैल्यू, जो बताती है कि ऑटोकंप्लीट विजेट को सिर्फ़ उन जगहों की जानकारी दिखानी चाहिए जो क्वेरी भेजे जाने के समय, ऑटोकंप्लीट विजेट की सीमाओं के अंदर हों. strictBounds को false (डिफ़ॉल्ट) पर सेट करने से, नतीजे सिर्फ़ उन जगहों के लिए दिखाए जाएंगे जो सीमाओं में शामिल हैं. हालांकि, ऐसा ज़रूरी नहीं है कि नतीजे सिर्फ़ उन जगहों के लिए दिखाए जाएं.
types optional
टाइप:  Array<string> optional
दिखाए जाने वाले अनुमान के टाइप. इस्तेमाल किए जा सकने वाले टाइप के बारे में जानने के लिए, डेवलपर गाइड देखें. अगर कोई टाइप नहीं दिया गया है, तो सभी टाइप दिखाए जाएंगे.

google.maps.places.SearchBox क्लास

यह एक ऐसा विजेट है जो उपयोगकर्ता के टेक्स्ट इनपुट के आधार पर, क्वेरी के अनुमान दिखाता है. यह text टाइप के इनपुट एलिमेंट से जुड़ता है और उस फ़ील्ड में टेक्स्ट डालने पर सुनता है. अनुमान की सूची, ड्रॉप-डाउन सूची के तौर पर दिखाई जाती है. टेक्स्ट डालने पर, यह सूची अपडेट हो जाती है.

यह क्लास MVCObject तक चलेगी.

const {SearchBox} = await google.maps.importLibrary("places") को कॉल करके ऐक्सेस करें. Maps JavaScript API में लाइब्रेरी देखें.
SearchBox
SearchBox(inputField[, opts])
पैरामीटर: 
SearchBox का एक नया इंस्टेंस बनाता है, जो दिए गए विकल्पों के साथ दिए गए इनपुट टेक्स्ट फ़ील्ड से जुड़ा होता है.
getBounds
getBounds()
पैरामीटर:  कोई नहीं
रिटर्न वैल्यू:  LatLngBounds|undefined
उन सीमाओं की जानकारी देता है जिनमें क्वेरी के अनुमान पक्षपात के साथ दिए गए हैं.
getPlaces
getPlaces()
पैरामीटर:  कोई नहीं
रिटर्न वैल्यू:  Array<PlaceResult>|undefined
places_changed इवेंट के साथ इस्तेमाल करने के लिए, उपयोगकर्ता की चुनी गई क्वेरी दिखाता है.
setBounds
setBounds(bounds)
पैरामीटर: 
रिटर्न वैल्यू:  कोई नहीं
क्वेरी के अनुमान को बायस करने के लिए, इस्तेमाल किए जाने वाले इलाके को सेट करता है. हालांकि, नतीजे सिर्फ़ इस इलाके के हिसाब से ही नहीं होंगे.
इनहेरिट किया गया: addListener, bindTo, get, notify, set, setValues, unbind, unbindAll
places_changed
function()
आर्ग्युमेंट:  कोई नहीं
यह इवेंट तब ट्रिगर होता है, जब कोई उपयोगकर्ता कोई क्वेरी चुनता है. नई जगहों की जानकारी पाने के लिए, getPlaces का इस्तेमाल किया जाना चाहिए.

SearchBoxOptions इंटरफ़ेस

google.maps.places.SearchBoxOptions इंटरफ़ेस

SearchBox ऑब्जेक्ट पर सेट किए जा सकने वाले विकल्प.
bounds optional
टाइप:  LatLngBounds|LatLngBoundsLiteral optional
वह इलाका जहां क्वेरी के अनुमान को प्राथमिकता दी जानी है. अनुमान, इन सीमाओं को टारगेट करने वाली क्वेरी के हिसाब से होते हैं. हालांकि, ये सिर्फ़ इन क्वेरी तक ही सीमित नहीं होते.