Autocomplete Data

AutocompleteSuggestion क्लास

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

अपने-आप पूरा होने वाले सुझाव का नतीजा.

const {AutocompleteSuggestion} = await google.maps.importLibrary("places");

स्टैटिक मेथड

fetchAutocompleteSuggestions

fetchAutocompleteSuggestions(autocompleteRequest) पैरामीटर: autocompleteRequest: AutocompleteRequest रिटर्न वैल्यू: Promise<{suggestions:Array<AutocompleteSuggestion>}> यह AutocompleteSuggestions की सूची फ़ेच करता है. अगर अनुरोध में AutocompleteRequest.sessionToken दिया गया है, तो Place.fetchFields को पहली बार कॉल करने पर, वह सेशन टोकन अपने-आप शामिल हो जाएगा. ऐसा, नतीजे के तौर पर मिलने वाले PlacePredictions पर PlacePrediction.toPlace से मिले हर Place पर होगा.

प्रॉपर्टी

placePrediction readonly

टाइप: PlacePrediction optional इसमें, दिखाए गए नतीजे का ऐसा नाम शामिल होता है जिसे आसानी से पढ़ा जा सकता है. किसी कारोबार के नतीजों के लिए, आम तौर पर यह कारोबार का नाम और पता होता है. अगर अपने-आप पूरा होने वाले सुझाव की इस सुविधा को फ़ेच करने के लिए इस्तेमाल किए गए AutocompleteRequest में AutocompleteRequest.sessionToken दिया गया था, तो PlacePrediction.toPlace को कॉल करने पर मिले Place पर पहली बार Place.fetchFields को कॉल करने पर, वही टोकन अपने-आप शामिल हो जाएगा.

AutocompleteRequest इंटरफ़ेस

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

AutocompleteSuggestion.fetchAutocompleteSuggestions के लिए अनुरोध इंटरफ़ेस.

