Perencanaan rute dengan matriks rute - Amazon Location Service

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

Perencanaan rute dengan matriks rute

Anda dapat menggunakan Amazon Location Service untuk membuat input ke perangkat lunak perencanaan dan pengoptimalan rute Anda. Anda dapat membuat hasil rute, termasuk waktu perjalanan dan jarak perjalanan, untuk rute antara serangkaian posisi keberangkatan dan serangkaian posisi tujuan.

Misalnya, mengingat posisi keberangkatan A dan B, dan posisi tujuan X dan Y, Amazon Location Service akan mengembalikan waktu perjalanan dan jarak perjalanan untuk rute dari A ke X, A ke Y, B ke X, dan B ke Y.

Anda dapat menghitung rute dengan berbagai moda transportasi, penghindaran, dan kondisi lalu lintas. Misalnya, Anda dapat menentukan bahwa kendaraan tersebut adalah truk yang panjangnya 35 kaki, dan rute yang dihitung akan menggunakan batasan tersebut untuk menentukan waktu tempuh dan jarak tempuh.

Jumlah hasil yang dikembalikan (dan rute dihitung) adalah jumlah posisi keberangkatan dikalikan dengan jumlah posisi tujuan. Anda dikenakan biaya untuk setiap rute yang dihitung, bukan setiap permintaan ke layanan, sehingga matriks rute dengan 10 keberangkatan dan 10 tujuan akan ditagih sebagai 100 rute.

Menghitung matriks rute

Anda dapat menghitung matriks rute antara satu set posisi keberangkatan dan serangkaian posisi tujuan. Hasil rute akan mencakup waktu tempuh dan jarak tempuh.

Prasyarat

  • Anda harus terlebih dahulu membuat sumber daya kalkulator rute dan menyiapkan otentikasi untuk permintaan Anda ke Lokasi Amazon. Untuk informasi selengkapnya, lihat Prasyarat.

Kirim permintaan dengan menggunakan CalculateRouteMatrix operasi. Permintaan minimal berisi bidang wajib berikut:

  • DeparturePositions— Kumpulan posisi awal untuk menghitung rute. Didefinisikan sebagai array [longitude, latitude]

  • DestinationPositions— Kumpulan posisi akhir untuk menghitung rute. Didefinisikan sebagai array dari[longitude, latitude].

catatan

Jika Anda menentukan posisi keberangkatan atau tujuan yang tidak terletak di jalan, Lokasi Amazon memindahkan posisi ke jalan terdekat.

Anda dapat secara opsional menentukan waktu keberangkatan, dan mode perjalanan dalam permintaan Anda.

Anda dapat menggunakan AWS CLI atau Amazon Location API.

API

Contoh berikut adalah CalculateRouteMatrix permintaan menggunakan sumber kalkulator rute ExampleCalculator. Permintaan menentukan penghitungan matriks rute dari posisi keberangkatan [-122.7565, 49.0021] dan [-122.2014, 47.6101] ke posisi tujuan [-122.3394, 47.6159] dan [-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

Contoh berikut adalah calculate-route-matrix perintah menggunakan sumber kalkulator rute ExampleCalculator. Permintaan menentukan penghitungan matriks rute dari posisi keberangkatan [-122.7565, 49.0021] dan [-122.2014, 47.6101] ke posisi tujuan [-122.3394, 47.6159] dan [-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]]"

Secara default, respons kembali Distance dalam kilometer. Anda dapat mengubah satuan pengukuran menjadi mil menggunakan parameter opsional berikut:

  • DistanceUnit- Menentukan sistem unit yang akan digunakan untuk hasil jarak.

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" }

Pembatasan posisi keberangkatan dan tujuan

Saat menghitung matriks rute, ada batasan pada posisi keberangkatan dan tujuan. Pembatasan ini bervariasi tergantung pada penyedia yang digunakan oleh RouteCalculator sumber daya.

Batasan Esri Ambil KEMARI
Jumlah posisi Hingga 10 posisi keberangkatan dan 10 posisi tujuan. Hingga 350 posisi keberangkatan dan 350 posisi tujuan.

Hingga 350 posisi keberangkatan dan 350 posisi tujuan.

