Places Service

PlacesService क्लास

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

इसमें जगहों को खोजने और किसी जगह के बारे में जानकारी पाने से जुड़े तरीके शामिल होते हैं.

const {PlacesService} = await google.maps.importLibrary("places") पर कॉल करके ऐक्सेस करें.
Maps JavaScript API में मौजूद लाइब्रेरी देखें.
PlacesService
PlacesService(attrContainer)
पैरामीटर: 
यह PlacesService का नया इंस्टेंस बनाता है. यह इंस्टेंस, तय किए गए कंटेनर में एट्रिब्यूशन रेंडर करता है.
findPlaceFromPhoneNumber
findPlaceFromPhoneNumber(request, callback)
पैरामीटर: 
रिटर्न वैल्यू:  कोई नहीं
यह फ़ंक्शन, किसी फ़ोन नंबर के आधार पर जगहों की सूची दिखाता है. ज़्यादातर मामलों में, नतीजों की सूची में सिर्फ़ एक आइटम होना चाहिए. हालांकि, अगर अनुरोध अस्पष्ट है, तो एक से ज़्यादा नतीजे दिखाए जा सकते हैं. कॉल बैक को पास किए गए PlaceResult, पूरे PlaceResult के सबसेट होते हैं. आपका ऐप्लिकेशन, PlacesService.getDetails को कॉल करके और PlaceResult.place_id को पास करके, हर जगह के लिए ज़्यादा जानकारी वाला PlaceResult पा सकता है.
findPlaceFromQuery
findPlaceFromQuery(request, callback)
पैरामीटर: 
रिटर्न वैल्यू:  कोई नहीं
क्वेरी स्ट्रिंग के आधार पर, जगहों की सूची वापस लाता है. ज़्यादातर मामलों में, नतीजों की सूची में सिर्फ़ एक आइटम होना चाहिए. हालांकि, अगर अनुरोध अस्पष्ट है, तो एक से ज़्यादा नतीजे दिखाए जा सकते हैं. कॉल बैक को पास किए गए PlaceResult, पूरे PlaceResult के सबसेट होते हैं. आपका ऐप्लिकेशन, PlacesService.getDetails को कॉल करके और PlaceResult.place_id को पास करके, हर जगह के लिए ज़्यादा जानकारी वाला PlaceResult पा सकता है.
getDetails
getDetails(request, callback)
पैरामीटर: 
रिटर्न वैल्यू:  कोई नहीं
यह फ़ंक्शन, दिए गए placeId से पहचानी गई जगह के बारे में जानकारी देता है.
nearbySearch
nearbySearch(request, callback)
पैरामीटर: 
रिटर्न वैल्यू:  कोई नहीं
यह कीवर्ड या टाइप के आधार पर, किसी जगह के आस-पास की जगहों की सूची दिखाता है. जगह की जानकारी हमेशा दी जानी चाहिए. इसके लिए, LatLngBounds या location और radius पैरामीटर पास करें. कॉल बैक को पास किए गए PlaceResult, पूरे PlaceResult के सबसेट होते हैं. आपका ऐप्लिकेशन, हर जगह के लिए ज़्यादा जानकारी वाला PlaceResult पा सकता है. इसके लिए, उसे जगह की जानकारी पाने का अनुरोध भेजना होगा. साथ ही, उसे उस जगह के लिए PlaceResult.place_id पास करना होगा. PlaceSearchPagination ऑब्जेक्ट का इस्तेमाल, नतीजों के अन्य पेजों को फ़ेच करने के लिए किया जा सकता है. अगर यह नतीजों का आखिरी पेज है या नतीजों का सिर्फ़ एक पेज है, तो यह ऑब्जेक्ट शून्य होगा.
textSearch
textSearch(request, callback)
पैरामीटर: 
रिटर्न वैल्यू:  कोई नहीं
यह क्वेरी स्ट्रिंग के आधार पर, जगहों की सूची वापस लाता है. उदाहरण के लिए, "न्यूयॉर्क में पिज़्ज़ा" या "ओटावा के आस-पास जूते की दुकानें". जगह की जानकारी देने वाले पैरामीटर का इस्तेमाल करना ज़रूरी नहीं है. जगह की जानकारी देने पर, नतीजे सिर्फ़ आस-पास की जगहों के हिसाब से दिखाए जाते हैं. हालांकि, ऐसा नहीं है कि नतीजे सिर्फ़ उस जगह के हिसाब से दिखाए जाएं. textSearch का इस्तेमाल तब करें, जब आपको किसी स्ट्रिंग का इस्तेमाल करके जगहों को खोजना हो. साथ ही, उन मामलों में भी इसका इस्तेमाल करें जहां आपको खोज के नतीजों को किसी खास जगह तक सीमित नहीं करना है. PlaceSearchPagination ऑब्जेक्ट का इस्तेमाल, नतीजों के अन्य पेजों को फ़ेच करने के लिए किया जा सकता है. अगर यह नतीजों का आखिरी पेज है या नतीजों का सिर्फ़ एक पेज है, तो यह ऑब्जेक्ट शून्य होगा.

