Este guia descreve como migrar apps que usam a API Directions ou a API Distance Matrix para a API Routes. Para saber mais sobre a API Routes, consulte a visão geral do produto.
Práticas recomendadas de faturamento para migração
Essa orientação se aplica se o uso da API for alto o suficiente para passar para o nível 2 de preços. Ao migrar para uma versão mais recente de uma API, você também vai receber uma cobrança por uma SKU diferente. Para evitar o aumento de custos durante o mês da sua transição, recomendamos mudar para as novas APIs em produção o mais próximo possível do início do mês. Isso garante que você atinja os níveis de preço mensais mais econômicos durante o mês da migração. Para mais informações sobre os níveis de preços, consulte a página de preços e as perguntas frequentes sobre preços.
Atualizar os endpoints da API REST
Atualize seu 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 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 local
A especificação de pontos de passagem como polilinhas codificadas está disponível na API Directions para ajustar um grande número de pontos de passagem no limite de URL de 16.384 caracteres. Esse recurso não é necessário na API Routes porque os pontos de passagem podem ser transmitidos no corpo da solicitação REST ou gRPC como coordenadas de latitude/longitude. Para conferir exemplos, consulte o Exemplo de HTTP no documento Como calcular uma matriz de rotas ou Definir um ponto de passagem intermediário no documento Especificar pontos de passagem intermediários.
Converter parâmetros
As tabelas a seguir listam parâmetros na API Directions e na API Distance Matrix que foram renomeados ou modificados ou que não têm suporte na versão GA. Atualize seu código se estiver usando algum desses parâmetros.
Solicitar conversões de parâmetros
| Parâmetro de direções 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 |
Suporte apenas para rotas do Compute. |
mode |
travelMode |
Inclusão de suporte para |
region |
regionCode |
|
traffic_model |
trafficModel |
Saiba mais |
transit_mode |
"travelMode": "TRANSIT" |
Na API Directions, em uma rota de transporte público, cada segmento de uma viagem com o mesmo modo de transporte (por exemplo, a pé ou de transporte público) é considerado uma etapa, e as direções individuais para esse modo de transporte estão em subetapas. Por outro lado, na API Routes, as etapas são consistentemente uma instrução de navegação para todos os tipos de viagem. Cada instrução de navegação é uma etapa. Para várias etapas em um modo de transporte, a API Routes fornece metadados que contêm um resumo das etapas desse modo, em "stepsOverview". Para solicitar esses metadados, use a máscara de campo "routes.legs.stepsOverview". Saiba mais. |
transit_routing_preference |
transitRoutingPreference |
Saiba mais |
units |
units |
Saiba mais |
waypoints |
intermediates |
Remoção do suporte a polígonos codificados. |
optimize=true para waypoints |
"optimizeWaypointOrder": "true" |
Saiba mais |
Conversões de parâmetros de resposta
| Parâmetro de direções 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:
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 erros informados pela API. Consulte Processar erros de solicitação para mais informações. | |
geocoded_waypoints |
geocoding_results |
Suporte apenas para rotas do Compute. 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 |