Delen via

Route - Get Route Range

  • Referentie
Service:
Maps
API-versie:
1.0

Gebruik om een kaart te maken die het gebied weergeeft dat toegankelijk is vanaf een bepaald punt binnen een bepaalde drempelwaarde op basis van tijd, afstand of brandstofcapaciteit.

De Get Route Range (Isochrone) API is een HTTP-aanvraag GET waarmee een set locaties wordt berekend die kunnen worden bereikt vanaf het beginpunt op basis van brandstof, energie, tijd of opgegeven afstandsbudget. Een veelhoekgrens (of Isochrone) wordt geretourneerd in een richting tegen de klok in, evenals het exacte polygooncentrum dat het resultaat was van het beginpunt.

De geretourneerde veelhoek kan worden gebruikt voor verdere verwerking, zoals Zoeken in geometrie om te zoeken naar POIs binnen de opgegeven isochrone.

GET https://atlas.microsoft.com/route/range/{format}?api-version=1.0&query={query}
Met optionele 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}

URI-parameters

Name In Vereist Type Description
format
 path True

ResponseFormat

Gewenste indeling van het antwoord. De waarde kan json of xml zijn.
api-version
 query True

string

Versienummer van Azure Maps-API.
query
 query True

number[]

De coördinaat van waaruit de bereikberekening moet beginnen.
accelerationEfficiency
 query

number

double

Hiermee wordt de efficiëntie aangegeven van het omzetten van chemische energie die in brandstof is opgeslagen in kinetische energie wanneer het voertuig accelereert (dat wil zeggen KineticEnergyGained/ChemicalEnergyConsumed). ChemicalEnergyConsumed wordt verkregen door het omzetten van verbruikte brandstof in chemische energie met behulp van fuelEnergyDensityInMJoulesPerLiter.

Moet worden gekoppeld aan decelerationEfficiency.

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

Zinnige waarden : voor verbrandingsmodel : 0.33, voor elektrisch model : 0.66
auxiliaryPowerInkW
 query

number

double

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

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

Zinnige waarden: 1.7
auxiliaryPowerInLitersPerHour
 query

number

double

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

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

Zinnige waarden: 0,2
avoid
 query

RouteAvoidType[]

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 '&avoid=motorways&avoid=tollRoads&avoid=ferries'. In Aanvragen voor routebereik mag de waarde alreadyUsedRoads niet worden gebruikt.
constantSpeedConsumptionInkWhPerHundredkm
 query

string

Hiermee geeft u de snelheidsafhankelijke component van het verbruik.

Opgegeven als een niet-geordende lijst met snelheids-verbruikstariefparen. De lijst definieert punten op een verbruikscurve. Verbruikstarieven voor snelheden die niet in de lijst staan, zijn als volgt te vinden:

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

  • anders door lineaire extrapolatie, 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 gebruikt zonder verdere verwerking.

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

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

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

Zinnige waarden : 50,8.2:130,21,3

Deze parameter is vereist voor het model Voor elektrisch verbruik.
constantSpeedConsumptionInLitersPerHundredkm
 query

string

Hiermee geeft u de snelheidsafhankelijke component van het verbruik.

Wordt geleverd als een ongeordeerde lijst met door dubbele punt gescheiden snelheids-& verbruikstariefparen. De lijst definieert punten op een verbruikscurve. Verbruikstarieven voor snelheden die niet in de lijst staan, zijn als volgt te vinden:

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

  • anders door lineaire extrapolatie, 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 gebruikt zonder verdere verwerking.

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

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

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

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

Opmerking : deze parameter is vereist voor het verbrandingsverbruiksmodel.
currentChargeInkWh
 query

number

double

Hiermee geeft u de huidige elektrische energievoorziening in kilowattuur (kWh) op.

Deze parameter bestaat naast de parameter maxChargeInkWh .

Het toegestane waardenbereik is 0,0 tot maxChargeInkWh.

Zinnige waarden : 43
currentFuelInLiters
 query

number

double

Hiermee geeft u de huidige brandstoftoevoer in liter aan.

Zinnige waarden: 55
decelerationEfficiency
 query

number

double

Specificeert de efficiëntie van het omzetten van kinetische energie in opgeslagen (niet verbruikte) brandstof wanneer het voertuig vertraagt (d.w.w.v. ChemicalEnergySaved/KineticEnergyLost). ChemicalEnergySaved wordt verkregen door het omzetten van opgeslagen (niet verbruikte) brandstof naar energie met behulp van fuelEnergyDensityInMJoulesPerLiter.

Moet worden gekoppeld aan accelerationEfficiency.

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

