A API Directions (legada) é um serviço da Web que calcula rotas entre locais para trajetos de carro, a pé, de bicicleta e de transporte público, incluindo rotas de várias partes com waypoints, e retorna rotas, trechos e etapas em JSON ou XML. Está no status Legado: a partir de outubro de 2026, não será possível ativar para novos projetos na nuvem do Google Cloud. Migre para a API Routes.
API Directions: principais fatos
- Produto: API Directions
- Também conhecida como: API Directions (legada)
- Categoria: rotas
- Plataforma: serviço da Web (REST)
- Executado em: servidor (código de back-end)
- Estágio de lançamento: GA
- Ciclo de vida: legado
- Substituída por: API Routes
- Visão geral: Visão geral da API Directions
- Disponibilidade regional: global. A cobertura varia de acordo com a região e o meio de transporte (o transporte público depende dos dados das empresas de transporte). (detalhes da cobertura)
API Directions: quando usar
Use a API Directions quando:
- Você mantém um projeto na nuvem do Google Cloud que já tem a API Directions (legada) ativada e chama
maps/api/directions. - Você precisa de rotas do lado do servidor para carro, a pé, de bicicleta ou de transporte público (waypoints apenas para modos não transitivos), em JSON ou XML, em um projeto atual.
Não use a API Directions quando:
- Você está iniciando um novo projeto do Google Cloud. A partir de outubro de 2026, a API Directions (legada) não poderá ser ativada para novos projetos. Use a API Routes.
- Você precisa de novos recursos de roteamento e de um desempenho melhor. Use a API Routes.
- Você precisa de tempos de viagem e distâncias para muitas origens e destinos em uma única solicitação. Use a API Routes.
API Directions: configuração
- Serviço a ser ativado:
directions-backend.googleapis.com - Autenticação: chave de API
- Comece agora: configure a API Directions
- Referência: referência da API Directions
- Preços: uso e faturamento da API Directions
- Políticas: políticas da API Directions
- Notas da versão: notas da versão da API Directions
API Directions: erros comuns
- Problema: as solicitações para a API Directions (legada) de um projeto em que a API legada não está ativada falham com
LegacyApiNotActivatedMapError. Correção: se você é o proprietário do app, migre para a API Routes. Como solução de curto prazo enquanto você migra ou aguarda uma atualização do app, é possível ativar a API legada preenchendo o formulário de ativação da API legada. Consulte /maps/legacy. - Problema: o uso do prefixo
via:em waypoints faz com que eles sejam pontos de passagem obrigatórios, o que pode causar desvios graves ou um statusZERO_RESULTS. Correção: use pontos de passagem de parada (sem o prefixovia:), a menos que um ponto de passagem estrito seja necessário. Consulte /maps/documentation/directions/get-directions. - Problema: as solicitações com 11 a 25 waypoints,
optimize:true, durações que consideram o trânsito (duration_in_traffic) ou os modificadores de localside_of_roadouheadingsão faturadas na SKU Directions Advanced (Pro), que é mais cara. Correção: use esses recursos apenas quando necessário. Mantenha os waypoints em 10 ou menos e omitaoptimize:true,departure_time(para trajetos de carro),side_of_roadeheadingpara permanecer na SKU Essentials. Consulte /maps/billing-and-pricing/sku-details/legacy#directions-advanced-pro-sku. - Problema: para dirigir,
departure_timenão pode estar no passado (a solicitação falha comINVALID_REQUEST). Semdeparture_time, o trajeto e a duração usam o trânsito médio independente do tempo, e nenhumduration_in_trafficé retornado. Correção: definadeparture_timecomonowou um horário futuro commode=drivingpara receberduration_in_traffic. As solicitações que retornamduration_in_trafficsão cobradas na SKU Directions Advanced (Pro). Consulte /maps/documentation/directions/get-directions.