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): खोज के नतीजों की खास जानकारी दिखाने के लिए भाषा.

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

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

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

Instructions for Tool Call:

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

  • हमेशा text_query में ज़्यादा से ज़्यादा सटीक और काम की जानकारी दें.

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

  • जवाब में दी गई जानकारी का स्रोत बताना ज़रूरी है. इसके लिए, attribution फ़ील्ड में मौजूद जानकारी का इस्तेमाल करें.

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

कर्ल अनुरोध 
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 MCP tool specification.
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

इनपुट स्कीमा

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

SearchTextRequest

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

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

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

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

object (LocationBias)

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

LocationBias

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

object (Circle)

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

सर्कल

JSON के काेड में दिखाना 
{
  "center": {
    object (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 (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
}
फ़ील्ड
places[]

object (PlaceView)

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

string

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

PlaceView

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

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

string

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

string

जगह का आईडी.
googleMapsLinks

object (GoogleMapsLinks)

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

object (Attribution)

जगह की जानकारी के साथ दिखाने के लिए एट्रिब्यूशन ज़रूरी है.

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

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

object (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 पर इस जगह की फ़ोटो दिखाने वाला लिंक.

एट्रिब्यूशन

JSON के काेड में दिखाना 
{
  "title": string,
  "url": string
}
फ़ील्ड
title

string

एट्रिब्यूशन के लिए दिखाने जाने वाला टाइटल.
url

string

एट्रिब्यूशन के लिए लिंक करने का यूआरएल.

टूल एनोटेशन

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

टाइटल स्ट्रिंग के साथ-साथ, यहां दिए गए बूलियन हिंट भी तय किए गए हैं:

  • readOnlyHint: अगर यह सही है, तो टूल अपने एनवायरमेंट में बदलाव नहीं करता है. डिफ़ॉल्ट: गलत.
  • destructiveHint: अगर यह वैल्यू 'सही है' पर सेट है, तो टूल, डेटा को मिटाने जैसी कार्रवाइयां कर सकता है. अगर यह वैल्यू 'गलत है' पर सेट है, तो टूल सिर्फ़ जोड़ने वाली कार्रवाइयां कर सकता है. डिफ़ॉल्ट: सही.
  • idempotentHint: अगर यह वैल्यू सही है, तो एक ही आर्ग्युमेंट के साथ टूल को बार-बार कॉल करने से, इसके एनवायरमेंट पर कोई अतिरिक्त असर नहीं पड़ेगा. डिफ़ॉल्ट: गलत.
  • openWorldHint: अगर यह वैल्यू सही है, तो टूल बाहरी इकाइयों के 'ओपन वर्ल्ड' के साथ इंटरैक्ट कर सकता है. अगर यह वैल्यू 'गलत है' पर सेट है, तो टूल सिर्फ़ इंटरनल इकाइयों के साथ इंटरैक्ट कर सकता है. उदाहरण के लिए, वेब पर खोज करने वाला टूल ओपन वर्ल्ड होगा, जबकि मेमोरी टूल ओपन वर्ल्ड नहीं होगा.

बदलाव करने वाला सुराग: ❌ | एक ही बार इस्तेमाल किया जा सकने वाला सुराग: ❌ | सिर्फ़ पढ़ने वाला सुराग: ✅ | ओपन वर्ल्ड सुराग: ❌