Places Autocomplete Service

AutocompleteService क्लास

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

इसमें ऑटोकंप्लीट सुविधा की मदद से मिलने वाले सुझावों को वापस पाने से जुड़े तरीके शामिल हैं.

const {AutocompleteService} = await google.maps.importLibrary("places") पर कॉल करके ऐक्सेस करें.
Maps JavaScript API में मौजूद लाइब्रेरी देखें.
AutocompleteService
AutocompleteService()
पैरामीटर:  कोई नहीं
यह AutocompleteService का नया इंस्टेंस बनाता है.
getPlacePredictions
getPlacePredictions(request[, callback])
पैरामीटर: 
  • request:  AutocompletionRequest ऑटोकंप्लीट करने का अनुरोध.
  • callback:  function(Array<AutocompletePrediction> optional, PlacesServiceStatus): void optional यह एक कॉलबैक है. यह AutocompletePrediction ऑब्जेक्ट के कलेक्शन और PlacesServiceStatus वैल्यू को आर्ग्युमेंट के तौर पर स्वीकार करता है.
लौटाई गई वैल्यू:  Promise<AutocompleteResponse>
यह ऑटोकंप्लीट के अनुरोध के आधार पर, जगह के नाम अपने-आप पूरे होने के सुझाव वापस लाता है.
getQueryPredictions
getQueryPredictions(request, callback)
पैरामीटर: 
  • request:  QueryAutocompletionRequest क्वेरी अपने-आप पूरी होने का अनुरोध.
  • callback:  function(Array<QueryAutocompletePrediction> optional, PlacesServiceStatus): void यह एक कॉलबैक है. यह QueryAutocompletePrediction ऑब्जेक्ट के कलेक्शन और PlacesServiceStatus वैल्यू को आर्ग्युमेंट के तौर पर स्वीकार करता है.
रिटर्न वैल्यू:  कोई नहीं
यह ऑटोकंप्लीट की सुविधा की मदद से क्वेरी के लिए सुझाव पाने के अनुरोध के आधार पर, ऑटोकंप्लीट की सुविधा की मदद से क्वेरी के लिए सुझाव वापस लाता है.

AutocompletionRequest इंटरफ़ेस

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