Zinnige waarden : voor verbrandingsmodel : 0.83, voor elektrisch model : 0.91
departAt
 query

string

date-time

De datum en tijd van vertrek vanaf het beginpunt opgemaakt als een dateTime waarde zoals gedefinieerd in RFC 3339, sectie 5.6, met een optionele tijdzone-offset. Wanneer er geen tijdzoneverschil is opgegeven, wordt ervan uitgegaan dat deze de verschuiving van het beginpunt is.

  • Standaardwaarde: nu
  • Andere waarde: dateTime

Voorbeelden:

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

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

number

double

Afstandsbudget in meters die het maximale bereik bepalen dat kan worden afgelegd met behulp van de rijafstand. Het verbruiksmodel is alleen van invloed op het bereik wanneer routeType eco is.
Er moet precies één budget (fuelBudgetInLiters, energyBudgetInkWh, timeBudgetInSec of distanceBudgetInMeters) worden gebruikt.
downhillEfficiency
 query

number

double

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

Moet worden gekoppeld aan uphillEfficiency.

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

Zinnige waarden : voor verbrandingsmodel : 0.51, voor elektrisch model : 0.73
energyBudgetInkWh
 query

number

double

Elektrisch energiebudget in kilowattuur (kWh) dat het maximale bereik bepaalt dat kan worden bereisd met behulp van het opgegeven elektrisch verbruiksmodel.
Wanneer energyBudgetInkWh wordt gebruikt, is het verplicht om een gedetailleerd elektrisch verbruiksmodel op te geven.
Er moet precies één budget (fuelBudgetInLiters, energyBudgetInkWh, timeBudgetInSec of distanceBudgetInMeters) worden gebruikt.
fuelBudgetInLiters
 query

number

double

Brandstofbudget in liter dat het maximale bereik bepaalt dat kan worden bereisd met behulp van het opgegeven verbrandingsverbruiksmodel.
Wanneer fuelBudgetInLiters wordt gebruikt, is het verplicht om een gedetailleerd verbrandingsverbruiksmodel op te geven.
Er moet precies één budget (fuelBudgetInLiters, energyBudgetInkWh, timeBudgetInSec of distanceBudgetInMeters) worden gebruikt.
fuelEnergyDensityInMJoulesPerLiter
 query

number

double

Hiermee geeft u de hoeveelheid chemische energie opgeslagen in één liter brandstof in megajoules (MJ). Het wordt gebruikt in combinatie met de *Efficiëntieparameters voor conversies tussen bespaarde of verbruikte energie en brandstof. De 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.

Zinnige waarden: 34.2
hilliness
 query

InclineLevel

Mate van heuvelachtigheid voor spannende route. Deze parameter kan alleen worden gebruikt in combinatie met routeType=thrilling.
maxChargeInkWh
 query

number

double

Hiermee geeft u de maximale elektrische energietoevoer in kilowattuur (kWh) op die in de accu van het voertuig mag worden opgeslagen.

Deze parameter bestaat naast de parameter currentChargeInkWh .

De minimumwaarde moet groter zijn dan of gelijk zijn aan currentChargeInkWh.

Zinnige waarden : 85
routeType
 query

RouteType

Het type route dat is aangevraagd.
timeBudgetInSec
 query

number

double

Tijdsbudget in seconden dat het maximale bereik bepaalt dat kan worden gereisd met behulp van rijtijd. Het verbruiksmodel is alleen van invloed op het bereik wanneer routeType eco is.
Er moet precies één budget (fuelBudgetInLiters, energyBudgetInkWh, timeBudgetInSec of distanceBudgetInMeters) worden gebruikt.
traffic
 query

boolean

Mogelijke waarden:

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

TravelMode

De manier van reizen 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. Als de aangevraagde travelMode niet beschikbaar is voor een bepaalde sectie, is het travelMode-element van het antwoord voor die sectie 'overige'. Houd er rekening mee dat reismodi bus, motor, taxi en busje beta-functionaliteit zijn. Volledige beperkingsgegevens zijn niet in alle gebieden beschikbaar.
uphillEfficiency
 query

number

double

Hiermee geeft u de efficiëntie op van het omzetten van chemische energie die in brandstof is opgeslagen in potentiële energie wanneer het voertuig hoger wordt (dat wil zeggen PotentialEnergyGained/ChemicalEnergyConsumed). ChemicalEnergyConsumed wordt verkregen door het omzetten van verbruikte brandstof in chemische energie met behulp van fuelEnergyDensityInMJoulesPerLiter.

