Neste guia, descrevemos como migrar apps que usam a API Directions ou a API Distance Matrix para utilizar a API Routes. Para saber mais sobre a API Routes, consulte a visão geral do produto.
Atualizar os endpoints da API REST
Atualize o código para usar os novos endpoints da API Routes
Da API Directions
| API Directions | https://maps.googleapis.com/maps/api/directions/outputFormat?parameters |
| API Routes | https://routes.googleapis.com/directions/v2:computeRoutes |
Da API Distance Matrix
| API Distance Matrix | https://maps.googleapis.com/maps/api/distancematrix/outputFormat?parameters |
| API Routes | https://routes.googleapis.com/distanceMatrix/v2:computeRouteMatrix |
Converter parâmetros de URL para usar um corpo de solicitação HTTPS
Com as APIs Directions e Distance Matrix, você transmite propriedades de configuração como parâmetros de URL para uma solicitação HTTP GET. Por exemplo, para a API Directions:
https://maps.googleapis.com/maps/api/directions/outputFormat?parameters
Com a API Routes, você transmite parâmetros no corpo de uma solicitação ou em cabeçalhos como parte de uma solicitação HTTP POST. Para exemplos, veja:
Converter waypoints codificados em polilinhas em waypoints de localização
A especificação de waypoints como polilinhas codificadas está disponível na API Directions para que se ajustem a um grande número de waypoints no limite de 16.384 caracteres do URL. Esse recurso não é necessário na API Routes porque os waypoints podem ser transmitidos no corpo da solicitação REST ou gRPC como coordenadas de latitude/longitude. Consulte Exemplo de HTTP no documento Calcular uma matriz de rota ou Definir um waypoint intermediário no documento Especificar waypoints intermediários.
Converter parâmetros
As tabelas a seguir listam os parâmetros nas APIs Directions e Distance Matrix que foram renomeados ou modificados ou que não são compatíveis com a versão do GA. Atualize seu código se você estiver usando algum desses parâmetros.
Conversões de parâmetros de solicitação
| Parâmetro de rotas ou matriz de distância | Parâmetro da API Routes | Observações |
|---|---|---|
alternatives |
computeAlternativeRoutes |
|
arrival_time |
arrivalTime |
Disponível apenas no modo TRANSIT, e não ao mesmo
tempo que departureTime. |
avoid |
routeModifiers |
|
departure_time |
departureTime |
Não pode ser usado ao mesmo tempo que arrivalTime. |
language |
languageCode |
Compatível apenas com o Compute Routes. |
mode |
travelMode |
Foi adicionado suporte a |
region |
regionCode |
|
traffic_model |
trafficModel |
Saiba mais |
transit_mode |
"travelMode": "TRANSIT" |
Na API Directions, em um trajeto de transporte público, cada trecho de uma viagem com o mesmo meio de transporte (por exemplo, "A pé" ou "Transporte público") é considerado uma etapa, e as rotas individuais desse meio estão em subetapas. Por outro lado, na API Routes, as etapas são consistentemente uma instrução de navegação em todos os tipos de viagem. Portanto, cada instrução de navegação é uma etapa. Para várias etapas em um modo de viagem, a API Routes fornece metadados com um resumo das etapas desse meio de transporte em "stepsOverview". Para solicitar esses metadados, use a máscara de campo "routes.legs.stepsOverview". Saiba mais. |
transit_routing_preference |
transitRoutingPreference |
Saiba mais |
units |
Não disponível para a matriz de rota. | |
waypoints |
intermediates |
Remoção da compatibilidade com polilinhas codificadas. |
optimize=true para waypoints |
"optimizeWaypointOrder": "true" |
Saiba mais |
Conversões de parâmetros de resposta
| Parâmetro de rotas ou matriz de distância | Parâmetro da API Routes | Observações |
|---|---|---|
copyrights |
Não incluído na resposta. Você precisa incluir a seguinte instrução ao mostrar os resultados aos usuários:
Exemplo:
|
|
distance |
distanceMeters |
A distância só está disponível em metros. |
duration_in_traffic |
duration |
Removido na API Routes, use duration. |
status |
Indisponível. Use os códigos de resposta HTTP para os erros informados pela API. Consulte Processar erros de solicitação para mais informações. | |
geocoded_waypoints |
geocoding_results |
Compatível apenas com o Compute Routes. Contém informações de resposta de geocodificação apenas para waypoints especificados como endereços. |
bounds |
viewport |
|
legs.end_address |
Indisponível. | |
legs.start_address |
Indisponível. | |
overview_polyline |
polilinha | |
summary |
description |
|
waypoint_order |
optimizedIntermediateWaypointIndex |