Share via

RouteGetRouteDirectionsOptionalParams interface

  • Referensi
Paket:
azure-maps-rest

Parameter opsional.

Extends

RequestOptionsBase

Properti

accelerationEfficiency

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 Yang Masuk Akal : untuk Model Pembakaran : 0,33, untuk Model Listrik : 0,66
alternativeType

Mengontrol optimalitas, sehubungan dengan kriteria perencanaan yang diberikan, dari alternatif yang dihitung dibandingkan dengan rute referensi. Nilai yang mungkin termasuk: 'anyRoute', 'betterRoute'
arriveAt

Tanggal dan waktu kedatangan di titik tujuan. Ini harus ditentukan sebagai dateTime. Ketika offset zona waktu tidak ditentukan, itu akan diasumsikan sebagai titik tujuan. Nilai arriveAt harus di masa mendatang. Parameter arriveAt tidak dapat digunakan bersama dengan departAt, minDeviationDistance, atau minDeviationTime.
auxiliaryPowerInkW

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

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

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 calculateReachableRange, nilai yang sudah DigunakanRoads tidak boleh digunakan. Nilai yang mungkin termasuk: 'tollRoads', 'motorways', 'feri', 'unpavedRoads', 'carpools', 'alreadyUsedRoads', 'borderCrossings'
computeBestOrder

Pesan ulang titik arah rute untuk mengurangi panjang rute. Menghasilkan hasil terbaik saat digunakan bersama dengan routeType terpendek. Nilai yang mungkin benar atau salah. True menghitung urutan yang lebih baik jika memungkinkan, tetapi tidak diizinkan untuk digunakan bersama dengan nilai maxAlternatives yang lebih besar dari 0 atau bersama dengan titik arah lingkaran. False akan menggunakan lokasi dalam urutan yang diberikan dan tidak diizinkan untuk digunakan bersama dengan routeRepresentation none.
computeTravelTimeFor

Menentukan apakah akan mengembalikan waktu perjalanan tambahan menggunakan berbagai jenis informasi lalu lintas (tidak ada, historis, langsung) serta waktu perjalanan perkiraan terbaik default. Nilai yang mungkin termasuk: 'none', 'all'
constantSpeedConsumptionInkWhPerHundredkm

Menentukan komponen konsumsi yang bergantung pada kecepatan. Disediakan sebagai daftar pasangan kecepatan/tingkat konsumsi yang tidak diurutkan. Daftar 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 jika tidak, dengan asumsi konstanta (ΔConsumption/ΔSpeed) ditentukan oleh dua titik terdekat dalam daftar

