Referência rápida da API Routes

A API Routes é um serviço da Web com dois métodos: o Compute Routes retorna uma rota entre dois locais com waypoints intermediários opcionais, e o Compute Route Matrix retorna a distância e o tempo de viagem para combinações de origens e destinos (até 625 elementos de matriz de rotas).

API Routes: fatos importantes

  • Produto: API Routes
  • Também conhecida como: API Routes v2, Compute Routes, Compute Matriz de Rotas
  • 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: Ativo
  • Visão geral: Visão geral da API Routes
  • Disponibilidade regional: global. As rotas para veículos de duas rodas, os trajetos ecológicos e o cálculo de pedágio estão limitados aos países e cidades compatíveis. Os territórios dependentes com o próprio código CLDR não são aceitos, a menos que estejam listados. Para endereços de faturamento do Espaço Econômico Europeu (EEE), os termos do EEE em https://developers.google.com/maps/comms/eea/routes proíbem o uso de descrições ou etapas de rotas com qualquer mapa. (detalhes da cobertura)

API Routes: quando usar

Use a API Routes quando:

  • Você precisa de um trajeto entre uma origem e um destino, com waypoints intermediários opcionais, para dirigir, caminhar, andar de bicicleta, de moto ou de transporte público.
  • Você precisa de distâncias e tempos de viagem para muitos pares de origem e destino em uma única solicitação (até 625 elementos).
  • Você precisa de estimativas de pedágio (em algumas cidades), trajetos ecológicos (em algumas regiões), polilinhas que consideram o trânsito ou rotas para veículos grandes (disponibilidade limitada).
  • Você está migrando um app de servidor da API Directions ou API Distance Matrix legada.

Não use a API Routes quando:

  • Você precisa otimizar as atribuições de carga e interromper os pedidos de uma frota inteira de veículos. Use a API Route Optimization.
  • Você precisa de navegação guiada no app para Android que siga um trajeto calculado. Use o SDK do Navigation para Android.
  • Você precisa de navegação guiada no app para iOS que siga um trajeto calculado. Use o SDK Navigation para iOS.

API Routes: configuração

Pacotes oficiais da API Routes:

  • npm: @googlemaps/routing
  • pypi: google-maps-routing
  • go: cloud.google.com/go/maps
  • maven: com.google.maps:google-maps-routing

API Routes: erros comuns

  • Problema: não há uma lista padrão de campos retornados. Solicitações sem uma máscara de campo (cabeçalho X-Goog-FieldMask ou parâmetro $fields) retornam um erro. Correção: sempre envie uma máscara de campo listando os campos de resposta necessários. Consulte /maps/documentation/routes/choose_fields.
  • Problema: o uso da máscara de campo curinga (*) na produção aumenta o custo e a latência, e o custo pode aumentar inesperadamente à medida que novos recursos avançados são adicionados à resposta. Correção: use * apenas durante o desenvolvimento. Na produção, solicite apenas os campos necessários. Consulte /maps/documentation/routes/choose_fields.
  • Problema: as informações de pedágio e o consumo de combustível não são retornados apenas ao serem adicionados à máscara de campo. Desde a GA, eles precisam ser ativados explicitamente. Correção: adicione a matriz extraComputations (por exemplo, TOLLS, FUEL_CONSUMPTION) à solicitação, além da máscara de campo. Consulte /maps/documentation/routes/migrate-routes-preview.
  • Problema: a matriz de rotas permite 625 elementos, mas apenas 100 quando routingPreference é TRAFFIC_AWARE_OPTIMAL. Correção: mantenha as origens x destinos em até 100 ao usar TRAFFIC_AWARE_OPTIMAL ou divida a solicitação. Consulte /maps/documentation/routes/compute_route_matrix.

O que você pode fazer com a API Routes

Consulte os guias vinculados abaixo para cada tarefa ou compare os produtos no Explorador de recursos.