Places Service (deprecated)

PlacesService क्लास

क्लास google.maps.places.PlacesService
लाइब्रेरी "places"

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

const {PlacesService} = await google.maps.importLibrary("places");
PlacesService
PlacesService(attrContainer)
पैरामीटर:
PlacesService का एक नया इंस्टेंस बनाता है, जो तय किए गए कंटेनर में एट्रिब्यूशन रेंडर करता है.
findPlaceFromPhoneNumber
findPlaceFromPhoneNumber(request, callback)
पैरामीटर:
रिटर्न वैल्यू: कोई नहीं
फ़ोन नंबर के आधार पर जगहों की सूची दिखाता है. ज़्यादातर मामलों में, नतीजे की सूची में सिर्फ़ एक आइटम होना चाहिए. हालांकि, अगर अनुरोध साफ़ तौर पर नहीं किया गया है, तो एक से ज़्यादा नतीजे मिल सकते हैं. कॉलबैक को पास किए गए PlaceResult, पूरे PlaceResult के सबसेट होते हैं. आपका ऐप्लिकेशन, हर जगह के लिए ज़्यादा जानकारी वाला PlaceResult पा सकता है. इसके लिए, उसे PlacesService.getDetails को कॉल करना होगा और अपनी पसंद की जगह के लिए PlaceResult.place_id पास करना होगा.
findPlaceFromQuery
findPlaceFromQuery(request, callback)
पैरामीटर:
रिटर्न वैल्यू: कोई नहीं
किसी क्वेरी स्ट्रिंग के आधार पर, जगहों की सूची को ऐक्सेस करना. ज़्यादातर मामलों में, नतीजे की सूची में सिर्फ़ एक आइटम होना चाहिए. हालांकि, अगर अनुरोध साफ़ तौर पर नहीं किया गया है, तो एक से ज़्यादा नतीजे मिल सकते हैं. कॉलबैक को पास किए गए PlaceResult, पूरे PlaceResult के सबसेट होते हैं. आपका ऐप्लिकेशन, हर जगह के लिए ज़्यादा जानकारी वाला PlaceResult पा सकता है. इसके लिए, उसे PlacesService.getDetails को कॉल करना होगा और अपनी पसंद की जगह के लिए PlaceResult.place_id पास करना होगा.
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
ज़रूरी नहीं
टाइप: Array<string> optional
जानकारी वाले रिस्पॉन्स में शामिल किए जाने वाले फ़ील्ड. इनके लिए बिल जनरेट किया जाएगा. अगर कोई फ़ील्ड तय नहीं किया गया है या ['ALL'] पास किया गया है, तो सभी उपलब्ध फ़ील्ड दिखाए जाएंगे और उनके लिए बिल भेजा जाएगा. हालांकि, प्रोडक्शन डिप्लॉयमेंट के लिए ऐसा करने का सुझाव नहीं दिया जाता. फ़ील्ड की सूची देखने के लिए, PlaceResult पर जाएं. नेस्ट किए गए फ़ील्ड को डॉट-पाथ की मदद से तय किया जा सकता है. उदाहरण के लिए, "geometry.location".
language
ज़रूरी नहीं
टाइप: string optional
भाषा का आइडेंटिफ़ायर, जिससे यह तय होता है कि जानकारी किस भाषा में दिखाई जाए. उपलब्ध भाषाओं की सूची देखें.
region
ज़रूरी नहीं
टाइप: string optional
उपयोगकर्ता के इलाके का कोड. इससे, खोज के नतीजों में दिखने वाली फ़ोटो और अन्य चीज़ों पर असर पड़ सकता है. क्षेत्र कोड, दो वर्णों वाली ccTLD ("टॉप-लेवल डोमेन") वैल्यू स्वीकार करता है. ज़्यादातर ccTLD कोड, ISO 3166-1 कोड से मिलते-जुलते होते हैं. हालांकि, कुछ अपवाद भी होते हैं. उदाहरण के लिए, यूनाइटेड किंगडम का ccTLD "uk" (.co.uk) है, जबकि इसका ISO 3166-1 कोड "gb" है. तकनीकी तौर पर, यह कोड "यूनाइटेड किंगडम ऑफ़ ग्रेट ब्रिटेन ऐंड नॉर्दर्न आयरलैंड" के लिए है.
sessionToken
ज़रूरी नहीं
टाइप: AutocompleteSessionToken optional
यह एक यूनीक रेफ़रंस है. इसका इस्तेमाल, ऑटोकंप्लीट सेशन के साथ जानकारी के अनुरोध को बंडल करने के लिए किया जाता है.

