Weather - Get Current Conditions

Usługa:: Maps

Wersja interfejsu API:: 1.1

Użyj, aby uzyskać aktualne warunki pogodowe.
Interfejs Get Current Conditions API to żądanie HTTP GET , które zwraca szczegółowe bieżące warunki pogodowe, takie jak opady, temperatura i wiatr dla danej lokalizacji współrzędnych. Można również pobrać obserwacje z ostatnich 6 lub 24 godzin dla określonej lokalizacji. Podstawowe informacje zwracane z odpowiedzią obejmują szczegóły, takie jak data i godzina obserwacji, krótki opis warunków pogodowych, ikona pogody, flagi wskaźnika opadów i temperatura. Zwracane są również dodatkowe szczegóły, takie jak temperatura RealFeel™ i indeks UV. Aby uzyskać więcej informacji, zobacz Żądanie danych pogodowych w czasie rzeczywistym

GET {endpoint}/weather/currentConditions/json?api-version=1.1&query={query}

Z parametrami opcjonalnymi:

GET {endpoint}/weather/currentConditions/json?api-version=1.1&query={query}&unit={unit}&details={details}&duration={duration}&language={language}

Parametry identyfikatora URI

Nazwa	W	Wymagane	Typ	Opis
endpoint	path	True	string (uri)	Nazwa hosta usługi Azure Maps. Użyj `https://atlas.microsoft.com` do Azure chmury publicznej. Aby skupić się na konkretnej Azure Maps geografii lub chmurze suwerennej, zobacz Azure Maps zakres geograficzny.
format	path	True	JsonFormat	Żądany format odpowiedzi. Obsługiwany jest tylko format `json`.
api-version	query	True	string minLength: 1	Wersja interfejsu API do użycia dla tej operacji.
query	query	True	number[]	Odpowiednie zapytanie określone jako ciąg rozdzielony przecinkami składające się z szerokości geograficznej, po której następuje długość geograficzna, np. "47.641268,-122.125679". Informacje o pogodzie są ogólnie dostępne dla lokalizacji na lądzie, zbiorników wodnych otoczonych lądem oraz obszarów oceanu, które znajdują się w odległości około 50 mil morskich od linii brzegowej.
details	query		string	Zwróć pełne informacje o bieżących warunkach. Dostępne wartości to `true` - Zwraca pełne szczegóły. Domyślnie zwracane są wszystkie szczegóły. `false` - Zwraca skróconą wersję bieżących danych o stanie, która obejmuje datę obserwacji, godzinę i frazę pogody, kod ikony, flagę wskaźnika opadów i temperaturę.
duration	query		integer (int32)	Ramy czasowe zwracanych warunków pogodowych. Domyślnie zostaną zwrócone najbardziej aktualne warunki pogodowe. Wartość domyślna to 0. Obsługiwane wartości to: `0` - Zwróć najbardziej aktualne warunki pogodowe. `6` - Wróć warunki pogodowe z ostatnich 6 godzin. `24` - Wróć warunki pogodowe z ostatnich 24 godzin.
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. Jeśli 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.
unit	query		WeatherDataUnit	Określa, że dane mają być zwracane w jednostkach metrycznych lub jednostkach imperialnych. Wartość domyślna to metric.

Nagłówek żądania

Nazwa	Wymagane	Typ	Opis
x-ms-client-id		string	Wskazuje konto przeznaczone do użycia z modelem bezpieczeństwa Microsoft Entra ID. Ten unikalny identyfikator konta Azure Maps można uzyskać z API Azure Maps Account API na płaszczyźnie zarządzania. Więcej informacji na temat korzystania z Microsoft Entra ID zabezpieczeń w Azure Maps można znaleźć w Manage authentication in Azure Maps.

Odpowiedzi

Nazwa	Typ	Opis
200 OK	CurrentConditionsResult	Żądanie zakończyło się pomyślnie.
Other Status Codes	ErrorResponse	Nieoczekiwana odpowiedź na błąd.

Zabezpieczenia

AadToken

Są to przepływy Microsoft Entra OAuth 2.0. W połączeniu z Azure zarządzaniem dostępem opartym na rolach może być używany do kontroli dostępu do Azure Maps API REST. Kontrola dostępu oparta na rolach Azure służy do wyznaczania dostępu do jednego lub więcej kont zasobów lub podzasobów Azure Maps. Każdy użytkownik, grupa lub jednostka usługi mogą 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 koncepcji uwierzytelniania . Podsumowując, ta definicja zabezpieczeń zawiera 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.

Note

