Planejamento de rotas com uma matriz de rotas - Amazon Location Service

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á.

Planejamento de rotas com uma matriz de rotas

Você pode usar o Amazon Location Service para criar entradas para seu software de planejamento e otimização de rotas. Você pode criar resultados de rotas, incluindo tempo e distância de viagem, para rotas entre um conjunto de posições de partida e um conjunto de posições de destino.

Por exemplo, considerando as posições de partida A e B e as posições de destino X e Y, o Amazon Location Service retornará o tempo e a distância da viagem para rotas de A a X, A a Y, B a X e B a Y.

Você pode calcular as rotas com diferentes modos de transporte, evasões e condições de tráfego. Por exemplo, você pode especificar que o veículo é um caminhão com 11 metros de comprimento, e a rota calculada usará essas restrições para determinar o tempo e a distância da viagem.

O número de resultados (e rotas calculadas) é o número de posições de partida multiplicado pelo número de posições de destino. Você é cobrado por cada rota calculada, não por cada solicitação ao serviço. Assim sendo, uma matriz de rotas com 10 partidas e 10 destinos será cobrada como 100 rotas.

Cálculo de uma matriz de rotas

Você pode calcular uma matriz de rotas entre um conjunto de posições de partida e um conjunto de posições de destino. Os resultados da rota incluirão o tempo de viagem e a distância da viagem.

Pré-requisito

  • Primeiro, você deve criar um recurso de calculadora de rotas e configurar a autenticação para suas solicitações para o Amazon Location. Para ter mais informações, consulte Pré-requisitos.

