MCP Tools Reference: mapstools.googleapis.com

Tool: compute_routes

Berechnet eine Reiseroute zwischen einem angegebenen Start- und Zielort. Unterstützte Reisemodi:DRIVE (Standard), WALK.

Eingabeanforderungen (KRITISCH) : Sowohl origin als auch destination sind erforderlich. Jeder Wert muss mit einer der folgenden Methoden angegeben werden, die in das jeweilige Feld eingebettet ist:

  • address : (String, z.B. „Eiffelturm, Paris“). Hinweis: Je detaillierter oder spezifischer die eingegebene Adresse ist, desto besser sind die Ergebnisse.

  • lat_lng: : (Objekt, {"latitude": Zahl, "longitude": Zahl})

  • place_id: : (String, z.B. „ChIJOwE_Id1w5EAR4Q27FkL6T_0“) Hinweis: Diese ID kann mit dem Tool „search_places“ abgerufen werden. Jede Kombination von Eingabetypen ist zulässig (z.B. Startort nach Adresse, Zielort nach lat_lng). Wenn der Start- oder Zielort fehlt, müssen Sie den Nutzer um eine Klarstellung bitten , bevor Sie versuchen, das Tool aufzurufen.

Beispiel für einen Toolaufruf : {"origin":{"address":"Eiffel Tower"},"destination":{"place_id":"ChIJt_5xIthw5EARoJ71mGq7t74"},"travel_mode":"DRIVE"}

  • Die begründete Ausgabe muss der Quelle mit den Informationen aus dem Feld attribution zugeschrieben werden, sofern verfügbar.

Die folgenden Beispiele zeigen, wie Sie curl verwenden, um das MCP-Tool compute_routes aufzurufen.

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": "compute_routes",
    "arguments": {
      // provide these details according to the tool's MCP specification
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

Eingabeschema

ComputeRoutesRequest.

ComputeRoutesRequest

JSON-Darstellung 
{
  "origin": {
    object (Waypoint)
  },
  "destination": {
    object (Waypoint)
  },
  "travelMode": enum (RouteTravelMode)
}
Felder
origin

object (Waypoint)

Erforderlich. Startort
destination

object (Waypoint)

Erforderlich. Ziel-Wegpunkt.
travelMode

enum (RouteTravelMode)

Optional. Gibt das Verkehrsmittel an.

Waypoint

JSON-Darstellung 
{

  // Union field location_type can be only one of the following:
  "latLng": {
    object (LatLng)
  },
  "placeId": string,
  "address": string
  // End of list of possible types for union field location_type.
}
Felder
Union-Feld location_type. Verschiedene Möglichkeiten, einen Ort darzustellen. Für location_type ist nur einer der folgenden Werte zulässig:
latLng

object (LatLng)

Ein Punkt, der mit geografischen Koordinaten angegeben wird.
placeId

string

Die Orts-ID, die dem Zwischenstopp zugeordnet ist.
address

string

Lesbare Adresse oder Plus Code. Weitere Informationen finden Sie unter https://plus.codes.

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

ComputeRoutesResponse.

ComputeRoutesResponse

JSON-Darstellung 
{
  "routes": [
    {
      object (Route)
    }
  ]
}
Felder
routes[]

object (Route)

Enthält Routen zwischen dem angeforderten Start- und Zielort. Derzeit wird nur eine Route zurückgegeben.

Route

JSON-Darstellung 
{
  "distanceMeters": integer,
  "duration": string,
  "attribution": {
    object (Attribution)
  }
}
Felder
distanceMeters

integer

Die Reisedistanz der Route in Metern.
duration

string (Duration format)

Die Zeit, die für die Navigation auf der Route benötigt wird.

Die Dauer in Sekunden mit bis zu neun Nachkommastellen und am Ende mit „s“. Beispiel: "3.5s".
attribution

object (Attribution)

Erforderliche Attribution, die mit der Route angezeigt werden soll.

Dauer

JSON-Darstellung 
{
  "seconds": string,
  "nanos": integer
}
Felder
seconds

string (int64 format)

Vorzeichenbehaftete Sekunden der Zeitspanne. Muss zwischen -315.576.000.000 und +315.576.000.000 liegen. Hinweis: Diese Grenzwerte werden so berechnet: 60 Sekunden/Minute * 60 Minuten/Stunde * 24 Stunden/Tag * 365,25 Tage/Jahr * 10.000 Jahre
nanos

integer

Vorzeichenbehaftete Sekundenbruchteile der Zeitspanne in Nanosekunden. Dauern von weniger als einer Sekunde werden mit einem Feld seconds mit dem Wert 0 und einem positiven oder negativen Feld nanos dargestellt. Bei Dauern von einer Sekunde oder mehr muss ein Wert ungleich null für das Feld nanos dasselbe Vorzeichen wie das Feld seconds haben. Muss zwischen -999.999.999 und +999.999.999 liegen.

Attribution

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

string

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

string

Die URL, zu der für die Attribution verlinkt werden soll.

Toolanmerkungen

Destruktiver Hinweis: ❌ | Idempotenter Hinweis: ❌ | Schreibgeschützter Hinweis: ✅ | Hinweis zur offenen Welt: ❌