Delen via

RouteGetRouteDirectionsQueryParamProperties interface

  • Referentie
Pakket:
@azure-rest/maps-route

Eigenschappen

accelerationEfficiency

Hiermee geeft u de efficiëntie van het converteren van chemische energie opgeslagen in brandstof naar kinetische energie wanneer het voertuig versnelt (d.w.w.v. De KinetischeEnergyGained/ChemicalEnergyConsumed). ChemicalEnergyConsumed wordt verkregen door verbruikte brandstof om te zetten in chemische energie met behulp van fuelEnergyDensityInMJoulesPerLiter.

Moet worden gekoppeld aan vertragingsefficiency.

Het toegestane bereik van waarden is 0,0 tot 1/decelerationEfficiency.

Verstandige waarden: voor verbrandingsmodel : 0,33, voor elektrisch model : 0,66
alternativeType

Bepaalt de optimale werking, met betrekking tot de opgegeven planningscriteria, van de berekende alternatieven in vergelijking met de referentieroute.
arriveAt

De datum en tijd van aankomst op het doelpunt dat is opgemaakt als een dateTime-waarde zoals gedefinieerd in RFC 3339, sectie 5,6, met een optionele tijdzone-offset. Wanneer er geen tijdzone-offset wordt opgegeven, wordt ervan uitgegaan dat dit van het doelpunt is.

Voorbeelden:

  • 2023-12-19T16:39:57
  • 2023-12-19T16:39:57-08:00

De parameter arriveAt kan niet worden gebruikt in combinatie met departAt, minDeviationDistance of minDeviationTime.
auxiliaryPowerInkW

Hiermee geeft u de hoeveelheid verbruikt vermogen voor ondersteunende systemen, in kilowatts (kW).

Het kan worden gebruikt om verbruik op te geven als gevolg van apparaten en systemen zoals AC-systemen, radio, verwarming, enz.

Zinnige waarden : 1,7
auxiliaryPowerInLitersPerHour

Hiermee geeft u de hoeveelheid verbruikte brandstof voor ondersteunende systemen van het voertuig, in liter per uur.

Het kan worden gebruikt om verbruik op te geven als gevolg van apparaten en systemen zoals AC-systemen, radio, verwarming, enz.

Zinnige waarden : 0.2
avoid

Hiermee geeft u iets op dat de routeberekening moet proberen te vermijden bij het bepalen van de route. Kan meerdere keren in één aanvraag worden opgegeven, bijvoorbeeld '&vermijd=snelwegen&vermijden=tollRoads&avoid=veerboten'. In routebereikaanvragen mag de waarde alreadyUsedRoads niet worden gebruikt.
computeBestOrder

Rangschik de route-waypoints opnieuw met behulp van een snel heuristisch algoritme om de lengte van de route te verminderen. Geeft de beste resultaten wanneer deze worden gebruikt in combinatie met routeType kortste. U ziet dat oorsprong en bestemming worden uitgesloten van de geoptimaliseerde waypoint-indexen. Als u oorsprong en bestemming in het antwoord wilt opnemen, verhoogt u alle indexen met 1 om rekening te houden met de oorsprong en voegt u vervolgens de bestemming toe als de uiteindelijke index. Mogelijke waarden zijn waar of onwaar. True berekent indien mogelijk een betere volgorde, maar mag niet worden gebruikt in combinatie met de waarde maxAlternatives die groter is dan 0 of in combinatie met cirkel-waypoints. False gebruikt de locaties in de opgegeven volgorde en mag niet worden gebruikt in combinatie met routeRepresentation geen.
computeTravelTimeFor

Hiermee geeft u op of er extra reistijden moeten worden geretourneerd met behulp van verschillende soorten verkeersinformatie (geen, historisch, live) en de standaard best-schatting reistijd.
constantSpeedConsumptionInkWhPerHundredkm

Hiermee geeft u het snelheidsafhankelijke onderdeel van het verbruik.

Geleverd als een niet-geordende lijst met snelheids-/verbruiksfrequentieparen. De lijst definieert punten op een verbruikscurve. Verbruikstarieven voor snelheden die niet in de lijst staan, worden als volgt gevonden:

  • door lineaire interpolatie, als de opgegeven snelheid tussen twee snelheden in de lijst ligt

  • door lineaire extrapolatie anders, uitgaande van een constante (ΔConsumption/ΔSpeed) die wordt bepaald door de dichtstbijzijnde twee punten in de lijst

De lijst moet tussen 1 en 25 punten (inclusief) bevatten en mag geen dubbele punten voor dezelfde snelheid bevatten. Als het slechts één punt bevat, wordt de verbruikssnelheid van dat punt zonder verdere verwerking gebruikt.

Het verbruik dat is opgegeven voor de grootste snelheid moet groter zijn dan of gelijk zijn aan die van de voorlaatste snelheid. Dit zorgt ervoor dat extrapolatie niet leidt tot negatieve verbruikstarieven.

Op dezelfde manier kunnen verbruikswaarden die zijn opgegeven voor de twee kleinste snelheden in de lijst, niet leiden tot een negatief verbruik voor een kleinere snelheid.

Het geldige bereik voor de verbruikswaarden (uitgedrukt in kWh/100km) ligt tussen 0,01 en 100000,0.

Verstandige waarden: 50,8.2:130,21.3

Deze parameter is vereist voor elektrische verbruiksmodel.
constantSpeedConsumptionInLitersPerHundredkm

Hiermee geeft u het snelheidsafhankelijke onderdeel van het verbruik.