FindPlaceFromPhoneNumberRequest इंटरफ़ेस

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

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

FindPlaceFromQueryRequest इंटरफ़ेस

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

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

PlaceSearchRequest इंटरफ़ेस

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

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

TextSearchRequest इंटरफ़ेस

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

टेक्स्ट से खोजने का अनुरोध, PlacesService को भेजा जाएगा.
bounds
ज़रूरी नहीं
टाइप: LatLngBounds|LatLngBoundsLiteral optional
जगहों को खोजते समय, नतीजों को बायस करने के लिए इस्तेमाल की जाने वाली सीमाएं (ज़रूरी नहीं). अगर bounds सेट है, तो location और radius, दोनों को अनदेखा कर दिया जाएगा. नतीजे, इन सीमाओं के अंदर तक ही सीमित नहीं रहेंगे. हालांकि, इसके अंदर के नतीजों को ज़्यादा रैंक मिलेगी.
language
ज़रूरी नहीं
टाइप: string optional
भाषा का आइडेंटिफ़ायर, जिससे यह तय होता है कि नाम और पते किस भाषा में दिखाए जाएं. हालांकि, ऐसा तब ही होगा, जब उस भाषा में नाम और पते उपलब्ध हों. उपलब्ध भाषाओं की सूची देखें.
location
ज़रूरी नहीं
टाइप: LatLng|LatLngLiteral optional
जगहों को खोजते समय, नतीजों को बायस करने के लिए इस्तेमाल किए जाने वाले इलाके का केंद्र.
query
ज़रूरी नहीं
टाइप: string optional
अनुरोध की क्वेरी के लिए इस्तेमाल किया जाने वाला कीवर्ड. उदाहरण के लिए, किसी जगह का नाम ('ताज महल'), किसी कैटगरी के बाद जगह का नाम ('दिल्ली में पिज़्ज़ा') या किसी जगह के नाम के बाद जगह की जानकारी ('मुंबई में स्टारबक्स').
radius
ज़रूरी नहीं
टाइप: number optional
मीटर में, उस इलाके का दायरा जिसका इस्तेमाल जगहों को खोजते समय, नतीजों को बायस करने के लिए किया जाता है.
region
ज़रूरी नहीं
टाइप: string optional
नतीजों को किसी खास क्षेत्र के हिसाब से दिखाने के लिए, क्षेत्र का कोड. क्षेत्र कोड, दो वर्णों वाली ccTLD ("टॉप-लेवल डोमेन") वैल्यू स्वीकार करता है. ज़्यादातर ccTLD कोड, ISO 3166-1 कोड से मिलते-जुलते होते हैं. हालांकि, कुछ अपवाद भी होते हैं. उदाहरण के लिए, यूनाइटेड किंगडम का ccTLD "uk" (.co.uk) है, जबकि इसका ISO 3166-1 कोड "gb" है. तकनीकी तौर पर, यह कोड "यूनाइटेड किंगडम ऑफ़ ग्रेट ब्रिटेन ऐंड नॉर्दर्न आयरलैंड" के लिए है.
type
ज़रूरी नहीं
टाइप: string optional
यह दिए गए टाइप की जगहें खोजता है. टाइप को अनुरोध की टारगेट की जाने वाली जगह की स्थानीय भाषा में अनुवाद किया जाता है. साथ ही, क्वेरी स्ट्रिंग के तौर पर इस्तेमाल किया जाता है. अगर कोई क्वेरी भी दी गई है, तो उसे स्थानीय भाषा में मौजूद टाइप स्ट्रिंग से जोड़ दिया जाता है. किसी दूसरे टाइप के नतीजे, जवाब से हटा दिए जाते हैं. इस फ़ील्ड का इस्तेमाल करके, भाषा और देश/इलाके के हिसाब से कैटगरी के मुताबिक खोजें की जा सकती हैं. मान्य टाइप यहां दिए गए हैं.

RankBy कॉन्सटैंट

कॉन्सटैंट google.maps.places.RankBy
लाइब्रेरी "places"

PlaceSearchRequest के लिए रैंकिंग के विकल्प.