Ta definicja zabezpieczeń wymaga użycia nagłówka x-ms-client-id w celu wskazania, do którego zasobu usługi Azure Maps aplikacja żąda dostępu. Można to uzyskać za pomocą interfejsu API zarządzania usługami Maps.
Authorization URL jest specyficzna dla wystąpienia chmury publicznej platformy Azure. Suwerenne chmury mają unikalne adresy URL autoryzacji oraz konfiguracje Microsoft Entra ID.
Kontrola dostępu oparta na rolach platformy Azure jest konfigurowana na podstawie 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 Web SDK usługi Azure Maps umożliwia skonfigurowanie aplikacji na podstawie konfiguracji dla wielu przypadków użycia.
Aby uzyskać więcej informacji na temat platformy tożsamości firmy Microsoft, zobacz Platforma tożsamości Microsoft overview.

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

Zakresy

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

subscription-key

Jest to klucz wspólny aprowizowany podczas tworzenie 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.

Za pomocą tego klucza każda aplikacja może uzyskiwać dostęp do całego interfejsu 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 poufnych aplikacji klienckich podejście do uzyskiwania dostępu do interfejsów API REST usługi Azure Maps, aby klucz mógł być bezpiecznie przechowywany.

Typ: apiKey
W: header

SAS Token

Jest to token sygnatury dostępu współdzielonego tworzony na podstawie operacji List SAS na 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 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 i 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 zabezpieczony niż klucz wspólny.

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

Typ: apiKey
W: header

Przykłady

Successfully retrieve detailed current weather conditions for a given coordinate location

Przykładowe żądanie

HTTP

GET https://atlas.microsoft.com/weather/currentConditions/json?api-version=1.1&query=47.641268,-122.125679

Przykładowa odpowiedź

Kod stanu:: 200

{
  "results": [
    {
      "apparentTemperature": {
        "unit": "C",
        "unitType": 17,
        "value": 16.1
      },
      "ceiling": {
        "unit": "m",
        "unitType": 5,
        "value": 4359
      },
      "cloudCover": 95,
      "dateTime": "2019-11-14T15:08:00-08:00",
      "dewPoint": {
        "unit": "C",
        "unitType": 17,
        "value": 9.2
      },
      "hasPrecipitation": false,
      "iconCode": 7,
      "isDayTime": true,
      "obstructionsToVisibility": "",
      "pastTwentyFourHourTemperatureDeparture": {
        "unit": "C",
        "unitType": 17,
        "value": 1.8
      },
      "phrase": "Cloudy",
      "precipitationSummary": {
        "past12Hours": {
          "unit": "mm",
          "unitType": 3,
          "value": 0.8
        },
        "past18Hours": {
          "unit": "mm",
          "unitType": 3,
          "value": 0.8
        },
        "past24Hours": {
          "unit": "mm",
          "unitType": 3,
          "value": 0.8
        },
        "past3Hours": {
          "unit": "mm",
          "unitType": 3,
          "value": 0.8
        },
        "past6Hours": {
          "unit": "mm",
          "unitType": 3,
          "value": 0.8
        },
        "past9Hours": {
          "unit": "mm",
          "unitType": 3,
          "value": 0.8
        },
        "pastHour": {
          "unit": "mm",
          "unitType": 3,
          "value": 0.5
        }
      },
      "pressure": {
        "unit": "mb",
        "unitType": 14,
        "value": 1014.9
      },
      "pressureTendency": {
        "code": "S",
        "localizedDescription": "Steady"
      },
      "realFeelTemperature": {
        "unit": "C",
        "unitType": 17,
        "value": 13.6
      },
      "realFeelTemperatureShade": {
        "unit": "C",
        "unitType": 17,
        "value": 13.6
      },
      "relativeHumidity": 75,
      "temperature": {
        "unit": "C",
        "unitType": 17,
        "value": 13.7
      },
      "temperatureSummary": {
        "past12Hours": {
          "maximum": {
            "unit": "C",
            "unitType": 17,
            "value": 13.7
          },
          "minimum": {
            "unit": "C",
            "unitType": 17,
            "value": 5.9
          }
        },
        "past24Hours": {
          "maximum": {
            "unit": "C",
            "unitType": 17,
            "value": 13.7
          },
          "minimum": {
            "unit": "C",
            "unitType": 17,
            "value": 5.9
          }
        },
        "past6Hours": {
          "maximum": {
            "unit": "C",
            "unitType": 17,
            "value": 13.7
          },
          "minimum": {
            "unit": "C",
            "unitType": 17,
            "value": 8.3
          }
        }
      },
      "uvIndex": 0,
      "uvIndexPhrase": "Low",
      "visibility": {
        "unit": "km",
        "unitType": 6,
        "value": 8
      },
      "wetBulbTemperature": {
        "unit": "C",
        "unitType": 17,
        "value": 11.4
      },
      "wind": {
        "direction": {
          "degrees": 315,
          "localizedDescription": "NW"
        },
        "speed": {
          "unit": "km/h",
          "unitType": 7,
          "value": 3.6
        }
      },
      "windChillTemperature": {
        "unit": "C",
        "unitType": 17,
        "value": 13.9
      },
      "windGust": {
        "speed": {
          "unit": "km/h",
          "unitType": 7,
          "value": 4.9
        }
      }
    }
  ]
}

