Autocomplete Data

AutocompleteSuggestion क्लास

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

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

const {AutocompleteSuggestion} = await google.maps.importLibrary("places");
fetchAutocompleteSuggestions
fetchAutocompleteSuggestions(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 की लंबाई को ही इसकी वैल्यू माना जाता है.
internalUsageAttributionIds
ज़रूरी नहीं
टाइप: Iterable<string> optional
इन आइडेंटिफ़ायर का इस्तेमाल, कॉल को खास पैकेज या ओएसएस लाइब्रेरी से एट्रिब्यूट करने के लिए किया जाता है.
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 से ली गई है.
BetafetchAddressValidation
fetchAddressValidation(request)
पैरामीटर:
रिटर्न वैल्यू: 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 के साथ फ़ॉर्मैट किया जा सकता है.
toString
toString()
पैरामीटर: कोई नहीं
रिटर्न वैल्यू: string
इसमें रिस्पॉन्स के तौर पर FormattableText.text मिलता है.