Wordt geleverd als een niet-geordende lijst met door dubbele punt gescheiden snelheidsparen & verbruiksfrequentieparen. De lijst definieert punten op een verbruikscurve. Verbruikstarieven voor snelheden die niet in de lijst staan, worden als volgt gevonden:

  • door lineaire interpolatie, als de opgegeven snelheid tussen twee snelheden in de lijst ligt

  • door lineaire extrapolatie anders, uitgaande van een constante (ΔConsumption/ΔSpeed) die wordt bepaald door de dichtstbijzijnde twee punten in de lijst

De lijst moet tussen 1 en 25 punten (inclusief) bevatten en mag geen dubbele punten voor dezelfde snelheid bevatten. Als het slechts één punt bevat, wordt de verbruikssnelheid van dat punt zonder verdere verwerking gebruikt.

Het verbruik dat is opgegeven voor de grootste snelheid moet groter zijn dan of gelijk zijn aan die van de voorlaatste snelheid. Dit zorgt ervoor dat extrapolatie niet leidt tot negatieve verbruikstarieven.

Op dezelfde manier kunnen verbruikswaarden die zijn opgegeven voor de twee kleinste snelheden in de lijst, niet leiden tot een negatief verbruik voor een kleinere snelheid.

Het geldige bereik voor de verbruikswaarden (uitgedrukt in l/100km) ligt tussen 0,01 en 100000,0.

Verstandige waarden: 50,6.3:130,11,5

Opmerking: deze parameter is vereist voor het verbrandingsverbruiksmodel.
currentChargeInkWh

Hiermee geeft u de huidige elektrische energietoevoer in kilowatturen (kWh).

Deze parameter bestaat samen met maxChargeInkWh parameter.

Het toegestane waardenbereik is 0,0 tot maxChargeInkWh.

Verstandige waarden : 43
currentFuelInLiters

Hiermee geeft u de huidige toevoer van brandstof in liter.

Verstandige waarden : 55
decelerationEfficiency

Hiermee geeft u de efficiëntie van het converteren van kinetische energie naar opgeslagen (niet verbruikte) brandstof wanneer het voertuig vertraagt (d.w.w.v. ChemicalEnergySaved/KinetischeEnergyLost). ChemicalEnergySaved wordt verkregen door opgeslagen (niet verbruikte) brandstof te converteren naar energie met behulp van fuelEnergyDensityInMJoulesPerLiter.

Moet worden gekoppeld aan accelerationEfficiency.

Het toegestane bereik van waarden is 0,0 tot 1/accelerationEfficiency.

Verstandige waarden: voor verbrandingsmodel : 0,83, voor elektrisch model : 0,91
departAt

De datum en tijd van vertrek van het oorspronkelijke punt die zijn opgemaakt als een dateTime waarde zoals gedefinieerd in RFC 3339, sectie 5,6, met een optionele tijdzone-offset. Wanneer er geen tijdzone-offset is opgegeven, wordt ervan uitgegaan dat deze van het oorspronkelijke punt is.

  • Standaardwaarde: nu
  • Andere waarde: dateTime

Voorbeelden:

  • 2023-12-19T16:39:57
  • 2023-12-19T16:39:57-08:00

De parameter departAt kan niet worden gebruikt in combinatie met arriveAt.
downhillEfficiency

Hiermee geeft u de efficiëntie van het converteren van potentiële energie naar opgeslagen (niet verbruikte) brandstof wanneer het voertuig verhoging verliest (d.w. ChemicalEnergySaved/PotentialEnergyLost). ChemicalEnergySaved wordt verkregen door opgeslagen (niet verbruikte) brandstof te converteren naar energie met behulp van fuelEnergyDensityInMJoulesPerLiter.

Moet worden gekoppeld aan uphillEfficiency.

Het toegestane waardenbereik is 0,0 tot 1/uphillEfficiency.

Verstandige waarden: voor verbrandingsmodel : 0,51, voor elektrisch model : 0,73
fuelEnergyDensityInMJoulesPerLiter

Hiermee geeft u de hoeveelheid chemische energie opgeslagen in één liter brandstof in megajoules (MJ). Het wordt gebruikt in combinatie met de *Efficiency parameters voor conversies tussen opgeslagen of verbruikte energie en brandstof. Energiedichtheid is bijvoorbeeld 34,2 MJ/l voor benzine en 35,8 MJ/l voor dieselbrandstof.

Deze parameter is vereist als een *Efficiency parameter is ingesteld.

Verstandige waarden : 34.2
hilliness

Mate van heuveligheid voor spannende route. Deze parameter kan alleen worden gebruikt in combinatie met routeType=spannende.
instructionsType

Indien opgegeven, worden instructies geretourneerd. Houd er rekening mee dat de parameter instructionsType niet kan worden gebruikt in combinatie met routeRepresentation=none.
language

De taalparameter bepaalt de taal van de richtlijnenberichten. De juiste zelfstandige naamwoorden (de namen van straten, pleinen, enzovoort) worden geretourneerd in de opgegeven taal, of als dat niet beschikbaar is, worden ze geretourneerd in een beschikbare taal die zich er dichtbij bevindt. Toegestane waarden zijn (een subset van) de IETF-taaltags. De momenteel ondersteunde talen worden vermeld in de sectie Ondersteunde talen.

Standaardwaarde: en-GB
maxAlternatives

Het aantal gewenste alternatieve routes dat moet worden berekend. Standaard: 0, minimum: 0 en maximum: 5
maxChargeInkWh