Daftar harus berisi antara 1 dan 25 titik (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 yang terpenultiasi. 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

Menentukan komponen konsumsi yang bergantung pada kecepatan. Disediakan sebagai daftar yang tidak diurutkan dari pasangan kecepatan yang dibatasi titik dua & pasangan tingkat konsumsi. Daftar 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 jika tidak, dengan asumsi konstanta (ΔConsumption/ΔSpeed) ditentukan oleh dua titik terdekat dalam daftar

Daftar harus berisi antara 1 dan 25 titik (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 yang terpenultiasi. 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

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

Menentukan pasokan bahan bakar saat ini dalam liter. Nilai Masuk Akal : 55
decelerationEfficiency

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/accelerationEfficiency.

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

Tanggal dan waktu keberangkatan dari titik asal. Waktu keberangkatan selain dari sekarang harus ditentukan sebagai dateTime. Ketika offset zona waktu tidak ditentukan, itu akan diasumsikan sebagai titik asal. Nilai departAt harus di masa mendatang dalam format tanggal-waktu (1996-12-19T16:39:57-08:00).
downhillEfficiency

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 Yang Masuk Akal : untuk Model Pembakaran : 0,51, untuk Model Listrik : 0,73
fuelEnergyDensityInMJoulesPerLiter

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

Tingkat kebukitan untuk rute yang mendebarkan. Parameter ini hanya dapat digunakan bersama dengan routeType=thrilling. Nilai yang mungkin termasuk: 'rendah', 'normal', 'tinggi'
instructionsType

Jika ditentukan, instruksi panduan akan dikembalikan. Perhatikan bahwa parameter instructionsType tidak dapat digunakan bersama dengan routeRepresentation=none. Nilai yang mungkin termasuk: 'coded', 'text', 'tagged'
language

Parameter bahasa menentukan bahasa pesan panduan. Ini tidak mempengaruhi kata benda yang tepat (nama jalan, plaza, dll.) Ini tidak berpengaruh ketika instruksiType=dikodekan. Nilai yang diizinkan adalah (subset dari) tag bahasa IETF yang dijelaskan
maxAlternatives

Jumlah rute alternatif yang diinginkan untuk dihitung. Default: 0, minimum: 0 dan maksimum: 5
maxChargeInkWh

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
minDeviationDistance

Semua rute alternatif yang dikembalikan akan mengikuti rute referensi (lihat bagian Post Requests) dari titik asal permintaan calculateRoute untuk setidaknya jumlah meter ini. Hanya dapat digunakan saat mengkonstruksi ulang rute. Parameter minDeviationDistance tidak dapat digunakan bersama dengan arriveAt
minDeviationTime

Semua rute alternatif yang dikembalikan akan mengikuti rute referensi (lihat bagian Permintaan POST) dari titik asal permintaan calculateRoute setidaknya selama jumlah detik ini. Hanya dapat digunakan saat mengkonstruksi ulang rute. Parameter minDeviationTime tidak dapat digunakan bersama dengan arriveAt
report

Menentukan data mana yang harus dilaporkan untuk tujuan diagnosis. Satu-satunya nilai yang mungkin adalah effectiveSettings. Melaporkan parameter atau data efektif yang digunakan saat memanggil API. Dalam kasus parameter default, default akan tercermin di mana parameter tidak ditentukan oleh pemanggil.
routeRepresentation

Menentukan representasi kumpulan rute yang disediakan sebagai respons. Nilai parameter ini hanya dapat digunakan bersama dengan computeBestOrder=true. Nilai yang mungkin termasuk: 'polyline', 'summaryOnly', 'none'
routeType

Jenis rute yang diminta. Nilai yang mungkin termasuk: 'tercepat', 'terpendek', 'eco', 'mendebarkan'
sectionType

Menentukan jenis bagian mana yang dilaporkan dalam respons rute.

Misalnya jika sectionType = pedestrian, bagian yang cocok untuk pejalan kaki hanya dikembalikan. Beberapa jenis dapat digunakan. SectionType default mengacu pada input travelMode. Secara default travelMode diatur ke mobil. Nilai yang mungkin termasuk: 'carTrain', 'country', 'ferry', 'motorway', 'pedestrian', 'tollRoad', 'tollVignette', 'traffic', 'travelMode', 'tunnel'
traffic

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

Mode perjalanan untuk rute yang diminta. 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 yang lain. Perhatikan bahwa mode perjalanan bus, sepeda motor, taksi, dan van adalah fungsionalitas BETA. Data pembatasan penuh tidak tersedia di semua area. Dalam permintaan calculateReachableRange , nilai sepeda dan pejalan kaki tidak boleh digunakan. Nilai yang mungkin termasuk: 'mobil', 'truk', 'taksi', 'bus', 'van', 'sepeda motor', 'sepeda', 'pejalan kaki'
uphillEfficiency

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 Yang Masuk Akal : untuk Model Pembakaran : 0,27, untuk Model Listrik : 0,74
vehicleAxleWeight

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

Kendaraan digunakan untuk tujuan komersial dan dengan demikian mungkin tidak diizinkan untuk mengemudi di beberapa jalan.
vehicleEngineType

Jenis mesin kendaraan. Ketika Model Konsumsi terperinci ditentukan, model tersebut harus konsisten dengan nilai vehicleEngineType. Nilai yang mungkin termasuk: 'pembakaran', 'listrik'
vehicleHeading

Arah menuju kendaraan dalam derajat mulai dari utara benar dan melanjutkan ke arah searah jarang. Utara adalah 0 derajat, timur adalah 90 derajat, selatan adalah 180 derajat, barat adalah 270 derajat. Kemungkinan nilai 0-359
vehicleHeight

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

Panjang kendaraan dalam meter. Nilai 0 berarti bahwa pembatasan panjang tidak dipertimbangkan.
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 lain. Nilai yang dimulai dengan USHazmat adalah untuk perutean AS sementara otherHazmat harus digunakan untuk semua negara lain. vehicleLoadType dapat ditentukan beberapa kali. Parameter ini saat ini hanya dipertimbangkan untuk travelMode=truck. Nilai yang mungkin termasuk: 'USHazmatClass1', 'USHazmatClass2', 'USHazmatClass3', 'USHazmatClass4', 'USHazmatClass5', 'USHazmatClass6', 'USHazmatClass7', 'USHazmatClass8', 'USHazmatClass9', 'otherHazmatExplosive', 'otherHazmatGeneral', 'otherHazmatHarmfulToWater'
vehicleMaxSpeed

Kecepatan maksimum kendaraan dalam km/jam. Nilai 0 berarti bahwa nilai yang sesuai untuk kendaraan akan ditentukan dan diterapkan selama perencanaan rute. Nilai bukan nol dapat ditimpa selama perencanaan rute.
vehicleWeight

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

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

Tingkat belokan untuk rute yang mendebarkan. Parameter ini hanya dapat digunakan bersama dengan routeType=thrilling. Nilai yang mungkin termasuk: 'rendah', 'normal', 'tinggi'

Properti yang Diwariskan

abortSignal

Sinyal yang dapat digunakan untuk membatalkan permintaan.
customHeaders

{object} [CustomHeaders] Header permintaan kustom yang ditentukan pengguna yang akan diterapkan sebelum permintaan dikirim.
onDownloadProgress

Panggilan balik yang diaktifkan setelah kemajuan pengunduhan.
onUploadProgress

Panggilan balik yang diaktifkan setelah kemajuan pengunggahan.
timeout

Jumlah milidetik yang dapat diambil permintaan sebelum dihentikan secara otomatis.

Detail Properti

accelerationEfficiency

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 Yang Masuk Akal : untuk Model Pembakaran : 0,33, untuk Model Listrik : 0,66

accelerationEfficiency?: number

Nilai Properti

number

alternativeType

Mengontrol optimalitas, sehubungan dengan kriteria perencanaan yang diberikan, dari alternatif yang dihitung dibandingkan dengan rute referensi. Nilai yang mungkin termasuk: 'anyRoute', 'betterRoute'

alternativeType?: AlternativeRouteType

Nilai Properti

AlternativeRouteType

arriveAt

Tanggal dan waktu kedatangan di titik tujuan. Ini harus ditentukan sebagai dateTime. Ketika offset zona waktu tidak ditentukan, itu akan diasumsikan sebagai titik tujuan. Nilai arriveAt harus di masa mendatang. Parameter arriveAt tidak dapat digunakan bersama dengan departAt, minDeviationDistance, atau minDeviationTime.

arriveAt?: Date

Nilai Properti

Date

auxiliaryPowerInkW

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

auxiliaryPowerInkW?: string

Nilai Properti

string

auxiliaryPowerInLitersPerHour

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

auxiliaryPowerInLitersPerHour?: number

Nilai Properti

number

avoid

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 calculateReachableRange, nilai yang sudah DigunakanRoads tidak boleh digunakan. Nilai yang mungkin termasuk: 'tollRoads', 'motorways', 'feri', 'unpavedRoads', 'carpools', 'alreadyUsedRoads', 'borderCrossings'

avoid?: Avoid[]

Nilai Properti

Avoid[]

computeBestOrder

Pesan ulang titik arah rute untuk mengurangi panjang rute. Menghasilkan hasil terbaik saat digunakan bersama dengan routeType terpendek. Nilai yang mungkin benar atau salah. True menghitung urutan yang lebih baik jika memungkinkan, tetapi tidak diizinkan untuk digunakan bersama dengan nilai maxAlternatives yang lebih besar dari 0 atau bersama dengan titik arah lingkaran. False akan menggunakan lokasi dalam urutan yang diberikan dan tidak diizinkan untuk digunakan bersama dengan routeRepresentation none.

computeBestOrder?: boolean

Nilai Properti

boolean

computeTravelTimeFor

Menentukan apakah akan mengembalikan waktu perjalanan tambahan menggunakan berbagai jenis informasi lalu lintas (tidak ada, historis, langsung) serta waktu perjalanan perkiraan terbaik default. Nilai yang mungkin termasuk: 'none', 'all'

computeTravelTimeFor?: ComputeTravelTimeFor

Nilai Properti

ComputeTravelTimeFor

constantSpeedConsumptionInkWhPerHundredkm

Menentukan komponen konsumsi yang bergantung pada kecepatan. Disediakan sebagai daftar pasangan kecepatan/tingkat konsumsi yang tidak diurutkan. Daftar 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 jika tidak, dengan asumsi konstanta (ΔConsumption/ΔSpeed) ditentukan oleh dua titik terdekat dalam daftar

Daftar harus berisi antara 1 dan 25 titik (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 yang terpenultiasi. 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.

constantSpeedConsumptionInkWhPerHundredkm?: string

Nilai Properti

string

constantSpeedConsumptionInLitersPerHundredkm

Menentukan komponen konsumsi yang bergantung pada kecepatan. Disediakan sebagai daftar yang tidak diurutkan dari pasangan kecepatan yang dibatasi titik dua & pasangan tingkat konsumsi. Daftar 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 jika tidak, dengan asumsi konstanta (ΔConsumption/ΔSpeed) ditentukan oleh dua titik terdekat dalam daftar

Daftar harus berisi antara 1 dan 25 titik (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 yang terpenultiasi. 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.

constantSpeedConsumptionInLitersPerHundredkm?: number

Nilai Properti

number

currentChargeInkWh

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

currentChargeInkWh?: string

Nilai Properti

string

currentFuelInLiters

Menentukan pasokan bahan bakar saat ini dalam liter. Nilai Masuk Akal : 55

currentFuelInLiters?: number

Nilai Properti

number

decelerationEfficiency

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/accelerationEfficiency.

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

decelerationEfficiency?: number

Nilai Properti

number

departAt

Tanggal dan waktu keberangkatan dari titik asal. Waktu keberangkatan selain dari sekarang harus ditentukan sebagai dateTime. Ketika offset zona waktu tidak ditentukan, itu akan diasumsikan sebagai titik asal. Nilai departAt harus di masa mendatang dalam format tanggal-waktu (1996-12-19T16:39:57-08:00).

departAt?: Date

Nilai Properti

Date

downhillEfficiency

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 Yang Masuk Akal : untuk Model Pembakaran : 0,51, untuk Model Listrik : 0,73

downhillEfficiency?: number

Nilai Properti

number

fuelEnergyDensityInMJoulesPerLiter

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

fuelEnergyDensityInMJoulesPerLiter?: number

Nilai Properti

number

hilliness

Tingkat kebukitan untuk rute yang mendebarkan. Parameter ini hanya dapat digunakan bersama dengan routeType=thrilling. Nilai yang mungkin termasuk: 'rendah', 'normal', 'tinggi'

hilliness?: Hilliness

Nilai Properti

Hilliness

instructionsType

Jika ditentukan, instruksi panduan akan dikembalikan. Perhatikan bahwa parameter instructionsType tidak dapat digunakan bersama dengan routeRepresentation=none. Nilai yang mungkin termasuk: 'coded', 'text', 'tagged'

instructionsType?: RouteInstructionsType

Nilai Properti

RouteInstructionsType

language

Parameter bahasa menentukan bahasa pesan panduan. Ini tidak mempengaruhi kata benda yang tepat (nama jalan, plaza, dll.) Ini tidak berpengaruh ketika instruksiType=dikodekan. Nilai yang diizinkan adalah (subset dari) tag bahasa IETF yang dijelaskan

language?: string

Nilai Properti

string

maxAlternatives

Jumlah rute alternatif yang diinginkan untuk dihitung. Default: 0, minimum: 0 dan maksimum: 5

maxAlternatives?: number

Nilai Properti

number

maxChargeInkWh

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

maxChargeInkWh?: string

Nilai Properti

string

minDeviationDistance

Semua rute alternatif yang dikembalikan akan mengikuti rute referensi (lihat bagian Post Requests) dari titik asal permintaan calculateRoute untuk setidaknya jumlah meter ini. Hanya dapat digunakan saat mengkonstruksi ulang rute. Parameter minDeviationDistance tidak dapat digunakan bersama dengan arriveAt

minDeviationDistance?: number

Nilai Properti

number

minDeviationTime

Semua rute alternatif yang dikembalikan akan mengikuti rute referensi (lihat bagian Permintaan POST) dari titik asal permintaan calculateRoute setidaknya selama jumlah detik ini. Hanya dapat digunakan saat mengkonstruksi ulang rute. Parameter minDeviationTime tidak dapat digunakan bersama dengan arriveAt

minDeviationTime?: number

Nilai Properti

number

report

Menentukan data mana yang harus dilaporkan untuk tujuan diagnosis. Satu-satunya nilai yang mungkin adalah effectiveSettings. Melaporkan parameter atau data efektif yang digunakan saat memanggil API. Dalam kasus parameter default, default akan tercermin di mana parameter tidak ditentukan oleh pemanggil.

report?: string

Nilai Properti

string

routeRepresentation

Menentukan representasi kumpulan rute yang disediakan sebagai respons. Nilai parameter ini hanya dapat digunakan bersama dengan computeBestOrder=true. Nilai yang mungkin termasuk: 'polyline', 'summaryOnly', 'none'

routeRepresentation?: RouteRepresentation

Nilai Properti

RouteRepresentation

routeType

Jenis rute yang diminta. Nilai yang mungkin termasuk: 'tercepat', 'terpendek', 'eco', 'mendebarkan'

routeType?: RouteType

Nilai Properti

RouteType

sectionType

Menentukan jenis bagian mana yang dilaporkan dalam respons rute.

Misalnya jika sectionType = pedestrian, bagian yang cocok untuk pejalan kaki hanya dikembalikan. Beberapa jenis dapat digunakan. SectionType default mengacu pada input travelMode. Secara default travelMode diatur ke mobil. Nilai yang mungkin termasuk: 'carTrain', 'country', 'ferry', 'motorway', 'pedestrian', 'tollRoad', 'tollVignette', 'traffic', 'travelMode', 'tunnel'

sectionType?: SectionType

Nilai Properti

SectionType

traffic

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.
traffic?: boolean

Nilai Properti

boolean

travelMode

Mode perjalanan untuk rute yang diminta. 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 yang lain. Perhatikan bahwa mode perjalanan bus, sepeda motor, taksi, dan van adalah fungsionalitas BETA. Data pembatasan penuh tidak tersedia di semua area. Dalam permintaan calculateReachableRange , nilai sepeda dan pejalan kaki tidak boleh digunakan. Nilai yang mungkin termasuk: 'mobil', 'truk', 'taksi', 'bus', 'van', 'sepeda motor', 'sepeda', 'pejalan kaki'

travelMode?: TravelMode

Nilai Properti

TravelMode

uphillEfficiency

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 Yang Masuk Akal : untuk Model Pembakaran : 0,27, untuk Model Listrik : 0,74

uphillEfficiency?: number

Nilai Properti

number

vehicleAxleWeight

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

vehicleAxleWeight?: number

Nilai Properti

number

vehicleCommercial

Kendaraan digunakan untuk tujuan komersial dan dengan demikian mungkin tidak diizinkan untuk mengemudi di beberapa jalan.

vehicleCommercial?: boolean

Nilai Properti

boolean

vehicleEngineType

Jenis mesin kendaraan. Ketika Model Konsumsi terperinci ditentukan, model tersebut harus konsisten dengan nilai vehicleEngineType. Nilai yang mungkin termasuk: 'pembakaran', 'listrik'

vehicleEngineType?: VehicleEngineType

Nilai Properti

VehicleEngineType

vehicleHeading

Arah menuju kendaraan dalam derajat mulai dari utara benar dan melanjutkan ke arah searah jarang. Utara adalah 0 derajat, timur adalah 90 derajat, selatan adalah 180 derajat, barat adalah 270 derajat. Kemungkinan nilai 0-359

vehicleHeading?: number

Nilai Properti

number

vehicleHeight

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

vehicleHeight?: number

Nilai Properti

number

vehicleLength

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

vehicleLength?: number

Nilai Properti

number

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 lain. Nilai yang dimulai dengan USHazmat adalah untuk perutean AS sementara otherHazmat harus digunakan untuk semua negara lain. vehicleLoadType dapat ditentukan beberapa kali. Parameter ini saat ini hanya dipertimbangkan untuk travelMode=truck. Nilai yang mungkin termasuk: 'USHazmatClass1', 'USHazmatClass2', 'USHazmatClass3', 'USHazmatClass4', 'USHazmatClass5', 'USHazmatClass6', 'USHazmatClass7', 'USHazmatClass8', 'USHazmatClass9', 'otherHazmatExplosive', 'otherHazmatGeneral', 'otherHazmatHarmfulToWater'

vehicleLoadType?: VehicleLoadType

Nilai Properti

VehicleLoadType

vehicleMaxSpeed

Kecepatan maksimum kendaraan dalam km/jam. Nilai 0 berarti bahwa nilai yang sesuai untuk kendaraan akan ditentukan dan diterapkan selama perencanaan rute. Nilai bukan nol dapat ditimpa selama perencanaan rute.

vehicleMaxSpeed?: number

Nilai Properti

number

vehicleWeight

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

vehicleWeight?: number

Nilai Properti

number

vehicleWidth

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

vehicleWidth?: number

Nilai Properti

number

windingness

Tingkat belokan untuk rute yang mendebarkan. Parameter ini hanya dapat digunakan bersama dengan routeType=thrilling. Nilai yang mungkin termasuk: 'rendah', 'normal', 'tinggi'

windingness?: Windingness

Nilai Properti

Windingness

Detail Properti yang Diwariskan

abortSignal

Sinyal yang dapat digunakan untuk membatalkan permintaan.

abortSignal?: AbortSignalLike

Nilai Properti

AbortSignalLike

Diwarisi Dari RequestOptionsBase.abortSignal

customHeaders

{object} [CustomHeaders] Header permintaan kustom yang ditentukan pengguna yang akan diterapkan sebelum permintaan dikirim.

customHeaders?: [key: string]: string

Nilai Properti

[key: string]: string

Diwarisi Dari RequestOptionsBase.customHeaders

onDownloadProgress

Panggilan balik yang diaktifkan setelah kemajuan pengunduhan.

onDownloadProgress?: (progress: TransferProgressEvent) => void

Nilai Properti

(progress: TransferProgressEvent) => void

Diwarisi Dari RequestOptionsBase.onDownloadProgress

onUploadProgress

Panggilan balik yang diaktifkan setelah kemajuan pengunggahan.

onUploadProgress?: (progress: TransferProgressEvent) => void

Nilai Properti

(progress: TransferProgressEvent) => void

Diwarisi Dari RequestOptionsBase.onUploadProgress

timeout

Jumlah milidetik yang dapat diambil permintaan sebelum dihentikan secara otomatis.

timeout?: number

Nilai Properti

number

Diwarisi Dari RequestOptionsBase.timeout