Udostępnij za pośrednictwem

Route - Get Route Range

  • Odwołanie
Service:
Maps
API Version:
1.0

Umożliwia utworzenie mapy przedstawiającej obszar dostępny z danego punktu w określonym progu na podstawie czasu, odległości lub pojemności paliwa.

Get Route Range Interfejs API (Isochrone) to żądanie HTTPGET, które oblicza zestaw lokalizacji, które można uzyskać z punktu początkowego na podstawie określonego budżetu paliwa, energii, czasu lub odległości. Granica wielokąta (lub Isochrone) jest zwracana w orientacji odwrotnej do ruchu wskazówek zegara, a także dokładnego środka wielokąta, który był wynikiem punktu początkowego.

Zwrócony wielokąt może służyć do dalszego przetwarzania, takiego jak Search Wewnątrz Geometrii, aby wyszukać interfejsy POI w ramach podanego izochronu.

GET https://atlas.microsoft.com/route/range/{format}?api-version=1.0&query={query}
With optional parameters: 
GET https://atlas.microsoft.com/route/range/{format}?api-version=1.0&query={query}&fuelBudgetInLiters={fuelBudgetInLiters}&energyBudgetInkWh={energyBudgetInkWh}&timeBudgetInSec={timeBudgetInSec}&distanceBudgetInMeters={distanceBudgetInMeters}&departAt={departAt}&routeType={routeType}&traffic={traffic}&avoid={avoid}&travelMode={travelMode}&hilliness={hilliness}&windingness={windingness}&vehicleAxleWeight={vehicleAxleWeight}&vehicleWidth={vehicleWidth}&vehicleHeight={vehicleHeight}&vehicleLength={vehicleLength}&vehicleMaxSpeed={vehicleMaxSpeed}&vehicleWeight={vehicleWeight}&vehicleCommercial={vehicleCommercial}&vehicleLoadType={vehicleLoadType}&vehicleEngineType={vehicleEngineType}&constantSpeedConsumptionInLitersPerHundredkm={constantSpeedConsumptionInLitersPerHundredkm}&currentFuelInLiters={currentFuelInLiters}&auxiliaryPowerInLitersPerHour={auxiliaryPowerInLitersPerHour}&fuelEnergyDensityInMJoulesPerLiter={fuelEnergyDensityInMJoulesPerLiter}&accelerationEfficiency={accelerationEfficiency}&decelerationEfficiency={decelerationEfficiency}&uphillEfficiency={uphillEfficiency}&downhillEfficiency={downhillEfficiency}&constantSpeedConsumptionInkWhPerHundredkm={constantSpeedConsumptionInkWhPerHundredkm}&currentChargeInkWh={currentChargeInkWh}&maxChargeInkWh={maxChargeInkWh}&auxiliaryPowerInkW={auxiliaryPowerInkW}

Parametry identyfikatora URI

Nazwa W Wymagane Typ Opis
format
 path True

ResponseFormat

Żądany format odpowiedzi. Wartość może być json lub xml.
api-version
 query True

string

Numer wersji interfejsu API Azure Maps.
query
 query True

number[]

Współrzędna, z której ma zostać uruchomione obliczenie zakresu.
accelerationEfficiency
 query

number

double

Określa wydajność konwersji energii chemicznej przechowywanej w paliwie na energię kinetyczną, gdy pojazd przyspiesza (tj. Kinetic EnergyGained/Chemical EnergyConsumed). Chemical EnergyConsumed uzyskuje się poprzez przekonwertowanie zużytego paliwa na energię chemiczną przy użyciu paliwa EnergyDensityInMJoulesPerLiter.

Musi być sparowana z decelerationEfficiency.

Dozwolony zakres wartości to od 0,0 do 1/decelerationEfficiency.

Rozsądne wartości: dla modelu spalania : 0,33, dla modelu elektrycznego : 0,66
auxiliaryPowerInkW
 query

number

double

Określa ilość zużytej mocy do utrzymania systemów pomocniczych w kilowatach (kW).

Może służyć do określania zużycia z powodu urządzeń i systemów, takich jak systemy AC, radio, ogrzewanie itp.

Rozsądne wartości: 1,7
auxiliaryPowerInLitersPerHour
 query

number

double

Określa ilość zużytego paliwa do utrzymania systemów pomocniczych pojazdu, w litrach na godzinę.

Może służyć do określania zużycia z powodu urządzeń i systemów, takich jak systemy AC, radio, ogrzewanie itp.

Rozsądne wartości: 0,2
avoid
 query

RouteAvoidType[]

