O Google usa tecnologia de IA na tradução de conteúdos para seu idioma de preferência. As traduções com IA podem ter erros.

Por que migrar para a API Routes?

Desenvolvedores do Espaço Econômico Europeu (EEE)

A API Routes oferece melhor desempenho para calcular rotas, distância e tempo de viagem, o que torna vantajoso substituir apps que usam as APIs Directions e Distance Matrix. A maior parte da funcionalidade da API Routes é compatível com versões anteriores das APIs Directions e API Distance Matrix.

Use este guia para entender as principais diferenças na API Routes em comparação com os produtos que ela substitui, além de como lidar com as mudanças necessárias. Para mais detalhes sobre outros recursos da API Routes, consulte a visão geral do produto.

Principais melhorias

Esta seção aborda algumas das melhorias que você pode esperar ao usar a API Routes nos seus apps.

Limites de solicitação maiores

API Routes Compute Route Matrix	Máximo de 625 elementos, a menos que você especifique `TRAFFIC_AWARE_OPTIMAL`. Máximo de 100 elementos com `TRAFFIC_AWARE_OPTIMAL`. Consulte Preferências de roteamento avançadas. Máximo de 50 waypoints (origens + destinos) usando um ID de lugar.
API Distance Matrix	Máximo de 25 origens ou 25 destinos por solicitação. Máximo de 100 elementos (número de origens × número de destinos) por solicitação do lado do servidor.

Respostas mais rápidas às solicitações

O recurso Compute Route Matrix oferece as seguintes melhorias de latência:

Receba elementos de streaming da resposta antes que toda a matriz seja calculada.
Use máscaras de campo para personalizar os detalhes da resposta, solicitando apenas os dados necessários. Essa é uma prática recomendada que também ajuda a reduzir os custos.
Cálculos de rotas aprimorados para trânsito, para que você possa fazer a troca entre qualidade de dados e tempo de resposta.

Melhorias no roteamento

O recurso de rota de computação oferece estas melhorias de roteamento:

Informações sobre pedágios, além da distância e do HEC.
Rotas para veículos de duas rodas.
Qualifique os pontos de parada para garantir a segurança.
Aumento da precisão da HEC ao definir a direção do deslocamento e o lado da via para os waypoints.

Solicite apenas os dados necessários

Agora você especifica quais campos retornar, reduzindo o tempo de processamento e as cobranças de faturamento.

API Routes Calcular rotas Calcular matriz de rotas	As solicitações precisam usar uma máscara de campo para especificar quais campos você quer que sejam retornados na resposta. O mascaramento de campo garante que você não solicite dados desnecessários, o que evita tempo de processamento e cobranças desnecessárias. Para mais informações, consulte Escolher campos para retornar.
API Directions API Distance Matrix	Retorna uma lista padrão de campos, mesmo que o app não precise deles. Isso pode resultar em tempo de processamento e cobranças de faturamento desnecessários.

Cálculos de rotas otimizados para trânsito

A API Routes oferece suporte a três preferências de rotas que podem ser usadas para equilibrar a latência de resposta e a qualidade dos dados ao solicitar informações de trânsito.

Para mais informações, consulte Configurar qualidade x latência.

`TRAFFIC_UNAWARE` (padrão)	Usa dados médios de tráfego independentes do tempo, e não dados de tráfego em tempo real, para calcular o trajeto, resultando na menor latência de resposta. Essa configuração é equivalente a quando o trânsito não é usado na API Directions e na API Distance Matrix.
`TRAFFIC_AWARE` (novo)	Qualidade de tráfego em tempo real otimizada para desempenho com latência reduzida. Ao contrário de `TRAFFIC_AWARE_OPTIMAL`, essa configuração aplica otimizações para reduzir significativamente a latência. Essa configuração também é nova para a API Routes e não tem equivalente na API Directions ou na API Distance Matrix.
`TRAFFIC_AWARE_OPTIMAL`	Dados de trânsito abrangentes e de alta qualidade. Essa configuração produz a maior latência e é equivalente à configuração `departure_time` nas APIs Directions e API Distance Matrix. Essa preferência é equivalente ao modo usado pelo maps.google.com e pelo app Google Maps para dispositivos móveis.

Comparação de cálculo de rotas

A tabela a seguir compara as opções de trajeto entre a API Routes e os serviços da API Directions e da API Distance Matrix.

Opção de tráfego API Routes API Directions
API Distance Matrix Latência

Sem trânsito em tempo real TRAFFIC_UNAWARE departure_time propriedade não definida Latência mais rápida dos três modos.

Condições de trânsito em tempo real aplicadas

Opção de tráfego	API Routes	API Directions API Distance Matrix	Latência
Sem trânsito em tempo real	`TRAFFIC_UNAWARE`	`departure_time` propriedade não definida	Latência mais rápida dos três modos.
Condições de trânsito em tempo real aplicadas	`TRAFFIC_AWARE`	Não há equivalente	Novo modo adicionado pela API Routes. Ela oferece uma latência um pouco maior do que `TRAFFIC_UNAWARE` com um pequeno custo de qualidade da ETA. Ele tem uma latência muito menor do que o `TRAFFIC_AWARE_OPTIMAL`.
Dados de trânsito em tempo real abrangentes e de alta qualidade aplicados	`TRAFFIC_AWARE_OPTIMAL`	Conjunto de propriedades `departure_time`	Equivalente ao modo usado por maps.google.com e pelo app Google Maps para dispositivos móveis. Para a Compute Route Matrix, o número de elementos em uma solicitação (número de origens × número de destinos) não pode exceder 100.

