Bagikan melalui


Route - Get Route Range

Gunakan untuk membuat peta yang menggambarkan area yang dapat diakses dari titik tertentu dalam ambang tertentu berdasarkan waktu, jarak, atau kapasitas bahan bakar.

Get Route Range API (Isochrone) adalah permintaan HTTP GET yang akan menghitung sekumpulan lokasi yang dapat dicapai dari titik asal berdasarkan bahan bakar, energi, waktu, atau anggaran jarak yang ditentukan. Batas poligon (atau Isochrone) dikembalikan dalam orientasi berlawanan arah jagung serta pusat poligon yang tepat yang merupakan hasil dari titik asal.

Poligon yang dikembalikan dapat digunakan untuk pemrosesan lebih lanjut seperti Search Inside Geometry untuk mencari POI dalam isochrone yang disediakan.

GET https://atlas.microsoft.com/route/range/{format}?api-version=1.0&query={query}
GET https://atlas.microsoft.com/route/range/{format}?api-version=1.0&query={query}&fuelBudgetInLiters={fuelBudgetInLiters}&energyBudgetInkWh={energyBudgetInkWh}&timeBudgetInSec={timeBudgetInSec}&distanceBudgetInMeters={distanceBudgetInMeters}&departAt={departAt}&routeType={routeType}&traffic={traffic}&avoid={avoid}&travelMode={travelMode}&hilliness={hilliness}&windingness={windingness}&vehicleAxleWeight={vehicleAxleWeight}&vehicleWidth={vehicleWidth}&vehicleHeight={vehicleHeight}&vehicleLength={vehicleLength}&vehicleMaxSpeed={vehicleMaxSpeed}&vehicleWeight={vehicleWeight}&vehicleCommercial={vehicleCommercial}&vehicleLoadType={vehicleLoadType}&vehicleEngineType={vehicleEngineType}&constantSpeedConsumptionInLitersPerHundredkm={constantSpeedConsumptionInLitersPerHundredkm}&currentFuelInLiters={currentFuelInLiters}&auxiliaryPowerInLitersPerHour={auxiliaryPowerInLitersPerHour}&fuelEnergyDensityInMJoulesPerLiter={fuelEnergyDensityInMJoulesPerLiter}&accelerationEfficiency={accelerationEfficiency}&decelerationEfficiency={decelerationEfficiency}&uphillEfficiency={uphillEfficiency}&downhillEfficiency={downhillEfficiency}&constantSpeedConsumptionInkWhPerHundredkm={constantSpeedConsumptionInkWhPerHundredkm}&currentChargeInkWh={currentChargeInkWh}&maxChargeInkWh={maxChargeInkWh}&auxiliaryPowerInkW={auxiliaryPowerInkW}

Parameter URI

Nama Dalam Diperlukan Jenis Deskripsi
format
path True

ResponseFormat

Format respons yang diinginkan. Nilai dapat berupa json atau xml.

api-version
query True

string

Nomor versi API Azure Maps.

query
query True

number[]

Koordinat dari mana perhitungan rentang harus dimulai.

accelerationEfficiency
query

number

double

Menentukan efisiensi konversi energi kimia yang disimpan dalam bahan bakar ke energi kinetik ketika kendaraan berakselerasi (yaitu KineticEnergyGained/ChemicalEnergyConsumed). ChemicalEnergyConsumed diperoleh dengan mengonversi bahan bakar yang dikonsumsi menjadi energi kimia menggunakan fuelEnergyDensityInMJoulesPerLiter.

Harus dipasangkan dengan decelerationEfficiency.

Rentang nilai yang diizinkan adalah 0,0 hingga 1/decelerationEfficiency.

Nilai Masuk Akal : untuk Model Pembakaran : 0,33, untuk Model Listrik : 0,66

auxiliaryPowerInkW
query

number

double

Menentukan jumlah daya yang digunakan untuk mempertahankan sistem tambahan, dalam kilowatt (kW).

Ini dapat digunakan untuk menentukan konsumsi karena perangkat dan sistem seperti sistem AC, radio, pemanasan, dll.

Nilai Masuk Akal : 1.7

auxiliaryPowerInLitersPerHour
query

number

double

Menentukan jumlah bahan bakar yang dikonsumsi untuk mempertahankan sistem tambahan kendaraan, dalam liter per jam.

Ini dapat digunakan untuk menentukan konsumsi karena perangkat dan sistem seperti sistem AC, radio, pemanasan, dll.

Nilai Masuk Akal : 0,2

avoid
query

RouteAvoidType[]

