MCP Tools Reference: mapstools.googleapis.com

टूल: search_places

उपयोगकर्ता की अनुरोध में जगहें, कारोबार, पते, जगहें, दिलचस्पी की जगहें या Google Maps से जुड़ी कोई अन्य खोज करने के लिए कहा गया हो, तो इस टूल को कॉल करें.

इनपुट से जुड़ी ज़रूरी शर्तें (अहम):

  1. text_query (string - ज़रूरी है): यह मुख्य खोज क्वेरी होती है. इसमें साफ़ तौर पर बताया जाना चाहिए कि उपयोगकर्ता क्या ढूंढ रहा है.

    • उदाहरण: 'restaurants in New York', 'coffee shops near Golden Gate Park', 'SF MoMA', '1600 Amphitheatre Pkwy, Mountain View, CA, USA', 'pets friendly parks in Manhattan, New York', 'date night restaurants in Chicago', 'accessible public libraries in Los Angeles'.
    • किसी जगह के बारे में जानकारी पाने के लिए: अनुरोध किए गए एट्रिब्यूट को शामिल करें. उदाहरण के लिए, 'Google Store Mountain View opening hours', 'SF MoMa phone number', 'Shoreline Park Mountain View address').

  2. location_bias (object - OPTIONAL): इसका इस्तेमाल, किसी खास भौगोलिक जगह के आस-पास के नतीजों को प्राथमिकता देने के लिए करें.

    • फ़ॉर्मैट: {"location_bias": {"circle": {"center": {"latitude": [value], "longitude": [value]}, "radius_meters": [value (optional)]}}}
    • इस्तेमाल:
      • 5 कि॰मी॰ के दायरे में खोज के नतीजों को प्राथमिकता देने के लिए: {"location_bias": {"circle": {"center": {"latitude": 34.052235, "longitude": -118.243683}, "radius_meters": 5000}}}
      • सेंटर पॉइंट को ज़्यादा प्राथमिकता देने के लिए: {"location_bias": {"circle": {"center": {"latitude": 34.052235, "longitude": -118.243683}}}} (radius_meters को छोड़कर).

  3. language_code (string - OPTIONAL): खोज के नतीजों की खास जानकारी दिखाने के लिए भाषा.

    • फ़ॉर्मैट: दो अक्षरों वाला भाषा कोड (आईएसओ 639-1). इसके बाद, वैकल्पिक तौर पर अंडरस्कोर और दो अक्षरों वाला देश कोड (आईएसओ 3166-1 ऐल्फ़ा-2) हो सकता है. उदाहरण के लिए, en, ja, en_US, zh_CN, es_MX. अगर भाषा कोड नहीं दिया गया है, तो नतीजे अंग्रेज़ी में दिखेंगे.

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

    • फ़ॉर्मैट: दो अक्षरों वाला देश का कोड (ISO 3166-1 alpha-2), जैसे कि US, CA.

Instructions for Tool Call:

  • जगह की जानकारी (ज़रूरी): खोज के नतीजों में जगह की पूरी जानकारी होनी चाहिए. अगर जगह की जानकारी साफ़ तौर पर नहीं दी गई है (जैसे, सिर्फ़ "पिज़्ज़ा की दुकानें"), तो आपको इसे text_query में बताना होगा (जैसे, "न्यूयॉर्क में पिज़्ज़ा बेचने वाली जगहें") या location_bias पैरामीटर का इस्तेमाल करें. अगर किसी जगह के बारे में ज़्यादा जानकारी देनी हो, तो शहर, राज्य/प्रांत, और देश/इलाके का नाम शामिल करें.

  • हमेशा text_query को ज़्यादा से ज़्यादा जानकारी के साथ सटीक बनाएँ.

  • location_bias का इस्तेमाल सिर्फ़ तब करें, जब निर्देशांक साफ़ तौर पर दिए गए हों या जब उपयोगकर्ता के जाने-पहचाने कॉन्टेक्स्ट से जगह की जानकारी का अनुमान लगाना सही और बेहतर नतीजों के लिए ज़रूरी हो.

यहां दिए गए सैंपल में, curl का इस्तेमाल करके search_places एमसीपी टूल को चालू करने का तरीका बताया गया है.

Curl अनुरोध 
                  