const {RankBy} = await google.maps.importLibrary("places");
DISTANCE यह जगह की जानकारी के हिसाब से, नतीजों को रैंक करता है.
PROMINENCE रैंक के हिसाब से, नतीजों को उनकी अहमियत के आधार पर दिखाया जाता है.

LocationBias typedef

typedef google.maps.places.LocationBias

LocationBias, जगहों को खोजते समय इस्तेमाल की जाने वाली एक सामान्य सीमा या संकेत को दिखाता है. नतीजे, तय किए गए इलाके से बाहर के हो सकते हैं. मौजूदा उपयोगकर्ता के आईपी पते को बायस के तौर पर इस्तेमाल करने के लिए, स्ट्रिंग "IP_BIAS" को तय किया जा सकता है. ध्यान दें: Circle का इस्तेमाल करने पर, सेंटर और रेडियस को तय करना ज़रूरी है.

LatLng|LatLngLiteral|LatLngAltitude|LatLngAltitudeLiteral|LatLngBounds|LatLngBoundsLiteral|Circle|CircleLiteral|string

LocationRestriction typedef

typedef google.maps.places.LocationRestriction

LocationRestriction, जगहें खोजते समय इस्तेमाल की जाने वाली एक सख्त सीमा को दिखाता है.

LatLngBounds|LatLngBoundsLiteral

PlacesServiceStatus कॉन्सटैंट

कॉन्सटैंट google.maps.places.PlacesServiceStatus
लाइब्रेरी "places"

खोज पूरी होने पर, PlacesService से मिला स्टेटस. इन्हें वैल्यू या कॉन्सटेंट के नाम का इस्तेमाल करके तय करें. उदाहरण के लिए, 'OK' या google.maps.places.PlacesServiceStatus.OK.

इन कॉन्सटैंट को स्ट्रिंग के तौर पर भी इस्तेमाल किया जा सकता है. TypeScript में, स्ट्रिंग लिटरल को PlacesServiceStatusString टाइप से तय किया जाता है.