Moet worden gekoppeld aan downhillEfficiency.

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

Zinnige waarden : voor verbrandingsmodel : 0.27, voor elektrisch model : 0.74
vehicleAxleWeight
 query

integer

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

boolean

Of het voertuig wordt gebruikt voor commerciële doeleinden. Op sommige wegen mogen bedrijfsvoertuigen mogelijk niet rijden.
vehicleEngineType
 query

VehicleEngineType

Motortype van het voertuig. Wanneer een gedetailleerd verbruiksmodel wordt opgegeven, moet dit consistent zijn met de waarde van vehicleEngineType.
vehicleHeight
 query

number

double

Hoogte van het voertuig in meters. De waarde 0 betekent dat hoogtebeperkingen niet in aanmerking worden genomen.
vehicleLength
 query

number

double

Lengte van het voertuig in meters. Een waarde van 0 betekent dat er geen rekening wordt gehouden met lengtebeperkingen.
vehicleLoadType
 query

VehicleLoadType

Soorten ladingen die kunnen worden geclassificeerd als gevaarlijke materialen en beperkt zijn vanaf bepaalde wegen. Beschikbare vehicleLoadType-waarden zijn Amerikaanse 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 otherHazmat 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
 query

integer

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

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

  • Een niet-nulwaarde kan worden overschreven tijdens het plannen van de route. 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 80 km/uur bedraagt, maar de huidige verkeersstroom 60 km/uur is, gebruikt de routeringsmotor opnieuw 60 km/uur.
vehicleWeight
 query

integer

Gewicht van het voertuig in kilogrammen.

  • 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 gedetailleerd verbruiksmodel is opgegeven en de waarde van vehicleWeight niet nul is, worden gewichtsbeperkingen overwogen.

  • In alle andere gevallen wordt deze parameter genegeerd.

Zinnige waarden : voor verbrandingsmodel : 1600, voor elektrisch model : 1900
vehicleWidth
 query

number

double

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

WindingnessLevel

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

Aanvraagkoptekst

Name Vereist Type Description
x-ms-client-id

string

Hiermee geeft u op welk account is bedoeld voor gebruik in combinatie met het Microsoft Entra ID-beveiligingsmodel. Het vertegenwoordigt een unieke id voor het Azure Maps-account en kan worden opgehaald uit de Azure Maps-beheervlak Account-API. Als u Microsoft Entra ID-beveiliging in Azure Maps wilt gebruiken, raadpleegt u de volgende artikelen voor hulp.

Antwoorden

Name Type Description
200 OK

RouteRangeResult

OK
Other Status Codes

ErrorResponse

Er is een onverwachte fout opgetreden.

Beveiliging

AADToken

Dit zijn de Microsoft Entra OAuth 2.0-stromen . Wanneer het wordt gekoppeld aan op rollen gebaseerd toegangsbeheer van Azure , kan het worden gebruikt om de toegang tot Azure Maps REST API's te beheren. Op rollen gebaseerd toegangsbeheer van Azure wordt gebruikt om toegang tot een of meer Azure Maps-resourceaccounts of subresources aan te wijzen. Elke gebruiker, groep of service-principal kan toegang krijgen via een ingebouwde rol of een aangepaste rol die bestaat uit een of meer machtigingen voor Azure Maps REST API's.

Als u scenario's wilt implementeren, raden we u aan om verificatieconcepten te bekijken. Samengevat biedt deze beveiligingsdefinitie een oplossing voor het modelleren van toepassingen via objecten die toegangsbeheer kunnen hebben voor specifieke API's en bereiken.

Notities

  • Voor deze beveiligingsdefinitie moet de x-ms-client-id header worden gebruikt om aan te geven tot welke Azure Maps-resource de toepassing toegang aanvraagt. Dit kan worden verkregen via de Beheer-API van Maps.

De Authorization URL is specifiek voor het azure-exemplaar van de openbare cloud. Onafhankelijke clouds hebben unieke autorisatie-URL's en Microsoft Entra ID-configuraties. * Op rollen gebaseerd toegangsbeheer van Azure wordt geconfigureerd vanuit het Azure-beheervlak via Azure Portal, PowerShell, CLI, Azure SDK's of REST API's. * Gebruik van de Azure Maps Web SDK maakt configuratie van een toepassing mogelijk voor meerdere use cases.

Type: oauth2
Stroom: implicit
Autorisatie-URL: https://login.microsoftonline.com/common/oauth2/authorize

Bereiken

Name Description
https://atlas.microsoft.com/.default https://atlas.microsoft.com/.default

subscription-key