curl --location 'https://mapstools.googleapis.com/mcp' \
--header 'content-type: application/json' \
--header 'accept: application/json, text/event-stream' \
--data '{
  "method": "tools/call",
  "params": {
    "name": "search_places",
    "arguments": {
      // provide these details according to the tool's MCP specification
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

इनपुट स्कीमा

SearchText के लिए अनुरोध किया गया मैसेज.

SearchTextRequest

JSON के काेड में दिखाना 
{
  "textQuery": string,
  "languageCode": string,
  "regionCode": string,
  "pageSize": integer,
  "pageToken": string,

  // Union field _location_bias can be only one of the following:
  "locationBias": {
    object (LocationBias)
  }
  // End of list of possible types for union field _location_bias.
}
फ़ील्ड
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

ज़रूरी नहीं. ज़्यादा से ज़्यादा कितनी जगहों की जानकारी दिखानी है. ऐसा हो सकता है कि सेवा इस वैल्यू से कम नतीजे दिखाए.
pageToken

string

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

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

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

object (LocationBias)

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

LocationBias

JSON के काेड में दिखाना 
{
  "circle": {
    object (Circle)
  }
}
फ़ील्ड
circle

object (Circle)

ज़रूरी नहीं. केंद्र बिंदु और त्रिज्या से तय किया गया वृत्त. radius_meters ज़रूरी नहीं है. अगर इसे सेट नहीं किया जाता है, तो नतीजे सेंटर पॉइंट के हिसाब से दिखेंगे.

सर्कल

JSON के काेड में दिखाना 
{
  "center": {
    object (google.type.LatLng)
  },

  // Union field _radius_meters can be only one of the following:
  "radiusMeters": number
  // End of list of possible types for union field _radius_meters.
}
फ़ील्ड
center

object (google.type.LatLng)

ज़रूरी है. सर्कल का सेंटर पॉइंट.

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

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

number

सर्कल का दायरा, मीटर में. दायरा 50,000 मीटर के अंदर होना चाहिए.

LatLng

JSON के काेड में दिखाना 
{
  "latitude": number,
  "longitude": number
}
फ़ील्ड
latitude

number

डिग्री में अक्षांश. यह [-90.0, +90.0] की रेंज में होना चाहिए.
longitude

number

डिग्री में देशांतर. यह [-180.0, +180.0] की रेंज में होना चाहिए.

आउटपुट स्कीमा

SearchText के लिए जवाब का मैसेज.

SearchTextResponse

JSON के काेड में दिखाना 
{
  "places": [
    {
      object (PlaceView)
    }
  ],
  "summary": string,
  "nextPageToken": string
}
फ़ील्ड
places[]

object (PlaceView)

सिर्फ़ आउटपुट के लिए. जवाब में बताई गई जगहों की सूची.
summary

string

सिर्फ़ आउटपुट के लिए. खोज के नतीजों की खास जानकारी, आम भाषा में दी गई है. जवाब में "[0]", "[1]", "[2]" वगैरह जैसे ज़ीरो-आधारित उद्धरण शामिल हो सकते हैं. ये उद्धरण, places फ़ील्ड में मौजूद जगहों से मैप होते हैं.
nextPageToken

string

ज़रूरी नहीं. यह एक ऐसा टोकन है जिसे page_token के तौर पर भेजा जा सकता है, ताकि अगला पेज वापस पाया जा सके.

PlaceView

JSON के काेड में दिखाना 
{
  "place": string,
  "id": string,
  "googleMapsLinks": {
    object (GoogleMapsLinks)
  },

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

string

जगह के संसाधन का नाम, "places/{id}" फ़ॉर्मैट में होता है.
id

string

जगह का प्लेस आईडी.
googleMapsLinks

object (GoogleMapsLinks)

Google Maps पर अलग-अलग कार्रवाइयां ट्रिगर करने वाले लिंक.

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

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

object (google.type.LatLng)

इस जगह की पोज़िशन.

LatLng

JSON के काेड में दिखाना 
{
  "latitude": number,
  "longitude": number
}
फ़ील्ड
latitude

number

डिग्री में अक्षांश. यह [-90.0, +90.0] की रेंज में होना चाहिए.
longitude

number

डिग्री में देशांतर. यह [-180.0, +180.0] की रेंज में होना चाहिए.
JSON के काेड में दिखाना 
{
  "directionsUrl": string,
  "placeUrl": string,
  "writeAReviewUrl": string,
  "reviewsUrl": string,
  "photosUrl": string
}
फ़ील्ड
directionsUrl

string

जगह तक पहुंचने का रास्ता दिखाने वाला लिंक. यह लिंक सिर्फ़ डेस्टिनेशन की जगह की जानकारी भरता है और यात्रा के डिफ़ॉल्ट मोड DRIVE का इस्तेमाल करता है.
placeUrl

string

इस जगह को दिखाने के लिए लिंक.
writeAReviewUrl

string

Google Maps पर इस जगह के लिए समीक्षा लिखने का लिंक.
reviewsUrl

string

Google Maps पर इस जगह की समीक्षाएं दिखाने वाला लिंक.
photosUrl

string

Google Maps पर इस जगह की समीक्षाएं दिखाने वाला लिंक.

टूल एनोटेशन

डेटा में बदलाव करने वाला हिंट: ❌ | एक ही बार लागू होने वाला हिंट: ❌ | सिर्फ़ पढ़ने वाला हिंट: ✅ | ओपन वर्ल्ड हिंट: ❌