Określa element, którego obliczenie trasy powinno próbować uniknąć podczas określania trasy. Można określić wiele razy w jednym żądaniu, na przykład "&avoid=highways&avoid=tollRoads&avoid=promy". W żądaniach zakresu tras wartość jużUsedRoads nie może być używana.
constantSpeedConsumptionInkWhPerHundredkm
 query

string

Określa składnik zależny od szybkości zużycia.

Podana jako nieurządkowana lista par szybkości/szybkości/szybkości. Lista definiuje punkty na krzywej zużycia. Stawki zużycia dla szybkości, które nie znajdują się na liście, są następujące:

  • przez interpolację liniową, jeśli dana prędkość znajduje się między dwiema prędkościami na liście

  • przez ekstrapolację liniową w przeciwnym razie przy założeniu stałej (ΔConsumption/ΔSpeed) określonej przez najbliższe dwa punkty na liście

Lista musi zawierać od 1 do 25 punktów (włącznie) i może nie zawierać zduplikowanych punktów dla tej samej prędkości. Jeśli zawiera tylko jeden punkt, wskaźnik zużycia tego punktu jest używany bez dalszego przetwarzania.

Zużycie określone dla największej prędkości musi być większe lub równe z przedostatnią największą prędkością. Dzięki temu ekstrapolacja nie prowadzi do ujemnych wskaźników konsumpcji.

Podobnie wartości zużycia określone dla dwóch najmniejszych prędkości na liście nie mogą prowadzić do ujemnego zużycia w przypadku mniejszej prędkości.

Prawidłowy zakres wartości zużycia (wyrażony w kWh/100 km) wynosi od 0,01 do 10000,0.

Rozsądne wartości: 50,8.2:130,21.3

Ten parametr jest wymagany w przypadku modelu zużycia energii elektrycznej.
constantSpeedConsumptionInLitersPerHundredkm
 query

string

Określa składnik zależny od szybkości zużycia.

Podana jako lista nieurządkowanych par szybkości rozdzielanych dwukropkami & szybkości użycia. Lista definiuje punkty na krzywej zużycia. Stawki zużycia dla szybkości, które nie znajdują się na liście, są następujące:

  • przez interpolację liniową, jeśli dana prędkość znajduje się między dwiema prędkościami na liście

  • przez ekstrapolację liniową w przeciwnym razie przy założeniu stałej (ΔConsumption/ΔSpeed) określonej przez najbliższe dwa punkty na liście

Lista musi zawierać od 1 do 25 punktów (włącznie) i może nie zawierać zduplikowanych punktów dla tej samej prędkości. Jeśli zawiera tylko jeden punkt, wskaźnik zużycia tego punktu jest używany bez dalszego przetwarzania.

Zużycie określone dla największej prędkości musi być większe lub równe z przedostatnią największą prędkością. Dzięki temu ekstrapolacja nie prowadzi do ujemnych wskaźników konsumpcji.

Podobnie wartości zużycia określone dla dwóch najmniejszych prędkości na liście nie mogą prowadzić do ujemnego zużycia w przypadku mniejszej prędkości.

Prawidłowy zakres wartości zużycia (wyrażony w l/100 km) wynosi od 0,01 do 100000,0.

Rozsądne wartości: 50,6.3:130,11.5

Uwaga : ten parametr jest wymagany dla modelu zużycia spalania.
currentChargeInkWh
 query

number

double

Określa bieżącą energię elektryczną w godzinach kilowatów (kWh).

Ten parametr współistnieje z parametrem maxChargeInkWh .

Dozwolony zakres wartości to od 0,0 do maxChargeInkWh.

Rozsądne wartości: 43
currentFuelInLiters
 query

number

double

Określa bieżącą dostawę paliwa w litrach.

Rozsądne wartości: 55
decelerationEfficiency
 query

number

double

Określa wydajność konwersji energii kinetycznej w celu zaoszczędzenia (nieużywanego) paliwa, gdy pojazd zwalnia (tj. Chemical EnergySaved/Kinetic EnergyLost). Chemical EnergySaved uzyskuje się poprzez konwersję zapisanego (nieużytowanego) paliwa na energię przy użyciu paliwa EnergyDensityInMJoulesPerLiter.

Musi być sparowana z akceleratoremSprawność.

Dozwolony zakres wartości to od 0,0 do 1/accelerationEfficiency.

Rozsądne wartości: dla modelu spalania : 0,83, dla modelu elektrycznego : 0,91
departAt
 query

string

date-time

