MCP Tools Reference: mapstools.googleapis.com

Narzędzie: search_places

Użyj tego narzędzia, gdy użytkownik chce znaleźć miejsca, firmy, adresy, lokalizacje, ciekawe miejsca lub inne informacje związane z Mapami Google.

Wymagania dotyczące danych wejściowych (KRYTYCZNE):

  1. text_query (ciąg znaków – OBOWIĄZKOWY): główne zapytanie. Musi on jasno określać, czego szuka użytkownik.

    • Przykłady: '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'.
    • Szczegóły konkretnego miejsca: podaj wymagany atrybut (np. 'Google Store Mountain View opening hours', 'SF MoMa phone number', 'Shoreline Park Mountain View address').

  2. location_bias (obiekt – OPCJONALNIE): użyj tego parametru, aby nadać priorytet wynikom w pobliżu określonego obszaru geograficznego.

    • Format: {"location_bias": {"circle": {"center": {"latitude": [value], "longitude": [value]}, "radius_meters": [value (optional)]}}}
    • Użycie:
      • Aby ustawić preferencje dla promienia 5 km: {"location_bias": {"circle": {"center": {"latitude": 34.052235, "longitude": -118.243683}, "radius_meters": 5000}}}
      • Aby silnie faworyzować punkt środkowy: {"location_bias": {"circle": {"center": {"latitude": 34.052235, "longitude": -118.243683}}}} (pomijając radius_meters).

  3. language_code (ciąg znaków – OPCJONALNIE): język, w którym ma być wyświetlane podsumowanie wyników wyszukiwania.

    • Format: dwuliterowy kod języka (ISO 639-1), opcjonalnie z podkreśleniem i dwuliterowym kodem kraju (ISO 3166-1 alfa-2), np. en, ja, en_US, zh_CN, es_MX. Jeśli nie podasz kodu języka, wyniki będą w języku angielskim.

  4. region_code (ciąg znaków – OPCJONALNY): kod regionu CLDR użytkownika w Unicode. Ten parametr służy do wyświetlania szczegółów miejsca, np. nazwy miejsca w danym regionie, jeśli jest dostępna. W zależności od obowiązujących przepisów parametr może wpływać na wyniki.

    • Format: dwuliterowy kod kraju (ISO 3166-1 alfa-2), np. US, CA.

Instrukcje dotyczące wywołania narzędzia:

  • Informacje o lokalizacji (KRYTYCZNE): wyszukiwanie musi zawierać wystarczające informacje o lokalizacji. Jeśli lokalizacja jest niejednoznaczna (np. tylko „pizzerie”), musisz ją określić w parametrze text_query (np. „pizzerie w Nowym Jorku”) lub użyj parametru location_bias. W razie potrzeby podaj nazwę miasta, stanu/prowincji i regionu/kraju, aby uniknąć niejednoznaczności.

  • Zawsze podawaj jak najbardziej szczegółowe i bogate w kontekst text_query.

  • Używaj tylko location_bias, jeśli współrzędne są wyraźnie podane lub jeśli wywnioskowanie lokalizacji z kontekstu znanego użytkownikowi jest odpowiednie i konieczne do uzyskania lepszych wyników.

Poniższy przykład pokazuje, jak za pomocą curl wywołać narzędzie search_places MCP.

Żądanie 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
}'

Schemat danych wejściowych

Wiadomość z prośbą o wywołanie funkcji SearchText.

SearchTextRequest

Zapis 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.
}
Pola
textQuery

string

Wymagane. Zapytanie tekstowe.
languageCode

string

Opcjonalnie: Język, w którym ma zostać zwrócone podsumowanie. Jeśli kod języka jest nieokreślony lub nierozpoznany, zwracane jest podsumowanie w języku angielskim.

Na przykład „pl” w przypadku języka polskiego.

Aktualna lista obsługiwanych języków: https://developers.google.com/maps/faq#languagesupport.
regionCode

string

Opcjonalnie: Kod Unicode kraju lub regionu (CLDR) lokalizacji, z której pochodzi żądanie. Ten parametr służy do wyświetlania szczegółów miejsca, np. nazwy miejsca w danym regionie, jeśli jest dostępna. W zależności od obowiązujących przepisów parametr może wpływać na wyniki.

Na przykład „PL” w przypadku Polski.

