Weather - Get Weather Along Route

Odwołanie

Usługa:: Maps

Wersja interfejsu API:: 1.1

Użyj polecenia , aby uzyskać dokładną, maksymalnie minutową prognozę, która obejmuje oceny zagrożeń pogodowych i powiadomienia wzdłuż trasy.

Interfejs Get Weather Along Route API jest żądaniem HTTP GET , które zwraca hiperlokalnej (co najmniej jeden kilometr), aktualną prognozę pogody, oceny zagrożeń pogodowych i powiadomienia wzdłuż trasy opisanej jako sekwencja punktów drogi. Obejmuje to listę zagrożeń pogodowych wpływających na punkt drogi lub trasę, a zagregowany indeks zagrożeń dla każdego punktu drogi może służyć do malowania każdej części trasy zgodnie z tym, jak bezpieczne jest dla kierowcy. Podczas przesyłania punktów drogi zaleca się pozostawanie w obrębie lub w pobliżu odległości, którą można podróżować w ciągu 120 minut lub wkrótce po. Dane są aktualizowane co pięć minut.

Usługa uzupełnia usługę Azure Maps Route Service , która umożliwia najpierw zażądanie trasy między miejscem początkowym a miejscem docelowym i użyciem go jako danych wejściowych dla punktu końcowego Weather Along Route.

Ponadto usługa obsługuje scenariusze generowania powiadomień pogodowych dla punktów waypoint, które doświadczają wzrostu intensywności zagrożenia pogodowego. Jeśli na przykład oczekuje się, że pojazd zacznie doświadczać ulewnego deszczu, gdy osiągnie punkt drogi, zostanie wygenerowane powiadomienie o pogodzie dla ulewnego deszczu, aby produkt końcowy mógł wyświetlić powiadomienie o ulewnym deszczu, zanim kierowca osiągnie ten punkt. Wyzwalacz dla tego, kiedy wyświetlić powiadomienie dla punktu drogi, może być oparty na przykład na geofencence lub możliwej do wybrania odległości do punktu drogi.

Interfejs API obejmuje wszystkie regiony planety, z wyjątkiem szerokości geograficznych nad Grenlandią i Antarktydą.

GET https://atlas.microsoft.com/weather/route/json?api-version=1.1&query={query}

Z parametrami opcjonalnymi:

GET https://atlas.microsoft.com/weather/route/json?api-version=1.1&query={query}&language={language}

Parametry identyfikatora URI

Nazwa	W	Wymagane	Typ	Opis
format	path	True	JsonFormat	Żądany format odpowiedzi. Obsługiwany jest tylko `json` format.
api-version	query	True	string	Numer wersji interfejsu API usługi Azure Maps.
query	query	True	string	Współrzędne, przez które trasa jest obliczana, oddzielona dwukropkiem (:) i wprowadzana w kolejności chronologicznej. Wymagany jest co najmniej dwa punkty drogi. Pojedyncze wywołanie interfejsu API może zawierać maksymalnie 60 punktów drogi. Punkt drogi wskazuje lokalizację, wartość ETA i opcjonalny nagłówek: szerokość geograficzna,długość geograficzna,ETA,nagłówek, gdzie `Latitude` - Współrzędna szerokości geograficznej w stopniach dziesiętnych. `Longitude` - Współrzędna długości geograficznej w stopniach dziesiętnych. `ETA (estimated time of arrival)` - Liczba minut od chwili obecnej, która zajmie pojazdowi dotarcie do punktu drogi. Dozwolony zakres wynosi od 0,0 do 120,0 minut. `Heading` - Opcjonalna wartość wskazująca nagłówek pojazdu, gdy przechodzi punkt drogi. Wyrażona w stopniach zegara względem prawdziwej północy. Jest to wydawane w celu obliczenia blasku słońca jako zagrożenia jazdy. Dozwolony zakres wynosi od 0,0 do 360,0 stopni. Jeśli nie zostanie podana, nagłówek będzie automatycznie uzyskiwany na podstawie położenia sąsiednich punktów drogi. Zaleca się pozostawanie w odległości 120 minut lub krótko po niej. Dzięki temu można zapewnić dokładniejszą ocenę dla podróży i zapobiec przechwyceniu izolowanych zdarzeń między punktami drogi. Informacje mogą i powinny być aktualizowane wzdłuż trasy (zwłaszcza w przypadku podróży większych niż 2 godziny), aby stale ściągać nowe punkty drogi w przyszłości, ale także zapewnić, że informacje o prognozie zawartości, takie jak typ opadów i intensywność, są dokładne, gdy burze rozwijają się i rozpraszają w czasie.
language	query		string	Język, w którym powinny być zwracane wyniki wyszukiwania. Powinien być jednym z obsługiwanych tagów języka IETF, bez uwzględniania wielkości liter. Gdy dane w określonym języku nie są dostępne dla określonego pola, używany jest język domyślny. Aby uzyskać szczegółowe informacje, zobacz Obsługiwane języki .

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ń identyfikatora Entra firmy Microsoft w usłudze Azure Maps, zobacz następujące artykuły , aby uzyskać wskazówki.

