Places Autocomplete Service (deprecated)

AutocompleteService क्लास

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

इस्तेमाल नहीं किया जा सकता: 1 मार्च, 2025 से, google.maps.places.AutocompleteService नए ग्राहकों के लिए उपलब्ध नहीं है. इसके बजाय, कृपया AutocompleteSuggestion का इस्तेमाल करें. फ़िलहाल, google.maps.places.AutocompleteService को बंद करने का कोई प्लान नहीं है. हालांकि, google.maps.places.AutocompleteService के बजाय AutocompleteSuggestion का इस्तेमाल करने का सुझाव दिया जाता है. google.maps.places.AutocompleteService में मौजूद गड़बड़ियों को ठीक नहीं किया जाएगा. हालांकि, इसमें होने वाली किसी भी बड़ी गड़बड़ी को ठीक किया जाएगा. सहायता बंद करने से कम से कम 12 महीने पहले आपको इसकी सूचना दी जाएगी. ज़्यादा जानकारी के लिए, कृपया https://developers.google.com/maps/legacy पर जाएं. साथ ही, माइग्रेट करने से जुड़ी गाइड के लिए, https://developers.google.com/maps/documentation/javascript/places-migration-overview पर जाएं.

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

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 ज़रूरी नहीं	अब इस्तेमाल नहीं किया जाता: मई 2023 से, bounds का इस्तेमाल नहीं किया जा सकता. इसके बजाय, AutocompletionRequest.locationBias और AutocompletionRequest.locationRestriction का इस्तेमाल करें. टाइप: LatLngBounds|LatLngBoundsLiteral optional अनुमान को बायस करने की सीमाएं. अनुमान, दिए गए bounds के हिसाब से होंगे. हालांकि, ये सिर्फ़ इन तक सीमित नहीं होंगे. अगर bounds सेट है, तो location और radius, दोनों को अनदेखा कर दिया जाएगा.
componentRestrictions ज़रूरी नहीं	टाइप: ComponentRestrictions optional कॉम्पोनेंट से जुड़ी पाबंदियां. कॉम्पोनेंट से जुड़ी पाबंदियों का इस्तेमाल, अनुमानों को सिर्फ़ पैरंट कॉम्पोनेंट तक सीमित करने के लिए किया जाता है. उदाहरण के लिए, देश.
language ज़रूरी नहीं	टाइप: string optional अगर हो सके, तो उस भाषा के लिए भाषा आइडेंटिफ़ायर जिसमें नतीजे दिखाए जाने चाहिए. चुनी गई भाषा में मिलने वाले नतीजों को ज़्यादा अच्छी रैंकिंग दी जा सकती है. हालांकि, सुझाव इस भाषा तक ही सीमित नहीं हैं. उपलब्ध भाषाओं की सूची देखें.
location ज़रूरी नहीं	अब इस्तेमाल नहीं किया जाता: मई 2023 से, location का इस्तेमाल नहीं किया जा सकता. इसके बजाय, AutocompletionRequest.locationBias और AutocompletionRequest.locationRestriction का इस्तेमाल करें. टाइप: LatLng optional अनुमान लगाने के लिए जगह की जानकारी. अनुमान, दिए गए location और radius के हिसाब से पक्षपातपूर्ण होंगे. इसके अलावा, bounds का इस्तेमाल किया जा सकता है.
locationBias ज़रूरी नहीं	टाइप: LocationBias optional जगहें खोजते समय इस्तेमाल की जाने वाली सॉफ़्ट बाउंड्री या हिंट.
locationRestriction ज़रूरी नहीं	टाइप: LocationRestriction optional खोज के नतीजों को सीमित करने के लिए बाउंड.
offset ज़रूरी नहीं	टाइप: number optional इनपुट किए गए शब्द में वर्ण की वह पोज़िशन जहां सेवा, अनुमान लगाने के लिए टेक्स्ट का इस्तेमाल करती है. यह इनपुट फ़ील्ड में कर्सर की पोज़िशन होती है.
origin ज़रूरी नहीं	टाइप: LatLng|LatLngLiteral optional वह जगह जहां से AutocompletePrediction.distance_meters का हिसाब लगाया जाता है.
radius ज़रूरी नहीं	अब इस्तेमाल नहीं किया जाता: मई 2023 से, radius का इस्तेमाल नहीं किया जा सकता. इसके बजाय, AutocompletionRequest.locationBias और AutocompletionRequest.locationRestriction का इस्तेमाल करें. टाइप: 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	टाइप: Array<AutocompletePrediction> 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 सेवा से सुझाई गई जगह के ब्यौरे का दूसरा टेक्स्ट है. इस टेक्स्ट को फ़ॉर्मैट नहीं किया गया है. आम तौर पर, जगह की जानकारी.