A API Routes oferece melhor desempenho para calcular rotas, distância e tempo de viagem, o que vale a pena substituir os apps que usam atualmente as APIs Directions e 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 |
|
| API Distance Matrix |
|
Respostas mais rápidas às solicitações
O recurso da matriz de rotas de computação oferece as seguintes melhorias de latência:
- Receba elementos de streaming da resposta antes que a matriz inteira 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 os custos.
- Cálculos de rota aprimorados para tráfego, para que você possa fazer a troca entre a qualidade dos dados e o 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.
- Roteiros de veículos de duas rodas.
- Qualifique seus pontos de passagem por segurança.
- HEC mais preciso com a definição da direção de deslocamento e do lado da via para os waypoints.
Solicite apenas os dados necessários
Agora você especifica quais campos serão retornados, reduzindo o tempo de processamento e as cobranças de faturamento.
| API Routes | Suas 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ários.
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 desnecessário e cobranças de faturamento. |
Cálculos de rota aprimorados para o 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áfego.
Para mais informações, consulte Configurar qualidade x latência.
TRAFFIC_UNAWARE (padrão) |
Usa dados de tráfego médios independentes de tempo, não dados de tráfego em tempo real, para calcular a rota, resultando na menor latência de resposta. Essa configuração é equivalente ao caso em que o tráfego não é usado na API Directions e na API Distance Matrix. |
TRAFFIC_AWARE (novo) |
Qualidade de tráfego ao vivo 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, sem equivalente na API Directions ou na API Distance Matrix.
|
TRAFFIC_AWARE_OPTIMAL |
Dados de tráfego abrangentes e de alta qualidade. Essa configuração produz a latência mais alta 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 do cálculo de rota
A tabela a seguir compara as opções de roteamento 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 |
A propriedade departure_time não foi 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 a Ele tem uma latência muito menor do que |
| 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 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 de esses serviços nos seus apps atuais.
Chamar um serviço em vez de dois
| API Routes | Ative apenas um serviço no console da API para que o app use as rotas e a matriz de rotas do Compute.
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 da API. |
Usa solicitações HTTPS POST
| API Routes | Transmita parâmetros no corpo da solicitação ou nos
cabeçalhos como parte de uma solicitação HTTP POST. Confira exemplos em: - 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 ETA
A API Routes retorna a hora estimada de chegada e usa a propriedade de resposta duration de maneira diferente da API Directions e dos serviços da API Distance Matrix, conforme mostrado na tabela abaixo.
| Tipo de HEC | API Routes | API Directions API Distance Matrix |
|---|---|---|
| HEC sem informações de trânsito e independente do horário. | Defina usando
|
Corresponde a
|
| HEC que considera o trânsito em tempo real. | Defina usando
|
Defina o uso de
|
Waypoints de polilinha
Não é mais necessário converter as coordenadas de latitude/longitude em pontos de passagem de poligonal 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 dos limites de solicitação convertendo pontos de latitude/longitude em waypoints de polilinha.
Endereços formatados (geocódigo reverso)
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 o modo DIRIGIDO como padrão quando uma solicitação de rota não especifica um modo de transporte. No entanto, quando uma solicitação especifica um modo de transporte para uma rota, a API Routes não retorna uma matriz de modos de transporte disponíveis como opções alternativas para a solicitação. Se o seu caso de uso depender desse recurso, envie um problema descrevendo como você usa o recurso para que possamos fazer o acompanhamento.
XML como formato de resposta
A API Routes não fornece XML como um formato de resposta. Você pode encontrar vários convertidores de JSON para XML on-line que atendem às suas finalidades.