Więcej informacji znajdziesz na stronie https://www.unicode.org/cldr/charts/latest/supplemental/territory_language_information.html.

Pamiętaj, że 3-cyfrowe kody regionów nie są obecnie obsługiwane.
pageSize

integer

Opcjonalnie: Maksymalna liczba miejsc do zwrócenia. Usługa może zwrócić mniej niż ta wartość.
pageToken

string

Opcjonalnie: Token strony otrzymany z poprzedniego wywołania SearchText. Podaj ten token, aby pobrać kolejną stronę.

Pole zbiorcze _location_bias.

Pole _location_bias może mieć tylko jedną z tych wartości:
locationBias

object (LocationBias)

Opcjonalny region, który ma wpływać na wyniki wyszukiwania. Jeśli w polu text_query znajduje się konkretna lokalizacja, będzie ona używana do określania wyników wyszukiwania zamiast tego pola.

LocationBias

Zapis JSON 
{
  "circle": {
    object (Circle)
  }
}
Pola
circle

object (Circle)

Opcjonalnie: Okrąg zdefiniowany przez punkt środkowy i promień. Symbol radius_meters jest opcjonalny. Jeśli nie zostanie ustawiona, wyniki będą bardziej zbliżone do punktu środkowego.

Okrąg

Zapis 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.
}
Pola
center

object (google.type.LatLng)

Wymagane. Środek okręgu.

Pole zbiorcze _radius_meters.

Pole _radius_meters może mieć tylko jedną z tych wartości:
radiusMeters

number

Promień okręgu w metrach. Promień musi wynosić maksymalnie 50 000 metrów.

LatLng

Zapis JSON 
{
  "latitude": number,
  "longitude": number
}
Pola
latitude

number

Szerokość geograficzna w stopniach. Musi mieścić się w zakresie od –90,0 do +90,0.
longitude

number

Długość geograficzna w stopniach. Musi mieścić się w zakresie [–180,0, +180,0].

Schemat wyjściowy

Wiadomość z odpowiedzią dla SearchText.

SearchTextResponse

Zapis JSON 
{
  "places": [
    {
      object (PlaceView)
    }
  ],
  "summary": string,
  "nextPageToken": string
}
Pola
places[]

object (PlaceView)

Tylko dane wyjściowe. Lista miejsc, które są wymienione w podsumowaniu.
summary

string

Tylko dane wyjściowe. Podsumowanie wyników wyszukiwania w języku naturalnym. Podsumowanie może zawierać cytaty oparte na zerowym indeksie, np. „[0]”, „[1]”, „[2]” itp. Te cytaty są powiązane z odpowiednimi miejscami w polu places.
nextPageToken

string

Opcjonalnie: Token, który można wysłać jako page_token, aby pobrać następną stronę.

PlaceView

Zapis 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.
}
Pola
place

string

Nazwa zasobu miejsca w formacie „places/{id}”.
id

string

Identyfikator miejsca bazowego.
googleMapsLinks

object (GoogleMapsLinks)

Linki do uruchamiania różnych działań w Mapach Google.

Pole zbiorcze _location.

Pole _location może mieć tylko jedną z tych wartości:
location

object (google.type.LatLng)

Położenie tego miejsca.

LatLng

Zapis JSON 
{
  "latitude": number,
  "longitude": number
}
Pola
latitude

number

Szerokość geograficzna w stopniach. Musi mieścić się w zakresie od –90,0 do +90,0.
longitude

number

Długość geograficzna w stopniach. Musi mieścić się w zakresie [–180,0, +180,0].
Zapis JSON 
{
  "directionsUrl": string,
  "placeUrl": string,
  "writeAReviewUrl": string,
  "reviewsUrl": string,
  "photosUrl": string
}
Pola
directionsUrl

string

Link do wskazówek dojazdu do miejsca. Link zawiera tylko miejsce docelowe i domyślny środek transportu DRIVE.
placeUrl

string

Link do wyświetlenia tego miejsca.
writeAReviewUrl

string

Link do napisania opinii o tym miejscu w Mapach Google.
reviewsUrl

string

link do opinii o tym miejscu w Mapach Google;
photosUrl

string

link do opinii o tym miejscu w Mapach Google;

Adnotacje do narzędzi

Destructive Hint: ❌ | Idempotent Hint: ❌ | Read Only Hint: ✅ | Open World Hint: ❌