Referência rápida da API Directions

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

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 status ZERO_RESULTS. Correção: use pontos de passagem de parada (sem o prefixo via:), 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 local side_of_road ou heading sã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 omita optimize:true, departure_time (para trajetos de carro), side_of_road e heading para permanecer na SKU Essentials. Consulte /maps/billing-and-pricing/sku-details/legacy#directions-advanced-pro-sku.
  • Problema: para dirigir, departure_time não pode estar no passado (a solicitação falha com INVALID_REQUEST). Sem departure_time, o trajeto e a duração usam o trânsito médio independente do tempo, e nenhum duration_in_traffic é retornado. Correção: defina departure_time como now ou um horário futuro com mode=driving para receber duration_in_traffic. As solicitações que retornam duration_in_traffic são cobradas na SKU Directions Advanced (Pro). Consulte /maps/documentation/directions/get-directions.