Route - Get Route Range

  • Odwołanie
Service:
Maps
API Version:
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 Search Inside Geometry, 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 efektywność konwersji energii chemicznej przechowywanej w paliwie na energię kinetyczną, gdy pojazd przyspiesza (tj. KineticPrzekażed/ChemicalCareConsumed). Substancja ChemicznaWykonsumowana jest uzyskiwana przez konwersję zużytego paliwa na energię chemiczną przy użyciu paliwaPrzeciągnięciaInMJoulesPerLiter.

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ść energii zużywanej do utrzymania systemów pomocniczych w kilowatach (kW).

Może służyć do określania zużycia ze względu na urządzenia i systemy, takie jak systemy AC, radio, ogrzewanie itp.

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

number

double

Określa ilość paliwa zużywanego dla systemów pomocniczych pojazdu, w litrach na godzinę.

Może służyć do określania zużycia ze względu na urządzenia i systemy, takie 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 zużycia zależny od szybkości.

Podana jako nieurządkowana lista par szybkości/szybkości użycia. Lista definiuje punkty na krzywej zużycia. Stawki zużycia dla prędkości, które nie znajdują się na liście, znajdują się w następujący sposób:

  • przez interpolację liniową, jeśli dana szybkość 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 pojedynczy 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 niż lub równe z wyjątkiem największej prędkości. Gwarantuje to, że ekstrapolacja nie prowadzi do negatywnych wskaźników zużycia.

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

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

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

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

string

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

Podana jako nieuorderowana lista dwukropków rozdzielonych prędkością & par z szybkością zużycia. Lista definiuje punkty na krzywej zużycia. Stawki zużycia dla prędkości, które nie znajdują się na liście, znajdują się w następujący sposób:

  • przez interpolację liniową, jeśli dana szybkość 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 pojedynczy 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 niż lub równe z wyjątkiem największej prędkości. Gwarantuje to, że ekstrapolacja nie prowadzi do negatywnych wskaźników zużycia.

Podobnie wartości zużycia określone dla dwóch najmniejszych prędkości na liście nie mogą prowadzić do negatywnego wskaźnika zużycia dla 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żące zasilanie energii elektrycznej w godzinach kilowatów (kWh).

Ten parametr współistnieje z parametrem maxChargeInkWh .

Dozwolony zakres wartości to 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 na zaoszczędzone (nieużywane) paliwo, gdy pojazd zwalnia (tj. Chemical ChemicalsSaved/KineticCareLost). Substancja ChemicznaSaved jest uzyskiwana przez konwersję zaoszczędzonego (nieużytowanego) paliwa na energię przy użyciu paliwaSerweryInMJoulesPerLiter.

Musi być sparowana z przyspieszeniemSprawność.

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

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 do zaoszczędzonego (nieużytowanego) paliwa, gdy pojazd traci wysokość (tj. Chemical AnabolicSaved/PotentialCareLost). Substancja ChemicznaSaved jest uzyskiwana przez konwersję zaoszczędzonego (nieużytowanego) paliwa na energię przy użyciu paliwaSerweryInMJoulesPerLiter.

Musi być sparowana z pod góręSprawność.

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 megajoulach (MJ). Jest on używany w połączeniu z *Parametrami wydajności konwersji między zapisaną lub zużywaną energią a paliwem. Na przykład gęstość energii wynosi 34,2 MJ/l dla benzyny, a 35,8 MJ/l dla paliwa wysokoprężnego.

Ten parametr jest wymagany, jeśli ustawiono 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 maksymalne zasilanie energii elektrycznej 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 bieżącejChargeInkWh.

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 podniesienie (tj. Potential AnabolicGained/ChemicalScsiConsumed). Substancja ChemicznaWykonsumowana jest uzyskiwana przez konwersję zużytego paliwa na energię chemiczną przy użyciu paliwaPrzeciągnięciaInMJoulesPerLiter.

Musi być sparowana z wadą downhillEfficiency.

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ń 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 protokołu OAuth 2.0 Microsoft Entra. 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 Azure Maps. Mechanizmy kontroli dostępu opartej na rolach platformy Azure służą do wyznaczania dostępu do co najmniej jednego konta zasobów 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 Azure Maps interfejsów API REST.

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łówkax-ms-client-id, aby wskazać, do którego zasobu 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 Tożsamość Microsoft Entra. * Kontrola dostępu oparta na rolach platformy Azure jest konfigurowana z płaszczyzny zarządzania platformy Azure za pośrednictwem Azure Portal, programu PowerShell, interfejsu wiersza polecenia, zestawów SDK platformy Azure lub interfejsów API REST. * Użycie zestawu AZURE MAPS Web SDK umożliwia konfigurację opartą na konfiguracji aplikacji w wielu przypadkach 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ólny aprowizowany 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.

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 Azure Maps w celu bezpiecznego przechowywania klucza.

Type: apiKey
In: query

SAS Token

Jest to token sygnatury dostępu współdzielonego tworzony na podstawie operacji listy sygnatur dostępu współdzielonego w zasobie Azure Maps za pośrednictwem płaszczyzny zarządzania platformy Azure za pośrednictwem 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.

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