Dit is een gedeelde sleutel die wordt ingericht wanneer u een Azure Maps-account maakt in Azure Portal of met behulp van PowerShell, CLI, Azure SDK's of REST API.

Met deze sleutel heeft elke toepassing toegang tot alle REST API's. Met andere woorden, deze sleutel kan worden gebruikt als een hoofdsleutel in het account waarin ze zijn uitgegeven.

Voor openbaar beschikbare toepassingen wordt aanbevolen om de benadering vertrouwelijke clienttoepassingen te gebruiken voor toegang tot Azure Maps REST API's, zodat uw sleutel veilig kan worden opgeslagen.

Type: apiKey
In: query

SAS Token

Dit is een shared access signature-token dat is gemaakt op basis van de SAS-bewerking List op de Azure Maps-resource via het Azure-beheervlak via Azure Portal, PowerShell, CLI, Azure SDK's of REST API's.

Met dit token is elke toepassing gemachtigd om toegang te krijgen met op rollen gebaseerd toegangsbeheer van Azure en fijnmazige controle over het verloop, de snelheid en de gebruiksregio(s) voor het specifieke token. Met andere woorden, het SAS-token kan worden gebruikt om toepassingen in staat te stellen toegang op een veiligere manier te beheren dan de gedeelde sleutel.

Voor openbaar beschikbaar gemaakte toepassingen wordt aanbevolen om een specifieke lijst met toegestane oorsprongen te configureren op de resource Van het account toewijzen om misbruik van het genereren te beperken en het SAS-token regelmatig te vernieuwen.

Type: apiKey
In: header

Voorbeelden

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

Voorbeeldaanvraag

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

Voorbeeldrespons

Statuscode:
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
      }
    ]
  }
}

Definities

Name Description
EffectiveSetting

Effectieve parameter of gegevens die worden gebruikt bij het aanroepen van deze Route-API.
ErrorAdditionalInfo

Aanvullende informatie over de resourcebeheerfout.
ErrorDetail

De foutdetails.
ErrorResponse

Foutreactie
InclineLevel

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

Een locatie die wordt weergegeven als een breedtegraad en lengtegraad.
ResponseFormat

Gewenste indeling van het antwoord. De waarde kan json of xml zijn.
RouteAvoidType

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 '&avoid=motorways&avoid=tollRoads&avoid=ferries'. In Aanvragen voor routebereik mag de waarde alreadyUsedRoads niet worden gebruikt.
RouteRange

Bereikbaar bereik
RouteRangeResult

Dit object wordt geretourneerd na een geslaagde aanroep voor routebereik
RouteReport

Rapporteert de effectieve instellingen die worden gebruikt in de huidige aanroep.
RouteType

Het type route dat is aangevraagd.
TravelMode

De manier van reizen 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. Als de aangevraagde travelMode niet beschikbaar is voor een bepaalde sectie, is het travelMode-element van het antwoord voor die sectie 'overige'. Houd er rekening mee dat reismodi bus, motor, taxi en busje beta-functionaliteit zijn. Volledige beperkingsgegevens zijn niet in alle gebieden beschikbaar.
VehicleEngineType

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

Soorten ladingen die kunnen worden geclassificeerd als gevaarlijke materialen en beperkt zijn vanaf bepaalde wegen. Beschikbare vehicleLoadType-waarden zijn Amerikaanse 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 otherHazmat 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.
WindingnessLevel

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

EffectiveSetting

Effectieve parameter of gegevens die worden gebruikt bij het aanroepen van deze Route-API.

Name Type Description
key

string

Naam van de gebruikte parameter.
value

string

Waarde van de gebruikte parameter.

ErrorAdditionalInfo

Aanvullende informatie over de resourcebeheerfout.

Name Type Description
info

object

De aanvullende informatie.
type

string

Het type aanvullende informatie.

ErrorDetail

De foutdetails.

Name Type Description
additionalInfo

ErrorAdditionalInfo[]

De fout aanvullende informatie.
code

string

De foutcode.
details

ErrorDetail[]

De foutdetails.
message

string

Het foutbericht.
target

string

Het foutdoel.

ErrorResponse

Foutreactie

Name Type Description
error

ErrorDetail

Het foutobject.

InclineLevel

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

Name Type Description
high

string

hoog
low

string

laag
normal

string

normaal

LatLongPair

Een locatie die wordt weergegeven als een breedtegraad en lengtegraad.

Name Type Description
latitude

number

De eigenschap Breedtegraad
longitude

number

De eigenschap Lengtegraad

ResponseFormat

Gewenste indeling van het antwoord. De waarde kan json of xml zijn.

