आस-पास के स्थान खोजें.
एचटीटीपी अनुरोध
POST https://places.googleapis.com/v1/places:searchNearby
यूआरएल, gRPC ट्रांसकोडिंग सिंटैक्स का इस्तेमाल करता है.
अनुरोध का मुख्य भाग
अनुरोध के मुख्य हिस्से में इस तरह का डेटा शामिल होता है:
जेएसओएन के काेड में दिखाना |
---|
{ "languageCode": string, "regionCode": string, "includedTypes": [ string ], "excludedTypes": [ string ], "includedPrimaryTypes": [ string ], "excludedPrimaryTypes": [ string ], "maxResultCount": integer, "locationRestriction": { object ( |
फ़ील्ड | |
---|---|
languageCode |
जगह की जानकारी, उपलब्ध होने पर पसंदीदा भाषा में दिखाई जाएगी. अगर भाषा कोड तय नहीं है या पहचाना नहीं गया है, तो किसी भी भाषा की जगह की जानकारी दिखाई जा सकती है. साथ ही, अगर जानकारी मौजूद हो, तो अंग्रेज़ी की प्राथमिकता भी शामिल की जा सकती है. इस्तेमाल की जा सकने वाली भाषाओं की मौजूदा सूची: https://developers.google.com/maps/faq#languagesupport. |
regionCode |
जिस जगह से अनुरोध किया जा रहा है उस जगह का यूनिकोड देश/क्षेत्र कोड (CLDR) है. इस पैरामीटर का इस्तेमाल, जगह की जानकारी दिखाने के लिए किया जाता है. जैसे, जगह के हिसाब से जगह का नाम (अगर उपलब्ध हो). पैरामीटर, लागू होने वाले कानून के आधार पर नतीजों पर असर डाल सकता है. ज़्यादा जानकारी के लिए, https://www.unicode.org/cldr/charts/latest/supplemental/territory_language_information.html पर जाएं. ध्यान दें कि फ़िलहाल तीन अंकों वाले इलाके के कोड इस्तेमाल नहीं किए जा सकते. |
includedTypes[] |
https://developers.google.com/maps/documentation/places/web-service/place-types से जगह का टाइप (जैसे, "restaurant" या "gas_station") शामिल किया गया है. टेबल A से ज़्यादा से ज़्यादा 50 टाइप के बारे में बताया जा सकता है. अगर कोई कॉन्फ़्लिक्ट टाइप है, जैसे कि कोई टाइप शामिल है और एक्सक्लूड टाइप, दोनों में दिखता है, तो INVALID_LABEL गड़बड़ी मिलती है. अगर किसी जगह के टाइप को एक से ज़्यादा तरह की पाबंदियों के साथ सेट किया गया है, तो सिर्फ़ वही जगहें दिखेंगी जो सभी पाबंदियों के हिसाब से हों. उदाहरण के लिए, अगर हमारे पास {includedTypes = ["restaurant"], शामिलPrimaryTypes = ["restaurant"]} है, तो वापस की गई जगहें "रेस्टोरेंट" से जुड़ी सेवाएं उपलब्ध कराती हैं, लेकिन मुख्य रूप से "रेस्टोरेंट" के रूप में काम नहीं करतीं. |
excludedTypes[] |
https://developers.google.com/maps/documentation/places/web-service/place-types से जगह का टाइप (जैसे, "restaurant" या "gas_station") हटाया गया है. टेबल A से ज़्यादा से ज़्यादा 50 टाइप के बारे में बताया जा सकता है. अगर क्लाइंट शामिल किए गए टाइप (जैसे कि रेस्टोरेंट) और बाहर रखे गए टाइप (जैसे कि कैफ़े) दोनों उपलब्ध कराता है, तो जवाब में उन जगहों की जानकारी शामिल होनी चाहिए जो रेस्टोरेंट हैं, न कि कैफ़े. रिस्पॉन्स में ऐसी जगहें शामिल हैं जो कम से कम एक शामिल टाइप और किसी भी शामिल नहीं किए गए टाइप से मेल खाती हैं. अगर कोई कॉन्फ़्लिक्ट टाइप है, जैसे कि कोई टाइप शामिल है और एक्सक्लूड टाइप, दोनों में दिखता है, तो INVALID_LABEL गड़बड़ी मिलती है. अगर किसी जगह के टाइप को एक से ज़्यादा तरह की पाबंदियों के साथ सेट किया गया है, तो सिर्फ़ वही जगहें दिखेंगी जो सभी पाबंदियों के हिसाब से हों. उदाहरण के लिए, अगर हमारे पास {includedTypes = ["restaurant"], शामिलPrimaryTypes = ["restaurant"]} है, तो वापस की गई जगहें "रेस्टोरेंट" से जुड़ी सेवाएं उपलब्ध कराती हैं, लेकिन मुख्य रूप से "रेस्टोरेंट" के रूप में काम नहीं करतीं. |
includedPrimaryTypes[] |
https://developers.google.com/maps/documentation/places/web-service/place-types से जगह का मुख्य टाइप (जैसे, "restaurant" या "gas_station") शामिल किया गया है. किसी जगह के लिए, इस्तेमाल किए जा सकने वाले टाइप की टेबल में से, सिर्फ़ एक प्राइमरी टाइप हो सकता है. टेबल A से ज़्यादा से ज़्यादा 50 टाइप के बारे में बताया जा सकता है. अगर कोई विरोधाभासी मुख्य टाइप है, यानी एक प्रकार, includePrimaryTypes और excludedPrimaryTypes, दोनों में मौजूद नहीं है, तो एक INVALID_googleplay गड़बड़ी मिलती है. अगर किसी जगह के टाइप को एक से ज़्यादा तरह की पाबंदियों के साथ सेट किया गया है, तो सिर्फ़ वही जगहें दिखेंगी जो सभी पाबंदियों के हिसाब से हों. उदाहरण के लिए, अगर हमारे पास {includedTypes = ["restaurant"], शामिलPrimaryTypes = ["restaurant"]} है, तो वापस की गई जगहें "रेस्टोरेंट" से जुड़ी सेवाएं उपलब्ध कराती हैं, लेकिन मुख्य रूप से "रेस्टोरेंट" के रूप में काम नहीं करतीं. |
excludedPrimaryTypes[] |
https://developers.google.com/maps/documentation/places/web-service/place-types से मुख्य जगह का टाइप (जैसे, "restaurant" या "gas_station") बाहर रखा गया है. टेबल A से ज़्यादा से ज़्यादा 50 टाइप के बारे में बताया जा सकता है. अगर कोई विरोधाभासी मुख्य टाइप है, यानी एक प्रकार, includePrimaryTypes और excludedPrimaryTypes, दोनों में मौजूद नहीं है, तो एक INVALID_googleplay गड़बड़ी मिलती है. अगर किसी जगह के टाइप को एक से ज़्यादा तरह की पाबंदियों के साथ सेट किया गया है, तो सिर्फ़ वही जगहें दिखेंगी जो सभी पाबंदियों के हिसाब से हों. उदाहरण के लिए, अगर हमारे पास {includedTypes = ["restaurant"], शामिलPrimaryTypes = ["restaurant"]} है, तो वापस की गई जगहें "रेस्टोरेंट" से जुड़ी सेवाएं उपलब्ध कराती हैं, लेकिन मुख्य रूप से "रेस्टोरेंट" के रूप में काम नहीं करतीं. |
maxResultCount |
दिए जाने वाले नतीजों की ज़्यादा से ज़्यादा संख्या. यह 1 से 20 (डिफ़ॉल्ट) के बीच होना चाहिए. अगर संख्या सेट नहीं है, तो यह फिर से ऊपरी सीमा पर सेट हो जाती है. अगर संख्या, नेगेटिव पर सेट है या तय सीमा से ज़्यादा है, तो INVALID_VERSION गड़बड़ी दिखती है. |
locationRestriction |
ज़रूरी है. खोजा जाने वाला इलाका. |
rankPreference |
जवाब में नतीजों को कैसे रैंक किया जाएगा. |
जवाब का मुख्य भाग
'आस-पास खोजें' के लिए रिस्पॉन्स प्रोटो.
अगर एपीआई सही से जुड़ जाता है, ताे जवाब के मुख्य भाग में नीचे दिए गए स्ट्रक्चर शामिल होता है.
जेएसओएन के काेड में दिखाना |
---|
{
"places": [
{
object ( |
फ़ील्ड | |
---|---|
places[] |
ऐसी जगहों की सूची जो उपयोगकर्ता की ज़रूरतों को पूरा करती है. जैसे, जगहों के टाइप, जगहों की संख्या, और खास जगह पर लागू होने वाली पाबंदी. |
LocationRestriction
खोजा जाने वाला इलाका.
जेएसओएन के काेड में दिखाना |
---|
{ // Union field |
फ़ील्ड | |
---|---|
यूनियन फ़ील्ड
|
|
circle |
केंद्र बिंदु और त्रिज्या से परिभाषित वृत्त. |
RankPreference
जवाब में नतीजों को कैसे रैंक किया जाएगा.
Enums | |
---|---|
RANK_PREFERENCE_UNSPECIFIED |
रैंक वरीयता मान सेट नहीं है. डिफ़ॉल्ट रूप से POPULARITY के हिसाब से रैंक का इस्तेमाल करेगा. |
DISTANCE |
दूरी के आधार पर नतीजों को रैंक करता है. |
POPULARITY |
लोकप्रियता के हिसाब से नतीजों की रैंक तय करता है. |