Menentukan sesuatu yang harus dihindari oleh perhitungan rute saat menentukan rute. Dapat ditentukan beberapa kali dalam satu permintaan, misalnya, '&avoid=motorways&avoid=tollRoads&avoid=ferries'. Dalam permintaan Rentang Rute, nilai alreadyUsedRoads tidak boleh digunakan.

constantSpeedConsumptionInkWhPerHundredkm
query

string

Menentukan komponen konsumsi yang bergantung pada kecepatan.

Disediakan sebagai daftar pasangan kecepatan/tingkat konsumsi yang tidak diurutkan. Daftar ini mendefinisikan titik pada kurva konsumsi. Tingkat konsumsi untuk kecepatan yang tidak ada dalam daftar ditemukan sebagai berikut:

  • dengan interpolasi linier, jika kecepatan yang diberikan terletak di antara dua kecepatan dalam daftar

  • dengan ekstrapolasi linier, dengan asumsi konstanta (ΔConsumption/ΔSpeed) ditentukan oleh dua titik terdekat dalam daftar

Daftar harus berisi antara 1 dan 25 poin (inklusif), dan mungkin tidak berisi titik duplikat untuk kecepatan yang sama. Jika hanya berisi satu titik, maka tingkat konsumsi titik tersebut digunakan tanpa pemrosesan lebih lanjut.

Konsumsi yang ditentukan untuk kecepatan terbesar harus lebih besar dari atau sama dengan kecepatan terbesar terpenulis. Ini memastikan bahwa ekstrapolasi tidak menyebabkan tingkat konsumsi negatif.

Demikian pula, nilai konsumsi yang ditentukan untuk dua kecepatan terkecil dalam daftar tidak dapat menyebabkan tingkat konsumsi negatif untuk kecepatan yang lebih kecil.

Rentang yang valid untuk nilai konsumsi (dinyatakan dalam kWh/100km) adalah antara 0,01 dan 100000,0.

Nilai Masuk Akal : 50,8.2:130,21.3

Parameter ini diperlukan untuk model konsumsi Listrik.

constantSpeedConsumptionInLitersPerHundredkm
query

string

Menentukan komponen konsumsi yang bergantung pada kecepatan.

Disediakan sebagai daftar yang tidak diurutkan dari pasangan kecepatan yang dibatasi titik dua & tingkat konsumsi. Daftar ini mendefinisikan titik pada kurva konsumsi. Tingkat konsumsi untuk kecepatan yang tidak ada dalam daftar ditemukan sebagai berikut:

  • dengan interpolasi linier, jika kecepatan yang diberikan terletak di antara dua kecepatan dalam daftar

  • dengan ekstrapolasi linier, dengan asumsi konstanta (ΔConsumption/ΔSpeed) ditentukan oleh dua titik terdekat dalam daftar

Daftar harus berisi antara 1 dan 25 poin (inklusif), dan mungkin tidak berisi titik duplikat untuk kecepatan yang sama. Jika hanya berisi satu titik, maka tingkat konsumsi titik tersebut digunakan tanpa pemrosesan lebih lanjut.

Konsumsi yang ditentukan untuk kecepatan terbesar harus lebih besar dari atau sama dengan kecepatan terbesar terpenulis. Ini memastikan bahwa ekstrapolasi tidak menyebabkan tingkat konsumsi negatif.

Demikian pula, nilai konsumsi yang ditentukan untuk dua kecepatan terkecil dalam daftar tidak dapat menyebabkan tingkat konsumsi negatif untuk kecepatan yang lebih kecil.

Rentang yang valid untuk nilai konsumsi (dinyatakan dalam l/100km) adalah antara 0,01 dan 100000,0.

Nilai Masuk Akal : 50,6.3:130,11.5

Catatan : Parameter ini diperlukan untuk Model Konsumsi Pembakaran.

currentChargeInkWh
query

number

double

Menentukan pasokan energi listrik saat ini dalam jam kilowatt (kWh).

Parameter ini ada bersama dengan parameter maxChargeInkWh .

Rentang nilai yang diizinkan adalah 0,0 hingga maxChargeInkWh.

Nilai Masuk Akal : 43

currentFuelInLiters
query

number

double

Menentukan pasokan bahan bakar saat ini dalam liter.

Nilai Masuk Akal : 55

decelerationEfficiency
query

number

double

Menentukan efisiensi konversi energi kinetik untuk menghemat (tidak dikonsumsi) bahan bakar ketika kendaraan turun (yaitu ChemicalEnergySaved/KineticEnergyLost). ChemicalEnergySaved diperoleh dengan mengonversi bahan bakar yang disimpan (tidak dikonsumsi) ke energi menggunakan fuelEnergyDensityInMJoulesPerLiter.

Harus dipasangkan dengan accelerationEfficiency.

Rentang nilai yang diizinkan adalah 0,0 hingga 1/akselerasiEfficiency.

