MCP Tools Reference: mapstools.googleapis.com

Ferramenta: compute_routes

Calcula um trajeto entre uma origem e um destino especificados. Meios de transporte aceitos:CARRO (padrão), A PÉ.

Requisitos de entrada (CRÍTICO): exige origem e destino. Cada um deles precisa ser fornecido usando um dos seguintes métodos, aninhado no respectivo campo:

  • address: (string, por exemplo, 'Torre Eiffel, Paris'). Observação: quanto mais granular ou específico for o endereço de entrada, melhores serão os resultados.

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

  • place_id:: (string, por exemplo, 'ChIJOwE_Id1w5EAR4Q27FkL6T_0') Observação: esse ID pode ser obtido na ferramenta search_places. Qualquer combinação de tipos de entrada é permitida (por exemplo, origem por endereço, destino por lat_lng). Se a origem ou o destino estiverem faltando, você PRECISA pedir esclarecimentos ao usuário antes de tentar chamar a ferramenta.

Exemplo de chamada de função: {"origin":{"address":"Eiffel Tower"},"destination":{"place_id":"ChIJt_5xIthw5EARoJ71mGq7t74"},"travel_mode":"DRIVE"}

O exemplo a seguir demonstra como usar curl para invocar a ferramenta compute_routes MCP.

Solicitação 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

ComputeRoutesRequest.

ComputeRoutesRequest

Representação JSON 
{
  "origin": {
    object (Waypoint)
  },
  "destination": {
    object (Waypoint)
  },
  "travelMode": enum (RouteTravelMode)
}
Campos
origin

object (Waypoint)

Obrigatório. Ponto de parada de origem.
destination

object (Waypoint)

Obrigatório. Ponto de parada de destino.
travelMode

enum (RouteTravelMode)

Opcional. Especifica o meio de transporte.

Ponto de referência

Representação 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ão location_type. Diferentes maneiras de representar um local. location_type pode ser apenas de um dos tipos a seguir:
latLng

object (google.type.LatLng)

Um ponto especificado usando coordenadas geográficas.
placeId

string

O ID do lugar associado ao ponto de referência.
address

string

Endereço legível ou um Plus Code. Para mais detalhes, consulte https://plus.codes.

LatLng

Representação JSON 
{
  "latitude": number,
  "longitude": number
}
Campos
latitude

number

A latitude em graus. Precisa estar no intervalo [-90,0, +90,0].
longitude

number

A longitude em graus. Precisa estar no intervalo [-180,0, +180,0].

Esquema de saída

ComputeRoutesResponse.

ComputeRoutesResponse

Representação JSON 
{
  "routes": [
    {
      object (Route)
    }
  ]
}
Campos
routes[]

object (Route)

Contém trajetos entre a origem e o destino solicitados. No momento, apenas um trajeto é retornado.

Rota

Representação JSON 
{
  "distanceMeters": integer,
  "duration": string
}
Campos
distanceMeters

integer

A distância da viagem da rota, em metros.
duration

string (Duration format)

O tempo necessário para percorrer o trajeto.

Duração em segundos com até nove dígitos fracionários, terminando em "s". Exemplo: "3.5s".

Duração

Representação JSON 
{
  "seconds": string,
  "nanos": integer
}
Campos
seconds

string (int64 format)

Segundos assinados do período. Precisa estar entre -315.576.000.000 e +315.576.000.000 (inclusive). Observação: esses limites são calculados com base em: 60 s/min * 60 min/h * 24 h/dia * 365,25 dias/ano * 10.000 anos
nanos

integer

Frações assinadas de um segundo com resolução de nanossegundos do período. Durações menores que um segundo são representadas com um campo seconds 0 e um campo nanos positivo ou negativo. Para durações de um segundo ou mais, um valor diferente de zero para o campo nanos precisa ter o mesmo sinal do campo seconds. Precisa estar entre -999.999.999 e +999.999.999 (inclusive).

Anotações de ferramentas

Dica destrutiva: ❌ | Dica idempotente: ❌ | Dica somente leitura: ✅ | Dica de mundo aberto: ❌