Hitung rute dengan Lokasi Amazon - Amazon Location Service
Mulai menghitung ruteTitik arahContoh tanggapan

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

Hitung rute dengan Lokasi Amazon

Anda dapat menggunakan Amazon Location Service untuk menghitung rute antara asal dan tujuan, dengan hingga 23 titik arah di sepanjang rute, untuk berbagai moda transportasi, penghindaran, dan kondisi lalu lintas.

catatan

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

Mulai menghitung rute

Kirim permintaan sederhana dengan menggunakan CalculateRoute operasi. Permintaan sederhana berisi bidang wajib berikut:

  • DeparturePosition— Posisi awal untuk menghitung rute dari. Didefinisikan sebagai [longitude, latitude]

  • DestinationPosition— Posisi akhir untuk menghitung rute. Didefinisikan sebagai[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 titik arah, waktu keberangkatan, dan mode perjalanan dalam permintaan Anda.

Anda dapat menggunakan AWS CLI atau Lokasi AmazonAPIs.

API

Contoh berikut adalah CalculateRoute permintaan menggunakan sumber kalkulator rute ExampleCalculator. Permintaan menentukan penghitungan rute dari posisi keberangkatan [-122.7565, 49.0021] ke posisi tujuan [-122.3394, 47.6159].

POST /routes/v0/calculators/ExampleCalculator/calculate/route
Content-type: application/json
{
   "DeparturePosition": [-122.7565,49.0021],
   "DestinationPosition": [-122.3394, 47.6159]
}
AWS CLI

Contoh berikut adalah calculate-route perintah menggunakan sumber kalkulator rute ExampleCalculator. Permintaan menentukan penghitungan rute dari posisi keberangkatan [-122.7565, 49.0021] ke posisi tujuan [-122.3394, 47.6159].

aws location \
    calculate-route \
        --calculator-name ExampleCalculator \
        --departure-position -122.7565 49.0021 \
        --destination-position -122.3394 47.6159

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
Content-type: application/json
{
   "DeparturePosition": [-122.7565,49.0021],
   "DestinationPosition": [-122.3394, 47.6159],
   "DistanceUnit": "Miles"
}

Mengatur titik arah

Saat menghitung rute, Anda dapat menentukan hingga 23 titik persinggahan antara posisi keberangkatan dan posisi tujuan menggunakan posisi titik arah.

  • WaypointPositions— Menentukan daftar urutan posisi menengah untuk memasukkan sepanjang rute antara posisi keberangkatan dan posisi tujuan.

    catatan

    Jika Anda menentukan posisi waypoint yang tidak terletak di jalan, Amazon Location memindahkan posisi ke jalan terdekat.

CalculateRoutePermintaan berikut menghitung rute dengan 2 titik arah:

  • Posisi keberangkatan adalah [-122.7565, 49.0021], dan posisi tujuan adalah [-122.3394, 47.6159].

  • Untuk parameter permintaanWaypointPositions:

    • Posisi stop over pertama adalah [-122.1884, 48.0936].

    • Posisi stop over kedua adalah [-122.3493, 47.6205].

  • Untuk menyertakan geometri linestring kaki antara dua titik arah ini, atur parameter opsional berikut ke true:

    • IncludeLegGeometry— Termasuk geometri setiap jalur antara sepasang posisi dalam respons.

POST /routes/v0/calculators/ExampleCalculator/calculate/route
Content-type: application/json
{
   "DeparturePosition": [-122.7565,49.0021],
   "DestinationPosition": [-122.3394, 47.6159],
   "WaypointPositions":[
        [-122.1884,48.0936],
        [-122.3493,47.6205]
    ],
   "IncludeLegGeometry": true
}

Contoh tanggapan

Berikut ini adalah contoh permintaan dengan respons yang sesuai saat memanggil CalculateRoute operasi dari Rute Lokasi Amazon API dengan IncludeLegGeometry disetel ke true, yang mencakup geometri linestring dari setiap jalur antara sepasang posisi dalam respons.

Example request
POST /routes/v0/calculators/ExampleCalculator/calculate/route
Content-type: application/json
{
   "DeparturePosition": [-122.7565,49.0021],
   "DestinationPosition": [-122.3394, 47.6159],
   "IncludeLegGeometry": true
}
Example response
{
   "Legs": [ 
      { 
         "Distance": 178.5,
         "DurationSeconds": 6480,
         "EndPosition": [-122.3394,47.6159],
         "Geometry": { 
            "LineString": [ 
               [-122.7565,49.0021],
               [-122.3394,47.6159]
            ]
         },
         "StartPosition": [-122.7565,49.0021],
         "Steps": [ 
            { 
               "Distance": 178.5,
               "DurationSeconds": 6480,
               "EndPosition": [-122.3394,47.6159],
               "GeometryOffset": 0,
               "StartPosition": [-122.7565,49.0021]
            }
         ]
      }
   ],
   "Summary": { 
      "DataSource": "Esri",
      "Distance": 178.5,
      "DistanceUnit": "Kilometers",
      "DurationSeconds": 6480,
      "RouteBBox": [
        -122.7565,49.0021,
        -122.3394,47.6159
    ]
   }
}