Nilai Masuk Akal : untuk Model Pembakaran : 0,83, untuk Model Listrik : 0,91

departAt
query

string

date-time

Tanggal dan waktu keberangkatan dari titik asal yang diformat sebagai nilai seperti yang dateTime didefinisikan dalam RFC 3339, bagian 5.6, dengan offset zona waktu opsional. Ketika offset zona waktu tidak ditentukan, itu akan diasumsikan sebagai titik asal.

  • Nilai default: sekarang
  • Nilai lainnya: dateTime

Contoh:

  • 2023-12-19T16:39:57
  • 2023-12-20T00:39:57+00:00

Parameter departAt tidak dapat digunakan bersama dengan arriveAt.

distanceBudgetInMeters
query

number

double

Anggaran jarak dalam meter yang menentukan rentang maksimal yang dapat ditempuh menggunakan jarak berkendara. Model Konsumsi hanya akan memengaruhi rentang ketika routeType adalah eco.
Tepat satu anggaran (fuelBudgetInLiters, energyBudgetInkWh, timeBudgetInSec, atau distanceBudgetInMeters) harus digunakan.

downhillEfficiency
query

number

double

Menentukan efisiensi konversi energi potensial untuk menghemat (tidak dikonsumsi) bahan bakar ketika kendaraan kehilangan elevasi (yaitu ChemicalEnergySaved/PotentialEnergyLost). ChemicalEnergySaved diperoleh dengan mengonversi bahan bakar yang disimpan (tidak dikonsumsi) ke energi menggunakan fuelEnergyDensityInMJoulesPerLiter.

Harus dipasangkan dengan uphillEfficiency.

Rentang nilai yang diizinkan adalah 0,0 hingga 1/uphillEfficiency.

Nilai Masuk Akal : untuk Model Pembakaran : 0,51, untuk Model Listrik : 0,73

energyBudgetInkWh
query

number

double

Anggaran energi listrik dalam jam kilowatt (kWh) yang menentukan rentang maksimal yang dapat ditempuh menggunakan Model Konsumsi Listrik yang ditentukan.
Ketika energyBudgetInkWh digunakan, wajib untuk menentukan Model Konsumsi Listrik terperinci.
Tepat satu anggaran (fuelBudgetInLiters, energyBudgetInkWh, timeBudgetInSec, atau distanceBudgetInMeters) harus digunakan.

fuelBudgetInLiters
query

number

double

Anggaran bahan bakar dalam liter yang menentukan rentang maksimal yang dapat ditempuh menggunakan Model Konsumsi Pembakaran yang ditentukan.
Ketika bahan bakarBudgetInLiters digunakan, wajib untuk menentukan Model Konsumsi Pembakaran terperinci.
Tepat satu anggaran (fuelBudgetInLiters, energyBudgetInkWh, timeBudgetInSec, atau distanceBudgetInMeters) harus digunakan.

fuelEnergyDensityInMJoulesPerLiter
query

number

double

Menentukan jumlah energi kimia yang disimpan dalam satu liter bahan bakar dalam megajoule (MJ). Ini digunakan bersama dengan parameter *Efisiensi untuk konversi antara energi yang disimpan atau dikonsumsi dan bahan bakar. Misalnya, kepadatan energi adalah 34,2 MJ/l untuk bensin, dan 35,8 MJ/l untuk bahan bakar Diesel.

Parameter ini diperlukan jika ada parameter *Efisiensi yang diatur.

Nilai Masuk Akal : 34,2

hilliness
query

InclineLevel

Tingkat kebukitan untuk rute yang mendebarkan. Parameter ini hanya dapat digunakan bersama dengan routeType=thrilling.

maxChargeInkWh
query

number

double

Menentukan pasokan energi listrik maksimum dalam jam kilowatt (kWh) yang dapat disimpan dalam baterai kendaraan.

Parameter ini ada bersama dengan parameter currentChargeInkWh .

Nilai minimum harus lebih besar dari atau sama dengan currentChargeInkWh.

Nilai Masuk Akal : 85

routeType
query

RouteType

Jenis rute yang diminta.

timeBudgetInSec
query

number

double

Anggaran waktu dalam detik yang menentukan rentang maksimal yang dapat ditempuh menggunakan waktu mengemudi. Model Konsumsi hanya akan memengaruhi rentang ketika routeType adalah eco.
Tepat satu anggaran (fuelBudgetInLiters, energyBudgetInkWh, timeBudgetInSec, atau distanceBudgetInMeters) harus digunakan.

traffic
query

boolean