Untuk rute yang lebih panjang, pembatasan tambahan berlaku. Lihat bagian.

Jarak antar posisi Setiap pasangan posisi keberangkatan dan tujuan harus berada dalam jarak 400 km satu sama lain (40 km untuk rute berjalan kaki).

Semua posisi keberangkatan dan tujuan harus berada dalam lingkaran berdiameter 180 km.

Untuk rute yang lebih panjang, pembatasan tambahan berlaku. Lihat bagian.

Panjang rute Rute tidak akan selesai jika total waktu perjalanan untuk rute tersebut lebih dari 400 menit.

Rute yang menyimpang lebih dari 10 km di luar lingkaran di sekitar titik keberangkatan dan tujuan tidak akan dihitung.

Untuk rute yang lebih panjang, pembatasan tambahan berlaku. Lihat bagian.

Wilayah Menghitung matriks rute tidak didukung di Korea. Tersedia di Asia Tenggara. Untuk daftar negara/wilayah yang didukung dan informasi selengkapnya, lihat. Negara/wilayah dan area yang dicakup Tidak ada batasan tambahan.

Perencanaan rute yang lebih panjang

Menghitung matriks hasil rute berguna untuk perencanaan rute yang efisien, tetapi perhitungannya bisa memakan waktu. Semua penyedia data Amazon Location Service membatasi jumlah rute atau jarak rute yang dapat dihitung. Misalnya, HERE memungkinkan pembuatan rute antara 350 posisi keberangkatan dan tujuan, tetapi posisi tersebut harus berada dalam lingkaran 180 km. Bagaimana jika Anda ingin merencanakan dengan rute yang lebih panjang?

Anda dapat menghitung matriks rute dengan panjang tidak terbatas untuk jumlah rute yang lebih kecil, menggunakan, RouteCalculator dengan HERE sebagai penyedia data. Ini tidak mengubah cara Anda memanggil CalculateRouteMatrix API, Amazon Location hanya memungkinkan rute yang lebih panjang ketika Anda memenuhi persyaratan.

Persyaratan untuk perhitungan rute panjang yang lebih panjang adalah:

  • RouteCalculatorHarus menggunakan penyedia data HERE.

  • Jumlah posisi keberangkatan tidak boleh lebih dari 15.

  • Jumlah total rute untuk menghitung tidak boleh lebih dari 100.

  • Perutean jarak jauh tidak diperbolehkan untuk rute truk dengan penghindaran tol ketika rute lebih dari 1.000 km. Kombinasi ini lebih lambat untuk dihitung, dan dapat menyebabkan panggilan habis. Anda dapat menghitung rute ini secara individual dengan CalculateRouteoperasi.

Jika panggilan Anda tidak memenuhi persyaratan ini (misalnya, Anda meminta 150 perhitungan rute dalam satu panggilan), maka CalculateRouteMatrix akan kembali hanya mengizinkan aturan rute yang lebih pendek. Anda kemudian dapat menghitung rute, selama posisi berada dalam lingkaran 180 km.

Saat menghitung rute yang lebih panjang, ingatlah poin-poin ini:

  • Rute yang lebih panjang dapat memakan waktu lebih lama untuk dihitung, bahkan lebih lama dari waktu maksimum untuk Amazon Location API. Jika Anda sering mendapatkan batas waktu dengan rute tertentu, Anda dapat mencoba sejumlah kecil rute di setiap panggilan. CalculateRouteMatrix

  • Jika Anda menambahkan lebih banyak posisi tujuan atau keberangkatan ke CalculateRouteMatrix permintaan Anda, operasi dapat beralih ke mode yang lebih terbatas, dan Anda bisa mendapatkan kesalahan untuk rute yang dapat dihitung tanpa masalah ketika ada lebih sedikit rute untuk dibuat. Dalam hal ini, kurangi jumlah posisi tujuan atau keberangkatan, dan buat beberapa permintaan untuk mendapatkan set lengkap perhitungan rute yang Anda butuhkan.

Contoh tanggapan

Berikut ini adalah contoh permintaan dengan respons yang sesuai saat memanggil CalculateRouteMatrix operasi dari Amazon Location Routes API.

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" } }