const {PlacesServiceStatus} = await google.maps.importLibrary("places");
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
ज़रूरी नहीं
टाइप: Array<GeocoderAddressComponent> optional
इस जगह के पते के कॉम्पोनेंट का कलेक्शन. सिर्फ़ PlacesService.getDetails के साथ उपलब्ध है.
adr_address
ज़रूरी नहीं
टाइप: string optional
adr माइक्रॉफ़ॉर्मैट में जगह के पते की जानकारी. सिर्फ़ PlacesService.getDetails के साथ उपलब्ध है.
aspects
ज़रूरी नहीं
टाइप: Array<PlaceAspectRating> optional
Google और Zagat के उपयोगकर्ताओं की समीक्षाओं के आधार पर, इस जगह के लिए दी गई रेटिंग. रेटिंग, 0 से 30 के स्केल पर दी जाती है.
business_status
ज़रूरी नहीं
टाइप: BusinessStatus optional
अगर जगह कोई कारोबार है, तो यह फ़्लैग कारोबार या जगह की स्थिति बताता है. इससे पता चलता है कि कारोबार चालू है या कुछ समय या हमेशा के लिए बंद है. अगर कोई डेटा उपलब्ध नहीं है, तो खोज या जानकारी के जवाबों में फ़्लैग मौजूद नहीं होता.
formatted_address
ज़रूरी नहीं
टाइप: string optional
जगह का पूरा पता.
formatted_phone_number
ज़रूरी नहीं
टाइप: string optional
जगह का फ़ोन नंबर, नंबर के क्षेत्रीय नियम के मुताबिक फ़ॉर्मैट किया गया है. सिर्फ़ PlacesService.getDetails के साथ उपलब्ध है.
geometry
ज़रूरी नहीं
टाइप: PlaceGeometry optional
जगह की ज्यामिति से जुड़ी जानकारी.
html_attributions
ज़रूरी नहीं
टाइप: Array<string> optional
इस जगह के नतीजे के लिए दिखाया जाने वाला एट्रिब्यूशन टेक्स्ट. उपलब्ध html_attributions हमेशा दिखाए जाते हैं, भले ही किसी भी fields का अनुरोध किया गया हो. साथ ही, इन्हें दिखाना ज़रूरी है.
icon
ज़रूरी नहीं
टाइप: string optional
किसी इमेज रिसॉर्स का यूआरएल, जिसका इस्तेमाल इस जगह की कैटगरी को दिखाने के लिए किया जा सकता है.
icon_background_color
ज़रूरी नहीं
टाइप: string optional
किसी जगह के आइकॉन के साथ इस्तेमाल करने के लिए, बैकग्राउंड का रंग. PlaceResult.icon_mask_base_uri भी देखें.
icon_mask_base_uri
ज़रूरी नहीं
टाइप: string optional
आइकॉन मास्क का छोटा किया गया यूआरएल. यूआरएल के आखिर में फ़ाइल एक्सटेंशन (जैसे, .svg या .png) जोड़कर, अलग-अलग तरह के आइकॉन ऐक्सेस करें.
international_phone_number
ज़रूरी नहीं
टाइप: string optional
अंतरराष्ट्रीय फ़ॉर्मैट में जगह का फ़ोन नंबर. अंतरराष्ट्रीय फ़ॉर्मैट में, देश का कोड शामिल होता है. साथ ही, इसकी शुरुआत में प्लस (+) का निशान होता है. सिर्फ़ PlacesService.getDetails के साथ उपलब्ध है.
name
ज़रूरी नहीं
टाइप: string optional
जगह का नाम. ध्यान दें: उपयोगकर्ता की ओर से डाली गई जगहों के मामले में, यह रॉ टेक्स्ट होता है. इसे उपयोगकर्ता ने टाइप किया होता है. कृपया इस डेटा का इस्तेमाल करते समय सावधानी बरतें. ऐसा इसलिए, क्योंकि नुकसान पहुंचाने वाले उपयोगकर्ता, कोड इंजेक्शन अटैक के लिए इसका इस्तेमाल कर सकते हैं. इस बारे में ज़्यादा जानने के लिए, http://en.wikipedia.org/wiki/Code_injection पर जाएं.
opening_hours
ज़रूरी नहीं
टाइप: PlaceOpeningHours optional
इससे पता चलता है कि जगह कब खुलती या बंद होती है.
permanently_closed
ज़रूरी नहीं
टाइप: boolean optional
एक फ़्लैग, जिससे पता चलता है कि जगह हमेशा के लिए बंद है या कुछ समय के लिए. अगर जगह चालू है या कोई डेटा उपलब्ध नहीं है, तो जवाब में फ़्लैग मौजूद नहीं होता.
photos
ज़रूरी नहीं
टाइप: Array<PlacePhoto> optional
इस जगह की फ़ोटो. कलेक्शन में ज़्यादा से ज़्यादा दस PlacePhoto ऑब्जेक्ट होंगे.
place_id
ज़रूरी नहीं
टाइप: string optional
जगह के लिए यूनीक आइडेंटिफ़ायर.
plus_code
ज़रूरी नहीं
टाइप: PlacePlusCode optional
यह जगह के लिए, ओपन लोकेशन कोड या "प्लस कोड" तय करता है.
price_level
ज़रूरी नहीं
टाइप: number optional
जगह की कीमत का लेवल, 0 से 4 के स्केल पर. कीमत के लेवल को इस तरह समझा जाता है:
  • 0: मुफ़्त
  • 1: कम कीमत वाले
  • 2: सामान्य
  • 3: महंगा
  • 4: बहुत महंगा
