Esta página foi traduzida pela API Cloud Translation.

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 os 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 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ções

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 cálculo de rotas oferece estas melhorias:

Informações sobre pedágios, além da distância e do HEC.
Rotas para veículos de duas rodas.
Qualifique seus pontos de parada para 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 Compute Routes Compute Route Matrix	As solicitações precisam usar uma máscara de campo para especificar quais campos você quer 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 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 seu app não precise deles. Isso pode resultar em tempo de processamento e cobranças desnecessários.

Cálculos de rotas aprimorados 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ânsito independentes de tempo, não dados de trânsito 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 do tráfego 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 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 Distance Matrix. Essa preferência é equivalente ao modo usado por 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 roteamento entre os serviços da API Routes, 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 A menor latência 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	A menor latência 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. Ela tem uma latência muito menor do que `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 matriz de rotas do Compute, 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.

Ela tem uma latência muito menor do que 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 matriz de rotas do Compute, 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.

Chamar um serviço em vez de dois

API Routes	Ative apenas um serviço no console de API 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: a API Directions e a 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 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 a estimativa 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 HEC API Routes API Directions
API Distance Matrix

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

Tipo de HEC	API Routes	API Directions API Distance Matrix
Previsão de chegada independente do tempo e sem informações de trânsito.	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 estar 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.	Definido usando `TRAFFIC_AWARE` ou `TRAFFIC_AWARE_OPTIMAL`. A ETA 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.	Definido usando `departure_time` na solicitação. A ETA que considera o trânsito em tempo real está contida 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 estar 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.

Definido usando TRAFFIC_AWARE ou TRAFFIC_AWARE_OPTIMAL.

A ETA 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.

Definido usando departure_time na solicitação.

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

Pontos de referência de polilinha

Não é mais necessário converter as coordenadas de latitude/longitude em pontos de referência de polilinha com esse serviço, que é compatível com 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 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 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. Há vários conversores de JSON para XML on-line que podem atender às suas necessidades.