Definicje

Nazwa	Opis
CurrentConditions	Pojedyncza obserwacja pogodowa dla podanego miejsca, zwracana przez operację Get Current Conditions. W zależności od zapytania `duration`, ta obserwacja może być najnowszym (najnowszym) odczytem lub jednym z poprzednich godzinowych pomiarów. Domyślnie zwracany jest uproszczony podzbiór: data i godzina obserwacji, fraza pogodowa, kod ikony, wskaźnik opadów oraz temperatura. Gdy żądanie wymaga pełnych szczegółów, uwzględnia się każda nieruchomość, dodając pomiary takie jak RealFeel, punkt rosy, wiatr, widoczność, zachmurzenie, ciśnienie oraz podsumowania opadów i temperatur z ostatnich kilku godzin.
CurrentConditionsResult	Odpowiedź zwracana przez operację Get Current Conditions, zawierającą jedną lub więcej obserwacji warunków bieżących dla określonej lokalizacji. Domyślnie zwracana jest pojedyncza obserwacja dla bieżącego czasu; gdy parametr jest ustawiony `duration` na 6 lub 24, odpowiedź zawiera również jedną obserwację na ostatnią godzinę w tym oknie.
ErrorAdditionalInfo	Dodatkowe informacje o błędzie zarządzania zasobami.
ErrorDetail	Szczegóły błędu.
ErrorResponse	Wspólna odpowiedź na błędy dla wszystkich API Azure Resource Manager zwraca szczegóły błędów dla nieudanych operacji. (Jest to również zgodne z formatem odpowiedzi na błąd OData).
IconCode	Numeryczny kod warunków pogodowych, który identyfikuje, którą ikonę wyświetlić na ekranie. Każda wartość w tej enumeracji odpowiada ikonie pogody w Azure Maps (np. Słoneczne, Pochmurne lub Burze) i łączy się z czytelną dla człowieka `iconPhrase` ikoną zwracaną obok niej. Ten sam kod może pojawiać się w bieżących, godzinowych, dziennych, kwartałowych i minutowych odpowiedziach, co pozwala aplikacjom wyświetlać spójny zestaw ikon dla wszystkich serwisów pogodowych. Pełną listę kodów, ikon, do których się przypisują, oraz przykładowe obrazy można znaleźć w artykule Usługi pogodowe w Azure Maps.
JsonFormat	Żądany format odpowiedzi. Obsługiwany jest tylko format `json`.
PastHoursTemperature	Najwyższe i najniższe temperatury powietrza zaobserwowane podczas jednego z okien włączania `TemperatureSummary` (po 6, 12 lub 24 godzinach) w stopniach Celsjusza (°C) lub Fahrenheita (°F), w zależności od jednostki określonej w prośbie.
PrecipitationSummary	Całkowite opady równoważne cieczy, które spadły w miejscu obserwacji podczas przesuwających się okien kończących się w czasie obserwacji. Każda wartość obejmuje pełne okno mierzone od "teraz" – na przykład `past3Hours` jest to suma bieżąca za ostatnie trzy godziny, a nie tylko za trzecią godzinę – więc okna nakładają się, a dłuższe okna obejmują opady zgłaszane dla krótszych. Śnieg i lód dostarczają swojego stopionego (ciekłego) odpowiednika. Podawane w milimetrach (mm) lub calach (in), w zależności od jednostki określonej w zapytaniu.
PressureTendency	Ostatni trend ciśnienia atmosferycznego – niezależnie od tego, czy ciśnienie rośnie, maleje, czy pozostaje – powrócił zarówno jako zlokalizowana fraza, jak i jednoliterowy kod. Przydatne do przewidywania krótkotrwałych zmian pogodowych; spadek ciśnienia często sygnatuje pogarszającą się pogodę, podczas gdy wzrost ciśnienia zazwyczaj oznacza poprawę warunków.
TemperatureSummary	Najwyższe i najniższe temperatury powietrza zaobserwowane w tym miejscu nad ruchomymi oknami, kończące się w czasie obserwacji. Każda wartość obejmuje pełne okno mierzone od "teraz" – na przykład raportuje `past12Hours` maksimum i minimum w ostatnich 12 godzinach, a nie tylko w dwunastej godzinie – więc okna się nakładają, a dłuższe okna obejmują temperatury zgłaszane dla krótszych. Podawane w stopniach Celsjusza (°C) lub Fahrenheita (°F), w zależności od jednostki określonej w żądaniu.
UnitType	Wartość całkowita przypisana do typu wyświetlanej jednostki. Na przykład 17 dla stopni Celsjusza, 18 dla stopni Fahrenheita. Może być używany do przeliczania jednostek. Więcej informacji można znaleźć w Usługi pogodowe w Azure Maps.
WeatherDataUnit	Określa, czy zwracać dane w jednostkach metrycznych czy imperialnych, z metryką jako domyślną. Przykład: Metryka: milimetr (mm), metr (m), kilometr (km), Celsjusz (C) Imperial: cal (cal), stopa (ft), mila (mila), Fahrenheit (F)
WeatherValue	Wartości dla wskaźników związanych z pogodą, takich jak temperatura, punkt rosy i prędkość wiatru, przedstawione w jednostkach metrycznych lub imperialnych, zgodnie z parametrem jednostkowym URI. Więcej informacji można znaleźć w artykule Typy jednostek w artykule Weather services in Azure Maps.
WindDetails	Dostarcza prognozowaną prędkość wiatru, mierzoną w jednostkach takich jak kilometry na godzinę (km/h) lub mile na godzinę (mph), w zależności od jednostki określonej w żądaniu. Wskazuje także kierunek wiatru mierzony w stopniach azymutu, zaczynając od prawdziwej północy i poruszając się zgodnie z ruchem wskazówek zegara. Północ odpowiada 0°, wschód 90°, południe 180°, a zachód 270°. Możliwe wartości wahają się od 0° do 359°.
WindDirection	Zawiera szczegóły dotyczące kierunku wiatru, w tym kierunek w stopniach azymutu oraz zlokalizowany skrót kierunku wiatru.

