Migrar da API Directions ou API Distance Matrix

Neste guia, descrevemos como migrar apps que usam a API Directions ou a API Distance Matrix para usar 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 a API Directions e a API Distance Matrix, você transmitir propriedades de configuração como parâmetros de URL para uma solicitação HTTP GET. Para exemplo, para a API Directions:

https://maps.googleapis.com/maps/api/directions/outputFormat?parameters

Com a API Routes, você transmite parâmetros em um corpo de 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 pontos de referência como polilinhas codificadas está disponível no API Directions para atender a uma o número de pontos de referência no limite do URL de 16.384 caracteres. Este 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. Por exemplo, consulte Exemplo de HTTP no documento Calcular uma matriz de rotas, ou Definir um waypoint intermediário no documento Especificar waypoints intermediários.

Converter parâmetros

As tabelas a seguir listam os parâmetros nas a API Directions e a API Distance Matrix que tenham foram renomeadas ou modificadas ou parâmetros que não são compatíveis com o GA lançamento. 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 momento como 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 para TWO_WHEELER e TRANSIT.
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é" Transporte público) é considerada uma etapa, e direções individuais que o modo de transporte está em subetapas. Em contraste, API Routes, as etapas são, de forma consistente, 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 meio de transporte, a API Routes fornece metadados que contenham um resumo das etapas desse meio de transporte, em `stepsOverview`. Para solicitar esses metadados, use o 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. É necessário incluir a seguinte declaração ao mostrar os resultados aos usuários:

Powered by Google, ©YEAR Google

Exemplo:

Powered by Google, ©2022 Google
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 erros relatados 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