Nilai yang memungkinkan:

  • true - Pertimbangkan semua informasi lalu lintas yang tersedia selama perutean
  • false - Abaikan data lalu lintas saat ini selama perutean. Perhatikan bahwa meskipun data lalu lintas saat ini diabaikan selama perutean, efek lalu lintas historis pada kecepatan jalan yang efektif masih dimasukkan.
travelMode
query

TravelMode

Mode perjalanan untuk rute yang diminta. Jika tidak ditentukan, defaultnya adalah 'mobil'. Perhatikan bahwa travelMode yang diminta mungkin tidak tersedia untuk seluruh rute. Jika travelMode yang diminta tidak tersedia untuk bagian tertentu, elemen travelMode dari respons untuk bagian tersebut akan menjadi "lainnya". Perhatikan bahwa mode perjalanan bus, sepeda motor, taksi, dan van adalah fungsionalitas BETA. Data pembatasan penuh tidak tersedia di semua area.

uphillEfficiency
query

number

double

Menentukan efisiensi konversi energi kimia yang disimpan dalam bahan bakar ke energi potensial ketika kendaraan mendapatkan elevasi (yaitu PotentialEnergyGained/ChemicalEnergyConsumed). ChemicalEnergyConsumed diperoleh dengan mengonversi bahan bakar yang dikonsumsi menjadi energi kimia menggunakan fuelEnergyDensityInMJoulesPerLiter.

Harus dipasangkan dengan downhillEfficiency.

Rentang nilai yang diizinkan adalah 0,0 hingga 1/downhillEfficiency.

Nilai Masuk Akal : untuk Model Pembakaran : 0,27, untuk Model Listrik : 0,74

vehicleAxleWeight
query

integer

Berat per sumbu kendaraan dalam kg. Nilai 0 berarti bahwa pembatasan berat per sumbu tidak dipertimbangkan.

vehicleCommercial
query

boolean

Apakah kendaraan digunakan untuk tujuan komersial. Kendaraan komersial mungkin tidak diizinkan untuk berkendara di beberapa jalan.

vehicleEngineType
query

VehicleEngineType

Jenis mesin kendaraan. Ketika Model Konsumsi terperinci ditentukan, model tersebut harus konsisten dengan nilai vehicleEngineType.

vehicleHeight
query

number

double

Tinggi kendaraan dalam meter. Nilai 0 berarti bahwa pembatasan tinggi tidak dipertimbangkan.

vehicleLength
query

number

double

Panjang kendaraan dalam meter. Nilai 0 berarti bahwa pembatasan panjang tidak dipertimbangkan.

vehicleLoadType
query

VehicleLoadType

Jenis kargo yang mungkin diklasifikasikan sebagai bahan berbahaya dan dibatasi dari beberapa jalan. Nilai vehicleLoadType yang tersedia adalah kelas Hazmat AS 1 hingga 9, ditambah klasifikasi generik untuk digunakan di negara/wilayah lain. Nilai yang dimulai dengan USHazmat adalah untuk perutean AS sementara otherHazmat harus digunakan untuk semua negara/wilayah lain. vehicleLoadType dapat ditentukan beberapa kali. Parameter ini saat ini hanya dipertimbangkan untuk travelMode=truck.

vehicleMaxSpeed
query

integer

Kecepatan maksimum kendaraan dalam km/jam. Kecepatan maksimal di profil kendaraan digunakan untuk memeriksa apakah kendaraan diizinkan di jalan raya.

  • Nilai 0 berarti bahwa nilai yang sesuai untuk kendaraan akan ditentukan dan diterapkan selama perencanaan rute.

  • Nilai bukan nol dapat ditimpa selama perencanaan rute. Misalnya, arus lalu lintas saat ini adalah 60 km/jam. Jika kecepatan maksimum kendaraan diatur ke 50 km/jam, mesin perutean akan mempertimbangkan 60 km/jam karena ini adalah situasi saat ini. Jika kecepatan maksimum kendaraan disediakan sebagai 80 km/jam tetapi arus lalu lintas saat ini adalah 60 km/jam, maka mesin perutean akan kembali menggunakan 60 km/jam.

vehicleWeight
query

integer

Berat kendaraan dalam kilogram.

  • Ini wajib jika salah satu dari parameter *Efisiensi ditetapkan.

  • Ini harus benar-benar positif ketika digunakan dalam konteks Model Konsumsi. Pembatasan berat badan dipertimbangkan.

  • Jika tidak ada Model Konsumsi terperinci yang ditentukan dan nilai vehicleWeight bukan nol, maka pembatasan berat akan dipertimbangkan.

  • Dalam semua kasus lain, parameter ini diabaikan.

Nilai Masuk Akal : untuk Model Pembakaran : 1600, untuk Model Listrik : 1900

vehicleWidth
query

number

double

Lebar kendaraan dalam meter. Nilai 0 berarti bahwa pembatasan lebar tidak dipertimbangkan.