प्रॉपर्टी
input	टाइप: string वह टेक्स्ट स्ट्रिंग जिसे खोजना है.
futureOpeningBusinessesIncluded ज़रूरी नहीं	टाइप: boolean optional उन कारोबारों के लिए जगह के सुझाव शामिल करें जो अभी तक नहीं खुले हैं, लेकिन आने वाले समय में खुलने की उम्मीद है.
includedPrimaryTypes ज़रूरी नहीं	टाइप: Array<string> optional शामिल किया गया मुख्य जगह का टाइप (उदाहरण के लिए, "restaurant" या "gas_station"). किसी जगह की जानकारी सिर्फ़ तब दिखती है, जब उसका मुख्य टाइप इस सूची में शामिल हो. ज़्यादा से ज़्यादा पांच वैल्यू दी जा सकती हैं. अगर कोई टाइप नहीं बताया जाता है, तो सभी तरह की जगहों की जानकारी दिखती है.
includedRegionCodes ज़रूरी नहीं	टाइप: Array<string> optional सिर्फ़ उन इलाकों के नतीजे शामिल करें जिनके लिए दो वर्णों वाले CLDR रीजन कोड दिए गए हैं. ज़्यादा से ज़्यादा 15 कोड दिए जा सकते हैं. खाली सेट होने पर, नतीजों पर कोई पाबंदी नहीं लगेगी. अगर locationRestriction और includedRegionCodes, दोनों सेट हैं, तो नतीजे इंटरसेक्शन वाले इलाके में दिखेंगे.
inputOffset ज़रूरी नहीं	टाइप: number optional input का शून्य-आधारित यूनिकोड वर्ण ऑफ़सेट, जो input में कर्सर की पोज़िशन दिखाता है. कर्सर की पोज़िशन से, अनुमानों पर असर पड़ सकता है. अगर कोई वैल्यू नहीं दी गई है, तो डिफ़ॉल्ट रूप से input की लंबाई को ही इसकी वैल्यू माना जाता है.
language ज़रूरी नहीं	टाइप: string optional वह भाषा जिसमें नतीजे दिखाए जाएंगे. यह डिफ़ॉल्ट रूप से, ब्राउज़र की भाषा से जुड़ी प्राथमिकता के हिसाब से सेट होगा. अगर input में इस्तेमाल की गई भाषा, language से अलग है, तो नतीजे अलग-अलग भाषाओं में हो सकते हैं. इसके अलावा, अगर नतीजे में मिली जगह का अनुवाद, स्थानीय भाषा से language में नहीं किया गया है, तो भी नतीजे अलग-अलग भाषाओं में हो सकते हैं.
locationBias ज़रूरी नहीं	टाइप: LocationBias optional किसी खास जगह के हिसाब से नतीजे दिखाता है. locationBias या locationRestriction में से किसी एक को ही सेट किया जाना चाहिए. अगर दोनों में से कोई भी सेट नहीं है, तो नतीजे आईपी पते के हिसाब से दिखाए जाएंगे. इसका मतलब है कि आईपी पते को किसी सटीक जगह से मैप किया जाएगा और उसका इस्तेमाल, बायस सिग्नल के तौर पर किया जाएगा.
locationRestriction ज़रूरी नहीं	टाइप: LocationRestriction optional नतीजों को किसी खास जगह तक सीमित करें. locationBias या locationRestriction में से किसी एक को ही सेट किया जाना चाहिए. अगर दोनों में से कोई भी सेट नहीं है, तो नतीजे आईपी पते के हिसाब से दिखाए जाएंगे. इसका मतलब है कि आईपी पते को किसी सटीक जगह से मैप किया जाएगा और उसका इस्तेमाल, बायस सिग्नल के तौर पर किया जाएगा.
origin ज़रूरी नहीं	टाइप: LatLng|LatLngLiteral optional वह शुरुआती पॉइंट जहां से डेस्टिनेशन तक की जियोडेसिक दूरी का हिसाब लगाया जाता है. इसे PlacePrediction.distanceMeters के तौर पर दिखाया जाता है. अगर यह वैल्यू नहीं दी जाती है, तो जियोडेसिक दूरी नहीं दिखाई जाएगी.
pureServiceAreaBusinessesIncluded ज़रूरी नहीं	टाइप: boolean optional अगर फ़ील्ड को 'सही है' पर सेट किया गया है, तो घर या दुकान पर सेवा देने वाले कारोबारों को शामिल करें. घर या दुकान पर सेवा देने वाला कारोबार, ग्राहकों के पते पर जाकर सेवा मुहैया कराता है या डिलीवरी देता है. हालांकि, अपने कारोबार के पते पर ग्राहकों को सेवा नहीं देता है. उदाहरण के लिए, प्लंबर या सफ़ाई की सेवाएं देने वाले कारोबारों का Google Maps पर कोई पता या जगह नहीं हो सकती.
region ज़रूरी नहीं	टाइप: string optional देश/इलाके का कोड, जिसे CLDR के दो वर्णों वाले कोड के तौर पर बताया गया है. इससे पते के फ़ॉर्मैट और नतीजों की रैंकिंग पर असर पड़ता है. साथ ही, इससे यह भी तय हो सकता है कि कौनसे नतीजे दिखाए जाएं. इससे, खोज के नतीजों को किसी खास इलाके तक सीमित नहीं किया जाता.
sessionToken ज़रूरी नहीं	टाइप: AutocompleteSessionToken optional यह एक टोकन है, जो बिलिंग के मकसद से ऑटोकंप्लीट सेशन की पहचान करता है. AutocompleteSessionToken की मदद से नया सेशन टोकन जनरेट करें. सेशन तब शुरू होता है, जब उपयोगकर्ता कोई क्वेरी टाइप करना शुरू करता है. साथ ही, यह तब खत्म होता है, जब वह कोई जगह चुनता है और Place.fetchFields को कॉल करता है. हर सेशन में कई क्वेरी हो सकती हैं. इसके बाद, एक fetchFields कॉल किया जा सकता है. किसी सेशन में हर अनुरोध के लिए इस्तेमाल किए गए क्रेडेंशियल, एक ही Google Cloud Console प्रोजेक्ट के होने चाहिए. सेशन खत्म होने के बाद, टोकन अमान्य हो जाता है. आपके ऐप्लिकेशन को हर सेशन के लिए एक नया टोकन जनरेट करना होगा. अगर sessionToken पैरामीटर को शामिल नहीं किया जाता है या किसी सेशन टोकन का फिर से इस्तेमाल किया जाता है, तो सेशन के लिए शुल्क इस तरह लिया जाता है जैसे कि कोई सेशन टोकन नहीं दिया गया हो. इसका मतलब है कि हर अनुरोध के लिए अलग से शुल्क लिया जाता है. जब AutocompleteSuggestion.fetchAutocompleteSuggestions को किए गए अनुरोध में सेशन टोकन दिया जाता है, तो वही टोकन, Place पर fetchFields को किए गए पहले कॉल में अपने-आप शामिल हो जाएगा. यह, नतीजे के तौर पर मिले AutocompleteSuggestion में से किसी एक पर PlacePrediction.toPlace को कॉल करने पर मिलता है. हमारा सुझाव है कि आप इन दिशा-निर्देशों का पालन करें: किसी जगह के शुरुआती अक्षर लिखने पर पूरा नाम सुझाने की सुविधा के सभी कॉल के लिए, सेशन टोकन इस्तेमाल करें. हर सेशन के लिए एक नया टोकन जनरेट करें. पक्का करें कि हर नए सेशन के लिए, एक यूनीक सेशन टोकन पास किया जाए. एक से ज़्यादा सेशन के लिए एक ही टोकन का इस्तेमाल करने पर, हर अनुरोध के लिए अलग से बिल भेजा जाएगा.