Data i godzina odejścia z punktu początkowego sformatowane jako dateTime wartość zdefiniowana w dokumencie RFC 3339 sekcja 5.6 z opcjonalnym przesunięciem strefy czasowej. Jeśli przesunięcie strefy czasowej nie zostanie określone, przyjmuje się, że jest to przesunięcie punktu początkowego.

  • Wartość domyślna: teraz
  • Inna wartość: dateTime

Przykłady:

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

Nie można użyć parametru departAt w połączeniu z arriveAt.
distanceBudgetInMeters
 query

number

double

Budżet odległości w metrach, który określa maksymalny zakres, który można przejechać przy użyciu odległości jazdy. Model zużycia będzie mieć wpływ tylko na zakres, gdy parametr routeType ma wartość eco.
Należy użyć dokładnie jednego budżetu (paliwaBudgetInLiters, energiiBudgetInkWh, timeBudgetInSec lub odległościBudgetInMeters).
downhillEfficiency
 query

number

double

Określa wydajność konwersji potencjalnej energii w celu zaoszczędzenia (nieużywanego) paliwa, gdy pojazd traci wysokość (tj. Chemical EnergySaved/Potential EnergyLost). Chemical EnergySaved uzyskuje się poprzez konwersję zapisanego (nieużytowanego) paliwa na energię przy użyciu paliwa EnergyDensityInMJoulesPerLiter.

Musi być sparowana z pod góręEfficiency.

Dozwolony zakres wartości to od 0,0 do 1/pod góręSprawność.

Rozsądne wartości: dla modelu spalania : 0,51, dla modelu elektrycznego : 0,73
energyBudgetInkWh
 query

number

double

Budżet energii elektrycznej w godzinach kilowatów (kWh), który określa maksymalny zakres, który można przejechać przy użyciu określonego modelu zużycia energii elektrycznej.
W przypadku użycia energiiBudgetInkWh należy określić szczegółowy model zużycia energii elektrycznej.
Należy użyć dokładnie jednego budżetu (paliwaBudgetInLiters, energiiBudgetInkWh, timeBudgetInSec lub odległościBudgetInMeters).
fuelBudgetInLiters
 query

number

double

Budżet paliwa w litrach, który określa maksymalny zakres, który można przejechać przy użyciu określonego modelu zużycia spalania.
W przypadku użycia paliwaBudgetInLiters należy określić szczegółowy model zużycia spalania.
Należy użyć dokładnie jednego budżetu (paliwaBudgetInLiters, energiiBudgetInkWh, timeBudgetInSec lub odległościBudgetInMeters).
fuelEnergyDensityInMJoulesPerLiter
 query

number

double

Określa ilość energii chemicznej przechowywanej w jednym litrze paliwa w megadżuli (MJ). Jest on używany w połączeniu z *Parametry wydajności do konwersji między zaoszczędzonej lub zużytej energii i paliwa. Na przykład gęstość energetyczna wynosi 34,2 MJ/l dla benzyny i 35,8 MJ/l dla paliwa wysokoprężnego.

Ten parametr jest wymagany, jeśli jest ustawiony dowolny parametr *Wydajność .

Rozsądne wartości: 34,2
hilliness
 query

InclineLevel

Stopień hilliness do porywającej trasy. Tego parametru można używać tylko w połączeniu z routeType=thrilling.
maxChargeInkWh
 query

number

double

Określa maksymalną energię elektryczną w godzinach kilowatów (kWh), które mogą być przechowywane w baterii pojazdu.

Ten parametr współistnieje z bieżącym parametremChargeInkWh .

Wartość minimalna musi być większa lub równa currentChargeInkWh.

Rozsądne wartości: 85
routeType
 query

RouteType

Żądany typ trasy.
timeBudgetInSec
 query

number

double

Budżet czasu w sekundach, który określa maksymalny zakres, który można przejechać przy użyciu czasu jazdy. Model zużycia będzie mieć wpływ tylko na zakres, gdy parametr routeType ma wartość eco.
Należy użyć dokładnie jednego budżetu (paliwaBudgetInLiters, energiiBudgetInkWh, timeBudgetInSec lub odległościBudgetInMeters).
traffic
 query

boolean

Możliwe wartości:

  • true — należy wziąć pod uwagę wszystkie dostępne informacje o ruchu podczas routingu
  • false — ignoruj bieżące dane ruchu podczas routingu. Należy pamiętać, że mimo że bieżące dane ruchu są ignorowane podczas routingu, wpływ historycznego ruchu na efektywne prędkości drogowe jest nadal uwzględniany.
travelMode
 query

TravelMode

