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,
  "pageSize": integer,
  "pageToken": string,
  "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
(deprecated)

integer

अब काम नहीं करता: इसके बजाय pageSize का इस्तेमाल करें.

हर पेज पर दिखाए जा सकने वाले नतीजों की ज़्यादा से ज़्यादा संख्या. अगर उपलब्ध नतीजों की संख्या maxResultCount से ज़्यादा है, तो nextPageToken दिखाया जाता है. इसे pageToken को पास किया जा सकता है, ताकि बाद के अनुरोधों में नतीजों का अगला पेज दिखाया जा सके. अगर 0 दिया जाता है या कोई वैल्यू नहीं दी जाती है, तो डिफ़ॉल्ट वैल्यू 20 का इस्तेमाल किया जाता है. वैल्यू ज़्यादा से ज़्यादा 20 हो सकती है. 20 से ज़्यादा वैल्यू को लागू करके 20 कर दिया जाएगा. ऋणात्मक मान एक INVALID_LABEL गड़बड़ी दिखाएगा.

अगर maxResultCount और pageSize, दोनों के बारे में बताया गया है, तो maxResultCount को अनदेखा कर दिया जाएगा.
pageSize

integer

ज़रूरी नहीं. हर पेज पर दिखाए जा सकने वाले नतीजों की ज़्यादा से ज़्यादा संख्या. अगर उपलब्ध नतीजों की संख्या pageSize से ज़्यादा है, तो nextPageToken दिखाया जाता है. इसे pageToken को पास किया जा सकता है, ताकि बाद के अनुरोधों में नतीजों का अगला पेज दिखाया जा सके. अगर 0 दिया जाता है या कोई वैल्यू नहीं दी जाती है, तो डिफ़ॉल्ट वैल्यू 20 का इस्तेमाल किया जाता है. वैल्यू ज़्यादा से ज़्यादा 20 होनी चाहिए. वहीं, 20 से ज़्यादा वैल्यू को 20 पर सेट किया जाएगा. ऋणात्मक मान एक INVALID_LABEL गड़बड़ी दिखाएगा.

अगर maxResultCount और pageSize, दोनों के बारे में बताया गया है, तो maxResultCount को अनदेखा कर दिया जाएगा.
pageToken

string

ज़रूरी नहीं. पिछले TextSearch कॉल से मिला पेज टोकन. बाद वाला पेज फिर से पाने के लिए यह विकल्प दें.

पेज पर नंबर जोड़ते समय, TextSearch को दिए गए pageToken, pageSize, और maxResultCount के अलावा अन्य सभी पैरामीटर, उस शुरुआती कॉल से मेल खाने चाहिए जो पेज टोकन दिया गया था. अगर ऐसा नहीं होता है, तो एक INVALID_LABEL गड़बड़ी मिलती है.
priceLevels[]

enum (PriceLevel)

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

boolean

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

object (LocationBias)

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

object (LocationRestriction)

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

object (EVOptions)

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

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

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

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

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

object (Place)

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

object (ContextualContent)

एक्सपेरिमेंटल: ज़्यादा जानकारी के लिए, https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative पर जाएं.

काम के कॉन्टेंट की ऐसी सूची जिसमें हर एंट्री, जगह वाले फ़ील्ड में उसी इंडेक्स में मौजूद सही जगह से जुड़ी होती है. अनुरोध में मौजूद textQuery से जुड़े कॉन्टेंट को प्राथमिकता दी जाती है. अगर किसी जगह के हिसाब से कॉन्टेंट उपलब्ध नहीं है, तो उस जगह के हिसाब से कॉन्टेंट नहीं दिखेगा. यह सिर्फ़ तब खाली होगा, जब इस जगह के लिए कॉन्टेंट उपलब्ध नहीं होगा. अनुरोध किए जाने पर, इस सूची में जगहों की सूची में जितनी चाहे उतनी एंट्री होनी चाहिए.
nextPageToken

string

अगला पेज वापस पाने के लिए, pageToken के तौर पर भेजा जा सकने वाला टोकन. अगर यह फ़ील्ड खाली है या इसे छोड़ा जाता है, तो इसके बाद कोई पेज नहीं होगा.

RankPreference

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

