Udostępnij za pośrednictwem

Route - Get Route Range

  • Odwołanie
Usługa:
Maps
Wersja interfejsu API:
1.0

Użyj polecenia , aby utworzyć mapę, która przedstawia obszar dostępny z danego punktu w ramach określonego progu na podstawie czasu, odległości lub pojemności paliwa.

Interfejs Get Route Range API (Isochrone) to żądanie HTTP GET , 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, 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 Wyszukiwanie 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}
Z parametrami opcjonalnymi: 
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 usługi 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 coś, czego należy unikać podczas określania trasy. Można określić wiele razy w jednym żądaniu, na przykład "&avoid=autostrady&avoid=tollRoads&unikaj =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 wartość zdefiniowana dateTime w dokumencie RFC 3339, sekcja 5.6 z opcjonalnym przesunięciem strefy czasowej. Jeśli nie określono przesunięcia strefy czasowej, zakłada się, że jest to punkt początkowy.

  • 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 parametrem 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 routeType jest eko.
Należy użyć dokładnie jednego budżetu (paliwaBudgetInLiters, energyBudgetInkWh, timeBudgetInSec lub odległośćBudgetInMeters).
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 kilowatowych godzinach (kWh), który określa maksymalny zakres, który można stosować przy użyciu określonego modelu zużycia energii elektrycznej.
Gdy jest używana energiaBudgetInkWh, należy określić szczegółowy model zużycia energii elektrycznej.
Należy użyć dokładnie jednego budżetu (paliwaBudgetInLiters, energyBudgetInkWh, timeBudgetInSec lub odległośćBudgetInMeters).
fuelBudgetInLiters
 query

number

double

Budżet paliwa w litrach, który określa maksymalny zakres, który można stosować 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, energyBudgetInkWh, timeBudgetInSec lub odległośćBudgetInMeters).
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ń wzgórza do porywającej trasy. Ten parametr może być używany 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 określający maksymalny zakres, który można stosować przy użyciu czasu jazdy. Model zużycia będzie mieć wpływ tylko na zakres, gdy routeType jest eko.
Należy użyć dokładnie jednego budżetu (paliwaBudgetInLiters, energyBudgetInkWh, timeBudgetInSec lub odległośćBudgetInMeters).
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 chociaż 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 zdefiniowano, 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 element 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 autobus, motocykl, taksówka i van 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

Typy ładunków, które mogą być klasyfikowane jako materiały niebezpieczne i ograniczone z 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 uznawany tylko za 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.

  • Wartość niezerowa może zostać zastąpiona podczas planowania trasy. Na przykład bieżący przepływ ruchu wynosi 60 km/godzinę. Jeśli maksymalna prędkość pojazdu jest ustawiona na 50 km/godzinę, silnik routingu rozważy 60 km/godzinę, ponieważ jest to bieżąca sytuacja. Jeśli maksymalna prędkość pojazdu zostanie podana jako 80 km/godzinę, ale bieżący 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ć ściśle dodatnia, gdy jest używana w kontekście modelu zużycia. Ograniczenia wagi są brane pod uwagę.

  • Jeśli nie określono żadnego szczegółowego modelu zużycia , a wartość pojazduWeight nie jest zerowa, 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 zwrotów dla porywającej trasy. Ten parametr może być używany 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ń Microsoft Entra ID. Reprezentuje unikatowy identyfikator konta usługi Azure Maps i można go pobrać z interfejsu API konta płaszczyzny zarządzania usługi Azure Maps. Aby użyć zabezpieczeń microsoft Entra ID 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 protokołu Microsoft Entra OAuth 2.0 . W 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 usługi Azure Maps. Mechanizmy kontroli dostępu oparte na rolach platformy Azure służą do wyznaczania dostępu do co najmniej jednego konta zasobów usługi Azure Maps 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 interfejsów API REST usługi Azure Maps.

Aby zaimplementować scenariusze, zalecamy wyświetlenie pojęć dotyczących uwierzytelniania. Podsumowując, ta definicja zabezpieczeń udostępnia 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 , aby wskazać, do którego zasobu usługi Azure Maps aplikacja żąda dostępu. Można to uzyskać za pomocą interfejsu API zarządzania mapami.

Element Authorization URL jest specyficzny dla wystąpienia chmury publicznej platformy Azure. Suwerenne chmury mają unikatowe adresy URL autoryzacji i konfiguracje identyfikatorów entra firmy Microsoft. * Kontrola dostępu oparta na rolach platformy Azure jest konfigurowana z płaszczyzny zarządzania platformy Azure za pośrednictwem witryny Azure Portal, programu PowerShell, interfejsu wiersza polecenia, zestawów AZURE SDK lub interfejsów API REST. * Użycie zestawu Sdk sieci Web usługi Azure Maps umożliwia konfigurację opartą na konfiguracji aplikacji w wielu przypadkach użycia.

