Autocomplete Data (new)

AutocompleteRequest इंटरफ़ेस

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

AutocompleteSuggestion.fetchAutocompleteSuggestions के लिए इंटरफ़ेस का अनुरोध करें.
input
टाइप:  string
वह टेक्स्ट स्ट्रिंग जिस पर खोजना है.
includedPrimaryTypes optional
टाइप:  Array<string> optional
जगह का मुख्य टाइप शामिल है, जैसे कि "रेस्टोरेंट" या "gas_station".

किसी जगह को सिर्फ़ तब दिखाया जाता है, जब उसका मुख्य टाइप इस सूची में शामिल होता है. ज़्यादा से ज़्यादा पांच वैल्यू दी जा सकती हैं. अगर कोई टाइप तय नहीं किया गया है, तो सभी तरह की जगहें दिखाई जाती हैं.
includedRegionCodes optional
टाइप:  Array<string> optional
सिर्फ़ बताए गए क्षेत्रों में नतीजे शामिल करें. इन कोड में ज़्यादा से ज़्यादा 15 CLDR दो वर्ण वाले क्षेत्र कोड डालें. किसी खाली सेट से नतीजों पर पाबंदी नहीं होगी. अगर locationRestriction और includedRegionCodes, दोनों को सेट किया जाता है, तो नतीजे, चौराहे वाली जगह पर दिखाए जाएंगे.
inputOffset optional
टाइप:  number optional
input का शून्य-आधारित यूनिकोड वर्ण ऑफ़सेट, जो input में कर्सर की स्थिति को दिखाता है. कर्सर की पोज़िशन से, दिखाए जाने वाले सुझावों पर असर पड़ सकता है. अगर इसके लिए भाषा तय नहीं की गई है, तो डिफ़ॉल्ट रूप से input की लंबाई सेट की जाती है.
language optional
टाइप:  string optional
वह भाषा जिसमें नतीजे देने हैं. ब्राउज़र की भाषा प्राथमिकता डिफ़ॉल्ट होगी. अगर input में इस्तेमाल की गई भाषा language से अलग है या लौटाए गए स्थान का स्थानीय भाषा से language में अनुवाद नहीं है, तो परिणाम मिश्रित भाषाओं में हो सकते हैं.
locationBias optional
टाइप:  LocationBias optional
चुनी गई जगह के लिए पक्षपातपूर्ण होता है.

ज़्यादा से ज़्यादा locationBias या locationRestriction में से कोई एक सेट की जानी चाहिए. अगर दोनों में से कोई भी सेट नहीं है, तो नतीजों में आईपी पते के हिसाब से नतीजे होंगे. इसका मतलब है कि आईपी पते को, सही जगह से मैप किया जाएगा और उसका इस्तेमाल मापदंड के हिसाब से करने के सिग्नल के तौर पर किया जाएगा.
locationRestriction optional
टाइप:  LocationRestriction optional
नतीजों को किसी खास जगह पर सीमित करें.

ज़्यादा से ज़्यादा locationBias या locationRestriction में से कोई एक सेट की जानी चाहिए. अगर दोनों में से कोई भी सेट नहीं है, तो नतीजों में आईपी पते के हिसाब से नतीजे होंगे. इसका मतलब है कि आईपी पते को, सही जगह से मैप किया जाएगा और उसका इस्तेमाल मापदंड के हिसाब से करने के सिग्नल के तौर पर किया जाएगा.
origin optional
टाइप:  LatLng|LatLngLiteral optional
वह मूल बिंदु जहां से मंज़िल के लिए जियोडेसिक दूरी की गणना की जाती है (PlacePrediction.distanceMeters के रूप में दिखाई जाती है). अगर यह मान छोड़ दिया जाता है, तो जियोडेसिक दूरी दिखाई नहीं देगी.
region optional
टाइप:  string optional
क्षेत्र का कोड, जिसे CLDR दो वर्णों वाले क्षेत्र के कोड के तौर पर दिखाया जाता है. इससे पते के फ़ॉर्मैट और नतीजों की रैंकिंग पर असर पड़ता है. साथ ही, नतीजों के दिखने पर भी असर पड़ सकता है. इससे, बताए गए क्षेत्र के लिए नतीजे सीमित नहीं होते.
sessionToken optional
टाइप:  AutocompleteSessionToken optional
यह एक टोकन है, जो बिलिंग के मकसद से ऑटोकंप्लीट की सुविधा वाले सेशन की पहचान करता है. AutocompleteSessionToken की मदद से नया सेशन टोकन जनरेट करें.

सेशन तब शुरू होता है, जब उपयोगकर्ता कोई क्वेरी टाइप करना शुरू करता है. किसी जगह को चुनने और Place.fetchFields को कॉल करने के बाद, सेशन खत्म होता है. हर सेशन में एक से ज़्यादा क्वेरी हो सकती हैं. इसके बाद, एक fetchFields कॉल हो सकती है. किसी सेशन में हर अनुरोध के लिए इस्तेमाल किए जाने वाले क्रेडेंशियल, एक ही Google Cloud Console प्रोजेक्ट से जुड़े होने चाहिए. सेशन खत्म होने के बाद, टोकन मान्य नहीं रहता. आपके ऐप्लिकेशन को हर सेशन के लिए नया टोकन जनरेट करना होगा. अगर sessionToken पैरामीटर को शामिल नहीं किया जाता है या किसी सेशन टोकन का फिर से इस्तेमाल किया जाता है, तो सेशन पर इस तरह से शुल्क लिया जाता है जैसे कि कोई सेशन टोकन न दिया गया हो. हर अनुरोध के लिए, अलग से बिल भेजा जाता है.