Odpowiedzi

Nazwa	Typ	Opis
200 OK	WeatherAlongRouteResult	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.

Aby uzyskać więcej informacji na temat platformy tożsamości firmy Microsoft, zobacz Omówienie platformy tożsamości firmy Microsoft.

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 detailed weather casts along a route described as a sequence of waypoints

Przykładowe żądanie

HTTP

GET https://atlas.microsoft.com/weather/route/json?api-version=1.1&query=38.907,-77.037,0:38.907,-77.009,10:38.926,-76.928,20:39.033,-76.852,30:39.168,-76.732,40:39.269,-76.634,50:39.287,-76.612,60

Przykładowa odpowiedź

Kod stanu:: 200

{
  "summary": {
    "iconCode": 35,
    "hazards": {
      "maxHazardIndex": 0
    }
  },
  "waypoints": [
    {
      "iconCode": 38,
      "shortPhrase": "Mostly cloudy",
      "isDayTime": false,
      "cloudCover": 70,
      "temperature": {
        "value": 3.4,
        "unit": "C",
        "unitType": 17
      },
      "wind": {
        "direction": {
          "degrees": 142
        },
        "speed": {
          "value": 2,
          "unit": "km/h",
          "unitType": 7
        }
      },
      "windGust": {
        "speed": {
          "value": 3,
          "unit": "km/h",
          "unitType": 7
        }
      },
      "precipitation": {
        "dbz": 0,
        "type": "SNOW"
      },
      "lightningCount": 0,
      "sunGlare": {
        "calculatedVehicleHeading": 90,
        "glareIndex": 0
      },
      "hazards": {
        "maxHazardIndex": 0
      },
      "notifications": []
    },
    {
      "iconCode": 38,
      "shortPhrase": "Mostly cloudy",
      "isDayTime": false,
      "cloudCover": 65,
      "temperature": {
        "value": 3.4,
        "unit": "C",
        "unitType": 17
      },
      "wind": {
        "direction": {
          "degrees": 166
        },
        "speed": {
          "value": 1,
          "unit": "km/h",
          "unitType": 7
        }
      },
      "windGust": {
        "speed": {
          "value": 2,
          "unit": "km/h",
          "unitType": 7
        }
      },
      "precipitation": {
        "dbz": 0,
        "type": "SNOW"
      },
      "lightningCount": 0,
      "sunGlare": {
        "calculatedVehicleHeading": 77,
        "glareIndex": 0
      },
      "hazards": {
        "maxHazardIndex": 0
      },
      "notifications": []
    },
    {
      "iconCode": 35,
      "shortPhrase": "Partly cloudy",
      "isDayTime": false,
      "cloudCover": 43,
      "temperature": {
        "value": 3.2,
        "unit": "C",
        "unitType": 17
      },
      "wind": {
        "direction": {
          "degrees": 163
        },
        "speed": {
          "value": 2,
          "unit": "km/h",
          "unitType": 7
        }
      },
      "windGust": {
        "speed": {
          "value": 2,
          "unit": "km/h",
          "unitType": 7
        }
      },
      "precipitation": {
        "dbz": 0,
        "type": "SNOW"
      },
      "lightningCount": 0,
      "sunGlare": {
        "calculatedVehicleHeading": 44,
        "glareIndex": 0
      },
      "hazards": {
        "maxHazardIndex": 0
      },
      "notifications": []
    },
    {
      "iconCode": 35,
      "shortPhrase": "Partly cloudy",
      "isDayTime": false,
      "cloudCover": 34,
      "temperature": {
        "value": 1.6,
        "unit": "C",
        "unitType": 17
      },
      "wind": {
        "direction": {
          "degrees": 189
        },
        "speed": {
          "value": 2,
          "unit": "km/h",
          "unitType": 7
        }
      },
      "windGust": {
        "speed": {
          "value": 4,
          "unit": "km/h",
          "unitType": 7
        }
      },
      "precipitation": {
        "dbz": 0,
        "type": "SNOW"
      },
      "lightningCount": 0,
      "sunGlare": {
        "calculatedVehicleHeading": 32,
        "glareIndex": 0
      },
      "hazards": {
        "maxHazardIndex": 0
      },
      "notifications": []
    },
    {
      "iconCode": 38,
      "shortPhrase": "Mostly cloudy",
      "isDayTime": false,
      "cloudCover": 54,
      "temperature": {
        "value": 0.5,
        "unit": "C",
        "unitType": 17
      },
      "wind": {
        "direction": {
          "degrees": 202
        },
        "speed": {
          "value": 4,
          "unit": "km/h",
          "unitType": 7
        }
      },
      "windGust": {
        "speed": {
          "value": 5,
          "unit": "km/h",
          "unitType": 7
        }
      },
      "precipitation": {
        "dbz": 0,
        "type": "SNOW"
      },
      "lightningCount": 0,
      "sunGlare": {
        "calculatedVehicleHeading": 36,
        "glareIndex": 0
      },
      "hazards": {
        "maxHazardIndex": 0
      },
      "notifications": []
    },
    {
      "iconCode": 35,
      "shortPhrase": "Partly cloudy",
      "isDayTime": false,
      "cloudCover": 46,
      "temperature": {
        "value": 2.4,
        "unit": "C",
        "unitType": 17
      },
      "wind": {
        "direction": {
          "degrees": 222
        },
        "speed": {
          "value": 4,
          "unit": "km/h",
          "unitType": 7
        }
      },
      "windGust": {
        "speed": {
          "value": 5,
          "unit": "km/h",
          "unitType": 7
        }
      },
      "precipitation": {
        "dbz": 0,
        "type": "SNOW"
      },
      "lightningCount": 0,
      "sunGlare": {
        "calculatedVehicleHeading": 38,
        "glareIndex": 0
      },
      "hazards": {
        "maxHazardIndex": 0
      },
      "notifications": []
    },
    {
      "iconCode": 35,
      "shortPhrase": "Partly cloudy",
      "isDayTime": false,
      "cloudCover": 39,
      "temperature": {
        "value": 2.3,
        "unit": "C",
        "unitType": 17
      },
      "wind": {
        "direction": {
          "degrees": 231
        },
        "speed": {
          "value": 4,
          "unit": "km/h",
          "unitType": 7
        }
      },
      "windGust": {
        "speed": {
          "value": 5,
          "unit": "km/h",
          "unitType": 7
        }
      },
      "precipitation": {
        "dbz": 0,
        "type": "SNOW"
      },
      "lightningCount": 0,
      "sunGlare": {
        "calculatedVehicleHeading": 43,
        "glareIndex": 0
      },
      "hazards": {
        "maxHazardIndex": 0
      },
      "notifications": []
    }
  ]
}

