Method: places.searchText

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

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

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

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

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

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

JSON के काेड में दिखाना 
{
  "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.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_ प्रोग्राम की गड़बड़ी मिलेगी.

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

integer

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

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

string

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

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

enum (PriceLevel)

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

boolean

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

object (LocationBias)

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

object (LocationRestriction)

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

object (EVOptions)

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

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

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

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

JSON के काेड में दिखाना 
{
  "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

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

JSON के काेड में दिखाना 
{

  // 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

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

JSON के काेड में दिखाना 
{

  // 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

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

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

number

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

enum (EVConnectorType)

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

ContextualContent

प्रयोग के तौर पर उपलब्ध: ज़्यादा जानकारी के लिए, https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative पर जाएं.

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

JSON के काेड में दिखाना 
{
  "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 पर जाएं.

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

JSON के काेड में दिखाना 
{

  // 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 पर जाएं.

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

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

object (HighlightedText)
review

object (Review)

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

HighlightedText

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

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

string
highlightedTextRanges[]

object (HighlightedTextRange)

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

HighlightedTextRange

हाइलाइट किए गए टेक्स्ट की सीमा.

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

integer
endIndex

integer

BusinessAvailabilityAttributesJustification

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

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

boolean

अगर कोई जगह टेकआउट की सुविधा देती है.
delivery

boolean

अगर यहां डिलीवरी की सुविधा है.
dineIn

boolean

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