Tryb podróży dla żądanej trasy. Jeśli nie zostanie zdefiniowana, wartość domyślna to "samochód". Należy pamiętać, że żądany tryb travelMode może nie być dostępny dla całej trasy. Jeśli żądany tryb travelMode nie jest dostępny dla określonej sekcji, element travelMode odpowiedzi dla tej sekcji będzie "inny". Należy pamiętać, że tryby podróży autobusem, motocyklem, taksówką i furgonetki są funkcją BETA. Pełne dane ograniczeń nie są dostępne we wszystkich obszarach.
uphillEfficiency
 query

number

double

Określa wydajność konwersji energii chemicznej przechowywanej w paliwie na potencjalną energię, gdy pojazd zyskuje wysokość (tj. Potential EnergyGained/Chemical EnergyConsumed). Chemical EnergyConsumed uzyskuje się poprzez przekonwertowanie zużytego paliwa na energię chemiczną przy użyciu paliwa EnergyDensityInMJoulesPerLiter.

Musi być sparowana z dółSprawność.

Dozwolony zakres wartości to od 0,0 do 1/downhillEfficiency.

Rozsądne wartości: dla modelu spalania : 0,27, dla modelu elektrycznego : 0,74
vehicleAxleWeight
 query

integer

Waga na oś pojazdu w kg. Wartość 0 oznacza, że ograniczenia wagi na oś nie są brane pod uwagę.
vehicleCommercial
 query

boolean

Czy pojazd jest używany do celów komercyjnych. Pojazdy komercyjne mogą nie być dozwolone do jazdy na niektórych drogach.
vehicleEngineType
 query

VehicleEngineType

Typ silnika pojazdu. Po określeniu szczegółowego modelu zużycia musi być zgodny z wartością vehicleEngineType.
vehicleHeight
 query

number

double

Wysokość pojazdu w metrach. Wartość 0 oznacza, że ograniczenia wysokości nie są brane pod uwagę.
vehicleLength
 query

number

double

Długość pojazdu w metrach. Wartość 0 oznacza, że ograniczenia długości nie są brane pod uwagę.
vehicleLoadType
 query

VehicleLoadType

Rodzaje ładunków, które mogą być klasyfikowane jako materiały niebezpieczne i ograniczone do niektórych dróg. Dostępne wartości vehicleLoadType to klasy us Hazmat od 1 do 9 oraz klasyfikacje ogólne do użycia w innych krajach/regionach. Wartości rozpoczynające się od usHazmat są przeznaczone dla routingu usa, podczas gdy innehazmat powinny być używane dla wszystkich innych krajów/regionów. vehicleLoadType można określić wiele razy. Ten parametr jest obecnie uwzględniany tylko dla parametru travelMode=truck.
vehicleMaxSpeed
 query

integer

Maksymalna prędkość pojazdu w km/godzinę. Maksymalna prędkość w profilu pojazdu służy do sprawdzania, czy pojazd jest dozwolony na autostradach.

  • Wartość 0 oznacza, że odpowiednia wartość dla pojazdu zostanie określona i zastosowana podczas planowania trasy.

  • Podczas planowania trasy może zostać zastąpiona wartość inna niż zero. Na przykład bieżący przepływ ruchu wynosi 60 km/godzinę. Jeśli maksymalna prędkość pojazdu wynosi 50 km/godzinę, silnik routingu rozważy 60 km/godzinę, ponieważ jest to obecna sytuacja. Jeśli maksymalna prędkość pojazdu wynosi 80 km/godzinę, ale obecny przepływ ruchu wynosi 60 km/godzinę, silnik routingu ponownie użyje 60 km/godzinę.
vehicleWeight
 query

integer

Waga pojazdu w kilogramach.

  • Jest to obowiązkowe, jeśli którykolwiek z parametrów *Wydajność jest ustawiony.

  • Musi być ona ściśle pozytywna, gdy jest używana w kontekście modelu zużycia. Rozważane są ograniczenia wagi.

  • Jeśli nie określono szczegółowego modelu zużycia , a wartość pojazdu Waga jest niezerowa, należy rozważyć ograniczenia wagi.

  • We wszystkich innych przypadkach ten parametr jest ignorowany.

Rozsądne wartości: dla modelu spalania : 1600, dla modelu elektrycznego : 1900
vehicleWidth
 query

number

double

Szerokość pojazdu w metrach. Wartość 0 oznacza, że ograniczenia szerokości nie są brane pod uwagę.
windingness
 query

WindingnessLevel

Poziom zakrętów dla porywającej trasy. Tego parametru można używać tylko w połączeniu z routeType=thrilling.

Nagłówek żądania

Nazwa Wymagane Typ Opis
x-ms-client-id

string

