Places Widgets

PlaceAutocompleteElement क्लास

google.maps.places.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 पर जाएं. वही तरीका अपनाएं जो इनपुट के लिए 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 कोड से मेल खाते हैं. हालांकि, इसमें कुछ खास अपवाद भी हैं. उदाहरण के लिए, यूनाइटेड किंगडम का ccTLD "uk" (.co.uk) है, जबकि उसका ISO 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
यह सुविधा, सुझाव के तौर पर दिए गए आइटम का मुख्य टेक्स्ट होती है. भौगोलिक जगहों के लिए, इसमें जगह का नाम होता है, जैसे कि 'सिडनी' या सड़क का नाम और नंबर, जैसे कि '10 किंग स्ट्रीट'. डिफ़ॉल्ट रूप से, पूर्वानुमान-आइटम-मुख्य-टेक्स्ट का रंग काला होता है. अगर अनुमान वाले आइटम में कोई अतिरिक्त टेक्स्ट है, तो यह अनुमान-आइटम-मुख्य टेक्स्ट के बाहर होता है और इसकी स्टाइल, अनुमान के आइटम के हिसाब से इनहेरिट करती है. इसका रंग डिफ़ॉल्ट रूप से धूसर होता है. आम तौर पर, अतिरिक्त टेक्स्ट में पता होता है.
prediction-item-match
दिखाए गए सुझाव का वह हिस्सा जो उपयोगकर्ता के इनपुट से मेल खाता है. डिफ़ॉल्ट रूप से, मेल खाने वाला यह टेक्स्ट, बोल्ड टेक्स्ट में हाइलाइट किया जाता है. ध्यान दें कि मेल खाने वाला टेक्स्ट, अनुमान वाले आइटम में कहीं भी हो सकता है. यह ज़रूरी नहीं है कि यह टेक्स्ट अनुमान वाले आइटम के मुख्य टेक्स्ट का हिस्सा हो.
prediction-item-selected
वह आइटम जब उपयोगकर्ता कीबोर्ड से उस पर जाता है. ध्यान दें: चुने गए आइटम पर, इन पार्ट स्टाइल और अनुमान वाले आइटम के पार्ट स्टाइल, दोनों का असर होगा.
prediction-list
वह विज़ुअल एलिमेंट जिसमें, जगहों के अपने-आप पूरे होने की सुविधा के दिखाए गए अनुमानों की सूची शामिल होती है. यह सूची, SpaceAutocompleteElement के नीचे ड्रॉपडाउन के तौर पर दिखती है.
BetaaddEventListener
addEventListener(type, listener[, options])
पैरामीटर: 
  • typestring एक केस-सेंसिटिव (बड़े और छोटे अक्षरों में अंतर) स्ट्रिंग, जो इवेंट टाइप के बारे में बताती है.
  • listenerEventListener|EventListenerObject वह ऑब्जेक्ट जिसे सूचना मिलती है. यह हैंडल इवेंट के तरीके वाला कोई फ़ंक्शन या ऑब्जेक्ट होना चाहिए
  • optionsboolean|AddEventListenerOptions optional विकल्प देखें. कस्टम इवेंट में सिर्फ़ capture और passive का इस्तेमाल किया जा सकता है.
रिटर्न वैल्यू:  void
एक ऐसा फ़ंक्शन सेट अप करता है जिसे टारगेट के लिए तय किया गया इवेंट डिलीवर किए जाने पर कॉल किया जाएगा. addEventListener देखें
BetaremoveEventListener
removeEventListener(type, listener[, options])
पैरामीटर: 
  • typestring एक स्ट्रिंग जिससे इवेंट लिसनर को हटाने के लिए, इवेंट टाइप के बारे में पता चलता है.
  • listenerEventListener|EventListenerObject इवेंट टारगेट से हटाने के लिए, इवेंट हैंडलर का इवेंट लिसनर.
  • optionsboolean|EventListenerOptions optional विकल्प देखें
रिटर्न वैल्यू:  void
टारगेट से, addEventListener के साथ पहले से रजिस्टर किया गया इवेंट लिसनर हटा देता है. removeEventListener देखें
gmp-placeselect
function(placeAutocompletePlaceSelectEvent)
तर्क: 
यह इवेंट तब सक्रिय होता है, जब कोई उपयोगकर्ता किसी जगह का अनुमान चुनता है. इसमें जगह से जुड़ा ऑब्जेक्ट होता है.
gmp-requesterror
function(placeAutocompleteRequestErrorEvent)
तर्क: 
यह इवेंट तब ट्रिगर होता है, जब बैकएंड का कोई अनुरोध अस्वीकार कर दिया जाता है. उदाहरण के लिए, गलत एपीआई पासकोड. इस इवेंट पर बबल नहीं होता है.

PlaceAutocompleteElementOptions इंटरफ़ेस

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

SpaceAutocompleteElement बनाने के विकल्प.

componentRestrictions optional
टाइप:  ComponentRestrictions optional
locationBias optional
टाइप:  LocationBias optional
locationRestriction optional
टाइप:  LocationRestriction optional
requestedLanguage optional
टाइप:  string optional
requestedRegion optional
टाइप:  string optional
types optional
टाइप:  Array<string> optional