Hiermee geeft u de maximale elektrische energietoevoer in kilowatturen (kWh) op die in de batterij van het voertuig kunnen worden opgeslagen.

Deze parameter bestaat samen met currentChargeInkWh parameter.

De minimumwaarde moet groter dan of gelijk zijn aan currentChargeInkWh.

Verstandige waarden : 85
minDeviationDistance

Alle alternatieve routes die worden geretourneerd, volgen de referentieroute (zie sectie POST-aanvragen) vanaf het oorspronkelijke punt van de calculateRoute-aanvraag voor ten minste dit aantal meters. Kan alleen worden gebruikt bij het reconstrueren van een route. De parameter minDeviationDistance kan niet worden gebruikt in combinatie met arriveAt
minDeviationTime

Alle alternatieve routes die worden geretourneerd, volgen de referentieroute (zie sectie POST-aanvragen) vanaf het oorspronkelijke punt van de calculateRoute-aanvraag gedurende ten minste dit aantal seconden. Kan alleen worden gebruikt bij het reconstrueren van een route. De parameter minDeviationTime kan niet worden gebruikt in combinatie met arriveAt. De standaardwaarde is 0. Als u )minDeviationTime_ instelt op een waarde die groter is dan nul, heeft dit de volgende gevolgen:

  • Het oorspronkelijke punt van de calculateRoute-aanvraag moet zich op de invoerreferentieroute (of zeer dichtbij) bevindt.
    • Als dit niet het geval is, wordt er een fout geretourneerd.
    • Het oorspronkelijke punt hoeft zich echter niet aan het begin van de invoerreferentieroute te bevinden (het kan worden beschouwd als de huidige voertuigpositie op de referentieroute).
  • De referentieroute, geretourneerd als de eerste route in de calculateRoute Response, begint op het oorspronkelijke punt dat is opgegeven in de calculateRoute Request. Het eerste deel van de invoerreferentieroute totdat het oorspronkelijke punt wordt uitgesloten van het antwoord.
  • De waarden van minDeviationDistance en minDeviationTime bepalen hoe ver alternatieve routes gegarandeerd de referentieroute vanaf het beginpunt volgen.
  • De route moet vertrekkenDegebruiken.
  • De vehicleHeading wordt genegeerd.
query

De coördinaten waarmee de route wordt berekend, gescheiden door een dubbele punt. Er zijn minimaal twee coördinaten vereist. De eerste is de oorsprong en het laatste is de bestemming van de route. Optionele coördinaten in-between fungeren als WayPoints in de route. U kunt maximaal 150 WayPoints doorgeven.
report

Hiermee geeft u op welke gegevens moeten worden gerapporteerd voor diagnosedoeleinden. De enige mogelijke waarde is effectiveSettings. Rapporteert de effectieve parameters of gegevens die worden gebruikt bij het aanroepen van de API. In het geval van standaardparameters wordt de standaardwaarde weergegeven wanneer de parameter niet is opgegeven door de aanroeper.
routeRepresentation

Hiermee geeft u de weergave van de set routes opgegeven als antwoord.
routeType

Het type route aangevraagd.
sectionType

Hiermee geeft u op welke sectietypen worden gerapporteerd in het routeantwoord.

Als bijvoorbeeld sectionType = voetgangers de secties die alleen geschikt zijn voor voetgangers, worden geretourneerd. Kan meerdere keren worden opgegeven in één aanvraag, bijvoorbeeld '§ionType=carTrain§ionType=voetgangers§ionType=snelweg'. Het standaard sectionType verwijst naar de travelMode-invoer. Standaard is travelMode ingesteld op auto
traffic

Mogelijke waarden:

  • true - Houd rekening met alle beschikbare verkeersinformatie tijdens routering
  • false : huidige verkeersgegevens tijdens routering negeren. Houd er rekening mee dat hoewel de huidige verkeersgegevens tijdens de routering worden genegeerd, het effect van historisch verkeer op effectieve wegsnelheden nog steeds wordt opgenomen.
travelMode

De reismodus voor de aangevraagde route. Als dit niet is gedefinieerd, is de standaardwaarde 'auto'. Houd er rekening mee dat de aangevraagde travelMode mogelijk niet beschikbaar is voor de hele route. Wanneer de aangevraagde travelMode niet beschikbaar is voor een bepaalde sectie, is het element travelMode van het antwoord voor die sectie 'overig'. Houd er rekening mee dat reismodi bus, motorfiets, taxi en busje beta-functionaliteit zijn. Volledige beperkingsgegevens zijn niet beschikbaar in alle gebieden.
uphillEfficiency

Hiermee geeft u de efficiëntie van het converteren van chemische energie opgeslagen in brandstof naar potentiële energie wanneer het voertuig verhoging (d.w.w.v. PotentialEnergyGained/ChemicalEnergyConsumed). ChemicalEnergyConsumed wordt verkregen door verbruikte brandstof om te zetten in chemische energie met behulp van fuelEnergyDensityInMJoulesPerLiter.

Moet worden gekoppeld aan downhillEfficiency.

Het toegestane waardenbereik is 0,0 tot 1/downhillEfficiency.

Zinnige waarden: voor verbrandingsmodel : 0,27, voor elektrisch model : 0,74
vehicleAxleWeight

Gewicht per as van het voertuig in kg. Een waarde van 0 betekent dat gewichtsbeperkingen per as niet worden overwogen.
vehicleCommercial

Of het voertuig wordt gebruikt voor commerciële doeleinden. Bedrijfsvoertuigen mogen mogelijk niet op sommige wegen rijden.
vehicleEngineType