Określa, które konto jest przeznaczone do użycia w połączeniu z modelem zabezpieczeń Tożsamość Microsoft Entra. Reprezentuje unikatowy identyfikator konta Azure Maps i można go pobrać z interfejsu API konta płaszczyzny zarządzania Azure Maps. Aby użyć zabezpieczeń Tożsamość Microsoft Entra w usłudze Azure Maps, zobacz następujące artykuły, aby uzyskać wskazówki.

Odpowiedzi

Nazwa Typ Opis
200 OK

RouteRangeResult

OK
Other Status Codes

ErrorResponse

Wystąpił nieoczekiwany błąd.

Zabezpieczenia

AADToken

Są to przepływy Microsoft Entra OAuth 2.0. Po połączeniu z kontrolą dostępu opartą na rolach platformy Azure może służyć do kontrolowania dostępu do interfejsów API REST Azure Maps. Mechanizmy kontroli dostępu opartej na rolach platformy Azure służą do wyznaczania dostępu do co najmniej jednego Azure Maps konta zasobu lub zasobów podrzędnych. Każdy użytkownik, grupa lub jednostka usługi może mieć dostęp za pośrednictwem wbudowanej roli lub roli niestandardowej składającej się z co najmniej jednego uprawnienia do Azure Maps interfejsów API REST.

Aby zaimplementować scenariusze, zalecamy wyświetlenie pojęć związanych z uwierzytelnianiem. Podsumowując, ta definicja zabezpieczeń stanowi rozwiązanie do modelowania aplikacji za pośrednictwem obiektów, które mogą kontrolować dostęp do określonych interfejsów API i zakresów.

Uwagi

  • Ta definicja zabezpieczeń wymaga użycia nagłówka x-ms-client-id w celu wskazania, do którego zasobu Azure Maps aplikacja żąda dostępu. Można to uzyskać z poziomu interfejsu API zarządzania usługami Maps.

Element Authorization URL jest specyficzny dla wystąpienia chmury publicznej platformy Azure. Suwerenne chmury mają unikatowe adresy URL autoryzacji i konfiguracje Tożsamość Microsoft Entra. * Kontrola dostępu oparta na rolach platformy Azure jest konfigurowana z poziomu płaszczyzny zarządzania platformy Azure za pośrednictwem Azure Portal, programu PowerShell, interfejsu wiersza polecenia, zestawów AZURE SDK lub interfejsów API REST. * Użycie zestawu AZURE MAPS Web SDK umożliwia skonfigurowanie aplikacji na podstawie konfiguracji dla wielu przypadków użycia.

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

Scopes

Nazwa Opis
https://atlas.microsoft.com/.default https://atlas.microsoft.com/.default

subscription-key

Jest to klucz współużytkowany podczas Twórca konta Azure Maps w Azure Portal lub przy użyciu programu PowerShell, interfejsu wiersza polecenia, zestawów SDK platformy Azure lub interfejsu API REST.

Za pomocą tego klucza każda aplikacja może uzyskiwać dostęp do wszystkich interfejsów API REST. Innymi słowy, ten klucz może służyć jako klucz główny na koncie, w którym są wystawiane.

W przypadku publicznie uwidocznionych aplikacji zalecamy użycie podejścia do poufnych aplikacji klienckich w celu uzyskania dostępu Azure Maps interfejsów API REST, aby klucz mógł być bezpiecznie przechowywany.

Type: apiKey
In: query

SAS Token

Jest to token sygnatury dostępu współdzielonego tworzony na podstawie operacji list sygnatur dostępu współdzielonego na zasobie Azure Maps za pośrednictwem płaszczyzny zarządzania platformy Azure za pośrednictwem Azure Portal, programu PowerShell, interfejsu wiersza polecenia, zestawów AZURE SDK lub interfejsów API REST.

Dzięki temu tokenowi każda aplikacja jest autoryzowana do uzyskiwania dostępu za pomocą kontroli dostępu opartej na rolach platformy Azure oraz szczegółowej kontroli wygaśnięcia, szybkości i regionów użycia dla określonego tokenu. Innymi słowy, token SAS może służyć do umożliwienia aplikacjom kontrolowania dostępu w sposób bardziej bezpieczny niż klucz wspólny.

W przypadku publicznie uwidocznionych aplikacji zalecamy skonfigurowanie określonej listy dozwolonych źródeł w zasobie konta mapy w celu ograniczenia nadużyć renderowania i regularnego odnawiania tokenu SAS.

Type: apiKey
In: header

Przykłady

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

Sample Request

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

Sample Response