AutocompleteSessionToken क्लास

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

यह ऑटोकंप्लीट सेशन को ट्रैक करने के लिए इस्तेमाल किए जाने वाले सेशन टोकन को दिखाता है.

const {AutocompleteSessionToken} = await google.maps.importLibrary("places");

निर्माता
AutocompleteSessionToken	AutocompleteSessionToken() पैरामीटर: कोई नहीं AutocompleteSessionToken का नया इंस्टेंस बनाता है.

PlacePrediction क्लास

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

किसी जगह के शुरुआती अक्षर लिखने पर पूरा नाम सुझाने की सुविधा के लिए, ऑटोकंप्लीट के सुझाव के नतीजे.

const {PlacePrediction} = await google.maps.importLibrary("places");

प्रॉपर्टी
distanceMeters readonly	टाइप: number optional अगर origin की वैल्यू दी गई है, तो origin से जियोडेसिक की लंबाई मीटर में.
mainText readonly	टाइप: FormattableText optional इससे जगह का नाम पता चलता है.
placeId readonly	टाइप: string सुझाई गई जगह का यूनीक आइडेंटिफ़ायर. इस आइडेंटिफ़ायर का इस्तेमाल, उन अन्य एपीआई में किया जा सकता है जो जगह के आईडी स्वीकार करते हैं.
secondaryText readonly	टाइप: FormattableText optional यह जगह की पहचान करने के लिए, साफ़ तौर पर जानकारी देने वाली अन्य सुविधाओं (जैसे, शहर या इलाका) को दिखाता है.
text readonly	टाइप: FormattableText इसमें, दिखाए गए नतीजे का ऐसा नाम शामिल होता है जिसे आसानी से पढ़ा जा सकता है. किसी कारोबार के नतीजों के लिए, आम तौर पर यह कारोबार का नाम और पता होता है. text का सुझाव उन डेवलपर के लिए दिया जाता है जो एक यूज़र इंटरफ़ेस (यूआई) एलिमेंट दिखाना चाहते हैं. जो डेवलपर दो अलग-अलग, लेकिन मिलते-जुलते यूज़र इंटरफ़ेस (यूआई) एलिमेंट दिखाना चाहते हैं वे PlacePrediction.mainText और PlacePrediction.secondaryText का इस्तेमाल कर सकते हैं.
types readonly	टाइप: Array<string> इस जगह पर लागू होने वाले टाइप की सूची. यह सूची, https://developers.google.com/maps/documentation/places/web-service/place-types में मौजूद टेबल A या टेबल B से ली गई है.

