Autocomplete Data (new)

AutocompleteSuggestion क्लास

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

ऑटोकंप्लीट करने के लिए सुझाया गया नतीजा.

const {AutocompleteSuggestion} = await google.maps.importLibrary("places") पर कॉल करके ऐक्सेस करें.
Maps JavaScript API में मौजूद लाइब्रेरी देखें.
fetchAutocompleteSuggestions
fetchAutocompleteSuggestions(autocompleteRequest)
पैरामीटर: 
लौटाई गई वैल्यू:  Promise<{suggestions:Array<AutocompleteSuggestion>}>
यह AutocompleteSuggestions की सूची फ़ेच करता है.

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

अगर इस AutocompleteSuggestion को फ़ेच करने के लिए इस्तेमाल किए गए AutocompleteRequest में AutocompleteRequest.sessionToken दिया गया था, तो PlacePrediction.toPlace को कॉल करने पर मिले Place पर पहली बार Place.fetchFields को कॉल करते समय, वही टोकन अपने-आप शामिल हो जाएगा.

AutocompleteRequest इंटरफ़ेस

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

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

किसी जगह की जानकारी सिर्फ़ तब दिखाई जाती है, जब उसका मुख्य टाइप इस सूची में शामिल हो. ज़्यादा से ज़्यादा पांच वैल्यू दी जा सकती हैं. अगर कोई टाइप नहीं दिया गया है, तो सभी Place टाइप दिखाए जाते हैं.
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
यह एक टोकन है. इससे बिलिंग के लिए, Autocomplete सेशन की पहचान की जाती है. AutocompleteSessionToken के ज़रिए नया सेशन टोकन जनरेट करें.

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

अगर AutocompleteSuggestion.fetchAutocompleteSuggestions को किए गए अनुरोध में सेशन टोकन दिया जाता है, तो वही टोकन, Place पर fetchFields को किए गए पहले कॉल में अपने-आप शामिल हो जाएगा. यह Place, AutocompleteSuggestion में से किसी एक पर PlacePrediction.toPlace को कॉल करके वापस लाया जाता है.

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

AutocompleteSessionToken क्लास

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

यह एक सेशन टोकन है. इसका इस्तेमाल, अपने-आप पूरा होने वाले सेशन को ट्रैक करने के लिए किया जाता है.

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

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 में दिए गए टाइप की सूची, जो इस जगह पर लागू होती है.
BetafetchAddressValidation
fetchAddressValidation(request)
पैरामीटर: 
लौटाई गई वैल्यू:  Promise<AddressValidation>
यह कुकी, पते की पुष्टि करने का अनुरोध भेजती है. यह अनुरोध, अपने-आप पूरा होने की सुविधा वाले इस सेशन से जुड़ा होता है. यह कुकी, अनुरोध में अपने-आप पूरा होने की सुविधा वाले सेशन का टोकन अपने-आप भर देती है. PlacePrediction से जगह की कोई जानकारी अपने-आप शामिल नहीं होती है. यह सुविधा, सेशन को अपने-आप पूरा होने की सुविधा को मैनेज करने में मदद करती है.
toPlace
toPlace()
पैरामीटर:  कोई नहीं
लौटाई गई वैल्यू:  Place
यह PlacePrediction का Place दिखाता है. जगह की पूरी जानकारी पाने के लिए, Place.fetchFields को कॉल करना ज़रूरी है.

अगर इस PlacePrediction को फ़ेच करने के लिए इस्तेमाल किए गए AutocompleteRequest में AutocompleteRequest.sessionToken दिया गया था, तो fetchFields को कॉल करते समय वही टोकन अपने-आप शामिल हो जाएगा.

इसके अलावा, PlaceAutocompleteElement का इस्तेमाल करते समय, PlacePrediction.toPlace से मिले Place पर पहली बार कॉल करने पर, सेशन टोकन अपने-आप शामिल हो जाएगा.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 के साथ फ़ॉर्मैट किया जा सकता है.