PlaceAutocompletePlaceSelectEvent क्लास

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

यह इवेंट तब बन जाता है, जब उपयोगकर्ता जगह के ऑटोकंप्लीट एलिमेंट वाली जगह चुन लेता है. चुने गए आइटम को event.place की मदद से ऐक्सेस करें.

इस क्लास में Event को शामिल किया जाता है.

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

Betaplace
टाइप:  Place

PlaceAutocompleteRequestErrorEvent क्लास

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

नेटवर्क अनुरोध में कोई समस्या होने पर, प्लेसमेंट ऑटोकंप्लीट एलिमेंट से यह इवेंट भेजा जाता है.

इस क्लास में 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])
पैरामीटर: 
  • inputFieldHTMLInputElement <input> टेक्स्ट फ़ील्ड, जिससे Autocomplete अटैच किया जाना चाहिए.
  • optsAutocompleteOptions optional विकल्प.
Autocomplete का एक नया इंस्टेंस बनाता है, जो दिए गए विकल्पों के साथ बताए गए इनपुट टेक्स्ट फ़ील्ड से जुड़ जाता है.
getBounds
getBounds()
पैरामीटर: कोई नहीं
रिटर्न वैल्यू:  LatLngBounds|undefined मापदंड से जुड़ी सीमाएं.
उन सीमाओं को दिखाता है जिनसे जुड़े अनुमान भेदभाव वाले होते हैं.
getFields
getFields()
पैरामीटर: कोई नहीं
रिटर्न वैल्यू:  Array<string>|undefined
सही तरीके से जानकारी मिलने के बाद, जानकारी के जवाब में जगह के लिए शामिल की जाने वाली फ़ील्ड की जानकारी देता है. फ़ील्ड की सूची के लिए, PlaceResult देखें.
getPlace
getPlace()
पैरामीटर: कोई नहीं
लौटाए जाने वाले प्रॉडक्ट की वैल्यू:  PlaceResult वह जगह जिसे उपयोगकर्ता ने चुना है.
अगर जगह की जानकारी वापस मिल जाती है, तो उपयोगकर्ता की चुनी गई जगह की जानकारी दिखाता है. ऐसा न होने पर, स्टब प्लेस ऑब्जेक्ट दिखता है, जिसमें name प्रॉपर्टी को इनपुट फ़ील्ड की मौजूदा वैल्यू पर सेट किया जाता है.
setBounds
setBounds(bounds)
पैरामीटर: 
रिटर्न वैल्यू: कोई नहीं
जगह के नतीजे दिखाने के लिए पसंदीदा जगह सेट करता है. नतीजे इस क्षेत्र के पक्ष में होते हैं, लेकिन इन तक सीमित नहीं होते.
setComponentRestrictions
setComponentRestrictions(restrictions)
पैरामीटर: 
  • restrictionsComponentRestrictions optional इस्तेमाल करने की सीमाएं.
रिटर्न वैल्यू: कोई नहीं
कॉम्पोनेंट की पाबंदियां सेट करता है. कॉम्पोनेंट से जुड़ी पाबंदियों का इस्तेमाल करके, सिर्फ़ पैरंट कॉम्पोनेंट के अनुमानों को सीमित किया जाता है. उदाहरण के लिए, देश.
setFields
setFields(fields)
पैरामीटर: 
  • fieldsArray<string> optional
रिटर्न वैल्यू: कोई नहीं
जानकारी पूरी तरह से मिल जाने के बाद, जानकारी के जवाब में जगह के लिए शामिल किए जाने वाले फ़ील्ड सेट करता है. फ़ील्ड की सूची के लिए, PlaceResult देखें.
setOptions
setOptions(options)
पैरामीटर: 
रिटर्न वैल्यू: कोई नहीं
setTypes
setTypes(types)
पैरामीटर: 
  • typesArray<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
सिर्फ़ जगह के आईडी पाना है या नहीं. Places_बदलने वाले इवेंट के चालू होने पर, दिए गए प्लेसमेंट के नतीजे में सिर्फ़ प्लेसमेंट_आईडी, टाइप, और नाम वाले फ़ील्ड होंगे. इनमें अपने-आप पूरे होने वाली सेवा से मिली प्लेसमेंट और जानकारी के साथ प्लेसमेंट_आईडी भी शामिल होंगे. डिफ़ॉल्ट रूप से बंद होता है.
strictBounds optional
टाइप:  boolean optional
एक बूलियन वैल्यू, जो दिखाती है कि ऑटोकंप्लीट विजेट को सिर्फ़ उन जगहों की जानकारी देनी चाहिए जो क्वेरी भेजते समय ऑटोकंप्लीट विजेट की सीमा के अंदर हैं. सख्तसीमाओं को 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
वह क्षेत्र जिसकी ओर क्वेरी के अनुमानों को पूर्वाग्रह करना है. अनुमान, इन सीमाओं को टारगेट करने वाली क्वेरी के प्रति पक्षपात करते हैं. हालांकि, ये इन तक ही सीमित नहीं होते हैं.