Este produto ou recurso está no status legado. Para mais informações sobre o status legado e como migrar de serviços legados para mais recentes, consulte
Produtos e recursos legados.
Visão geral da API Directions (legada)
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)
A API Directions (legada) é um serviço que aceita uma solicitação HTTP e retorna instruções formatadas em JSON ou XML entre locais.
Por que usar a API Directions
Com a API Directions, você pode receber rotas para vários meios de transporte, como transporte público, carro, a pé ou bicicleta.
O que você pode fazer com a API Directions?
Com a API Directions, é possível calcular rotas entre locais,
incluindo os seguintes detalhes:
- Rotas para vários meios de transporte, incluindo transporte público, carro, a pé ou bicicleta.
- Rotas em várias partes usando uma série de waypoints.
- Especifique origens, destinos e waypoints de várias maneiras, incluindo como strings de texto (por exemplo, "Chicago, IL" ou "Darwin, NT, Australia"), IDs de lugar ou coordenadas de latitude/longitude.
Como a API Directions funciona
A API Directions retorna os trajetos mais eficientes ao calcular rotas. O produto considera os seguintes elementos de viagem ao determinar o trajeto mais eficiente:
- Tempo de viagem (principal)
- Distância
- Número de voltas
O exemplo de solicitação a seguir retorna rotas de carro de Toronto, Ontário, para Montreal, Quebec, no formato JSON:
https://maps.googleapis.com/maps/api/directions/json
?destination=Montreal
&origin=Toronto
&key=YOUR_API_KEY
Recursos
A tabela a seguir resume os recursos disponíveis na API Directions e os dados que ela retorna.
| Recursos de dados |
Dados retornados |
Formato de retorno |
| Directions
Forneça origens e destinos na forma de IDs de lugar, endereços ou coordenadas de latitude/longitude. Consulte os parâmetros obrigatórios para mais detalhes.
|
Instruções detalhadas, divididas em rotas, trechos e etapas. Consulte Respostas de rotas para mais detalhes.
|
|
Como usar a API Directions
| 1 |
Comece a configuração. |
Comece com Configurar seu projeto do Google Cloud e siga as instruções de configuração. |
| 2 |
Teste a demonstração |
Depois de ter uma chave de API e um projeto na nuvem, teste a demonstração de rotas sem custo financeiro. Consulte A demonstração da API Directions.
|
| 3 |
Criar uma solicitação |
Consulte os exemplos de solicitações e saiba mais sobre as opções disponíveis que você pode fornecer, como meios de transporte, pontos de parada e restrições de rota. Confira exemplos de rotas.
|
| 4 |
Entender os princípios básicos da resposta |
Analise as respostas de dados para se preparar para usar dados de rotas no seu app. Consulte
Respostas de rotas
para mais detalhes.
|
| 5 |
Incorpore dados de rotas no seu próprio app! |
Você pode usar esses dados para calcular a distância e o tempo de viagem.
|
Bibliotecas de clientes disponíveis
Chame essa API no idioma de sua escolha usando uma das seguintes bibliotecas de cliente:
Os clientes Java, Python, Go e Node.js dos serviços do Google Maps são bibliotecas de cliente apoiadas pela comunidade e que têm código aberto sob a Licença Apache 2.0.
Faça o download deles no GitHub, onde você também encontra instruções de instalação e exemplos de código.
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-08-31 UTC.
[null,null,["Última atualização 2025-08-31 UTC."],[[["\u003cp\u003eThe Directions API provides route information between locations using various transportation modes like driving, walking, transit, or bicycling.\u003c/p\u003e\n"],["\u003cp\u003eYou can customize your requests by specifying origins, destinations, waypoints, and travel preferences.\u003c/p\u003e\n"],["\u003cp\u003eThe API calculates the most efficient routes based on travel time, distance, and the number of turns.\u003c/p\u003e\n"],["\u003cp\u003eResults are available in JSON or XML format and include detailed directions, routes, legs, and steps.\u003c/p\u003e\n"],["\u003cp\u003eClient libraries are available in Java, Python, Go, and Node.js for easy integration into your applications.\u003c/p\u003e\n"]]],[],null,["# Directions API (Legacy) 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\nThe Directions API (Legacy) is a service that accepts an HTTP request and returns JSON or XML-formatted directions between locations.\n\nWhy use the Directions API\n--------------------------\n\nWith the Directions API, you can get directions for several modes of\ntransportation, such as transit, driving, walking, or bicycling.\n\nWhat you can do with the Directions API?\n----------------------------------------\n\nWith the Directions API, you can calculate directions between locations,\nincluding the following details:\n\n- Directions for several modes of transportation, including transit, driving, walking or bicycling.\n- Multipart directions using a series of waypoints.\n- Specify origins, destinations, and waypoints in multiple ways, including as text strings (for example, \"Chicago, IL\" or \"Darwin, NT, Australia\"), place IDs, or latitude/longitude coordinates.\n\nHow the Directions API works\n----------------------------\n\nThe Directions API returns the most efficient routes when\ncalculating directions. The product factors in the following travel elements\nwhen determining the most efficient route:\n\n- Travel time (primary)\n- Distance\n- Number of turns\n\nThe following example request returns driving directions from Toronto, Ontario to Montreal, Quebec in JSON format: \n\n```scdoc\nhttps://maps.googleapis.com/maps/api/directions/json\n ?destination=Montreal\n &origin=Toronto\n &key=YOUR_API_KEY\n```\n\n### Resources\n\nThe following table summarizes the resources available through the\nDirections API along with the data it returns.\n\n\u003cbr /\u003e\n\n| Data resources | Data returned | Return format |\n|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------|---------------|\n| [Directions](/maps/documentation/directions/get-directions#DirectionsRequests) Supply origins and destinations in the form of place IDs, addresses, or latitude/longitude coordinates. See [required parameters](/maps/documentation/directions/get-directions#required-parameters) for details. | Detailed directions, broken into routes, legs, and steps. See [Directions responses](/maps/documentation/directions/get-directions#DirectionsResponses) for details. | - JSON - XML |\n\n\u003cbr /\u003e\n\nHow to use the Directions API\n-----------------------------\n\n|---|---------------------------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| 1 | **Get set up.** | Start with [Set up your Google Cloud project](/maps/documentation/directions/cloud-setup) and complete the setup instructions that follow. |\n| 2 | **Try the demo** | Once you have an API key and a cloud project you try out the directions demo at no charge. See [The Directions API demo](/maps/documentation/directions/start). |\n| 3 | **Build a request** | See the example requests and learn about the available options you can supply, such as travel modes, waypoints, and route restrictions. See [Directions examples](/maps/documentation/directions/get-directions#ExampleRequests). |\n| 4 | **Understand response basics** | Explore the data responses to prepare to use directions data for your app. See [Directions responses](/maps/documentation/directions/get-directions#DirectionsResponses) for details. |\n| 5 | **Incorporate direction data into your own app!** | You can use this data to calculate travel distance and time. |\n\n#### Available client libraries\n\nCall this API in the language of\nyour choice through one of the following client libraries:\n\n- [Java\n Client for Google Maps Services](https://github.com/googlemaps/google-maps-services-java)\n- [Python\n Client for Google Maps Services](https://github.com/googlemaps/google-maps-services-python)\n- [Go Client\n for Google Maps Services](https://github.com/googlemaps/google-maps-services-go)\n- [Node.js\n Client for Google Maps Services](https://github.com/googlemaps/google-maps-services-js)\n\nThe Java Client, Python Client, Go Client and Node.js Client for Google Maps\nServices are community-supported client libraries, open sourced under the\n[Apache 2.0 License](http://www.apache.org/licenses/LICENSE-2.0).\nDownload them from GitHub, where you can also find installation instructions and sample code.\n\nWhat's next\n-----------\n\n- **Start using the Directions API** : Go to [Get started](/maps/documentation/directions/start).\n- **Start making Directions requests** : Go to [Get\n directions](/maps/documentation/directions/get-directions).\n- **Follow best practices** : Go to [Web service best\n practices](/maps/documentation/directions/web-service-best-practices)."]]