CurrentConditions

Objekt

Pojedyncza obserwacja pogodowa dla podanego miejsca, zwracana przez operację Get Current Conditions. W zależności od zapytania duration, ta obserwacja może być najnowszym (najnowszym) odczytem lub jednym z poprzednich godzinowych pomiarów. Domyślnie zwracany jest uproszczony podzbiór: data i godzina obserwacji, fraza pogodowa, kod ikony, wskaźnik opadów oraz temperatura. Gdy żądanie wymaga pełnych szczegółów, uwzględnia się każda nieruchomość, dodając pomiary takie jak RealFeel, punkt rosy, wiatr, widoczność, zachmurzenie, ciśnienie oraz podsumowania opadów i temperatur z ostatnich kilku godzin.

Nazwa	Typ	Opis
apparentTemperature	WeatherValue	Pozorna temperatura w czasie obserwacji – jak powietrze faktycznie się czuje dla ludzi, biorąc pod uwagę temperaturę powietrza, wilgotność względną i prędkość wiatru. Mierzone w stopniach Celsjusza (°C) lub Fahrenheita (°F), w zależności od jednostki podanej w prośbie.
ceiling	WeatherValue	Limit chmur w czasie obserwacji – wysokość najniższej warstwy chmur nad ziemią – w stopach (ft) lub metrach (m), w zależności od jednostki określonej w żądaniu. Ważne dla lotnictwa, ponieważ wpływa na widoczność i operacje lotu.
cloudCover	integer (int32)	Procent nieba pokrytego chmurami w czasie obserwacji wynosi od 0 (czysto) do 100 (zachmurzone). Może mieć wartość NULL.
dateTime	string (date-time)	Data i godzina tej obserwacji, w formacie RFC 3339 (yyyy-mm-ddThh:mm:ss-hh:mm). Na przykład 2025-04-29T07:00:00-07:00.
dewPoint	WeatherValue	Punkt rosy w czasie obserwacji – temperatura, do której powietrze musi się ochłodzić, aby było nasycone (100% wilgotności względnej). Mierzone w stopniach Celsjusza (°C) lub Fahrenheita (°F), w zależności od jednostki podanej w prośbie. Wyższy punkt rosy oznacza większą wilgoć w powietrzu.
hasPrecipitation	boolean	`true` jeśli w czasie obserwacji występują opady (deszcz, śnieg, śnieg lub grad); w przeciwnym razie `false`.
iconCode	IconCode	Reprezentatywny kod ikony pogody dla tej obserwacji, w połączeniu z nieruchomością `phrase` . Wartość numeryczna odpowiada ikonie pogody w Azure Maps – pełną listę można znaleźć w artykule Usługi pogodowe w Azure Maps. Może mieć wartość NULL.
isDayTime	boolean	`true` jeśli jest dzień w określonym miejscu w czasie obserwacji; `false` jeśli jest nocą.
obstructionsToVisibility	string	Kod identyfikujący dominujący czynnik obniżający widoczność w czasie obserwacji, taki jak mgła, dym, mgła czy opady. Przydatne do aktywności wymagających dobrej widoczności, takich jak jazda samochodem czy lotnictwo. Możliwe wartości: A = silna burza/grad BD = wydmuchiwanie pyłu BN = wydmuchiwanie piasku BS = dmuchanie śniegu D = pył F = mgła GF = mgła gruntowa HZ = mgła I = lód IC = kryształy lodu IF = mgła lodowa IP = kulki lodowe IPW = deszcz kulek lodowych K = dym L = mżawka R = deszcz RS = deszcz/śnieg RW = deszcz S = śnieg SG = ziarno śniegu SP = śnieżne śnieżki SW = opady śniegu T = burza UP = nieokreślone opady ZL = mżawka z lodem ZR = lodowaty deszcz + = ciężki - = światło
pastTwentyFourHourTemperatureDeparture	WeatherValue	Zmiana temperatury powietrza w porównaniu do 24 godzin temu wynosi stopnie Celsjusza (°C) lub Fahrenheita (°F), w zależności od jednostki podanej w prośbie. Wartości dodatnie oznaczają, że powietrze jest cieplejsze niż wczoraj o tej samej porze; wartości ujemne oznaczają, że jest chłodniej.
phrase	string	Krótki opis warunków pogodowych w czasie obserwacji – na przykład słonecznie lub częściowo pochmurno. Sparuje z `iconCode`, co identyfikuje odpowiadającą ikonę pogody. Więcej informacji można znaleźć w Usługi pogodowe w Azure Maps.
precipitationSummary	PrecipitationSummary	Podsumowanie ilości opadów równoważnych cieczy w miejscu obserwacji w oknach przesuwających się z ostatnich 1, 3, 6, 9, 12, 18 i 24 godzin, w milimetrach (mm) lub calach (calach), w zależności od jednostki określonej w żądaniu.
pressure	WeatherValue	Ciśnienie atmosferyczne (powietrze) na poziomie gruntu w czasie obserwacji, w milibarach (mb) lub calach rtęci (inHg), w zależności od jednostki określonej w żądaniu.
pressureTendency	PressureTendency	Ostatni trend ciśnienia atmosferycznego – rośnie, spada lub utrzymuje się stabilnie. Przydatne do przewidywania krótkotrwałych zmian pogodowych; spadek ciśnienia często sygnatuje pogarszającą się pogodę, podczas gdy wzrost ciśnienia zazwyczaj oznacza poprawę warunków.
realFeelTemperature	WeatherValue	Temperatura RealFeel™ w czasie obserwacji to stopnie Celsjusza (°C) lub Fahrenheita (°F), w zależności od jednostki podanej w żądaniu. Stworzony przez AccuWeather, RealFeel łączy temperaturę powietrza z wilgotnością, wiatrem, zachmurzeniem, intensywnością słońca i innymi czynnikami, aby pokazać, jak pogoda faktycznie się czuje. Więcej informacji znajdziesz w artykule Jaka jest temperatura AccuWeather RealFeel?
realFeelTemperatureShade	WeatherValue	Temperatura RealFeel™ w czasie obserwacji w zacienionych obszarach wynosi stopnie Celsjusza (°C) lub Fahrenheita (°F), w zależności od jednostki określonej w żądaniu. Na przykład `realFeelTemperature`, ale wyklucza efekt ocieplenia bezpośredniego światła słonecznego, dając dokładniejsze wyobrażenie o tym, jak pogoda jest w cieniu.
relativeHumidity	integer (int32)	Wilgotność względna w czasie obserwacji, wyrażona jako procent od 0 do 100 maksymalnej ilości pary wodnej, jaką powietrze może utrzymać przy tej samej temperaturze.
temperature	WeatherValue	Temperatura powietrza w czasie obserwacji wypadała w stopniach Celsjusza (°C) lub Fahrenheita (°F), w zależności od jednostki określonej w żądaniu.
temperatureSummary	TemperatureSummary	Podsumowanie najwyższych i najniższych temperatur powietrza obserwowanych w tym miejscu w oknach ruchomych w ciągu ostatnich 6, 12 i 24 godzin, w stopniach Celsjusza (°C) lub Fahrenheita (°F), w zależności od jednostki określonej w żądaniu.
uvIndex	integer (int32)	Wskaźnik ultrafioletowy (UV) w czasie obserwacji, wskazujący na ryzyko uszkodzenia spowodowanego niechronioną ekspozycją na słońce. Obsługiwane wartości to: 0-2: Niskie ryzyko promieniowania UV dla przeciętnej osoby. 3-5: Umiarkowane ryzyko uszkodzenia spowodowanego niechronionym słońcem. 6-7: Wysokie ryzyko uszkodzenia spowodowanego niechronionym słońcem. 8-10: Bardzo wysokie ryzyko uszkodzenia spowodowanego niechronionym słońcem. 11+: Ekstremalne ryzyko uszkodzenia spowodowanego niechronionym słońcem.
uvIndexPhrase	string	Krótka opisowa etykieta dla `uvIndex` – na przykład Niski,Umiarkowany, Wysoký, Bardzo Wysoki lub Ekstremalny.
visibility	WeatherValue	Widoczność pozioma w czasie obserwacji – odległość, na której obiekt lub światło jest wyraźnie rozpoznawalne – w kilometrach (km) lub milach (mi), w zależności od jednostki określonej w żądaniu.
wetBulbTemperature	WeatherValue	Temperatura mokrego termometra w czasie obserwacji – temperatura, jaką powietrze osiągnie, jeśli zostanie schłodzone do nasycenia (100% wilgotności względnej) przez odparowanie wody przy stałym ciśnieniu. Mierzone w stopniach Celsjusza (°C) lub Fahrenheita (°F), w zależności od jednostki podanej w prośbie. Przydatne do oceny stresu cieplnego i chłodzenia parowego.
wind	WindDetails	Prędkość i kierunek wiatru w czasie obserwacji. Prędkość wynosi w kilometrach na godzinę (km/h) lub milach na godzinę (mph), w zależności od jednostki określonej w żądaniu; kierunek jest w stopniach azymutu, mierzonych zgodnie z ruchem wskazówek zegara od prawdziwej północy (0° = N, 90° = E, 180° = S, 270° = W).
windChillTemperature	WeatherValue	Temperatura chłodna przy wietrze w czasie obserwacji – jak zimne powietrze jest na odsłoniętej skórze spowodowane wspólnym działaniem wiatru i niskiej temperatury. Zazwyczaj niższa niż rzeczywista temperatura powietrza. Mierzone w stopniach Celsjusza (°C) lub Fahrenheita (°F), w zależności od jednostki podanej w prośbie.
windGust	WindDetails	Maksymalna prędkość i kierunek krótkiego porywu wiatru i podmuchu w czasie obserwacji, przy użyciu tych samych jednostek i konwencji azymutu co `wind`. Podmuchy wiatru to krótkotrwałe skoki prędkości wiatru, które mogą wpływać na aktywności takie jak lotnictwo, żeglarstwo, puszczanie latawców i inne wydarzenia na zewnątrz.

