Autocomplete Data (new)

AutocompleteRequest इंटरफ़ेस

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

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

input
टाइप:  string
वह टेक्स्ट स्ट्रिंग जिस पर खोजना है.
includedPrimaryTypes optional
टाइप:  Array<string> optional
प्राइमरी जगह का टाइप शामिल किया गया हो. उदाहरण के लिए, "restaurant" या "gas_station".

किसी जगह की जानकारी सिर्फ़ तब दिखती है, जब उसकी मुख्य कैटगरी इस सूची में शामिल हो. ज़्यादा से ज़्यादा पांच वैल्यू दी जा सकती हैं. अगर कोई टाइप नहीं दिया गया है, तो जगह के सभी टाइप दिखाए जाते हैं.
includedRegionCodes optional
टाइप:  Array<string> optional
सिर्फ़ उन इलाकों के नतीजे शामिल करें जिनके लिए आपने CLDR के दो वर्णों वाले ज़्यादा से ज़्यादा 15 इलाके कोड तय किए हैं. खाली सेट से नतीजों पर कोई असर नहीं पड़ेगा. अगर 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 class

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

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

const {AutocompleteSessionToken} = await google.maps.importLibrary("places") को कॉल करके ऐक्सेस करें. Maps JavaScript API में लाइब्रेरी देखें.

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

AutocompleteSuggestion class

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

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

const {AutocompleteSuggestion} = await google.maps.importLibrary("places") को कॉल करके ऐक्सेस करें. Maps JavaScript API में लाइब्रेरी देखें.

fetchAutocompleteSuggestions
fetchAutocompleteSuggestions(autocompleteRequest)
पैरामीटर: 
रिटर्न वैल्यू:  Promise<{suggestions:Array<AutocompleteSuggestion>}>
AutocompleteSuggestions की सूची फ़ेच करता है.
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
इस PlacePrediction की जगह की जानकारी दिखाता है. जगह की पूरी जानकारी पाने के लिए, Place.fetchFields को फिर से कॉल करना ज़रूरी है.

StringRange class

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 के साथ फ़ॉर्मैट किया जा सकता है.