MCP Tools Reference: mapstools.googleapis.com

Tool: search_places

Rufen Sie dieses Tool auf, wenn der Nutzer nach Orten, Unternehmen, Adressen, Standorten, Sehenswürdigkeiten oder anderen Google Maps-bezogenen Suchanfragen sucht.

Anforderungen an die Eingabe (WICHTIG):

  1. text_query (String – ERFORDERLICH): Die primäre Suchanfrage. Darin muss klar definiert werden, wonach der Nutzer sucht.

    • Beispiele: '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'.
    • Für bestimmte Ortsdetails:Fügen Sie das angeforderte Attribut hinzu (z.B. 'Google Store Mountain View opening hours', 'SF MoMa phone number', 'Shoreline Park Mountain View address').

  2. location_bias (Objekt – OPTIONAL): Damit können Sie Ergebnisse in der Nähe eines bestimmten geografischen Gebiets priorisieren.

    • Format:{"location_bias": {"circle": {"center": {"latitude": [value], "longitude": [value]}, "radius_meters": [value (optional)]}}}
    • Verwendung:
      • Um einen Radius von 5 km zu bevorzugen:{"location_bias": {"circle": {"center": {"latitude": 34.052235, "longitude": -118.243683}, "radius_meters": 5000}}}
      • Starke Gewichtung des Mittelpunkts: {"location_bias": {"circle": {"center": {"latitude": 34.052235, "longitude": -118.243683}}}} (radius_meters wird ausgelassen).

  3. language_code (String – OPTIONAL): Die Sprache, in der die Zusammenfassung der Suchergebnisse angezeigt werden soll.

    • Format:Ein zweistelliger Sprachcode (ISO 639-1), optional gefolgt von einem Unterstrich und einem zweistelligen Ländercode (ISO 3166-1 Alpha-2), z.B. en, ja, en_US, zh_CN, es_MX. Wenn der Sprachcode nicht angegeben ist, werden die Ergebnisse auf Englisch angezeigt.

  4. region_code (String – OPTIONAL): Der Unicode-CLDR-Regionscode des Nutzers. Mit diesem Parameter werden die Ortsdetails angezeigt, z. B. der regionsspezifische Ortsname, sofern verfügbar. Der Parameter kann sich je nach anwendbarem Recht auf die Ergebnisse auswirken.

    • Format:Ein zweistelliger Ländercode (ISO 3166-1 alpha-2), z.B. US, CA.

Instructions for Tool Call:

  • Standortinformationen (KRITISCH): Die Suche muss ausreichend Standortinformationen enthalten. Wenn der Standort nicht eindeutig ist (z.B. nur „Pizzerien“), müssen Sie ihn im text_query angeben (z.B. „Pizzerien in New York“) oder den Parameter location_bias verwenden. Geben Sie bei Bedarf den Namen der Stadt, des Bundesstaats/der Provinz und der Region/des Landes an, um Mehrdeutigkeiten zu vermeiden.

  • Geben Sie immer die spezifischste und kontextbezogenste text_query an, die möglich ist.

  • Verwenden Sie location_bias nur, wenn Koordinaten explizit angegeben werden oder wenn das Ableiten eines Standorts aus dem bekannten Kontext eines Nutzers angemessen und für bessere Ergebnisse erforderlich ist.

  • Die fundierte Ausgabe muss der Quelle zugeordnet werden. Verwenden Sie dazu die Informationen aus dem Feld attribution, sofern verfügbar.

Im folgenden Beispiel wird gezeigt, wie Sie mit curl das MCP-Tool search_places aufrufen.

Curl-Anfrage 
                  
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
}'

Eingabeschema

Anfragenachricht für SearchText.

SearchTextRequest

JSON-Darstellung 
{
  "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.
}
Felder
textQuery

string

Erforderlich. Die Textabfrage.
languageCode

string

Optional. Die Sprache, in der die Zusammenfassung zurückgegeben werden soll. Wenn der Sprachcode nicht angegeben oder nicht erkannt wird, wird die Zusammenfassung mit einer Präferenz für Englisch zurückgegeben.

Beispiel: „en“ für Englisch.

Aktuelle Liste der unterstützten Sprachen: https://developers.google.com/maps/faq#languagesupport.
regionCode

string

Optional. Der Länder-/Regionscode (CLDR) des Standorts, von dem die Anfrage stammt, im Unicode-Format. Mit diesem Parameter werden die Ortsdetails angezeigt, z. B. der regionsspezifische Ortsname, sofern verfügbar. Der Parameter kann sich je nach anwendbarem Recht auf die Ergebnisse auswirken.

Beispiel: „US“ für die USA.

Weitere Informationen finden Sie unter https://www.unicode.org/cldr/charts/latest/supplemental/territory_language_information.html.

Hinweis: Dreistellige Ländercodes werden derzeit nicht unterstützt.
pageSize