CurrentConditionsResult

Objekt

Odpowiedź zwracana przez operację Get Current Conditions, zawierającą jedną lub więcej obserwacji warunków bieżących dla określonej lokalizacji. Domyślnie zwracana jest pojedyncza obserwacja dla bieżącego czasu; gdy parametr jest ustawiony duration na 6 lub 24, odpowiedź zawiera również jedną obserwację na ostatnią godzinę w tym oknie.

Nazwa	Typ	Opis
results	CurrentConditions[]	Obserwacje warunków bieżących, w kolejności chronologicznej z najnowszymi pierwszymi. Domyślnie pojedynczy wpis – najnowsza obserwacja jest zwracana; odpowiedź może również zawierać jeden wpis na godzinę w ostatnim oknie przesuwającym się (zazwyczaj w ciągu ostatnich 6 lub 24 godzin), w zależności od żądania.

Nazwa

Typ

Opis

results

CurrentConditions[]

Obserwacje warunków bieżących, w kolejności chronologicznej z najnowszymi pierwszymi. Domyślnie pojedynczy wpis – najnowsza obserwacja

jest zwracana; odpowiedź może również zawierać jeden wpis na godzinę w ostatnim oknie przesuwającym się (zazwyczaj w ciągu ostatnich 6 lub 24 godzin), w zależności od żądania.