PlaceDetailsRequest इंटरफ़ेस

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

जगह की जानकारी के बारे में क्वेरी, PlacesService को भेजी जाएगी.
placeId
टाइप:  string
उस जगह का प्लेस आईडी जिसके बारे में जानकारी का अनुरोध किया जा रहा है.
fields optional
टाइप:  Array<string> optional
जवाब में शामिल किए जाने वाले फ़ील्ड, जिनके लिए बिल भेजा जाएगा. अगर कोई फ़ील्ड नहीं दिया गया है या ['ALL'] पास किया गया है, तो सभी उपलब्ध फ़ील्ड दिखाए जाएंगे और उनके लिए बिल भेजा जाएगा. प्रोडक्शन डिप्लॉयमेंट के लिए, ऐसा करने का सुझाव नहीं दिया जाता. फ़ील्ड की सूची देखने के लिए, PlaceResult देखें. नेस्ट किए गए फ़ील्ड को डॉट-पाथ (उदाहरण के लिए, "geometry.location") के साथ तय किया जा सकता है.
language optional
टाइप:  string optional
यह उस भाषा के लिए आइडेंटिफ़ायर है जिसमें जानकारी दिखानी है. इस्तेमाल की जा सकने वाली भाषाओं की सूची देखें.
region optional
टाइप:  string optional
उपयोगकर्ता के इलाके का क्षेत्र कोड. इससे यह तय करने में मदद मिलती है कि कौनसी फ़ोटो दिखाई जा सकती हैं. साथ ही, इससे अन्य चीज़ों पर भी असर पड़ सकता है. क्षेत्र के कोड में, दो वर्णों वाली ccTLD ("टॉप-लेवल डोमेन") वैल्यू डाली जा सकती है. ज़्यादातर ccTLD कोड, ISO 3166-1 कोड के जैसे ही होते हैं. हालांकि, कुछ अपवाद भी हैं. उदाहरण के लिए, यूनाइटेड किंगडम का ccTLD "uk" (.co.uk) है, जबकि इसका ISO 3166-1 कोड "gb" है. तकनीकी तौर पर, यह "ग्रेट ब्रिटेन और उत्तरी आयरलैंड का यूनाइटेड किंगडम" के लिए है.
sessionToken optional
टाइप:  AutocompleteSessionToken optional
इस यूनीक रेफ़रंस का इस्तेमाल, जानकारी के अनुरोध को ऑटोकंप्लीट सेशन के साथ बंडल करने के लिए किया जाता है.

FindPlaceFromPhoneNumberRequest इंटरफ़ेस

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

टेक्स्ट की मदद से जगह खोजने का अनुरोध, PlacesService.findPlaceFromPhoneNumber को भेजा जाएगा.
fields
टाइप:  Array<string>
जवाब में शामिल किए जाने वाले फ़ील्ड. इनके लिए बिल भेजा जाएगा. अगर ['ALL'] को पास किया जाता है, तो सभी उपलब्ध फ़ील्ड वापस कर दिए जाएंगे और उनके लिए बिल भेजा जाएगा. हमारा सुझाव है कि प्रोडक्शन डिप्लॉयमेंट के लिए, इसका इस्तेमाल न करें. फ़ील्ड की सूची देखने के लिए, PlaceResult देखें. नेस्ट किए गए फ़ील्ड को डॉट-पाथ (उदाहरण के लिए, "geometry.location") के साथ तय किया जा सकता है.
phoneNumber
टाइप:  string
उस जगह का फ़ोन नंबर जिसके बारे में जानकारी चाहिए. फ़ॉर्मैट E.164 होना चाहिए.
language optional
टाइप:  string optional
यह एक भाषा आइडेंटिफ़ायर है. इससे यह पता चलता है कि नाम और पते किस भाषा में दिखाए जाने चाहिए. हालांकि, ऐसा सिर्फ़ तब किया जाता है, जब यह मुमकिन हो. इस्तेमाल की जा सकने वाली भाषाओं की सूची देखें.
locationBias optional
टाइप:  LocationBias optional
जगह की जानकारी खोजते समय इस्तेमाल किया गया पूर्वाग्रह. नतीजे, दिए गए LocationBias के हिसाब से तय किए जाएंगे. हालांकि, ऐसा करना ज़रूरी नहीं है.

