MCP Tools Reference: mapstools.googleapis.com

Herramienta: compute_routes

Calcula una ruta de viaje entre un origen y un destino especificados. Medios de transporte admitidos: DRIVE (predeterminado), WALK.

Requisitos de entrada (CRÍTICOS): Requiere origen y destino. Cada uno debe proporcionarse con uno de los siguientes métodos, anidado dentro de su campo respectivo:

  • address: (cadena, p.ej., "Torre Eiffel, París"). Nota: Cuanto más detallada o específica sea la dirección de entrada, mejores serán los resultados.

  • lat_lng: (objeto, {"latitude": número, "longitude": número})

  • place_id: (cadena, p.ej., "ChIJOwE_Id1w5EAR4Q27FkL6T_0") Nota: Este ID se puede obtener de la herramienta search_places. Se permite cualquier combinación de tipos de entrada (p.ej., origen por dirección, destino por lat_lng). Si falta el origen o el destino, DEBES pedirle al usuario que aclare la información antes de intentar llamar a la herramienta.

Ejemplo de llamada a herramienta: {"origin":{"address":"Eiffel Tower"},"destination":{"place_id":"ChIJt_5xIthw5EARoJ71mGq7t74"},"travel_mode":"DRIVE"}

En el siguiente ejemplo, se muestra cómo usar curl para invocar la herramienta de MCP compute_routes.

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

Esquema de entrada

Es un objeto ComputeRoutesRequest.

ComputeRoutesRequest

Representación JSON 
{
  "origin": {
    object (Waypoint)
  },
  "destination": {
    object (Waypoint)
  },
  "travelMode": enum (RouteTravelMode)
}
Campos
origin

object (Waypoint)

Obligatorio. Es el punto de ruta de origen.
destination

object (Waypoint)

Obligatorio. Es el punto de ruta de destino.
travelMode

enum (RouteTravelMode)

Opcional. Especifica el medio de transporte.

Punto de referencia

Representación JSON 
{

  // 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.
}
Campos
Campo de unión location_type. Diferentes formas de representar una ubicación. location_type puede ser solo uno de los parámetros siguientes:
latLng

object (google.type.LatLng)

Es un punto especificado con coordenadas geográficas.
placeId

string

Es el ID de lugar asociado con el punto de ruta.
address

string

Dirección legible o Plus Code. Visita https://plus.codes para obtener más información.

LatLng

Representación JSON 
{
  "latitude": number,
  "longitude": number
}
Campos
latitude

number

La latitud expresada en grados. Debe pertenecer al rango [-90.0, +90.0].
longitude

number

La longitud expresada en grados. Debe pertenecer al rango [-180.0, +180.0].

Esquema de salida

Es la respuesta de ComputeRoutes.

ComputeRoutesResponse

Representación JSON 
{
  "routes": [
    {
      object (Route)
    }
  ]
}
Campos
routes[]

object (Route)

Contiene rutas entre el origen y el destino solicitados. Actualmente, solo se muestra una ruta.

Ruta

Representación JSON 
{
  "distanceMeters": integer,
  "duration": string
}
Campos
distanceMeters

integer

Es la distancia de viaje de la ruta, en metros.
duration

string (Duration format)

Es el tiempo necesario para recorrer la ruta.

Una duración en segundos con hasta nueve dígitos decimales, que terminan en “s”. Ejemplo: "3.5s".

Duración

Representación JSON 
{
  "seconds": string,
  "nanos": integer
}
Campos
seconds

string (int64 format)

Son los segundos firmados del período. Debe estar entre -315,576,000,000 y +315,576,000,000, inclusive. Nota: Estos límites se calculan de la siguiente manera: 60 s/min * 60 min/h * 24 h/día * 365.25 días/año * 10,000 años
nanos

integer

Fracciones firmadas de un segundo con una resolución de nanosegundos del período. Las duraciones inferiores a un segundo se representan con un campo seconds igual a 0 y un campo nanos positivo o negativo. Para duraciones de un segundo o más, un valor distinto de cero para el campo nanos debe tener el mismo signo que el campo seconds. Debe ser un valor entre -999,999,999 y +999,999,999, inclusive.

Anotaciones de herramientas

Sugerencia destructiva: ❌ | Sugerencia idempotente: ❌ | Sugerencia de solo lectura: ✅ | Sugerencia de mundo abierto: ❌