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á.
# 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}'
```
------