rating
ज़रूरी नहीं
टाइप: number optional
इस जगह के लिए उपयोगकर्ताओं की समीक्षाओं के आधार पर, 1.0 से 5.0 के बीच की रेटिंग.
reviews
ज़रूरी नहीं
टाइप: Array<PlaceReview> optional
इस जगह की समीक्षाओं की सूची. सिर्फ़ PlacesService.getDetails के साथ उपलब्ध है.
types
ज़रूरी नहीं
टाइप: Array<string> optional
इस जगह के लिए टाइप का कलेक्शन (उदाहरण के लिए, ["political", "locality"] या ["restaurant", "establishment"]).
url
ज़रूरी नहीं
टाइप: string optional
इस जगह के लिए, Google के आधिकारिक पेज का यूआरएल. यह Google के मालिकाना हक वाला पेज है. इसमें जगह के बारे में सबसे अच्छी जानकारी मौजूद होती है. सिर्फ़ PlacesService.getDetails के साथ उपलब्ध है.
user_ratings_total
ज़रूरी नहीं
टाइप: number optional
उपयोगकर्ता रेटिंग की संख्या, जिसकी वजह से इस जगह को PlaceResult.rating रेटिंग मिली.
utc_offset
ज़रूरी नहीं
टाइप: number optional
जगह के मौजूदा टाइमज़ोन के यूटीसी से ऑफ़सेट, मिनट में. उदाहरण के लिए, सिडनी, ऑस्ट्रेलिया में डेलाइट सेविंग के दौरान, यूटीसी से 11 घंटे आगे होता है. इसलिए, utc_offset, 660 होगा. यूटीसी से पीछे वाले टाइमज़ोन के लिए, ऑफ़सेट नेगेटिव होता है. उदाहरण के लिए, केप वर्ड के लिए utc_offset, -60 है. सिर्फ़ PlacesService.getDetails के साथ उपलब्ध है.
utc_offset_minutes
ज़रूरी नहीं
टाइप: number optional
जगह के मौजूदा टाइमज़ोन के यूटीसी से ऑफ़सेट, मिनट में. उदाहरण के लिए, सिडनी, ऑस्ट्रेलिया में डेलाइट सेविंग के दौरान, यूटीसी से 11 घंटे आगे होता है. इसलिए, utc_offset_minutes, 660 होगा. यूटीसी से पीछे वाले टाइमज़ोन के लिए, ऑफ़सेट नेगेटिव होता है. उदाहरण के लिए, केप वर्ड के लिए utc_offset_minutes, -60 है. सिर्फ़ PlacesService.getDetails के साथ उपलब्ध है.
vicinity
ज़रूरी नहीं
टाइप: string optional
जगह का आसान पता. इसमें सड़क का नाम, सड़क का नंबर, और मोहल्ला शामिल होता है. हालांकि, इसमें प्रांत/राज्य, पिन कोड या देश शामिल नहीं होता. उदाहरण के लिए, ऑस्ट्रेलिया के सिडनी में मौजूद Google के ऑफ़िस की विसिनिटी वैल्यू "48 Pirrama Road, Pyrmont" है. सिर्फ़ PlacesService.getDetails के साथ उपलब्ध है.
website
ज़रूरी नहीं
टाइप: 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
लाइब्रेरी "places"

जगह के लिए कारोबार की स्थिति. ज़्यादा जानकारी के लिए, वेब सेवा का दस्तावेज़ देखें.

इन कॉन्सटैंट को स्ट्रिंग के तौर पर भी इस्तेमाल किया जा सकता है. TypeScript में, स्ट्रिंग लिटरल को BusinessStatusString टाइप से तय किया जाता है.

const {BusinessStatus} = await google.maps.importLibrary("places");
CLOSED_PERMANENTLY कारोबार हमेशा के लिए बंद हो गया है. ज़्यादा जानकारी के लिए, वेब सेवा का दस्तावेज़ देखें.
CLOSED_TEMPORARILY कारोबार कुछ समय के लिए बंद है. ज़्यादा जानकारी के लिए, वेब सेवा का दस्तावेज़ देखें.
FUTURE_OPENING कारोबार आने वाले समय में खुलेगा. ज़्यादा जानकारी के लिए, वेब सेवा का दस्तावेज़ देखें.
OPERATIONAL कारोबार चालू है, लेकिन ज़रूरी नहीं कि वह अभी खुला हो. ज़्यादा जानकारी के लिए, वेब सेवा का दस्तावेज़ देखें.

PlaceGeometry इंटरफ़ेस

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

किसी जगह की ज्यामिति के बारे में जानकारी देता है.
location
ज़रूरी नहीं
टाइप: LatLng optional
जगह की पोज़िशन.
viewport
ज़रूरी नहीं
टाइप: LatLngBounds optional
इस जगह को मैप पर दिखाते समय, पसंदीदा व्यूपोर्ट. अगर जगह के लिए पसंदीदा व्यूपोर्ट की जानकारी नहीं है, तो यह प्रॉपर्टी null होगी. सिर्फ़ PlacesService.getDetails के साथ उपलब्ध है.

PlaceOpeningHours इंटरफ़ेस

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