Envie uma solicitação usando a operação CalculateRouteMatrix. Uma solicitação mínima contém os seguintes campos obrigatórios:

  • DeparturePositions — O conjunto de posições iniciais para as quais calcular as rotas. Definido como uma matriz de [longitude, latitude]

  • DestinationPositions — O conjunto de posições finais para as quais calcular as rotas. Definido como uma matriz de [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 um horário de partida e um modo de viagem em sua solicitação.

Você pode usar a AWS CLI ou as APIs do Amazon Location.

API

O exemplo a seguir é uma CalculateRouteMatrix solicitação usando o recurso de calculadora de rotas ExampleCalculator. A solicitação especifica o cálculo da matriz de rotas das posições de partida [-122,7565, 49,0021] e [-122,2014, 47,6101] até as posições de destino [-122,3394, 47,6159] e [-122,4813, 48,7511].

POST /routes/v0/calculators/ExampleCalculator/calculate/route-matrix Content-type: application/json { "DeparturePositions": [ [-122.7565,49.0021], [-122.2014,47.6101] ], "DestinationPositions": [ [-122.3394, 47.6159], [-122.4813,48.7511] ] }
AWS CLI

O exemplo a seguir é um calculate-route-matrix comando usando o recurso de calculadora de rotas ExampleCalculator. A solicitação especifica o cálculo da matriz de rotas das posições de partida [-122,7565, 49,0021 ] e [-122,2014, 47,6101] até as posições de destino [-122,3394, 47,6159 ] e [-122,4813, 48,7511].

aws location \ calculate-route-matrix \ --calculator-name ExampleCalculator \ --departure-positions "[[-122.7565,49.0021],[-122.2014,47.6101]]" \ --destination-positions "[[-122.3394,47.6159],[-122.4813,48.7511]]"

Por padrão, a resposta resulta na 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-matrix Content-type: application/json { "DeparturePositions": [ [-122.7565,49.0021], [-122.2014,47.6101] ], "DestinationPositions": [ [-122.3394, 47.6159], [-122.4813,48.7511] ], "DistanceUnit": "Miles" }

Restrições nas posições de partida e destino

Ao calcular uma matriz de rotas, há restrições nas posições de partida e destino. Essas restrições variam de acordo com o provedor usado pelo recurso RouteCalculator.

Limitação Esri Grab HERE
Número de posições Até 10 posições de partida e 10 posições de destino. Até 350 posições de partida e 350 posições de destino.

Até 350 posições de partida e 350 posições de destino.

Para rotas mais longas, restrições adicionais se aplicam. Consulte a seção.

Distância entre posições Qualquer par de posições de partida e destino deve estar a 400 km uma da outra (40 km para rotas de pedestres).

Todas as posições de partida e destino devem estar dentro de um círculo de 180 km de diâmetro.

Para rotas mais longas, restrições adicionais se aplicam. Consulte a seção.

Comprimento da rota As rotas não serão concluídas se o tempo total de viagem da rota for superior a 400 minutos.

As rotas que se desviam mais de 10 km fora de um círculo ao redor dos pontos de partida e destino não serão calculadas.

Para rotas mais longas, restrições adicionais se aplicam. Consulte a seção.

Regiões O cálculo de uma matriz de rotas não é suportado na Coreia. Disponível no sudeste da Ásia. Para obter uma lista de países/regiões compatíveis e obter mais informações, consulte Países/regiões e área de cobertura. Sem restrições adicionais.

Planejamento de rotas mais longas

O cálculo de uma matriz de resultados de rotas é útil para um planejamento eficiente de rotas, mas o cálculo pode levar algum tempo. Todos os provedores de dados do Amazon Location Service limitam o número de rotas ou a distância das rotas que podem ser calculadas. Por exemplo, o HERE permite criar rotas entre 350 posições de partida e destino, mas essas posições devem estar dentro de um círculo de 180 km. E se você quiser planejar com rotas mais longas?

Você pode calcular uma matriz de rotas com comprimentos irrestritos para um número menor de rotas, usando, a RouteCalculator com o HERE como provedor de dados. Isso não muda a forma como você chama a API CalculateRouteMatrix. O Amazon Location simplesmente permite rotas mais longas quando você atende aos requisitos.

Os requisitos para cálculos de rotas de maior extensão são:

  • A RouteCalculator deve usar o provedor de dados HERE.

  • O número de posições de partida não deve ser maior que 15.

  • O número total de rotas a serem calculadas não deve ser maior que 100.

  • O roteamento de longa distância não é permitido para roteamento de caminhões sem pedágio quando as rotas são maiores que 1.000 km. Essa combinação é mais lenta de calcular e pode fazer com que a chamada atinja o tempo limite. Você pode calcular essas rotas individualmente com a CalculateRouteoperação.

Se sua chamada não atender a esses requisitos (por exemplo, você está solicitando 150 cálculos de rota em uma única chamada), a CalculateRouteMatrix voltará a permitir apenas as regras de rota mais curtas. Você pode então calcular as rotas, desde que as posições estejam dentro de um círculo de 180 km.

Ao calcular rotas mais longas, tenha em mente estes pontos:

  • Rotas mais longas podem levar mais tempo para serem calculadas, até mais do que o tempo máximo das APIs do Amazon Location. Se você tiver tempos limite frequentes com rotas específicas, poderá tentar um número menor de rotas em cada chamada para a CalculateRouteMatrix.

  • Se você adicionar mais posições de destino ou de partida à sua solicitação CalculateRouteMatrix, a operação poderá mudar para o modo mais restrito e você poderá receber um erro em uma rota que pode ser calculada sem problemas quando há menos rotas para criar. Nesse caso, reduza o número de posições de destino ou de partida e faça várias solicitações para obter o conjunto completo de cálculos de rota de que você precisa.

Exemplo de resposta

Veja a seguir um exemplo de solicitação com a resposta correspondente ao chamar a operação CalculateRouteMatrix a partir da API de rotas do Amazon Location.

Example request
POST /routes/v0/calculators/ExampleCalculator/calculate/route-matrix Content-type: application/json { "DeparturePositions": [ [-122.7565,49.0021], [-122.2014,47.6101] ], "DestinationPositions": [ [-122.3394, 47.6159], [-122.4813,48.7511] ] }
Example response
{ "RouteMatrix": [ [ { "Distance": 178.764, "DurationSeconds": 7565 }, { "Distance": 39.795, "DurationSeconds": 1955 } ], [ { "Distance": 15.31, "DurationSeconds": 1217 }, { "Distance": 142.506, "DurationSeconds": 6279 } ] ], "Summary": { "DataSource": "Here", "RouteCount": 4, "ErrorCount": 0, "DistanceUnit": "Kilometers" } }