हम इन दिशा-निर्देशों को अपनाने का सुझाव देते हैं:
  • ऑटोकंप्लीट की सुविधा वाले सभी कॉल के लिए, सेशन टोकन का इस्तेमाल करें.
  • हर सेशन के लिए नया टोकन जनरेट करें.
  • हर नए सेशन के लिए, एक यूनीक सेशन टोकन पास करना न भूलें. एक से ज़्यादा सेशन के लिए एक ही टोकन का इस्तेमाल करने पर, हर अनुरोध का अलग-अलग बिल भेजा जाएगा.

AutocompleteSessionToken क्लास

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

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

const {AutocompleteSessionToken} = await google.maps.importLibrary("places") पर कॉल करके ऐक्सेस करें. Maps JavaScript API में लाइब्रेरी देखें.
AutocompleteSessionToken
AutocompleteSessionToken()
पैरामीटर: कोई नहीं
AutocompleteSessionToken का नया इंस्टेंस बनाता है.

AutocompleteSuggestion क्लास

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

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

const {AutocompleteSuggestion} = await google.maps.importLibrary("places") पर कॉल करके ऐक्सेस करें. Maps JavaScript API में लाइब्रेरी देखें.
fetchAutocompleteSuggestions
fetchAutocompleteSuggestions(autocompleteRequest)
पैरामीटर: 
रिटर्न वैल्यू:  Promise<{suggestions:Array<AutocompleteSuggestion>}>
अपने-आप पूरा होने वाले सुझावों की सूची फ़ेच करता है.
placePrediction
टाइप:  PlacePrediction optional
इसमें लौटाए गए नतीजे के लिए ऐसा नाम होता है जिसे कोई भी व्यक्ति आसानी से पढ़ सकता है. आम तौर पर, कारोबार की जगहों के नतीजों के लिए, यह कारोबार का नाम और पता होता है.

PlacePrediction क्लास

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

किसी स्थान के लिए ऑटोकंप्लीट सुविधा की मदद से मिलने वाले सुझाव के लिए अनुमान.

const {PlacePrediction} = await google.maps.importLibrary("places") पर कॉल करके ऐक्सेस करें. Maps JavaScript API में लाइब्रेरी देखें.
distanceMeters
टाइप:  number optional
अगर origin बताया गया है, तो origin से मीटर में जियोडेसिक लंबाई.
mainText
टाइप:  FormattableText optional
जगह का नाम दिखाता है.
placeId
टाइप:  string
सुझाई गई जगह का यूनीक आइडेंटिफ़ायर. इस आइडेंटिफ़ायर का इस्तेमाल, जगह के आईडी स्वीकार करने वाले अन्य एपीआई में किया जा सकता है.
secondaryText
टाइप:  FormattableText optional
साफ़ तौर पर जानकारी देने वाली सुविधाओं (जैसे, शहर या इलाका) की जानकारी मिलती है, ताकि जगह को और ज़्यादा आसानी से पहचाना जा सके.
text
टाइप:  FormattableText
इसमें लौटाए गए नतीजे के लिए ऐसा नाम होता है जिसे कोई भी व्यक्ति आसानी से पढ़ सकता है. आम तौर पर, कारोबार की जगहों के नतीजों के लिए, यह कारोबार का नाम और पता होता है.

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

StringRange क्लास

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

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

const {StringRange} = await google.maps.importLibrary("places") पर कॉल करके ऐक्सेस करें. Maps JavaScript API में लाइब्रेरी देखें.
endOffset
टाइप:  number
सबस्ट्रिंग (खास तौर पर) के आखिरी यूनिकोड वर्ण का, शून्य पर आधारित ऑफ़सेट.
startOffset
टाइप:  number
सबस्ट्रिंग के पहले यूनिकोड वर्ण का शून्य-आधारित ऑफ़सेट (शामिल)

FormattableText क्लास

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

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

const {FormattableText} = await google.maps.importLibrary("places") पर कॉल करके ऐक्सेस करें. Maps JavaScript API में लाइब्रेरी देखें.
matches
टाइप:  Array<StringRange>
स्ट्रिंग रेंज की सूची, जिससे पता चलता है कि FormattableText.text में इनपुट अनुरोध का मिलान कहां हुआ. text के खास हिस्सों को फ़ॉर्मैट करने के लिए, रेंज का इस्तेमाल किया जा सकता है. अगर मैचिंग, स्ट्रिंग मैचिंग के बजाय किसी दूसरी शर्त से की गई हो, तो हो सकता है कि सबस्ट्रिंग, AutocompleteRequest.input से एग्ज़ैक्ट मैच न करे. उदाहरण के लिए, स्पेल करेक्शन या ट्रांसलिट्रेशन. ये वैल्यू FormattableText.text के यूनिकोड वर्ण ऑफ़सेट हैं. रेंज को बढ़ते हुए ऑफ़सेट वैल्यू में क्रम में लगाने की गारंटी है.
text
टाइप:  string
वह टेक्स्ट जिसे FormattableText.matches के साथ फ़ॉर्मैट किया गया है या इस तरह इस्तेमाल किया जा सकता है.