windingness
query

WindingnessLevel

Tingkat belokan untuk rute yang mendebarkan. Parameter ini hanya dapat digunakan bersama dengan routeType=thrilling.

Header Permintaan

Nama Diperlukan Jenis Deskripsi
x-ms-client-id

string

Menentukan akun mana yang ditujukan untuk penggunaan bersama dengan model keamanan ID Microsoft Entra. Ini mewakili ID unik untuk akun Azure Maps dan dapat diambil dari API Akun bidang manajemen Azure Maps. Untuk menggunakan keamanan ID Microsoft Entra di Azure Maps, lihat artikel berikut ini untuk panduan.

Respons

Nama Jenis Deskripsi
200 OK

RouteRangeResult

OK

Other Status Codes

ErrorResponse

Terjadi kesalahan tak terduga.

Keamanan

AADToken

Ini adalah Alur Microsoft Entra OAuth 2.0 . Saat dipasangkan dengan kontrol akses berbasis peran Azure , kontrol akses tersebut dapat digunakan untuk mengontrol akses ke REST API Azure Maps. Kontrol akses berbasis peran Azure digunakan untuk menunjuk akses ke satu atau beberapa akun sumber daya atau sub-sumber daya Azure Maps. Setiap pengguna, grup, atau perwakilan layanan dapat diberikan akses melalui peran bawaan atau peran kustom yang terdiri dari satu atau beberapa izin ke REST API Azure Maps.

Untuk menerapkan skenario, sebaiknya lihat konsep autentikasi. Singkatnya, definisi keamanan ini menyediakan solusi untuk pemodelan aplikasi melalui objek yang mampu mengontrol akses pada API dan cakupan tertentu.

Catatan

  • Definisi keamanan ini memerlukan penggunaan x-ms-client-id header untuk menunjukkan sumber daya Azure Maps mana yang meminta akses aplikasi. Ini dapat diperoleh dari API manajemen Maps.

Authorization URL khusus untuk instans cloud publik Azure. Sovereign cloud memiliki URL Otorisasi yang unik dan konfigurasi ID Microsoft Entra. * Kontrol akses berbasis peran Azure dikonfigurasi dari bidang manajemen Azure melalui portal Microsoft Azure, PowerShell, CLI, Azure SDK, atau REST API. * Penggunaan Azure Maps Web SDK memungkinkan penyiapan berbasis konfigurasi aplikasi untuk beberapa kasus penggunaan.

Jenis: oauth2
Alur: implicit
URL Otorisasi: https://login.microsoftonline.com/common/oauth2/authorize

Cakupan

Nama Deskripsi
https://atlas.microsoft.com/.default https://atlas.microsoft.com/.default

subscription-key

Ini adalah kunci bersama yang disediakan saat Anda Membuat akun Azure Maps di portal Microsoft Azure atau menggunakan PowerShell, CLI, Azure SDK, atau REST API.

Dengan kunci ini, aplikasi apa pun dapat mengakses semua REST API. Dengan kata lain, kunci ini dapat digunakan sebagai kunci master di akun tempat kunci tersebut diterbitkan.

Untuk aplikasi yang diekspos secara publik, rekomendasi kami adalah menggunakan pendekatan aplikasi klien rahasia untuk mengakses REST API Azure Maps sehingga kunci Anda dapat disimpan dengan aman.

Jenis: apiKey
Dalam: query

SAS Token

Ini adalah token tanda tangan akses bersama dibuat dari operasi Daftar SAS pada sumber daya Azure Maps melalui bidang manajemen Azure melalui portal Microsoft Azure, PowerShell, CLI, Azure SDK, atau REST API.

Dengan token ini, aplikasi apa pun berwenang untuk mengakses dengan kontrol akses berbasis peran Azure dan kontrol fine-grain ke kedaluwarsa, tarif, dan wilayah penggunaan untuk token tertentu. Dengan kata lain, Token SAS dapat digunakan untuk memungkinkan aplikasi mengontrol akses dengan cara yang lebih aman daripada kunci bersama.

Untuk aplikasi yang diekspos secara publik, rekomendasi kami adalah mengonfigurasi daftar spesifik asal yang diizinkan pada sumber daya akun Peta untuk membatasi penyalahgunaan penyalahgunaan dan memperbarui Token SAS secara teratur.

Jenis: apiKey
Dalam: header

Contoh

Successfully retrieve a set of locations that can be reached from the origin point based on various conditions

Permintaan sampel

GET https://atlas.microsoft.com/route/range/json?api-version=1.0&query=50.97452,5.86605&timeBudgetInSec=6000

Respon sampel