Motortype van het voertuig. Wanneer een gedetailleerd verbruiksmodel is opgegeven, moet het consistent zijn met de waarde van vehicleEngineType.
vehicleHeading

De richtingsrichting van het voertuig in graden beginnend bij waar Noord en doorgaan in rechtsom. Het noorden is 0 graden, het oosten is 90 graden, het zuiden is 180 graden, west is 270 graden. Mogelijke waarden 0-359
vehicleHeight

Hoogte van het voertuig in meters. Een waarde van 0 betekent dat hoogtebeperkingen niet worden overwogen.
vehicleLength

Lengte van het voertuig in meters. Een waarde van 0 betekent dat lengtebeperkingen niet worden overwogen.
vehicleLoadType

Soorten ladingen die kunnen worden geclassificeerd als gevaarlijke materialen en beperkt zijn van sommige wegen. Beschikbare vehicleLoadType-waarden zijn US Hazmat-klassen 1 tot en met 9, plus algemene classificaties voor gebruik in andere landen/regio's. Waarden die beginnen met USHazmat zijn voor amerikaanse routering, terwijl andereHazmat moet worden gebruikt voor alle andere landen/regio's. vehicleLoadType kan meerdere keren worden opgegeven. Deze parameter wordt momenteel alleen in aanmerking genomen voor travelMode=truck.
vehicleMaxSpeed

Maximumsnelheid van het voertuig in km/uur. De maximale snelheid in het voertuigprofiel wordt gebruikt om te controleren of een voertuig is toegestaan op snelwegen.

  • Een waarde van 0 betekent dat een passende waarde voor het voertuig wordt bepaald en toegepast tijdens de routeplanning.

  • Een niet-nulwaarde kan tijdens het plannen van de route worden overschreven. De huidige verkeersstroom is bijvoorbeeld 60 km/uur. Als de maximumsnelheid van het voertuig is ingesteld op 50 km/uur, zal de routeringsmotor rekening houden met 60 km/uur, aangezien dit de huidige situatie is. Als de maximumsnelheid van het voertuig wordt opgegeven als 80 km/uur, maar de huidige verkeersstroom 60 km/uur is, gebruikt de routeringsmotor opnieuw 60 km/uur.
vehicleWeight

Gewicht van het voertuig in kilogram.

  • Dit is verplicht als een van de *Efficiëntieparameters is ingesteld.

  • Het moet strikt positief zijn wanneer deze wordt gebruikt in de context van het verbruiksmodel. Gewichtsbeperkingen worden overwogen.

  • Als er geen gedetailleerde verbruiksmodel is opgegeven en de waarde van vehicleWeight niet nul is, worden gewichtsbeperkingen overwogen.

  • In alle andere gevallen wordt deze parameter genegeerd.

Verstandige waarden: voor verbrandingsmodel : 1600, voor elektrisch model : 1900
vehicleWidth

Breedte van het voertuig in meters. Een waarde van 0 betekent dat breedtebeperkingen niet worden overwogen.
windingness

Hoogte van bochten voor spannende route. Deze parameter kan alleen worden gebruikt in combinatie met routeType=spannende.

Eigenschapdetails

accelerationEfficiency

Hiermee geeft u de efficiëntie van het converteren van chemische energie opgeslagen in brandstof naar kinetische energie wanneer het voertuig versnelt (d.w.w.v. De KinetischeEnergyGained/ChemicalEnergyConsumed). ChemicalEnergyConsumed wordt verkregen door verbruikte brandstof om te zetten in chemische energie met behulp van fuelEnergyDensityInMJoulesPerLiter.

Moet worden gekoppeld aan vertragingsefficiency.

Het toegestane bereik van waarden is 0,0 tot 1/decelerationEfficiency.

Verstandige waarden: voor verbrandingsmodel : 0,33, voor elektrisch model : 0,66

accelerationEfficiency?: number

Waarde van eigenschap

number

alternativeType

Bepaalt de optimale werking, met betrekking tot de opgegeven planningscriteria, van de berekende alternatieven in vergelijking met de referentieroute.

alternativeType?: "anyRoute" | "betterRoute"

Waarde van eigenschap

"anyRoute" | "betterRoute"

arriveAt

De datum en tijd van aankomst op het doelpunt dat is opgemaakt als een dateTime-waarde zoals gedefinieerd in RFC 3339, sectie 5,6, met een optionele tijdzone-offset. Wanneer er geen tijdzone-offset wordt opgegeven, wordt ervan uitgegaan dat dit van het doelpunt is.

Voorbeelden:

  • 2023-12-19T16:39:57
  • 2023-12-19T16:39:57-08:00

De parameter arriveAt kan niet worden gebruikt in combinatie met departAt, minDeviationDistance of minDeviationTime.

arriveAt?: string | Date

Waarde van eigenschap

string | Date

auxiliaryPowerInkW

Hiermee geeft u de hoeveelheid verbruikt vermogen voor ondersteunende systemen, in kilowatts (kW).

Het kan worden gebruikt om verbruik op te geven als gevolg van apparaten en systemen zoals AC-systemen, radio, verwarming, enz.

Zinnige waarden : 1,7

auxiliaryPowerInkW?: number

Waarde van eigenschap

number

auxiliaryPowerInLitersPerHour

Hiermee geeft u de hoeveelheid verbruikte brandstof voor ondersteunende systemen van het voertuig, in liter per uur.

