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

# Calcular matriz de rotas
<a name="calculate-route-matrix"></a>

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
<a name="route-matrix-use-cases"></a>
+ **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
<a name="route-matrix-request"></a>

**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 name="route-matrix-response"></a>

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.