Status code:
200 
{
  "formatVersion": "0.0.1",
  "reachableRange": {
    "center": {
      "latitude": 50.9745,
      "longitude": 5.86605
    },
    "boundary": [
      {
        "latitude": 52.03704,
        "longitude": 5.73602
      },
      {
        "latitude": 52.09456,
        "longitude": 5.59435
      },
      {
        "latitude": 52.16815,
        "longitude": 5.42279
      },
      {
        "latitude": 52.25047,
        "longitude": 5.21276
      },
      {
        "latitude": 52.21374,
        "longitude": 5.15355
      },
      {
        "latitude": 52.25674,
        "longitude": 4.96687
      },
      {
        "latitude": 52.07834,
        "longitude": 4.739
      },
      {
        "latitude": 52.05647,
        "longitude": 4.72513
      },
      {
        "latitude": 51.94553,
        "longitude": 4.53237
      },
      {
        "latitude": 51.70119,
        "longitude": 4.31165
      },
      {
        "latitude": 51.5837,
        "longitude": 4.28917
      },
      {
        "latitude": 51.48463,
        "longitude": 3.82685
      },
      {
        "latitude": 51.21096,
        "longitude": 3.62838
      },
      {
        "latitude": 50.6814,
        "longitude": 3.89244
      },
      {
        "latitude": 50.66791,
        "longitude": 3.93493
      },
      {
        "latitude": 50.49042,
        "longitude": 3.98156
      },
      {
        "latitude": 50.30944,
        "longitude": 4.47995
      },
      {
        "latitude": 50.24448,
        "longitude": 4.60502
      },
      {
        "latitude": 50.24467,
        "longitude": 4.89999
      },
      {
        "latitude": 50.08735,
        "longitude": 5.04206
      },
      {
        "latitude": 49.99214,
        "longitude": 5.23042
      },
      {
        "latitude": 49.88478,
        "longitude": 5.40994
      },
      {
        "latitude": 49.85797,
        "longitude": 5.46178
      },
      {
        "latitude": 49.86279,
        "longitude": 5.7196
      },
      {
        "latitude": 49.83259,
        "longitude": 5.74151
      },
      {
        "latitude": 50.22239,
        "longitude": 5.9387
      },
      {
        "latitude": 50.0011,
        "longitude": 6.08535
      },
      {
        "latitude": 50.04616,
        "longitude": 6.12089
      },
      {
        "latitude": 50.09472,
        "longitude": 6.28373
      },
      {
        "latitude": 49.95863,
        "longitude": 6.51654
      },
      {
        "latitude": 50.00485,
        "longitude": 6.61034
      },
      {
        "latitude": 50.00587,
        "longitude": 6.70295
      },
      {
        "latitude": 50.2947,
        "longitude": 6.65865
      },
      {
        "latitude": 50.36903,
        "longitude": 6.79276
      },
      {
        "latitude": 50.31614,
        "longitude": 7.32163
      },
      {
        "latitude": 50.36737,
        "longitude": 7.58782
      },
      {
        "latitude": 50.46919,
        "longitude": 7.7626
      },
      {
        "latitude": 50.96246,
        "longitude": 7.9826
      },
      {
        "latitude": 51.07086,
        "longitude": 7.55924
      },
      {
        "latitude": 51.36614,
        "longitude": 7.58138
      },
      {
        "latitude": 51.52015,
        "longitude": 7.67861
      },
      {
        "latitude": 51.65781,
        "longitude": 7.35175
      },
      {
        "latitude": 51.81916,
        "longitude": 7.21664
      },
      {
        "latitude": 51.9587,
        "longitude": 7.0467
      },
      {
        "latitude": 51.82713,
        "longitude": 6.67267
      },
      {
        "latitude": 51.81133,
        "longitude": 6.48424
      },
      {
        "latitude": 51.9368,
        "longitude": 6.27316
      },
      {
        "latitude": 52.01701,
        "longitude": 6.14452
      },
      {
        "latitude": 52.20847,
        "longitude": 6.09312
      },
      {
        "latitude": 52.23705,
        "longitude": 6.01297
      }
    ]
  }
}

Definicje

Nazwa Opis
EffectiveSetting

Efektywny parametr lub dane używane podczas wywoływania tego interfejsu API trasy.
ErrorAdditionalInfo

Dodatkowe informacje o błędzie zarządzania zasobami.
ErrorDetail

Szczegóły błędu.
ErrorResponse

Odpowiedź na błąd
InclineLevel

Stopień hilliness do porywającej trasy. Tego parametru można używać tylko w połączeniu z routeType=thrilling.
LatLongPair

Lokalizacja reprezentowana jako szerokość geograficzna i długość geograficzna.
ResponseFormat

Żądany format odpowiedzi. Wartość może być json lub xml.
RouteAvoidType