AutocompleteService.getPlacePredictions को अपने-आप पूरा होने का अनुरोध भेजा जाएगा.
input
टाइप:  string
उपयोगकर्ता ने इनपुट स्ट्रिंग डाली है.
bounds optional
टाइप:  LatLngBounds|LatLngBoundsLiteral optional
पूर्वानुमान में पक्षपात को रोकने के लिए सीमाएं. पूर्वानुमान, दिए गए bounds के हिसाब से लगाए जाएंगे. हालांकि, ये सिर्फ़ bounds तक सीमित नहीं होंगे. अगर bounds एट्रिब्यूट की वैल्यू सेट की जाती है, तो location और radius, दोनों एट्रिब्यूट की वैल्यू को अनदेखा कर दिया जाएगा.
componentRestrictions optional
टाइप:  ComponentRestrictions optional
कॉम्पोनेंट से जुड़ी पाबंदियां. कॉम्पोनेंट की पाबंदियों का इस्तेमाल, अनुमानों को सिर्फ़ पैरंट कॉम्पोनेंट तक सीमित करने के लिए किया जाता है. उदाहरण के लिए, देश.
language optional
टाइप:  string optional
अगर हो सके, तो उस भाषा के लिए आइडेंटिफ़ायर जिसमें नतीजे दिखाए जाने चाहिए. चुनी गई भाषा में मिले नतीजों को बेहतर रैंकिंग दी जा सकती है. हालांकि, सुझाव सिर्फ़ इसी भाषा में नहीं दिए जाते. इस्तेमाल की जा सकने वाली भाषाओं की सूची देखें.
location optional
टाइप:  LatLng optional
पूर्वानुमान को किसी खास जगह के हिसाब से बनाने के लिए इस्तेमाल की जाने वाली जगह की जानकारी. अनुमान, दिए गए location और radius के हिसाब से लगाए जाएंगे. इसके अलावा, bounds का इस्तेमाल किया जा सकता है.
locationBias optional
टाइप:  LocationBias optional
जगहें खोजते समय इस्तेमाल करने के लिए, एक सॉफ्ट बाउंड्री या हिंट.
locationRestriction optional
टाइप:  LocationRestriction optional
खोज के नतीजों को सीमित करने के लिए सीमाएं.
offset optional
टाइप:  number optional
इनपुट शब्द में वह जगह जहां सेवा, अनुमान लगाने के लिए टेक्स्ट का इस्तेमाल करती है (इनपुट फ़ील्ड में कर्सर की जगह).
origin optional
टाइप:  LatLng|LatLngLiteral optional
वह जगह जहां से AutocompletePrediction.distance_meters का हिसाब लगाया जाता है.
radius optional
टाइप:  number optional
पूर्वानुमान को पक्षपाती बनाने के लिए इस्तेमाल किए गए इलाके का दायरा. radius को मीटर में बताया जाता है. साथ ही, इसके साथ हमेशा location प्रॉपर्टी होनी चाहिए. इसके अलावा, bounds का इस्तेमाल किया जा सकता है.
region optional
टाइप:  string optional
यह एक क्षेत्र का कोड होता है. इसका इस्तेमाल, नतीजों को फ़ॉर्मैट करने और उन्हें फ़िल्टर करने के लिए किया जाता है. इससे इस देश के लिए सुझावों को सीमित नहीं किया जाता. क्षेत्र के कोड में, दो वर्णों वाली ccTLD ("टॉप-लेवल डोमेन") वैल्यू डाली जा सकती है. ज़्यादातर ccTLD कोड, ISO 3166-1 कोड के जैसे ही होते हैं. हालांकि, कुछ अपवाद भी हैं. उदाहरण के लिए, यूनाइटेड किंगडम का ccTLD "uk" (.co.uk) है, जबकि इसका ISO 3166-1 कोड "gb" है. तकनीकी तौर पर, यह "ग्रेट ब्रिटेन और उत्तरी आयरलैंड का यूनाइटेड किंगडम" के लिए है.
sessionToken optional
टाइप:  AutocompleteSessionToken optional
इस यूनीक रेफ़रंस का इस्तेमाल, अलग-अलग अनुरोधों को सेशन में बंडल करने के लिए किया जाता है.
types optional
टाइप:  Array<string> optional
अनुमानों के टाइप जिन्हें दिखाना है. साथ काम करने वाले टाइप के बारे में जानने के लिए, डेवलपर गाइड देखें. अगर कोई टाइप नहीं दिया गया है, तो सभी टाइप दिखाए जाएंगे.

AutocompleteResponse इंटरफ़ेस

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

AutocompleteService.getPlacePredictions को कॉल करने पर, अपने-आप पूरा होने की सुविधा से मिला जवाब. इसमें AutocompleteService.getPlacePredictions की सूची शामिल होती है.AutocompletePrediction
predictions
टाइप:  Array<AutocompletePrediction>
AutocompletePrediction की सूची.

QueryAutocompletionRequest इंटरफ़ेस

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

QueryAutocompleteService को QueryAutocompletion अनुरोध भेजा जाना है.
input
टाइप:  string
उपयोगकर्ता ने इनपुट स्ट्रिंग डाली है.
bounds optional
टाइप:  LatLngBounds|LatLngBoundsLiteral optional
पूर्वानुमान में पक्षपात को रोकने के लिए सीमाएं. पूर्वानुमान, दिए गए bounds के हिसाब से लगाए जाएंगे. हालांकि, ये सिर्फ़ bounds तक सीमित नहीं होंगे. अगर bounds एट्रिब्यूट की वैल्यू सेट की जाती है, तो location और radius, दोनों एट्रिब्यूट की वैल्यू को अनदेखा कर दिया जाएगा.
location optional
टाइप:  LatLng optional
पूर्वानुमान को किसी खास जगह के हिसाब से बनाने के लिए इस्तेमाल की जाने वाली जगह की जानकारी. अनुमान, दिए गए location और radius के हिसाब से लगाए जाएंगे. इसके अलावा, bounds का इस्तेमाल किया जा सकता है.
offset optional
टाइप:  number optional
इनपुट शब्द में वह जगह जहां सेवा, अनुमान लगाने के लिए टेक्स्ट का इस्तेमाल करती है (इनपुट फ़ील्ड में कर्सर की जगह).
radius optional
टाइप:  number optional
पूर्वानुमान को पक्षपाती बनाने के लिए इस्तेमाल किए गए इलाके का दायरा. radius को मीटर में बताया जाता है. साथ ही, इसके साथ हमेशा location प्रॉपर्टी होनी चाहिए. इसके अलावा, bounds का इस्तेमाल किया जा सकता है.

