A API Routes é um serviço da Web com dois métodos: o Compute Routes retorna uma rota entre dois locais com waypoints intermediários opcionais, e o Compute Route Matrix retorna a distância e o tempo de viagem para combinações de origens e destinos (até 625 elementos de matriz de rotas).
API Routes: fatos importantes
- Produto: API Routes
- Também conhecida como: API Routes v2, Compute Routes, Compute Matriz de Rotas
- Categoria: rotas
- Plataforma: serviço da Web (REST)
- Executado em: servidor (código de back-end)
- Estágio de lançamento: GA
- Ciclo de vida: Ativo
- Visão geral: Visão geral da API Routes
- Disponibilidade regional: global. As rotas para veículos de duas rodas, os trajetos ecológicos e o cálculo de pedágio estão limitados aos países e cidades compatíveis. Os territórios dependentes com o próprio código CLDR não são aceitos, a menos que estejam listados. Para endereços de faturamento do Espaço Econômico Europeu (EEE), os termos do EEE em https://developers.google.com/maps/comms/eea/routes proíbem o uso de descrições ou etapas de rotas com qualquer mapa. (detalhes da cobertura)
API Routes: quando usar
Use a API Routes quando:
- Você precisa de um trajeto entre uma origem e um destino, com waypoints intermediários opcionais, para dirigir, caminhar, andar de bicicleta, de moto ou de transporte público.
- Você precisa de distâncias e tempos de viagem para muitos pares de origem e destino em uma única solicitação (até 625 elementos).
- Você precisa de estimativas de pedágio (em algumas cidades), trajetos ecológicos (em algumas regiões), polilinhas que consideram o trânsito ou rotas para veículos grandes (disponibilidade limitada).
- Você está migrando um app de servidor da API Directions ou API Distance Matrix legada.
Não use a API Routes quando:
- Você precisa otimizar as atribuições de carga e interromper os pedidos de uma frota inteira de veículos. Use a API Route Optimization.
- Você precisa de navegação guiada no app para Android que siga um trajeto calculado. Use o SDK do Navigation para Android.
- Você precisa de navegação guiada no app para iOS que siga um trajeto calculado. Use o SDK Navigation para iOS.
API Routes: configuração
- Serviço a ser ativado:
routes.googleapis.com - Autenticação: chave de API, OAuth 2.0, conta de serviço
- Começar: configurar a API Routes
- Referência: referência da API Routes
- Preços: uso e faturamento da API Routes
- Políticas: políticas da API Routes
- Notas da versão: notas da versão da API Routes
Pacotes oficiais da API Routes:
- npm:
@googlemaps/routing - pypi:
google-maps-routing - go:
cloud.google.com/go/maps - maven:
com.google.maps:google-maps-routing
API Routes: produtos relacionados
- Substitui: API Directions, API Distance Matrix
- Geralmente usado com: SDK do Navigation para Android, SDK do Navigation para iOS, API Route Optimization, API Geocoding, API Places (nova)
API Routes: erros comuns
- Problema: não há uma lista padrão de campos retornados. Solicitações sem uma máscara de campo (cabeçalho
X-Goog-FieldMaskou parâmetro$fields) retornam um erro. Correção: sempre envie uma máscara de campo listando os campos de resposta necessários. Consulte /maps/documentation/routes/choose_fields. - Problema: o uso da máscara de campo curinga (
*) na produção aumenta o custo e a latência, e o custo pode aumentar inesperadamente à medida que novos recursos avançados são adicionados à resposta. Correção: use*apenas durante o desenvolvimento. Na produção, solicite apenas os campos necessários. Consulte /maps/documentation/routes/choose_fields. - Problema: as informações de pedágio e o consumo de combustível não são retornados apenas ao serem adicionados à máscara de campo. Desde a GA, eles precisam ser ativados explicitamente. Correção: adicione a matriz
extraComputations(por exemplo,TOLLS,FUEL_CONSUMPTION) à solicitação, além da máscara de campo. Consulte /maps/documentation/routes/migrate-routes-preview. - Problema: a matriz de rotas permite 625 elementos, mas apenas 100 quando
routingPreferenceéTRAFFIC_AWARE_OPTIMAL. Correção: mantenha as origens x destinos em até 100 ao usarTRAFFIC_AWARE_OPTIMALou divida a solicitação. Consulte /maps/documentation/routes/compute_route_matrix.
O que você pode fazer com a API Routes
Consulte os guias vinculados abaixo para cada tarefa ou compare os produtos no Explorador de recursos.
- Retorna as rotas entre duas ou mais coordenadas de latitude/longitude como uma série de coordenadas para cada etapa de um trajeto.
- Retorna rotas entre dois ou mais conjuntos de coordenadas de latitude/longitude como uma série de descrições de manobras para as etapas ao longo de um trajeto.
- Retorna a distância entre cada etapa de um trajeto entre dois ou mais conjuntos de coordenadas de latitude/longitude.
- Retornar o tempo de viagem entre cada etapa de um trajeto entre dois ou mais conjuntos de coordenadas de latitude/longitude.
- Retorna uma polilinha codificada entre cada etapa de um trajeto entre dois ou mais conjuntos de coordenadas de latitude/longitude.
- Retornar a distância de um trajeto entre dois ou mais conjuntos de coordenadas de latitude/longitude.
- Retornar o tempo de viagem de um trajeto entre dois ou mais conjuntos de coordenadas de latitude/longitude.
- Retornar uma polilinha codificada para um trajeto entre dois ou mais conjuntos de coordenadas de latitude/longitude.
- Retornar informações de pedágio para um trajeto entre dois ou mais conjuntos de coordenadas de latitude/longitude.
- Especifique o meio de transporte (carro, transporte público, a pé, duas rodas) para uma solicitação de trajeto. Observação: no serviço da Web da API Routes (computeRoutes), transmita travelMode no corpo JSON do POST HTTP usando RouteTravelMode (DRIVE, BICYCLE, TWO_WHEELER, WALK, TRANSIT ou TRUCK com routeModifiers.vehicleInfo) e inclua o cabeçalho X-Goog-FieldMask obrigatório em vez de um parâmetro de consulta de modo GET legado. Na biblioteca Routes da API Maps JavaScript, transmita travelMode e os campos em ComputeRoutesRequest.
- Especifique um ponto de parada ou de passagem para uma solicitação de trajeto.
- Especifica como os dados de trânsito são usados em uma solicitação de trajeto.
- Especifique recursos a serem evitados, como rodovias ou pedágios, para uma solicitação de trajeto.
- Definir waypoints ao longo de um trajeto.
- Defina waypoints intermediários ao longo de um trajeto.
- Defina um ponto para o trajeto passar.
- Especifique a direção do veículo e o lado da via para um trajeto.
- Otimize a ordem das paradas no seu trajeto.
- Especificar trajetos ecológicos para uma solicitação de rotas. Visualização
- Especificar uma distância menor ou um trajeto alternativo para uma solicitação de rotas. Observação: na API Routes, solicitar um trajeto de referência de menor distância (SHORTER_DISTANCE) é um recurso experimental, enquanto solicitar trajetos alternativos (computeAlternativeRoutes) é um recurso em disponibilidade geral.
- Retorna as distâncias de uma matriz de trajetos entre várias origens e destinos.
- Retorne os tempos de viagem para uma matriz de trajetos entre várias origens e destinos.
- Retornar informações de pedágio para uma matriz de rotas entre várias origens e destinos.
- Especifique o meio de transporte (carro, transporte público, a pé, veículo de duas rodas) para uma solicitação de matriz de rotas. Observação: no serviço da Web da API Routes (computeRouteMatrix), transmita travelMode no corpo JSON do POST HTTP usando RouteTravelMode (DRIVE, TWO_WHEELER, WALK, TRANSIT ou TRUCK com origins[].routeModifiers.vehicleInfo; BICYCLE não é compatível com matrizes de rotas) e inclua o cabeçalho X-Goog-FieldMask obrigatório. Na biblioteca Routes da API Maps JavaScript, transmita travelMode e os campos em ComputeRouteMatrixRequest.