ErrorAdditionalInfo

Objekt

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

Nazwa	Typ	Opis
info		Dodatkowe informacje.
type	string	Dodatkowy typ informacji.

ErrorDetail

Objekt

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

Objekt

Wspólna odpowiedź na błędy dla wszystkich API Azure Resource Manager zwraca szczegóły błędów dla nieudanych operacji. (Jest to również zgodne z formatem odpowiedzi na błąd OData).

Nazwa	Typ	Opis
error	ErrorDetail	Obiekt błędu.

IconCode

Wyliczenie

Numeryczny kod warunków pogodowych, który identyfikuje, którą ikonę wyświetlić na ekranie. Każda wartość w tej enumeracji odpowiada ikonie pogody w Azure Maps (np. Słoneczne, Pochmurne lub Burze) i łączy się z czytelną dla człowieka iconPhrase ikoną zwracaną obok niej. Ten sam kod może pojawiać się w bieżących, godzinowych, dziennych, kwartałowych i minutowych odpowiedziach, co pozwala aplikacjom wyświetlać spójny zestaw ikon dla wszystkich serwisów pogodowych.

Pełną listę kodów, ikon, do których się przypisują, oraz przykładowe obrazy można znaleźć w artykule Usługi pogodowe w Azure Maps.

Wartość	Opis
1	Słoneczny
2	Przeważnie słonecznie
3	Częściowo słonecznie
4	Przerywane chmury
5	Mgliste słońce
6	Przeważnie pochmurno
7	Cloudy
8	Ponury (Pochmurny)
11	Mgła
12	Showers
13	Głównie pochmurne z prysznicami
14	Częściowo słonecznie z prysznicami
15	Thunderstorms
16	Głównie pochmurne z burzemi
17	Częściowo słonecznie z burzami
18	Deszcz
19	Flurries
20	Głównie pochmurne z Flurries
21	Częściowo słonecznie z flurries
22	Snow
23	Głównie pochmurne z śniegiem
24	Lód
25	Sleet
26	Marznący deszcz
29	Deszcz i śnieg
30	Hot
31	Cold
32	Windy
33	Przejrzysty
34	W większości jasne
35	Deszcz
36	Przerywane chmury
37	Mgliste światło księżyca
38	Przeważnie pochmurno
39	Częściowo pochmurne z prysznicami
40	Głównie pochmurne z prysznicami
41	Częściowo pochmurne z burzemi
42	Głównie pochmurne z burzemi
43	Głównie pochmurne z Flurries
44	Głównie pochmurne z śniegiem

