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á.
Calcule uma rota com a Amazon Location
Você pode usar o Amazon Location Service para calcular rotas entre uma origem e um destino, com até 23 pontos de referência ao longo da rota, para diferentes modos de transporte, evasões e condições de tráfego.
nota
Primeiro, você deve criar um recurso de calculadora de rotas e configurar a autenticação para suas solicitações para o Amazon Location. Para obter mais informações, consulte Pré-requisitos para calcular rotas usando o Amazon Location.
Começar a calcular rotas
Envie uma solicitação simples usando a operação CalculateRoute. Uma solicitação simples contém os seguintes campos obrigatórios:
-
DeparturePosition: a posição inicial a partir da qual calcular a rota. Definido como[longitude, latitude] -
DestinationPosition: a posição final para a qual calcular a rota. Definido como[longitude, latitude].
nota
Se você especificar uma posição de partida ou destino que não esteja localizada em uma estrada, o Amazon Location moverá a posição para a estrada mais próxima.
Opcionalmente, você pode especificar pontos de referência, um horário de partida e um modo de viagem em sua solicitação.
Você pode usar o AWS CLI ou o Amazon LocationAPIs.
Por padrão, a resposta retorna Distance em quilômetros. Você pode alterar a unidade de medida para milhas usando o seguinte parâmetro opcional:
-
DistanceUnit: especifica o sistema de unidades a ser usado para os resultados da distância.
POST /routes/v0/calculators/ExampleCalculator/calculate/route Content-type: application/json { "DeparturePosition": [-122.7565,49.0021], "DestinationPosition": [-122.3394, 47.6159], "DistanceUnit": "Miles" }
Definir pontos de referência
Ao calcular uma rota, você pode especificar até 23 pontos de parada intermediários entre a posição de partida e a posição de destino usando as posições do ponto de referência.
-
WaypointPositions: especifica uma lista ordenada de posições intermediárias a serem incluídas ao longo de uma rota entre a posição de partida e a posição de destino.nota
Se você especificar uma posição de ponto de referência que não esteja localizada em uma estrada, o Amazon Location moverá a posição para a estrada mais próxima.
A solicitação CalculateRoute a seguir calcula uma rota com dois pontosde referência:
-
A posição de partida é [-122,7565, 49,0021] e a posição de destino é [-122,3394, 47,6159].
-
Para o parâmetro de solicitação
WaypointPositions:-
A primeira posição de parada é [
-122.1884, 48.0936]. -
A segunda posição de parada é [
-122.3493, 47.6205].
-
-
Para incluir a geometria da linha da perna entre esses dois pontos de referência, defina o seguinte parâmetro opcional como
true:-
IncludeLegGeometry: inclui a geometria de cada trecho entre um par de posições na resposta.
-
POST /routes/v0/calculators/ExampleCalculator/calculate/route Content-type: application/json { "DeparturePosition": [-122.7565,49.0021], "DestinationPosition": [-122.3394, 47.6159], "WaypointPositions":[ [-122.1884,48.0936], [-122.3493,47.6205] ], "IncludeLegGeometry":true}
Exemplo de resposta
A seguir está um exemplo de solicitação com a resposta correspondente ao chamar a CalculateRoute operação a partir das rotas de localização da Amazon API com o IncludeLegGeometry definido como true, que inclui a geometria da cadeia de linhas de cada caminho entre um par de posições na resposta.
