Method: searchText

टेक्स्ट क्वेरी की मदद से जगहें खोजें.

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

POST https://mapstools.googleapis.com/v1alpha:searchText

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

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

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

JSON के काेड में दिखाना 
{
  "textQuery": string,
  "languageCode": string,
  "regionCode": string,
  "pageSize": integer,
  "includeExtendedDetails": boolean,
  "locationBias": {
    object (LocationBias)
  }
}
फ़ील्ड
textQuery

string

ज़रूरी है. टेक्स्ट क्वेरी.
languageCode

string

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

उदाहरण के लिए, अंग्रेज़ी के लिए "en".

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

string

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

उदाहरण के लिए, अमेरिका के लिए "US".

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

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

integer

ज़रूरी नहीं. ज़्यादा से ज़्यादा 10 जगहों की जानकारी दिखाई जा सकती है. सेवा, इस वैल्यू से कम नतीजे दिखा सकती है. डिफ़ॉल्ट वैल्यू 5 है.

पांच से ज़्यादा जगहों के लिए अनुरोध करने पर, Pro टियर ट्रिगर हो जाएगा. इससे बिलिंग की लागत और इंतज़ार का समय बढ़ जाएगा.
includeExtendedDetails

boolean

ज़रूरी नहीं. जवाब में, जगह की ज़्यादा जानकारी शामिल होती है.

जब उपयोगकर्ता के अनुरोध के लिए, बेहतर क्वालिटी वाली अहम जानकारी, रीयल-टाइम डाइनैमिक या इकाई की खास विशेषताओं की ज़रूरत हो, तो इस फ़ील्ड को true पर सेट करें: - क्वालिटी वाली समीक्षाएं, ग्राहक की भावना, और सुझाव/राय/शिकायत. - खास ऑफ़र, जैसे कि मेन्यू आइटम, पकवान, खास तरह का खाना, पेय पदार्थ या कारोबार की खास बातें. - माहौल, इंटीरियर डेकोर, एस्थेटिक, ऐंबियंस या मूड की क्वालिटी. - रीयल-टाइम डेटा और खास सुविधाओं की जानकारी, विज़िटर के लिए नीतियां/सलाह, और इंतज़ार का समय.

स्टैंडर्ड डिस्कवरी सर्च (जैसे, पकवान, स्टोर के टाइप), जगह/पते की जानकारी, संपर्क जानकारी, कारोबार के खुले होने का समय, और स्टैंडर्ड मेटाडेटा/सुविधाओं के लिए, false (डिफ़ॉल्ट) को चुनें.

इस फ़ील्ड को चालू करने पर, Pro टियर ट्रिगर हो जाएगा. इससे बिलिंग की कुल लागत और इंतज़ार का समय बढ़ जाएगा.
locationBias

object (LocationBias)

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

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

कामयाब रहने पर, जवाब के मुख्य हिस्से में SearchTextResponse का एक इंस्टेंस शामिल किया जाता है.

अनुमति पाने के लिंक

नीचे दिए गए OAuth के लिंक की ज़रूरत हाेती है:

  • https://www.googleapis.com/auth/maps-platform.mapstools