ComponentRestrictions इंटरफ़ेस

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

यह कॉम्पोनेंट की उन पाबंदियों के बारे में बताता है जिनका इस्तेमाल, ऑटोकंप्लीट सेवा के साथ किया जा सकता है.
country optional
टाइप:  string|Array<string> optional
इस पैरामीटर का इस्तेमाल करके, अनुमानों को सिर्फ़ चुने गए देश तक सीमित किया जा सकता है. इसके लिए, ISO 3166-1 Alpha-2 फ़ॉर्मैट में देश का कोड डालें. यह कोड केस-सेंसिटिव नहीं होता. उदाहरण के लिए, 'us', 'br' या 'au'. एक या ज़्यादा से ज़्यादा पांच देशों के कोड की स्ट्रिंग दी जा सकती हैं.

AutocompletePrediction इंटरफ़ेस

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

यह ऑटोकंप्लीट की सुविधा से मिलने वाले एक सुझाव को दिखाता है.
description
टाइप:  string
यह Places सेवा की ओर से सुझाई गई क्वेरी का बिना फ़ॉर्मैट किया गया वर्शन है.
matched_substrings
टाइप:  Array<PredictionSubstring>
जगह की जानकारी में मौजूद सबस्ट्रिंग का ऐसा सेट जो उपयोगकर्ता के इनपुट में मौजूद एलिमेंट से मेल खाता हो. इसका इस्तेमाल उन सबस्ट्रिंग को हाइलाइट करने के लिए किया जा सकता है. हर सबस्ट्रिंग की पहचान, ऑफ़सेट और लंबाई से की जाती है. इसे यूनिकोड वर्णों में दिखाया जाता है.
place_id
टाइप:  string
यह एक प्लेस आईडी है. इसका इस्तेमाल, जगह की जानकारी देने वाली सेवा (PlacesService.getDetails देखें) का इस्तेमाल करके, इस जगह के बारे में जानकारी पाने के लिए किया जा सकता है.
structured_formatting
टाइप:  StructuredFormatting
जगह के ब्यौरे के बारे में स्ट्रक्चर्ड जानकारी. इसे मुख्य टेक्स्ट और सेकंडरी टेक्स्ट में बांटा गया है. इसमें ऑटोकंप्लीट इनपुट से मैच करने वाले सबस्ट्रिंग की एक ऐरे भी शामिल है. इसे ऑफ़सेट और लंबाई से पहचाना जाता है. इसे यूनिकोड वर्णों में दिखाया जाता है.
terms
टाइप:  Array<PredictionTerm>
ऊपर दिए गए ब्यौरे में शामिल अलग-अलग शब्दों के बारे में जानकारी. इसमें सबसे ज़्यादा से लेकर सबसे कम खास जानकारी शामिल है. उदाहरण के लिए, "Taco Bell", "Willits", और "CA".
types
टाइप:  Array<string>
यह एक ऐरे है, जिसमें सुझाव के टाइप शामिल होते हैं. उदाहरण के लिए, 'establishment' या 'geocode'.
distance_meters optional
टाइप:  number optional
जगह की AutocompletionRequest.origin से दूरी, मीटर में.

QueryAutocompletePrediction इंटरफ़ेस

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