JsonFormat

Wyliczenie

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

Wartość	Opis
json	format wymiany danych notacji obiektów JavaScript

PastHoursTemperature

Objekt

Najwyższe i najniższe temperatury powietrza zaobserwowane podczas jednego z okien włączania TemperatureSummary (po 6, 12 lub 24 godzinach) w stopniach Celsjusza (°C) lub Fahrenheita (°F), w zależności od jednostki określonej w prośbie.

Nazwa	Typ	Opis
maximum	WeatherValue	Najwyższa temperatura zaobserwowana podczas okna okna.
minimum	WeatherValue	Najniższa temperatura zaobserwowana w tym oknie.

PrecipitationSummary

Objekt

Całkowite opady równoważne cieczy, które spadły w miejscu obserwacji podczas przesuwających się okien kończących się w czasie obserwacji. Każda wartość obejmuje pełne okno mierzone od "teraz" – na przykład past3Hours jest to suma bieżąca za ostatnie trzy godziny, a nie tylko za trzecią godzinę – więc okna nakładają się, a dłuższe okna obejmują opady zgłaszane dla krótszych. Śnieg i lód dostarczają swojego stopionego (ciekłego) odpowiednika. Podawane w milimetrach (mm) lub calach (in), w zależności od jednostki określonej w zapytaniu.

Nazwa	Typ	Opis
past12Hours	WeatherValue	Opady ekwiwalentne cieczy spadły w ciągu ostatnich 12 godzin.
past18Hours	WeatherValue	Opady ekwiwalentne w cieczy spadły w ciągu ostatnich 18 godzin.
past24Hours	WeatherValue	Opady równoważne cieczom, które spadły w ciągu ostatnich 24 godzin.
past3Hours	WeatherValue	Opady ekwiwalentne cieczy, które spadły w ciągu ostatnich 3 godzin.
past6Hours	WeatherValue	Opady ekwiwalentne cieczy, które spadły w ciągu ostatnich 6 godzin.
past9Hours	WeatherValue	Opady równoważne cieczy, które spadły w ciągu ostatnich 9 godzin.
pastHour	WeatherValue	Opady równoważne cieczy, które spadły w ciągu ostatniej godziny.

PressureTendency

Objekt

Ostatni trend ciśnienia atmosferycznego – niezależnie od tego, czy ciśnienie rośnie, maleje, czy pozostaje – powrócił zarówno jako zlokalizowana fraza, jak i jednoliterowy kod. Przydatne do przewidywania krótkotrwałych zmian pogodowych; spadek ciśnienia często sygnatuje pogarszającą się pogodę, podczas gdy wzrost ciśnienia zazwyczaj oznacza poprawę warunków.

Nazwa	Typ	Opis
code	string	Jednoliterowy kod niezależny od języka dla tendencji ciśnienia: F = Spadający, S = Stały, R = Rosnący.
localizedDescription	string	Krótkie wyrażenie opisujące tendencję nacisku – na przykład Opadające, Stałe lub Rosnące – wróciło w języku wskazanym w prośbie.

TemperatureSummary

Objekt

Najwyższe i najniższe temperatury powietrza zaobserwowane w tym miejscu nad ruchomymi oknami, kończące się w czasie obserwacji. Każda wartość obejmuje pełne okno mierzone od "teraz" – na przykład raportuje past12Hours maksimum i minimum w ostatnich 12 godzinach, a nie tylko w dwunastej godzinie – więc okna się nakładają, a dłuższe okna obejmują temperatury zgłaszane dla krótszych. Podawane w stopniach Celsjusza (°C) lub Fahrenheita (°F), w zależności od jednostki określonej w żądaniu.

