Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Pelajari cara menggunakan CalculateRouteMatrix
Di bagian ini Anda mempelajari cara menggunakan `CalculateRouteMatrix` untuk menemukan rute yang efisien untuk beberapa asal dan tujuan.
**Topics**
+ [
# Cara menghitung matriks rute jarak dan waktu untuk beberapa asal dan tujuan
](calculate-route-matrix-distance.md)
+ [
# Cara menghitung matriks rute dengan penghindaran
](calculate-route-matrix-with-avoidance.md)
# Cara menghitung matriks rute jarak dan waktu untuk beberapa asal dan tujuan
CalculateRouteMatrix API menghitung rute dan menyediakan waktu tempuh dan jarak tempuh untuk setiap kombinasi asal dan tujuan. Kemampuan ini berguna untuk aplikasi yang membutuhkan perencanaan dan pengoptimalan rute di beberapa lokasi.
Respons termasuk `Distance` dalam meter dan `Duration` dalam detik untuk setiap pasangan asal-tujuan.
## Kasus penggunaan potensial
+ **Optimalkan perencanaan rute:** Gunakan matriks rute sebagai input untuk perangkat lunak pengoptimalan rute untuk meningkatkan efisiensi layanan dan mengurangi waktu perjalanan.
## Contoh
### CalculateRouteMatrix dengan batas perutean tak terbatas
------
#### [ 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 dengan batas routing berbasis geometri
------
#### [ 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}}}'
```
------
# Cara menghitung matriks rute dengan penghindaran
CalculateRouteMatrix API menghitung rute dan mengembalikan waktu dan jarak perjalanan dari masing-masing asal ke setiap tujuan dalam daftar yang ditentukan. Respons termasuk `Distance` dalam meter dan `Duration` dalam detik. API dapat digunakan untuk mengatur opsi penghindaran untuk area atau fitur jalan tertentu, memastikan rute menghindari zona atau kondisi tertentu. Jika rute alternatif tidak layak, preferensi penghindaran dapat dilewati.
## Kasus penggunaan potensial
+ **Perencanaan dan pengoptimalan rute:** Gunakan matriks rute sebagai masukan untuk perangkat lunak yang memerlukan rute perjalanan yang dioptimalkan sambil menghindari area atau fitur jalan tertentu.
## Contoh
### CalculateRouteMatrix dengan area penghindaran
------
#### [ 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 menghindari jalan tol, jalan raya, dan feri
------
#### [ 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}'
```
------