Het kan worden gebruikt om verbruik op te geven als gevolg van apparaten en systemen zoals AC-systemen, radio, verwarming, enz.

Zinnige waarden : 0.2

auxiliaryPowerInLitersPerHour?: number

Waarde van eigenschap

number

avoid

Hiermee geeft u iets op dat de routeberekening moet proberen te vermijden bij het bepalen van de route. Kan meerdere keren in één aanvraag worden opgegeven, bijvoorbeeld '&vermijd=snelwegen&vermijden=tollRoads&avoid=veerboten'. In routebereikaanvragen mag de waarde alreadyUsedRoads niet worden gebruikt.

avoid?: ("tollRoads" | "motorways" | "ferries" | "unpavedRoads" | "carpools" | "alreadyUsedRoads" | "borderCrossings")[]

Waarde van eigenschap

("tollRoads" | "motorways" | "ferries" | "unpavedRoads" | "carpools" | "alreadyUsedRoads" | "borderCrossings")[]

computeBestOrder

Rangschik de route-waypoints opnieuw met behulp van een snel heuristisch algoritme om de lengte van de route te verminderen. Geeft de beste resultaten wanneer deze worden gebruikt in combinatie met routeType kortste. U ziet dat oorsprong en bestemming worden uitgesloten van de geoptimaliseerde waypoint-indexen. Als u oorsprong en bestemming in het antwoord wilt opnemen, verhoogt u alle indexen met 1 om rekening te houden met de oorsprong en voegt u vervolgens de bestemming toe als de uiteindelijke index. Mogelijke waarden zijn waar of onwaar. True berekent indien mogelijk een betere volgorde, maar mag niet worden gebruikt in combinatie met de waarde maxAlternatives die groter is dan 0 of in combinatie met cirkel-waypoints. False gebruikt de locaties in de opgegeven volgorde en mag niet worden gebruikt in combinatie met routeRepresentation geen.

computeBestOrder?: boolean

Waarde van eigenschap

boolean

computeTravelTimeFor

Hiermee geeft u op of er extra reistijden moeten worden geretourneerd met behulp van verschillende soorten verkeersinformatie (geen, historisch, live) en de standaard best-schatting reistijd.

computeTravelTimeFor?: "none" | "all"

Waarde van eigenschap

"none" | "all"

constantSpeedConsumptionInkWhPerHundredkm

Hiermee geeft u het snelheidsafhankelijke onderdeel van het verbruik.

Geleverd als een niet-geordende lijst met snelheids-/verbruiksfrequentieparen. De lijst definieert punten op een verbruikscurve. Verbruikstarieven voor snelheden die niet in de lijst staan, worden als volgt gevonden:

  • door lineaire interpolatie, als de opgegeven snelheid tussen twee snelheden in de lijst ligt

  • door lineaire extrapolatie anders, uitgaande van een constante (ΔConsumption/ΔSpeed) die wordt bepaald door de dichtstbijzijnde twee punten in de lijst

De lijst moet tussen 1 en 25 punten (inclusief) bevatten en mag geen dubbele punten voor dezelfde snelheid bevatten. Als het slechts één punt bevat, wordt de verbruikssnelheid van dat punt zonder verdere verwerking gebruikt.

Het verbruik dat is opgegeven voor de grootste snelheid moet groter zijn dan of gelijk zijn aan die van de voorlaatste snelheid. Dit zorgt ervoor dat extrapolatie niet leidt tot negatieve verbruikstarieven.

Op dezelfde manier kunnen verbruikswaarden die zijn opgegeven voor de twee kleinste snelheden in de lijst, niet leiden tot een negatief verbruik voor een kleinere snelheid.

Het geldige bereik voor de verbruikswaarden (uitgedrukt in kWh/100km) ligt tussen 0,01 en 100000,0.

Verstandige waarden: 50,8.2:130,21.3

Deze parameter is vereist voor elektrische verbruiksmodel.

constantSpeedConsumptionInkWhPerHundredkm?: string

Waarde van eigenschap

string

constantSpeedConsumptionInLitersPerHundredkm

Hiermee geeft u het snelheidsafhankelijke onderdeel van het verbruik.

Wordt geleverd als een niet-geordende lijst met door dubbele punt gescheiden snelheidsparen & verbruiksfrequentieparen. De lijst definieert punten op een verbruikscurve. Verbruikstarieven voor snelheden die niet in de lijst staan, worden als volgt gevonden:

  • door lineaire interpolatie, als de opgegeven snelheid tussen twee snelheden in de lijst ligt

  • door lineaire extrapolatie anders, uitgaande van een constante (ΔConsumption/ΔSpeed) die wordt bepaald door de dichtstbijzijnde twee punten in de lijst

De lijst moet tussen 1 en 25 punten (inclusief) bevatten en mag geen dubbele punten voor dezelfde snelheid bevatten. Als het slechts één punt bevat, wordt de verbruikssnelheid van dat punt zonder verdere verwerking gebruikt.

Het verbruik dat is opgegeven voor de grootste snelheid moet groter zijn dan of gelijk zijn aan die van de voorlaatste snelheid. Dit zorgt ervoor dat extrapolatie niet leidt tot negatieve verbruikstarieven.

Op dezelfde manier kunnen verbruikswaarden die zijn opgegeven voor de twee kleinste snelheden in de lijst, niet leiden tot een negatief verbruik voor een kleinere snelheid.

Het geldige bereik voor de verbruikswaarden (uitgedrukt in l/100km) ligt tussen 0,01 en 100000,0.

Verstandige waarden: 50,6.3:130,11,5