FindPlaceFromQueryRequest इंटरफ़ेस

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

टेक्स्ट की मदद से जगह खोजने का अनुरोध, PlacesService.findPlaceFromQuery को भेजा जाएगा.
fields
टाइप:  Array<string>
जवाब में शामिल किए जाने वाले फ़ील्ड. इनके लिए बिल भेजा जाएगा. अगर ['ALL'] को पास किया जाता है, तो सभी उपलब्ध फ़ील्ड वापस कर दिए जाएंगे और उनके लिए बिल भेजा जाएगा. हमारा सुझाव है कि प्रोडक्शन डिप्लॉयमेंट के लिए, इसका इस्तेमाल न करें. फ़ील्ड की सूची देखने के लिए, PlaceResult देखें. नेस्ट किए गए फ़ील्ड को डॉट-पाथ (उदाहरण के लिए, "geometry.location") के साथ तय किया जा सकता है.
query
टाइप:  string
अनुरोध की क्वेरी. उदाहरण के लिए, किसी जगह का नाम या पता.
language optional
टाइप:  string optional
यह एक भाषा आइडेंटिफ़ायर है. इससे यह पता चलता है कि नाम और पते किस भाषा में दिखाए जाने चाहिए. हालांकि, ऐसा सिर्फ़ तब किया जाता है, जब यह मुमकिन हो. इस्तेमाल की जा सकने वाली भाषाओं की सूची देखें.
locationBias optional
टाइप:  LocationBias optional
जगह की जानकारी खोजते समय इस्तेमाल किया गया पूर्वाग्रह. नतीजे, दिए गए LocationBias के हिसाब से तय किए जाएंगे. हालांकि, ऐसा करना ज़रूरी नहीं है.

PlaceSearchRequest इंटरफ़ेस

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

जगह की खोज के लिए क्वेरी, जिसे PlacesService को भेजा जाना है.
bounds optional
टाइप:  LatLngBounds|LatLngBoundsLiteral optional
जगहों को खोजने के लिए सीमाएं. अगर bounds एट्रिब्यूट की वैल्यू सेट की जाती है, तो location और radius, दोनों एट्रिब्यूट की वैल्यू को अनदेखा कर दिया जाएगा.
keyword optional
टाइप:  string optional
यह एक ऐसा शब्द है जिसे सभी उपलब्ध फ़ील्ड से मैच किया जाता है. इसमें नाम, टाइप, पता, ग्राहक समीक्षाएं, और तीसरे पक्ष का अन्य कॉन्टेंट शामिल है. हालांकि, यह इन तक ही सीमित नहीं है.
language optional
टाइप:  string optional
यह एक भाषा आइडेंटिफ़ायर है. इससे यह पता चलता है कि नाम और पते किस भाषा में दिखाए जाने चाहिए. हालांकि, ऐसा सिर्फ़ तब किया जाता है, जब यह मुमकिन हो. इस्तेमाल की जा सकने वाली भाषाओं की सूची देखें.
location optional
टाइप:  LatLng|LatLngLiteral optional
वह जगह जिसके आस-पास जगहों को खोजना है.
maxPriceLevel optional
टाइप:  number optional
नतीजों को सिर्फ़ उन जगहों तक सीमित करता है जहां कीमत तय सीमा के अंदर हो. मान्य वैल्यू 0 (सबसे कम कीमत) से लेकर 4 (सबसे ज़्यादा कीमत) तक होती हैं. अगर बताया गया है, तो minPrice से ज़्यादा या इसके बराबर होना चाहिए.
minPriceLevel optional
टाइप:  number optional
नतीजों को सिर्फ़ उन जगहों तक सीमित करता है जहां कीमत का लेवल तय किया गया हो या उससे ज़्यादा हो. मान्य वैल्यू 0 (सबसे कम कीमत) से लेकर 4 (सबसे ज़्यादा कीमत) तक होती हैं. अगर यह वैल्यू दी गई है, तो यह maxPrice से कम या इसके बराबर होनी चाहिए.