TRAFFIC_AWARE

Não há equivalente

Novo modo adicionado pela API Routes. Ela oferece uma latência um pouco maior do que TRAFFIC_UNAWARE com um pequeno custo de qualidade da ETA.

Ele tem uma latência muito menor do que o TRAFFIC_AWARE_OPTIMAL.

Dados de trânsito em tempo real abrangentes e de alta qualidade aplicados

TRAFFIC_AWARE_OPTIMAL

Conjunto de propriedades departure_time

Equivalente ao modo usado por maps.google.com e pelo app Google Maps para dispositivos móveis.

Para a Compute Route Matrix, o número de elementos em uma solicitação (número de origens × número de destinos) não pode exceder 100.

principais diferenças

Esta seção aborda as principais diferenças entre a API Routes e os serviços que ela substitui, além de maneiras de lidar com essas diferenças ao migrar desses serviços nos seus apps atuais.

Chame um serviço em vez de dois

API Routes	Ative apenas um serviço no Console de APIs para que seu app use Compute Routes e Compute Route Matrix. Para mais informações, consulte Configurar no Console de APIs do Google.
API Directions API Distance Matrix	Ative dois serviços: API Directions e API Distance Matrix como serviços separados no console de APIs.

Usa solicitações `HTTPS POST`

API Routes	Transmita parâmetros no corpo da solicitação ou em cabeçalhos como parte de uma solicitação `HTTP POST`. Confira alguns exemplos: - Calcular um trajeto - Calcular uma matriz de trajetos
API Directions API Distance Matrix	Transmita parâmetros de URL usando uma solicitação `HTTP GET`.

Diferenças na resposta de HEC

A API Routes retorna o HEC e usa a propriedade de resposta duration de forma diferente dos serviços das APIs Directions e API Distance Matrix, conforme mostrado na tabela abaixo.

Tipo de ETA API Routes API Directions
API Distance Matrix

Previsão de chegada sem informações de trânsito e independente do horário.

Tipo de ETA	API Routes	API Directions API Distance Matrix
Previsão de chegada sem informações de trânsito e independente do horário.	Definido usando `TRAFFIC_UNAWARE`. ETA contida na propriedade de resposta `duration`. As propriedades de resposta `duration` e `staticDuration` contêm o mesmo valor.	Corresponde a `departure_time` não definido na solicitação. ETA contida na propriedade de resposta `duration`. A propriedade de resposta `duration_in_traffic` não é retornada.
HEC que considera o trânsito em tempo real.	Defina usando `TRAFFIC_AWARE` ou `TRAFFIC_AWARE_OPTIMAL`. A estimativa de chegada que considera o trânsito em tempo real está contida na propriedade de resposta `duration`. A propriedade de resposta `staticDuration` contém a duração do trajeto sem considerar as condições de trânsito. A propriedade `duration_in_traffic` não é mais retornada.	Defina usando `departure_time` na solicitação. O HEC que considera o trânsito em tempo real está incluído na propriedade de resposta `duration_in_traffic`.

Definido usando TRAFFIC_UNAWARE.

ETA contida na propriedade de resposta duration.
As propriedades de resposta duration e staticDuration contêm o mesmo valor.

Corresponde a departure_time não definido na solicitação.

ETA contida na propriedade de resposta duration.
A propriedade de resposta duration_in_traffic não é retornada.

HEC que considera o trânsito em tempo real.

Defina usando TRAFFIC_AWARE ou TRAFFIC_AWARE_OPTIMAL.

A estimativa de chegada que considera o trânsito em tempo real está contida na propriedade de resposta duration.
A propriedade de resposta staticDuration contém a duração do trajeto sem considerar as condições de trânsito.
A propriedade duration_in_traffic não é mais retornada.

Defina usando departure_time na solicitação.

O HEC que considera o trânsito em tempo real está incluído na propriedade de resposta duration_in_traffic.

Waypoints de polilinha

Com esse serviço, não é mais necessário converter as coordenadas de latitude/longitude em pontos de referência de polilinha, que aceita um corpo de solicitação POST e, portanto, não é mais afetado pelos limites de strings de URL. Alguns usuários da API Distance Matrix resolveram o problema dos limites de solicitações convertendo pontos de latitude/longitude em waypoints de polilinha.

Endereços formatados (geocodificação inversa)

A API Routes não fornece endereços formatados na resposta. Para receber endereços formatados, use a API Geocoding, que foi criada para esse caso de uso e oferece resultados de maior qualidade.

Meios de transporte disponíveis

Assim como na API Directions, a API Routes usa DRIVE como o modo padrão quando uma solicitação de trajeto não especifica um meio de transporte. No entanto, quando uma solicitação especifica um meio de transporte para um trajeto, a API Routes não retorna uma matriz de meios de transporte disponíveis como opções alternativas para a solicitação. Se o seu caso de uso depender desse recurso, registre um problema descrevendo como você usa o recurso para que possamos acompanhar.

XML como formato de resposta

A API Routes não oferece XML como formato de resposta. Você pode encontrar vários conversores de JSON para XML on-line que atendem às suas necessidades.