Opmerking: deze parameter is vereist voor het verbrandingsverbruiksmodel.

constantSpeedConsumptionInLitersPerHundredkm?: string

Waarde van eigenschap

string

currentChargeInkWh

Hiermee geeft u de huidige elektrische energietoevoer in kilowatturen (kWh).

Deze parameter bestaat samen met maxChargeInkWh parameter.

Het toegestane waardenbereik is 0,0 tot maxChargeInkWh.

Verstandige waarden : 43

currentChargeInkWh?: number

Waarde van eigenschap

number

currentFuelInLiters

Hiermee geeft u de huidige toevoer van brandstof in liter.

Verstandige waarden : 55

currentFuelInLiters?: number

Waarde van eigenschap

number

decelerationEfficiency

Hiermee geeft u de efficiëntie van het converteren van kinetische energie naar opgeslagen (niet verbruikte) brandstof wanneer het voertuig vertraagt (d.w.w.v. ChemicalEnergySaved/KinetischeEnergyLost). ChemicalEnergySaved wordt verkregen door opgeslagen (niet verbruikte) brandstof te converteren naar energie met behulp van fuelEnergyDensityInMJoulesPerLiter.

Moet worden gekoppeld aan accelerationEfficiency.

Het toegestane bereik van waarden is 0,0 tot 1/accelerationEfficiency.

Verstandige waarden: voor verbrandingsmodel : 0,83, voor elektrisch model : 0,91

decelerationEfficiency?: number

Waarde van eigenschap

number

departAt

De datum en tijd van vertrek van het oorspronkelijke punt die zijn opgemaakt als een dateTime waarde zoals gedefinieerd in RFC 3339, sectie 5,6, met een optionele tijdzone-offset. Wanneer er geen tijdzone-offset is opgegeven, wordt ervan uitgegaan dat deze van het oorspronkelijke punt is.

  • Standaardwaarde: nu
  • Andere waarde: dateTime

Voorbeelden:

  • 2023-12-19T16:39:57
  • 2023-12-19T16:39:57-08:00

De parameter departAt kan niet worden gebruikt in combinatie met arriveAt.

departAt?: string | Date

Waarde van eigenschap

string | Date

downhillEfficiency

Hiermee geeft u de efficiëntie van het converteren van potentiële energie naar opgeslagen (niet verbruikte) brandstof wanneer het voertuig verhoging verliest (d.w. ChemicalEnergySaved/PotentialEnergyLost). ChemicalEnergySaved wordt verkregen door opgeslagen (niet verbruikte) brandstof te converteren naar energie met behulp van fuelEnergyDensityInMJoulesPerLiter.

Moet worden gekoppeld aan uphillEfficiency.

Het toegestane waardenbereik is 0,0 tot 1/uphillEfficiency.

Verstandige waarden: voor verbrandingsmodel : 0,51, voor elektrisch model : 0,73

downhillEfficiency?: number

Waarde van eigenschap

number

fuelEnergyDensityInMJoulesPerLiter

Hiermee geeft u de hoeveelheid chemische energie opgeslagen in één liter brandstof in megajoules (MJ). Het wordt gebruikt in combinatie met de *Efficiency parameters voor conversies tussen opgeslagen of verbruikte energie en brandstof. Energiedichtheid is bijvoorbeeld 34,2 MJ/l voor benzine en 35,8 MJ/l voor dieselbrandstof.

Deze parameter is vereist als een *Efficiency parameter is ingesteld.

Verstandige waarden : 34.2

fuelEnergyDensityInMJoulesPerLiter?: number

Waarde van eigenschap

number

hilliness

Mate van heuveligheid voor spannende route. Deze parameter kan alleen worden gebruikt in combinatie met routeType=spannende.

hilliness?: "low" | "normal" | "high"

Waarde van eigenschap

"low" | "normal" | "high"

instructionsType

Indien opgegeven, worden instructies geretourneerd. Houd er rekening mee dat de parameter instructionsType niet kan worden gebruikt in combinatie met routeRepresentation=none.

instructionsType?: "coded" | "text" | "tagged"

Waarde van eigenschap

"coded" | "text" | "tagged"

language

De taalparameter bepaalt de taal van de richtlijnenberichten. De juiste zelfstandige naamwoorden (de namen van straten, pleinen, enzovoort) worden geretourneerd in de opgegeven taal, of als dat niet beschikbaar is, worden ze geretourneerd in een beschikbare taal die zich er dichtbij bevindt. Toegestane waarden zijn (een subset van) de IETF-taaltags. De momenteel ondersteunde talen worden vermeld in de sectie Ondersteunde talen.

Standaardwaarde: en-GB

language?: string

Waarde van eigenschap

string

maxAlternatives

Het aantal gewenste alternatieve routes dat moet worden berekend. Standaard: 0, minimum: 0 en maximum: 5

maxAlternatives?: number

Waarde van eigenschap

number

maxChargeInkWh

Hiermee geeft u de maximale elektrische energietoevoer in kilowatturen (kWh) op die in de batterij van het voertuig kunnen worden opgeslagen.

Deze parameter bestaat samen met currentChargeInkWh parameter.

De minimumwaarde moet groter dan of gelijk zijn aan currentChargeInkWh.

Verstandige waarden : 85

maxChargeInkWh?: number

Waarde van eigenschap

number

minDeviationDistance

Alle alternatieve routes die worden geretourneerd, volgen de referentieroute (zie sectie POST-aanvragen) vanaf het oorspronkelijke punt van de calculateRoute-aanvraag voor ten minste dit aantal meters. Kan alleen worden gebruikt bij het reconstrueren van een route. De parameter minDeviationDistance kan niet worden gebruikt in combinatie met arriveAt