Name Type Description
json

string

De JavaScript Object Notation Data Interchange-indeling
xml

string

De uitbreidbare opmaaktaal

RouteAvoidType

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 '&avoid=motorways&avoid=tollRoads&avoid=ferries'. In Aanvragen voor routebereik mag de waarde alreadyUsedRoads niet worden gebruikt.

Name Type Description
alreadyUsedRoads

string

Vermijdt het gebruik van dezelfde weg meerdere keren. Het meest nuttig in combinatie met routeType=spannend.
borderCrossings

string

Vermijdt grensoverschrijdingen in routeberekening.
carpools

string

Vermijdt routes waarvoor het gebruik van carpoolbanen (HOV/High Occupancy Vehicle) is vereist.
ferries

string

Vermijdt veerboten
motorways

string

Vermijdt snelwegen
tollRoads

string

Vermijdt tolwegen.
unpavedRoads

string

Vermijdt onverharde wegen

RouteRange

Bereikbaar bereik

Name Type Description
boundary

LatLongPair[]

Veelhoekgrens van het bereik dat wordt weergegeven als een lijst met punten.
center

LatLongPair

Middelpunt van het bereik

RouteRangeResult

Dit object wordt geretourneerd na een geslaagde aanroep voor routebereik

Name Type Description
formatVersion

string

De eigenschap Versie opmaken
reachableRange

RouteRange

Bereikbaar bereik
report

RouteReport

Rapporteert de effectieve instellingen die worden gebruikt in de huidige aanroep.

RouteReport

Rapporteert de effectieve instellingen die worden gebruikt in de huidige aanroep.

Name Type Description
effectiveSettings

EffectiveSetting[]

Effectieve parameters of gegevens die worden gebruikt bij het aanroepen van deze Route-API.

RouteType

Het type route dat is aangevraagd.

Name Type Description
eco

string

Een route die in balans is met economie en snelheid.
fastest

string

De snelste route.
shortest

string

De kortste route op afstand.
thrilling

string

Omvat interessante of uitdagende wegen en gebruikt zo min mogelijk snelwegen. U kunt het niveau van de inbegrepen bochten en ook de mate van heuvelachtigheid kiezen. Bekijk de parameters heuvelachtigheid en windingness om dit in te stellen. Er is een limiet van 900 km op routes gepland met routeType=spannend

TravelMode

De manier van reizen 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. Als de aangevraagde travelMode niet beschikbaar is voor een bepaalde sectie, is het travelMode-element van het antwoord voor die sectie 'overige'. Houd er rekening mee dat reismodi bus, motor, taxi en busje beta-functionaliteit zijn. Volledige beperkingsgegevens zijn niet in alle gebieden beschikbaar.

Name Type Description
bus

string

De geretourneerde routes zijn geoptimaliseerd voor bussen, inclusief het gebruik van alleen busrijen. BETA-functionaliteit.
car

string

De geretourneerde routes zijn geoptimaliseerd voor auto's.
motorcycle

string

De geretourneerde routes zijn geoptimaliseerd voor motorfietsen. BETA-functionaliteit.
taxi

string

De geretourneerde routes zijn geoptimaliseerd voor taxi's. BETA-functionaliteit.
truck

string

De geretourneerde routes zijn geoptimaliseerd voor bedrijfsvoertuigen, zoals voor vrachtwagens.
van

string

De geretourneerde routes zijn geoptimaliseerd voor busjes. BETA-functionaliteit.

VehicleEngineType

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

Name Type Description
combustion

string

Verbrandingsmotor.
electric

string

Elektrische motor.

VehicleLoadType

Soorten ladingen die kunnen worden geclassificeerd als gevaarlijke materialen en beperkt zijn vanaf bepaalde wegen. Beschikbare vehicleLoadType-waarden zijn Amerikaanse 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 otherHazmat 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.

Name Type Description
USHazmatClass1

string

Explosieven
USHazmatClass2

string

Gecomprimeerd gas
USHazmatClass3

string

Ontvlambare vloeistoffen
USHazmatClass4

string

Ontvlambare vaste stoffen
USHazmatClass5

string

Oxiderende stoffen
USHazmatClass6

string

Vergif
USHazmatClass7

string

Radioactief
USHazmatClass8

string

Corrosief materiaal
USHazmatClass9

string

Diversen
otherHazmatExplosive

string

Explosieven
otherHazmatGeneral

string

Diversen
otherHazmatHarmfulToWater

string

Schadelijk voor water

WindingnessLevel

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

Name Type Description
high

string

hoog
low

string

laag
normal

string

normaal