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 interessante substituir apps que usam a API Directions e a API Distance Matrix. A maioria das funcionalidades da API Routes é compatível com versões anteriores da API Directions e da 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.

Aumento dos limites de solicitação

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 aprimoradas. 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 de solicitação mais rápidas

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, uma prática recomendada que também ajuda a reduzir o custo.
Cálculos de rota aprimorados para trânsito, para que você possa fazer a troca entre qualidade de dados e tempo de resposta.

Melhorias de roteamento

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

Informações sobre pedágios , além da distância e da previsão de chegada.
Rotas de veículos de duas rodas.
Qualifique seus waypoints de parada para segurança.
Aumento da precisão da previsão de chegada definindo a direção da viagem e o lado da estrada para waypoints.

Solicitar apenas os dados necessários

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

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

Cálculos de rota aprimorados para trânsito

A API Routes oferece suporte a três preferências de roteamento 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 versus latência.

`TRAFFIC_UNAWARE` (padrão)	Usa dados de trânsito médios independentes do tempo dados de trânsito em tempo real, para calcular a rota, resultando na menor latência de resposta. Essa configuração é equivalente a quando o trânsito não é usado na API Directions e Distance Matrix API.
`TRAFFIC_AWARE` (novo)	Qualidade de trânsito em tempo real otimizada para desempenho e 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, sem equivalente na API Directions ou na 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` na API Directions e na 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 rota

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

Opção de trânsito API Routes API Directions
API Distance Matrix Latência

Sem trânsito em tempo real TRAFFIC_UNAWARE Propriedade departure_time 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ânsito	API Routes	API Directions API Distance Matrix	Latência
Sem trânsito em tempo real	`TRAFFIC_UNAWARE`	Propriedade `departure_time` 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. Ele oferece uma latência um pouco maior que `TRAFFIC_UNAWARE` com um pequeno custo de qualidade da previsão de chegada. Ele tem uma latência muito menor que `TRAFFIC_AWARE_OPTIMAL`.
Dados de trânsito em tempo real abrangentes e de alta qualidade aplicados	`TRAFFIC_AWARE_OPTIMAL`	Propriedade `departure_time` definida	Equivalente ao modo usado pelo 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. Ele oferece uma latência um pouco maior que TRAFFIC_UNAWARE com um pequeno custo de qualidade da previsão de chegada.

Ele tem uma latência muito menor que TRAFFIC_AWARE_OPTIMAL.

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

TRAFFIC_AWARE_OPTIMAL

Propriedade departure_time definida

Equivalente ao modo usado pelo 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 resolver essas diferenças ao migrar desses serviços nos seus apps atuais.

Chamar um serviço em vez de dois

API Routes	Ative apenas um serviço no Console de APIs para que seu app use o Compute Routes e o 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`. Para exemplos, consulte: - Calcular uma rota - Calcular uma matriz de rotas
API Directions API Distance Matrix	Transmita parâmetros de URL usando uma solicitação `HTTP GET`.

Diferenças na resposta da previsão de chegada

A API Routes retorna a previsão de chegada e usa a propriedade de resposta duration de maneira diferente dos serviços da API Directions e da API Distance Matrix, conforme mostrado na tabela abaixo.

Tipo de previsão de chegada API Routes API Directions
API Distance Matrix

Previsão de chegada independente do tempo e do trânsito.

Tipo de previsão de chegada	API Routes	API Directions API Distance Matrix
Previsão de chegada independente do tempo e do trânsito.	Definido usando `TRAFFIC_UNAWARE`. A previsão de chegada está 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. A previsão de chegada está contida na propriedade de resposta `duration`. A propriedade de resposta `duration_in_traffic` não é retornada.
Previsão de chegada que considera o trânsito em tempo real.	Definido usando `TRAFFIC_AWARE` ou `TRAFFIC_AWARE_OPTIMAL`. A previsão de chegada que considera o trânsito em tempo real está contida em la propriedade de resposta `duration`. A propriedade de resposta `staticDuration` contém a duração da viagem pela rota sem considerar as condições de trânsito. A propriedade `duration_in_traffic` não é mais retornada.	Definido usando `departure_time` na solicitação. A previsão de chegada que considera o trânsito em tempo real está contida na `duration_in_traffic` propriedade de resposta.

Definido usando TRAFFIC_UNAWARE.

A previsão de chegada está 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.

A previsão de chegada está contida na propriedade de resposta duration.
A propriedade de resposta duration_in_traffic não é retornada.

Previsão de chegada que considera o trânsito em tempo real.

Definido usando TRAFFIC_AWARE ou TRAFFIC_AWARE_OPTIMAL.

A previsão de chegada que considera o trânsito em tempo real está contida em la propriedade de resposta duration.
A propriedade de resposta staticDuration contém a duração da viagem pela rota sem considerar as condições de trânsito.
A propriedade duration_in_traffic não é mais retornada.

Definido usando departure_time na solicitação.

A previsão de chegada que considera o trânsito em tempo real está contida na duration_in_traffic propriedade de resposta.

Waypoints de polilinha

Não é mais necessário converter as coordenadas de latitude/longitude em waypoints de polilinha com esse serviço, que oferece suporte a um corpo de solicitação POST e, portanto, não é mais afetado pelos limites de string de URL. Alguns usuários da API Distance Matrix resolveram o problema de limites de solicitação 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 a API Directions, a API Routes usa DRIVE como o modo padrão quando uma solicitação de rota não especifica um meio de transporte. No entanto, quando uma solicitação especifica um meio de transporte para uma rota, a API Routes não retorna uma matriz de meios de transporte disponíveis como opções alternativas para a solicitação. Se o caso de uso depende desse recurso,registre um problema descrevendo como você o usa para que possamos fazer o acompanhamento.

XML como formato de resposta

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