Typ: oauth2
Flow: implicit
Adres URL autoryzacji: https://login.microsoftonline.com/common/oauth2/authorize

Zakresy

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

subscription-key

Jest to klucz wspólny aprowizowany podczas tworzenia konta usługi Azure Maps w witrynie Azure Portal lub przy użyciu programu PowerShell, interfejsu wiersza polecenia, zestawów SDK platformy Azure lub interfejsu API REST.

Przy użyciu tego klucza każda aplikacja może uzyskać dostęp do całego interfejsu API REST. Innymi słowy, ten klucz może być używany 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 do interfejsów API REST usługi Azure Maps, aby można było bezpiecznie przechowywać klucz.

Typ: apiKey
W: query

SAS Token

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

Przy użyciu tego tokenu każda aplikacja jest autoryzowana do uzyskiwania dostępu za pomocą kontroli dostępu opartej na rolach platformy Azure i szczegółowej kontroli wygaśnięcia, szybkości i regionów użycia dla określonego tokenu. Innymi słowy, token sygnatury dostępu współdzielonego może służyć do umożliwienia aplikacjom kontrolowania dostępu w bardziej bezpieczny sposób 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 SYGNATURy dostępu współdzielonego.

Typ: apiKey
W: header

Przykłady

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

Przykładowe żądanie

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

Przykładowa odpowiedź

Kod stanu:
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

Skuteczny 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ń wzgórza do porywającej trasy. Ten parametr może być używany 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 coś, czego należy unikać podczas określania trasy. Można określić wiele razy w jednym żądaniu, na przykład "&avoid=autostrady&avoid=tollRoads&unikaj =promy". W żądaniach zakresu tras wartość jużUsedRoads nie może być używana.
RouteRange

Dostępny zakres
RouteRangeResult

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

Zgłasza 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 zdefiniowano, 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 element 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 autobus, motocykl, taksówka i van 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

Typy ładunków, które mogą być klasyfikowane jako materiały niebezpieczne i ograniczone z 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 uznawany tylko za travelMode=truck.
WindingnessLevel

Poziom zwrotów dla porywającej trasy. Ten parametr może być używany tylko w połączeniu z routeType=thrilling.

EffectiveSetting

Skuteczny 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 błędu.

InclineLevel

Stopień wzgórza do porywającej trasy. Ten parametr może być używany tylko w połączeniu z routeType=thrilling.

Nazwa Typ Opis
high

string

wysoka
low

string

niski
normal

string

normalny

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

Rozszerzalny język znaczników

RouteAvoidType

Określa coś, czego należy unikać podczas określania trasy. Można określić wiele razy w jednym żądaniu, na przykład "&avoid=autostrady&avoid=tollRoads&unikaj =promy". W żądaniach zakresu tras wartość jużUsedRoads nie może być używana.

Nazwa Typ Opis
alreadyUsedRoads

string

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

string

Unika przekraczania granic w obliczeniach tras.
carpools

string

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

string

Unika promów
motorways

string

Unikaj autostrad
tollRoads

string

Unika dróg żniwnych.
unpavedRoads

string

Unika niepavowanych dróg

RouteRange

Dostępny zakres

Nazwa Typ Opis
boundary

LatLongPair[]

Granica wielokątna osiągalnego zakresu reprezentowanego jako lista punktów.
center

LatLongPair

Punkt środkowy dostępnego zakresu

RouteRangeResult

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

Nazwa Typ Opis
formatVersion

string

Formatowanie właściwości Version
reachableRange

RouteRange

Dostępny zakres
report

RouteReport

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

RouteReport

Zgłasza 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 wykorzystuje jak najwięcej autostrad. Można wybrać poziom uwzględnionych zakrętów, a także stopień wzgórza. Zobacz parametry hilliness i uzwojenia, aby dowiedzieć się, jak to ustawić. Istnieje limit 900 km na trasach planowanych z routeType=porywający

TravelMode

Tryb podróży dla żądanej trasy. Jeśli nie zdefiniowano, 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 element 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 autobus, motocykl, taksówka i van 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 użycia tylko pasów autobusowych. 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 ciężarówki.
van

string

Zwrócone trasy są zoptymalizowane pod kątem furgonetek. 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

Typy ładunków, które mogą być klasyfikowane jako materiały niebezpieczne i ograniczone z 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 uznawany tylko za 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 zwrotów dla porywającej trasy. Ten parametr może być używany tylko w połączeniu z routeType=thrilling.

Nazwa Typ Opis
high

string

wysoka
low

string

niski
normal

string

normalny