MCP Tools Reference: mapstools.googleapis.com

Tool: compute_routes

Berechnet eine Route zwischen einem angegebenen Start- und Zielort. Unterstützte Mobilitätsformen:DRIVE (Standard), WALK.

Anforderungen an die Eingabe (WICHTIG): Sowohl Ursprung als auch Ziel sind erforderlich. Jeder Wert muss mit einer der folgenden Methoden im jeweiligen Feld angegeben werden:

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

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

  • place_id:: (String, z.B. 'ChIJOwE_Id1w5EAR4Q27FkL6T_0') Hinweis: Diese ID kann über das Tool „search_places“ abgerufen werden. Beliebige Kombinationen von Eingabetypen sind zulässig, z.B. Startpunkt nach Adresse und Zielpunkt nach lat_lng. Wenn der Start- oder Zielort fehlt, MÜSSEN Sie den Nutzer um Klärung bitten, bevor Sie versuchen, das Tool aufzurufen.

Beispiel für Tool-Aufruf: {"origin":{"address":"Eiffel Tower"},"destination":{"place_id":"ChIJt_5xIthw5EARoJ71mGq7t74"},"travel_mode":"DRIVE"}

Im folgenden Beispiel wird gezeigt, wie Sie mit curl das MCP-Tool compute_routes 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": "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. Start-Wegpunkt.
destination

object (Waypoint)

Erforderlich. Ziel-Wegpunkt.
travelMode

enum (RouteTravelMode)

Optional. Gibt die Mobilitätsform an.

Zwischenstopp

JSON-Darstellung 
{

  // Union field location_type can be only one of the following:
  "latLng": {
    object (google.type.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 (google.type.LatLng)

Ein Punkt, der mit geografischen Koordinaten angegeben wird.
placeId

string

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

string

Eine lesbare Adresse oder ein 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
}
Felder
distanceMeters

integer

Die zurückzulegende Strecke der Route in Metern.
duration

string (Duration format)

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

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

Dauer

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

string (int64 format)

Signierte Sekunden des Zeitraums. Muss zwischen -315.576.000.000 und +315.576.000.000 (einschließlich) liegen. Hinweis: Diese Grenzen werden so berechnet: 60 Sek./Min. × 60 Min./Std. × 24 Std./Tag × 365,25 Tage/Jahr × 10.000 Jahre
nanos

integer

Signierte Sekundenbruchteile mit Nanosekunden-Auflösung für den Zeitraum. Dauern von weniger als einer Sekunde werden mit dem Feld seconds = 0 und einem positiven oder negativen Feld nanos dargestellt. Bei Zeiträumen 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 (einschließlich).

Tool-Annotationen

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