Określa element, którego obliczenie trasy powinno próbować uniknąć podczas określania trasy. Można określić wiele razy w jednym żądaniu, na przykład "&avoid=highways&avoid=tollRoads&avoid=promy". W żądaniach zakresu tras wartość jużUsedRoads nie może być używana.
RouteRange

Osiągalny zakres
RouteRangeResult

Ten obiekt jest zwracany z pomyślnego wywołania zakresu osiągalnego trasy
RouteReport

Raportuje obowiązujące ustawienia używane w bieżącym wywołaniu.
RouteType

Żądany typ trasy.
TravelMode

Tryb podróży dla żądanej trasy. Jeśli nie zostanie zdefiniowana, wartość domyślna to "samochód". Należy pamiętać, że żądany tryb travelMode może nie być dostępny dla całej trasy. Jeśli żądany tryb travelMode nie jest dostępny dla określonej sekcji, element travelMode odpowiedzi dla tej sekcji będzie "inny". Należy pamiętać, że tryby podróży autobusem, motocyklem, taksówką i furgonetki są funkcją BETA. Pełne dane ograniczeń nie są dostępne we wszystkich obszarach.
VehicleEngineType

Typ silnika pojazdu. Po określeniu szczegółowego modelu zużycia musi być zgodny z wartością vehicleEngineType.
VehicleLoadType

Rodzaje ładunków, które mogą być klasyfikowane jako materiały niebezpieczne i ograniczone do niektórych dróg. Dostępne wartości vehicleLoadType to klasy us Hazmat od 1 do 9 oraz klasyfikacje ogólne do użycia w innych krajach/regionach. Wartości rozpoczynające się od usHazmat są przeznaczone dla routingu usa, podczas gdy innehazmat powinny być używane dla wszystkich innych krajów/regionów. vehicleLoadType można określić wiele razy. Ten parametr jest obecnie uwzględniany tylko dla parametru travelMode=truck.
WindingnessLevel

Poziom zakrętów dla porywającej trasy. Tego parametru można używać tylko w połączeniu z routeType=thrilling.

EffectiveSetting

Efektywny parametr lub dane używane podczas wywoływania tego interfejsu API trasy.

Nazwa Typ Opis
key

string

Nazwa użytego parametru.
value

string

Wartość użytego parametru.

ErrorAdditionalInfo

Dodatkowe informacje o błędzie zarządzania zasobami.

Nazwa Typ Opis
info

object

Dodatkowe informacje.
type

string

Dodatkowy typ informacji.

ErrorDetail

Szczegóły błędu.

Nazwa Typ Opis
additionalInfo

ErrorAdditionalInfo[]

Dodatkowe informacje o błędzie.
code

string

Kod błędu.
details

ErrorDetail[]

Szczegóły błędu.
message

string

Komunikat o błędzie.
target

string

Element docelowy błędu.

ErrorResponse

Odpowiedź na błąd

Nazwa Typ Opis
error

ErrorDetail

Obiekt error.

InclineLevel

Stopień hilliness do porywającej trasy. Tego parametru można używać tylko w połączeniu z routeType=thrilling.

Nazwa Typ Opis
high

string

wysoka
low

string

Niskie
normal

string

Normalne

LatLongPair

Lokalizacja reprezentowana jako szerokość geograficzna i długość geograficzna.

Nazwa Typ Opis
latitude

number

Właściwość Szerokość geograficzna
longitude

number

Właściwość Długość geograficzna

ResponseFormat

Żądany format odpowiedzi. Wartość może być json lub xml.

Nazwa Typ Opis
json

string

Format wymiany danych notacji obiektów JavaScript
xml

string

The Extensible Markup Language

RouteAvoidType

Określa element, którego obliczenie trasy powinno próbować uniknąć podczas określania trasy. Można określić wiele razy w jednym żądaniu, na przykład "&avoid=highways&avoid=tollRoads&avoid=promy". W żądaniach zakresu tras wartość jużUsedRoads nie może być używana.

Nazwa Typ Opis
alreadyUsedRoads

string

Pozwala uniknąć wielokrotnego korzystania z tej samej drogi. Najbardziej przydatne w połączeniu z routeType=thrilling.
borderCrossings

string

Pozwala uniknąć przekraczania granic w obliczeniach tras.
carpools

string

Unika tras, które wymagają korzystania z carpool (HOV/High Occupancy Vehicle) pasów ruchu.
ferries

string

Unika promów
motorways

string

Unika autostrad
tollRoads

string

Unika dróg płatnych.
unpavedRoads

string

Unika niepavowanych dróg

RouteRange

Osiągalny zakres