{
  "formatVersion": "0.0.1",
  "reachableRange": {
    "center": {
      "latitude": 50.9745,
      "longitude": 5.86605
    },
    "boundary": [
      {
        "latitude": 52.03704,
        "longitude": 5.73602
      },
      {
        "latitude": 52.09456,
        "longitude": 5.59435
      },
      {
        "latitude": 52.16815,
        "longitude": 5.42279
      },
      {
        "latitude": 52.25047,
        "longitude": 5.21276
      },
      {
        "latitude": 52.21374,
        "longitude": 5.15355
      },
      {
        "latitude": 52.25674,
        "longitude": 4.96687
      },
      {
        "latitude": 52.07834,
        "longitude": 4.739
      },
      {
        "latitude": 52.05647,
        "longitude": 4.72513
      },
      {
        "latitude": 51.94553,
        "longitude": 4.53237
      },
      {
        "latitude": 51.70119,
        "longitude": 4.31165
      },
      {
        "latitude": 51.5837,
        "longitude": 4.28917
      },
      {
        "latitude": 51.48463,
        "longitude": 3.82685
      },
      {
        "latitude": 51.21096,
        "longitude": 3.62838
      },
      {
        "latitude": 50.6814,
        "longitude": 3.89244
      },
      {
        "latitude": 50.66791,
        "longitude": 3.93493
      },
      {
        "latitude": 50.49042,
        "longitude": 3.98156
      },
      {
        "latitude": 50.30944,
        "longitude": 4.47995
      },
      {
        "latitude": 50.24448,
        "longitude": 4.60502
      },
      {
        "latitude": 50.24467,
        "longitude": 4.89999
      },
      {
        "latitude": 50.08735,
        "longitude": 5.04206
      },
      {
        "latitude": 49.99214,
        "longitude": 5.23042
      },
      {
        "latitude": 49.88478,
        "longitude": 5.40994
      },
      {
        "latitude": 49.85797,
        "longitude": 5.46178
      },
      {
        "latitude": 49.86279,
        "longitude": 5.7196
      },
      {
        "latitude": 49.83259,
        "longitude": 5.74151
      },
      {
        "latitude": 50.22239,
        "longitude": 5.9387
      },
      {
        "latitude": 50.0011,
        "longitude": 6.08535
      },
      {
        "latitude": 50.04616,
        "longitude": 6.12089
      },
      {
        "latitude": 50.09472,
        "longitude": 6.28373
      },
      {
        "latitude": 49.95863,
        "longitude": 6.51654
      },
      {
        "latitude": 50.00485,
        "longitude": 6.61034
      },
      {
        "latitude": 50.00587,
        "longitude": 6.70295
      },
      {
        "latitude": 50.2947,
        "longitude": 6.65865
      },
      {
        "latitude": 50.36903,
        "longitude": 6.79276
      },
      {
        "latitude": 50.31614,
        "longitude": 7.32163
      },
      {
        "latitude": 50.36737,
        "longitude": 7.58782
      },
      {
        "latitude": 50.46919,
        "longitude": 7.7626
      },
      {
        "latitude": 50.96246,
        "longitude": 7.9826
      },
      {
        "latitude": 51.07086,
        "longitude": 7.55924
      },
      {
        "latitude": 51.36614,
        "longitude": 7.58138
      },
      {
        "latitude": 51.52015,
        "longitude": 7.67861
      },
      {
        "latitude": 51.65781,
        "longitude": 7.35175
      },
      {
        "latitude": 51.81916,
        "longitude": 7.21664
      },
      {
        "latitude": 51.9587,
        "longitude": 7.0467
      },
      {
        "latitude": 51.82713,
        "longitude": 6.67267
      },
      {
        "latitude": 51.81133,
        "longitude": 6.48424
      },
      {
        "latitude": 51.9368,
        "longitude": 6.27316
      },
      {
        "latitude": 52.01701,
        "longitude": 6.14452
      },
      {
        "latitude": 52.20847,
        "longitude": 6.09312
      },
      {
        "latitude": 52.23705,
        "longitude": 6.01297
      }
    ]
  }
}

Definisi

Nama Deskripsi
EffectiveSetting

Parameter atau data efektif yang digunakan saat memanggil Route API ini.

ErrorAdditionalInfo

Info tambahan kesalahan manajemen sumber daya.

ErrorDetail

Detail kesalahan.

ErrorResponse

Respons kesalahan

InclineLevel

Tingkat kebukitan untuk rute yang mendebarkan. Parameter ini hanya dapat digunakan bersama dengan routeType=thrilling.

LatLongPair

Lokasi yang direpresentasikan sebagai garis lintang dan bujur.

ResponseFormat

Format respons yang diinginkan. Nilai dapat berupa json atau xml.