इससे किसी जगह के कारोबार के खुले होने के समय के बारे में जानकारी मिलती है.
open_now
ज़रूरी नहीं
टाइप: boolean optional
क्या जगह इस समय खुली है.
periods
ज़रूरी नहीं
टाइप: Array<PlaceOpeningHoursPeriod> optional
हफ़्ते के हर दिन के लिए, कारोबार के खुले होने का समय. यह समय, रविवार से शुरू होकर समय के हिसाब से क्रम में होना चाहिए. इसमें वे दिन शामिल नहीं हैं जब जगह खुली नहीं होती. सिर्फ़ PlacesService.getDetails के साथ उपलब्ध है.
weekday_text
ज़रूरी नहीं
टाइप: Array<string> optional
सात स्ट्रिंग की एक कलेक्शन, जो हफ़्ते के हर दिन के लिए, कारोबार के खुले होने के समय को फ़ॉर्मैट करके दिखाती है. Places Service, कारोबार के खुले होने के समय को मौजूदा भाषा के हिसाब से सही तरीके से फ़ॉर्मैट और स्थानीय भाषा में उपलब्ध कराएगी. इस कलेक्शन में एलिमेंट का क्रम, भाषा पर निर्भर करता है. कुछ भाषाओं में हफ़्ते की शुरुआत सोमवार से होती है, जबकि कुछ में रविवार से. सिर्फ़ PlacesService.getDetails के साथ उपलब्ध है. अन्य कॉल से, खाली कलेक्शन मिल सकता है.
isOpen
isOpen([date])
पैरामीटर:
  • date: Date optional
रिटर्न वैल्यू: 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
ज़रूरी नहीं
टाइप: PlaceOpeningHoursTime optional
जगह के बंद होने का समय.

PlaceOpeningHoursTime इंटरफ़ेस

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

इससे पता चलता है कि कोई जगह कब खुलती या बंद होती है.
day
टाइप: number
हफ़्ते के दिन, [0, 6] की रेंज में संख्या के तौर पर, रविवार से शुरू होते हैं. उदाहरण के लिए, 2 का मतलब मंगलवार है.
hours
टाइप: number
PlaceOpeningHoursTime.time के घंटे, संख्या के तौर पर [0, 23] की रेंज में. इसकी जानकारी, जगह के टाइम ज़ोन में दी जाएगी.
minutes
टाइप: number
PlaceOpeningHoursTime.time के मिनट, संख्या के तौर पर. यह संख्या [0, 59] के बीच होनी चाहिए. यह जानकारी, जगह के टाइम ज़ोन के हिसाब से दी जाएगी.
time
टाइप: string
दिन का समय, 24 घंटे वाले "hhmm" फ़ॉर्मैट में. वैल्यू, ["0000", "2359"] की रेंज में होती हैं. समय की जानकारी, जगह के टाइम ज़ोन के हिसाब से दी जाएगी.
nextDate
ज़रूरी नहीं
टाइप: 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

किसी जगह के लिए, ओपन लोकेशन कोड या "प्लस कोड" तय करता है. Plus Codes का इस्तेमाल, उन जगहों पर मोहल्ले के पते के तौर पर किया जा सकता है जहां मोहल्ले के पते मौजूद नहीं हैं. जैसे, जहां इमारतों को नंबर नहीं दिए गए हैं या सड़कों के नाम नहीं हैं.
global_code
टाइप: string
एक प्लस कोड, जिसका इलाका डिग्री के 1/8000वें हिस्से से लेकर डिग्री के 1/8000वें हिस्से तक है. उदाहरण के लिए, "8FVC9G8F+5W".
compound_code
ज़रूरी नहीं
टाइप: string optional
एक Plus Code, जिसमें डिग्री के 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
ज़रूरी नहीं
टाइप: number optional
नतीजे में दिखने वाली इमेज की ज़्यादा से ज़्यादा ऊंचाई, पिक्सल में.
maxWidth
ज़रूरी नहीं
टाइप: 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 के बाद से सेकंड में दिखाया जाता है.
aspects
ज़रूरी नहीं
टाइप: Array<PlaceAspectRating> optional
समीक्षा में रेटिंग दिए गए पहलू. रेटिंग 0 से 3 के स्केल पर दी जाती है.
author_url
ज़रूरी नहीं
टाइप: string optional
समीक्षक की प्रोफ़ाइल का यूआरएल. समीक्षा करने वाले व्यक्ति की प्रोफ़ाइल उपलब्ध न होने पर, यह undefined होगी.
rating
ज़रूरी नहीं
टाइप: number optional
इस समीक्षा की रेटिंग, 1.0 और 5.0 के बीच की कोई संख्या होनी चाहिए. हालांकि, इन दोनों में से भी कोई संख्या हो सकती है.