Nazwa Typ Opis
boundary

LatLongPair[]

Wielokątny granica osiągalnego zakresu reprezentowanego jako lista punktów.
center

LatLongPair

Punkt środkowy osiągalnego zakresu

RouteRangeResult

Ten obiekt jest zwracany z pomyślnego wywołania zakresu osiągalnego trasy

Nazwa Typ Opis
formatVersion

string

Właściwość Formatuj wersję
reachableRange

RouteRange

Osiągalny zakres
report

RouteReport

Raportuje obowiązujące ustawienia używane w bieżącym wywołaniu.

RouteReport

Raportuje obowiązujące ustawienia używane w bieżącym wywołaniu.

Nazwa Typ Opis
effectiveSettings

EffectiveSetting[]

Skuteczne parametry lub dane używane podczas wywoływania tego interfejsu API trasy.

RouteType

Żądany typ trasy.

Nazwa Typ Opis
eco

string

Trasa zrównoważona przez gospodarkę i szybkość.
fastest

string

Najszybsza trasa.
shortest

string

Najkrótsza trasa według odległości.
thrilling

string

Obejmuje interesujące lub trudne drogi i korzysta z jak najmniejszej liczby autostrad. Można wybrać poziom zakrętów uwzględnionych, a także stopień pagórkowatości. Zobacz parametry hilliness i uzwojenia, aby dowiedzieć się, jak to ustawić. Istnieje limit 900 km na trasach zaplanowanych z routeType= porywający

TravelMode

Tryb podróży dla żądanej trasy. Jeśli nie zostanie zdefiniowana, wartość domyślna to "samochód". Należy pamiętać, że żądany tryb travelMode może nie być dostępny dla całej trasy. Jeśli żądany tryb travelMode nie jest dostępny dla określonej sekcji, element travelMode odpowiedzi dla tej sekcji będzie "inny". Należy pamiętać, że tryby podróży autobusem, motocyklem, taksówką i furgonetki są funkcją BETA. Pełne dane ograniczeń nie są dostępne we wszystkich obszarach.

Nazwa Typ Opis
bus

string

Zwrócone trasy są zoptymalizowane pod kątem autobusów, w tym korzystanie tylko z pasów ruchu autobusowego. Funkcjonalność beta.
car

string

Zwrócone trasy są zoptymalizowane pod kątem samochodów.
motorcycle

string

Zwrócone trasy są zoptymalizowane pod kątem motocykli. Funkcjonalność beta.
taxi

string

Zwrócone trasy są zoptymalizowane pod kątem taksówek. Funkcjonalność beta.
truck

string

Zwrócone trasy są zoptymalizowane pod kątem pojazdów komercyjnych, takich jak dla ciężarówek.
van

string

Zwrócone trasy są zoptymalizowane pod kątem samochodów dostawczych. Funkcjonalność beta.

VehicleEngineType

Typ silnika pojazdu. Po określeniu szczegółowego modelu zużycia musi być zgodny z wartością vehicleEngineType.

Nazwa Typ Opis
combustion

string

Silnik spalania wewnętrznego.
electric

string

Silnik elektryczny.

VehicleLoadType

Rodzaje ładunków, które mogą być klasyfikowane jako materiały niebezpieczne i ograniczone do niektórych dróg. Dostępne wartości vehicleLoadType to klasy us Hazmat od 1 do 9 oraz klasyfikacje ogólne do użycia w innych krajach/regionach. Wartości rozpoczynające się od usHazmat są przeznaczone dla routingu usa, podczas gdy innehazmat powinny być używane dla wszystkich innych krajów/regionów. vehicleLoadType można określić wiele razy. Ten parametr jest obecnie uwzględniany tylko dla parametru travelMode=truck.

Nazwa Typ Opis
USHazmatClass1

string

Materiały wybuchowe
USHazmatClass2

string

Gaz skompresowany
USHazmatClass3

string

Łatwopalne płyny
USHazmatClass4

string

Łatwopalne stałe
USHazmatClass5

string

Utleniacze
USHazmatClass6

string

Trucizny
USHazmatClass7

string

Materiały radioaktywne
USHazmatClass8

string

Substancje żrące
USHazmatClass9

string

Różne
otherHazmatExplosive

string

Materiały wybuchowe
otherHazmatGeneral

string

Różne
otherHazmatHarmfulToWater

string

Szkodliwe dla wody

WindingnessLevel

Poziom zakrętów dla porywającej trasy. Tego parametru można używać tylko w połączeniu z routeType=thrilling.

Nazwa Typ Opis
high

string

wysoka
low

string

Niskie
normal

string

Normalne