RouteAvoidType

Menentukan sesuatu yang harus dihindari oleh perhitungan rute saat menentukan rute. Dapat ditentukan beberapa kali dalam satu permintaan, misalnya, '&avoid=motorways&avoid=tollRoads&avoid=ferries'. Dalam permintaan Rentang Rute, nilai yang sudah DigunakanRoads tidak boleh digunakan.

RouteRange

Rentang yang Dapat Dijangkau

RouteRangeResult

Objek ini dikembalikan dari panggilan Rentang Yang Dapat Dijangkau Rute yang berhasil

RouteReport

Melaporkan pengaturan efektif yang digunakan dalam panggilan saat ini.

RouteType

Jenis rute yang diminta.

TravelMode

Mode perjalanan untuk rute yang diminta. Jika tidak ditentukan, defaultnya adalah 'mobil'. Perhatikan bahwa travelMode yang diminta mungkin tidak tersedia untuk seluruh rute. Jika travelMode yang diminta tidak tersedia untuk bagian tertentu, elemen travelMode dari respons untuk bagian tersebut akan menjadi "lainnya". Perhatikan bahwa mode perjalanan bus, sepeda motor, taksi, dan van adalah fungsionalitas BETA. Data pembatasan penuh tidak tersedia di semua area.

VehicleEngineType

Jenis mesin kendaraan. Ketika Model Konsumsi terperinci ditentukan, model tersebut harus konsisten dengan nilai vehicleEngineType.

VehicleLoadType

Jenis kargo yang mungkin diklasifikasikan sebagai bahan berbahaya dan dibatasi dari beberapa jalan. Nilai vehicleLoadType yang tersedia adalah kelas Hazmat AS 1 hingga 9, ditambah klasifikasi generik untuk digunakan di negara/wilayah lain. Nilai yang dimulai dengan USHazmat adalah untuk perutean AS sementara otherHazmat harus digunakan untuk semua negara/wilayah lain. vehicleLoadType dapat ditentukan beberapa kali. Parameter ini saat ini hanya dipertimbangkan untuk travelMode=truck.

WindingnessLevel

Tingkat belokan untuk rute yang mendebarkan. Parameter ini hanya dapat digunakan bersama dengan routeType=thrilling.

EffectiveSetting

Parameter atau data efektif yang digunakan saat memanggil Route API ini.

Nama Jenis Deskripsi
key

string

Nama parameter yang digunakan.

value

string

Nilai parameter yang digunakan.

ErrorAdditionalInfo

Info tambahan kesalahan manajemen sumber daya.

Nama Jenis Deskripsi
info

object

Info tambahan.

type

string

Jenis info tambahan.

ErrorDetail

Detail kesalahan.

Nama Jenis Deskripsi
additionalInfo

ErrorAdditionalInfo[]

Info tambahan kesalahan.

code

string

Kode kesalahan.

details

ErrorDetail[]

Detail kesalahan.

message

string

Pesan kesalahan.

target

string

Target kesalahan.

ErrorResponse

Respons kesalahan

Nama Jenis Deskripsi
error

ErrorDetail

Objek kesalahan.

InclineLevel

Tingkat kebukitan untuk rute yang mendebarkan. Parameter ini hanya dapat digunakan bersama dengan routeType=thrilling.

Nama Jenis Deskripsi
high

string

tinggi

low

string

rendah

normal

string

normal

LatLongPair

Lokasi yang direpresentasikan sebagai garis lintang dan bujur.

Nama Jenis Deskripsi
latitude

number

Properti garis lintang

longitude

number

Properti garis bujur

ResponseFormat

Format respons yang diinginkan. Nilai dapat berupa json atau xml.

Nama Jenis Deskripsi
json

string

Format Pertukaran Data Notasi Objek JavaScript

xml

string

Bahasa Markup yang Dapat Diperluas

RouteAvoidType

Menentukan sesuatu yang harus dihindari oleh perhitungan rute saat menentukan rute. Dapat ditentukan beberapa kali dalam satu permintaan, misalnya, '&avoid=motorways&avoid=tollRoads&avoid=ferries'. Dalam permintaan Rentang Rute, nilai yang sudah DigunakanRoads tidak boleh digunakan.

Nama Jenis Deskripsi
alreadyUsedRoads

string

Menghindari penggunaan jalan yang sama beberapa kali. Paling berguna bersama dengan routeType=mendebarkan.

borderCrossings

string

Menghindari persimpangan batas dalam perhitungan rute.

carpools

string

Menghindari rute yang memerlukan penggunaan jalur carpool (HOV/High Occupancy Vehicle).

ferries

string

Menghindari feri

motorways

string

Menghindari jalan raya

tollRoads

string

Menghindari jalan tol.