minDeviationDistance?: number

Waarde van eigenschap

number

minDeviationTime

Alle alternatieve routes die worden geretourneerd, volgen de referentieroute (zie sectie POST-aanvragen) vanaf het oorspronkelijke punt van de calculateRoute-aanvraag gedurende ten minste dit aantal seconden. Kan alleen worden gebruikt bij het reconstrueren van een route. De parameter minDeviationTime kan niet worden gebruikt in combinatie met arriveAt. De standaardwaarde is 0. Als u )minDeviationTime_ instelt op een waarde die groter is dan nul, heeft dit de volgende gevolgen:

  • Het oorspronkelijke punt van de calculateRoute-aanvraag moet zich op de invoerreferentieroute (of zeer dichtbij) bevindt.
    • Als dit niet het geval is, wordt er een fout geretourneerd.
    • Het oorspronkelijke punt hoeft zich echter niet aan het begin van de invoerreferentieroute te bevinden (het kan worden beschouwd als de huidige voertuigpositie op de referentieroute).
  • De referentieroute, geretourneerd als de eerste route in de calculateRoute Response, begint op het oorspronkelijke punt dat is opgegeven in de calculateRoute Request. Het eerste deel van de invoerreferentieroute totdat het oorspronkelijke punt wordt uitgesloten van het antwoord.
  • De waarden van minDeviationDistance en minDeviationTime bepalen hoe ver alternatieve routes gegarandeerd de referentieroute vanaf het beginpunt volgen.
  • De route moet vertrekkenDegebruiken.
  • De vehicleHeading wordt genegeerd.
minDeviationTime?: number

Waarde van eigenschap

number

query

De coördinaten waarmee de route wordt berekend, gescheiden door een dubbele punt. Er zijn minimaal twee coördinaten vereist. De eerste is de oorsprong en het laatste is de bestemming van de route. Optionele coördinaten in-between fungeren als WayPoints in de route. U kunt maximaal 150 WayPoints doorgeven.

query: string

Waarde van eigenschap

string

report

Hiermee geeft u op welke gegevens moeten worden gerapporteerd voor diagnosedoeleinden. De enige mogelijke waarde is effectiveSettings. Rapporteert de effectieve parameters of gegevens die worden gebruikt bij het aanroepen van de API. In het geval van standaardparameters wordt de standaardwaarde weergegeven wanneer de parameter niet is opgegeven door de aanroeper.

report?: "effectiveSettings"

Waarde van eigenschap

"effectiveSettings"

routeRepresentation

Hiermee geeft u de weergave van de set routes opgegeven als antwoord.

routeRepresentation?: "polyline" | "summaryOnly" | "none"

Waarde van eigenschap

"polyline" | "summaryOnly" | "none"

routeType

Het type route aangevraagd.

routeType?: "fastest" | "shortest" | "eco" | "thrilling"

Waarde van eigenschap

"fastest" | "shortest" | "eco" | "thrilling"

sectionType

Hiermee geeft u op welke sectietypen worden gerapporteerd in het routeantwoord.

Als bijvoorbeeld sectionType = voetgangers de secties die alleen geschikt zijn voor voetgangers, worden geretourneerd. Kan meerdere keren worden opgegeven in één aanvraag, bijvoorbeeld '§ionType=carTrain§ionType=voetgangers§ionType=snelweg'. Het standaard sectionType verwijst naar de travelMode-invoer. Standaard is travelMode ingesteld op auto

sectionType?: ("carTrain" | "country" | "ferry" | "motorway" | "pedestrian" | "tollRoad" | "tollVignette" | "traffic" | "travelMode" | "tunnel" | "carpool" | "urban")[]

Waarde van eigenschap

("carTrain" | "country" | "ferry" | "motorway" | "pedestrian" | "tollRoad" | "tollVignette" | "traffic" | "travelMode" | "tunnel" | "carpool" | "urban")[]

traffic

Mogelijke waarden:

  • true - Houd rekening met alle beschikbare verkeersinformatie tijdens routering
  • false : huidige verkeersgegevens tijdens routering negeren. Houd er rekening mee dat hoewel de huidige verkeersgegevens tijdens de routering worden genegeerd, het effect van historisch verkeer op effectieve wegsnelheden nog steeds wordt opgenomen.
traffic?: boolean

Waarde van eigenschap

boolean

travelMode

De reismodus voor de aangevraagde route. Als dit niet is gedefinieerd, is de standaardwaarde 'auto'. Houd er rekening mee dat de aangevraagde travelMode mogelijk niet beschikbaar is voor de hele route. Wanneer de aangevraagde travelMode niet beschikbaar is voor een bepaalde sectie, is het element travelMode van het antwoord voor die sectie 'overig'. Houd er rekening mee dat reismodi bus, motorfiets, taxi en busje beta-functionaliteit zijn. Volledige beperkingsgegevens zijn niet beschikbaar in alle gebieden.

travelMode?: "pedestrian" | "car" | "truck" | "taxi" | "bus" | "van" | "motorcycle" | "bicycle"

Waarde van eigenschap

"pedestrian" | "car" | "truck" | "taxi" | "bus" | "van" | "motorcycle" | "bicycle"

uphillEfficiency

