Visão geral do Compute Routes
Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
Desenvolvedores do Espaço Econômico Europeu (EEE)

Introdução
O Compute Routes é um método no serviço da API Routes que aceita
uma solicitação HTTPS e retorna a rota ideal entre dois locais.
Mostre rotas com trânsito em tempo real para transporte público, bicicleta, carro,
motocicleta ou a pé entre vários locais.
Precisa de matrizes de rotas? Se você tiver interesse em uma matriz de rotas, consulte a Visão geral da Compute Route Matrix.
Migrando? Se você estiver migrando da API Distance Matrix (legado),
consulte as instruções de migração começando com
Por que migrar para a API Routes.
Por que usar o Compute Routes
Com o Compute Routes, você pode rotear seus veículos ou pacotes de acordo com suas preferências, otimizando o custo e a qualidade, com uma ampla variedade de detalhes de rota.
O que você pode fazer com as rotas de computação?
Com o método Compute Routes
da API Routes, é possível fazer o seguinte:
Confira rotas para diferentes formas de viajar e para um ou
vários destinos:
Modos de transporte: transporte público, carro, veículos de duas rodas,
a pé ou de bicicleta.
Uma série de waypoints que podem ser otimizados para a ordem mais eficiente de viagem até eles.
Use várias maneiras de especificar origens, destinos e pontos de passagem:
Strings de texto. Por exemplo: "Chicago, IL", "Darwin, NT, Australia", "1800
Amphitheatre Parkway, Mountain View, CA 94043" ou "CWF6+FWX Mountain
View, California"
IDs de lugares
Coordenadas de latitude e longitude, opcionalmente com a direção do veículo
Ajuste as opções de trajeto com base nas suas necessidades e objetivos:
Selecione trajetos econômicos ou de baixo consumo de combustível para o tipo de motor do seu veículo:
Diesel, Elétrico, Híbrido, Gasolina. Para mais informações, consulte
Como encontrar um trajeto ecológico.
Defina opções detalhadas para o cálculo de tráfego, permitindo que você tome
decisões de troca de qualidade e latência. Para mais detalhes, consulte Especificar como e se incluir dados de tráfego.
Defina a direção do veículo (direção de deslocamento) e as informações da via para os waypoints para aumentar a precisão do HEC. Para saber mais, consulte Especificar a direção e o lado da estrada do veículo.
Especifique locais de passagem e de destino e locais de escala segura. Para saber mais, consulte Definir uma parada ao longo de uma rota e Definir um ponto para uma rota passar.
Solicitar informações de pedágio, distância do trajeto e HEC. Para
mais detalhes, consulte
Calcular as taxas de pedágio de uma rota.
Controle a latência e a qualidade solicitando apenas os dados necessários
usando uma máscara de campo, que ajuda a evitar o tempo de processamento desnecessário e
taxas de faturamento mais altas. Para mais detalhes, consulte
Escolher quais informações retornar.
Como o Compute Routes funciona
O método ComputeRoutes
da API Routes aceita uma solicitação POST HTTP com
um corpo de solicitação JSON que contém os detalhes da solicitação. São necessários uma origem, um destino, travelMode
e uma máscara de campo para especificar quais campos serão retornados.
Exemplo
curl -X POST -d '{
"origin": {
"address": "1800 Amphitheatre Parkway, Mountain View, CA 94043"
},
"destination": {
"address": "Sloat Blvd &, Upper Great Hwy, San Francisco, CA 94132"
},
"travelMode": "DRIVE"
}' \
-H 'Content-Type: application/json' -H 'X-Goog-Api-Key: YOUR_API_KEY' \
-H 'X-Goog-FieldMask: routes.duration,routes.distanceMeters' \
'https://routes.googleapis.com/directions/v2:computeRoutes'
Em seguida, o serviço calcula a rota solicitada e retorna os campos que você solicitou.
Recursos
A tabela a seguir resume os recursos disponíveis pelo método Compute Routes da API Routes, além dos dados retornados.
Recursos de dados |
Dados retornados |
Formato da devolução |
ComputeRoutes |
Retorna rotas, segmentos e etapas de uma rota, com rotas alternativas,
se solicitado. |
JSON |
Como usar o Compute Routes
Bibliotecas de clientes disponíveis
Para conferir uma lista das bibliotecas de cliente disponíveis para
Compute Routes, consulte
Bibliotecas de cliente.
A seguir
Exceto em caso de indicação contrária, o conteúdo desta página é licenciado de acordo com a Licença de atribuição 4.0 do Creative Commons, e as amostras de código são licenciadas de acordo com a Licença Apache 2.0. Para mais detalhes, consulte as políticas do site do Google Developers. Java é uma marca registrada da Oracle e/ou afiliadas.
Última atualização 2025-06-20 UTC.
[null,null,["Última atualização 2025-06-20 UTC."],[],[],null,["# Compute Routes Overview\n\n**European Economic Area (EEA) developers** If your billing address is in the European Economic Area, effective on 8 July 2025, the [Google Maps Platform EEA Terms of Service](https://cloud.google.com/terms/maps-platform/eea) will apply to your use of the Services. Functionality varies by region. [Learn more](/maps/comms/eea/faq).\n\n[](/maps/documentation/routes/demo)\n\nIntroduction\n------------\n\nCompute Routes is a method in the Routes API service that accepts\nan HTTPS request and returns the ideal route between two locations.\nProvide directions with real-time traffic for transit, biking, driving,\n2-wheel motorized vehicles, or walking between multiple locations.\n\n**Need Route Matrixes?** If you are interested in a route matrix, see\n[Compute Route Matrix Overview](/maps/documentation/routes/compute-route-matrix-over).\n\n**Migrating?** If you are migrating from the Distance Matrix API (Legacy),\nsee migration instructions starting with\n[Why migrate to the Routes API](/maps/documentation/routes/migrate-routes-why).\n\nWhy use Compute Routes\n----------------------\n\nWith Compute Routes, with a wide\nrange of route details you can route your vehicles or packages according to\nyour preferences while optimizing for cost and quality.\n\nWhat you can do with Compute Routes?\n------------------------------------\n\nWith the Routes API `Compute Routes` method, you can\ndo the following things:\n\n- **Get directions for different ways to travel**, and for a single or\n multiple destinations:\n\n - Modes of transportation: transit, driving, two-wheel vehicles,\n walking, or bicycling.\n\n - A series of waypoints that you can optimize for the most efficient\n order in which to travel to them.\n\n- **Use multiple ways to specify origins, destinations, and waypoints**:\n\n - Text strings. For example: \"Chicago, IL\", \"Darwin, NT, Australia\", \"1800\n Amphitheatre Parkway, Mountain View, CA 94043\", or \"CWF6+FWX Mountain\n View, California\"\n\n - Place IDs\n\n - Latitude and longitude coordinates, optionally with vehicle heading\n\n- **Fine-tune your route options** based on your needs and goals:\n\n - Select fuel or energy-efficient routes for your vehicle's engine type:\n Diesel, Electric, Hybrid, Gas. For more information, see\n [Get an eco-friendly route](/maps/documentation/routes/eco-routes#request_an_eco-friendly_route).\n\n - Set fine-grained options for traffic calculation, letting you make\n quality versus latency trade off decisions. For details, see\n [Specify how and if to include traffic data](/maps/documentation/routes/config_trade_offs).\n\n - Set vehicle heading (direction of travel) and side-of-road information\n for waypoints to increase ETA accuracy. For details, see\n [Specify vehicle heading and side of road](/maps/documentation/routes/location_modifiers).\n\n - Specify pass-through versus terminal locations and safe stopover\n locations. For details, see [Set a stop along a route](/maps/documentation/routes/stop_over) and\n [Set a point for a route to pass through](/maps/documentation/routes/pass-through).\n\n - Request toll information, along with route distance and ETA. For\n details, see\n [Calculate toll fees for a route](/maps/documentation/routes/calculate_toll_fees).\n\n- **Control your latency and quality** by requesting only the data you need\n using a field mask, which helps you avoid unnecessary processing time and\n higher request billing rates. For details, see\n [Choose what information to return](/maps/documentation/routes/choose_fields).\n\nHow Compute Routes works\n------------------------\n\nThe Routes API `ComputeRoutes` method accepts an HTTP POST request with\na JSON request body that contains the request details. Required are an origin,\ndestination, `travelMode`, and a field mask to specify which fields to return. \n\n#### Example\n\n```json\ncurl -X POST -d '{\n \"origin\": {\n \"address\": \"1800 Amphitheatre Parkway, Mountain View, CA 94043\"\n },\n \"destination\": {\n \"address\": \"Sloat Blvd &, Upper Great Hwy, San Francisco, CA 94132\"\n },\n \"travelMode\": \"DRIVE\"\n }' \\\n -H 'Content-Type: application/json' -H 'X-Goog-Api-Key: YOUR_API_KEY' \\\n -H 'X-Goog-FieldMask: routes.duration,routes.distanceMeters' \\\n 'https://routes.googleapis.com/directions/v2:computeRoutes'\n```\n\nThe service then calculates the requested route, and returns the fields you've\nrequested.\n\n### Resources\n\nThe following table summarizes the resources available through the\nRoutes API Compute Routes method,\nalong with the data it returns.\n\n\u003cbr /\u003e\n\n| Data resources | Data returned | Return format |\n|----------------------------------------------------------------------|-----------------------------------------------------------------------------------|---------------|\n| [ComputeRoutes](/maps/documentation/routes/compute_route_directions) | Returns routes, legs, and steps for a route, with alternate routes, if requested. | JSON |\n\n\u003cbr /\u003e\n\n### How to use Compute Routes\n\n|---|---------------------------------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| 1 | **Get set up** | Start with [Set up your Google Cloud project](/maps/documentation/routes/cloud-setup) and complete the setup instructions that follow. |\n| 2 | **Understand how the Routes API bills** | For information, see [Usage and billing](/maps/documentation/routes/usage-and-billing). |\n| 3 | **Compute a route and review the response** | For more information, see [Get a route](/maps/documentation/routes/compute_route_directions) and [Review the route responses](/maps/documentation/routes/understand-route-response). |\n\n### Available client libraries\n\nFor a list of the available client libraries for\nCompute Routes, see\n[Client libraries](/maps/documentation/routes/client-libraries).\n\nWhat's next\n-----------\n\n- [Get a route](/maps/documentation/routes/compute_route_directions)\n- [Available route options](/maps/documentation/routes/route-opt)\n- [Choose what information to return](/maps/documentation/routes/choose_fields)\n- [Migrate from Directions API (Legacy)](/maps/documentation/routes/migrate-routes)\n- [Migrate from the Routes API preview to GA](/maps/documentation/routes/migrate-routes-preview)"]]