Enums
RANK_PREFERENCE_UNSPECIFIED "न्यूयॉर्क शहर के रेस्टोरेंट" जैसी कैटगरी से जुड़ी क्वेरी के लिए, RELEVANCE डिफ़ॉल्ट होता है. हमारा सुझाव है कि "माउंटेन व्यू, सीए" जैसी अन्य कैटगरी से जुड़ी क्वेरी के लिए, आप RankPreference को सेट न करें.
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)

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

ContextualContent

एक्सपेरिमेंटल: ज़्यादा जानकारी के लिए, https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative पर जाएं.

जगह से जुड़ी क्वेरी के हिसाब से कॉन्टेंट.

जेएसओएन के काेड में दिखाना 
{
  "reviews": [
    {
      object (Review)
    }
  ],
  "photos": [
    {
      object (Photo)
    }
  ],
  "justifications": [
    {
      object (Justification)
    }
  ]
}
फ़ील्ड
reviews[]

object (Review)

इस जगह की समीक्षाओं की सूची, जगह से जुड़ी क्वेरी से जारी.
photos[]

object (Photo)

इस जगह की फ़ोटो के बारे में जानकारी (इसमें पहचान फ़ाइलें भी शामिल हैं). यह जगह से जुड़ी क्वेरी से जुड़ी है.
justifications[]

object (Justification)

एक्सपेरिमेंटल: ज़्यादा जानकारी के लिए, https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative पर जाएं.

जगह के लिए वजहें.

सही ठहराने की वजह

एक्सपेरिमेंटल: ज़्यादा जानकारी के लिए, https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative पर जाएं.

जगह के लिए वजहें. वजहों से इस सवाल का जवाब मिलता है कि कोई जगह असली उपयोगकर्ता में दिलचस्पी क्यों ले सकती है.

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

  // Union field justification can be only one of the following:
  "reviewJustification": {
    object (ReviewJustification)
  },
  "businessAvailabilityAttributesJustification": {
    object (BusinessAvailabilityAttributesJustification)
  }
  // End of list of possible types for union field justification.
}
फ़ील्ड

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

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

object (ReviewJustification)

एक्सपेरिमेंटल: ज़्यादा जानकारी के लिए, https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative पर जाएं.
businessAvailabilityAttributesJustification

object (BusinessAvailabilityAttributesJustification)

एक्सपेरिमेंटल: ज़्यादा जानकारी के लिए, https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative पर जाएं.

ReviewJustification

एक्सपेरिमेंटल: ज़्यादा जानकारी के लिए, https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative पर जाएं.

उपयोगकर्ता की ओर से की गई समीक्षा की वजहें. यह उपयोगकर्ता की समीक्षा के उस सेक्शन को हाइलाइट करता है जिसमें असली उपयोगकर्ता की दिलचस्पी हो सकती है. उदाहरण के लिए, अगर खोज क्वेरी "फ़ायरवुड पिज़्ज़ा" है, तो क्वेरी के हिसाब से काम के टेक्स्ट को समीक्षा की वजह से हाइलाइट किया जाता है.

जेएसओएन के काेड में दिखाना 
{
  "highlightedText": {
    object (HighlightedText)
  },
  "review": {
    object (Review)
  }
}
फ़ील्ड
highlightedText

object (HighlightedText)
review

object (Review)

वह समीक्षा जिससे हाइलाइट किया गया टेक्स्ट जनरेट किया गया है.

HighlightedText

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

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

string
highlightedTextRanges[]

object (HighlightedTextRange)

हाइलाइट किए गए टेक्स्ट के रेंज की सूची.

HighlightedTextRange

हाइलाइट किए गए टेक्स्ट की रेंज.

जेएसओएन के काेड में दिखाना 
{
  "startIndex": integer,
  "endIndex": integer
}
फ़ील्ड
startIndex

integer
endIndex

integer

BusinessAvailabilityAttributesJustification

एक्सपेरिमेंटल: ज़्यादा जानकारी के लिए, https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative पर जाएं. BusinessAvailability एट्रिब्यूट की वजहें. यह कारोबार के कुछ ऐसे एट्रिब्यूट दिखाता है जो असली उपयोगकर्ता में दिलचस्पी दिखा सकते हैं.

जेएसओएन के काेड में दिखाना 
{
  "takeout": boolean,
  "delivery": boolean,
  "dineIn": boolean
}
फ़ील्ड
takeout

boolean

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

boolean

क्या कोई जगह डिलीवरी की सुविधा देती है.
dineIn

boolean

अगर किसी जगह पर बैठकर खाने की सुविधा है.