Hiermee geeft u de efficiëntie van het converteren van chemische energie opgeslagen in brandstof naar potentiële energie wanneer het voertuig verhoging (d.w.w.v. PotentialEnergyGained/ChemicalEnergyConsumed). ChemicalEnergyConsumed wordt verkregen door verbruikte brandstof om te zetten in chemische energie met behulp van fuelEnergyDensityInMJoulesPerLiter.

Moet worden gekoppeld aan downhillEfficiency.

Het toegestane waardenbereik is 0,0 tot 1/downhillEfficiency.

Zinnige waarden: voor verbrandingsmodel : 0,27, voor elektrisch model : 0,74

uphillEfficiency?: number

Waarde van eigenschap

number

vehicleAxleWeight

Gewicht per as van het voertuig in kg. Een waarde van 0 betekent dat gewichtsbeperkingen per as niet worden overwogen.

vehicleAxleWeight?: number

Waarde van eigenschap

number

vehicleCommercial

Of het voertuig wordt gebruikt voor commerciële doeleinden. Bedrijfsvoertuigen mogen mogelijk niet op sommige wegen rijden.

vehicleCommercial?: boolean

Waarde van eigenschap

boolean

vehicleEngineType

Motortype van het voertuig. Wanneer een gedetailleerd verbruiksmodel is opgegeven, moet het consistent zijn met de waarde van vehicleEngineType.

vehicleEngineType?: "combustion" | "electric"

Waarde van eigenschap

"combustion" | "electric"

vehicleHeading

De richtingsrichting van het voertuig in graden beginnend bij waar Noord en doorgaan in rechtsom. Het noorden is 0 graden, het oosten is 90 graden, het zuiden is 180 graden, west is 270 graden. Mogelijke waarden 0-359

vehicleHeading?: number

Waarde van eigenschap

number

vehicleHeight

Hoogte van het voertuig in meters. Een waarde van 0 betekent dat hoogtebeperkingen niet worden overwogen.

vehicleHeight?: number

Waarde van eigenschap

number

vehicleLength

Lengte van het voertuig in meters. Een waarde van 0 betekent dat lengtebeperkingen niet worden overwogen.

vehicleLength?: number

Waarde van eigenschap

number

vehicleLoadType

Soorten ladingen die kunnen worden geclassificeerd als gevaarlijke materialen en beperkt zijn van sommige wegen. Beschikbare vehicleLoadType-waarden zijn US Hazmat-klassen 1 tot en met 9, plus algemene classificaties voor gebruik in andere landen/regio's. Waarden die beginnen met USHazmat zijn voor amerikaanse routering, terwijl andereHazmat moet worden gebruikt voor alle andere landen/regio's. vehicleLoadType kan meerdere keren worden opgegeven. Deze parameter wordt momenteel alleen in aanmerking genomen voor travelMode=truck.

vehicleLoadType?: "USHazmatClass1" | "USHazmatClass2" | "USHazmatClass3" | "USHazmatClass4" | "USHazmatClass5" | "USHazmatClass6" | "USHazmatClass7" | "USHazmatClass8" | "USHazmatClass9" | "otherHazmatExplosive" | "otherHazmatGeneral" | "otherHazmatHarmfulToWater"

Waarde van eigenschap

"USHazmatClass1" | "USHazmatClass2" | "USHazmatClass3" | "USHazmatClass4" | "USHazmatClass5" | "USHazmatClass6" | "USHazmatClass7" | "USHazmatClass8" | "USHazmatClass9" | "otherHazmatExplosive" | "otherHazmatGeneral" | "otherHazmatHarmfulToWater"

vehicleMaxSpeed

Maximumsnelheid van het voertuig in km/uur. De maximale snelheid in het voertuigprofiel wordt gebruikt om te controleren of een voertuig is toegestaan op snelwegen.

  • Een waarde van 0 betekent dat een passende waarde voor het voertuig wordt bepaald en toegepast tijdens de routeplanning.

  • Een niet-nulwaarde kan tijdens het plannen van de route worden overschreven. De huidige verkeersstroom is bijvoorbeeld 60 km/uur. Als de maximumsnelheid van het voertuig is ingesteld op 50 km/uur, zal de routeringsmotor rekening houden met 60 km/uur, aangezien dit de huidige situatie is. Als de maximumsnelheid van het voertuig wordt opgegeven als 80 km/uur, maar de huidige verkeersstroom 60 km/uur is, gebruikt de routeringsmotor opnieuw 60 km/uur.

vehicleMaxSpeed?: number

Waarde van eigenschap

number

vehicleWeight

Gewicht van het voertuig in kilogram.

  • Dit is verplicht als een van de *Efficiëntieparameters is ingesteld.

  • Het moet strikt positief zijn wanneer deze wordt gebruikt in de context van het verbruiksmodel. Gewichtsbeperkingen worden overwogen.

  • Als er geen gedetailleerde verbruiksmodel is opgegeven en de waarde van vehicleWeight niet nul is, worden gewichtsbeperkingen overwogen.

  • In alle andere gevallen wordt deze parameter genegeerd.

Verstandige waarden: voor verbrandingsmodel : 1600, voor elektrisch model : 1900

vehicleWeight?: number

Waarde van eigenschap

number

vehicleWidth

Breedte van het voertuig in meters. Een waarde van 0 betekent dat breedtebeperkingen niet worden overwogen.

vehicleWidth?: number

Waarde van eigenschap

number

windingness

Hoogte van bochten voor spannende route. Deze parameter kan alleen worden gebruikt in combinatie met routeType=spannende.

windingness?: "low" | "normal" | "high"

Waarde van eigenschap

"low" | "normal" | "high"