As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
# Rotas do Amazon Location Service
![\[Uma visão geral de rotas do Amazon Location Service.\]](http://docs.aws.amazon.com/pt_br/location/latest/developerguide/images/routesV2/route-banner.png)
Com as rotas do Amazon Location Service, você pode calcular o tempo de viagem e a distância entre vários pontos de partida e chegada, visualizar rastreamentos de GPS de veículos alinhados com estradas e entender melhor suas áreas de serviço. Isso ajuda a reduzir os custos operacionais e melhorar a experiência do cliente.
## Atributos
**Planejar um caminho de rota**
Calcule rotas entre dois ou mais locais, considerando vários fatores, como distância, tempo e condições da estrada. Você também pode ver rotas alternativas para o mesmo conjunto de locais.
**Otimização de tabelas**
Otimize as rotas por tempo ou distância, escolhendo a rota mais rápida ou a mais curta. Você também pode sequenciar pontos de referência para otimizar o problema do ambulante viajante.
**Análise de rota**
Analise métricas de desempenho, como tempo de viagem, distância ou número de paradas, para garantir que a rota atenda às metas desejadas.
**Área de serviço**
Define a área geográfica que pode ser atendida desde um determinado local com base nos limites de distância ou tempo.
**Custos de pedágio**
Calcule os custos associados à infraestrutura de pedágio em sua rota.
**Evasões**
Restrinja o cálculo da rota evitando rodovias, túneis, balsas e estradas com pedágio.
**Limites de velocidade**
Encontre limites de velocidade para cada segmento de uma rota, garantindo que os motoristas estejam em conformidade com as regulamentações locais.
![\[Um aplicativo usando os atributos de roda do Amazon Location Service.\]](http://docs.aws.amazon.com/pt_br/location/latest/developerguide/images/routesV2/route-demo.png)
## Casos de uso
**Forneça rotas eficientes e direções passo a passo**
Planeje rotas desde qualquer local de partida (endereço, POI ou coordenadas de GPS) e calcule o melhor caminho para vários destinos, considerando as dimensões e restrições do veículo.
Para obter mais informações, consulte [Calcular rotas](calculate-routes.md).
**Otimizar as rotas de entrega**
Use o sequenciamento de pontos de referência para resolver o problema do ambulante viajante e calcular a rota ideal para vários destinos, minimizando o tempo e a distância.
Para obter mais informações, consulte [Otimizar pontos de referência](actions-optimize-waypoints.md).
**Certificar-se de que as entregas sejam feitas no armazém mais próximo**
Use a rota de matriz e o sequenciamento de pontos de referência para identificar a rota mais rápida de seus armazéns até cada cliente, maximizando a eficiência e minimizando os custos.
Para obter mais informações, consulte [Calcular rotas](calculate-routes.md) e [Calcular matriz de rotas](calculate-route-matrix.md).
**Melhorar o envio de táxis e viagens compartilhadas**
Use a rota de matriz para identificar o veículo disponível mais próximo e calcular as rotas ideais com base no tráfego em tempo real. Isso garante que o veículo mais próximo chegue ao cliente de forma eficiente, aumentando a satisfação do cliente e a produtividade da empresa. Faça mais viagens, economize nos custos de combustível e ofereça uma experiência de serviço superior.
Para obter mais informações, consulte [Calcular rotas](calculate-routes.md), [Calcular matriz de rotas](calculate-route-matrix.md) e [Calcular isolinhas](calculate-isolines.md).
**Encontrar áreas de serviço**
Use rotas Isoline para determinar o alcance geográfico de sua empresa, com base em restrições de tempo ou distância. Isso permite que a empresa identifique clientes em potencial e faça planos de despacho. Os provedores de serviços de saúde domiciliares podem garantir que tenham pessoal e recursos suficientes para alcançar todos os pacientes em 15 minutos. A Isoline ajuda a otimizar as áreas de serviço, garantir entregas oportunas e localizar novas instalações.
Para obter mais informações, consulte [Calcular isolinhas](calculate-isolines.md).
**Ajustar o rastreamento de GPS às estradas**
Alinhe os rastreamentos de GPS às estradas e visualize os movimentos do veículo, garantindo a aderência à rota e a conformidade regulatória. Os gerentes de frota podem ver se os veículos permanecem nas rotas planejadas e identificar desvios. Verifique se os motoristas estão seguindo as orientações, identifique casos de ineficiência e garanta a conformidade com os regulamentos. Corrige imprecisões e variações do GPS e apresenta uma visão realista da atividade do veículo. Permita uma melhor tomada de decisão sobre otimização de rotas, comportamento do motorista e gerenciamento de frotas.
Para obter mais informações, consulte [Ajustar às estradas](snap-to-roads.md).
## APIs
Essa tabela fornece uma visão geral das principais APIs do Amazon Location Service para planejamento de rotas e processamento de dados com base na localização. Cada API oferece funcionalidades exclusivas, como calcular rotas, otimizar pontos de referência e ajustar rastreamentos de GPS nas estradas para oferecer um rastreamento preciso.
**APIs**
| Nome da API | Descrição | Ler mais |
| --- | --- | --- |
| Calcular rotas | Calcule o tempo de viagem, a distância e as direções passo a passo entre um ponto de partida e vários destinos, considerando restrições de veículos e tráfego em tempo real. | [Calcular rotas](calculate-routes.md) |
| Calcular matriz de rotas | Calcule a distância de rota e o tempo de rota entre um conjunto de pontos de partida e um conjunto de destinos, considerando o tráfego em tempo real. | [Calcular matriz de rotas](calculate-route-matrix.md) |
| Calcular isolinhas | Identifique a área geográfica que pode ser alcançada dentro de um tempo ou distância específicos com base em seus modos de viagem. | [Calcular isolinhas](calculate-isolines.md) |
| Otimizar pontos de referência | Encontre a ordem eficiente para viajar para vários destinos, reduzindo o tempo e a distância da viagem e considerando fatores como restrições de tráfego e veículos. | [Como otimizar pontos de referência para uma rota](optimize-waypoints.md) |
| Ajustar às estradas | Combine os rastreamentos de GPS com o segmento de estrada mais próximo, para melhorar a precisão do rastreamento de veículos e da visualização da rota. | [Ajustar às estradas](snap-to-roads.md) |
# Conceitos de rotas
Os conceitos de rotas no Amazon Location Service fornecem uma estrutura robusta para planejar e otimizar viagens, seja para navegação simples ou logística complexa. As rotas abrangem vários componentes, como pontos de referência, trechos, etapas e pequenas distâncias, cada um contribuindo para a granularidade e a flexibilidade dos cálculos de rotas. Aproveitando a API de rotas, você pode calcular distâncias de viagem, estimar tempos de viagem e otimizar viagens com várias paradas. Além disso, atributos como geometria da rota, reconhecimento de tráfego, limites de velocidade, custos de pedágio e codificação flexível de polilinhas aprimoram os recursos de visualização, análise e eficiência operacional. Esta seção aborda a terminologia, as práticas recomendadas e os padrões de uso detalhados, orientando você na implementação de soluções de rotas eficazes para navegação, entrega, serviços de campo e muito mais.
**Topics**
+ [Terminologia de rotas](routes-terminology.md)
+ [Onde (origem, destino, ponto de referência e traços)](concepts-where.md)
+ [Quando (partida e chegada)](concepts-when.md)
+ [Como (modo de viagem, evasão e exclusão)](concepts-how.md)
+ [Conscientização do trânsito](concepts-traffic-awareness.md)
+ [Otimizar a sequência de rotas e pontos de referência](optimize-route-waypoint.md)
+ [Itinerário e avisos para o motorista](driver-schedule-notices.md)
# Terminologia de rotas
**Rota**
Uma rota fornece detalhes para viajar de uma posição de partida por meio de posições de ponto de referência até um destino. Inclui distância de viagem, tempo de viagem, geometria da rota, limites de velocidade, pequenas distâncias e outros atributos.
**Matriz de rotas**
Uma matriz que representa a distância e o tempo de viagem de um conjunto de origens a um conjunto de destinos. É útil como entrada para aplicativos de planejamento ou otimização de rotas.
**Ponto de parada**
Os pontos de referência são paradas intermediárias ao longo de uma rota do ponto de partida até o destino. A rota segue a ordem de parada, conforme especificado na solicitação.
**Elemento**
Um trecho representa a viagem entre duas posições consecutivas em uma rota. Se as posições não estiverem localizadas fora da estrada, elas serão movidas para a estrada mais próxima. Uma rota sem pontos de parada consiste em um único trecho. As rotas com um ou mais pontos de referência têm vários trechos, com cada trecho representando a viagem de um ponto de referência para o outro. Certos trechos, como aqueles que envolvem balsas, contêm informações específicas pertinentes a esse tipo de trecho.
**Etapa**
Uma etapa é um segmento dentro de um trecho, fornecendo detalhes resumidos dessa parte da jornada. Os tipos de etapas incluem:
+ **Etapas padrão** – Etapas básicas com instruções legíveis por humanos, adequadas para aplicativos web que exibem uma visão geral da rota.
+ **Etapas passo a passo** – Etapas detalhadas adequadas para aplicações passo a passo, fornecendo instruções granulares.
+ **Etapas antes da viagem** – Etapas a serem concluídas antes de se iniciar a viagem. Exemplo: embarcar em uma balsa.
+ **Etapas após a viagem** – Etapas a serem concluídas após se chegar ao final de uma viagem. Exemplo: desembarcar de uma balsa.
**Span**
Uma pequena distância representa uma extensão contínua de uma estrada que compartilha um conjunto consistente de atributos. Novas pequenas distâncias são criadas ao longo de uma rota sempre que um dos atributos solicitados é alterado.
**Segmento**
Um segmento é uma parte navegável de uma estrada, normalmente representada como uma extensão linear.
**Geometria da rota**
A geometria da rota descreve o caminho de uma rota para visualização, análise ou outros usos. A geometria de cada trecho da rota pode ser representada como uma polilinha compactada e codificada ou como uma string de linha simples.
**Polilinha flexível**
Um formato de polilinha compacto e codificado para representar a geometria. Recomendado para limitar o tamanho da resposta e otimizado para decodificação do lado do cliente.
**String de linha simples**
Um formato GeoJSON LineString representando a geometria. Esse formato produz uma carga útil de resposta maior e é uma matriz ordenada de coordenadas que pode ser usada para traçar rotas em um mapa.
# Onde (origem, destino, ponto de referência e traços)
Especifica o local para o cálculo da rota, incluindo onde a rota começa, termina e as paradas intermediárias (ou locais a serem percorridos).
**Especifica o local para o cálculo da rota**
| Parameter | Descrição | Rotas | Matriz de rotas | Isolinha | Otimizar ponto de referência | Ajustar à estrada |
| --- | --- | --- | --- | --- | --- | --- |
| Origin(s) | Posição inicial da rota. | Sim, com opções | Sim, com opções | Sim, com opções | Sim, com opções | Não |
| Waypoint | Posições intermediárias a serem incluídas ao longo da rota. | Sim, com opções | Sim, com opções | Sim, com opções | Sim, com opções | Não |
| Destination(s) | Posição final da rota. | Sim, com opções | Sim, com opções | Sim, com opções | Sim, com opções | Não |
| Trace points | Traço de GPS que inclui informações históricas de posição emitidas por um modo de viagem. Essas posições incluem imprecisões e falhas típicas do GPS quando o dispositivo não consegue emitir ou registrar essas informações. | Não | Não | Não | Não | Sim, com opções |
## Opções configuráveis
Fornece opções para personalizar o comportamento da rota para pontos de referência, origens e destinos.
**Opções de pontos de referência**
| Parameter | Descrição | Rotas | Matriz de rotas | Isolinha | Otimizar ponto de referência | Ajustar à estrada |
| --- | --- | --- | --- | --- | --- | --- |
| AvoidActionsForDistance | Evita ações para a distância fornecida. Normalmente usado para garantir que os motoristas tenham tempo suficiente para tomar decisões perto dos pontos de referência. | Sim | Não | Não | Não | Não |
| AvoidUTurns | Especifica se os retornos são permitidos no ponto de referência. | Sim | Não | Não | Não | Não |
| Heading | GPS indo para a posição do ponto de referência. | Sim | Não | Não | Sim | Não |
| Matching | Opções para configurar a correspondência da posição informada com a rede rodoviária. | Sim, com opções | Não | Não | Não | Não |
| SideOfStreet | Especifica o lado da rua para associar à posição do ponto de referência. | Sim, com opções | Não | Não | Sim, com opções | Não |
| StopDuration | Duração da parada na posição do ponto de referência. | Sim | Não | Não | Não | Não |
| Position | Longitude e latitude do ponto de referência. | Sim | Não | Não | Sim | Não |
| PassThrough | Determina se o ponto de referência deve ser tratado como uma parada ou uma passagem. | Sim | Não | Não | Não | Não |
| Id | Cadeia de caracteres de identificação do ponto de referência. | Não | Não | Não | Sim | Não |
| AccessHours | Especifica as horas de acesso para visitar o destino. | Não | Não | Não | Sim | Não |
| AppointmentTime | Horário de compromisso agendado no ponto de referência. | Não | Não | Não | Sim | Não |
| ServiceDuration | Tempo de serviço no ponto de referência, como a duração de um compromisso. | Não | Não | Não | Sim | Não |
| Before | Define quais pontos de referência devem ser visitados depois deste. | Não | Não | Não | Sim | Não |
**Opções de origem**
| Parameter | Descrição | Rotas | Matriz de rotas | Isolinha | Otimizar ponto de referência | Ajustar à estrada |
| --- | --- | --- | --- | --- | --- | --- |
| AvoidActionsForDistance | Evita ações para a distância fornecida. | Sim | Sim | Sim | Não | Não |
| AvoidUTurns | Especifica se os retornos são permitidos na origem. | Sim | Não | Não | Não | Não |
| Heading | GPS indo para a posição de origem. | Sim | Sim | Sim | Não | Não |
| Matching | Opções para associar a posição de origem à rede rodoviária. | Sim, com opções | Sim, com opções | Sim, com opções | Não | Não |
| SideOfStreet | Especifica o lado da rua para associar à posição de origem. | Sim, com opções | Sim, com opções | Sim, com opções | Não | Não |
| Id | Cadeia de caracteres para identificação da origem. | Não | Não | Sim | Não | Não |
**Opções de destino**
| Parameter | Descrição | Rotas | Matriz de rotas | Isolinha | Otimizar ponto de referência | Ajustar à estrada |
| --- | --- | --- | --- | --- | --- | --- |
| AvoidActionsForDistance | Evita ações para a distância fornecida no destino. | Sim | Sim | Sim | Não | Não |
| AvoidUTurns | Especifica se os retornos são permitidos no destino. | Sim | Não | Não | Não | Não |
| Heading | GPS indo à posição de destino. | Sim | Sim | Sim | Sim | Não |
| Matching | Opções para associar a posição de destino à rede rodoviária. | Sim, com opções | Sim, com opções | Sim, com opções | Não | Não |
| SideOfStreet | Especifica o lado da rua para associar à posição de destino. | Sim, com opções | Sim, com opções | Sim, com opções | Sim, com opções | Não |
| StopDuration | Duração da parada no destino. | Sim | Não | Não | Não | Não |
| Id | Cadeia de caracteres para identificação do destino. | Não | Não | Sim | Não | Não |
| AccessHours | Especifica as horas de acesso para visitar o destino. | Não | Não | Sim | Não | Não |
| AppointmentTime | Hora do compromisso agendado no destino. | Não | Não | Sim | Não | Não |
| ServiceDuration | Tempo de serviço no destino, como a duração de um compromisso. | Não | Não | Sim | Não | Não |
# Quando (partida e chegada)
Especifica o horário para o cálculo da rota. O horário não apenas determina os registros de data e hora de partida e chegada, como também influencia os dados de tráfego a serem usados.
| Parameter | Descrição | Rotas | Matriz de rotas | Isolinha | Otimizar ponto de referência | Ajustar à estrada |
| --- | --- | --- | --- | --- | --- | --- |
| Departure Time | Hora de partida do ponto de origem. Se nem a hora de chegada nem de partida forem informadas, as informações dinâmicas de tráfego não forem usadas e somente as velocidades de fluxo livre com base no histórico de tráfego forem aplicadas. | Sim | Sim | Sim | Sim | Não |
| Depart Now | Usa a hora atual como a hora de partida do ponto de origem. | Sim | Sim | Sim | Não | Não |
| Arrival Time | Hora de chegada ao destino. Se nem a hora de chegada nem de partida forem informadas, as informações dinâmicas de tráfego não forem usadas e somente as velocidades de fluxo livre com base no histórico de tráfego forem aplicadas. | Sim | Não | Sim | Não | Não |
# Como (modo de viagem, evasão e exclusão)
Use as opções a seguir para especificar o modo de viagem e os atributos relacionados a serem usados no cálculo da rota.
**Opções do modo de viagem**
Especifica o modo de transporte ao calcular uma rota. Essa configuração influencia a velocidade estimada de viagem, a compatibilidade rodoviária e a possibilidade de usar balsas quando necessário.
| Parameter | Descrição | Rotas | Matriz de rotas | Isolinha | Otimizar ponto de referência | Ajustar à estrada |
| --- | --- | --- | --- | --- | --- | --- |
| Carro | Modo de viagem de carro. | Sim, com opções | Sim, com opções | Sim, com opções | Sim | Sim |
| Scooter | Modo de viagem de moto. | Sim, com opções | Sim | Sim, com opções | Sim | Sim |
| Pedestrian | Modo de viagem a pé. | Sim, com opções | Sim | Sim | Sim, com opções | Sim |
| Truck | Modo de viagem de caminhão. | Sim, com opções | Sim, com opções | Sim, com opções | Sim, com opções | Sim, com opções |
**Opções de evasão, exclusão e permissão**
Determina se um conjunto específico de atributos deve ser incluído, excluído ou evitado durante o cálculo da rota.
| Parameter | Descrição | Rotas | Matriz de rotas | Isolinha | Otimizar ponto de referência | Ajustar à estrada |
| --- | --- | --- | --- | --- | --- | --- |
| Avoidance | Atributos que são evitados na melhor das hipóteses. Se o roteador não conseguir encontrar uma rota válida, a evasão será ignorada, e um aviso indicará que não foi possível atender à solicitação de evasão. | Sim, com opções | Sim, com opções | Sim, com opções | Sim, com opções | Não |
| Exclusão | Atributos que são estritamente excluídos. Se o roteador não conseguir encontrar uma rota válida com as opções de exclusão, nenhuma rota será retornada. | Sim, com opções | Sim, com opções | Não | Não | Não |
| Permitir | Atributos que precisam ser ativados explicitamente. | Sim, com opções | Sim, com opções | Sim, com opções | Sim, com opções | Não |
**Lista de evasão**
Lista os atributos que são evitados na melhor das hipóteses. Se o roteador não conseguir encontrar uma rota válida, a evasão será ignorada, e um aviso indicará que não foi possível atender à solicitação de evasão.
| Parameter | Descrição | Rotas | Matriz de rotas | Isolinha | Otimizar ponto de referência | Ajustar à estrada |
| --- | --- | --- | --- | --- | --- | --- |
| Áreas | Áreas a serem evitadas com exceções. | Sim, com opções | Sim, com opções | Sim, com opções | Sim, com opções | Não |
| Estradas de acesso controlado | Estradas de alta velocidade com pontos de entrada limitados. | Sim | Sim | Sim | Sim | Não |
| Car Shuttle Trains | Trens que transportam veículos por túneis. | Sim | Sim | Sim | Não | Não |
| Dirt Roads | Estradas não pavimentadas com superfícies naturais. | Sim | Sim | Sim | Sim | Não |
| Ferries | Plataformas que transportam veículos sobre a água | Sim | Sim | Sim | Não | Não |
| Boat Ferries | Balsas que transportam veículos sobre trilhos ferroviários. | Não | Não | Sim | Sim | Não |
| Rail Ferries | Balsas que transportam veículos sobre trilhos ferroviários. | Não | Não | Sim | Sim | Não |
| Seasonal Closure | Estradas fechadas durante certas estações. | Sim | Não | Sim | Não | Não |
| Tunnels | Passagens subterrâneas para tráfego de veículos. | Sim | Sim | Sim | Sim | Não |
| Toll Road | Estradas que exigem pagamento em troca de acesso. | Sim | Sim | Sim | Sim | Não |
| Toll Transponders | Evita estradas onde os transponders de pedágio são o único meio de pagamento. | Sim | Não | Sim | Não | Não |
| U-Turns | Pontos que permitem que os veículos retornem para a direção inversa. | Sim | Sim | Sim | Sim | Não |
| Zone Categories | Categorias de zonas a serem evitadas. | Sim | Sim | Sim | Não | Não |
**Lista de exclusões**
Lista os atributos que são estritamente excluídos. Se o roteador não conseguir encontrar uma rota válida com as opções de exclusão, nenhuma rota será retornada.
| Parameter | Descrição | Rotas | Matriz de rotas | Isolinha | Otimizar ponto de referência | Ajustar à estrada |
| --- | --- | --- | --- | --- | --- | --- |
| Countries | Código do país 2 ou Código do país 3 para países que devem ser estritamente excluídos do cálculo da rota. | Sim | Sim | Não | Sim | Não |
**Lista de permissões**
Lista os atributos que precisam ser ativados explicitamente para o cálculo da rota.
| Parameter | Descrição | Rotas | Matriz de rotas | Isolinha | Otimizar ponto de referência | Ajustar à estrada |
| --- | --- | --- | --- | --- | --- | --- |
| HOV | Permite o uso de faixas de veículos de alta ocupação para o cálculo da rota. | Sim | Sim | Sim | Não | Não |
| HOT | Permite o uso de faixas de pedágio de alta ocupação para o cálculo da rota. | Sim | Sim | Sim | Não | Não |
# Conscientização do trânsito
Determina o tipo de informação relacionada ao tráfego usada durante o cálculo da rota. Tráfego de fluxo representa congestionamento, excluindo congestionamentos de longa duração relacionados a incidentes. A precisão dos dados do fluxo de tráfego diminui com o tempo, tornando os dados históricos de tráfego mais confiáveis para eventos passados.
| Parameter | Descrição | Rotas | Matriz de rotas | Isolinha | Otimizar ponto de referência | Ajustar à estrada |
| --- | --- | --- | --- | --- | --- | --- |
| Usage | Ativa ou desativa os dados de tráfego durante o cálculo da rota. Quando ativado, se `DepartureTime`, `ArrivalTime` ou `DepartNow` não forem informados, somente fechamentos de longa duração serão considerados. Caso contrário, se um horário for informado, todos os dados de tráfego serão levados em consideração. | Sim | Sim | Sim | Sim | Não |
| FlowEventThresholdOverride | Duração, em segundos, pela qual um evento de tráfego de fluxo é considerado válido. Embora válidos, os dados de tráfego de fluxo predominam sobre os dados históricos de tráfego. | Sim | Sim | Sim | Não | Não |
# Otimizar a sequência de rotas e pontos de referência
## Otimizar a rota
Critérios de otimização para o cálculo de uma rota. Essa pode ser a rota mais rápida medida pelo tempo ou a rota mais curta medida pela distância.
| Opção | Descrição | Medição |
| --- | --- | --- |
| Rota mais rápida | Calcule a rota mais rápida, concentrando-se em minimizar o tempo de viagem. Isso leva em consideração as condições do tráfego, os limites de velocidade da estrada e outros fatores. | Time |
| Rota mais curta | Calcule a rota mais curta, minimizando a distância percorrida. Isso geralmente é usado quando a distância é o fator chave, como reduzir os custos de combustível ou as emissões. | Distância |
## Otimizar ponto de referência
Critérios de otimização para sequenciar pontos de referência em uma rota.
# Itinerário e avisos para o motorista
## Itinerário do motorista
Configurações do motorista para definir itinerários de trabalho e descanso. Obrigatório em muitas jurisdições.
| Parâmetro | Description | Rotas | Matriz de rotas | Isolinha | Otimizar ponto de referência | Ajustar à estrada |
| --- | --- | --- | --- | --- | --- | --- |
| Custom rest cycles | Ciclos de descanso definidos pela duração da condução a serem seguidos por uma duração de descanso. Qualquer número desses ciclos pode ser informado. | Sim, com opções | Não | Não | Não | Não |
| Long rest cycle and short rest cycle | Ciclos de descanso definidos por ciclos curto e longo. Uma duração curta de viagem é seguida por uma duração curta de viagem para descanso. As viagens curtas podem ser repetidas até que uma duração longa de viagem seja atingida, momento em que a duração longa de descanso é aplicada. | Não | Não | Não | Sim, com opções | Não |
## Avisos e restrições
Informações complementares sobre as decisões tomadas durante o cálculo da rota.
| Parâmetro | Description | Rotas | Matriz de rotas | Isolinha | Otimizar ponto de referência | Ajustar à estrada |
| --- | --- | --- | --- | --- | --- | --- |
| Notices | Avisos sobre o cálculo da rota. Além disso, pode incluir um impacto no aviso, indicando se os resultados do cálculo da rota podem ser usados como estão ou se precisarão ser inspecionados manualmente antes do uso. | Sim, com detalhes | Não | Não | Não | Sim |
| FailedConstraints | Restrições fornecidas na solicitação que não foram atendidas, gerando falha do problema de otimização. | Não | Não | Não | Sim, com detalhes | Não |
# Rota APIs
As rotas fornecem funcionalidades para calcular caminhos otimizados entre locais. Esses atributos ajudam aplicações que exigem planejamento logístico, cálculos de distância e otimização de rotas. Os usuários também podem colocar pontos de localização em estradas para melhorar a precisão. Para obter mais informações, consulte[Rotas do Amazon Location Service](routes.md).
+ **CalculateIsolines**: gera isolinhas com base no tempo de viagem ou na distância, úteis para definir áreas de serviço ou zonas de acessibilidade. Para obter mais informações, consulte[Calcular isolinhas](calculate-isolines.md).
+ **CalculateRouteMatrix**: Fornece uma matriz de distâncias e tempos de viagem entre várias origens e destinos, apoiando a logística e o planejamento de viagens. Para obter mais informações, consulte[Calcular matriz de rotas](calculate-route-matrix.md).
+ **CalculateRoutes**: calcula rotas otimizadas para navegação em várias point-to-point paradas, incluindo preferências de roteamento personalizáveis. Para obter mais informações, consulte[Calcular rotas](calculate-routes.md).
+ **OptimizeWaypoints**: otimiza a ordem dos pontos de referência para a rota de viagem mais eficiente, minimizando a distância ou o tempo. Para obter mais informações, consulte[Otimizar pontos de referência](actions-optimize-waypoints.md).
+ **SnapToRoads**: alinha as coordenadas aos caminhos rodoviários mais próximos, aprimorando a precisão do GPS ao capturar pontos em estradas conhecidas. Para obter mais informações, consulte[Ajustar às estradas](snap-to-roads.md).
A tabela a seguir apresenta vários casos de uso comercial que são mais bem resolvidos com o Routes APIs.
| **Necessidade da empresa** | **API útil** | **Exemplos** |
| --- | --- | --- |
| **Calcular a distância e o tempo de viagem para uma origem e um destino**É compatível com o seguinte: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/location/latest/developerguide/choose-routes-apis.html) | `CalculateRoutes` | |
| **Encontrar uma polilinha de rota para uma origem e um destino **É compatível com o seguinte: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/location/latest/developerguide/choose-routes-apis.html) | `CalculateRoutes` | |
| **Encontrar rotas, curva a curva, para uma origem e um destino**É compatível com o seguinte: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/location/latest/developerguide/choose-routes-apis.html) | `CalculateRoutes` | |
| **Encontrar uma rota partindo agora**É compatível com o seguinte: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/location/latest/developerguide/choose-routes-apis.html) | `CalculateRoutes` | |
| **Encontrar uma rota se você partir em um horário específico**É compatível com o seguinte: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/location/latest/developerguide/choose-routes-apis.html) | `CalculateRoutes` | |
| **Encontrar uma rota se precisar chegar em um horário específico**É compatível com o seguinte: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/location/latest/developerguide/choose-routes-apis.html) | `CalculateRoutes` | |
| **Encontrar as rotas mais curtas**É compatível com o seguinte: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/location/latest/developerguide/choose-routes-apis.html) | `CalculateRoutes` | |
| **Encontrar as rotas mais rápidas **É compatível com o seguinte: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/location/latest/developerguide/choose-routes-apis.html) | `CalculateRoutes` | |
| **Encontrar rotas alternativas**É compatível com o seguinte: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/location/latest/developerguide/choose-routes-apis.html) | `CalculateRoutes` | |
| **Encontrar rotas com reconhecimento de tráfego **É compatível com o seguinte: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/location/latest/developerguide/choose-routes-apis.html) | `CalculateRoutes` | |
| **Encontre rotas com evasão, como pedágio, retorno, balsa, rodovia, túnel, entre outras **É compatível com o seguinte: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/location/latest/developerguide/choose-routes-apis.html) | `CalculateRoutes` | |
| **Encontrar rotas com evasão personalizada, passando polilinha ou polígono**É compatível com o seguinte: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/location/latest/developerguide/choose-routes-apis.html) | `CalculateRoutes` | |
| **Calcular o custo do pedágio **É compatível com o seguinte: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/location/latest/developerguide/choose-routes-apis.html) | `CalculateRoutes` | [Calcular o custo do pedágio](calculate-toll-cost.md) |
| **Encontrar o limite de velocidade de uma extensão de estrada em uma rota **É compatível com o seguinte: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/location/latest/developerguide/choose-routes-apis.html) | `CalculateRoutes` | |
| **Desenhar uma rota em um mapa**Permite marcação de pontos de referência. | `GetTile`e `GetStyleDescriptor` com mecanismo de renderização (MapLibre) com Calcular rota | |
| **Calcular a matriz de rota de distância e tempo para várias origens e destinos**É compatível com o seguinte:[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/location/latest/developerguide/choose-routes-apis.html) | `CalculateRouteMatrix` | [Como calcular uma matriz de rota de distância e tempo para várias origens e destinos](calculate-route-matrix-distance.md) |
| **Calcular a matriz de rotas com evasão**É compatível com o seguinte:[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/location/latest/developerguide/choose-routes-apis.html) | `CalculateRouteMatrix` | [Como calcular a matriz de rotas com evasão](calculate-route-matrix-with-avoidance.md) |
| **Calcular uma área de serviço com base no tempo (isócronas)**Permite modos de viagem, como caminhão, pedestre, carro e moto. | `CalculateIsolines` | [Como calcular uma área de serviço com base em intervalos de tempo](calculate-service-area-based-on-time.md) |
| **Calcular uma área de serviço com base na distância (isodistância)**Permite modos de viagem, como caminhão, pedestre, carro e moto. | `CalculateIsolines` | |
| **Calcular uma área de serviço com evasão**Permite modos de viagem, como caminhão, pedestre, carro e moto. | `CalculateIsolines` | |
| **Calcular uma área de serviço a partir da direção inversa** Permite modos de viagem, como caminhão, pedestre, carro e moto. | `CalculateIsolines` | |
| **Calcular área de serviço para vários intervalos de tempo ou distância** Permite modos de viagem, como caminhão, pedestre, carro e moto. | `CalculateIsolines` | |
| **Otimizar pontos de referência para rotas (problema de vendedor que viaja)** Permite modos de viagem, como caminhão, pedestre, carro e moto. | `OptimizeWaypoint` | [Como otimizar pontos de referência para uma rota](optimize-waypoints.md) |
| **Otimizar pontos de referência para uma rota com reconhecimento de tráfego ** Permite modos de viagem, como caminhão, pedestre, carro e moto. | `OptimizeWaypoint` | |
| **Otimizar pontos de passagem para uma rota com reconhecimento do horário de acesso** Permite modos de viagem, como caminhão, pedestre, carro e moto. | `OptimizeWaypoint` | |
| **Associar traços do GPS à rede rodoviária **Permite modos de viagem, como caminhão, pedestre, carro e moto. | Ajustar à estrada | [Como associar traços do GPS a uma rede rodoviária](how-to-match-gps-traces.md) |
| **Visualizar traços de GPS correspondentes em um mapa **Permite modos de viagem, como caminhão, pedestre, carro e moto. | `GetStyleDescriptor`com mecanismo de renderização (MapLibre) com Snap to road | |
# Calcular rotas
A API Rotas calcula rotas entre dois ou mais locais com ou sem evasões para diferentes modos de viagem, como carro, caminhão, scooter e pedestre. Com essa API, você pode personalizar as opções de rotas e solicitar informações adicionais relacionadas à rota para atender a necessidades específicas. Essa API suporta turn-by-turn navegação e personaliza cálculos de rotas aplicando parâmetros como evitar estradas com pedágio, rodovias ou balsas. A API também retorna limites de velocidade e custos de pedágio.
Para obter mais informações, consulte [CalculateRoutes](https://docs.aws.amazon.com/location/latest/APIReference/API_CalculateRoutes.html)a *Amazon Location Service API Reference*.
Por exemplo, solicitações, respostas, comandos cURL e CLI para essa API, consulte [Como usar o cálculo de rotas](https://docs.aws.amazon.com/location/latest/developerguide/calculate-routes-how-to.html).
![\[Uma visão geral de rotas do Amazon Location Service.\]](http://docs.aws.amazon.com/pt_br/location/latest/developerguide/images/routesV2/P2P-Turn-by-turn-navigation.gif)
## Casos de uso
+ **Exibir detalhes geográficos em um mapa de rotas:** use atributos avançados de mapeamento para visualizar rotas detalhadas com informações geográficas valiosas, incluindo pontos turísticos, terrenos e infraestrutura urbana. Melhore a tomada de decisões permitindo que os usuários visualizem rotas claras do ponto de partida até o destino. Esse atributo pode permitir navegação, planejamento e vários cenários logísticos, além de exibir rotas para modos de viagem, como carros, caminhões, scooters e pedestres. Personalize rotas adicionando elementos como evasões ou cálculos de pedágio.
+ **Mostrar turn-by-turn navegação:** forneça suporte de navegação contínuo na web e em dispositivos móveis. Os usuários podem acessar as turn-by-turn direções, garantindo uma viagem eficiente. As duas plataformas podem usar as instruções de navegação para oferecer rotas para viagens pessoais ou de negócios, incluindo limites de velocidade.
+ **Calcular custos de pedágio ao longo das rotas:** incorpore cálculos de custos de pedágio ao planejamento de rotas para fornecer estimativas de preços precisas para rotas que incluem estradas com pedágio, pontes ou túneis. Mostre antecipadamente os custos de pedágio para ajudar motoristas e planejadores a tomar decisões econômicas e evitar pedágios quando necessário.
+ **Garantir a conformidade com os limites de velocidade:** integre dados de limite de velocidade para ajudar os motoristas a se manterem dentro dos limites legais, reduzindo o risco de multas e promovendo uma direção mais segura e econômica. Também é útil para logística e gerenciamento de frotas, que podem monitorar a conformidade com a velocidade em tempo real.
+ **Auxiliar com soluções de fretes e rotas de veículos:** simplifique as operações de fretes e rotas de veículos integrando recursos de rotas, navegação e rastreamento em portais de logística. Planeje com eficiência rotas para várias entregas, rastreie encomendas em tempo real e gerencie os custos de combustível por meio de rotas melhores.
## Sobre a solicitação
**nota**
Para clientes em `ap-southeast-1` e`ap-southeast-5`, os campos de solicitação e resposta compatíveis podem ser diferentes. Consulte a [Referência da CalculateRoutes API](https://docs.aws.amazon.com/location/latest/APIReference/API_CalculateRoutes.html) para obter detalhes.
A solicitação exige os parâmetros `Origin` e `Destination`, enquanto parâmetros opcionais, como `Allow`, `Avoid` e `Traffic` personalizam a rota de acordo com as necessidades e restrições específicas.
**Origem**
A posição inicial da rota em longitude e latitude.
**Destination** (Destino)
A posição final da rota.
**Pontos de referência**
Posições intermediárias a serem incluídas ao longo de uma rota entre as posições inicial e final.
**OptimizeRoutingFor**
Critérios de otimização de a rota, como a mais rápida ou a mais curta.
**LegGeometryFormat**
Formato da geometria retornada para cada trecho da rota.
**Evite**
Recursos a serem evitados durante o cálculo da rota, ignorados se nenhuma rota alternativa for encontrada.
**Tráfego**
Opções relacionadas ao tráfego que afetam o cálculo da rota.
**Pedágios**
Opções relacionadas ao pedágio que afetam os cálculos da rota e os custos de pedágio.
**LegAdditionalFeatures**
Recursos que podem ser ativados na resposta de cada trecho da viagem.
**SpanAdditionalFeatures**
Recursos de distância que podem ser ativados na resposta de cada trecho da viagem.
## Sobre a resposta
A resposta fornece detalhes da rota, como trechos da viagem, avisos sobre os cálculos da rota e informações resumidas, incluindo distância e duração.
**Rotas**
Conjunto de rotas que contêm trechos e propriedades associadas.
**Avisos**
Avisos ou mensagens informativas sobre a rota.
**LegGeometryFormat**
Especifica o formato da geometria da rota.
### Detalhes do trecho
Cada trecho de uma viagem pode ser do tipo balsa, pedestre ou veículo, dependendo do meio de transporte. Embora cada trecho contenha propriedades independentes do meio de transporte, propriedades específicas podem ser encontradas em:
**FerryLegDetails**
Propriedades específicas da balsa para o trecho.
**VehicleLegDetails**
Propriedades específicas do veículo para o trecho.
**PedestrianLegDetails**
Propriedades específicas dos pedestres para o trecho.
### Etapas
Cada trecho de uma viagem é dividido em etapas que descrevem as ações de partes da rota. Uma etapa pode ser Padrão, adequada para aplicativos básicos ou TurnByTurn adequada para turn-by-turn navegação. Cada etapa contém propriedades independentes do tipo de etapa, como duração e distância, e outras propriedades específicas, como ExitStepDetails, que se aplicam somente às etapas de saída.
**BeforeTravelSteps**
Etapas a serem realizadas antes de iniciar a viagem.
**TravelSteps**
Etapas a serem realizadas durante a viagem.
**AfterTravelSteps**
Etapas a serem realizadas após concluir a viagem.
### Segmentos
Cada trecho de uma viagem pode ser dividido em segmentos. Segmento é uma parte do trecho com os mesmos valores para o conjunto de `SpanAdditionalFeatures` solicitados. Os segmentos são divididos por propriedades da estrada, como `SpeedLimit`, nomes de estradas ou regiões. Os segmentos retornados podem ser usados para visualizar os atributos da estrada e as informações relacionadas ao acesso.
# Calcular o custo do pedágio
Este tópico é uma visão geral de campos e definições associados ao cálculo dos custos de pedágio. Usando esses campos, você pode especificar parâmetros como métodos de pagamento, moeda e características do veículo para personalizar os cálculos do custo do pedágio.
| Nome do campo | Rotas |
| --- | --- |
| Transponders | Sim, com opções |
| Vinhetas | Sim, com opções |
| Moeda | Sim, com opções |
| EmissionType | Sim, com opções |
| VehicleCategory | Sim, com opções |
## Definições
Esta seção define rapidamente cada campo usado no cálculo do custo do pedágio.
****Transponders****
Transponders são um método de pagamento de pedágios que podem resultar em um preço diferente em comparação com outros métodos de pagamento.
****Vinhetas****
Vinheta é uma forma de precificação rodoviária. Quando um usuário tem a vinheta exigida, nenhum pagamento adicional de pedágio é necessário.
****Moeda****
A moeda na qual os custos de pedágio são informados. Além da moeda local, uma moeda convertida é incluída, o que também afeta a moeda usada no resumo do pedágio na resposta.
****EmissionType****
O tipo de emissão do veículo, usado para calcular os custos de pedágio com base nas emissões do veículo.
****VehicleCategory****
A subcategoria do veículo usada para o cálculo do custo do pedágio.
# Sobre as etapas da rota
Esta seção define várias ações e etapas que precisam ser tomadas para concluir um trecho de uma jornada. As etapas da rota variam de acordo com o modo de viagem e fornecem orientação para aplicações de visão geral e navegação detalhada passo a passo.
## Visão geral das etapas da rota
Os seguintes tipos de etapas da rota definem as ações necessárias para concluir um trecho da rota, variando de acordo com o modo de viagem e o estágio da viagem.
| **Step type (Tipo de etapa** | **Descrição** |
| --- | --- |
| Default steps | Etapas básicas que fornecem instruções legíveis por humanos, geralmente usadas em aplicativos baseados na web para oferecer uma visão geral da rota. |
| Turn by turn steps | Etapas detalhadas para criar um aplicativo de navegação passo a passo, oferecendo direções mais granulares. |
| Before travel steps | Etapas que precisam ser concluídas antes de iniciar a seção de viagem, como embarcar em uma balsa. |
| After travel steps | Etapas a serem executadas após a conclusão da seção de viagem, como desembarcar de uma balsa. |
## Detalhamento de etapas por modo de viagem
| **Seção** | **N.º da etapa** | **Antes da viagem** | **Viajar** | **Depois da viagem** |
| --- | --- | --- | --- | --- |
| Veículo | Chegar | Não | Sim | Não |
| Veículo | Continuar | Não | Sim | Não |
| Veículo | ContinueHighway | Não | Sim | Não |
| Veículo | Partir | Não | Sim | Não |
| Veículo | Exit | Não | Sim | Não |
| Pedestre | Chegar | Não | Sim | Não |
| Pedestre | Cobrança | Não | Sim | Não |
| Balsa | Wait | Não | Não | Sim |
| Balsa | Embarcar | Sim | Não | Não |
| Balsa | Desembarcar | Não | Não | Sim |
# Calcular matriz de rotas
O serviço de Matriz de rotas calcula matrizes de rotas, fornecendo tempos de viagem ou distâncias entre várias origens e destinos. Esse serviço oferece opções flexíveis de personalização, permitindo que você especifique modos de viagem, condições de tráfego e outros parâmetros de rotas. Os cálculos da matriz podem ter tamanho e forma variados, para auxiliar no uso de matrizes quadradas e não quadradas e acomodar dados de tráfego dinâmicos ou de fluxo livre.
Para obter mais informações, consulte [CalculateRouteMatrix](https://docs.aws.amazon.com/location/latest/APIReference/API_CalculateRouteMatrix.html)a *Amazon Location Service API Reference*.
Por exemplo, solicitações, respostas, comandos cURL e CLI para essa API, consulte [Como usar o cálculo de matriz de rotas](https://docs.aws.amazon.com/location/latest/developerguide/calculate-route-matrix-how-to.html).
## Casos de uso
+ **Otimizar as rotas de entrega para logística e comércio eletrônico:** calcule com eficiência o tempo de viagem e a distância entre vários locais de coleta e entrega para otimizar as rotas. As empresas de logística podem usar esse atributo para minimizar os custos e o tempo de entrega, planejando caminhos eficientes entre as cidades. É ideal para definir janelas de entrega otimizadas para serviços no mesmo dia ou no dia seguinte, e planejar rotas de entrega com várias paradas.
+ **Vincular motoristas a passageiros em aplicações de compartilhamento de viagens:** use cálculos de rota para associar motoristas aos passageiros mais próximos, encontrando a rota mais rápida entre os locais. As aplicações de compartilhamento de viagens podem aprimorar a experiência do usuário ao informar estimativas de chegada do motorista em tempo real, garantindo coletas e entregas imediatas. Aceita vários meios de transporte, como carros, bicicletas e scooters.
+ **Planejar e otimizar rotas para gerenciamento de frotas:** gerencie grandes frotas otimizando rotas para reduzir o consumo de combustível e o tempo de viagem. Os gerentes de frota podem atribuir as rotas mais eficientes aos veículos em várias paradas, aumentando assim a eficiência operacional geral. Os casos de uso incluem frotas de serviços, transportadoras e concessionárias em que o planejamento ideal de rotas é essencial para visitas ao local.
## Sobre a solicitação
**nota**
Para clientes em `ap-southeast-1` e`ap-southeast-5`, os campos de solicitação e resposta compatíveis podem ser diferentes. Consulte a [Referência da CalculateRouteMatrix API](https://docs.aws.amazon.com/location/latest/APIReference/API_CalculateRouteMatrix.html) para obter detalhes.
A solicitação inclui **Origens** e **Destinos** para cálculos de rotas, com parâmetros opcionais para personalizar a matriz com base nas preferências e restrições. Para obter mais detalhes, consulte Referência de API para a API Calcular matriz de rotas.
+ `Origins`: lista de coordenadas de origem em longitude e latitude.
+ `Destinations`: lista de coordenadas de destino.
+ `OptimizeRoutingFor`: critérios de otimização, como rota “mais rápida” ou “mais curta”.
+ `RoutingBoundary`: define limites para cálculo, como “Ilimitado” ou restrito a uma geometria específica.
+ `Avoid`: atributos a serem evitados durante o cálculo da rota. Ignorado se nenhuma rota viável for encontrada.
+ `Traffic`: opções relacionadas ao tráfego que afetam os cálculos de rotas.
## Sobre a resposta
A resposta inclui uma matriz de rotas calculadas entre origens e destinos, com detalhes como distância e duração. Erros e limites para as rotas também são informados, se aplicável. Consulte a Referência de API para obter detalhes adicionais sobre a API Calcular matriz de rotas.
+ `RouteMatrix`: Matriz contendo distâncias de viagem (em metros) e durações (em segundos) entre origens e destinos.
+ `ErrorCount`: número de erros encontrados durante os cálculos da rota.
+ `RoutingBoundary`: limite dentro do qual a matriz é calculada.
# Calcular isolinhas
A API Calcular isolinhas permite determinar áreas acessíveis dentro de limites de tempo ou distância especificados. Ao considerar fatores como restrições de estradas, condições de tráfego e modo de viagem, ela gera linhas isoladas que descrevem áreas acessíveis, que ajudam nas aplicações de planejamento urbano, logística e acessibilidade de serviços. Essa API pode ser usada para planejamento urbano, análise imobiliária e estudos de acessibilidade, por meio da visualização do alcance do serviço, das opções de transporte ou dos recursos dentro de um prazo ou limite de distância definido. Ao exibir essas isolinhas em um mapa, os usuários podem avaliar o alcance da viagem dentro de restrições específicas, aprimorando a tomada de decisões para seleção de locais, cobertura de serviços e alocação de recursos.
Para obter mais informações, consulte [CalculateIsolines](https://docs.aws.amazon.com/location/latest/APIReference/API_CalculateIsolines.html) na Amazon *Referência de API do Amazon Location Service*.
Por exemplo, solicitações, respostas, comandos cURL e CLI para essa API, consulte [Como usar o cálculo de isolinhas](https://docs.aws.amazon.com/location/latest/developerguide/calculate-isolines-how-to.html).
## Casos de uso
+ **Avaliar a acessibilidade à assistência médica por meio de isolinhas de tempo de viagem:** gere isolinhas para avaliar o acesso às instalações de saúde de vários bairros com base nos tempos de viagem. As organizações de saúde podem usar esse atributo para identificar áreas carentes e tomar decisões informadas sobre a localização das clínicas ou serviços móveis de saúde, melhorando assim o acesso à saúde comunitária.
+ **Analisar o alcance do mercado para a expansão do varejo usando isolinhas de tempo de viagem:** crie isolinhas para representar o acesso do cliente aos locais de varejo com base nos tempos de viagem. As empresas de varejo podem avaliar novas localizações de lojas e entender os dados demográficos dos clientes, usando essas visualizações para expandir e otimizar estrategicamente o potencial de vendas.
+ **Otimizar a logística e as zonas de entrega com isolinhas:** gere isolinhas para definir zonas de entrega com base em requisitos logísticos urgentes. As empresas de logística podem visualizar áreas acessíveis dentro de prazos específicos a partir dos centros de distribuição, melhorando o planejamento de rotas, a eficiência operacional e as entregas pontuais.
+ **Planejar o acesso turístico e recreativo com isolinhas:** visualize os tempos de viagem das atrações turísticas às acomodações próximas. Os órgãos de turismo podem ajudar os viajantes a encontrar opções convenientes de hospedagem, promovendo negócios locais e aprimorando a experiência de viagem exibindo essas isolinhas em um mapa.
+ **Melhorar o planejamento de resposta a emergências por meio de isolinhas:** gere isolinhas para avaliar os tempos de resposta de locais de serviço de emergência a várias áreas de uma comunidade. As equipes de gerenciamento de emergências podem identificar regiões com tempos de resposta críticos, otimizando a alocação de recursos para melhorar a resposta durante incidentes.
+ **Analisar os padrões de deslocamento para o planejamento da força de trabalho com isolinhas: gere isolinhas** para visualizar os tempos de deslocamento e identificar áreas com altos tempos de viagem. As empresas podem usar esses insights para políticas de trabalho remoto ou realocações de escritórios, aumentando a satisfação e a produtividade dos funcionários.
## Sobre a solicitação
A solicitação aceita parâmetros como `Origin`, `Destination` e `Thresholds` para definir isolinhas. Parâmetros opcionais, como`Allow`, `Avoid` e `TravelModeOptions`, permitem a personalização das restrições de isolinha. Para obter mais informações, consulte o .
**Origem**
O ponto de partida para o cálculo da isolinha em longitude e latitude.
**Limites**
Limites de tempo ou distância usados para definir o limite da isolinha.
**TravelMode**
O meio de transporte, como carro, pedestre ou caminhão.
**OptimizeIsolineFor**
Critérios de otimização, como cálculo Preciso, Balanceado ou Rápido.
**DepartureTime**
Hora de partida, se especificada, para calcular isolinhas dependentes do tempo.
**ArrivalTime**
Hora de chegada, se especificada, para calcular isolinhas dependentes do tempo.
**IsolineGranularity**
O número máximo de pontos e a resolução do limite da isolinha.
## Sobre a resposta
A resposta inclui isolinhas com propriedades como `IsolineGeometryFormat`, que descrevem a área acessível com base nos parâmetros da solicitação.
**Isolinhas**
Isolinhas calculadas com propriedades associadas, incluindo geometrias e conexões.
**Geometrias**
Lista de geometrias que descrevem os limites calculados das isolinhas.
**Conexões**
Conexões entre geometrias de isolinhas, incluindo a geometria de cada conexão.
# Otimizar pontos de referência
A API Optimize Waypoints calcula a sequência mais eficiente para visitar vários pontos de referência ao longo de uma rota. Com o uso de algoritmos avançados, essa API minimiza o tempo e a distância da viagem, considerando fatores como condições de tráfego, evasões e especificações do veículo. A integração da API Optimize Waypoints ajuda as empresas a otimizar as operações, reduzir o consumo de combustível, melhorar a eficiência da entrega e aumentar a satisfação do cliente. A API fornece rotas otimizadas, melhorando a tomada de decisões e a alocação de recursos em cenários de viagem com várias paradas.
Para obter mais informações, consulte [OptimizeWaypoints](https://docs.aws.amazon.com/location/latest/APIReference/API_OptimizeWaypoints.html) na *referência da API do Amazon Location Service*.
Por exemplo, solicitações, respostas, comandos cURL e CLI para essa API, consulte [Como usar a otimização de pontos de referência](https://docs.aws.amazon.com/location/latest/developerguide/optimize-waypoints-how-to.html).
## Casos de uso
+ **Melhorar a eficiência da entrega em várias paradas:** otimize com eficiência a sequência de várias paradas de entrega para reduzir o tempo e os custos de viagem. Os serviços de entrega podem agilizar as operações calculando a rota mais eficiente para os motoristas, minimizando as despesas com combustível e garantindo entregas pontuais. Isso melhora a satisfação do cliente e a eficiência operacional.
+ **Simplificar as operações de serviço de campo:** otimize a sequência de visitas a vários locais de trabalho em um único dia, reduzindo o tempo de viagem dos técnicos de serviço de campo. Isso permite que as empresas concluam mais trabalhos diariamente, aumentando a produtividade e a prestação de serviços.
+ **Planejar rotas turísticas eficientes para agências de viagens:** otimize itinerários que incluam várias atrações para maximizar o turismo e minimizar o tempo de viagem. As agências de viagens podem usar esse atributo para criar planos ideais para visitas guiadas, aprimorando a experiência geral do turista ao fazer melhor uso do tempo disponível.
+ **Melhorar a eficiência do motorista que compartilha viagens:** otimize as sequências de embarque e desembarque de vários passageiros, reduzindo os tempos de espera e aprimorando a experiência do passageiro. Os serviços de compartilhamento de viagens podem maximizar os ganhos do motorista e garantir um atendimento oportuno aos passageiros, otimizando os pontos de referência.
+ **Otimizar rotas para serviços de coleta de lixo:** planeje rotas de coleta de resíduos para minimizar a distância e o tempo de viagem, o que ajuda as empresas de gerenciamento de resíduos a otimizar as operações e garantir a coleta oportuna, obtendo economia de custos e reduzindo o impacto ambiental.
+ **Coordenar a logística para eventos e conferências:** gerencie a logística de transporte para entregar equipamentos e suprimentos em vários locais, otimizando as rotas de carga e descarga. Isso permite que os planejadores de eventos simplifiquem o transporte, reduzam os atrasos e garantam a chegada oportuna dos materiais para os eventos.
+ **Melhorar as rotas de resposta a emergências:** planeje as rotas mais rápidas para várias emergências, otimizando os tempos de resposta em situações críticas. Os serviços de emergência podem melhorar a eficiência da resposta, possivelmente salvando vidas usando pontos de referência otimizados.
+ **Facilitar o planejamento de rotas de vendas para representantes de campo:** otimize as rotas para os representantes de vendas que visitam vários clientes em um dia, minimizando o tempo de viagem e maximizando as visitas. Isso ajuda as empresas a aumentar a produtividade e aproveitar mais oportunidades de vendas.
## Sobre a solicitação
A solicitação requer parâmetros como `Origin` e `Waypoints` para calcular uma sequência otimizada. Parâmetros opcionais, como `Avoid`, `Traffic`, e `Driver`, permitem personalização adicional.
**Pontos de referência**
Uma lista de pontos de referência a serem otimizados em sequência.
**Origem**
A posição inicial da rota para otimização.
**Destino**
Uma posição final opcional da rota para otimização.
**OptimizeSequencingFor**
Critérios para otimização de sequenciamento, como rota mais rápida ou mais curta.
**Tráfego**
Opções relacionadas ao tráfego que afetam o cálculo da rota.
**Driver**
Ciclos de trabalho e descanso do motorista para garantir a conformidade com os regulamentos regionais de direção.
**Agrupamento em clusters**
Com o Clustering, você especifica como os pontos de referência próximos podem ser agrupados para melhorar a sequência otimizada.
Cada ponto de referência também pode especificar restrições que devem ser atendidas, como, `AppointmentTime`, `AccessHours` e restrições de ordenação, como `Before` de outro ponto de referência.
## Sobre a resposta
A resposta contém detalhes da sequência otimizada de pontos de referência, incluindo `OptimizedWaypoints`, com `Distance` e `Duration` gerais da viagem.
**OptimizedWaypoints**
Uma lista de pontos de referência em sua ordem otimizada.
**ImpedingWaypoints**
Pontos de referência que evitam uma sequência otimizada, incluindo restrições com falha que não foram atendidas.
**Conexões**
Detalhes sobre viagens entre pontos de referência, incluindo distância e duração.
**TimeBreakdown**
Detalhamento do total de durações de `Travel`, `Rest`, `Service` e `Wait` da rota.
**ClusterIndex**
Índice do cluster ao qual o ponto de referência está associado. O índice será incluído na resposta somente se o agrupamento em clusters tiver sido executado durante o processamento da solicitação.
# Ajustar às estradas
A API Ajustar às estradas aprimora a precisão do posicionamento geográfico quando alinha as coordenadas de GPS aos segmentos de estrada mais próximos em um mapa digital. Essa API pega dados brutos de longitude e latitude, geralmente coletados de dispositivos móveis ou veículos, e “ajusta” esses pontos à rede rodoviária correspondente, corrigindo imprecisões causadas pela perda de sinal ou pelo desvio do GPS. Quando integra a API Ajustar às estradas, você pode garantir que seus aplicativos forneçam dados confiáveis e precisos, apoiando uma melhor tomada de decisão e eficiência operacional em vários cenários.
Para obter mais informações, consulte [SnapToRoads](https://docs.aws.amazon.com/location/latest/APIReference/API_SnapToRoads.html) na *Referência de API do Amazon Location Service*.
Por exemplo, solicitações, respostas, comandos cURL e CLI para essa API, consulte [Como usar Ajustar às estradas](https://docs.aws.amazon.com/location/latest/developerguide/snap-to-roads-how-to.html).
## Casos de uso
+ **Melhorar a precisão da navegação conectando-se à rede rodoviária:** alinhe eficientemente as coordenadas de GPS aos segmentos de estrada mais próximos para melhorar a precisão da navegação. Esse atributo é valioso para serviços de mapeamento e navegação, fornecendo aos usuários direções precisas e atualizações de localização em tempo real, aprimorando assim a experiência de navegação.
+ **Melhorar a precisão dos dados para aplicativos de gerenciamento de frotas:** corrija as posições relatadas dos veículos ajustando suas coordenadas GPS às estradas mais próximas. Nos sistemas de gerenciamento de frotas, esse atributo garante o rastreamento preciso dos veículos, permitindo uma logística otimizada e uma melhor eficiência operacional.
## Sobre a solicitação
A solicitação precisa que `TracePoints` corresponda às estradas, com parâmetros opcionais como `SnappedGeometryFormat` e `SnapRadius` para controlar o formato da geometria e o raio de ajuste.
**TracePoints**
Uma lista de coordenadas a serem inseridas na rede rodoviária.
**SnappedGeometryFormat**
O formato da geometria retornada, como “FlexiblePolyline” ou “Simple”.
**SnapRadius**
O raio em torno dos pontos de rastreamento dentro dos quais o ajuste da estrada é considerado.
## Sobre a resposta
A resposta contém geometria corrigida e pontos de rastreamento ajustados, com propriedades como `SnappedGeometry` e `SnappedTracePoints` para indicar precisão e confiança no ajuste.
**SnappedGeometry**
A geometria corrigida da rota ajustada.
**SnappedTracePoints**
As coordenadas ajustadas dos pontos de rastreamento foram ajustadas às estradas.
**Avisos**
Avisos ou mensagens informativas sobre o processo de ajuste.
# Instruções de uso
Esta seção fornece guias para aproveitar as rotas APIs para resolver os desafios de roteamento e navegação. Esses tutoriais abordam as tarefas essenciais para integrar a funcionalidade de rotas em suas aplicações. Cada tópico se concentra em um caso de uso específico, permitindo que você implemente com eficiência recursos avançados de rota adaptados às suas necessidades comerciais.
**Topics**
+ [Saiba como usar CalculateRoutes](calculate-routes-how-to.md)
+ [Saiba como usar o CalculateIsolines](calculate-isolines-how-to.md)
+ [Saiba como usar o CalculateRouteMatrix](calculate-route-matrix-how-to.md)
+ [Saiba como usar OptimizeWaypoints](optimize-waypoints-how-to.md)
+ [Saber como usar a SnapToRoads](snap-to-roads-how-to.md)
# Saiba como usar CalculateRoutes
Esta seção contém instruções passo a passo para usar `CalculateRoutes`. Este tópico detalha orientações sobre como encontrar rotas com configurações específicas, como incorporar navegação passo a passo, definir modos de viagem e adicionar pontos de referência.
**Topics**
+ [Como encontrar uma rota para uma origem e um destino](calculate-routes-origin-destination-waypoints.md)
+ [Como encontrar rotas com direções passo a passo](how-to-find-turn-by-turn-route.md)
+ [Como encontrar um limite de velocidade para um trecho de estrada](calculate-routes-speed-limit-road.md)
+ [Como encontrar rotas alternativas](calculate-routes-alternate.md)
+ [Como calcular os pedágios de uma rota](calculate-routes-tolls.md)
+ [Como criar rotas com evasão personalizada](calculate-routes-custom-avoidance-poly.md)
+ [Como criar rotas personalizando como evitar vários itens possíveis](calculate-routes-custom-avoidance-multiple.md)
+ [Como encontrar a rota mais rápida](calculate-routes-custom-avoidance-fast.md)
+ [Como encontrar as rotas mais curtas](calculate-routes-custom-avoidance-shortest.md)
# Como encontrar uma rota para uma origem e um destino
A API CalculateRoutes ajuda você a encontrar as melhores rotas entre a origem e o destino, além das melhores oportunidades para o motorista descansar. Ela aceita modos de viagem como caminhão, pedestre, carro e scooter. Ela também permite usar até 25 pontos de referência (paradas), incluindo a origem e o destino, com apenas algumas restrições.
## Casos de uso possíveis
+ **Encontrar rotas ponto a ponto:** determine a melhor rota entre dois locais com base em vários modos de viagem e opções adicionais.
## Exemplos
### Calcular rotas da origem ao destino usando o TravelMode Carro
------
#### [ Sample request ]
```
{
"Origin": [
-123.118105,
49.282423
],
"Destination": [
-123.020098,
49.232872
]
}
```
------
#### [ Sample response ]
```
{
"LegGeometryFormat": "FlexiblePolyline",
"Notices": [],
"Routes": [
{
"Legs": [
{
"Geometry": {
"Polyline": "Redacted"
},
"TravelMode": "Car",
"Type": "Vehicle",
"VehicleLegDetails": {
"AfterTravelSteps": [],
"Arrival": {
"Place": {
"ChargingStation": false,
"OriginalPosition": [
-123.020098,
49.232872
],
"Position": [
-123.0203051,
49.2328499
]
}
},
"Departure": {
"Place": {
"ChargingStation": false,
"OriginalPosition": [
-123.1181051,
49.282423
],
"Position": [
-123.1180883,
49.2824349
]
}
},
"TravelSteps": [
{
"Distance": 1288,
"Duration": 102,
"Type": "Depart"
},
{
"Distance": 262,
"Duration": 24,
"Type": "Ramp"
},
{
"Distance": 1356,
"Duration": 134,
"Type": "Turn"
},
{
"Distance": 7092,
"Duration": 568,
"Type": "Keep"
},
{
"Distance": 65,
"Duration": 26,
"Type": "Turn"
},
{
"Distance": 50,
"Duration": 18,
"Type": "Turn"
},
{
"Distance": 0,
"Duration": 0,
"Type": "Arrive"
}
]
}
}
]
}
]
}
```
------
#### [ cURL ]
```
curl --request POST \
--url 'https://routes.geo.eu-central-1.amazonaws.com/v2/routes?key=Your_key' \
--header 'Content-Type: application/json' \
--data '{
"Origin": [
-123.118105,
49.282423
],
"Destination": [
-123.020098,
49.232872
]
}'
```
------
#### [ AWS CLI ]
```
aws geo-routes calculate-routes --key ${YourKey} \
--origin -123.118105 49.282423 \
--destination -123.020098 49.232872
```
------
# Como encontrar rotas com direções passo a passo
A API CalculateRoutes ajuda você a encontrar as melhores rotas entre a origem e o destino, além das melhores oportunidades para o motorista descansar. Ela aceita modos de viagem como carro, caminhão, pedestre e moto. Ela também permite usar até 25 pontos de referência (paradas), incluindo a origem e o destino, com apenas algumas restrições.
## Casos de uso possíveis
+ **Criar um aplicativo móvel de navegação:** use a API para obter instruções de navegação passo a passo.
+ **Exibir instruções em uma plataforma da web:** mostre orientações detalhadas de rotas para aplicações web para auxiliar na navegação.
## Exemplos
### Calcular rotas usando TravelMode Carro
------
#### [ Sample request ]
```
{
"Origin": [
-123.118105,
49.282423
],
"Destination": [
-123.020098,
49.232872
],
"TravelStepType": "TurnByTurn",
"TravelMode": "Car"
}
```
------
#### [ Sample response ]
```
{
"LegGeometryFormat": "FlexiblePolyline",
"Notices": [],
"Routes": [
{
"Legs": [
{
"Geometry": {
"Polyline": "Redacted"
},
"TravelMode": "Car",
"Type": "Vehicle",
"VehicleLegDetails": {
"Arrival": {
"Place": {
"Position": [-123.0203051, 49.2328499]
}
},
"Departure": {
"Place": {
"Position": [-123.1180883, 49.2824349]
}
},
"TravelSteps": [
{
"Distance": 1288,
"Duration": 102,
"Type": "Depart",
"NextRoad": {
"RoadName": "W Georgia St",
"RouteNumber": "HWY-1A"
}
},
{
"Distance": 262,
"Duration": 24,
"Type": "Keep",
"NextRoad": {
"RoadName": "Main St",
"RouteNumber": "HWY-1A"
}
},
{
"Distance": 1356,
"Duration": 134,
"Type": "Turn",
"NextRoad": {
"RoadName": "Main St",
"RouteNumber": "HWY-1A"
}
},
{
"Distance": 7092,
"Duration": 568,
"Type": "Keep",
"NextRoad": {
"RoadName": "Kingsway",
"RouteNumber": "HWY-1A"
}
},
{
"Distance": 65,
"Duration": 26,
"Type": "Turn"
},
{
"Distance": 0,
"Duration": 0,
"Type": "Arrive"
}
]
}
}
]
}
]
}
```
------
#### [ cURL ]
```
curl --request POST \
--url 'https://routes.geo.eu-central-1.amazonaws.com/v2/routes?key=Your_key' \
--header 'Content-Type: application/json' \
--data '{
"Origin": [
-123.118105,
49.282423
],
"Destination": [
-123.020098,
49.232872
],
"TravelStepType": "TurnByTurn",
"TravelMode": "Car"
}'
```
------
#### [ AWS CLI ]
```
aws geo-routes calculate-routes --key ${YourKey} \
--origin -123.118105 49.282423 \
--destination -123.020098 49.232872 \
--travel-step-type "TurnByTurn" \
--travel-mode "Car"
```
------
# Como encontrar um limite de velocidade para um trecho de estrada
A API CalculateRoutes ajuda você a encontrar as melhores rotas entre a origem e o destino, além das melhores oportunidades para o motorista descansar. Ela aceita modos de viagem como carro, caminhão, pedestre e moto. Ela também permite usar até 25 pontos de referência (paradas), incluindo a origem e o destino, com apenas algumas restrições.
## Casos de uso possíveis
+ **Auditar a conformidade com os limites de velocidade:** atenta-se aos limites de velocidade e à conformidade com eles.
+ **Informar o motorista sobre o limite de velocidade:** notifica o motorista sobre o limite de velocidade quando não há outra informação.
## Exemplos
### Encontrar limites de velocidade em TravelMode Carro
------
#### [ Sample request ]
```
{
"Origin": [
13.055211,
52.704802
],
"Destination": [
13.551910,
52.282705
],
"TravelMode": "Car",
"SpanAdditionalFeatures": ["SpeedLimit"]
}
```
------
#### [ Sample response ]
```
{
"LegGeometryFormat": "FlexiblePolyline",
"Notices": [],
"Routes": [
{
"Legs": [
{
"Geometry": {
"Polyline": "Redacted"
},
"TravelMode": "Car",
"Type": "Vehicle",
"VehicleLegDetails": {
"AfterTravelSteps": [],
"Arrival": {
"Place": {
"ChargingStation": false,
"OriginalPosition": [
13.55191,
52.282705
],
"Position": [
13.5507836,
52.2859121
]
}
},
"Departure": {
"Place": {
"ChargingStation": false,
"OriginalPosition": [
13.055211,
52.704802
],
"Position": [
13.0555036,
52.7056073
]
}
},
"Incidents": [],
"Notices": [],
"PassThroughWaypoints": [],
"Spans": [
{
"GeometryOffset": 0,
"SpeedLimit": {
"Unlimited": true
}
},
{
"GeometryOffset": 151,
"SpeedLimit": {
"MaxSpeed": 120.00000762939453
}
},
{
"GeometryOffset": 167,
"SpeedLimit": {
"MaxSpeed": 80
}
},
{
"GeometryOffset": 195,
"SpeedLimit": {
"MaxSpeed": 120.00000762939453
}
},
{
"GeometryOffset": 220,
"SpeedLimit": {
"Unlimited": true
}
},
{
"GeometryOffset": 356,
"SpeedLimit": {
"MaxSpeed": 120.00000762939453
}
},
{
"GeometryOffset": 358,
"SpeedLimit": {
"MaxSpeed": 100
}
},
{
"GeometryOffset": 368,
"SpeedLimit": {
"MaxSpeed": 80
}
},
{
"GeometryOffset": 384,
"SpeedLimit": {
"MaxSpeed": 60.000003814697266
}
},
{
"GeometryOffset": 639,
"SpeedLimit": {
"MaxSpeed": 80
}
},
{
"GeometryOffset": 701,
"SpeedLimit": {
"MaxSpeed": 60.000003814697266
}
},
{
"GeometryOffset": 726,
"SpeedLimit": {
"MaxSpeed": 80
}
},
{
"GeometryOffset": 805,
"SpeedLimit": {
"MaxSpeed": 60.000003814697266
}
},
{
"GeometryOffset": 839,
"SpeedLimit": {
"MaxSpeed": 80
}
},
{
"GeometryOffset": 1384,
"SpeedLimit": {
"MaxSpeed": 60.000003814697266
}
},
{
"GeometryOffset": 1393,
"SpeedLimit": {
"MaxSpeed": 50
}
},
{
"GeometryOffset": 1443,
"SpeedLimit": {
"MaxSpeed": 30.000001907348633
}
},
{
"GeometryOffset": 1454,
"SpeedLimit": {
"MaxSpeed": 50
}
},
{
"GeometryOffset": 1504,
"SpeedLimit": {
"MaxSpeed": 60.000003814697266
}
},
{
"GeometryOffset": 1513,
"SpeedLimit": {
"MaxSpeed": 80
}
},
{
"GeometryOffset": 1516,
"SpeedLimit": {
"MaxSpeed": 60.000003814697266
}
},
{
"GeometryOffset": 1555,
"SpeedLimit": {
"MaxSpeed": 80
}
},
{
"GeometryOffset": 1748,
"SpeedLimit": {
"MaxSpeed": 120.00000762939453
}
},
{
"GeometryOffset": 1904,
"SpeedLimit": {
"MaxSpeed": 100
}
},
{
"GeometryOffset": 1945,
"SpeedLimit": {
"Unlimited": true
}
},
{
"GeometryOffset": 2006,
"SpeedLimit": {
"MaxSpeed": 70
}
},
{
"GeometryOffset": 2017,
"SpeedLimit": {
"MaxSpeed": 50
}
},
{
"GeometryOffset": 2033,
"SpeedLimit": {
"MaxSpeed": 30.000001907348633
}
}
],
"Tolls": [],
"TollSystems": [],
"TravelSteps": [
{
"Distance": 9099,
"Duration": 262,
"ExitNumber": [],
"GeometryOffset": 0,
"Type": "Depart"
},
{
"Distance": 18849,
"Duration": 800,
"ExitNumber": [],
"GeometryOffset": 162,
"KeepStepDetails": {
"Intersection": [],
"SteeringDirection": "Right"
},
"Type": "Keep"
},
{
"Distance": 4290,
"Duration": 212,
"ExitNumber": [],
"ExitStepDetails": {
"Intersection": [],
"SteeringDirection": "Right"
},
"GeometryOffset": 701,
"Type": "Exit"
},
{
"Distance": 14418,
"Duration": 651,
"ExitNumber": [],
"GeometryOffset": 828,
"Type": "Continue"
},
{
"Distance": 1255,
"Duration": 62,
"ExitNumber": [],
"ExitStepDetails": {
"Intersection": [],
"SteeringDirection": "Right"
},
"GeometryOffset": 1359,
"Type": "Exit"
},
{
"Distance": 1607,
"Duration": 139,
"ExitNumber": [],
"GeometryOffset": 1393,
"TurnStepDetails": {
"Intersection": [],
"SteeringDirection": "Left",
"TurnIntensity": "Typical"
},
"Type": "Turn"
},
{
"Distance": 934,
"Duration": 92,
"ExitNumber": [],
"GeometryOffset": 1442,
"Type": "Continue"
},
{
"Distance": 320,
"Duration": 27,
"ExitNumber": [],
"GeometryOffset": 1473,
"Type": "Continue"
},
{
"Distance": 320,
"Duration": 33,
"ExitNumber": [],
"GeometryOffset": 1491,
"Type": "Continue"
},
{
"Distance": 17863,
"Duration": 680,
"ExitNumber": [],
"GeometryOffset": 1504,
"RampStepDetails": {
"Intersection": [],
"SteeringDirection": "Right"
},
"Type": "Ramp"
},
{
"Distance": 2888,
"Duration": 95,
"ExitNumber": [],
"GeometryOffset": 1917,
"Type": "Continue"
},
{
"Distance": 321,
"Duration": 28,
"ExitNumber": [],
"ExitStepDetails": {
"Intersection": [],
"SteeringDirection": "Right"
},
"GeometryOffset": 1977,
"Type": "Exit"
},
{
"Distance": 549,
"Duration": 41,
"ExitNumber": [],
"GeometryOffset": 2006,
"TurnStepDetails": {
"Intersection": [],
"SteeringDirection": "Right",
"TurnIntensity": "Typical"
},
"Type": "Turn"
},
{
"Distance": 386,
"Duration": 51,
"ExitNumber": [],
"GeometryOffset": 2023,
"TurnStepDetails": {
"Intersection": [],
"SteeringDirection": "Left",
"TurnIntensity": "Typical"
},
"Type": "Turn"
},
{
"Distance": 98,
"Duration": 15,
"ExitNumber": [],
"GeometryOffset": 2033,
"TurnStepDetails": {
"Intersection": [],
"SteeringDirection": "Right",
"TurnIntensity": "Typical"
},
"Type": "Turn"
},
{
"Distance": 0,
"Duration": 0,
"ExitNumber": [],
"GeometryOffset": 2036,
"Type": "Arrive"
}
],
"TruckRoadTypes": [],
"Zones": []
}
}
],
"MajorRoadLabels": [
{
"RouteNumber": {
"Language": "de",
"Value": "A111"
}
},
{
"RouteNumber": {
"Language": "de",
"Value": "A113"
}
}
]
}
]
}
```
------
#### [ cURL ]
```
curl --request POST \
--url 'https://routes.geo.eu-central-1.amazonaws.com/v2/routes?key=Your_key' \
--header 'Content-Type: application/json' \
--data '{
"Origin": [
13.055211,
52.704802
],
"Destination": [
13.551910,
52.282705
],
"TravelMode": "Car",
"SpanAdditionalFeatures": ["SpeedLimit"]
}'
```
------
#### [ AWS CLI ]
```
aws geo-routes calculate-routes --key ${YourKey} \
--origin 13.055211 52.704802 \
--destination 13.551910 52.282705 \
--travel-mode "Car" \
--span-additional-features "SpeedLimit"
```
------
# Como encontrar rotas alternativas
A API CalculateRoutes ajuda você a encontrar as melhores rotas entre a origem e o destino, além das melhores oportunidades para o motorista descansar. Ela aceita modos de viagem como carro, caminhão, pedestre e moto. Ela também permite usar até 25 pontos de referência (paradas), incluindo a origem e o destino, com apenas algumas restrições.
## Casos de uso possíveis
+ **Identificar rotas alternativas:** escolha a melhor rota de acordo com o que você precisa.
## Exemplos
### Encontrar rotas alternativas em TravelMode Carro
------
#### [ Sample request ]
```
{
"Origin": [
13.055211,
52.704802
],
"Destination": [
13.551910,
52.282705
],
"TravelMode": "Car",
"MaxAlternatives": 2
}
```
------
#### [ Sample response ]
```
{
"LegGeometryFormat": "FlexiblePolyline",
"Notices": [],
"Routes": [
{
"Legs": [
{
"Geometry": {
"Polyline": "Redacted"
},
"TravelMode": "Car",
"Type": "Vehicle",
"VehicleLegDetails": {
"AfterTravelSteps": [],
"Arrival": {
"Place": {
"ChargingStation": false,
"OriginalPosition": [
13.55191,
52.282705
],
"Position": [
13.5507836,
52.2859121
]
}
},
"Departure": {
"Place": {
"ChargingStation": false,
"OriginalPosition": [
13.055211,
52.704802
],
"Position": [
13.0555036,
52.7056073
]
}
},
"Incidents": [],
"Notices": [],
"PassThroughWaypoints": [],
"Spans": [],
"Tolls": [],
"TollSystems": [],
"TravelSteps": [
{
"Distance": 9099,
"Duration": 262,
"ExitNumber": [],
"GeometryOffset": 0,
"Type": "Depart"
},
{
"Distance": 18849,
"Duration": 800,
"ExitNumber": [],
"GeometryOffset": 162,
"KeepStepDetails": {
"Intersection": [],
"SteeringDirection": "Right"
},
"Type": "Keep"
},
{
"Distance": 4290,
"Duration": 212,
"ExitNumber": [],
"ExitStepDetails": {
"Intersection": [],
"SteeringDirection": "Right"
},
"GeometryOffset": 701,
"Type": "Exit"
},
{
"Distance": 14418,
"Duration": 651,
"ExitNumber": [],
"GeometryOffset": 828,
"Type": "Continue"
},
{
"Distance": 1255,
"Duration": 62,
"ExitNumber": [],
"ExitStepDetails": {
"Intersection": [],
"SteeringDirection": "Right"
},
"GeometryOffset": 1359,
"Type": "Exit"
},
{
"Distance": 1607,
"Duration": 139,
"ExitNumber": [],
"GeometryOffset": 1393,
"TurnStepDetails": {
"Intersection": [],
"SteeringDirection": "Left",
"TurnIntensity": "Typical"
},
"Type": "Turn"
},
{
"Distance": 934,
"Duration": 92,
"ExitNumber": [],
"GeometryOffset": 1442,
"Type": "Continue"
},
{
"Distance": 320,
"Duration": 27,
"ExitNumber": [],
"GeometryOffset": 1473,
"Type": "Continue"
},
{
"Distance": 320,
"Duration": 33,
"ExitNumber": [],
"GeometryOffset": 1491,
"Type": "Continue"
},
{
"Distance": 17863,
"Duration": 680,
"ExitNumber": [],
"GeometryOffset": 1504,
"RampStepDetails": {
"Intersection": [],
"SteeringDirection": "Right"
},
"Type": "Ramp"
},
{
"Distance": 2888,
"Duration": 95,
"ExitNumber": [],
"GeometryOffset": 1917,
"Type": "Continue"
},
{
"Distance": 321,
"Duration": 28,
"ExitNumber": [],
"ExitStepDetails": {
"Intersection": [],
"SteeringDirection": "Right"
},
"GeometryOffset": 1977,
"Type": "Exit"
},
{
"Distance": 549,
"Duration": 41,
"ExitNumber": [],
"GeometryOffset": 2006,
"TurnStepDetails": {
"Intersection": [],
"SteeringDirection": "Right",
"TurnIntensity": "Typical"
},
"Type": "Turn"
},
{
"Distance": 386,
"Duration": 51,
"ExitNumber": [],
"GeometryOffset": 2023,
"TurnStepDetails": {
"Intersection": [],
"SteeringDirection": "Left",
"TurnIntensity": "Typical"
},
"Type": "Turn"
},
{
"Distance": 98,
"Duration": 15,
"ExitNumber": [],
"GeometryOffset": 2033,
"TurnStepDetails": {
"Intersection": [],
"SteeringDirection": "Right",
"TurnIntensity": "Typical"
},
"Type": "Turn"
},
{
"Distance": 0,
"Duration": 0,
"ExitNumber": [],
"GeometryOffset": 2036,
"Type": "Arrive"
}
],
"TruckRoadTypes": [],
"Zones": []
}
}
],
"MajorRoadLabels": [
{
"RouteNumber": {
"Language": "de",
"Value": "A111"
}
},
{
"RouteNumber": {
"Language": "de",
"Value": "A113"
}
}
]
},
{
"Legs": [
{
"Geometry": {
"Polyline": "Redacted"
},
"TravelMode": "Car",
"Type": "Vehicle",
"VehicleLegDetails": {
"AfterTravelSteps": [],
"Arrival": {
"Place": {
"ChargingStation": false,
"OriginalPosition": [
13.55191,
52.282705
],
"Position": [
13.5507836,
52.2859121
]
}
},
"Departure": {
"Place": {
"ChargingStation": false,
"OriginalPosition": [
13.055211,
52.704802
],
"Position": [
13.0555036,
52.7056073
]
}
},
"Incidents": [],
"Notices": [],
"PassThroughWaypoints": [],
"Spans": [],
"Tolls": [],
"TollSystems": [],
"TravelSteps": [
{
"Distance": 91047,
"Duration": 2880,
"ExitNumber": [],
"GeometryOffset": 0,
"Type": "Depart"
},
{
"Distance": 3496,
"Duration": 119,
"ExitNumber": [],
"ExitStepDetails": {
"Intersection": [],
"SteeringDirection": "Right"
},
"GeometryOffset": 1473,
"Type": "Exit"
},
{
"Distance": 321,
"Duration": 28,
"ExitNumber": [],
"ExitStepDetails": {
"Intersection": [],
"SteeringDirection": "Right"
},
"GeometryOffset": 1565,
"Type": "Exit"
},
{
"Distance": 549,
"Duration": 41,
"ExitNumber": [],
"GeometryOffset": 1594,
"TurnStepDetails": {
"Intersection": [],
"SteeringDirection": "Right",
"TurnIntensity": "Typical"
},
"Type": "Turn"
},
{
"Distance": 386,
"Duration": 51,
"ExitNumber": [],
"GeometryOffset": 1611,
"TurnStepDetails": {
"Intersection": [],
"SteeringDirection": "Left",
"TurnIntensity": "Typical"
},
"Type": "Turn"
},
{
"Distance": 98,
"Duration": 15,
"ExitNumber": [],
"GeometryOffset": 1621,
"TurnStepDetails": {
"Intersection": [],
"SteeringDirection": "Right",
"TurnIntensity": "Typical"
},
"Type": "Turn"
},
{
"Distance": 0,
"Duration": 0,
"ExitNumber": [],
"GeometryOffset": 1624,
"Type": "Arrive"
}
],
"TruckRoadTypes": [],
"Zones": []
}
}
],
"MajorRoadLabels": [
{
"RouteNumber": {
"Language": "de",
"Value": "A10"
}
}
]
},
{
"Legs": [
{
"Geometry": {
"Polyline": "Redacted"
},
"TravelMode": "Car",
"Type": "Vehicle",
"VehicleLegDetails": {
"AfterTravelSteps": [],
"Arrival": {
"Place": {
"ChargingStation": false,
"OriginalPosition": [
13.55191,
52.282705
],
"Position": [
13.5507836,
52.2859121
]
}
},
"Departure": {
"Place": {
"ChargingStation": false,
"OriginalPosition": [
13.055211,
52.704802
],
"Position": [
13.0555036,
52.7056073
]
}
},
"Incidents": [],
"Notices": [],
"PassThroughWaypoints": [],
"Spans": [],
"Tolls": [],
"TollSystems": [],
"TravelSteps": [
{
"Distance": 9099,
"Duration": 262,
"ExitNumber": [],
"GeometryOffset": 0,
"Type": "Depart"
},
{
"Distance": 18849,
"Duration": 800,
"ExitNumber": [],
"GeometryOffset": 162,
"KeepStepDetails": {
"Intersection": [],
"SteeringDirection": "Right"
},
"Type": "Keep"
},
{
"Distance": 4290,
"Duration": 212,
"ExitNumber": [],
"ExitStepDetails": {
"Intersection": [],
"SteeringDirection": "Right"
},
"GeometryOffset": 701,
"Type": "Exit"
},
{
"Distance": 12258,
"Duration": 554,
"ExitNumber": [],
"GeometryOffset": 828,
"Type": "Continue"
},
{
"Distance": 18567,
"Duration": 1218,
"ExitNumber": [],
"ExitStepDetails": {
"Intersection": [],
"SteeringDirection": "Right"
},
"GeometryOffset": 1282,
"Type": "Exit"
},
{
"Distance": 250,
"Duration": 28,
"ExitNumber": [],
"GeometryOffset": 1760,
"RampStepDetails": {
"Intersection": [],
"SteeringDirection": "Right"
},
"Type": "Ramp"
},
{
"Distance": 4856,
"Duration": 245,
"ExitNumber": [],
"GeometryOffset": 1793,
"TurnStepDetails": {
"Intersection": [],
"SteeringDirection": "Right",
"TurnIntensity": "Typical"
},
"Type": "Turn"
},
{
"Distance": 3202,
"Duration": 165,
"ExitNumber": [],
"GeometryOffset": 1970,
"RoundaboutExitStepDetails": {
"Intersection": [],
"SteeringDirection": "Right"
},
"Type": "RoundaboutExit"
},
{
"Distance": 386,
"Duration": 51,
"ExitNumber": [],
"GeometryOffset": 2072,
"TurnStepDetails": {
"Intersection": [],
"SteeringDirection": "Right",
"TurnIntensity": "Typical"
},
"Type": "Turn"
},
{
"Distance": 98,
"Duration": 15,
"ExitNumber": [],
"GeometryOffset": 2082,
"TurnStepDetails": {
"Intersection": [],
"SteeringDirection": "Right",
"TurnIntensity": "Typical"
},
"Type": "Turn"
},
{
"Distance": 0,
"Duration": 0,
"ExitNumber": [],
"GeometryOffset": 2085,
"Type": "Arrive"
}
],
"TruckRoadTypes": [],
"Zones": []
}
}
],
"MajorRoadLabels": [
{
"RouteNumber": {
"Language": "de",
"Value": "A111"
}
},
{
"RouteNumber": {
"Language": "de",
"Value": "B96"
}
}
]
}
]
}
```
------
#### [ cURL ]
```
curl --request POST \
--url 'https://routes.geo.eu-central-1.amazonaws.com/v2/routes?key=Your_key' \
--header 'Content-Type: application/json' \
--data '{
"Origin": [
13.055211,
52.704802
],
"Destination": [
13.551910,
52.282705
],
"TravelMode": "Car",
"MaxAlternatives": 2
}'
```
------
#### [ AWS CLI ]
```
aws geo-routes calculate-routes --key ${YourKey} \
--origin 13.055211 52.704802 \
--destination 13.551910 52.282705 \
--travel-mode "Car" \
--max-alternatives 2
```
------
# Como calcular os pedágios de uma rota
A API CalculateRoutes ajuda você a encontrar as melhores rotas entre a origem e o destino, além das melhores oportunidades para o motorista descansar. Ela aceita modos de viagem como carro, caminhão, pedestre e moto. Ela também permite usar até 25 pontos de referência (paradas), incluindo a origem e o destino, com apenas algumas restrições.
## Casos de uso possíveis
+ **Calcular pedágios:** calcule os custos de pedágio durante o planejamento da rota.
+ **Auditar pedágios:** audite os custos de pedágio depois de viajar.
## Exemplos
### Calcular pedágios para suas rotas em TravelMode Carro
------
#### [ Sample request ]
```
{
"Origin": [
2.234491,
48.815704
],
"Destination": [
5.11412,
47.260723
],
"TravelMode": "Car",
"Tolls": {
"AllTransponders": true,
"AllVignettes": true
}
}
```
------
#### [ Sample response ]
```
{
"LegGeometryFormat": "FlexiblePolyline",
"Notices": [],
"Routes": [
{
"Legs": [
{
"Geometry": {
"Polyline": "Redacted"
},
"TravelMode": "Car",
"Type": "Vehicle",
"VehicleLegDetails": {
"AfterTravelSteps": [],
"Arrival": {
"Place": {
"ChargingStation": false,
"OriginalPosition": [
5.11412,
47.2607229
],
"Position": [
5.1128203,
47.2596356
]
}
},
"Departure": {
"Place": {
"ChargingStation": false,
"OriginalPosition": [
2.234491,
48.8157039
],
"Position": [
2.2346482,
48.815674
]
}
},
"Incidents": [],
"Notices": [],
"PassThroughWaypoints": [],
"Spans": [],
"Tolls": [
{
"Country": "FRA",
"PaymentSites": [
{
"Name": "FLEURY-EN-BIERE",
"Position": [
2.53988,
48.42578
]
},
{
"Name": "POUILLY-EN-AUXOIS",
"Position": [
4.56112,
47.25244
]
}
],
"Rates": [
{
"Id": "2d680295-fb0f-45aa-a8ed-79d9f0f9ff9f",
"LocalPrice": {
"Currency": "EUR",
"Estimate": false,
"Range": false,
"Value": 21.700000762939453
},
"Name": "APRR",
"PaymentMethods": [
"Cash",
"BankCard",
"CreditCard",
"Transponder",
"TravelCard"
],
"Transponders": [
{
"SystemName": "BipandGo"
},
{
"SystemName": "BipandGo"
},
{
"SystemName": "BipandGo IDVROOM carpoorling"
},
{
"SystemName": "Cito30"
},
{
"SystemName": "Easytrip pass"
},
{
"SystemName": "Liane 30"
},
{
"SystemName": "Liber-t"
},
{
"SystemName": "Liber-t mobilitis"
},
{
"SystemName": "Pass Pont-Pont"
},
{
"SystemName": "Progressivi'T Maurienne"
},
{
"SystemName": "TopEurop"
},
{
"SystemName": "Tunnel Pass+"
},
{
"SystemName": "Ulys"
},
{
"SystemName": "Ulys Europe"
},
{
"SystemName": "Viaduc-t 30"
}
]
}
],
"Systems": [
0
]
}
],
"TollSystems": [
{
"Name": "APRR"
}
],
"TravelSteps": [
{
"Distance": 122,
"Duration": 21,
"ExitNumber": [],
"GeometryOffset": 0,
"Type": "Depart"
},
{
"Distance": 32,
"Duration": 7,
"ExitNumber": [],
"GeometryOffset": 7,
"TurnStepDetails": {
"Intersection": [],
"SteeringDirection": "Right",
"TurnIntensity": "Typical"
},
"Type": "Turn"
},
{
"Distance": 74,
"Duration": 14,
"ExitNumber": [],
"GeometryOffset": 8,
"TurnStepDetails": {
"Intersection": [],
"SteeringDirection": "Right",
"TurnIntensity": "Typical"
},
"Type": "Turn"
},
{
"Distance": 199,
"Duration": 33,
"ExitNumber": [],
"GeometryOffset": 9,
"TurnStepDetails": {
"Intersection": [],
"SteeringDirection": "Right",
"TurnIntensity": "Typical"
},
"Type": "Turn"
},
{
"Distance": 21,
"Duration": 10,
"ExitNumber": [],
"GeometryOffset": 17,
"TurnStepDetails": {
"Intersection": [],
"SteeringDirection": "Right",
"TurnIntensity": "Typical"
},
"Type": "Turn"
},
{
"Distance": 461,
"Duration": 63,
"ExitNumber": [],
"GeometryOffset": 20,
"TurnStepDetails": {
"Intersection": [],
"SteeringDirection": "Right",
"TurnIntensity": "Typical"
},
"Type": "Turn"
},
{
"Distance": 1557,
"Duration": 145,
"ExitNumber": [],
"GeometryOffset": 41,
"TurnStepDetails": {
"Intersection": [],
"SteeringDirection": "Left",
"TurnIntensity": "Typical"
},
"Type": "Turn"
},
{
"Distance": 3471,
"Duration": 151,
"ExitNumber": [],
"GeometryOffset": 135,
"RoundaboutExitStepDetails": {
"Intersection": [],
"SteeringDirection": "Right"
},
"Type": "RoundaboutExit"
},
{
"Distance": 9796,
"Duration": 430,
"ExitNumber": [],
"GeometryOffset": 242,
"RampStepDetails": {
"Intersection": [],
"SteeringDirection": "Right"
},
"Type": "Ramp"
},
{
"Distance": 2473,
"Duration": 112,
"ExitNumber": [],
"ExitStepDetails": {
"Intersection": [],
"SteeringDirection": "Right"
},
"GeometryOffset": 582,
"Type": "Exit"
},
{
"Distance": 674,
"Duration": 25,
"ExitNumber": [],
"GeometryOffset": 669,
"Type": "Continue"
},
{
"Distance": 253953,
"Duration": 7468,
"ExitNumber": [],
"GeometryOffset": 679,
"Type": "Continue"
},
{
"Distance": 37379,
"Duration": 1192,
"ExitNumber": [],
"ExitStepDetails": {
"Intersection": [],
"SteeringDirection": "Right"
},
"GeometryOffset": 5701,
"Type": "Exit"
},
{
"Distance": 2021,
"Duration": 110,
"ExitNumber": [],
"GeometryOffset": 6695,
"RoundaboutExitStepDetails": {
"Intersection": [],
"SteeringDirection": "Right"
},
"Type": "RoundaboutExit"
},
{
"Distance": 7380,
"Duration": 316,
"ExitNumber": [],
"GeometryOffset": 6776,
"RoundaboutPassStepDetails": {
"Intersection": [],
"SteeringDirection": "Right"
},
"Type": "RoundaboutPass"
},
{
"Distance": 4253,
"Duration": 156,
"ExitNumber": [],
"GeometryOffset": 6987,
"KeepStepDetails": {
"Intersection": [],
"SteeringDirection": "Left"
},
"Type": "Keep"
},
{
"Distance": 813,
"Duration": 54,
"ExitNumber": [],
"GeometryOffset": 7081,
"RampStepDetails": {
"Intersection": [],
"SteeringDirection": "Right"
},
"Type": "Ramp"
},
{
"Distance": 1909,
"Duration": 109,
"ExitNumber": [],
"GeometryOffset": 7133,
"TurnStepDetails": {
"Intersection": [],
"SteeringDirection": "Left",
"TurnIntensity": "Sharp"
},
"Type": "Turn"
},
{
"Distance": 827,
"Duration": 47,
"ExitNumber": [],
"GeometryOffset": 7182,
"Type": "Continue"
},
{
"Distance": 680,
"Duration": 41,
"ExitNumber": [],
"GeometryOffset": 7216,
"RoundaboutExitStepDetails": {
"Intersection": [],
"SteeringDirection": "Right"
},
"Type": "RoundaboutExit"
},
{
"Distance": 224,
"Duration": 12,
"ExitNumber": [],
"GeometryOffset": 7258,
"Type": "Continue"
},
{
"Distance": 25,
"Duration": 2,
"ExitNumber": [],
"GeometryOffset": 7265,
"Type": "Continue"
},
{
"Distance": 748,
"Duration": 51,
"ExitNumber": [],
"GeometryOffset": 7267,
"Type": "Continue"
},
{
"Distance": 656,
"Duration": 46,
"ExitNumber": [],
"GeometryOffset": 7299,
"RoundaboutExitStepDetails": {
"Intersection": [],
"SteeringDirection": "Right"
},
"Type": "RoundaboutExit"
},
{
"Distance": 1119,
"Duration": 78,
"ExitNumber": [],
"GeometryOffset": 7329,
"Type": "Continue"
},
{
"Distance": 432,
"Duration": 26,
"ExitNumber": [],
"GeometryOffset": 7383,
"TurnStepDetails": {
"Intersection": [],
"SteeringDirection": "Right",
"TurnIntensity": "Typical"
},
"Type": "Turn"
},
{
"Distance": 1864,
"Duration": 100,
"ExitNumber": [],
"GeometryOffset": 7402,
"RoundaboutExitStepDetails": {
"Intersection": [],
"SteeringDirection": "Right"
},
"Type": "RoundaboutExit"
},
{
"Distance": 1110,
"Duration": 93,
"ExitNumber": [],
"GeometryOffset": 7470,
"RoundaboutExitStepDetails": {
"Intersection": [],
"SteeringDirection": "Right"
},
"Type": "RoundaboutExit"
},
{
"Distance": 232,
"Duration": 10,
"ExitNumber": [],
"GeometryOffset": 7563,
"Type": "Continue"
},
{
"Distance": 642,
"Duration": 29,
"ExitNumber": [],
"GeometryOffset": 7572,
"Type": "Continue"
},
{
"Distance": 357,
"Duration": 25,
"ExitNumber": [],
"GeometryOffset": 7580,
"Type": "Continue"
},
{
"Distance": 63,
"Duration": 10,
"ExitNumber": [],
"GeometryOffset": 7600,
"TurnStepDetails": {
"Intersection": [],
"SteeringDirection": "Right",
"TurnIntensity": "Typical"
},
"Type": "Turn"
},
{
"Distance": 2626,
"Duration": 411,
"ExitNumber": [],
"GeometryOffset": 7602,
"TurnStepDetails": {
"Intersection": [],
"SteeringDirection": "Right",
"TurnIntensity": "Typical"
},
"Type": "Turn"
},
{
"Distance": 234,
"Duration": 37,
"ExitNumber": [],
"GeometryOffset": 7627,
"Type": "Continue"
},
{
"Distance": 0,
"Duration": 0,
"ExitNumber": [],
"GeometryOffset": 7632,
"Type": "Arrive"
}
],
"TruckRoadTypes": [],
"Zones": []
}
}
],
"MajorRoadLabels": [
{
"RouteNumber": {
"Language": "fr",
"Value": "A6"
}
}
]
}
]
}
```
------
#### [ cURL ]
```
curl --request POST \
--url 'https://routes.geo.eu-central-1.amazonaws.com/v2/routes?key=Your_key' \
--header 'Content-Type: application/json' \
--data '{
"Origin": [
2.234491,
48.815704
],
"Destination": [
5.11412,
47.260723
],
"TravelMode": "Car",
"Tolls": {
"AllTransponders": true,
"AllVignettes": true
}
}'
```
------
#### [ AWS CLI ]
```
aws geo-routes calculate-routes --key ${YourKey} \
--origin 13.055211 52.704802 \
--destination 13.551910 52.282705 \
--travel-mode "Car" \
--tolls '{"AllTransponders": true, "AllVignettes": true}'
```
------
# Como criar rotas com evasão personalizada
A API CalculateRoutes ajuda você a encontrar as melhores rotas entre a origem e o destino, além das melhores oportunidades para o motorista descansar. Ela aceita modos de viagem como carro, caminhão, pedestre e moto. Ela também permite usar até 25 pontos de referência (paradas), incluindo a origem e o destino, com apenas algumas restrições.
## Casos de uso possíveis
+ **Calcular rotas personalizando como evitar alguns fatores:** personalize rotas com evasão para encontrar melhores rotas e planejamento de trajetos.
## Exemplos
### Use CalculateRoutes com BoundingBox de evasão para criar rotas personalizadas.
------
#### [ Sample request ]
```
{
"Origin": [
-123.116655,
49.281538
],
"Destination": [
-123.01791785749363,
49.22782762759908
],
"TravelMode": "Car",
"Avoid": {
"Areas": [
{
"Geometry": {
"BoundingBox": [
-123.078693,
49.238987,
-123.054638,
49.251694
]
}
}
]
}
}
```
------
#### [ Sample response ]
```
{
"LegGeometryFormat": "FlexiblePolyline",
"Notices": [],
"Routes": [
{
"Legs": [
{
"Geometry": {
"Polyline": "Redacted"
},
"TravelMode": "Car",
"Type": "Vehicle",
"VehicleLegDetails": {
"AfterTravelSteps": [],
"Arrival": {
"Place": {
"ChargingStation": false,
"OriginalPosition": [
-123.0179179,
49.2278276
],
"Position": [
-123.0229001,
49.22883
]
}
},
"Departure": {
"Place": {
"ChargingStation": false,
"OriginalPosition": [
-123.116655,
49.281538
],
"Position": [
-123.1166332,
49.2815528
]
}
},
"Incidents": [],
"Notices": [],
"PassThroughWaypoints": [],
"Spans": [],
"Tolls": [],
"TollSystems": [],
"TravelSteps": [
{
"Distance": 1144,
"Duration": 85,
"ExitNumber": [],
"GeometryOffset": 0,
"Type": "Depart"
},
{
"Distance": 262,
"Duration": 24,
"ExitNumber": [],
"GeometryOffset": 35,
"RampStepDetails": {
"Intersection": [],
"SteeringDirection": "Right"
},
"Type": "Ramp"
},
{
"Distance": 433,
"Duration": 47,
"ExitNumber": [],
"GeometryOffset": 40,
"TurnStepDetails": {
"Intersection": [],
"SteeringDirection": "Right",
"TurnIntensity": "Typical"
},
"Type": "Turn"
},
{
"Distance": 1131,
"Duration": 81,
"ExitNumber": [],
"GeometryOffset": 54,
"TurnStepDetails": {
"Intersection": [],
"SteeringDirection": "Left",
"TurnIntensity": "Typical"
},
"Type": "Turn"
},
{
"Distance": 54,
"Duration": 4,
"ExitNumber": [],
"GeometryOffset": 79,
"Type": "Continue"
},
{
"Distance": 520,
"Duration": 39,
"ExitNumber": [],
"GeometryOffset": 83,
"Type": "Continue"
},
{
"Distance": 1123,
"Duration": 111,
"ExitNumber": [],
"GeometryOffset": 101,
"TurnStepDetails": {
"Intersection": [],
"SteeringDirection": "Right",
"TurnIntensity": "Typical"
},
"Type": "Turn"
},
{
"Distance": 1131,
"Duration": 81,
"ExitNumber": [],
"GeometryOffset": 141,
"TurnStepDetails": {
"Intersection": [],
"SteeringDirection": "Left",
"TurnIntensity": "Typical"
},
"Type": "Turn"
},
{
"Distance": 2843,
"Duration": 209,
"ExitNumber": [],
"GeometryOffset": 167,
"Type": "Continue"
},
{
"Distance": 3219,
"Duration": 246,
"ExitNumber": [],
"GeometryOffset": 255,
"TurnStepDetails": {
"Intersection": [],
"SteeringDirection": "Right",
"TurnIntensity": "Typical"
},
"Type": "Turn"
},
{
"Distance": 64,
"Duration": 23,
"ExitNumber": [],
"GeometryOffset": 332,
"TurnStepDetails": {
"Intersection": [],
"SteeringDirection": "Left",
"TurnIntensity": "Typical"
},
"Type": "Turn"
},
{
"Distance": 0,
"Duration": 0,
"ExitNumber": [],
"GeometryOffset": 334,
"Type": "Arrive"
}
],
"TruckRoadTypes": [],
"Zones": []
}
}
],
"MajorRoadLabels": [
{
"RoadName": {
"Language": "en",
"Value": "Boundary Rd"
}
},
{
"RoadName": {
"Language": "en",
"Value": "Grandview Hwy"
}
}
]
}
]
}
```
------
#### [ cURL ]
```
curl --request POST \
--url 'https://routes.geo.eu-central-1.amazonaws.com/v2/routes?key=Your_key' \
--header 'Content-Type: application/json' \
--data '{
"Origin": [
-123.116655,
49.281538
],
"Destination": [
-123.01791785749363,
49.22782762759908
],
"TravelMode": "Car",
"Avoid": {
"Areas": [
{
"Geometry": {
"BoundingBox": [
-123.078693,
49.238987,
-123.054638,
49.251694
]
}
}
]
}
}'
```
------
#### [ AWS CLI ]
```
aws geo-routes calculate-routes --key ${YourKey} \
--origin -123.13277 49.281538 \
--destination -123.01791785749363 49.22782762759908 \
--travel-mode "Car" \
--avoid '{"Areas":[{"Geometry":{"BoundingBox":[-123.054638,49.238987,-123.054638,49.251694]}}]}'
```
------
### Use CalculateRoutes com polígono de evasão para criar rotas personalizadas.
------
#### [ Sample request ]
```
{
"Origin": [
-123.116655,
49.281538
],
"Destination": [
-123.01791785749363,
49.22782762759908
],
"TravelMode": "Car",
"Avoid": {
"Areas": [
{
"Geometry": {
"polygon": [
[
[
-123.06953,
49.256419
],
[
-123.080486,
49.242115
],
[
-123.058573,
49.242115
],
[
-123.06953,
49.256419
]
]
]
}
}
]
}
}
```
------
#### [ Sample response ]
```
{
"LegGeometryFormat": "FlexiblePolyline",
"Notices": [],
"Routes": [
{
"Legs": [
{
"Geometry": {
"Polyline": "Redacted"
},
"TravelMode": "Car",
"Type": "Vehicle",
"VehicleLegDetails": {
"AfterTravelSteps": [],
"Arrival": {
"Place": {
"ChargingStation": false,
"OriginalPosition": [
-123.0179179,
49.2278276
],
"Position": [
-123.0229001,
49.22883
]
}
},
"Departure": {
"Place": {
"ChargingStation": false,
"OriginalPosition": [
-123.116655,
49.281538
],
"Position": [
-123.1166332,
49.2815528
]
}
},
"Incidents": [],
"Notices": [],
"PassThroughWaypoints": [],
"Spans": [],
"Tolls": [],
"TollSystems": [],
"TravelSteps": [
{
"Distance": 1144,
"Duration": 85,
"ExitNumber": [],
"GeometryOffset": 0,
"Type": "Depart"
},
{
"Distance": 262,
"Duration": 24,
"ExitNumber": [],
"GeometryOffset": 35,
"RampStepDetails": {
"Intersection": [],
"SteeringDirection": "Right"
},
"Type": "Ramp"
},
{
"Distance": 433,
"Duration": 47,
"ExitNumber": [],
"GeometryOffset": 40,
"TurnStepDetails": {
"Intersection": [],
"SteeringDirection": "Right",
"TurnIntensity": "Typical"
},
"Type": "Turn"
},
{
"Distance": 1131,
"Duration": 81,
"ExitNumber": [],
"GeometryOffset": 54,
"TurnStepDetails": {
"Intersection": [],
"SteeringDirection": "Left",
"TurnIntensity": "Typical"
},
"Type": "Turn"
},
{
"Distance": 54,
"Duration": 4,
"ExitNumber": [],
"GeometryOffset": 79,
"Type": "Continue"
},
{
"Distance": 520,
"Duration": 39,
"ExitNumber": [],
"GeometryOffset": 83,
"Type": "Continue"
},
{
"Distance": 1123,
"Duration": 111,
"ExitNumber": [],
"GeometryOffset": 101,
"TurnStepDetails": {
"Intersection": [],
"SteeringDirection": "Right",
"TurnIntensity": "Typical"
},
"Type": "Turn"
},
{
"Distance": 1131,
"Duration": 81,
"ExitNumber": [],
"GeometryOffset": 141,
"TurnStepDetails": {
"Intersection": [],
"SteeringDirection": "Left",
"TurnIntensity": "Typical"
},
"Type": "Turn"
},
{
"Distance": 448,
"Duration": 34,
"ExitNumber": [],
"GeometryOffset": 167,
"Type": "Continue"
},
{
"Distance": 1797,
"Duration": 151,
"ExitNumber": [],
"GeometryOffset": 182,
"TurnStepDetails": {
"Intersection": [],
"SteeringDirection": "Right",
"TurnIntensity": "Typical"
},
"Type": "Turn"
},
{
"Distance": 2836,
"Duration": 224,
"ExitNumber": [],
"GeometryOffset": 222,
"TurnStepDetails": {
"Intersection": [],
"SteeringDirection": "Left",
"TurnIntensity": "Typical"
},
"Type": "Turn"
},
{
"Distance": 339,
"Duration": 30,
"ExitNumber": [],
"GeometryOffset": 326,
"TurnStepDetails": {
"Intersection": [],
"SteeringDirection": "Right",
"TurnIntensity": "Typical"
},
"Type": "Turn"
},
{
"Distance": 64,
"Duration": 23,
"ExitNumber": [],
"GeometryOffset": 335,
"TurnStepDetails": {
"Intersection": [],
"SteeringDirection": "Left",
"TurnIntensity": "Typical"
},
"Type": "Turn"
},
{
"Distance": 0,
"Duration": 0,
"ExitNumber": [],
"GeometryOffset": 337,
"Type": "Arrive"
}
],
"TruckRoadTypes": [],
"Zones": []
}
}
],
"MajorRoadLabels": [
{
"RouteNumber": {
"Language": "en",
"Value": "HWY-1A"
}
},
{
"RoadName": {
"Language": "en",
"Value": "Nanaimo St"
}
}
]
}
]
}
```
------
#### [ cURL ]
```
curl --request POST \
--url 'https://routes.geo.eu-central-1.amazonaws.com/v2/routes?key=Your_key' \
--header 'Content-Type: application/json' \
--data '{
"Origin": [
-123.116655,
49.281538
],
"Destination": [
-123.01791785749363,
49.22782762759908
],
"TravelMode": "Car",
"Avoid": {
"Areas": [
{
"Geometry": {
"polygon": [
[
[
-123.06953,
49.256419
],
[
-123.080486,
49.242115
],
[
-123.058573,
49.242115
],
[
-123.06953,
49.256419
]
]
]
}
}
]
}
}'
```
------
#### [ AWS CLI ]
```
aws geo-routes calculate-routes --key ${YourKey} \
--origin -123.13277 49.281538 \
--destination -123.01791785749363 49.22782762759908 \
--travel-mode "Car" \
--avoid '{"Areas":[{"Geometry":{"Polygon":[[[-123.06953,49.256419],[-123.05167,49.242115],[-123.02381,49.242115],[-123.06953,49.256419]]]}}]}'
```
------
### Use CalculateRoutes com PolylinePolygon para criar rotas personalizadas.
------
#### [ Sample request ]
```
{
"Origin": [
-123.116655,
49.281538
],
"Destination": [
-123.01791785749363,
49.22782762759908
],
"TravelMode": "Car",
"Avoid": {
"Areas": [
{
"Geometry": {
"PolylinePolygon": [
"BF0s0sJxglvXr5CvkCAgpEs5CvkC"
]
}
}
]
}
}
```
------
#### [ Sample response ]
```
{
"LegGeometryFormat": "FlexiblePolyline",
"Notices": [],
"Routes": [
{
"Legs": [
{
"Geometry": {
"Polyline": "Redacted"
},
"TravelMode": "Car",
"Type": "Vehicle",
"VehicleLegDetails": {
"AfterTravelSteps": [],
"Arrival": {
"Place": {
"ChargingStation": false,
"OriginalPosition": [
-123.0179179,
49.2278276
],
"Position": [
-123.0229001,
49.22883
]
}
},
"Departure": {
"Place": {
"ChargingStation": false,
"OriginalPosition": [
-123.116655,
49.281538
],
"Position": [
-123.1166332,
49.2815528
]
}
},
"Incidents": [],
"Notices": [],
"PassThroughWaypoints": [],
"Spans": [],
"Tolls": [],
"TollSystems": [],
"TravelSteps": [
{
"Distance": 1144,
"Duration": 85,
"ExitNumber": [],
"GeometryOffset": 0,
"Type": "Depart"
},
{
"Distance": 262,
"Duration": 24,
"ExitNumber": [],
"GeometryOffset": 35,
"RampStepDetails": {
"Intersection": [],
"SteeringDirection": "Right"
},
"Type": "Ramp"
},
{
"Distance": 433,
"Duration": 47,
"ExitNumber": [],
"GeometryOffset": 40,
"TurnStepDetails": {
"Intersection": [],
"SteeringDirection": "Right",
"TurnIntensity": "Typical"
},
"Type": "Turn"
},
{
"Distance": 1131,
"Duration": 81,
"ExitNumber": [],
"GeometryOffset": 54,
"TurnStepDetails": {
"Intersection": [],
"SteeringDirection": "Left",
"TurnIntensity": "Typical"
},
"Type": "Turn"
},
{
"Distance": 54,
"Duration": 4,
"ExitNumber": [],
"GeometryOffset": 79,
"Type": "Continue"
},
{
"Distance": 520,
"Duration": 39,
"ExitNumber": [],
"GeometryOffset": 83,
"Type": "Continue"
},
{
"Distance": 1123,
"Duration": 111,
"ExitNumber": [],
"GeometryOffset": 101,
"TurnStepDetails": {
"Intersection": [],
"SteeringDirection": "Right",
"TurnIntensity": "Typical"
},
"Type": "Turn"
},
{
"Distance": 1131,
"Duration": 81,
"ExitNumber": [],
"GeometryOffset": 141,
"TurnStepDetails": {
"Intersection": [],
"SteeringDirection": "Left",
"TurnIntensity": "Typical"
},
"Type": "Turn"
},
{
"Distance": 448,
"Duration": 34,
"ExitNumber": [],
"GeometryOffset": 167,
"Type": "Continue"
},
{
"Distance": 1797,
"Duration": 151,
"ExitNumber": [],
"GeometryOffset": 182,
"TurnStepDetails": {
"Intersection": [],
"SteeringDirection": "Right",
"TurnIntensity": "Typical"
},
"Type": "Turn"
},
{
"Distance": 2836,
"Duration": 224,
"ExitNumber": [],
"GeometryOffset": 222,
"TurnStepDetails": {
"Intersection": [],
"SteeringDirection": "Left",
"TurnIntensity": "Typical"
},
"Type": "Turn"
},
{
"Distance": 339,
"Duration": 30,
"ExitNumber": [],
"GeometryOffset": 326,
"TurnStepDetails": {
"Intersection": [],
"SteeringDirection": "Right",
"TurnIntensity": "Typical"
},
"Type": "Turn"
},
{
"Distance": 64,
"Duration": 23,
"ExitNumber": [],
"GeometryOffset": 335,
"TurnStepDetails": {
"Intersection": [],
"SteeringDirection": "Left",
"TurnIntensity": "Typical"
},
"Type": "Turn"
},
{
"Distance": 0,
"Duration": 0,
"ExitNumber": [],
"GeometryOffset": 337,
"Type": "Arrive"
}
],
"TruckRoadTypes": [],
"Zones": []
}
}
],
"MajorRoadLabels": [
{
"RouteNumber": {
"Language": "en",
"Value": "HWY-1A"
}
},
{
"RoadName": {
"Language": "en",
"Value": "Nanaimo St"
}
}
]
}
]
}
```
------
#### [ cURL ]
```
curl --request POST \
--url 'https://routes.geo.eu-central-1.amazonaws.com/v2/routes?key=Your_key' \
--header 'Content-Type: application/json' \
--data '{
"Origin": [
-123.116655,
49.281538
],
"Destination": [
-123.01791785749363,
49.22782762759908
],
"TravelMode": "Car",
"Avoid": {
"Areas": [
{
"Geometry": {
"PolylinePolygon": [
"BF0s0sJxglvXr5CvkCAgpEs5CvkC"
]
}
}
]
}
}'
```
------
#### [ AWS CLI ]
```
aws geo-routes calculate-routes --key ${YourKey} \
--origin -123.13277 49.281538 \
--destination -123.01791785749363 49.22782762759908 \
--travel-mode "Car" \
--avoid '{"Areas":[{"Geometry":{"PolylinePolygon":["BF0s0sJxglvXr5CvkCAgpEs5CvkC"]}}]}'
```
------
### Use CalculateRoutes com corredor de evasão para criar rotas personalizadas.
------
#### [ Sample request ]
```
{
"Origin": [
-123.116655,
49.281538
],
"Destination": [
-123.01791785749363,
49.22782762759908
],
"TravelMode": "Car",
"Avoid": {
"Areas": [
{
"Geometry": {
"PolylineCorridor": {
"Polyline": "Redacted",
"Radius": 10
}
}
}
]
}
}
```
------
#### [ Sample response ]
```
{
"LegGeometryFormat": "FlexiblePolyline",
"Notices": [],
"Routes": [
{
"Legs": [
{
"Geometry": {
"Polyline": "Redacted"
},
"TravelMode": "Car",
"Type": "Vehicle",
"VehicleLegDetails": {
"AfterTravelSteps": [],
"Arrival": {
"Place": {
"ChargingStation": false,
"OriginalPosition": [
-123.0179179,
49.2278276
],
"Position": [
-123.0229001,
49.22883
]
}
},
"Departure": {
"Place": {
"ChargingStation": false,
"OriginalPosition": [
-123.116655,
49.281538
],
"Position": [
-123.1166332,
49.2815528
]
}
},
"Incidents": [],
"Notices": [],
"PassThroughWaypoints": [],
"Spans": [],
"Tolls": [],
"TollSystems": [],
"TravelSteps": [
{
"Distance": 1144,
"Duration": 85,
"ExitNumber": [],
"GeometryOffset": 0,
"Type": "Depart"
},
{
"Distance": 262,
"Duration": 24,
"ExitNumber": [],
"GeometryOffset": 35,
"RampStepDetails": {
"Intersection": [],
"SteeringDirection": "Right"
},
"Type": "Ramp"
},
{
"Distance": 1356,
"Duration": 134,
"ExitNumber": [],
"GeometryOffset": 40,
"TurnStepDetails": {
"Intersection": [],
"SteeringDirection": "Right",
"TurnIntensity": "Typical"
},
"Type": "Turn"
},
{
"Distance": 2468,
"Duration": 204,
"ExitNumber": [],
"GeometryOffset": 90,
"KeepStepDetails": {
"Intersection": [],
"SteeringDirection": "Left"
},
"Type": "Keep"
},
{
"Distance": 1100,
"Duration": 88,
"ExitNumber": [],
"GeometryOffset": 170,
"TurnStepDetails": {
"Intersection": [],
"SteeringDirection": "Right",
"TurnIntensity": "Typical"
},
"Type": "Turn"
},
{
"Distance": 1588,
"Duration": 133,
"ExitNumber": [],
"GeometryOffset": 214,
"TurnStepDetails": {
"Intersection": [],
"SteeringDirection": "Left",
"TurnIntensity": "Typical"
},
"Type": "Turn"
},
{
"Distance": 47,
"Duration": 14,
"ExitNumber": [],
"GeometryOffset": 260,
"Type": "Continue"
},
{
"Distance": 2478,
"Duration": 196,
"ExitNumber": [],
"GeometryOffset": 265,
"TurnStepDetails": {
"Intersection": [],
"SteeringDirection": "Right",
"TurnIntensity": "Typical"
},
"Type": "Turn"
},
{
"Distance": 339,
"Duration": 30,
"ExitNumber": [],
"GeometryOffset": 357,
"TurnStepDetails": {
"Intersection": [],
"SteeringDirection": "Right",
"TurnIntensity": "Typical"
},
"Type": "Turn"
},
{
"Distance": 64,
"Duration": 23,
"ExitNumber": [],
"GeometryOffset": 366,
"TurnStepDetails": {
"Intersection": [],
"SteeringDirection": "Left",
"TurnIntensity": "Typical"
},
"Type": "Turn"
},
{
"Distance": 0,
"Duration": 0,
"ExitNumber": [],
"GeometryOffset": 368,
"Type": "Arrive"
}
],
"TruckRoadTypes": [],
"Zones": []
}
}
],
"MajorRoadLabels": [
{
"RouteNumber": {
"Language": "en",
"Value": "HWY-1A"
}
}
]
}
]
}
```
------
#### [ cURL ]
```
curl --request POST \
--url 'https://routes.geo.eu-central-1.amazonaws.com/v2/routes?key=Your_key' \
--header 'Content-Type: application/json' \
--data '{
"Origin": [
-123.116655,
49.281538
],
"Destination": [
-123.01791785749363,
49.22782762759908
],
"TravelMode": "Car",
"Avoid": {
"Areas": [
{
"Geometry": {
"PolylineCorridor": {
"Polyline": "Redacted",
"Radius": 10
}
}
}
]
}
}'
```
------
#### [ AWS CLI ]
```
aws geo-routes calculate-routes --key ${YourKey} \
--origin -123.116655 49.281538 \
--destination -123.01791785749363 49.22782762759908 \
--travel-mode "Car" \
--avoid '{"Areas": [{"Geometry": {"PolylineCorridor": {"Polyline": "BF2mysJnmkvX5ekiC", "Radius": 10}}}]}'
```
------
### Use CalculateRoutes com PolylineCorridor de evasão para criar rotas personalizadas.
------
#### [ Sample request ]
```
{
"Origin": [
-123.116655,
49.281538
],
"Destination": [
-123.01791785749363,
49.22782762759908
],
"TravelMode": "Car",
"Avoid": {
"Areas": [
{
"Geometry": {
"Corridor": {
"LineString": [
[
-123.06532243038754,
49.245226301868776
],
[
-123.0547357660333,
49.24030469850804
]
],
"Radius": 10
}
}
}
]
}
}
```
------
#### [ Sample response ]
```
{
"LegGeometryFormat": "FlexiblePolyline",
"Notices": [],
"Routes": [
{
"Legs": [
{
"Geometry": {
"Polyline": "Redacted"
},
"TravelMode": "Car",
"Type": "Vehicle",
"VehicleLegDetails": {
"AfterTravelSteps": [],
"Arrival": {
"Place": {
"ChargingStation": false,
"OriginalPosition": [
-123.0179179,
49.2278276
],
"Position": [
-123.0229001,
49.22883
]
}
},
"Departure": {
"Place": {
"ChargingStation": false,
"OriginalPosition": [
-123.116655,
49.281538
],
"Position": [
-123.1166332,
49.2815528
]
}
},
"Incidents": [],
"Notices": [],
"PassThroughWaypoints": [],
"Spans": [],
"Tolls": [],
"TollSystems": [],
"TravelSteps": [
{
"Distance": 1144,
"Duration": 85,
"ExitNumber": [],
"GeometryOffset": 0,
"Type": "Depart"
},
{
"Distance": 262,
"Duration": 24,
"ExitNumber": [],
"GeometryOffset": 35,
"RampStepDetails": {
"Intersection": [],
"SteeringDirection": "Right"
},
"Type": "Ramp"
},
{
"Distance": 1356,
"Duration": 134,
"ExitNumber": [],
"GeometryOffset": 40,
"TurnStepDetails": {
"Intersection": [],
"SteeringDirection": "Right",
"TurnIntensity": "Typical"
},
"Type": "Turn"
},
{
"Distance": 2468,
"Duration": 204,
"ExitNumber": [],
"GeometryOffset": 90,
"KeepStepDetails": {
"Intersection": [],
"SteeringDirection": "Left"
},
"Type": "Keep"
},
{
"Distance": 1100,
"Duration": 88,
"ExitNumber": [],
"GeometryOffset": 170,
"TurnStepDetails": {
"Intersection": [],
"SteeringDirection": "Right",
"TurnIntensity": "Typical"
},
"Type": "Turn"
},
{
"Distance": 1588,
"Duration": 133,
"ExitNumber": [],
"GeometryOffset": 214,
"TurnStepDetails": {
"Intersection": [],
"SteeringDirection": "Left",
"TurnIntensity": "Typical"
},
"Type": "Turn"
},
{
"Distance": 47,
"Duration": 14,
"ExitNumber": [],
"GeometryOffset": 260,
"Type": "Continue"
},
{
"Distance": 2478,
"Duration": 196,
"ExitNumber": [],
"GeometryOffset": 265,
"TurnStepDetails": {
"Intersection": [],
"SteeringDirection": "Right",
"TurnIntensity": "Typical"
},
"Type": "Turn"
},
{
"Distance": 339,
"Duration": 30,
"ExitNumber": [],
"GeometryOffset": 357,
"TurnStepDetails": {
"Intersection": [],
"SteeringDirection": "Right",
"TurnIntensity": "Typical"
},
"Type": "Turn"
},
{
"Distance": 64,
"Duration": 23,
"ExitNumber": [],
"GeometryOffset": 366,
"TurnStepDetails": {
"Intersection": [],
"SteeringDirection": "Left",
"TurnIntensity": "Typical"
},
"Type": "Turn"
},
{
"Distance": 0,
"Duration": 0,
"ExitNumber": [],
"GeometryOffset": 368,
"Type": "Arrive"
}
],
"TruckRoadTypes": [],
"Zones": []
}
}
],
"MajorRoadLabels": [
{
"RouteNumber": {
"Language": "en",
"Value": "HWY-1A"
}
}
]
}
]
}
```
------
#### [ cURL ]
```
curl --request POST \
--url 'https://routes.geo.eu-central-1.amazonaws.com/v2/routes?key=Your_key' \
--header 'Content-Type: application/json' \
--data '{
"Origin": [
-123.116655,
49.281538
],
"Destination": [
-123.01791785749363,
49.22782762759908
],
"TravelMode": "Car",
"Avoid": {
"Areas": [
{
"Geometry": {
"Corridor": {
"LineString": [
[
-123.06532243038754,
49.245226301868776
],
[
-123.0547357660333,
49.24030469850804
]
],
"Radius": 10
}
}
}
]
}
}'
```
------
#### [ AWS CLI ]
```
aws geo-routes calculate-routes --key ${YourKey} \
--origin -123.13277 49.281538 \
--destination -123.01791785749363 49.22782762759908 \
--travel-mode "Car" \
--avoid '{"Areas":[{"Geometry":{"Corridor":{"LineString":[[-123.06532243038754,49.245226301868776],[-123.0547357660333,49.24030469850804]],"Radius":10}}}]}'
```
------
# Como criar rotas personalizando como evitar vários itens possíveis
A API CalculateRoutes ajuda você a encontrar as melhores rotas entre a origem e o destino, além das melhores oportunidades para o motorista descansar. Ela aceita modos de viagem como carro, caminhão, pedestre e moto. Ela também permite usar até 25 pontos de referência (paradas), incluindo a origem e o destino, com apenas algumas restrições.
## Casos de uso possíveis
+ **Calcular rotas personalizando como evitar alguns fatores:** personalize rotas com evasão para encontrar melhores rotas e planejamento de trajetos.
## Exemplos
### Use CalculateRoutes para evitar pedágios, curvas acentuadas, balsas, rodovias, túneis e muito mais.
------
#### [ Sample request ]
```
{
"Origin": [
-123.118105,
49.282423
],
"Destination": [
-123.020098,
49.232872
],
"TravelMode": "Car",
"Avoid": {
"TollRoads": true,
"UTurns": true,
"Ferries": true,
"ControlledAccessHighways": true,
"Tunnels": true
}
}
```
------
#### [ Sample response ]
```
{
"LegGeometryFormat": "FlexiblePolyline",
"Notices": [],
"Routes": [
{
"Legs": [
{
"Geometry": {
"Polyline": "Redacted"
},
"TravelMode": "Car",
"Type": "Vehicle",
"VehicleLegDetails": {
"AfterTravelSteps": [],
"Arrival": {
"Place": {
"ChargingStation": false,
"OriginalPosition": [
-123.020098,
49.232872
],
"Position": [
-123.0203051,
49.2328499
]
}
},
"Departure": {
"Place": {
"ChargingStation": false,
"OriginalPosition": [
-123.1181051,
49.282423
],
"Position": [
-123.1180883,
49.2824349
]
}
},
"Incidents": [],
"Notices": [],
"PassThroughWaypoints": [],
"Spans": [],
"Tolls": [],
"TollSystems": [],
"TravelSteps": [
{
"Distance": 1288,
"Duration": 102,
"ExitNumber": [],
"GeometryOffset": 0,
"Type": "Depart"
},
{
"Distance": 262,
"Duration": 24,
"ExitNumber": [],
"GeometryOffset": 37,
"RampStepDetails": {
"Intersection": [],
"SteeringDirection": "Right"
},
"Type": "Ramp"
},
{
"Distance": 1356,
"Duration": 134,
"ExitNumber": [],
"GeometryOffset": 42,
"TurnStepDetails": {
"Intersection": [],
"SteeringDirection": "Right",
"TurnIntensity": "Typical"
},
"Type": "Turn"
},
{
"Distance": 7092,
"Duration": 568,
"ExitNumber": [],
"GeometryOffset": 92,
"KeepStepDetails": {
"Intersection": [],
"SteeringDirection": "Left"
},
"Type": "Keep"
},
{
"Distance": 65,
"Duration": 26,
"ExitNumber": [],
"GeometryOffset": 337,
"TurnStepDetails": {
"Intersection": [],
"SteeringDirection": "Left",
"TurnIntensity": "Typical"
},
"Type": "Turn"
},
{
"Distance": 50,
"Duration": 18,
"ExitNumber": [],
"GeometryOffset": 339,
"TurnStepDetails": {
"Intersection": [],
"SteeringDirection": "Right",
"TurnIntensity": "Typical"
},
"Type": "Turn"
},
{
"Distance": 0,
"Duration": 0,
"ExitNumber": [],
"GeometryOffset": 343,
"Type": "Arrive"
}
],
"TruckRoadTypes": [],
"Zones": []
}
}
],
"MajorRoadLabels": [
{
"RouteNumber": {
"Language": "en",
"Value": "HWY-1A"
}
}
]
}
]
}
```
------
#### [ cURL ]
```
curl --request POST \
--url 'https://routes.geo.eu-central-1.amazonaws.com/v2/routes?key=Your_key' \
--header 'Content-Type: application/json' \
--data '{
"Origin": [
-123.118105,
49.282423
],
"Destination": [
-123.020098,
49.232872
],
"TravelMode": "Car",
"Avoid": {
"TollRoads": true,
"UTurns": true,
"Ferries": true,
"ControlledAccessHighways": true,
"Tunnels": true
}
}'
```
------
#### [ AWS CLI ]
```
aws geo-routes calculate-routes --key ${YourKey} \
--origin -123.118105 49.282423 \
--destination -123.020098 49.232872 \
--travel-mode "Car" \
--avoid '{"TollRoads": true, "UTurns": true, "Ferries": true, "ControlledAccessHighways": true, "Tunnels": true}'
```
------
# Como encontrar a rota mais rápida
A API CalculateRoutes ajuda você a encontrar as rotas mais rápidas entre a origem e o destino.
## Casos de uso possíveis
+ **Otimizar as rotas para eficiência de tempo:** melhore as operações de entrega calculando a rota mais rápida. É útil para reduzir o tempo de viagem nos serviços de logística e entrega.
## Exemplos
### Calcular a rota mais rápida
------
#### [ Sample request ]
```
{
"Origin": [
-123.118105,
49.282423
],
"Destination": [
-123.020098,
49.232872
],
"TravelMode": "Car",
"OptimizeRoutingFor": "FastestRoute"
}
```
------
#### [ Sample response ]
```
{
"LegGeometryFormat": "FlexiblePolyline",
"Notices": [],
"Routes": [
{
"Legs": [
{
"Geometry": {
"Polyline": "Redacted"
},
"TravelMode": "Car",
"Type": "Vehicle",
"VehicleLegDetails": {
"AfterTravelSteps": [],
"Arrival": {
"Place": {
"ChargingStation": false,
"OriginalPosition": [
-123.020098,
49.232872
],
"Position": [
-123.0203051,
49.2328499
]
}
},
"Departure": {
"Place": {
"ChargingStation": false,
"OriginalPosition": [
-123.1181051,
49.282423
],
"Position": [
-123.1180883,
49.2824349
]
}
},
"Incidents": [],
"Notices": [],
"PassThroughWaypoints": [],
"Spans": [],
"Tolls": [],
"TollSystems": [],
"TravelSteps": [
{
"Distance": 1288,
"Duration": 102,
"ExitNumber": [],
"GeometryOffset": 0,
"Type": "Depart"
},
{
"Distance": 262,
"Duration": 24,
"ExitNumber": [],
"GeometryOffset": 37,
"RampStepDetails": {
"Intersection": [],
"SteeringDirection": "Right"
},
"Type": "Ramp"
},
{
"Distance": 1356,
"Duration": 134,
"ExitNumber": [],
"GeometryOffset": 42,
"TurnStepDetails": {
"Intersection": [],
"SteeringDirection": "Right",
"TurnIntensity": "Typical"
},
"Type": "Turn"
},
{
"Distance": 7092,
"Duration": 568,
"ExitNumber": [],
"GeometryOffset": 92,
"KeepStepDetails": {
"Intersection": [],
"SteeringDirection": "Left"
},
"Type": "Keep"
},
{
"Distance": 65,
"Duration": 26,
"ExitNumber": [],
"GeometryOffset": 337,
"TurnStepDetails": {
"Intersection": [],
"SteeringDirection": "Left",
"TurnIntensity": "Typical"
},
"Type": "Turn"
},
{
"Distance": 50,
"Duration": 18,
"ExitNumber": [],
"GeometryOffset": 339,
"TurnStepDetails": {
"Intersection": [],
"SteeringDirection": "Right",
"TurnIntensity": "Typical"
},
"Type": "Turn"
},
{
"Distance": 0,
"Duration": 0,
"ExitNumber": [],
"GeometryOffset": 343,
"Type": "Arrive"
}
],
"TruckRoadTypes": [],
"Zones": []
}
}
],
"MajorRoadLabels": [
{
"RouteNumber": {
"Language": "en",
"Value": "HWY-1A"
}
}
]
}
]
}
```
------
#### [ cURL ]
```
curl --request POST \
--url 'https://routes.geo.eu-central-1.amazonaws.com/v2/routes?key=Your_key' \
--header 'Content-Type: application/json' \
--data '{
"Origin": [
-123.118105,
49.282423
],
"Destination": [
-123.020098,
49.232872
],
"TravelMode": "Car",
"OptimizeRoutingFor": "FastestRoute"
}'
```
------
#### [ AWS CLI ]
```
aws geo-routes calculate-routes --key ${YourKey} \
--origin -123.118105 49.282423 \
--destination -123.020098 49.232872 \
--travel-mode "Car" \
--optimize-routing-for "FastestRoute"
```
------
# Como encontrar as rotas mais curtas
A API CalculateRoutes ajuda você a encontrar as rotas mais curtas entre a origem e o destino.
## Casos de uso possíveis
+ **Otimizar as rotas para eficiência de tempo:** melhore as operações de entrega calculando a rota mais curta. É útil para reduzir a distância de viagem nos serviços de logística e entrega.
## Exemplos
### Use CalculateRoutes para encontrar a rota mais curta e economizar na distância percorrida.
------
#### [ Sample request ]
```
{
"Origin": [
-123.118105,
49.282423
],
"Destination": [
-123.020098,
49.232872
],
"TravelMode": "Car",
"OptimizeRoutingFor": "ShortestRoute"
}
```
------
#### [ Sample response ]
```
{
"LegGeometryFormat": "FlexiblePolyline",
"Notices": [],
"Routes": [
{
"Legs": [
{
"Geometry": {
"Polyline": "Redacted"
},
"TravelMode": "Car",
"Type": "Vehicle",
"VehicleLegDetails": {
"AfterTravelSteps": [],
"Arrival": {
"Place": {
"ChargingStation": false,
"OriginalPosition": [
-123.020098,
49.232872
],
"Position": [
-123.0203051,
49.2328499
]
}
},
"Departure": {
"Place": {
"ChargingStation": false,
"OriginalPosition": [
-123.1181051,
49.282423
],
"Position": [
-123.1180883,
49.2824349
]
}
},
"Incidents": [],
"Notices": [],
"PassThroughWaypoints": [],
"Spans": [],
"Tolls": [],
"TollSystems": [],
"TravelSteps": [
{
"Distance": 1288,
"Duration": 102,
"ExitNumber": [],
"GeometryOffset": 0,
"Type": "Depart"
},
{
"Distance": 262,
"Duration": 24,
"ExitNumber": [],
"GeometryOffset": 37,
"RampStepDetails": {
"Intersection": [],
"SteeringDirection": "Right"
},
"Type": "Ramp"
},
{
"Distance": 1356,
"Duration": 134,
"ExitNumber": [],
"GeometryOffset": 42,
"TurnStepDetails": {
"Intersection": [],
"SteeringDirection": "Right",
"TurnIntensity": "Typical"
},
"Type": "Turn"
},
{
"Distance": 7092,
"Duration": 568,
"ExitNumber": [],
"GeometryOffset": 92,
"KeepStepDetails": {
"Intersection": [],
"SteeringDirection": "Left"
},
"Type": "Keep"
},
{
"Distance": 65,
"Duration": 26,
"ExitNumber": [],
"GeometryOffset": 337,
"TurnStepDetails": {
"Intersection": [],
"SteeringDirection": "Left",
"TurnIntensity": "Typical"
},
"Type": "Turn"
},
{
"Distance": 50,
"Duration": 18,
"ExitNumber": [],
"GeometryOffset": 339,
"TurnStepDetails": {
"Intersection": [],
"SteeringDirection": "Right",
"TurnIntensity": "Typical"
},
"Type": "Turn"
},
{
"Distance": 0,
"Duration": 0,
"ExitNumber": [],
"GeometryOffset": 343,
"Type": "Arrive"
}
],
"TruckRoadTypes": [],
"Zones": []
}
}
],
"MajorRoadLabels": [
{
"RouteNumber": {
"Language": "en",
"Value": "HWY-1A"
}
}
]
}
]
}
```
------
#### [ cURL ]
```
curl --request POST \
--url 'https://routes.geo.eu-central-1.amazonaws.com/v2/routes?key=Your_key' \
--header 'Content-Type: application/json' \
--data '{
"Origin": [
-123.118105,
49.282423
],
"Destination": [
-123.020098,
49.232872
],
"TravelMode": "Car",
"OptimizeRoutingFor": "ShortestRoute"
}'
```
------
#### [ AWS CLI ]
```
aws geo-routes calculate-routes --key ${YourKey} \
--origin -123.118105 49.282423 \
--destination -123.020098 49.232872 \
--travel-mode "Scooter" \
--optimize-routing-for "ShortestRoute"
```
------
# Saiba como usar o CalculateIsolines
Nesta seção, você vai aprender a usar `CalculateIsolines` com intervalos de tempo ou distância, bem como definir áreas que devem ser evitadas.
**Topics**
+ [Como calcular uma área de serviço com base em intervalos de tempo](calculate-service-area-based-on-time.md)
+ [Como calcular uma área de serviço com base em intervalos de distância](calculate-service-area-based-on-distance.md)
+ [Como calcular uma área de serviço com base na evasão](calculate-service-area-based-on-avoidance.md)
# Como calcular uma área de serviço com base em intervalos de tempo
A API CalculateIsolines permite que você determine áreas de serviço acessíveis dentro de intervalos de tempo ou distância especificados, considerando as redes rodoviárias e as condições de tráfego. Essa funcionalidade auxilia as aplicações a definir áreas de serviço para restaurantes, mercados ou outros prestadores de serviços que podem ajudar no planejamento da eficiência de combustível e na definição de áreas acessíveis para cobertura de serviços.
## Casos de uso possíveis
+ **Planejar áreas de serviço:** use essa API para planejar áreas acessíveis para serviços como entrega de restaurantes ou mercados com base em tempo de viagem ou distância.
## Exemplos
### Calcular uma área de serviço com base em intervalo de tempo com TravelMode Carro
------
#### [ Sample request ]
```
{
"Origin": [
-123.11679620827039,
49.28147612192166
],
"DepartureTime": "2024-10-28T21:27:56Z",
"Thresholds": {
"Time": [
500,
1000,
1500
]
},
"TravelMode": "Car"
}
```
------
#### [ Sample response ]
```
{
"DepartureTime": "2024-10-28T14:27:56-07:00",
"IsolineGeometryFormat": "FlexiblePolyline",
"Isolines": [
{
"Connections": [],
"Geometries": [
{
"PolylinePolygon": [
"Redacted"
]
}
],
"TimeThreshold": 500
},
{
"Connections": [],
"Geometries": [
{
"PolylinePolygon": [
"Redacted"
]
}
],
"TimeThreshold": 1000
},
{
"Connections": [],
"Geometries": [
{
"PolylinePolygon": [
"Redacted"
]
}
],
"TimeThreshold": 1500
}
],
"SnappedOrigin": [
-123.11687,
49.2813999
]
}
```
------
#### [ cURL ]
```
curl --request POST \
--url 'https://routes.geo.eu-central-1.amazonaws.com/v2/isolines?key=Your_key' \
--header 'Content-Type: application/json' \
--data '{
"Origin": [
-123.11679620827039,
49.28147612192166
],
"DepartureTime": "2024-10-28T21:27:56Z",
"Thresholds": {
"Time": [
500,
1000,
1500
]
},
"TravelMode": "Car"
}'
```
------
#### [ AWS CLI ]
```
aws geo-routes calculate-isolines --key ${YourKey} \
--origin -123.11679620827039 49.28147612192166 \
--departure-time "2024-10-28T21:27:56Z" \
--thresholds '{"Time": [500, 1000, 1500]}' \
--travel-mode "Car"
```
------
# Como calcular uma área de serviço com base em intervalos de distância
A API CalculateIsolines permite que você determine áreas de serviço acessíveis dentro de intervalos de tempo ou distância especificados, considerando as redes rodoviárias e as condições de tráfego. Essa funcionalidade auxilia as aplicações a definir áreas de serviço para restaurantes, mercados ou outros prestadores de serviços que podem ajudar no planejamento da eficiência de combustível e na definição de áreas acessíveis para cobertura de serviços.
## Casos de uso possíveis
+ **Planejar áreas de serviço:** use essa API para planejar áreas acessíveis para serviços como entrega de restaurantes ou mercados com base em tempo de viagem ou distância.
## Exemplos
### Calcular uma área de serviço com base em intervalos de distância com TravelMode Carro
------
#### [ Sample request ]
```
{
"Origin": [
-123.11679620827039,
49.28147612192166
],
"DepartureTime": "2024-10-28T21:27:56Z",
"Thresholds": {
"Distance": [
1000,
2000,
3000
]
},
"TravelMode": "Car"
}
```
------
#### [ Sample response ]
```
{
"DepartureTime": "2024-10-28T14:27:56-07:00",
"IsolineGeometryFormat": "FlexiblePolyline",
"Isolines": [
{
"Connections": [],
"DistanceThreshold": 1000,
"Geometries": [
{
"PolylinePolygon": [
"Redacted"
]
}
]
},
{
"Connections": [],
"DistanceThreshold": 2000,
"Geometries": [
{
"PolylinePolygon": [
"Redacted"
]
}
]
},
{
"Connections": [],
"DistanceThreshold": 3000,
"Geometries": [
{
"PolylinePolygon": [
"Redacted"
]
}
]
}
],
"SnappedOrigin": [
-123.11687,
49.2813999
]
}
```
------
#### [ cURL ]
```
curl --request POST \
--url 'https://routes.geo.eu-central-1.amazonaws.com/v2/isolines?key=Your_key' \
--header 'Content-Type: application/json' \
--data '{
"Origin": [
-123.11679620827039,
49.28147612192166
],
"DepartureTime": "2024-10-28T21:27:56Z",
"Thresholds": {
"Distance": [
1000,
2000,
3000
]
},
"TravelMode": "Car"
}'
```
------
#### [ AWS CLI ]
```
aws geo-routes calculate-isolines --key ${YourKey} \
--origin -123.11679620827039 49.28147612192166 \
--departure-time "2024-10-28T21:27:56Z" \
--thresholds '{"Distance": [1000, 2000, 3000]}' \
--travel-mode "Car"
```
------
# Como calcular uma área de serviço com base na evasão
A API CalculateIsolines permite que você determine áreas de serviço acessíveis dentro de intervalos de tempo ou distância especificados, considerando as redes rodoviárias e as condições de tráfego a serem evitadas. Essa funcionalidade auxilia as aplicações a definir áreas de serviço para restaurantes, mercados ou outros prestadores de serviços que podem ajudar no planejamento da eficiência de combustível e na definição de áreas acessíveis para cobertura de serviços.
## Casos de uso possíveis
+ **Planejar áreas de serviço:** use essa API para planejar áreas acessíveis para serviços como entrega de restaurantes ou mercados com base na evasão.
## Exemplos
### Calcular uma área de serviço com base na evasão com TravelMode Carro
------
#### [ Sample request ]
```
{
"Origin": [
-123.11679620827039,
49.28147612192166
],
"DepartureTime": "2024-10-28T21:27:56Z",
"Thresholds": {
"Distance": [
4000
]
},
"Avoid": {
"TollRoads": true,
"UTurns": true,
"ControlledAccessHighways": true,
"Ferries": true,
"DirtRoads": true,
"SeasonalClosure": true,
"CarShuttleTrains": true,
"TollTransponders": true,
"ZoneCategories": [
{
"Category": "Environmental"
}
]
},
"TravelMode": "Car"
}
```
------
#### [ Sample response ]
```
{
"DepartureTime": "2024-10-28T14:27:56-07:00",
"IsolineGeometryFormat": "FlexiblePolyline",
"Isolines": [
{
"Connections": [],
"DistanceThreshold": 4000,
"Geometries": [
{
"PolylinePolygon": [
"Redacted"
]
}
]
}
],
"SnappedOrigin": [
-123.11687,
49.2813999
]
}
```
------
#### [ cURL ]
```
curl --request POST \
--url 'https://routes.geo.eu-central-1.amazonaws.com/v2/isolines?key=Your_key' \
--header 'Content-Type: application/json' \
--data '{
"Origin": [
-123.11679620827039,
49.28147612192166
],
"DepartureTime": "2024-10-28T21:27:56Z",
"Thresholds": {
"Distance": [
4000
]
},
"Avoid": {
"TollRoads": true,
"UTurns": true,
"ControlledAccessHighways": true,
"Ferries": true,
"DirtRoads": true,
"SeasonalClosure": true,
"CarShuttleTrains": true,
"TollTransponders": true,
"ZoneCategories": [
{
"Category": "Environmental"
}
]
},
"TravelMode": "Car"
}'
```
------
#### [ AWS CLI ]
```
aws geo-routes calculate-isolines --key ${YourKey} \
--origin -123.11679620827039 49.28147612192166 \
--departure-time "2024-10-28T21:27:56Z" \
--thresholds '{"Distance": [4000]}' \
--avoid '{"TollRoads": true, "UTurns": true, "ControlledAccessHighways": true, "Ferries": true, "DirtRoads": true, "SeasonalClosure": true, "CarShuttleTrains": true, "TollTransponders": true, "ZoneCategories": [{"Category": "Environmental"}]}' \
--travel-mode "Car"
```
------
### Calcular uma área de serviço com base na evasão com TravelMode Caminhão
------
#### [ Sample request ]
```
{
"Origin": [
-123.11679620827039,
49.28147612192166
],
"DepartureTime": "2024-10-28T21:27:56Z",
"Thresholds": {
"Distance": [
4000
]
},
"Avoid": {
"TollRoads": true,
"UTurns": true,
"ControlledAccessHighways": true,
"Ferries": true,
"DirtRoads": true,
"SeasonalClosure": true,
"CarShuttleTrains": true,
"TollTransponders": true,
"ZoneCategories": [
{
"Category": "Environmental"
}
]
},
"TravelMode": "Truck"
}
```
------
#### [ Sample response ]
```
{
"DepartureTime": "2024-10-28T14:27:56-07:00",
"IsolineGeometryFormat": "FlexiblePolyline",
"Isolines": [
{
"Connections": [],
"DistanceThreshold": 4000,
"Geometries": [
{
"PolylinePolygon": [
"Redacted"
]
}
]
}
],
"SnappedOrigin": [
-123.11687,
49.2813999
]
}
```
------
#### [ cURL ]
```
curl --request POST \
--url 'https://routes.geo.eu-central-1.amazonaws.com/v2/isolines?key=Your_key' \
--header 'Content-Type: application/json' \
--data '{
"Origin": [
-123.11679620827039,
49.28147612192166
],
"DepartureTime": "2024-10-28T21:27:56Z",
"Thresholds": {
"Distance": [
4000
]
},
"Avoid": {
"TollRoads": true,
"UTurns": true,
"ControlledAccessHighways": true,
"Ferries": true,
"DirtRoads": true,
"SeasonalClosure": true,
"CarShuttleTrains": true,
"TollTransponders": true,
"ZoneCategories": [
{
"Category": "Environmental"
}
]
},
"TravelMode": "Truck"
}'
```
------
#### [ AWS CLI ]
```
aws geo-routes calculate-isolines --key ${YourKey} \
--origin -123.11679620827039 49.28147612192166 \
--departure-time "2024-10-28T21:27:56Z" \
--thresholds '{"Distance": [4000]}' \
--avoid '{"TollRoads": true, "UTurns": true, "ControlledAccessHighways": true, "Ferries": true, "DirtRoads": true, "SeasonalClosure": true, "CarShuttleTrains": true, "TollTransponders": true, "ZoneCategories": [{"Category": "Environmental"}]}' \
--travel-mode "Truck"
```
------
### Calcular uma área de serviço com base na evasão para pedestres
------
#### [ Sample request ]
```
{
"Origin": [
-123.11679620827039,
49.28147612192166
],
"DepartureTime": "2024-10-28T21:27:56Z",
"Thresholds": {
"Distance": [
4000
]
},
"Avoid": {
"TollRoads": true,
"ControlledAccessHighways": true,
"Ferries": true,
"DirtRoads": true,
"SeasonalClosure": true,
"CarShuttleTrains": true,
"TollTransponders": true,
"ZoneCategories": [
{
"Category": "Environmental"
}
]
},
"TravelMode": "Pedestrian"
}
```
------
#### [ Sample response ]
```
{
"DepartureTime": "2024-10-28T14:27:56-07:00",
"IsolineGeometryFormat": "FlexiblePolyline",
"Isolines": [
{
"Connections": [],
"DistanceThreshold": 4000,
"Geometries": [
{
"PolylinePolygon": [
"Redacted"
]
}
]
}
],
"SnappedOrigin": [
-123.11687,
49.2813999
]
}
```
------
#### [ cURL ]
```
curl --request POST \
--url 'https://routes.geo.eu-central-1.amazonaws.com/v2/isolines?key=Your_key' \
--header 'Content-Type: application/json' \
--data '{
"Origin": [
-123.11679620827039,
49.28147612192166
],
"DepartureTime": "2024-10-28T21:27:56Z",
"Thresholds": {
"Distance": [
4000
]
},
"Avoid": {
"TollRoads": true,
"ControlledAccessHighways": true,
"Ferries": true,
"DirtRoads": true,
"SeasonalClosure": true,
"CarShuttleTrains": true,
"TollTransponders": true,
"ZoneCategories": [
{
"Category": "Environmental"
}
]
},
"TravelMode": "Pedestrian"
}'
```
------
#### [ AWS CLI ]
```
aws geo-routes calculate-isolines --key ${YourKey} \
--origin -123.11679620827039 49.28147612192166 \
--departure-time "2024-10-28T21:27:56Z" \
--thresholds '{"Distance": [4000]}' \
--avoid '{"TollRoads": true, "ControlledAccessHighways": true, "Ferries": true, "DirtRoads": true, "SeasonalClosure": true, "CarShuttleTrains": true, "TollTransponders": true, "ZoneCategories": [{"Category": "Environmental"}]}' \
--travel-mode "Pedestrian"
```
------
### Calcular uma área de serviço com base na evasão com TravelMode Scooter
------
#### [ Sample request ]
```
{
"Origin": [
-123.11679620827039,
49.28147612192166
],
"DepartureTime": "2024-10-28T21:27:56Z",
"Thresholds": {
"Distance": [
4000
]
},
"Avoid": {
"TollRoads": true,
"ControlledAccessHighways": true,
"DifficultTurns": false,
"Ferries": true,
"DirtRoads": true,
"SeasonalClosure": true,
"CarShuttleTrains": true,
"TollTransponders": true,
"ZoneCategories": [
{
"Category": "Environmental"
}
]
},
"TravelMode": "Scooter"
}
```
------
#### [ Sample response ]
```
{
"DepartureTime": "2024-10-28T14:27:56-07:00",
"IsolineGeometryFormat": "FlexiblePolyline",
"Isolines": [
{
"Connections": [],
"DistanceThreshold": 4000,
"Geometries": [
{
"PolylinePolygon": [
"Redacted"
]
}
]
}
],
"SnappedOrigin": [
-123.11687,
49.2813999
]
}
```
------
#### [ cURL ]
```
curl --request POST \
--url 'https://routes.geo.eu-central-1.amazonaws.com/v2/isolines?key=Your_key' \
--header 'Content-Type: application/json' \
--data '{
"Origin": [
-123.11679620827039,
49.28147612192166
],
"DepartureTime": "2024-10-28T21:27:56Z",
"Thresholds": {
"Distance": [
4000
]
},
"Avoid": {
"TollRoads": true,
"ControlledAccessHighways": true,
"Ferries": true,
"DirtRoads": true,
"SeasonalClosure": true,
"CarShuttleTrains": true,
"TollTransponders": true,
"ZoneCategories": [
{
"Category": "Environmental"
}
]
},
"TravelMode": "Scooter"
}'
```
------
#### [ AWS CLI ]
```
aws geo-routes calculate-isolines --key ${YourKey} \
--origin -123.11679620827039 49.28147612192166 \
--departure-time "2024-10-28T21:27:56Z" \
--thresholds '{"Distance": [4000]}' \
--avoid '{"TollRoads": true, "ControlledAccessHighways": true, "Ferries": true, "DirtRoads": true, "SeasonalClosure": true, "CarShuttleTrains": true, "TollTransponders": true, "ZoneCategories": [{"Category": "Environmental"}]}' \
--travel-mode "Scooter"
```
------
# Saiba como usar o CalculateRouteMatrix
Nesta seção, você aprenderá a usar `CalculateRouteMatrix` para encontrar rotas eficientes para várias origens e destinos.
**Topics**
+ [Como calcular uma matriz de rota de distância e tempo para várias origens e destinos](calculate-route-matrix-distance.md)
+ [Como calcular a matriz de rotas com evasão](calculate-route-matrix-with-avoidance.md)
# Como calcular uma matriz de rota de distância e tempo para várias origens e destinos
A CalculateRouteMatrix API calcula rotas e fornece o tempo de viagem e a distância de viagem para cada combinação de origens e destinos. Esse recurso é útil para aplicações que exigem planejamento e otimização de rotas em vários locais.
A resposta inclui `Distance` em metros e `Duration` segundos para cada par origem-destino.
## Casos de uso possíveis
+ **Otimizar o planejamento de rotas:** use a matriz de rotas como entrada para o software de otimização de rotas para melhorar a eficiência do serviço e reduzir o tempo de viagem.
## Exemplos
### CalculateRouteMatrix com um limite de roteamento ilimitado
------
#### [ Sample request ]
```
{
"Origins": [
{
"Position": [-123.11679620827039, 49.28147612192166]
},
{
"Position": [-123.11179620827039, 49.3014761219]
}
],
"Destinations": [
{
"Position": [-123.112317039, 49.28897192166]
}
],
"DepartureTime": "2024-05-28T21:27:56Z",
"RoutingBoundary": {
"Unbounded": true
}
}
```
------
#### [ Sample response ]
```
{
"ErrorCount": 0,
"RouteMatrix": [
[
{
"Distance": 1907,
"Duration": 343
}
],
[
{
"Distance": 5629,
"Duration": 954
}
]
],
"RoutingBoundary": {
"Unbounded": true
}
}
```
------
#### [ cURL ]
```
curl --request POST \
--url 'https://routes.geo.eu-central-1.amazonaws.com/v2/route-matrix?key=Your_key' \
--header 'Content-Type: application/json' \
--data '{
"Origins": [
{
"Position": [-123.11679620827039, 49.28147612192166]
},
{
"Position": [-123.11179620827039, 49.3014761219]
}
],
"Destinations": [
{
"Position": [-123.112317039, 49.28897192166]
}
],
"DepartureTime": "2024-05-28T21:27:56Z",
"RoutingBoundary": {
"Unbounded": true
}
}'
```
------
#### [ AWS CLI ]
```
aws geo-routes calculate-route-matrix --key ${YourKey} \
--origins '[{"Position": [-123.11679620827039, 49.28147612192166]}, {"Position": [-123.11179620827039, 49.3014761219]}]' \
--destinations '[{"Position": [-123.11179620827039, 49.28897192166]}]' \
--departure-time "2024-05-28T21:27:56Z" \
--routing-boundary '{"Unbounded": true}'
```
------
### CalculateRouteMatrix com um limite de roteamento baseado em geometria
------
#### [ Sample request ]
```
{
"Origins": [
{
"Position": [-123.11679620827039, 49.28147612192166]
},
{
"Position": [-123.11179620827039, 49.3014761219]
}
],
"Destinations": [
{
"Position": [-123.112317039, 49.28897192166]
}
],
"DepartureTime": "2024-05-28T21:27:56Z",
"RoutingBoundary": {
"Geometry": {
"AutoCircle": {
"Margin": 10000,
"MaxRadius": 30000
}
}
}
}
```
------
#### [ Sample response ]
```
{
"ErrorCount": 0,
"RouteMatrix": [
[
{
"Distance": 1907,
"Duration": 344
}
],
[
{
"Distance": 5629,
"Duration": 950
}
]
],
"RoutingBoundary": {
"Geometry": {
"Circle": {
"Center": [
-123.1142962082704,
49.29147612191083
],
"Radius": 11127
}
},
"Unbounded": false
}
}
```
------
#### [ cURL ]
```
curl --request POST \
--url 'https://routes.geo.eu-central-1.amazonaws.com/v2/route-matrix?key=Your_key' \
--header 'Content-Type: application/json' \
--data '{
"Origins": [
{
"Position": [-123.11679620827039, 49.28147612192166]
},
{
"Position": [-123.11179620827039, 49.3014761219]
}
],
"Destinations": [
{
"Position": [-123.112317039, 49.28897192166]
}
],
"DepartureTime": "2024-05-28T21:27:56Z",
"RoutingBoundary": {
"Geometry": {
"AutoCircle": {
"Margin": 10000,
"MaxRadius": 30000
}
}
}
}'
```
------
#### [ AWS CLI ]
```
aws geo-routes calculate-route-matrix --key ${YourKey} \
--origins '[{"Position": [-123.11679620827039, 49.28147612192166]}, {"Position": [-123.11179620827039, 49.3014761219]}]' \
--destinations '[{"Position": [-123.11179620827039, 49.28897192166]}]' \
--departure-time "2024-05-28T21:27:56Z" \
--routing-boundary '{"Geometry": {"AutoCircle": {"Margin": 10000, "MaxRadius": 30000}}}'
```
------
# Como calcular a matriz de rotas com evasão
A CalculateRouteMatrix API calcula rotas e retorna o tempo e a distância de viagem de cada origem até cada destino nas listas especificadas. A resposta inclui `Distance` em metros e `Duration` segundos. A API pode ser usada para definir opções de evasão de áreas específicas ou características da estrada, garantindo que as rotas evitem zonas ou condições específicas. Se uma rota alternativa não for viável, a preferência de evasão poderá ser ignorada.
## Casos de uso possíveis
+ **Planejamento e otimização de rotas:** use a matriz de rotas como entrada para um software que requer rotas de viagem otimizadas, evitando determinadas áreas ou características da estrada.
## Exemplos
### CalculateRouteMatrix com uma área de evitação
------
#### [ Sample request ]
```
{
"Origins": [
{
"Position": [-123.11679620827039, 49.28147612192166]
}
],
"Destinations": [
{
"Position": [-123.112317039, 49.28897192166]
}
],
"Avoid": {
"Areas": [
{
"Geometry": {
"BoundingBox": [
-123.116561,
49.281517,
-123.110165,
49.285689
]
}
}
]
},
"RoutingBoundary": {
"Unbounded": true
}
}
```
------
#### [ Sample response ]
```
{
"ErrorCount": 0,
"RouteMatrix": [
[
{
"Distance": 1855,
"Duration": 295
}
]
],
"RoutingBoundary": {
"Unbounded": true
}
}
```
------
#### [ cURL ]
```
curl --request POST \
--url 'https://routes.geo.eu-central-1.amazonaws.com/v2/route-matrix?key=Your_key' \
--header 'Content-Type: application/json' \
--data '{
"Origins": [
{
"Position": [-123.11679620827039, 49.28147612192166]
}
],
"Destinations": [
{
"Position": [-123.112317039, 49.28897192166]
}
],
"Avoid": {
"Areas": [
{
"Geometry": {
"BoundingBox": [
-123.116561,
49.281517,
-123.110165,
49.285689
]
}
}
]
},
"RoutingBoundary": {
"Unbounded": true
}
}'
```
------
#### [ AWS CLI ]
```
aws geo-routes calculate-route-matrix --key ${YourKey} \
--origins '[{"Position": [-123.11679620827039, 49.28147612192166]}]' \
--destinations '[{"Position": [-123.112317039, 49.28897192166]}]' \
--avoid '{"Areas": [{"Geometry": {"BoundingBox": [-123.116561, 49.281517, -123.110165, 49.285689]}}]}' \
--routing-boundary '{"Unbounded": true}'
```
------
### CalculateRouteMatrix evitando estradas com pedágio, rodovias e balsas
------
#### [ Sample request ]
```
{
"Origins": [
{
"Position": [-123.11679620827039, 49.28147612192166]
}
],
"Destinations": [
{
"Position": [-123.112317039, 49.28897192166]
}
],
"Avoid": {
"TollRoads": true,
"ControlledAccessHighways": true,
"Ferries": true
},
"RoutingBoundary": {
"Unbounded": true
}
}
```
------
#### [ Sample response ]
```
{
"ErrorCount": 0,
"RouteMatrix": [
[
{
"Distance": 1855,
"Duration": 295
}
]
],
"RoutingBoundary": {
"Unbounded": true
}
}
```
------
#### [ cURL ]
```
curl --request POST \
--url 'https://routes.geo.eu-central-1.amazonaws.com/v2/route-matrix?key=Your_key' \
--header 'Content-Type: application/json' \
--data '{
"Origins": [
{
"Position": [-123.11679620827039, 49.28147612192166]
}
],
"Destinations": [
{
"Position": [-123.112317039, 49.28897192166]
}
],
"Avoid": {
"TollRoads": true,
"ControlledAccessHighways": true,
"Ferries": true
},
"RoutingBoundary": {
"Unbounded": true
}
}'
```
------
#### [ AWS CLI ]
```
aws geo-routes calculate-route-matrix --key ${YourKey} \
--origins '[{"Position": [-123.11679620827039, 49.28147612192166]}]' \
--destinations '[{"Position": [-123.112317039, 49.28897192166]}]' \
--avoid '{"TollRoads": true, "ControlledAccessHighways": true, "Ferries": true}' \
--routing-boundary '{"Unbounded": true}'
```
------
# Saiba como usar OptimizeWaypoints
Saiba como usar a `OptimizeWaypoints` para encontrar as melhores rotas para minimizar o tempo ou a distância de viagem.
**Topics**
+ [Como otimizar pontos de referência para uma rota](optimize-waypoints.md)
+ [Como otimizar pontos de referência para uma rota com reconhecimento de tráfego](optimize-waypoints-traffic-awareness.md)
+ [Como otimizar pontos de referência para uma rota com reconhecimento do horário de acesso](optimize-waypoints-access-hours.md)
# Como otimizar pontos de referência para uma rota
A API OptimizeWaypoints também calcula a rota ideal entre uma série de pontos de referência, minimizando o tempo de viagem ou a distância total percorrida. Essa API resolve o problema do vendedor ambulante considerando as redes rodoviárias e as condições do tráfego para determinar o caminho ideal.
## Casos de uso possíveis
+ **Analise os padrões da área de serviço:** use a otimização de pontos de referência para tomar decisões informadas sobre as áreas de serviços comerciais e melhorar a eficiência logística.
## Exemplos
### Otimizar pontos de referência usando o TravelMode Carro
------
#### [ Sample Request ]
```
{
"Origin": [
-123.095740,
49.274426
],
"Waypoints": [
{
"Position": [
-123.115193,
49.280596
]
},
{
"Position": [
-123.089557,
49.271774
]
}
],
"DepartureTime": "2024-10-25T18:13:42Z",
"Destination": [
-123.095185,
49.263728
],
"TravelMode": "Car"
}
```
------
#### [ Sample Response ]
```
{
"Connections": [
{
"Distance": 1989,
"From": "Origin",
"RestDuration": 0,
"To": "Waypoint0",
"TravelDuration": 258,
"WaitDuration": 0
},
{
"Distance": 3010,
"From": "Waypoint0",
"RestDuration": 0,
"To": "Waypoint1",
"TravelDuration": 298,
"WaitDuration": 0
},
{
"Distance": 2371,
"From": "Waypoint1",
"RestDuration": 0,
"To": "Destination",
"TravelDuration": 311,
"WaitDuration": 0
}
],
"Distance": 7370,
"Duration": 867,
"ImpedingWaypoints": [],
"OptimizedWaypoints": [
{
"DepartureTime": "2024-10-25T18:13:42Z",
"Id": "Origin",
"Position": [
-123.09574,
49.274426
]
},
{
"DepartureTime": "2024-10-25T18:18:00Z",
"Id": "Waypoint0",
"Position": [
-123.115193,
49.280596
]
},
{
"DepartureTime": "2024-10-25T18:22:58Z",
"Id": "Waypoint1",
"Position": [
-123.089557,
49.271774
]
},
{
"ArrivalTime": "2024-10-25T18:28:09Z",
"Id": "Destination",
"Position": [
-123.095185,
49.263728
]
}
],
"TimeBreakdown": {
"RestDuration": 0,
"ServiceDuration": 0,
"TravelDuration": 867,
"WaitDuration": 0
}
}
```
------
#### [ cURL ]
```
curl --request POST \
--url 'https://routes.geo.eu-central-1.amazonaws.com/v2/optimize-waypoints?key=Your_key' \
--header 'Content-Type: application/json' \
--data '{
"Origin": [
-123.095740,
49.274426
],
"Waypoints": [
{
"Position": [
-123.115193,
49.280596
]
},
{
"Position": [
-123.089557,
49.271774
]
}
],
"DepartureTime": "2024-10-25T18:13:42Z",
"Destination": [
-123.095185,
49.263728
],
"TravelMode": "Car"
}'
```
------
#### [ AWS CLI ]
```
aws geo-routes optimize-waypoints --key ${YourKey} \
--origin -123.095740 49.274426 \
--waypoints '[{"Position": [-123.115193 , 49.280596]}, {"Position": [-123.089557 , 49.271774]}]' \
--destination -123.095185 49.263728 \
--departure-time "2024-10-25T18:13:42Z" \
--travel-mode "Car"
```
------
# Como otimizar pontos de referência para uma rota com reconhecimento de tráfego
A OptimizeWaypoints API calcula a rota ideal entre vários pontos de referência para minimizar o tempo de viagem ou a distância total. Ela utiliza algoritmos avançados para resolver o problema do vendedor ambulante de determinar o caminho mais eficiente, levando em consideração fatores como a rede viária e as condições do tráfego.
## Casos de uso possíveis
+ **Otimize rotas com várias paradas para eficiência de entrega:** melhore as operações de entrega calculando a rota mais curta ou mais rápida entre várias paradas. Isso é útil para reduzir os custos operacionais, o consumo de combustível e o tempo de viagem nos serviços de logística e entrega.
## Exemplos
### Otimize pontos de passagem com reconhecimento de tráfego usando o carro TravelMode
------
#### [ Sample request ]
```
{
"Origin": [
-123.095740,
49.274426
],
"Waypoints": [
{
"Position": [
-123.115193,
49.280596
]
},
{
"Position": [
-123.089557,
49.271774
]
}
],
"DepartureTime": "2024-10-25T18:13:42Z",
"Destination": [
-123.095185,
49.263728
],
"TravelMode": "Car",
"Traffic": {
"Usage": "UseTrafficData"
}
}
```
------
#### [ Sample response ]
```
{
"Connections": [
{
"Distance": 1989,
"From": "Origin",
"RestDuration": 0,
"To": "Waypoint0",
"TravelDuration": 324,
"WaitDuration": 0
},
{
"Distance": 2692,
"From": "Waypoint0",
"RestDuration": 0,
"To": "Waypoint1",
"TravelDuration": 338,
"WaitDuration": 0
},
{
"Distance": 2371,
"From": "Waypoint1",
"RestDuration": 0,
"To": "Destination",
"TravelDuration": 395,
"WaitDuration": 0
}
],
"Distance": 7052,
"Duration": 1057,
"ImpedingWaypoints": [],
"OptimizedWaypoints": [
{
"DepartureTime": "2024-10-25T18:13:42Z",
"Id": "Origin",
"Position": [
-123.09574,
49.274426
]
},
{
"ArrivalTime": "2024-10-25T18:19:06Z",
"DepartureTime": "2024-10-25T18:19:06Z",
"Id": "Waypoint0",
"Position": [
-123.115193,
49.280596
]
},
{
"ArrivalTime": "2024-10-25T18:24:44Z",
"DepartureTime": "2024-10-25T18:24:44Z",
"Id": "Waypoint1",
"Position": [
-123.089557,
49.271774
]
},
{
"ArrivalTime": "2024-10-25T18:31:19Z",
"Id": "Destination",
"Position": [
-123.095185,
49.263728
]
}
],
"TimeBreakdown": {
"RestDuration": 0,
"ServiceDuration": 0,
"TravelDuration": 1057,
"WaitDuration": 0
}
}
```
------
#### [ cURL ]
```
curl --request POST \
--url 'https://routes.geo.eu-central-1.amazonaws.com/v2/optimize-waypoints?key=Your_key' \
--header 'Content-Type: application/json' \
--data '{
"Origin": [
-123.095740,
49.274426
],
"Waypoints": [
{
"Position": [
-123.115193,
49.280596
]
},
{
"Position": [
-123.089557,
49.271774
]
}
],
"DepartureTime": "2024-10-25T18:13:42Z",
"Destination": [
-123.095185,
49.263728
],
"TravelMode": "Car",
"Traffic": {
"Usage": "UseTrafficData"
}
}'
```
------
#### [ AWS CLI ]
```
aws geo-routes optimize-waypoints --key ${YourKey} \
--origin -123.095740 49.274426 \
--waypoints '[{"Position": [-123.115193 , 49.280596]}, {"Position": [-123.089557 , 49.271774]}]' \
--destination -123.095185 49.263728 \
--departure-time "2024-10-25T18:13:42Z" \
--travel-mode "Car" \
--traffic '{"Usage": "UseTrafficData"}'
```
------
# Como otimizar pontos de referência para uma rota com reconhecimento do horário de acesso
A API OptimizeWaypoints também calcula a rota ideal entre um conjunto de pontos de referência, com o objetivo de minimizar o tempo de viagem ou a distância total percorrida. Ela resolve o problema do vendedor ambulante de determinar o caminho mais eficiente, levando em consideração fatores como a rede viária e as condições do tráfego.
## Casos de uso possíveis
+ **Analise o horário de acesso do cliente:** planeje a eficiência em torno do horário de acesso do cliente.
## Exemplos
### Otimizar pontos de referência com reconhecimento de horas de acesso usando o TravelMode Carro
------
#### [ Sample Request ]
```
{
"Origin": [
-123.095740,
49.274426
],
"Waypoints": [
{
"Position": [
-123.115193,
49.280596
],
"SideOfStreet": {
"Position": [
-123.089557,
49.271774
],
"UseWith": "AnyStreet"
},
"AccessHours": {
"From": {
"DayOfWeek": "Saturday",
"TimeOfDay": "00:02:42Z"
},
"To": {
"DayOfWeek": "Friday",
"TimeOfDay": "1:33:36+02:50"
}
},
"Heading": "250",
"ServiceDuration": "200"
},
{
"Position": [
-123.089557,
49.271774
],
"AccessHours": {
"From": {
"DayOfWeek": "Monday",
"TimeOfDay": "00:02:42Z"
},
"To": {
"DayOfWeek": "Tuesday",
"TimeOfDay": "1:33:36+02:50"
}
},
"ServiceDuration": "200"
}
],
"DepartureTime": "2024-10-25T18:13:42Z",
"Destination": [
-123.095185,
49.263728
],
"TravelMode": "Car"
}
```
------
#### [ Sample Response ]
```
{
"Connections": [
{
"Distance": 1989,
"From": "Origin",
"RestDuration": 0,
"To": "Waypoint0",
"TravelDuration": 258,
"WaitDuration": 20682
},
{
"Distance": 3360,
"From": "Waypoint0",
"RestDuration": 0,
"To": "Waypoint1",
"TravelDuration": 378,
"WaitDuration": 172222
},
{
"Distance": 2371,
"From": "Waypoint1",
"RestDuration": 0,
"To": "Destination",
"TravelDuration": 311,
"WaitDuration": 0
}
],
"Distance": 7720,
"Duration": 194251,
"ImpedingWaypoints": [],
"OptimizedWaypoints": [
{
"DepartureTime": "2024-10-25T18:13:42Z",
"Id": "Origin",
"Position": [
-123.09574,
49.274426
]
},
{
"ArrivalTime": "2024-10-25T18:18:00Z",
"DepartureTime": "2024-10-26T00:06:02Z",
"Id": "Waypoint0",
"Position": [
-123.115193,
49.280596
]
},
{
"ArrivalTime": "2024-10-26T00:12:20Z",
"DepartureTime": "2024-10-28T00:06:02Z",
"Id": "Waypoint1",
"Position": [
-123.089557,
49.271774
]
},
{
"ArrivalTime": "2024-10-28T00:11:13Z",
"Id": "Destination",
"Position": [
-123.095185,
49.263728
]
}
],
"TimeBreakdown": {
"RestDuration": 0,
"ServiceDuration": 400,
"TravelDuration": 947,
"WaitDuration": 192904
}
}
```
------
#### [ cURL ]
```
curl --request POST \
--url 'https://routes.geo.eu-central-1.amazonaws.com/v2/optimize-waypoints?key=Your_key' \
--header 'Content-Type: application/json' \
--data '{
"Origin": [
-123.095740,
49.274426
],
"Waypoints": [
{
"Position": [
-123.115193,
49.280596
],
"SideOfStreet": {
"Position": [
-123.089557,
49.271774
],
"UseWith": "AnyStreet"
},
"AccessHours": {
"From": {
"DayOfWeek": "Saturday",
"TimeOfDay": "00:02:42Z"
},
"To": {
"DayOfWeek": "Friday",
"TimeOfDay": "1:33:36+02:50"
}
},
"Heading": "250",
"ServiceDuration": "200"
},
{
"Position": [
-123.089557,
49.271774
],
"AccessHours": {
"From": {
"DayOfWeek": "Monday",
"TimeOfDay": "00:02:42Z"
},
"To": {
"DayOfWeek": "Tuesday",
"TimeOfDay": "1:33:36+02:50"
}
},
"ServiceDuration": "200"
}
],
"DepartureTime": "2024-10-25T18:13:42Z",
"Destination": [
-123.095185,
49.263728
],
"TravelMode": "Car"
}'
```
------
#### [ AWS CLI ]
```
aws geo-routes optimize-waypoints --key ${YourKey} \
--origin -123.095740 49.274426 \
--waypoints '[{"Position": [-123.115193 , 49.280596], "SideOfStreet": {"Position": [-123.089557, 49.271774], "UseWith": "AnyStreet"}, "AccessHours": {"From": {"DayOfWeek": "Saturday", "TimeOfDay": "00:02:42Z"}, "To": {"DayOfWeek": "Friday", "TimeOfDay": "1:33:36+02:50"}}, "Heading": 250, "ServiceDuration": 200}, {"Position": [-123.089557, 49.271774], "AccessHours": {"From": {"DayOfWeek": "Monday", "TimeOfDay": "00:02:42Z"}, "To": {"DayOfWeek": "Tuesday", "TimeOfDay": "1:33:36+02:50"}}, "ServiceDuration": 200}]' \
--destination -123.095185 49.263728 \
--departure-time "2024-10-25T18:13:42Z" \
--travel-mode "Car"
```
------
# Saber como usar a SnapToRoads
Este tópico explica como usar `SnapToRoads` para alinhar rastreamentos de GPS com redes rodoviárias, aprimorando a precisão posicional para aplicativos de navegação e gerenciamento de frotas. Essa API corrige a perda de sinal e o desvio do GPS quando se insere as coordenadas nos segmentos de estrada mais próximos, ao mesmo tempo que respeita as restrições do modo de viagem. Os exemplos ilustram usos práticos, como sobrepor rastreamentos de GPS, preencher lacunas de dados e reduzir o ruído para uma visualização mais clara da rota.
**Topics**
+ [Como associar traços do GPS a uma rede rodoviária](how-to-match-gps-traces.md)
# Como associar traços do GPS a uma rede rodoviária
A API SnapToRoads permite associar traços de GPS à rede rodoviária. Um traço de GPS inclui posições e metadados, como data e hora, velocidade e direção, que são registrados usando um dispositivo GPS. Esses traços geralmente têm uma margem de erro, o que os torna difíceis de usar diretamente para análise e visualização.
O SnaptoRoads considera as restrições legais e de tempo para o modo de viagem especificado ao associar os traços. Se o traço sugerir fortemente uma violação da restrição, a rota real percorrida será mantida.
## Casos de uso possíveis
+ **Sobrepor traços de GPS nas estradas com maior probabilidade de circulação:** esse atributo ajuda a alinhar os dados de GPS ao caminho mais preciso na rede rodoviária, oferecendo uma visualização mais clara dos dados.
+ **Interpolar falhas nos traços de GPS:** o SnapToRoads pode preencher falhas inserindo coordenadas em segmentos de estradas, criando um conjunto de dados mais contínuo e útil para aplicações.
+ **Filtrar ruídos e discrepâncias:** ao ajustar à estrada mais próxima, essa API pode ajudar a remover discrepâncias e reduzir o ruído do GPS, melhorando a confiabilidade dos dados para análise.
## Exemplos
### Associar o traço de GPS usando o modo carro
------
#### [ Sample request ]
```
{
"TracePoints": [
{
"Position": [8.53404,50.16364],
"Timestamp": "2024-05-22T18:13:42Z"
},
{
"Position": [8.53379056,50.16352417],
"Speed": 20,
"Timestamp": "2024-05-22T18:13:59Z"
}
],
"TravelMode": "Car"
}
```
------
#### [ Sample response ]
```
{
"Notices": [],
"SnappedGeometry": {
"Polyline": "Redacted"
},
"SnappedGeometryFormat": "FlexiblePolyline",
"SnappedTracePoints": [
{
"Confidence": 1,
"OriginalPosition": [8.53404, 50.16364],
"SnappedPosition": [8.53402, 50.16367]
},
{
"Confidence": 0.86,
"OriginalPosition": [8.53379056, 50.16352417],
"SnappedPosition": [8.53375, 50.16356]
}
]
}
```
------
#### [ cURL ]
```
curl --request POST \
--url 'https://routes.geo.eu-central-1.amazonaws.com/v2/snap-to-roads?key=Your_key' \
--header 'Content-Type: application/json' \
--data '{
"TracePoints": [
{
"Position": [8.53404,50.16364],
"Timestamp": "2024-05-22T18:13:42Z"
},
{
"Position": [8.53379056,50.16352417],
"Speed": 20,
"Timestamp": "2024-05-22T18:13:59Z"
}
],
"TravelMode": "Car"
}'
```
------
#### [ AWS CLI ]
```
aws geo-routes snap-to-roads --key ${YourKey} \
--trace-points '[{"Position": [8.53404, 50.16364], "Timestamp": "2024-05-22T18:13:42Z"}, {"Position": [8.53379056, 50.16352417], "Speed": 20, "Timestamp": "2024-05-22T18:13:59Z"}]' \
--travel-mode "Car"
```
------
### Associar o traço de GPS usando o modo caminhão com opções
------
#### [ Sample request ]
```
{
"TracePoints": [
{
"Position": [8.53404,50.16364],
"Timestamp": "2024-05-22T18:13:42Z"
},
{
"Position": [8.53379056,50.16352417],
"Speed": 20,
"Timestamp": "2024-05-22T18:13:59Z"
}
],
"TravelMode": "Truck",
"TravelModeOptions": {
"Truck": {
"GrossWeight": 10000
}
}
}
```
------
#### [ Sample response ]
```
{
"Notices": [],
"SnappedGeometry": {
"Polyline": "Redacted"
},
"SnappedGeometryFormat": "FlexiblePolyline",
"SnappedTracePoints": [
{
"Confidence": 1,
"OriginalPosition": [8.53404, 50.16364],
"SnappedPosition": [8.53402, 50.16367]
},
{
"Confidence": 0.86,
"OriginalPosition": [8.53379056, 50.16352417],
"SnappedPosition": [8.53375, 50.16356]
}
]
}
```
------
#### [ cURL ]
```
curl --request POST \
--url 'https://routes.geo.eu-central-1.amazonaws.com/v2/snap-to-roads?key=Your_key' \
--header 'Content-Type: application/json' \
--data '{
"TracePoints": [
{
"Position": [8.53404,50.16364],
"Timestamp": "2024-05-22T18:13:42Z"
},
{
"Position": [8.53379056,50.16352417],
"Speed": 20,
"Timestamp": "2024-05-22T18:13:59Z"
}
],
"TravelMode": "Truck",
"TravelModeOptions": {
"Truck": {
"GrossWeight": 10000
}
}
}'
```
------
#### [ AWS CLI ]
```
aws geo-routes snap-to-roads --key ${YourKey} \
--trace-points '[{"Position": [8.53404, 50.16364], "Timestamp": "2024-05-22T18:13:42Z"}, {"Position": [8.53379056, 50.16352417], "Speed": 20, "Timestamp": "2024-05-22T18:13:59Z"}]' \
--travel-mode "Truck" \
--travel-mode-options '{"Truck": {"GrossWeight": 10000}}'
```
------
# Gerenciar custos e uso
À medida que você continua aprendendo sobre as rotas do Amazon Location, é importante entender como gerenciar a capacidade do serviço, garantir que você siga os limites de uso e obter os melhores resultados por meio de otimizações de cotas e APIs. Quando aplica as práticas recomendadas de desempenho e precisão, você pode personalizar o aplicativo para lidar com consultas relacionadas ao local de forma eficiente e maximizar as solicitações de API.
**Topics**
+ [Práticas recomendadas](routes-best-practices.md)
+ [Preços de rotas](routes-pricing.md)
+ [Uso e cota de rotas](routes-quota-usage.md)
# Práticas recomendadas
Esta seção aborda as práticas recomendadas para usar a compactação e escolher entre os formatos Simple (GeoJSON) e FlexiblePolyline quando for interagir com a API, fornecendo orientação sobre como otimizar o desempenho, a largura de banda e o tratamento de dados.
## Compactação
Para melhorar o desempenho e a eficiência de seus aplicativos quando for interagir com nossa API, é recomendável ativar a compactação para respostas, especialmente quando for lidar com grandes cargas úteis baseadas em texto. Você pode ativar a compactação incluindo o cabeçalho `Accept-Encoding` em suas solicitações de API, especificando seu método de compactação preferido. Fornecemos suporte aos formatos `gzip` e `deflate` para fins de compressão, sendo que o `gzip` normalmente apresenta taxas de compressão melhores.
### Quando ativar a compactação
**Grandes respostas**
Ative a compactação para grandes respostas baseadas em texto para reduzir o uso da largura de banda e melhorar os tempos de carregamento.
**Restrições de rede**
Se seu aplicativo opera em redes de largura de banda limitada ou de alta latência, a compactação pode aumentar a eficiência da transferência de dados.
### Como usar a compactação de forma eficaz
**Definir o cabeçalho Accept-Encoding**
Inclua `Accept-Encoding: gzip, deflate` em suas solicitações HTTP para informar à nossa API que você oferece suporte a esses métodos de compactação. O método para ativar e lidar com a compactação varia de acordo com o [AWS SDK](https://docs.aws.amazon.com/sdkref/latest/guide/overview.html) e a linguagem de programação. Por exemplo, o [AWS SDK para Java](https://docs.aws.amazon.com/AWSJavaSDK/latest/javadoc/com/amazonaws/ClientConfiguration.html#withGzip-boolean-) v1 usa o método `withGzip` na classe `ClientConfiguration` para ativar o gzip enquanto o o AWS SDK para Go exige a adição de um middleware específico para o tratamento da compactação. Para outros SDKs, consulte o [Guia de referência do ASW SDK](https://docs.aws.amazon.com/sdkref/latest/guide/overview.html) para obter instruções detalhadas.
**Tratar a descompactação de forma adequada**
Certifique-se de que seu aplicativo cliente possa descompactar corretamente as respostas com base no cabeçalho `Content-Encoding` retornado pela nossa API.
**Testar e monitorar**
Avalie regularmente o impacto da compactação no desempenho do seu aplicativo, equilibrando os benefícios de tamanhos reduzidos de carga útil com qualquer sobrecarga adicional de CPU decorrente dos processos de descompactação.
## Linha poligonal
As práticas recomendadas para escolher entre os formatos Simple (GeoJSON) e FlexiblePolyline quando for interagir com nossa API, para otimizar o desempenho e a usabilidade de seus dados geoespaciais.
### Usar o formato Simple (GeoJSON)
**Legibilidade e padronização**
Use quando precisar de um formato amplamente reconhecido e legível por humanos para facilitar a depuração e a interoperabilidade com várias ferramentas geoespaciais.
**Precisão**
Escolha o formato Simple quando seu aplicativo precisar de alta precisão para coordenadas, pois o GeoJSON mantém a precisão decimal total sem perda.
**Menores conjuntos de dados**
O formato Simple é ideal quando se trabalha com conjuntos menores de dados de coordenadas, nos quais os benefícios de redução de tamanho da compactação são mínimos.
### Usar o formato FlexiblePolyline
**Redução do tamanho dos dados**
O FlexiblePolyline é ideal quando você precisa minimizar a quantidade de dados transmitidos, especialmente para grandes listas de coordenadas, aproveitando técnicas de compactação com perdas.
**Segurança de URL**
O FlexiblePolyline fornece uma string compacta e segura para URL que pode ser usada diretamente nos parâmetros de consulta sem codificação adicional.
**Otimização do desempenho**
O FlexiblePolyline ajuda a reduzir o tamanho da carga útil, levando a uma transferência de dados mais rápida e menor uso da largura de banda, tornando-o crucial para aplicativos de alto desempenho ou aqueles que operam em redes restritas.
# Preços de rotas
Veja abaixo os buckets de preços de cada API:
## Calcular rotas
O preço é baseado no número de solicitações de API. `CalculateRoutes` tem três categorias de preços: Core, Advanced e Premium.
**Core**
Esse bucket de preços fornece suporte aos modos de viagem Carro, Caminhão e Pedestre, sem cálculo do custo do pedágio.
**Advanced (Avançado)**
Esse bucket de preços fornece suporte a modos de viagem alternativos, como Scooter, sem cálculo do custo do pedágio.
**Premium**
Esse bucket de preços fornece suporte ao cálculo do custo do pedágio. Você será cobrado pelo preço Premium quando solicitar o cálculo do custo do pedágio definindo os parâmetros da solicitação `LegAdditionalFeatures["Tolls"]` ou`SpanAdditionalFeatures["TollSystems"]`, independentemente do modo de viagem.
## Calcular matriz de rotas
O preço é baseado no número de rotas calculadas. O número de rotas calculado em cada solicitação é igual ao número de origens multiplicado pelo número de destinos`Number of Routes = Number of origins x Number of Destinations`. Por exemplo, quando usar um tamanho de matriz de 300 origens por 100 destinos, o número total de rotas calculado é 30.000 (300 x 100 = 30.000).
**nota**
Os cálculos de rota são cobrados para cada par de origem e destino. Se você usar uma grande matriz de origens e destinos, seus custos aumentarão proporcionalmente.
`CalculateRouteMatrix` tem 2 categorias de preços: Core e Advanced.
**Core**
Esse bucket de preços fornece suporte aos modos de viagem Carro, Caminhão e Pedestre.
**Advanced (Avançado)**
Esse bucket de preços fornece suporte a modos de viagem alternativos, como Scooter.
## Otimizar ponto de referência
O preço é baseado no número de solicitações de API. `OptimizeWaypoint` tem dois buckets de preços: Advanced e Premium.
**Advanced (Avançado)**
Esse bucket de preços fornece suporte a até 30 pontos de referência em uma única solicitação; modos de viagem para Carro, Caminhão e Pedestre, com a caixa delimitadora dos pontos de entrada em 200 km e sem parâmetros opcionais, como `Avoid`, `Clustering`, `Driver`, `Exclude.Countries`, `TravelModeOptions.Truck.HazardousCargos`, `TravelModeOptions.Truck.TunnelRestrictionCode` e sem pontos de referência adicionais ou restrições de destino como `AccessHours`, `AppointmentTime`, `Before`, `Heading`, `ServiceDuration`, `SideOfStreet`.
O armazenamento em cluster automático pode ocorrer quando os pontos de referência estão próximos, mas ainda é considerado um bucket de preços avançado.
**Premium**
Esse bucket de preços fornece suporte a até 50 pontos de referência em uma única solicitação; sem restrições nos modos de viagem; caixa delimitadora dos pontos de entrada em 500 km; e com parâmetros opcionais, como `Avoid`, `Clustering`, `Driver`, `Exclude.Countries`, `TravelModeOptions.Truck.HazardousCargos`, `TravelModeOptions.Truck.TunnelRestrictionCode`. Além disso, esse bucket de preços fornece suporte a restrições opcionais de ponto de referência e destino, como `AccessHours`, `AppointmentTime`, `Before`, `Heading`, `ServiceDuration`, `SideOfStreet`.
Uma única solicitação só pode fornecer suporte a até 20 pontos de referência se alguma das restrições opcionais de ponto de referência e destino for aplicada.
## S nap-to-road
O preço é baseado no número de solicitações de API. `SnaptoRoad` tem dois buckets de preços: Core, Advanced e Premium.
**Advanced (Avançado)**
Esse bucket de preços suporta os modos de viagem Carro, Caminhão e Pedestre, com uma contagem de `TracePoints` de até 200 e com uma distância aérea máxima entre `TracePoints` de 100 quilômetros.
**Premium**
Esse bucket de preços não tem restrições quanto nos modos de viagem, até 5.000 pontos de `TracePoints`.
## Calcular isolinhas
O preço é baseado no número de isolinhas calculadas na resposta. `CalculateIsolines` tem 2 buckets de preços: Advanced e Premium.
**Advanced (Avançado)**
Esse bucket de preços fornece suporte aos modos de viagem Carro, Caminhão e Pedestre, com valores de `Thresholds.Time` de até 60 minutos ou valores de `Thresholds.Distance` de até 100 quilômetros.
**Premium**
Essa bucket de preços não tem restrições nos modos de viagem, com valores de `Thresholds.Time` de até 180 minutos ou valores de `Thresholds.Distance` de até 300 km.
# Uso e cota de rotas
## Cota de serviço
O Amazon Location Service APIs tem cotas padrão. Aumente essas cotas usando o [console do das cotas de serviço](https://console.aws.amazon.com/servicequotas/home#!/services/geo/quotas). Para limites que excedam o dobro do padrão, solicite por meio do console de autoatendimento ou entre em contato com o suporte.
**Limites de cota de serviço**
| Nome da API | Padrão | Limite máximo ajustável | Mais do que o Limite máximo ajustável |
| --- | --- | --- | --- |
| [Calcular rotas](calculate-routes.md) | 20 | 40 | Solicitar no [console de cota de serviço](https://console.aws.amazon.com/servicequotas/home#!/services/geo/quotas) ou entre em contato com a equipe de suporte |
| [Calcular isolinhas](calculate-isolines.md) | 20 | 40 | Solicitar no [console de cota de serviço](https://console.aws.amazon.com/servicequotas/home#!/services/geo/quotas) ou entre em contato com a equipe de suporte |
| [Ajustar às estradas](snap-to-roads.md) | 20 | 40 | Solicitar no [console de cota de serviço](https://console.aws.amazon.com/servicequotas/home#!/services/geo/quotas) ou entre em contato com a equipe de suporte |
| [Calcular matriz de rotas](calculate-route-matrix.md) | 5 | 10 | Solicitar no [console de cota de serviço](https://console.aws.amazon.com/servicequotas/home#!/services/geo/quotas) ou entre em contato com a equipe de suporte |
| [Otimizar pontos de referência](actions-optimize-waypoints.md) | 5 | 10 | Solicitar no [console de cota de serviço](https://console.aws.amazon.com/servicequotas/home#!/services/geo/quotas) ou entre em contato com a equipe de suporte |
## Outros limites de uso
Além das cotas de serviço, os seguintes limites de uso da API se aplicam:
**Outros limites de uso**
| Nome da API | Limite | Valor |
| --- | --- | --- |
| [Ajustar às estradas](snap-to-roads.md) | Soma da distância geodésica entre todos TracePoints | 500 KM |
| [Otimizar pontos de referência](actions-optimize-waypoints.md) | Soma da distância geodésica entre a origem, os pontos de referência na ordem fornecida e o destino | 100 KM |
| [Otimizar pontos de referência](actions-optimize-waypoints.md) | Perímetro da caixa delimitadora ao redor da origem, dos pontos de referência e do destino | 500 KM |
| [Calcular matriz de rotas](calculate-route-matrix.md) | Distância máxima entre origens e destinos para roteamento ilimitado (se Avoid ou TravelModeOptions .Truck for usado) | 60 KM |
| [Calcular matriz de rotas](calculate-route-matrix.md) | Distância máxima entre origens e destinos para rotas ilimitadas | 10.000 KM |
| [Calcular rotas](calculate-routes.md) | Tamanho da carga útil de resposta após a compactação | 6 MB |
| [Calcular matriz de rotas](calculate-route-matrix.md) | Tamanho da carga útil de resposta após a compactação | 6 MB |
| [Calcular isolinhas](calculate-isolines.md) | Tamanho da carga útil de resposta após a compactação | 6 MB |
| [Otimizar pontos de referência](actions-optimize-waypoints.md) | Tamanho da carga útil de resposta após a compactação | 6 MB |
| [Ajustar às estradas](snap-to-roads.md) | Tamanho da carga útil de resposta após a compactação | 6 MB |
## Próximas etapas
Verifique o seguinte para obter mais detalhes:
+ [Atribuição](https://docs.aws.amazon.com/location/latest/developerguide/data-attribution.html): informações sobre os requisitos de atribuição de dados para o Amazon Location Service.
+ [SLA](https://aws.amazon.com/location/sla/): o contrato de nível de serviço do Amazon Location Service, incluindo compromissos de tempo de atividade e tempos de resposta.
+ [Termos de serviço](https://aws.amazon.com/service-terms/): termos que regem o uso do Amazon Location Service, incluindo restrições e limitações.