तरीके
fetchAddressValidation	ध्यान दें: यह सुविधा सिर्फ़ v=beta चैनल में उपलब्ध है. fetchAddressValidation(request) पैरामीटर: request: AddressValidationRequest रिटर्न वैल्यू: Promise<AddressValidation> यह इस ऑटोकंप्लीट सेशन से जुड़ा, Address Validation का अनुरोध भेजता है. साथ ही, ऑटोकंप्लीट सेशन टोकन की मदद से, अनुरोध को अपने-आप भरता है. PlacePrediction से जगह की कोई भी जानकारी अपने-आप शामिल नहीं होती है. यह ऑटोकंप्लीट सेशन को मैनेज करने में मदद करने का एक आसान तरीका है.
toPlace	toPlace() पैरामीटर: कोई नहीं रिटर्न वैल्यू: Place यह इस PlacePrediction का Place रिप्रज़ेंटेशन दिखाता है. जगह की पूरी जानकारी पाने के लिए, Place.fetchFields को कॉल करना ज़रूरी है. अगर इस PlacePrediction को फ़ेच करने के लिए इस्तेमाल किए गए AutocompleteRequest में AutocompleteRequest.sessionToken दिया गया था, तो fetchFields को कॉल करते समय वही टोकन अपने-आप शामिल हो जाएगा. इसके अलावा, PlaceAutocompleteElement का इस्तेमाल करते समय, PlacePrediction.toPlace से मिले Place पर Place.fetchFields को किए गए पहले कॉल में, सेशन टोकन अपने-आप शामिल हो जाएगा.

StringRange क्लास

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

यह फ़ंक्शन, दिए गए टेक्स्ट में सबस्ट्रिंग की पहचान करता है.

const {StringRange} = await google.maps.importLibrary("places");

प्रॉपर्टी
endOffset readonly	टाइप: number सबस्ट्रिंग के आखिरी यूनिकोड वर्ण का ज़ीरो-बेस्ड ऑफ़सेट (शामिल नहीं).
startOffset readonly	टाइप: number सबस्ट्रिंग के पहले यूनिकोड वर्ण का ज़ीरो-बेस्ड ऑफ़सेट (इसमें शामिल है).

FormattableText क्लास

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

किसी जगह के सुझाव को दिखाने वाला टेक्स्ट. टेक्स्ट को इसी रूप में इस्तेमाल किया जा सकता है या फ़ॉर्मैट किया जा सकता है.

const {FormattableText} = await google.maps.importLibrary("places");

प्रॉपर्टी
matches readonly	टाइप: Array<StringRange> स्ट्रिंग रेंज की सूची, जिससे यह पता चलता है कि इनपुट अनुरोध, FormattableText.text में कहां मैच हुआ. रेंज का इस्तेमाल, text के कुछ हिस्सों को फ़ॉर्मैट करने के लिए किया जा सकता है. अगर मैच करने की प्रोसेस, स्ट्रिंग मैच करने के अलावा किसी अन्य शर्त के आधार पर तय की गई थी, तो हो सकता है कि सबस्ट्रिंग, AutocompleteRequest.input से एग्ज़ैक्ट मैच न हों. उदाहरण के लिए, स्पेलिंग में सुधार या ट्रांसलिट्रेशन. ये वैल्यू, FormattableText.text के यूनिकोड वर्ण ऑफ़सेट हैं. इस बात की गारंटी है कि रेंज को ऑफ़सेट वैल्यू के बढ़ते क्रम में लगाया जाएगा.
text readonly	टाइप: string ऐसा टेक्स्ट जिसे इसी रूप में इस्तेमाल किया जा सकता है या FormattableText.matches के साथ फ़ॉर्मैट किया जा सकता है.