Definicje

Nazwa	Opis
ErrorAdditionalInfo	Dodatkowe informacje o błędzie zarządzania zasobami.
ErrorDetail	Szczegóły błędu.
ErrorResponse	Odpowiedź na błąd
HazardDetail
HazardIndex	Indeks ważności/zagrożenia. `0` - Brak zagrożenia. `1` - Bądź świadomy. `2` - Zwróć uwagę, bądź przygotowany. `3` - Podejmij działania. `4` - Zagrażające życiu, awaryjne.
IconCode	Wartość liczbowa reprezentująca obraz, który wyświetla element `iconPhrase`. Szczegółowe informacje można znaleźć w artykule Weather services in Azure Maps (Usługi pogodowe w usłudze Azure Maps ).
JsonFormat	Żądany format odpowiedzi. Obsługiwany jest tylko `json` format.
SunGlare	Ocena wskazująca, jak oślepiające słońce jest dla kierowcy.
UnitType	Wartość identyfikatora liczbowego skojarzona z wyświetlanym typem jednostki. Można go użyć do tłumaczenia jednostkowego. Szczegółowe informacje można znaleźć w artykule Weather services in Azure Maps (Usługi pogodowe w usłudze Azure Maps ).
WeatherAlongRoutePrecipitation	Prognoza opadów pogody na trasie.
WeatherAlongRouteResult	Ten obiekt jest zwracany z pomyślnej pogody wzdłuż trasy.
WeatherAlongRouteSummary	Krótkie podsumowanie pogody wzdłuż trasy.
WeatherHazards	Opis zagrożenia pogodowego wpływającego na podróż.
WeatherNotification
WeatherUnit	Określona wartość danej jednostki powiązanej z pogodą.
WeatherWaypoint
WindDetails	Zwracane są szczegóły wiatru, w tym prędkość i kierunek.
WindDirection	Kierunek wiatru

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.

