Places Autocomplete Service (deprecated)

AutocompleteService क्लास

क्लास google.maps.places.AutocompleteService
लाइब्रेरी "places"

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

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

AutocompleteResponse इंटरफ़ेस

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

AutocompleteService.getPlacePredictions को कॉल करने पर, ऑटोकंप्लीट की सुविधा से मिला जवाब. इसमें AutocompletePrediction की सूची शामिल होती है.
predictions
AutocompletePrediction की सूची.

QueryAutocompletionRequest इंटरफ़ेस

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

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

ComponentRestrictions इंटरफ़ेस

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

इससे, ऑटोकंप्लीट सेवा के साथ इस्तेमाल किए जा सकने वाले कॉम्पोनेंट की पाबंदियां तय होती हैं.
country
ज़रूरी नहीं
टाइप: 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", "Willitis", और "CA".
types
टाइप: Array<string>
सुझाव से जुड़े अलग-अलग तरह के सुझावों का कलेक्शन. उदाहरण के लिए, 'establishment' या 'geocode'.
distance_meters
ज़रूरी नहीं
टाइप: number optional
AutocompletionRequest.origin से जगह की दूरी, मीटर में.

QueryAutocompletePrediction इंटरफ़ेस

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

यह ऑटोकंप्लीट की सुविधा की मदद से क्वेरी के लिए मिलने वाले एक सुझाव को दिखाता है.
description
टाइप: string
यह Places सेवा से सुझाई गई क्वेरी का बिना फ़ॉर्मैट वाला वर्शन है.
matched_substrings
टाइप: Array<PredictionSubstring>
जगह की जानकारी में सबस्ट्रिंग का एक सेट, जो उपयोगकर्ता के इनपुट में मौजूद एलिमेंट से मैच करता है. इसका इस्तेमाल, उन सबस्ट्रिंग को हाइलाइट करने के लिए किया जा सकता है. हर सबस्ट्रिंग की पहचान, ऑफ़सेट और लंबाई से की जाती है. इसे यूनिकोड वर्णों में दिखाया जाता है.
terms
टाइप: Array<PredictionTerm>
ऊपर दिए गए ब्यौरे में इस्तेमाल किए गए शब्दों की जानकारी. कैटगरी के हिसाब से शब्द पहले आते हैं. उदाहरण के लिए, "रेस्टोरेंट". पते में इस्तेमाल होने वाले शब्द, सबसे खास से लेकर सबसे कम खास के क्रम में दिखते हैं. उदाहरण के लिए, "San Francisco" और "CA".
place_id
ज़रूरी नहीं
टाइप: 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
यह जगह की जानकारी देने वाली सेवा के सुझाए गए ब्यौरे का मुख्य टेक्स्ट है. इस ब्यौरे को फ़ॉर्मैट नहीं किया गया है. आम तौर पर, जगह का नाम.
main_text_matched_substrings
टाइप: Array<PredictionSubstring>
मुख्य टेक्स्ट में सबस्ट्रिंग का एक सेट, जो उपयोगकर्ता के इनपुट में मौजूद एलिमेंट से मैच करता है. इसका इस्तेमाल, उन सबस्ट्रिंग को हाइलाइट करने के लिए किया जाता है. हर सबस्ट्रिंग की पहचान, ऑफ़सेट और लंबाई से की जाती है. इसे यूनिकोड वर्णों में दिखाया जाता है.
secondary_text
टाइप: string
यह Places सेवा से सुझाई गई जगह के ब्यौरे का दूसरा टेक्स्ट है. इस टेक्स्ट को फ़ॉर्मैट नहीं किया गया है. आम तौर पर, जगह की जानकारी.