integer

Optional. Die maximale Anzahl der zurückzugebenden Orte. Der Dienst gibt möglicherweise weniger als diesen Wert zurück.
pageToken

string

Optional. Ein Seitentoken, das von einem vorherigen SearchText-Aufruf empfangen wurde. Geben Sie dieses an, um die nachfolgende Seite abzurufen.

Union-Feld _location_bias.

Für _location_bias ist nur einer der folgenden Werte zulässig:
locationBias

object (LocationBias)

Eine optionale Region, auf die die Suchergebnisse ausgerichtet werden sollen. Wenn in text_query ein expliziter Standort angegeben ist, wird dieser anstelle dieses Felds verwendet, um die Suchergebnisse zu gewichten.

LocationBias

JSON-Darstellung 
{
  "circle": {
    object (Circle)
  }
}
Felder
circle

object (Circle)

Optional. Ein Kreis, der durch Mittelpunkt und Radius definiert wird. radius_meters ist optional. Wenn nichts anderes festgelegt ist, werden die Ergebnisse auf den Mittelpunkt ausgerichtet.

Kreis

JSON-Darstellung 
{
  "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.
}
Felder
center

object (LatLng)

Erforderlich. Der Mittelpunkt des Kreises.

Union-Feld _radius_meters.

Für _radius_meters ist nur einer der folgenden Werte zulässig:
radiusMeters

number

Der Radius des Kreises in Metern. Der Radius darf maximal 50.000 Meter betragen.

LatLng

JSON-Darstellung 
{
  "latitude": number,
  "longitude": number
}
Felder
latitude

number

Der Breitengrad in Grad. Er muss im Bereich [-90,0, +90,0] liegen.
longitude

number

Der Längengrad in Grad. Er muss im Bereich [-180,0, +180,0] liegen.

Ausgabeschema

Antwortnachricht für SearchText.

SearchTextResponse

JSON-Darstellung 
{
  "places": [
    {
      object (PlaceView)
    }
  ],
  "summary": string,
  "nextPageToken": string
}
Felder
places[]

object (PlaceView)

Nur Ausgabe. Die Liste der Orte, die in der Zusammenfassung erwähnt werden.
summary

string

Nur Ausgabe. Eine Zusammenfassung der Suchergebnisse in natürlicher Sprache. Die Zusammenfassung kann nullbasierte Zitationen wie „[0]“, „[1]“, „[2]“ usw. enthalten. Diese Zitationen werden den entsprechenden Stellen im Feld places zugeordnet.
nextPageToken

string

Optional. Ein Token, das als page_token gesendet werden kann, um die nächste Seite abzurufen.

PlaceView

JSON-Darstellung 
{
  "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.
}
Felder
place

string

Der Ressourcenname des zugrunde liegenden Orts im Format „places/{id}“.
id

string

Die Orts-ID des zugrunde liegenden Orts.
googleMapsLinks

object (GoogleMapsLinks)

Links zum Auslösen verschiedener Google Maps-Aktionen.
attribution

object (Attribution)

Erforderliche Quellenangabe, die mit dem Ort angezeigt werden soll.

Union-Feld _location.

Für _location ist nur einer der folgenden Werte zulässig:
location

object (LatLng)

Die Position dieses Orts.

LatLng

JSON-Darstellung 
{
  "latitude": number,
  "longitude": number
}
Felder
latitude

number

Der Breitengrad in Grad. Er muss im Bereich [-90,0, +90,0] liegen.
longitude

number

Der Längengrad in Grad. Er muss im Bereich [-180,0, +180,0] liegen.
JSON-Darstellung 
{
  "directionsUrl": string,
  "placeUrl": string,
  "writeAReviewUrl": string,
  "reviewsUrl": string,
  "photosUrl": string
}
Felder
directionsUrl

string

Ein Link, über den die Route zum Ort angezeigt wird. Der Link füllt nur den Zielort aus und verwendet den Standard-Fahrmodus DRIVE.
placeUrl

string

Ein Link, über den dieser Ort angezeigt wird.
writeAReviewUrl

string

Ein Link, über den Sie eine Rezension zu diesem Ort auf Google Maps schreiben können.
reviewsUrl

string

Ein Link, über den Sie Rezensionen zu diesem Ort in Google Maps aufrufen können.
photosUrl

string

Ein Link, über den Sie Fotos dieses Orts in Google Maps aufrufen können.

Attribution

JSON-Darstellung 
{
  "title": string,
  "url": string
}
Felder
title

string

Der Titel, der für die Quellenangabe angezeigt werden soll.
url

string

Die URL, die für die Quellenangabe verlinkt werden soll.

Tool-Annotationen

Destruktiver Hinweis: ❌ | Idempotenter Hinweis: ❌ | Hinweis „Nur lesen“: ✅ | Hinweis „Offene Welt“: ❌