HazardDetail

Nazwa Typ Opis

hazardCode

string

Unikatowy identyfikator (nie jest wyświetlany) dla każdego typu zagrożenia: LightRain, ModerateRain, HeavyRain, LightMix, ModerateMix, HeavyMix, LightSnow, ModerateSnow, HeavySnow, LightIce, ModerateIce, HeavyIce, Hail, LargeHail, SunGlare, SunGlareHigh, Lightning, SevereLightning, WindModerate, WindHigh, WindExtreme, FloodWarning, FlashFloodWarning, TornadoWarning, TsunamiWarning, SevereThunderstormWarning.

hazardIndex

HazardIndex

Indeks ważności/zagrożenia.

0 - Brak zagrożenia.
1 - Bądź świadomy.
2 - Zwróć uwagę, bądź przygotowany.
3 - Podejmij działania.
4 - Zagrażające życiu, awaryjne.

shortPhrase

string

Wyświetlana krótka fraza opisująca prognozowane warunki i intensywność/typ opadów.

HazardIndex

Indeks ważności/zagrożenia.

0 - Brak zagrożenia.
1 - Bądź świadomy.
2 - Zwróć uwagę, bądź przygotowany.
3 - Podejmij działania.
4 - Zagrażające życiu, awaryjne.

Nazwa	Typ	Opis
0	Integer
1	Integer
2	Integer
3	Integer
4	Integer

IconCode

Wartość liczbowa reprezentująca obraz, który wyświetla element iconPhrase. Szczegółowe informacje można znaleźć w artykule Weather services in Azure Maps (Usługi pogodowe w usłudze Azure Maps ).

Nazwa	Typ	Opis
1	Integer
10	Integer
11	Integer
12	Integer
13	Integer
14	Integer
15	Integer
16	Integer
17	Integer
18	Integer
19	Integer
2	Integer
20	Integer
21	Integer
22	Integer
23	Integer
24	Integer
25	Integer
26	Integer
27	Integer
28	Integer
29	Integer
3	Integer
30	Integer
31	Integer
32	Integer
33	Integer
34	Integer
35	Integer
36	Integer
37	Integer
38	Integer
39	Integer
4	Integer
40	Integer
41	Integer
42	Integer
43	Integer
44	Integer
5	Integer
6	Integer
7	Integer
8	Integer
9	Integer

JsonFormat

Żądany format odpowiedzi. Obsługiwany jest tylko json format.

Nazwa	Typ	Opis
json	string	Format wymiany danych notacji obiektów JavaScript

SunGlare

Ocena wskazująca, jak oślepiające słońce jest dla kierowcy.

