Route - Post Route Matrix
Använd för att hämta en vägmatris som visar restid och avstånd för alla möjliga par i en lista över ursprung och mål, med hjälp av en asynkron begäran.
API:et Post Route Matrix
är en HTTP-begäran POST
som gör det möjligt att beräkna en matris med vägsammanfattningar för en uppsättning vägar som definierats av ursprungs- och målplatser med hjälp av en asynkron begäran (asynkron). Information om hur du gör en synkron (synkron) begäran finns i Efter routningsmatrissynkronisering. För varje angivet ursprung beräknar tjänsten kostnaden för routning från det ursprunget till varje angivet mål. Uppsättningen ursprung och måluppsättningen kan betraktas som kolumn- och radrubriker i en tabell och varje cell i tabellen innehåller kostnaderna för routning från ursprunget till målet för cellen. Anta till exempel att ett livsmedelsleveransföretag har 20 förare och att de måste hitta den närmaste föraren för att hämta leveransen från restaurangen. För att lösa det här användningsfallet kan de anropa Matrix Route API.
För varje rutt returneras restiderna och avstånden. Du kan använda de beräknade kostnaderna för att avgöra vilka detaljerade vägar som ska beräknas med hjälp av API:et Route Directions.
Den maximala storleken för en matris för asynkron begäran är 700 och för synkroniseringsbegäran är den 100 (antalet ursprung multiplicerat med antalet mål).
Skicka begäran om synkron routningsmatris
Om ditt scenario kräver synkrona begäranden och matrisens maximala storlek är mindre än eller lika med 100, kanske du vill göra en synkron begäran. Den maximala storleken på en matris för det här API:et är 100 (antalet ursprung multiplicerat med antalet mål). Med den begränsningen i åtanke är exempel på möjliga matrisdimensioner: 10x10, 6x8, 9x8 (det behöver inte vara kvadrat).
POST https://atlas.microsoft.com/route/matrix/sync/json?api-version=1.0&subscription-key={subscription-key}
Skicka begäran om asynkron routningsmatris
Det asynkrona API:et är lämpligt för bearbetning av stora volymer av relativt komplexa routningsbegäranden. När du gör en begäran med hjälp av en asynkron begäran returnerar tjänsten som standard en 202-svarskod längs en omdirigerings-URL i fältet Plats i svarshuvudet. Den här URL:en bör kontrolleras regelbundet tills svarsdata eller felinformation är tillgänglig. Om waitForResults
parametern i begäran är inställd på true får användaren ett 200-svar om begäran slutförs under 120 sekunder.
Den maximala storleken på en matris för det här API:et är 700 (antalet ursprung multiplicerat med antalet mål). Med den begränsningen i åtanke är exempel på möjliga matrisdimensioner: 50x10, 10x10, 28x25. 10x70 (den behöver inte vara kvadratisk).
De asynkrona svaren lagras i 14 dagar. Omdirigerings-URL:en returnerar ett 404-svar om det används efter förfalloperioden.
POST https://atlas.microsoft.com/route/matrix/json?api-version=1.0&subscription-key={subscription-key}
Här är en typisk sekvens med asynkrona åtgärder:
Klienten skickar en POST-begäran om routningsmatris till Azure Maps
Servern svarar med något av följande:
HTTP
202 Accepted
– Begäran om routningsmatris har accepterats.HTTP
Error
– Ett fel uppstod när begäran om routningsmatris bearbetades. Detta kan antingen vara en 400 Felaktig begäran eller någon annan felstatuskod.Om matrisvägens begäran godkändes innehåller platsrubriken i svaret URL:en för att ladda ned resultatet av begäran. Den här status-URI:n ser ut så här:
GET https://atlas.microsoft.com/route/matrix/{matrixId}?api-version=1.0?subscription-key={subscription-key}
- Klienten utfärdar en GET-begäran på nedladdnings-URL:en som hämtades i steg 3 för att ladda ned resultatet
Ladda ned synkroniseringsresultat
När du gör en POST-begäran för API:et för routningsmatrissynkronisering returnerar tjänsten 200 svarskod för lyckad begäran och en svarsmatris. Svarstexten innehåller data och det finns ingen möjlighet att hämta resultaten senare.
Ladda ned Async-resultat
När en begäran utfärdar ett 202 Accepted
svar bearbetas begäran med hjälp av vår asynkrona pipeline. Du får en URL för att kontrollera förloppet för din asynkrona begäran i platsrubriken för svaret. Den här status-URI:n ser ut så här:
GET https://atlas.microsoft.com/route/matrix/{matrixId}?api-version=1.0?subscription-key={subscription-key}
Url:en som tillhandahålls av platsrubriken returnerar följande svar när en GET
begäran utfärdas.
HTTP
202 Accepted
– Matrisbegäran godkändes men bearbetas fortfarande. Försök igen om en stund.
HTTP
200 OK
– Matrisbegäran har bearbetats. Svarstexten innehåller alla resultat.
POST https://atlas.microsoft.com/route/matrix/json?api-version=1.0
POST https://atlas.microsoft.com/route/matrix/json?api-version=1.0&waitForResults={waitForResults}&computeTravelTimeFor={computeTravelTimeFor}§ionType={sectionType}&arriveAt={arriveAt}&departAt={departAt}&vehicleAxleWeight={vehicleAxleWeight}&vehicleLength={vehicleLength}&vehicleHeight={vehicleHeight}&vehicleWidth={vehicleWidth}&vehicleMaxSpeed={vehicleMaxSpeed}&vehicleWeight={vehicleWeight}&windingness={windingness}&hilliness={hilliness}&travelMode={travelMode}&avoid={avoid}&traffic={traffic}&routeType={routeType}&vehicleLoadType={vehicleLoadType}
URI-parametrar
Name | I | Obligatorisk | Typ | Description |
---|---|---|---|---|
format
|
path | True |
Önskat format för svaret. Endast |
|
api-version
|
query | True |
string |
Versionsnummer för Azure Maps API. |
arrive
|
query |
string date-time |
Datum och tid för ankomst till målplatsen formaterat som ett Exempel:
Parametern |
|
avoid
|
query |
Anger något som vägberäkningen bör försöka undvika när du fastställer vägen. Kan anges flera gånger i en begäran, till exempel "&avoid=motorways&avoid=tollRoads&avoid=ferries". I Begäranden om routningsintervall får värdet alreadyUsedRoads inte användas. |
||
compute
|
query |
Anger om du vill returnera ytterligare restider med olika typer av trafikinformation (ingen, historisk, live) samt bästa möjliga restid. |
||
depart
|
query |
string date-time |
Datum och tid för avvikelse från ursprungspunkten formaterat som ett
Exempel:
Parametern |
|
hilliness
|
query |
Grad av bergighet för spännande rutt. Den här parametern kan endast användas tillsammans med |
||
route
|
query |
Den typ av väg som begärs. |
||
section
|
query |
Anger vilken av avsnittstyperna som rapporteras i vägsvaret. |
||
traffic
|
query |
boolean |
Möjliga värden:
|
|
travel
|
query |
Färdmedel för den begärda rutten. Om det inte definieras är standardvärdet "car". Observera att den begärda travelMode kanske inte är tillgänglig för hela rutten. Om den begärda travelMode inte är tillgänglig för ett visst avsnitt, kommer travelMode-elementet i svaret för det avsnittet att vara "annat". Observera att reslägen buss, motorcykel, taxi och van är BETA-funktioner. Fullständiga begränsningsdata är inte tillgängliga i alla områden. |
||
vehicle
|
query |
integer |
Fordonets vikt per axel i kg. Värdet 0 innebär att viktbegränsningar per axel inte beaktas. |
|
vehicle
|
query |
number double |
Fordonets höjd i meter. Värdet 0 innebär att höjdbegränsningar inte beaktas. |
|
vehicle
|
query |
number double |
Fordonets längd i meter. Värdet 0 innebär att längdbegränsningar inte beaktas. |
|
vehicle
|
query |
Typer av last som kan klassificeras som farliga material och begränsas från vissa vägar. Tillgängliga vehicleLoadType-värden är AMERIKANSKA Hazmat-klasser 1 till och med 9, plus generiska klassificeringar för användning i andra länder/regioner. Värden som börjar med USHazmat är för USA-routning medan andraHazmat ska användas för alla andra länder/regioner. vehicleLoadType kan anges flera gånger. Den här parametern beaktas för närvarande endast för travelMode=truck. |
||
vehicle
|
query |
integer |
Fordonets högsta hastighet i km/timme. Maxhastigheten i fordonsprofilen används för att kontrollera om ett fordon tillåts på motorvägar.
|
|
vehicle
|
query |
integer |
Fordonets vikt i kg. |
|
vehicle
|
query |
number double |
Fordonets bredd i meter. Värdet 0 innebär att breddbegränsningar inte beaktas. |
|
wait
|
query |
boolean |
Booleskt värde som anger om begäran ska köras synkront. Om värdet är true får användaren ett svar på 200 om begäran har slutförts under 120 sekunder. Annars får användaren ett svar från 202 direkt. Mer information om 202-svaret finns i API-beskrivningen. Stöds endast för asynkron begäran. |
|
windingness
|
query |
Nivå av svängar för spännande rutt. Den här parametern kan endast användas tillsammans med |
Begärandehuvud
Name | Obligatorisk | Typ | Description |
---|---|---|---|
x-ms-client-id |
string |
Anger vilket konto som är avsett för användning tillsammans med Microsoft Entra ID-säkerhetsmodellen. Den representerar ett unikt ID för Azure Maps-kontot och kan hämtas från Konto-API:et för Azure Maps-hanteringsplan. Information om hur du använder Microsoft Entra ID-säkerhet i Azure Maps finns i följande artiklar . |
Begärandetext
Name | Typ | Description |
---|---|---|
destinations |
En giltig |
|
origins |
En giltig |
Svar
Name | Typ | Description |
---|---|---|
200 OK |
Matrisbegäran har bearbetats. Svarstexten innehåller alla resultat. |
|
202 Accepted |
Stöds endast för asynkron begäran. Begäran accepterad: Begäran har godkänts för bearbetning. Använd URL:en i platsrubriken för att försöka igen eller komma åt resultatet. Sidhuvuden Location: string |
|
Other Status Codes |
Det uppstod ett oväntat fel. |
Säkerhet
AADToken
Det här är Microsoft Entra OAuth 2.0-flöden . När den är kopplad till rollbaserad åtkomstkontroll i Azure kan den användas för att styra åtkomsten till REST-API:er för Azure Maps. Rollbaserade åtkomstkontroller i Azure används för att ange åtkomst till ett eller flera Azure Maps-resurskonton eller underresurser. Alla användare, grupper eller tjänstens huvudnamn kan beviljas åtkomst via en inbyggd roll eller en anpassad roll som består av en eller flera behörigheter till Rest-API:er för Azure Maps.
För att implementera scenarier rekommenderar vi att du visar autentiseringsbegrepp. Sammanfattningsvis tillhandahåller den här säkerhetsdefinitionen en lösning för modellering av program via objekt som kan få åtkomstkontroll för specifika API:er och omfång.
Kommentarer
- Den här säkerhetsdefinitionen
x-ms-client-id
kräver att huvudet används för att ange vilken Azure Maps-resurs programmet begär åtkomst till. Detta kan hämtas från Maps Management-API:et.
Authorization URL
är specifikt för den offentliga Azure-molninstansen. Nationella moln har unika auktoriserings-URL:er och Microsoft Entra ID-konfigurationer.
* Den rollbaserade åtkomstkontrollen i Azure konfigureras från Azure-hanteringsplanet via Azure-portalen, PowerShell, CLI, Azure SDK:er eller REST-API:er.
* Användning av Webb-SDK för Azure Maps möjliggör konfigurationsbaserad konfiguration av ett program för flera användningsfall.
- Mer information om Microsofts identitetsplattform finns i Översikt över Microsofts identitetsplattform.
Typ:
oauth2
Flow:
implicit
Auktoriseringswebbadress:
https://login.microsoftonline.com/common/oauth2/authorize
Omfattningar
Name | Description |
---|---|
https://atlas.microsoft.com/.default | https://atlas.microsoft.com/.default |
subscription-key
Det här är en delad nyckel som etableras när du skapar ett Azure Maps-konto i Azure-portalen eller använder PowerShell, CLI, Azure SDK:er eller REST API.
Med den här nyckeln kan alla program komma åt alla REST-API:et. Med andra ord kan den här nyckeln användas som en huvudnyckel i det konto som de utfärdas i.
För offentligt exponerade program rekommenderar vi att du använder metoden för konfidentiella klientprogram för att få åtkomst till REST-API:er för Azure Maps så att din nyckel kan lagras på ett säkert sätt.
Typ:
apiKey
I:
query
SAS Token
Det här är en signaturtoken för delad åtkomst som skapas från åtgärden Lista SAS på Azure Maps-resursen via Azure-hanteringsplanet via Azure-portalen, PowerShell, CLI, Azure SDK:er eller REST-API:er.
Med den här token har alla program behörighet att komma åt med rollbaserade Åtkomstkontroller i Azure och detaljerad kontroll av förfallodatum, frekvens och region för användning för den specifika token. Med andra ord kan SAS-token användas för att tillåta program att styra åtkomsten på ett mer säkert sätt än den delade nyckeln.
För offentligt exponerade program rekommenderar vi att du konfigurerar en specifik lista över tillåtna ursprung på map-kontoresursen för att begränsa återgivningsmissbruk och regelbundet förnya SAS-token.
Typ:
apiKey
I:
header
Exempel
Successfully submit a route matrix request
Exempelbegäran
POST https://atlas.microsoft.com/route/matrix/json?api-version=1.0&routeType=shortest
{
"origins": {
"type": "MultiPoint",
"coordinates": [
[
4.85106,
52.36006
],
[
4.85056,
52.36187
]
]
},
"destinations": {
"type": "MultiPoint",
"coordinates": [
[
4.85003,
52.36241
],
[
13.42937,
52.50931
]
]
}
}
Exempelsvar
{
"formatVersion": "0.0.1",
"matrix": [
[
{
"statusCode": 200,
"response": {
"routeSummary": {
"lengthInMeters": 495,
"travelTimeInSeconds": 134,
"trafficDelayInSeconds": 0,
"departureTime": "2018-07-27T22:55:29+00:00",
"arrivalTime": "2018-07-27T22:57:43+00:00"
}
}
},
{
"statusCode": 200,
"response": {
"routeSummary": {
"lengthInMeters": 647651,
"travelTimeInSeconds": 26835,
"trafficDelayInSeconds": 489,
"departureTime": "2018-07-27T22:55:29+00:00",
"arrivalTime": "2018-07-28T06:22:44+00:00"
}
}
}
],
[
{
"statusCode": 200,
"response": {
"routeSummary": {
"lengthInMeters": 338,
"travelTimeInSeconds": 104,
"trafficDelayInSeconds": 0,
"departureTime": "2018-07-27T22:55:29+00:00",
"arrivalTime": "2018-07-27T22:57:13+00:00"
}
}
},
{
"statusCode": 200,
"response": {
"routeSummary": {
"lengthInMeters": 647494,
"travelTimeInSeconds": 26763,
"trafficDelayInSeconds": 469,
"departureTime": "2018-07-27T22:55:29+00:00",
"arrivalTime": "2018-07-28T06:21:32+00:00"
}
}
}
]
],
"summary": {
"successfulRoutes": 4,
"totalRoutes": 4
}
}
operation-Location: New URL to check the status of the long-running operation.
Definitioner
Name | Description |
---|---|
Compute |
Anger om du vill returnera ytterligare restider med hjälp av olika typer av trafikinformation (ingen, historisk, live) samt bästa möjliga restid. |
Error |
Ytterligare information om resurshanteringsfelet. |
Error |
Felinformationen. |
Error |
Felsvar |
Geo |
En giltig |
Incline |
Grad av bergighet för spännande rutt. Den här parametern kan endast användas tillsammans med |
Json |
Önskat format för svaret. Endast |
Route |
Anger något som vägberäkningen ska försöka undvika när du fastställer vägen. Kan anges flera gånger i en begäran, till exempel "&avoid=motorways&avoid=tollRoads&avoid=ferries". I Begäranden om routningsintervall får värdet redanUsedRoads inte användas. |
Route |
Sammanfattningsobjekt för vägavsnitt. |
Route |
Matrisresultatobjekt |
Route |
Ett objekt med en matris med koordinater. |
Route |
Det här objektet returneras från ett lyckat Routningsmatrisanrop. Om till exempel 2 ursprung och 3 mål tillhandahålls finns det två matriser med 3 element i varje. Varje elements innehåll beror på vilka alternativ som anges i frågan. |
Route |
Svarsobjekt för den aktuella cellen i indatamatrisen. |
Route |
Sammanfattningsobjekt |
Route |
Den typ av väg som begärs. |
Section |
Anger vilken av avsnittstyperna som rapporteras i routningssvaret. |
Travel |
Färdsätt för den begärda rutten. Om det inte definieras är standardvärdet "bil". Observera att den begärda travelMode kanske inte är tillgänglig för hela vägen. Om den begärda travelMode inte är tillgänglig för ett visst avsnitt är travelMode-elementet i svaret för det avsnittet "annat". Observera att färdlägena buss, motorcykel, taxi och van är BETA-funktioner. Fullständiga begränsningsdata är inte tillgängliga i alla områden. |
Vehicle |
Typer av last som kan klassificeras som farligt material och som är begränsade från vissa vägar. Tillgängliga vehicleLoadType-värden är amerikanska Hazmat-klasser 1 till och med 9, plus generiska klassificeringar för användning i andra länder/regioner. Värden som börjar med USHazmat är för USA-routning medan andraHazmat ska användas för alla andra länder/regioner. vehicleLoadType kan anges flera gånger. Den här parametern beaktas för närvarande endast för travelMode=truck. |
Windingness |
Nivå av svängar för spännande rutt. Den här parametern kan endast användas tillsammans med |
ComputeTravelTime
Anger om du vill returnera ytterligare restider med hjälp av olika typer av trafikinformation (ingen, historisk, live) samt bästa möjliga restid.
Name | Typ | Description |
---|---|---|
all |
string |
Beräknar restider för alla typer av trafikinformation och anger alla resultat i fälten noTrafficTravelTimeInSeconds, historicTrafficTravelTimeInSeconds och liveTrafficIncidentsTravelTimeInSeconds som ingår i sammanfattningarna i vägsvaret. |
none |
string |
Beräknar inte ytterligare restider. |
ErrorAdditionalInfo
Ytterligare information om resurshanteringsfelet.
Name | Typ | Description |
---|---|---|
info |
object |
Den ytterligare informationen. |
type |
string |
Ytterligare informationstyp. |
ErrorDetail
Felinformationen.
Name | Typ | Description |
---|---|---|
additionalInfo |
Ytterligare information om felet. |
|
code |
string |
Felkoden. |
details |
Felinformationen. |
|
message |
string |
Felmeddelandet. |
target |
string |
Felmålet. |
ErrorResponse
Felsvar
Name | Typ | Description |
---|---|---|
error |
Felobjektet. |
GeoJsonMultiPoint
En giltig GeoJSON MultiPoint
geometrityp. Mer information finns i RFC 7946 .
Name | Typ | Description |
---|---|---|
coordinates |
number[] |
Koordinater för geometrin |
type |
string:
Multi |
Anger |
InclineLevel
Grad av bergighet för spännande rutt. Den här parametern kan endast användas tillsammans med routeType
=spännande.
Name | Typ | Description |
---|---|---|
high |
string |
hög |
low |
string |
låg |
normal |
string |
normal |
JsonFormat
Önskat format för svaret. Endast json
format stöds.
Name | Typ | Description |
---|---|---|
json |
string |
RouteAvoidType
Anger något som vägberäkningen ska försöka undvika när du fastställer vägen. Kan anges flera gånger i en begäran, till exempel "&avoid=motorways&avoid=tollRoads&avoid=ferries". I Begäranden om routningsintervall får värdet redanUsedRoads inte användas.
Name | Typ | Description |
---|---|---|
alreadyUsedRoads |
string |
Undviker att använda samma väg flera gånger. Mest användbart tillsammans med |
borderCrossings |
string |
Undviker gränsövergångar i vägberäkningen. |
carpools |
string |
Undviker vägar som kräver användning av samåkningsbanor (HOV/High Occupancy Vehicle). |
ferries |
string |
Undviker färjor |
motorways |
string |
Undviker motorvägar |
tollRoads |
string |
Undviker avgiftsbelagda vägar. |
unpavedRoads |
string |
Undviker osparade vägar |
RouteLegSummary
Sammanfattningsobjekt för vägavsnitt.
Name | Typ | Description |
---|---|---|
arrivalTime |
string |
Beräknad ankomsttid för rutten eller benet. Tiden är i UTC. |
batteryConsumptionInkWh |
number |
Uppskattad elenergiförbrukning i kilowatttimmar (kWh) med hjälp av elförbrukningsmodellen. Ingår om vehicleEngineType är inställt på elektrisk och constantSpeedConsumptionInkWhPerHundredkm har angetts. Värdet för batteryConsumptionInkWh inkluderar den upprymda elenergin och kan därför vara negativ (vilket indikerar att energin ökar). Om både maxChargeInkWh och currentChargeInkWh anges begränsas återställningen för att säkerställa att batteriladdningsnivån aldrig överskrider maxChargeInkWh. Om varken maxChargeInkWh eller currentChargeInkWh anges antas obegränsad återhämtning i förbrukningsberäkningen. |
departureTime |
string |
Beräknad avgångstid för rutten eller benet. Tiden är i UTC. |
fuelConsumptionInLiters |
number |
Uppskattad bränsleförbrukning i liter med hjälp av förbränningsförbrukningsmodellen. Ingår om vehicleEngineType är inställt på förbränning och constantSpeedConsumptionInLitersPerHundredkm anges. Värdet blir icke-negativt. |
historicTrafficTravelTimeInSeconds |
integer |
Beräknad restid som beräknas med tidsberoende historiska trafikdata. Ingår endast om computeTravelTimeFor = alla används i frågan. |
lengthInMeters |
integer |
Egenskapen Längd i meter |
liveTrafficIncidentsTravelTimeInSeconds |
integer |
Uppskattad restid som beräknas med hjälp av hastighetsdata i realtid. Ingår endast om computeTravelTimeFor = alla används i frågan. |
noTrafficTravelTimeInSeconds |
integer |
Beräknad restid beräknad som om det inte finns några förseningar på rutten på grund av trafikförhållanden (t.ex. överbelastning). Ingår endast om computeTravelTimeFor = alla används i frågan. |
trafficDelayInSeconds |
integer |
Uppskattad fördröjning i sekunder som orsakas av realtidsincidenter enligt trafikinformation. För rutter som planeras med avgångstid i framtiden är förseningar alltid 0. Om du vill returnera ytterligare restider med olika typer av trafikinformation måste parametern computeTravelTimeFor=all läggas till. |
travelTimeInSeconds |
integer |
Uppskattad restid i egenskapen sekunder som inkluderar fördröjningen på grund av realtidstrafik. Observera att även när traffic=false travelTimeInSeconds fortfarande inkluderar fördröjningen på grund av trafik. Om DepartAt är i framtiden beräknas restiden med hjälp av tidsberoende historiska trafikdata. |
RouteMatrix
Matrisresultatobjekt
Name | Typ | Description |
---|---|---|
response |
Svarsobjekt för den aktuella cellen i indatamatrisen. |
|
statusCode |
integer |
StatusCode-egenskapen för den aktuella cellen i indatamatrisen. |
RouteMatrixQuery
Ett objekt med en matris med koordinater.
Name | Typ | Description |
---|---|---|
destinations |
En giltig |
|
origins |
En giltig |
RouteMatrixResult
Det här objektet returneras från ett lyckat Routningsmatrisanrop. Om till exempel 2 ursprung och 3 mål tillhandahålls finns det två matriser med 3 element i varje. Varje elements innehåll beror på vilka alternativ som anges i frågan.
Name | Typ | Description |
---|---|---|
formatVersion |
string |
Formatversionsegenskap |
matrix |
Resultat som en 2-dimensionell matris med routningssammanfattningar. |
|
summary |
Sammanfattningsobjekt |
RouteMatrixResultResponse
Svarsobjekt för den aktuella cellen i indatamatrisen.
Name | Typ | Description |
---|---|---|
routeSummary |
Sammanfattningsobjekt för vägavsnitt. |
RouteMatrixSummary
Sammanfattningsobjekt
Name | Typ | Description |
---|---|---|
successfulRoutes |
integer |
Antal lyckade vägar i svaret. |
totalRoutes |
integer |
Totalt antal begärda vägar. Antal celler i indatamatrisen. |
RouteType
Den typ av väg som begärs.
Name | Typ | Description |
---|---|---|
eco |
string |
En väg som balanseras av ekonomi och hastighet. |
fastest |
string |
Den snabbaste vägen. |
shortest |
string |
Den kortaste vägen med avstånd. |
thrilling |
string |
Inkluderar intressanta eller utmanande vägar och använder så få motorvägar som möjligt. Du kan välja vilken nivå av svängar som ingår och även graden av bergighet. Se parametrarna hilliness och windingness för hur du ställer in detta. Det finns en gräns på 900 km på rutter planerade med |
SectionType
Anger vilken av avsnittstyperna som rapporteras i routningssvaret.
Till exempel om sectionType = fotgängare de sektioner som är lämpade för fotgängare endast returneras. Flera typer kan användas. StandardavsnittTypen refererar till travelMode-indata. Som standard är travelMode inställt på bil
Name | Typ | Description |
---|---|---|
carTrain |
string |
Delar av rutten som är bilar eller tåg. |
carpool |
string |
Delar av rutten som kräver användning av samåkningsfiler (HOV/High Occupancy Vehicle). |
country |
string |
Avsnitt som anger vilka länder/regioner som rutten finns i. |
ferry |
string |
Delar av rutten som är färjor. |
motorway |
string |
Delar av rutten som är motorvägar. |
pedestrian |
string |
Delar av rutten som endast lämpar sig för fotgängare. |
tollRoad |
string |
Delar av rutten som kräver en avgift som ska betalas. |
tollVignette |
string |
Delar av rutten som kräver en avgiftsbelagd vinjett för att finnas. |
traffic |
string |
Delar av vägen som innehåller trafikinformation. |
travelMode |
string |
Avsnitt i förhållande till parametern |
tunnel |
string |
Delar av rutten som är tunnlar. |
urban |
string |
Delar av rutten som finns i stadsområden. |
TravelMode
Färdsätt för den begärda rutten. Om det inte definieras är standardvärdet "bil". Observera att den begärda travelMode kanske inte är tillgänglig för hela vägen. Om den begärda travelMode inte är tillgänglig för ett visst avsnitt är travelMode-elementet i svaret för det avsnittet "annat". Observera att färdlägena buss, motorcykel, taxi och van är BETA-funktioner. Fullständiga begränsningsdata är inte tillgängliga i alla områden.
Name | Typ | Description |
---|---|---|
bicycle |
string |
De returnerade vägarna är optimerade för cyklar, inklusive användning av cykelbanor. |
bus |
string |
De returnerade rutterna är optimerade för bussar, inklusive användning av endast bussfiler. BETA-funktioner. |
car |
string |
De returnerade vägarna är optimerade för bilar. |
motorcycle |
string |
De returnerade vägarna är optimerade för motorcyklar. BETA-funktioner. |
pedestrian |
string |
De returnerade vägarna är optimerade för fotgängare, inklusive användning av trottoarer. |
taxi |
string |
De returnerade vägarna är optimerade för taxibilar. BETA-funktioner. |
truck |
string |
De returnerade rutterna är optimerade för nyttofordon, som för lastbilar. |
van |
string |
De returnerade vägarna är optimerade för skåpbilar. BETA-funktioner. |
VehicleLoadType
Typer av last som kan klassificeras som farligt material och som är begränsade från vissa vägar. Tillgängliga vehicleLoadType-värden är amerikanska Hazmat-klasser 1 till och med 9, plus generiska klassificeringar för användning i andra länder/regioner. Värden som börjar med USHazmat är för USA-routning medan andraHazmat ska användas för alla andra länder/regioner. vehicleLoadType kan anges flera gånger. Den här parametern beaktas för närvarande endast för travelMode=truck.
Name | Typ | Description |
---|---|---|
USHazmatClass1 |
string |
Explosiva ämnen och föremål |
USHazmatClass2 |
string |
Komprimerad gas |
USHazmatClass3 |
string |
Brandfarliga vätskor |
USHazmatClass4 |
string |
Brandfarliga fasta ämnen |
USHazmatClass5 |
string |
Oxidatorer |
USHazmatClass6 |
string |
Gifter |
USHazmatClass7 |
string |
Radioaktiva ämnen |
USHazmatClass8 |
string |
Frätande |
USHazmatClass9 |
string |
Övriga farliga ämnen |
otherHazmatExplosive |
string |
Explosiva ämnen och föremål |
otherHazmatGeneral |
string |
Övriga farliga ämnen |
otherHazmatHarmfulToWater |
string |
Skadligt för vatten |
WindingnessLevel
Nivå av svängar för spännande rutt. Den här parametern kan endast användas tillsammans med routeType
=spännande.
Name | Typ | Description |
---|---|---|
high |
string |
hög |
low |
string |
låg |
normal |
string |
normal |