Method: places.searchNearby

आस-पास के स्थान खोजें.

एचटीटीपी अनुरोध

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 (LocationRestriction)
  },
  "rankPreference": enum (RankPreference)
}
फ़ील्ड
languageCode

string

जगह की जानकारी, उपलब्ध होने पर पसंदीदा भाषा में दिखाई जाएगी. अगर भाषा कोड तय नहीं है या पहचाना नहीं गया है, तो किसी भी भाषा की जगह की जानकारी दिखाई जा सकती है. साथ ही, अगर जानकारी मौजूद हो, तो अंग्रेज़ी की प्राथमिकता भी शामिल की जा सकती है.

इस्तेमाल की जा सकने वाली भाषाओं की मौजूदा सूची: https://developers.google.com/maps/faq#languagesupport.
regionCode

string

जिस जगह से अनुरोध किया जा रहा है उस जगह का यूनिकोड देश/क्षेत्र कोड (CLDR) है. इस पैरामीटर का इस्तेमाल, जगह की जानकारी दिखाने के लिए किया जाता है. जैसे, जगह के हिसाब से जगह का नाम (अगर उपलब्ध हो). पैरामीटर, लागू होने वाले कानून के आधार पर नतीजों पर असर डाल सकता है.

ज़्यादा जानकारी के लिए, https://www.unicode.org/cldr/charts/latest/supplemental/territory_language_information.html पर जाएं.

ध्यान दें कि फ़िलहाल तीन अंकों वाले इलाके के कोड इस्तेमाल नहीं किए जा सकते.
includedTypes[]

string

https://developers.google.com/maps/documentation/places/web-service/place-types से जगह का टाइप (जैसे, "restaurant" या "gas_station") शामिल किया गया है.

टेबल A से ज़्यादा से ज़्यादा 50 टाइप के बारे में बताया जा सकता है.

अगर कोई कॉन्फ़्लिक्ट टाइप है, जैसे कि कोई टाइप शामिल है और एक्सक्लूड टाइप, दोनों में दिखता है, तो INVALID_LABEL गड़बड़ी मिलती है.

अगर किसी जगह के टाइप को एक से ज़्यादा तरह की पाबंदियों के साथ सेट किया गया है, तो सिर्फ़ वही जगहें दिखेंगी जो सभी पाबंदियों के हिसाब से हों. उदाहरण के लिए, अगर हमारे पास {includedTypes = ["restaurant"], शामिलPrimaryTypes = ["restaurant"]} है, तो वापस की गई जगहें "रेस्टोरेंट" से जुड़ी सेवाएं उपलब्ध कराती हैं, लेकिन मुख्य रूप से "रेस्टोरेंट" के रूप में काम नहीं करतीं.
excludedTypes[]

string

https://developers.google.com/maps/documentation/places/web-service/place-types से जगह का टाइप (जैसे, "restaurant" या "gas_station") हटाया गया है.

टेबल A से ज़्यादा से ज़्यादा 50 टाइप के बारे में बताया जा सकता है.

अगर क्लाइंट शामिल किए गए टाइप (जैसे कि रेस्टोरेंट) और बाहर रखे गए टाइप (जैसे कि कैफ़े) दोनों उपलब्ध कराता है, तो जवाब में उन जगहों की जानकारी शामिल होनी चाहिए जो रेस्टोरेंट हैं, न कि कैफ़े. रिस्पॉन्स में ऐसी जगहें शामिल हैं जो कम से कम एक शामिल टाइप और किसी भी शामिल नहीं किए गए टाइप से मेल खाती हैं.

अगर कोई कॉन्फ़्लिक्ट टाइप है, जैसे कि कोई टाइप शामिल है और एक्सक्लूड टाइप, दोनों में दिखता है, तो INVALID_LABEL गड़बड़ी मिलती है.

अगर किसी जगह के टाइप को एक से ज़्यादा तरह की पाबंदियों के साथ सेट किया गया है, तो सिर्फ़ वही जगहें दिखेंगी जो सभी पाबंदियों के हिसाब से हों. उदाहरण के लिए, अगर हमारे पास {includedTypes = ["restaurant"], शामिलPrimaryTypes = ["restaurant"]} है, तो वापस की गई जगहें "रेस्टोरेंट" से जुड़ी सेवाएं उपलब्ध कराती हैं, लेकिन मुख्य रूप से "रेस्टोरेंट" के रूप में काम नहीं करतीं.
includedPrimaryTypes[]

string

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[]

string

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

integer

दिए जाने वाले नतीजों की ज़्यादा से ज़्यादा संख्या. यह 1 से 20 (डिफ़ॉल्ट) के बीच होना चाहिए. अगर संख्या सेट नहीं है, तो यह फिर से ऊपरी सीमा पर सेट हो जाती है. अगर संख्या, नेगेटिव पर सेट है या तय सीमा से ज़्यादा है, तो INVALID_VERSION गड़बड़ी दिखती है.
locationRestriction

object (LocationRestriction)

ज़रूरी है. खोजा जाने वाला इलाका.
rankPreference

enum (RankPreference)

जवाब में नतीजों को कैसे रैंक किया जाएगा.

जवाब का मुख्य भाग

'आस-पास खोजें' के लिए रिस्पॉन्स प्रोटो.

अगर एपीआई सही से जुड़ जाता है, ताे जवाब के मुख्य भाग में नीचे दिए गए स्ट्रक्चर शामिल होता है.

जेएसओएन के काेड में दिखाना 
{
  "places": [
    {
      object (Place)
    }
  ]
}
फ़ील्ड
places[]

object (Place)

ऐसी जगहों की सूची जो उपयोगकर्ता की ज़रूरतों को पूरा करती है. जैसे, जगहों के टाइप, जगहों की संख्या, और खास जगह पर लागू होने वाली पाबंदी.

LocationRestriction

खोजा जाने वाला इलाका.

जेएसओएन के काेड में दिखाना 
{

  // Union field type can be only one of the following:
  "circle": {
    object (Circle)
  }
  // End of list of possible types for union field type.
}
फ़ील्ड

यूनियन फ़ील्ड type.

type इनमें से सिर्फ़ एक हो सकता है:
circle

object (Circle)

केंद्र बिंदु और त्रिज्या से परिभाषित वृत्त.

RankPreference

जवाब में नतीजों को कैसे रैंक किया जाएगा.

Enums
RANK_PREFERENCE_UNSPECIFIED रैंक वरीयता मान सेट नहीं है. डिफ़ॉल्ट रूप से POPULARITY के हिसाब से रैंक का इस्तेमाल करेगा.
DISTANCE दूरी के आधार पर नतीजों को रैंक करता है.
POPULARITY लोकप्रियता के हिसाब से नतीजों की रैंक तय करता है.