Nazwa	Typ	Opis
calculatedVehicleHeading	integer	Jeśli wartość nagłówka pojazdu nie zostanie podana dla punktu waypoint, usługa obliczy nagłówek na podstawie lokalizacji sąsiednich punktów waypoint, jeśli zostanie podany.
glareIndex	integer	Indeks od 0 do 100 wskazujący intensywność blasku słońca dla kierowcy. Wartość 50 lub wyższa może być uważana za zagrożenie dla niektórych kierowców, a wartość 100 oznacza, że kierowca jedzie prosto do słońca, a warunki atmosferyczne są jasne, co pozwala na pełną intensywność słońca, aby oślepić kierowcę.

UnitType

Wartość identyfikatora liczbowego skojarzona z wyświetlanym typem jednostki. Można go użyć do tłumaczenia jednostkowego. Szczegółowe informacje można znaleźć w artykule Weather services in Azure Maps (Usługi pogodowe w usłudze Azure Maps ).

Nazwa	Typ	Opis
0	Integer
1	Integer
10	Integer
11	Integer
12	Integer
13	Integer
14	Integer
15	Integer
16	Integer
17	Integer
18	Integer
19	Integer
2	Integer
20	Integer
21	Integer
22	Integer
3	Integer
31	Integer
4	Integer
5	Integer
6	Integer
7	Integer
8	Integer
9	Integer

WeatherAlongRoutePrecipitation

Prognoza opadów pogody na trasie.

Nazwa	Typ	Opis
dbz	number	Prognozowana intensywność opadów w dBZ (decybele względem Z) z 0,0 do 100,0.
type	string	Typ opadu. Jeśli wystąpią opady, typ, który będzie: "DESZCZ", "HAIL", "SNOW", "ICE" lub "MIX".

WeatherAlongRouteResult

Ten obiekt jest zwracany z pomyślnej pogody wzdłuż trasy.

Nazwa	Typ	Opis
summary	WeatherAlongRouteSummary	Krótkie podsumowanie pogody wzdłuż trasy.
waypoints	WeatherWaypoint[]	Dane dla każdego punktu waypoint zwróconego w tej samej kolejności, co określone w żądaniu.

WeatherAlongRouteSummary

Krótkie podsumowanie pogody wzdłuż trasy.

Nazwa	Typ	Opis
hazards	WeatherHazards	Opis zagrożenia pogodowego wpływającego na podróż.
iconCode	IconCode	Wartość liczbowa reprezentująca obraz, który wyświetla element `iconPhrase`. Szczegółowe informacje można znaleźć w artykule Weather services in Azure Maps (Usługi pogodowe w usłudze Azure Maps ).

WeatherHazards

Opis zagrożenia pogodowego wpływającego na podróż.

Nazwa Typ Opis

hazardDetails

Nazwa	Typ	Opis
hazardDetails	HazardDetail[]	Szczegóły zagrożeń pogodowych wpływających na podróż.
maxHazardIndex	HazardIndex	Indeks ważności/zagrożenia. `0` - Brak zagrożenia. `1` - Bądź świadomy. `2` - Zwróć uwagę, bądź przygotowany. `3` - Podejmij działania. `4` - Zagrażające życiu, awaryjne.

HazardDetail[]

Szczegóły zagrożeń pogodowych wpływających na podróż.

maxHazardIndex

HazardIndex

Indeks ważności/zagrożenia.

0 - Brak zagrożenia.
1 - Bądź świadomy.
2 - Zwróć uwagę, bądź przygotowany.
3 - Podejmij działania.
4 - Zagrażające życiu, awaryjne.

WeatherNotification

Nazwa	Typ	Opis
hazardCode	string	Unikatowy identyfikator (nie jest wyświetlany) dla każdego typu zagrożenia: LightRain, ModerateRain, HeavyRain, LightMix, ModerateMix, HeavyMix, LightSnow, ModerateSnow, HeavySnow, LightIce, ModerateIce, HeavyIce, Hail, LargeHail, SunGlare, SunGlareHigh, Lightning, SevereLightning, WindModerate, WindHigh, WindExtreme, FloodWarning, FlashFloodWarning, TornadoWarning, TsunamiWarning, SevereThunderstormWarning.
hazardIndex	HazardIndex	Indeks ważności/zagrożenia. `0` - Brak zagrożenia. `1` - Bądź świadomy. `2` - Zwróć uwagę, bądź przygotowany. `3` - Podejmij działania. `4` - Zagrażające życiu, awaryjne.
shortPhrase	string	Wyświetlana krótka fraza opisująca prognozowane warunki i intensywność/typ opadów.
type	string	Rodzaj powiadomienia wygenerowanego w celu ostrzeżenia kierowców o wystąpieniu zagrożenia lub zwiększenia intensywności zagrożenia.

