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 से कम या इसके बराबर होनी चाहिए. |
|
टाइप:
string optionalkeyword के बराबर. इस फ़ील्ड में मौजूद वैल्यू को keyword फ़ील्ड में मौजूद वैल्यू के साथ जोड़ दिया जाता है. इसके बाद, इसे एक ही खोज स्ट्रिंग के हिस्से के तौर पर पास किया जाता है. |
openNow optional |
टाइप:
boolean optionalनतीजों को सिर्फ़ उन जगहों तक सीमित करता है जो फ़िलहाल खुली हैं. |
radius optional |
टाइप:
number optionalदी गई जगह से वह दूरी (मीटर में) जिसके अंदर जगहों को खोजना है. ज़्यादा से ज़्यादा 50,000 वैल्यू डाली जा सकती हैं. |
rankBy optional |
टाइप:
RankBy optionalडिफ़ॉल्ट:
RankBy.PROMINENCEइससे यह तय होता है कि नतीजे दिखाते समय, रैंकिंग के लिए किस तरीके का इस्तेमाल किया जाए. ध्यान दें कि जब rankBy को DISTANCE पर सेट किया जाता है, तब आपको location बताना होगा. हालांकि, radius या bounds नहीं बताया जा सकता. |
type optional |
टाइप:
string optionalइससे दी गई जगह के टाइप के हिसाब से खोज की जाती है. टाइप को अनुरोध की टारगेट की गई जगह की स्थानीय भाषा में अनुवादित किया जाता है. साथ ही, इसका इस्तेमाल क्वेरी स्ट्रिंग के तौर पर किया जाता है. अगर कोई क्वेरी भी दी जाती है, तो उसे स्थानीय भाषा में टाइप की गई स्ट्रिंग के साथ जोड़ दिया जाता है. जवाब में, किसी दूसरे टाइप के नतीजे शामिल नहीं किए जाते. इस फ़ील्ड का इस्तेमाल, भाषा और क्षेत्र से जुड़ी जानकारी के बिना कैटगरी के हिसाब से खोज करने के लिए करें. मान्य टाइप यहां दिए गए हैं. |
TextSearchRequest इंटरफ़ेस
google.maps.places.TextSearchRequest
इंटरफ़ेस
PlacesService को टेक्स्ट की मदद से खोजने का अनुरोध भेजा जाएगा.
प्रॉपर्टी | |
|---|---|
bounds optional |
टाइप:
LatLngBounds|LatLngBoundsLiteral optionalजगहों की खोज करते समय, नतीजों को पक्षपाती बनाने के लिए इस्तेमाल की गई सीमाएं (ज़रूरी नहीं). अगर bounds एट्रिब्यूट की वैल्यू सेट की जाती है, तो location और radius, दोनों एट्रिब्यूट की वैल्यू को अनदेखा कर दिया जाएगा. नतीजे सिर्फ़ इन सीमाओं के अंदर नहीं दिखाए जाएंगे. हालांकि, इन सीमाओं के अंदर मौजूद नतीजों को बेहतर रैंकिंग मिलेगी. |
language optional |
टाइप:
string optionalयह एक भाषा आइडेंटिफ़ायर है. इससे यह पता चलता है कि नाम और पते किस भाषा में दिखाए जाने चाहिए. हालांकि, ऐसा सिर्फ़ तब किया जाता है, जब यह मुमकिन हो. इस्तेमाल की जा सकने वाली भाषाओं की सूची देखें. |
location optional |
टाइप:
LatLng|LatLngLiteral optionalजगहों के बारे में खोज करते समय, नतीजों को पक्षपाती बनाने के लिए इस्तेमाल किए गए इलाके का सेंटर. |
query optional |
टाइप:
string optionalअनुरोध का क्वेरी शब्द. उदाहरण के लिए, किसी जगह का नाम ('एफ़िल टॉवर'), कैटगरी के बाद जगह का नाम ('न्यूयॉर्क में पिज़्ज़ा') या किसी जगह के नाम के बाद जगह की जानकारी देने वाला शब्द ('सिडनी में Starbucks'). |
radius optional |
टाइप:
number optionalजगहों को खोजते समय, नतीजों को पक्षपाती बनाने के लिए इस्तेमाल किए गए इलाके का दायरा, मीटर में. |
region optional |
टाइप:
string optionalनतीजों को किसी खास क्षेत्र के हिसाब से दिखाने के लिए क्षेत्र कोड. क्षेत्र के कोड में, दो वर्णों वाली ccTLD ("टॉप-लेवल डोमेन") वैल्यू डाली जा सकती है. ज़्यादातर ccTLD कोड, ISO 3166-1 कोड के जैसे ही होते हैं. हालांकि, कुछ अपवाद भी हैं. उदाहरण के लिए, यूनाइटेड किंगडम का ccTLD "uk" ( .co.uk) है, जबकि इसका ISO 3166-1 कोड "gb" है. तकनीकी तौर पर, यह "ग्रेट ब्रिटेन और उत्तरी आयरलैंड का यूनाइटेड किंगडम" के लिए है. |
type optional |
टाइप:
string optionalइससे दी गई जगह के टाइप के हिसाब से खोज की जाती है. टाइप को अनुरोध की टारगेट की गई जगह की स्थानीय भाषा में अनुवादित किया जाता है. साथ ही, इसका इस्तेमाल क्वेरी स्ट्रिंग के तौर पर किया जाता है. अगर कोई क्वेरी भी दी जाती है, तो उसे स्थानीय भाषा में टाइप की गई स्ट्रिंग के साथ जोड़ दिया जाता है. जवाब में, किसी दूसरे टाइप के नतीजे शामिल नहीं किए जाते. इस फ़ील्ड का इस्तेमाल, भाषा और क्षेत्र से जुड़ी जानकारी के बिना कैटगरी के हिसाब से खोज करने के लिए करें. मान्य टाइप यहां दिए गए हैं. |
RankBy कॉन्स्टेंट
google.maps.places.RankBy
कॉन्स्टेंट
PlaceSearchRequest के लिए रैंकिंग के विकल्प.
const {RankBy} = await google.maps.importLibrary("places") पर कॉल करके ऐक्सेस करें.
Maps JavaScript API में मौजूद लाइब्रेरी देखें.
कॉन्स्टेंट | |
|---|---|
DISTANCE |
यह जगह के नतीजों को, जगह से दूरी के हिसाब से रैंक करता है. |
PROMINENCE |
यह कुकी, जगह के नतीजों को उनकी लोकप्रियता के हिसाब से रैंक करती है. |
LocationBias typedef
google.maps.places.LocationBias
typedef
LocationBias, जगहों को खोजते समय इस्तेमाल करने के लिए एक सॉफ्ट बाउंड्री या हिंट को दिखाता है. ऐसा हो सकता है कि नतीजे, चुनी गई जगह के बाहर से मिले हों. मौजूदा उपयोगकर्ता के आईपी पते को पूर्वाग्रह के तौर पर इस्तेमाल करने के लिए, स्ट्रिंग "IP_BIAS" को तय किया जा सकता है. ध्यान दें: Circle का इस्तेमाल करने पर, सेंटर और रेडियस तय करना ज़रूरी है.
LatLng|LatLngLiteral|LatLngAltitude|LatLngAltitudeLiteral|LatLngBounds|LatLngBoundsLiteral|Circle|CircleLiteral|string
LocationRestriction typedef
google.maps.places.LocationRestriction
typedef
LocationRestriction, जगहों को खोजने के लिए इस्तेमाल की जाने वाली एक सीमा को दिखाता है.
PlacesServiceStatus कॉन्स्टेंट
google.maps.places.PlacesServiceStatus
कॉन्स्टेंट
खोज पूरी होने पर, PlacesService से मिला स्टेटस. इन्हें वैल्यू के हिसाब से या कॉन्स्टेंट के नाम का इस्तेमाल करके तय करें. उदाहरण के लिए, 'OK' या google.maps.places.PlacesServiceStatus.OK.
const {PlacesServiceStatus} = await google.maps.importLibrary("places") पर कॉल करके ऐक्सेस करें.
Maps JavaScript API में मौजूद लाइब्रेरी देखें.
कॉन्स्टेंट | |
|---|---|
INVALID_REQUEST |
यह अनुरोध अमान्य था. |
NOT_FOUND |
रेफ़र की गई जगह नहीं मिली. |
OK |
जवाब में मान्य नतीजा शामिल है. |
OVER_QUERY_LIMIT |
ऐप्लिकेशन ने अनुरोधों की तय सीमा पार कर ली है. |
REQUEST_DENIED |
ऐप्लिकेशन को PlacesService का इस्तेमाल करने की अनुमति नहीं है. |
UNKNOWN_ERROR |
सर्वर में गड़बड़ी की वजह से, PlacesService का अनुरोध प्रोसेस नहीं किया जा सका. फिर से कोशिश करने पर, अनुरोध पूरा हो सकता है. |
ZERO_RESULTS |
इस अनुरोध के लिए कोई नतीजा नहीं मिला. |
PlaceSearchPagination इंटरफ़ेस
google.maps.places.PlaceSearchPagination
इंटरफ़ेस
इस ऑब्जेक्ट का इस्तेमाल, जगहों के नतीजों के अतिरिक्त पेजों को फ़ेच करने के लिए किया जाता है.
प्रॉपर्टी | |
|---|---|
hasNextPage |
टाइप:
booleanइससे पता चलता है कि ज़्यादा नतीजे उपलब्ध हैं या नहीं. true जब नतीजों का कोई और पेज मौजूद हो. |
तरीके | |
|---|---|
nextPage |
nextPage()पैरामीटर: कोई नहीं
लौटाई गई वैल्यू:
voidयह कुकी, नतीजों का अगला पेज फ़ेच करती है. यह उसी कॉलबैक फ़ंक्शन का इस्तेमाल करता है जो पहले खोज अनुरोध के लिए दिया गया था. |
PlaceResult इंटरफ़ेस
google.maps.places.PlaceResult
इंटरफ़ेस
किसी जगह के बारे में जानकारी तय करता है.
प्रॉपर्टी | |
|---|---|
address_components optional |
टाइप:
Array<GeocoderAddressComponent> optionalइस जगह के पते के कॉम्पोनेंट का कलेक्शन. यह सुविधा सिर्फ़ PlacesService.getDetails के साथ उपलब्ध है. |
adr_address optional |
टाइप:
string optionaladr microformat में जगह के पते का उदाहरण. यह सुविधा सिर्फ़ PlacesService.getDetails के साथ उपलब्ध है. |
aspects optional |
टाइप:
Array<PlaceAspectRating> optionalGoogle और Zagat का इस्तेमाल करने वाले लोगों की समीक्षाओं के आधार पर, इस जगह के लिए रेटिंग दी गई है. रेटिंग 0 से 30 के स्केल पर दी जाती हैं. |
business_status optional |
टाइप:
BusinessStatus optionalयह फ़्लैग, कारोबार की जगह के खुले होने का स्टेटस दिखाता है. इससे पता चलता है कि कारोबार की जगह खुली है या कुछ समय के लिए या हमेशा के लिए बंद है. अगर कोई डेटा उपलब्ध नहीं है, तो खोज या ज़्यादा जानकारी वाले जवाबों में फ़्लैग मौजूद नहीं होता है. |
formatted_address optional |
टाइप:
string optionalजगह का पूरा पता. |
formatted_phone_number optional |
टाइप:
string optionalजगह का फ़ोन नंबर, जिसे नंबर के रीजनल कन्वेंशन के हिसाब से फ़ॉर्मैट किया गया हो. यह सुविधा सिर्फ़ PlacesService.getDetails के साथ उपलब्ध है. |
geometry optional |
टाइप:
PlaceGeometry optionalजगह की ज्यामिति से जुड़ी जानकारी. |
html_attributions optional |
टाइप:
Array<string> optionalइस जगह के नतीजे के लिए एट्रिब्यूशन टेक्स्ट दिखाया जाएगा. अनुरोध किए गए fields से कोई फ़र्क़ नहीं पड़ता. उपलब्ध html_attributions हमेशा दिखाए जाते हैं और उन्हें दिखाया जाना चाहिए. |
icon optional |
टाइप:
string optionalइमेज रिसॉर्स का यूआरएल. इसका इस्तेमाल, इस जगह की कैटगरी को दिखाने के लिए किया जा सकता है. |
icon_background_color optional |
टाइप:
string optionalजगह के आइकॉन के साथ इस्तेमाल करने के लिए बैकग्राउंड का रंग. PlaceResult.icon_mask_base_uri भी देखें. |
icon_mask_base_uri optional |
टाइप:
string optionalआइकॉन मास्क का छोटा किया गया यूआरएल. फ़ाइल एक्सटेंशन को आखिर में जोड़कर, अलग-अलग तरह के आइकॉन ऐक्सेस करें (जैसे, .svg या .png). |
international_phone_number optional |
टाइप:
string optionalजगह का फ़ोन नंबर, अंतरराष्ट्रीय फ़ॉर्मैट में होना चाहिए. अंतरराष्ट्रीय फ़ॉर्मैट में देश का कोड शामिल होता है. साथ ही, इसके पहले प्लस (+) का निशान होता है. यह सुविधा सिर्फ़ PlacesService.getDetails के साथ उपलब्ध है. |
name optional |
टाइप:
string optionalजगह का नाम. ध्यान दें: उपयोगकर्ता की ओर से जोड़े गए स्थानों के मामले में, यह उपयोगकर्ता के टाइप किए गए शब्दों का मूल टेक्स्ट होता है. इस डेटा का इस्तेमाल करते समय सावधानी बरतें. ऐसा इसलिए, क्योंकि नुकसान पहुंचाने वाले लोग इसका इस्तेमाल कोड इंजेक्शन के हमलों के लिए कर सकते हैं. (देखें: http://en.wikipedia.org/wiki/Code_injection). |
opening_hours optional |
टाइप:
PlaceOpeningHours optionalइससे यह तय होता है कि जगह कब खुलती है या बंद होती है. |
|
टाइप:
boolean optionalयह फ़्लैग बताता है कि जगह हमेशा के लिए बंद है या कुछ समय के लिए बंद है. अगर जगह खुली है या कोई डेटा उपलब्ध नहीं है, तो जवाब में फ़्लैग नहीं दिखता. |
photos optional |
टाइप:
Array<PlacePhoto> optionalइस जगह की फ़ोटो. कलेक्शन में ज़्यादा से ज़्यादा दस PlacePhoto ऑब्जेक्ट शामिल होंगे. |
place_id optional |
टाइप:
string optionalजगह के लिए यूनीक आइडेंटिफ़ायर. |
plus_code optional |
टाइप:
PlacePlusCode optionalयह जगह के लिए, ओपन लोकेशन कोड या "प्लस कोड" तय करता है. |
price_level optional |
टाइप:
number optionalजगह के किराये का लेवल, 0 से 4 के स्केल पर. कीमत के लेवल का मतलब यहां दिया गया है:
|
rating optional |
टाइप:
number optionalइस जगह की रेटिंग, 1.0 से 5.0 के बीच होती है. यह रेटिंग, इस जगह के लिए लोगों की समीक्षाओं के आधार पर तय की जाती है. |
reviews optional |
टाइप:
Array<PlaceReview> optionalइस जगह की समीक्षाओं की सूची. यह सुविधा सिर्फ़ PlacesService.getDetails के साथ उपलब्ध है. |
types optional |
टाइप:
Array<string> optional इस जगह के टाइप का कलेक्शन (उदाहरण के लिए, ["political", "locality"] या ["restaurant", "establishment"]). |
url optional |
टाइप:
string optionalइस जगह के लिए, Google के आधिकारिक पेज का यूआरएल. यह Google के मालिकाना हक वाला पेज है. इसमें जगह के बारे में सबसे अच्छी जानकारी मौजूद होती है. यह सुविधा सिर्फ़ PlacesService.getDetails के साथ उपलब्ध है. |
user_ratings_total optional |
टाइप:
number optionalउपयोगकर्ता की उन रेटिंग की संख्या जिनकी वजह से इस जगह को PlaceResult.rating रेटिंग मिली है. |
|
टाइप:
number optionalजगह के मौजूदा टाइमज़ोन का यूटीसी से ऑफ़सेट, मिनटों में. उदाहरण के लिए, ऑस्ट्रेलिया के सिडनी में डेलाइट सेविंग टाइम के दौरान, यूटीसी से 11 घंटे आगे होता है. इसलिए, utc_offset की वैल्यू 660 होगी. यूटीसी से पीछे के टाइमज़ोन के लिए, ऑफ़सेट नेगेटिव होता है. उदाहरण के लिए, केप वर्डे के लिए utc_offset -60 है. यह सुविधा सिर्फ़ PlacesService.getDetails के साथ उपलब्ध है. |
utc_offset_minutes optional |
टाइप:
number optionalजगह के मौजूदा टाइमज़ोन का यूटीसी से ऑफ़सेट, मिनटों में. उदाहरण के लिए, ऑस्ट्रेलिया के सिडनी में डेलाइट सेविंग टाइम के दौरान, यूटीसी से 11 घंटे आगे होता है. इसलिए, utc_offset_minutes की वैल्यू 660 होगी. यूटीसी से पीछे के टाइमज़ोन के लिए, ऑफ़सेट नेगेटिव होता है. उदाहरण के लिए, केप वर्डे के लिए utc_offset_minutes -60 है. यह सुविधा सिर्फ़ PlacesService.getDetails के साथ उपलब्ध है. |
vicinity optional |
टाइप:
string optionalजगह का आसान पता. इसमें सड़क का नाम, सड़क का नंबर, और इलाका शामिल होता है. हालांकि, इसमें प्रांत/राज्य, पिन कोड या देश का नाम शामिल नहीं होता. उदाहरण के लिए, ऑस्ट्रेलिया के सिडनी में मौजूद Google के ऑफ़िस की आस-पास की जगह की वैल्यू "48 Pirrama Road, Pyrmont" है. यह सुविधा सिर्फ़ PlacesService.getDetails के साथ उपलब्ध है. |
website optional |
टाइप:
string optionalइस जगह की आधिकारिक वेबसाइट, जैसे कि किसी कारोबार का होम पेज. यह सुविधा सिर्फ़ PlacesService.getDetails के साथ उपलब्ध है. |
PlaceAspectRating इंटरफ़ेस
google.maps.places.PlaceAspectRating
इंटरफ़ेस
इससे जगह के उस पहलू के बारे में जानकारी मिलती है जिसके बारे में लोगों ने समीक्षा की है.
प्रॉपर्टी | |
|---|---|
rating |
टाइप:
numberइस पहलू की रेटिंग. अलग-अलग समीक्षाओं के लिए, यह 0 से 3 तक की कोई पूर्णांक संख्या होती है. किसी जगह की एग्रीगेट रेटिंग के लिए, यह 0 से 30 तक का पूर्णांक होता है. |
type |
टाइप:
stringपहलू का टाइप. उदाहरण के लिए, "food", "decor", "service" या "overall". |
BusinessStatus कॉन्स्टेंट
google.maps.places.BusinessStatus
कॉन्स्टेंट
अगर कोई जगह कारोबार है, तो PlaceResult में उसके खुले होने का स्टेटस दिखता है. इससे पता चलता है कि वह जगह खुली है या कुछ समय के लिए या हमेशा के लिए बंद है. इन्हें वैल्यू या कॉन्स्टेंट के नाम (उदाहरण: 'OPERATIONAL' या google.maps.places.BusinessStatus.OPERATIONAL) के हिसाब से तय करें.
const {BusinessStatus} = await google.maps.importLibrary("places") पर कॉल करके ऐक्सेस करें.
Maps JavaScript API में मौजूद लाइब्रेरी देखें.
कॉन्स्टेंट | |
|---|---|
CLOSED_PERMANENTLY |
कारोबार हमेशा के लिए बंद हो गया है. |
CLOSED_TEMPORARILY |
कारोबार कुछ समय के लिए बंद है. |
OPERATIONAL |
कारोबार सामान्य तरीके से चल रहा है. |
PlaceGeometry इंटरफ़ेस
google.maps.places.PlaceGeometry
इंटरफ़ेस
किसी जगह की ज्यामिति के बारे में जानकारी देता है.
प्रॉपर्टी | |
|---|---|
location optional |
टाइप:
LatLng optionalजगह की स्थिति. |
viewport optional |
टाइप:
LatLngBounds optionalमैप पर इस जगह को दिखाते समय, पसंदीदा व्यूपोर्ट. अगर जगह के लिए पसंदीदा व्यूपोर्ट की जानकारी नहीं है, तो इस प्रॉपर्टी को null के तौर पर सेट किया जाएगा. यह सुविधा सिर्फ़ PlacesService.getDetails के साथ उपलब्ध है. |
PlaceOpeningHours इंटरफ़ेस
google.maps.places.PlaceOpeningHours
इंटरफ़ेस
यह किसी जगह के खुले होने के समय के बारे में जानकारी देता है.
प्रॉपर्टी | |
|---|---|
|
टाइप:
boolean optionalमौजूदा समय में जगह खुली है या नहीं. |
periods optional |
टाइप:
Array<PlaceOpeningHoursPeriod> optionalकारोबार के खुले होने का समय, हफ़्ते के हर दिन के लिए. यह समय, रविवार से शुरू होकर क्रम से दिया गया होता है. उन दिनों को शामिल नहीं किया जाता है जब जगह खुली नहीं होती है. यह सुविधा सिर्फ़ PlacesService.getDetails के साथ उपलब्ध है. |
weekday_text optional |
टाइप:
Array<string> optionalयह सात स्ट्रिंग का एक ऐसा कलेक्शन होता है जिसमें हफ़्ते के हर दिन के लिए, कारोबार के खुले होने का समय फ़ॉर्मैट किया गया होता है. Places Service, मौजूदा भाषा के हिसाब से खुलने के समय को सही तरीके से फ़ॉर्मैट करेगी और उसे स्थानीय भाषा में दिखाएगी. इस ऐरे में मौजूद एलिमेंट का क्रम, भाषा के हिसाब से तय होता है. कुछ भाषाओं में हफ़्ते की शुरुआत सोमवार से होती है, जबकि कुछ में रविवार से. यह सुविधा सिर्फ़ PlacesService.getDetails के साथ उपलब्ध है. अन्य कॉल से खाली कलेक्शन मिल सकता है. |
तरीके | |
|---|---|
isOpen |
isOpen([date])पैरामीटर:
लौटाई गई वैल्यू:
boolean|undefinedदेखें कि जगह अभी खुली है या नहीं (जब कोई तारीख नहीं दी गई हो) या दी गई तारीख पर खुली है या नहीं. अगर इस जगह पर PlaceResult.utc_offset_minutes या PlaceOpeningHours.periods उपलब्ध नहीं है, तो undefined दिखाया जाता है. PlaceOpeningHours.periods सिर्फ़ PlacesService.getDetails के ज़रिए उपलब्ध है. इस तरीके में, छुट्टियों के दौरान के समय जैसे खास समय को ध्यान में नहीं रखा जाता. |
PlaceOpeningHoursPeriod इंटरफ़ेस
google.maps.places.PlaceOpeningHoursPeriod
इंटरफ़ेस
यह किसी जगह के खुले होने के समय के बारे में स्ट्रक्चर्ड जानकारी तय करता है. ध्यान दें: अगर कोई जगह हमेशा खुली रहती है, तो जवाब में close सेक्शन नहीं दिखेगा. क्लाइंट, हमेशा खुले रहने की स्थिति को इस तरह से दिखा सकते हैं: open में day शामिल है, जिसकी वैल्यू 0 है. साथ ही, time शामिल है, जिसकी वैल्यू "0000" है. इसमें close शामिल नहीं है.
प्रॉपर्टी | |
|---|---|
open |
टाइप:
PlaceOpeningHoursTimeजगह के खुलने का समय. |
close optional |
टाइप:
PlaceOpeningHoursTime optionalजगह के बंद होने का समय. |
PlaceOpeningHoursTime इंटरफ़ेस
google.maps.places.PlaceOpeningHoursTime
इंटरफ़ेस
इससे यह तय होता है कि कोई जगह कब खुलती है या बंद होती है.
प्रॉपर्टी | |
|---|---|
day |
टाइप:
numberहफ़्ते के दिनों को [ 0, 6] की रेंज में मौजूद संख्या के तौर पर दिखाया जाता है. यह रेंज रविवार से शुरू होती है. उदाहरण के लिए, 2 का मतलब मंगलवार है. |
hours |
टाइप:
numberPlaceOpeningHoursTime.time के घंटे, संख्या के तौर पर [0, 23] की सीमा में. यह जगह के समय क्षेत्र के हिसाब से रिपोर्ट किया जाएगा. |
minutes |
टाइप:
numberPlaceOpeningHoursTime.time के मिनट, संख्या के तौर पर [0, 59] की सीमा में. यह जगह के टाइमज़ोन के हिसाब से रिपोर्ट किया जाएगा. |
time |
टाइप:
stringदिन का समय, 24 घंटे वाले "hhmm" फ़ॉर्मैट में. वैल्यू, [ "0000", "2359"] की रेंज में होती हैं. समय की जानकारी, जगह के टाइम ज़ोन के हिसाब से दी जाएगी. |
nextDate optional |
टाइप:
number optionalटाइमस्टैंप (epoch के बाद से मिलीसेकंड के तौर पर, new Date() के साथ इस्तेमाल करने के लिए सही है). यह PlaceOpeningHoursTime के अगली बार होने का समय दिखाता है. इसका हिसाब, हफ़्ते के PlaceOpeningHoursTime.day, PlaceOpeningHoursTime.time, और PlaceResult.utc_offset_minutes से लगाया जाता है. अगर PlaceResult.utc_offset_minutes undefined है, तो nextDate undefined होगा. |
PlacePlusCode इंटरफ़ेस
google.maps.places.PlacePlusCode
इंटरफ़ेस
किसी जगह के लिए, Open Location Code या "प्लस कोड" तय करता है. प्लस कोड का इस्तेमाल, उन जगहों पर मोहल्ले के पतों की जगह किया जा सकता है जहां ये मौजूद नहीं हैं. जैसे, जहां बिल्डिंग के नंबर नहीं हैं या सड़कों के नाम नहीं हैं.
प्रॉपर्टी | |
|---|---|
global_code |
टाइप:
stringप्लस कोड, जो 1/8000 डिग्री गुणा 1/8000 डिग्री के क्षेत्र को दिखाता है. उदाहरण के लिए, "8FVC9G8F+5W". |
compound_code optional |
टाइप:
string optionalप्लस कोड, 1/8000 डिग्री गुणा 1/8000 डिग्री के क्षेत्र का कोड होता है. इसमें पहले चार वर्ण (इलाके का कोड) हटा दिए जाते हैं और उनकी जगह इलाके की जानकारी दी जाती है. उदाहरण के लिए, "9G8F+5W Zurich, Switzerland". अगर कोड को छोटा करने के लिए कोई सही जगह नहीं मिलती है, तो इस फ़ील्ड को शामिल नहीं किया जाता है. |
PlacePhoto इंटरफ़ेस
google.maps.places.PlacePhoto
इंटरफ़ेस
यह किसी जगह की फ़ोटो के एलिमेंट को दिखाता है.
प्रॉपर्टी | |
|---|---|
height |
टाइप:
numberपिक्सल में फ़ोटो की ऊंचाई. |
html_attributions |
टाइप:
Array<string>इस फ़ोटो के लिए एट्रिब्यूशन टेक्स्ट दिखाया जाएगा. |
width |
टाइप:
numberपिक्सल में फ़ोटो की चौड़ाई. |
तरीके | |
|---|---|
getUrl |
getUrl([opts])पैरामीटर:
लौटाई गई वैल्यू:
stringयह फ़ंक्शन, दिए गए विकल्पों के हिसाब से इमेज का यूआरएल दिखाता है. |
PhotoOptions इंटरफ़ेस
google.maps.places.PhotoOptions
इंटरफ़ेस
इसमें फ़ोटो का अनुरोध करने के विकल्पों के बारे में बताया गया है.
प्रॉपर्टी | |
|---|---|
maxHeight optional |
टाइप:
number optionalजवाब में मिली इमेज की ज़्यादा से ज़्यादा ऊंचाई, पिक्सल में. |
maxWidth optional |
टाइप:
number optionalजवाब में मिली इमेज की ज़्यादा से ज़्यादा चौड़ाई, पिक्सल में. |
PlaceReview इंटरफ़ेस
google.maps.places.PlaceReview
इंटरफ़ेस
इससे किसी जगह की एक समीक्षा के बारे में पता चलता है.
प्रॉपर्टी | |
|---|---|
author_name |
टाइप:
stringसमीक्षा करने वाले व्यक्ति का नाम. |
language |
टाइप:
stringयह एक आईईटीएफ़ भाषा कोड है. इससे पता चलता है कि यह समीक्षा किस भाषा में लिखी गई है. ध्यान दें कि इस कोड में सिर्फ़ मुख्य भाषा का टैग शामिल होता है. इसमें कोई ऐसा सेकंडरी टैग शामिल नहीं होता जो देश या इलाके के बारे में बताता हो. उदाहरण के लिए, अंग्रेज़ी में लिखी गई सभी समीक्षाओं को 'en-AU' या 'en-UK' के बजाय 'en' के तौर पर टैग किया जाता है. |
profile_photo_url |
टाइप:
stringसमीक्षा करने वाले व्यक्ति की प्रोफ़ाइल फ़ोटो का यूआरएल. |
relative_time_description |
टाइप:
stringयह फ़ॉर्मैट किया गया ऐसा स्ट्रिंग होता है जिसमें हाल ही के समय के बारे में बताया जाता है. इसमें समीक्षा के समय को मौजूदा समय के हिसाब से बताया जाता है. यह स्ट्रिंग, भाषा और देश के हिसाब से सही फ़ॉर्म में होती है. उदाहरण के लिए "a month ago". |
text |
टाइप:
stringसमीक्षा का टेक्स्ट. |
time |
टाइप:
numberसमीक्षा का टाइमस्टैंप. इसे Epoch के बाद से सेकंड में दिखाया जाता है. |
|
टाइप:
Array<PlaceAspectRating> optionalसमीक्षा में जिन पहलुओं को रेटिंग दी गई है. रेटिंग 0 से 3 के स्केल पर दी जाती हैं. |
author_url optional |
टाइप:
string optionalसमीक्षक की प्रोफ़ाइल का यूआरएल. समीक्षा करने वाले व्यक्ति की प्रोफ़ाइल उपलब्ध न होने पर, यह undefined होगा. |
rating optional |
टाइप:
number optionalइस समीक्षा की रेटिंग, 1.0 और 5.0 के बीच की कोई संख्या होनी चाहिए. हालांकि, इन दोनों में से भी कोई संख्या हो सकती है. |