unpavedRoads

string

Menghindari jalan yang belum diaspal

RouteRange

Rentang yang Dapat Dijangkau

Nama Jenis Deskripsi
boundary

LatLongPair[]

Batas poligon dari rentang yang dapat dijangkau diwakili sebagai daftar titik.

center

LatLongPair

Titik tengah rentang yang dapat dijangkau

RouteRangeResult

Objek ini dikembalikan dari panggilan Rentang Yang Dapat Dijangkau Rute yang berhasil

Nama Jenis Deskripsi
formatVersion

string

Properti Format Versi

reachableRange

RouteRange

Rentang yang Dapat Dijangkau

report

RouteReport

Melaporkan pengaturan efektif yang digunakan dalam panggilan saat ini.

RouteReport

Melaporkan pengaturan efektif yang digunakan dalam panggilan saat ini.

Nama Jenis Deskripsi
effectiveSettings

EffectiveSetting[]

Parameter atau data efektif yang digunakan saat memanggil Route API ini.

RouteType

Jenis rute yang diminta.

Nama Jenis Deskripsi
eco

string

Rute yang diseimbangkan oleh ekonomi dan kecepatan.

fastest

string

Rute tercepat.

shortest

string

Rute terpendek menurut jarak.

thrilling

string

Termasuk jalan yang menarik atau menantang dan menggunakan jalan tol sesedikat mungkin. Anda dapat memilih tingkat belokan yang disertakan dan juga tingkat kebukitan. Lihat parameter hilliness dan windingness untuk cara mengatur ini. Ada batas 900 km pada rute yang direncanakan dengan routeType=mendebarkan

TravelMode

Mode perjalanan untuk rute yang diminta. Jika tidak ditentukan, defaultnya adalah 'mobil'. Perhatikan bahwa travelMode yang diminta mungkin tidak tersedia untuk seluruh rute. Jika travelMode yang diminta tidak tersedia untuk bagian tertentu, elemen travelMode dari respons untuk bagian tersebut akan menjadi "lainnya". Perhatikan bahwa mode perjalanan bus, sepeda motor, taksi, dan van adalah fungsionalitas BETA. Data pembatasan penuh tidak tersedia di semua area.

Nama Jenis Deskripsi
bus

string

Rute yang dikembalikan dioptimalkan untuk bus, termasuk penggunaan jalur bus saja. Fungsionalitas BETA.

car

string

Rute yang dikembalikan dioptimalkan untuk mobil.

motorcycle

string

Rute yang dikembalikan dioptimalkan untuk sepeda motor. Fungsionalitas BETA.

taxi

string

Rute yang dikembalikan dioptimalkan untuk taksi. Fungsionalitas BETA.

truck

string

Rute yang dikembalikan dioptimalkan untuk kendaraan komersial, seperti untuk truk.

van

string

Rute yang dikembalikan dioptimalkan untuk van. Fungsionalitas BETA.

VehicleEngineType

Jenis mesin kendaraan. Ketika Model Konsumsi terperinci ditentukan, model tersebut harus konsisten dengan nilai vehicleEngineType.

Nama Jenis Deskripsi
combustion

string

Mesin pembakaran internal.

electric

string

Mesin listrik.

VehicleLoadType

Jenis kargo yang mungkin diklasifikasikan sebagai bahan berbahaya dan dibatasi dari beberapa jalan. Nilai vehicleLoadType yang tersedia adalah kelas Hazmat AS 1 hingga 9, ditambah klasifikasi generik untuk digunakan di negara/wilayah lain. Nilai yang dimulai dengan USHazmat adalah untuk perutean AS sementara otherHazmat harus digunakan untuk semua negara/wilayah lain. vehicleLoadType dapat ditentukan beberapa kali. Parameter ini saat ini hanya dipertimbangkan untuk travelMode=truck.

Nama Jenis Deskripsi
USHazmatClass1

string

Bahan peledak

USHazmatClass2

string

Gas terkompresi

USHazmatClass3

string

Cairan mudah terbakar

USHazmatClass4

string

Padatan yang mudah terbakar

USHazmatClass5

string

Oksidator

USHazmatClass6

string

Racun

USHazmatClass7

string

Radioaktif

USHazmatClass8

string

Korosif

USHazmatClass9

string

Lain-lain

otherHazmatExplosive

string

Bahan peledak

otherHazmatGeneral

string

Lain-lain

otherHazmatHarmfulToWater

string

Berbahaya bagi air

WindingnessLevel

Tingkat belokan untuk rute yang mendebarkan. Parameter ini hanya dapat digunakan bersama dengan routeType=thrilling.

Nama Jenis Deskripsi
high

string

tinggi

low

string

rendah

normal

string

normal