WeatherUnit

Określona wartość danej jednostki powiązanej z pogodą.

Nazwa	Typ	Opis
unit	string	Typ jednostki dla zwracanej wartości.
unitType	UnitType	Wartość identyfikatora liczbowego skojarzona z wyświetlanym typem jednostki. Można go użyć do tłumaczenia jednostkowego. Szczegółowe informacje można znaleźć w artykule Weather services in Azure Maps (Usługi pogodowe w usłudze Azure Maps ).
value	number	Zaokrąglona wartość.

WeatherWaypoint

Nazwa	Typ	Opis
cloudCover	integer	Procent reprezentujący pokrycie chmury.
hazards	WeatherHazards	Opis zagrożenia pogodowego wpływającego na podróż.
iconCode	IconCode	Wartość liczbowa reprezentująca obraz, który wyświetla element `iconPhrase`. Szczegółowe informacje można znaleźć w artykule Weather services in Azure Maps (Usługi pogodowe w usłudze Azure Maps ).
isDayTime	boolean	Wskazuje godzinę dnia. Wartość True oznacza "dzień", wartość false oznacza "noc".
lightningCount	integer	Szacowanie intensywności burz na otwartą skalę. Wartość 0 oznacza, że nie ma burzy; wartości 1 i wyższa średnia występuje burza z piorunami w rosnącej intensywności.
notifications	WeatherNotification[]	Lista powiadomień o zagrożeniach pogodowych.
precipitation	WeatherAlongRoutePrecipitation	Prognoza opadów pogody na trasie.
shortPhrase	string	Wyświetlana krótka fraza opisująca prognozowane warunki i intensywność/typ opadów.
sunGlare	SunGlare	Ocena wskazująca, jak oślepiające słońce jest dla kierowcy.
temperature	WeatherUnit	Określona wartość danej jednostki powiązanej z pogodą.
wind	WindDetails	Zwracane są szczegóły wiatru, w tym prędkość i kierunek.
windGust	WindDetails	Zwracane są szczegóły wiatru, w tym prędkość i kierunek.

WindDetails

Zwracane są szczegóły wiatru, w tym prędkość i kierunek.

Nazwa	Typ	Opis
direction	WindDirection	Kierunek wiatru
speed	WeatherUnit	Prędkość wiatru w określonej jednostce.

WindDirection

Kierunek wiatru

Nazwa	Typ	Opis
degrees	integer	Kierunek wiatru w stopniach Azimuth, zaczynając od prawdziwej Północy i kontynuując kierunek zgodnie z ruchem wskazówek zegara. Północ jest 0 stopni, wschód jest 90 stopni, południe jest 180 stopni, zachód jest 270 stopni. Możliwe wartości 0–359.
localizedDescription	string	Skrót kierunku w określonym języku.

Udostępnij za pośrednictwem

Weather - Get Weather Along Route

Parametry identyfikatora URI

Nagłówek żądania

Odpowiedzi

Zabezpieczenia

AADToken

Uwagi

Zakresy

subscription-key

SAS Token

Przykłady

Successfully retrieve detailed weather casts along a route described as a sequence of waypoints

Przykładowe żądanie

Przykładowa odpowiedź

Definicje

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

HazardDetail

HazardIndex

IconCode

JsonFormat

SunGlare

UnitType

WeatherAlongRoutePrecipitation

WeatherAlongRouteResult

WeatherAlongRouteSummary

WeatherHazards

WeatherNotification

WeatherUnit

WeatherWaypoint

WindDetails

WindDirection

Dodatkowe zasoby