यह क्वेरी ऑटोकंप्लीट की सुविधा से मिलने वाले एक सुझाव को दिखाता है.
description
टाइप:  string
यह Places सेवा की ओर से सुझाई गई क्वेरी का बिना फ़ॉर्मैट किया गया वर्शन है.
matched_substrings
टाइप:  Array<PredictionSubstring>
जगह की जानकारी में मौजूद सबस्ट्रिंग का ऐसा सेट जो उपयोगकर्ता के इनपुट में मौजूद एलिमेंट से मेल खाता हो. इसका इस्तेमाल उन सबस्ट्रिंग को हाइलाइट करने के लिए किया जा सकता है. हर सबस्ट्रिंग की पहचान, ऑफ़सेट और लंबाई से की जाती है. इसे यूनिकोड वर्णों में दिखाया जाता है.
terms
टाइप:  Array<PredictionTerm>
ऊपर दिए गए ब्यौरे में मौजूद हर शब्द के बारे में जानकारी. कैटगरी के हिसाब से शब्द पहले आते हैं. उदाहरण के लिए, "रेस्टोरेंट". पते की जानकारी, सबसे ज़्यादा से सबसे कम सटीक क्रम में दिखती है. उदाहरण के लिए, "सैन फ़्रांसिस्को" और "CA".
place_id optional
टाइप:  string optional
यह सुविधा सिर्फ़ तब उपलब्ध होती है, जब सुझाव किसी जगह के बारे में हो. यह एक प्लेस आईडी है. इसका इस्तेमाल, जगह की जानकारी देने वाली सेवा (PlacesService.getDetails देखें) का इस्तेमाल करके, इस जगह के बारे में जानकारी पाने के लिए किया जा सकता है.

PredictionTerm इंटरफ़ेस

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

यह अनुमानित शब्द को दिखाता है.
offset
टाइप:  number
जगह की जानकारी में, इस शब्द की शुरुआत का ऑफ़सेट. यह ऑफ़सेट, यूनिकोड वर्णों में होता है.
value
टाइप:  string
इस शब्द की वैल्यू. उदाहरण के लिए, "Taco Bell".

PredictionSubstring इंटरफ़ेस

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

यह किसी सुझाव के सबस्ट्रिंग को दिखाता है.
length
टाइप:  number
सबस्ट्रिंग की लंबाई.
offset
टाइप:  number
यह ब्यौरे वाली स्ट्रिंग में, सबस्ट्रिंग की शुरुआत का ऑफ़सेट होता है.

StructuredFormatting इंटरफ़ेस

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

इसमें जगह की जानकारी के बारे में स्ट्रक्चर्ड डेटा होता है. इसे मुख्य टेक्स्ट और सेकंडरी टेक्स्ट में बांटा जाता है. इसमें ऑटोकंप्लीट इनपुट से मैच किए गए सबस्ट्रिंग की एक ऐरे भी शामिल होती है. इसकी पहचान ऑफ़सेट और लंबाई से होती है. इसे यूनिकोड वर्णों में दिखाया जाता है.
main_text
टाइप:  string
यह जगह के बारे में दी गई जानकारी का मुख्य टेक्स्ट होता है. इसे Places सेवा से मिला है. आम तौर पर, यह जगह का नाम होता है.
main_text_matched_substrings
टाइप:  Array<PredictionSubstring>
मुख्य टेक्स्ट में मौजूद सबस्ट्रिंग का ऐसा सेट जो उपयोगकर्ता के इनपुट में मौजूद एलिमेंट से मेल खाता हो. इसका इस्तेमाल उन सबस्ट्रिंग को हाइलाइट करने के लिए किया जा सकता है. हर सबस्ट्रिंग की पहचान, ऑफ़सेट और लंबाई से की जाती है. इसे यूनिकोड वर्णों में दिखाया जाता है.
secondary_text
टाइप:  string
यह Places सेवा की ओर से सुझाई गई जगह के ब्यौरे का दूसरा टेक्स्ट वाला हिस्सा है. इसमें फ़ॉर्मैटिंग नहीं की गई है. आम तौर पर, यह जगह की जानकारी होती है.