Route - Get Route Range

  • Referensi
Service:
Maps
API Version:
1.0

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 serangkaian 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 jarang 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}
With optional parameters: 
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 yang sudah DigunakanRoads 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 fuelBudgetInLiters 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 as roda 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 mengemudi 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 tol.

  • 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 diatur.

  • 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 Microsoft Entra ID. Ini mewakili ID unik untuk akun Azure Maps dan dapat diambil dari API Akun bidang manajemen Azure Maps. Untuk menggunakan keamanan Microsoft Entra ID di Azure Maps lihat artikel berikut untuk panduan.

Respons

Nama Jenis Deskripsi
200 OK

RouteRangeResult

OK
Other Status Codes

ErrorResponse

Terjadi kesalahan tak terduga.

Keamanan

AADToken

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

Untuk menerapkan skenario, sebaiknya lihat konsep autentikasi. Singkatnya, definisi keamanan ini menyediakan solusi untuk memodelkan 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 diminta 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 Microsoft Entra ID. * Kontrol akses berbasis peran Azure dikonfigurasi dari bidang manajemen Azure melalui portal Azure, PowerShell, CLI, Azure SDK, atau REST API. * Penggunaan Azure Maps Web SDK memungkinkan penyiapan berbasis konfigurasi aplikasi untuk beberapa kasus penggunaan.

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

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

subscription-key

Ini adalah kunci bersama yang disediakan saat Anda Create akun Azure Maps di portal 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 dikeluarkan.

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

Type: apiKey
In: 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 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 halus ke kedaluwarsa, laju, 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 asal tertentu yang diizinkan di sumber daya akun Peta untuk membatasi penyalahgunaan penyalahgunaan dan memperbarui Token SAS secara teratur.

Type: apiKey
In: header

Contoh

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

Sample Request

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

Sample Response

Status code:
200 
{
  "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 alreadyUsedRoads 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 alreadyUsedRoads tidak boleh digunakan.

Nama Jenis Deskripsi
alreadyUsedRoads

string

Menghindari penggunaan jalan yang sama beberapa kali. Paling berguna bersama dengan routeType=thrilling.
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 direpresentasikan sebagai daftar titik.
center

LatLongPair

Titik tengah dari 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 berdasarkan jarak.
thrilling

string

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

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