Nazwa	Typ	Opis
past12Hours	PastHoursTemperature	Najwyższe i najniższe temperatury zaobserwowane w ciągu ostatnich 12 godzin.
past24Hours	PastHoursTemperature	Najwyższe i najniższe temperatury zaobserwowane w ciągu ostatnich 24 godzin.
past6Hours	PastHoursTemperature	Najwyższe i najniższe temperatury zaobserwowane w ciągu ostatnich 6 godzin.

UnitType

Wyliczenie

Wartość całkowita przypisana do typu wyświetlanej jednostki. Na przykład 17 dla stopni Celsjusza, 18 dla stopni Fahrenheita. Może być używany do przeliczania jednostek. Więcej informacji można znaleźć w Usługi pogodowe w Azure Maps.

Wartość	Opis
0	feet
1	inches
2	miles
3	millimeter
4	centimeter
5	miernik
6	kilometer
7	kilometersPerHour
8	knots
9	milesPerHour
10	metersPerSecond
11	hectoPascals
12	inchesOfMercury
13	kiloPascals
14	millibars
15	millimetersOfMercury
16	poundsPerSquareInch
17	Stopnie Celsjusza
18	Fahrenheit
19	kelvin
20	percent
21	float
22	liczba całkowita
31	MicrogramsPerCubicMeterOfAir

WeatherDataUnit

Wyliczenie

Określa, czy zwracać dane w jednostkach metrycznych czy imperialnych, z metryką jako domyślną. Przykład:

Metryka: milimetr (mm), metr (m), kilometr (km), Celsjusz (C)
Imperial: cal (cal), stopa (ft), mila (mila), Fahrenheit (F)

Wartość	Opis
imperial	Zwracaj dane za pomocą jednostek imperialnych, takich jak Fahrenheit (F) dla temperatury oraz mil (mi) dla odległości.
metric	Zwracanie danych przy użyciu jednostek metrycznych, takich jak stopnie Celsjusza (C) dla temperatury i kilometr (km) dla odległości.

WeatherValue

Objekt

Wartości dla wskaźników związanych z pogodą, takich jak temperatura, punkt rosy i prędkość wiatru, przedstawione w jednostkach metrycznych lub imperialnych, zgodnie z parametrem jednostkowym URI. Więcej informacji można znaleźć w artykule Typy jednostek w artykule Weather services in Azure Maps.

Nazwa	Typ	Opis
unit	string	Jednostka miary używana w wartości zwrotu, taka jak "C" dla Celsjusza, "F" dla Fahrenheita.
unitType	UnitType	Liczba całkowita reprezentująca typ jednostki. Na przykład 0 dla stóp, 1 dla cali, 2 dla mil. Pełną listę można znaleźć w artykule Typy jednostek w artykule Weather services in Azure Maps.
value	number (float)	Wartość zmierzona wyrażona w określonej jednostce.

WindDetails

Objekt

Dostarcza prognozowaną prędkość wiatru, mierzoną w jednostkach takich jak kilometry na godzinę (km/h) lub mile na godzinę (mph), w zależności od jednostki określonej w żądaniu. Wskazuje także kierunek wiatru mierzony w stopniach azymutu, zaczynając od prawdziwej północy i poruszając się zgodnie z ruchem wskazówek zegara. Północ odpowiada 0°, wschód 90°, południe 180°, a zachód 270°. Możliwe wartości wahają się od 0° do 359°.

Nazwa	Typ	Opis
direction	WindDirection	Kierunek wiatru mierzy się w stopniach azymutu, zaczynając od prawdziwej północy (0°) i poruszając zgodnie z ruchem wskazówek zegara. Wschód odpowiada 90°, południe 180°, a zachód 270°. Możliwe wartości wahają się od 0° do 359°. Ta własność zwraca liczbę całkowitą reprezentującą kierunek wiatru.
speed	WeatherValue	Oczekiwana prędkość wiatru, mierzona w kilometrach na godzinę (km/h) lub milach na godzinę (mph), w zależności od jednostki określonej w żądaniu.

WindDirection

Objekt

Zawiera szczegóły dotyczące kierunku wiatru, w tym kierunek w stopniach azymutu oraz zlokalizowany skrót kierunku wiatru.

Nazwa	Typ	Opis
degrees	integer (int32)	Kierunek wiatru mierzy się w stopniach azymutu, zaczynając od prawdziwej północy i poruszając się zgodnie z ruchem wskazówek zegara. północ odpowiada 0 stopniom, wschód 90 stopniom, południe 180 stopni, a zachód 270 stopni. Możliwe wartości wahają się od 0 do 359 stopni.
localizedDescription	string	Zlokalizowany skrót kierunku wiatru, zwracany w języku określonym w żądaniu. Na przykład `N` dla północy, `E` dla wschodu, `S` dla południa i `W` dla zachodu.