Method: places.searchText

टेक्स्ट क्वेरी पर आधारित जगह की खोज.

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

POST https://places.googleapis.com/v1/places:searchText

यह यूआरएल gRPC ट्रांसकोडिंग सिंटैक्स का इस्तेमाल करता है.

अनुरोध का मुख्य भाग

अनुरोध के मुख्य हिस्से में, इस तरह का डेटा शामिल होता है:

जेएसओएन के काेड में दिखाना
{
  "textQuery": string,
  "languageCode": string,
  "regionCode": string,
  "rankPreference": enum (RankPreference),
  "includedType": string,
  "openNow": boolean,
  "minRating": number,
  "maxResultCount": integer,
  "priceLevels": [
    enum (PriceLevel)
  ],
  "strictTypeFiltering": boolean,
  "locationBias": {
    object (LocationBias)
  },
  "locationRestriction": {
    object (LocationRestriction)
  },
  "evOptions": {
    object (EVOptions)
  }
}
फ़ील्ड
textQuery

string

ज़रूरी है. टेक्स्ट वाली खोज के लिए टेक्स्ट क्वेरी.

languageCode

string

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

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

regionCode

string

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

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

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

rankPreference

enum (RankPreference)

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

includedType

string

अनुरोध की गई जगह का टाइप. इस्तेमाल किए जा सकने वाले टाइप की पूरी सूची: https://developers.google.com/maps/documentation/places/web-service/place-types. सिर्फ़ एक शामिल टाइप का इस्तेमाल करें.

openNow

boolean

खोज को वर्तमान में खुले स्थानों तक सीमित करने के लिए उपयोग किया जाता है. डिफ़ॉल्ट रूप से गलत पर सेट होती है.

minRating

number

उन परिणामों को फ़िल्टर करें जिनकी औसत उपयोगकर्ता रेटिंग इस सीमा से पूरी तरह कम हो. कोई मान्य वैल्यू 0.5 के बीच 0.5 के बीच फ़्लोट होनी चाहिए (इसमें शामिल हैं). जैसे, [0, 0.5, 1.0, ... , 5.0]. इसमें ये सभी वैल्यू भी शामिल होनी चाहिए. इनपुट रेटिंग सबसे करीब 0.5(सीलिंग) तक हो जाएगी. उदाहरण के लिए, 0.6 की रेटिंग से 1.0 से कम रेटिंग वाले सभी नतीजे हट जाएंगे.

maxResultCount

integer

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

priceLevels[]

enum (PriceLevel)

इसका इस्तेमाल, खोज को उन जगहों तक सीमित करने के लिए किया जाता है जिन्हें कीमत के कुछ लेवल के तौर पर मार्क किया गया है. उपयोगकर्ता, कीमत के लेवल का कोई भी कॉम्बिनेशन चुन सकते हैं. डिफ़ॉल्ट रूप से, कीमत के सभी लेवल चुने जा सकते हैं.

strictTypeFiltering

boolean

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

locationBias

object (LocationBias)

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

locationRestriction

object (LocationRestriction)

वह क्षेत्र जिसे खोजना है. इस जगह पर पाबंदी है. इसका मतलब है कि दी गई जगह से बाहर के नतीजे नहीं दिखाए जाएंगे. इसे locationBias के साथ सेट नहीं किया जा सकता.

evOptions

object (EVOptions)

ज़रूरी नहीं. जगह की खोज के अनुरोध के लिए खोजे जा सकने वाले ईवी विकल्प सेट करें.

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

places.searchText के लिए रिस्पॉन्स प्रोटो.

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

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

object (Place)

टेक्स्ट की मदद से की गई खोज की शर्तों को पूरा करने वाली जगहों की सूची.

RankPreference

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

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

LocationBias

वह क्षेत्र जिसे खोजना है. इस जगह की जानकारी से जुड़ा कोई भेदभाव नहीं होता है, जिसका मतलब है कि दी गई जगह के हिसाब से नतीजे दिखाए जा सकते हैं.

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

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

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

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

rectangle

object (Viewport)

रेक्टैंगल बॉक्स, जिसके उत्तर-पूर्व और दक्षिण-पश्चिम कोने से पता चलता है. rectangle.high(), रेक्टैंगल व्यूपोर्ट के उत्तर-पूर्वी हिस्से के तौर पर होना चाहिए. rectangle.low(), रेक्टैंगल व्यूपोर्ट का दक्षिण-पश्चिम पॉइंट होना चाहिए. rectangle.low().latitude(), rectangle.high().latitude() से ज़्यादा नहीं हो सकता. इस वजह से, अक्षांश की सीमा खाली हो जाएगी. आयताकार व्यूपोर्ट 180 डिग्री से ज़्यादा चौड़ा नहीं हो सकता.

circle

object (Circle)

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

LocationRestriction

वह क्षेत्र जिसे खोजना है. इस जगह पर पाबंदी है. इसका मतलब है कि दी गई जगह से बाहर के नतीजे नहीं दिखाए जाएंगे.

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

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

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

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

rectangle

object (Viewport)

रेक्टैंगल बॉक्स, जिसके उत्तर-पूर्व और दक्षिण-पश्चिम कोने से पता चलता है. rectangle.high(), रेक्टैंगल व्यूपोर्ट के उत्तर-पूर्वी हिस्से के तौर पर होना चाहिए. rectangle.low(), रेक्टैंगल व्यूपोर्ट का दक्षिण-पश्चिम पॉइंट होना चाहिए. rectangle.low().latitude(), rectangle.high().latitude() से ज़्यादा नहीं हो सकता. इस वजह से, अक्षांश की सीमा खाली हो जाएगी. आयताकार व्यूपोर्ट 180 डिग्री से ज़्यादा चौड़ा नहीं हो सकता.

EVOptions

जगह की खोज का अनुरोध करने वाले ईवी के विकल्प, जिन्हें खोजा जा सकता है.

जेएसओएन के काेड में दिखाना
{
  "minimumChargingRateKw": number,
  "connectorTypes": [
    enum (EVConnectorType)
  ]
}
फ़ील्ड
minimumChargingRateKw

number

ज़रूरी नहीं. किलोवाट में, चार्जिंग की ज़रूरी दर. तय की गई दर से कम चार्ज रेट वाली जगह को फ़िल्टर करके, अलग कर दिया जाता है.

connectorTypes[]

enum (EVConnectorType)

ज़रूरी नहीं. पसंदीदा ईवी कनेक्टर टाइप की सूची. जो जगह सूची में दिए गए किसी भी तरह के कनेक्टर के साथ काम नहीं करती उसे फ़िल्टर करके बाहर कर दिया गया है.