Weather - Get Daily Forecast

Usługa:: Maps

Wersja interfejsu API:: 1.1

Użyj, aby uzyskać codzienną szczegółową prognozę pogody na następne 1, 5, 10, 15, 25 lub 45 dni.

Interfejs Get Daily Forecast API to żądanie HTTP GET , które zwraca szczegółową prognozę pogody, taką jak temperatura i wiatr w ciągu dnia, na następne 1, 5, 10, 15, 25 lub 45 dni dla danej lokalizacji współrzędnych. Odpowiedź zawiera szczegółowe informacje, takie jak temperatura, wiatr, opady, jakość powietrza i indeks UV. Aby uzyskać więcej informacji, zobacz Żądanie danych dziennej prognozy pogody.

Jeśli używasz warstwy cenowej Gen1 S0, możesz zażądać dziennej prognozy na następne 1, 5, 10 i 15 dni. Jeśli używasz warstwy cenowej Gen1 S1 lub Gen2, możesz również zażądać dziennej prognozy na następne 25 dni i 45 dni.

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

Z parametrami opcjonalnymi:

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

Parametry identyfikatora URI

Nazwa	W	Wymagane	Typ	Opis
format	path	True	JsonFormat	Żądany format odpowiedzi. Obsługiwany jest tylko format `json`.
api-version	query	True	string	Numer wersji interfejsu API usługi Azure Maps.
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.
duration	query		integer	Określa liczbę dni zwracanych codziennych odpowiedzi prognozy. Dostępne wartości to `1` - Zwróć dane prognozy na następny dzień. Zwracane domyślnie. `5` - Zwróć dane prognozy na najbliższe 5 dni. `10` - Zwróć dane prognozy na następne 10 dni. `25` - Zwróć dane prognozy na następne 25 dni. Dostępne tylko w SKU S1. `45` - Zwróć dane prognozy na następne 45 dni. Dostępne tylko w SKU S1.
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 zabezpieczeń Microsoft Entra ID. Ten unikatowy identyfikator konta Azure Maps można uzyskać z interfejsu API konta płaszczyzny zarządzania Azure Maps. Aby uzyskać więcej informacji na temat korzystania z zabezpieczeń Microsoft Entra ID w Azure Maps, zobacz Zarządzanie uwierzytelnianiem w Azure Maps.

Odpowiedzi

Nazwa	Typ	Opis
200 OK	DailyForecastResult	OK
Other Status Codes	ErrorResponse	Wystąpił nieoczekiwany błąd.

Zabezpieczenia

AADToken

Są to przepływy Microsoft Entra OAuth 2.0. Po połączeniu z dostępem opartym na rolach platformy Azure kontroli może służyć do kontrolowania dostępu do interfejsów API REST usługi Azure Maps. Mechanizmy kontroli dostępu opartej na rolach platformy Azure służą do wyznaczania dostępu do co najmniej jednego konta zasobu usługi Azure Maps lub zasobów podrzędnych. 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.

Notes

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 Maps.

Authorization URL jest specyficzna 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 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 konfigurację opartą na konfiguracji aplikacji w wielu przypadkach użycia.

Aby uzyskać więcej informacji na temat platformy tożsamości firmy Microsoft, zobacz Microsoft identity platform overview.

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

Zakresów

Nazwa	Opis
https://atlas.microsoft.com/.default	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: query

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 daily weather forecast for a given coordinate location

Przykładowe zapytanie

HTTP

GET https://atlas.microsoft.com/weather/forecast/daily/json?api-version=1.1&query=62.6490341,30.0734812&duration=5

Przykładowa odpowiedź

Kod stanu:: 200

{
  "summary": {
    "startDate": "2019-11-17T09:00:00-08:00",
    "endDate": "2019-11-17T15:00:00-08:00",
    "severity": 5,
    "phrase": "Rain Sunday evening",
    "category": "rain"
  },
  "forecasts": [
    {
      "date": "2019-11-13T21:00:00-08:00",
      "temperature": {
        "minimum": {
          "value": 0.8,
          "unit": "C",
          "unitType": 17
        },
        "maximum": {
          "value": 5.3,
          "unit": "C",
          "unitType": 17
        }
      },
      "realFeelTemperature": {
        "minimum": {
          "value": -3.4,
          "unit": "C",
          "unitType": 17
        },
        "maximum": {
          "value": 1.3,
          "unit": "C",
          "unitType": 17
        }
      },
      "realFeelTemperatureShade": {
        "minimum": {
          "value": -3.4,
          "unit": "C",
          "unitType": 17
        },
        "maximum": {
          "value": 1.6,
          "unit": "C",
          "unitType": 17
        }
      },
      "hoursOfSun": 1.1,
      "degreeDaySummary": {
        "heating": {
          "value": 15,
          "unit": "C",
          "unitType": 17
        },
        "cooling": {
          "value": 0,
          "unit": "C",
          "unitType": 17
        }
      },
      "airAndPollen": [
        {
          "name": "AirQuality",
          "value": 0,
          "category": "Good",
          "categoryValue": 1,
          "type": "Ozone"
        },
        {
          "name": "Grass",
          "value": 0,
          "category": "Low",
          "categoryValue": 1
        },
        {
          "name": "Mold",
          "value": 0,
          "category": "Low",
          "categoryValue": 1
        },
        {
          "name": "Ragweed",
          "value": 0,
          "category": "Low",
          "categoryValue": 1
        },
        {
          "name": "Tree",
          "value": 0,
          "category": "Low",
          "categoryValue": 1
        },
        {
          "name": "UVIndex",
          "value": 0,
          "category": "Low",
          "categoryValue": 1
        }
      ],
      "day": {
        "iconCode": 12,
        "iconPhrase": "Showers",
        "hasPrecipitation": true,
        "precipitationType": "Rain",
        "precipitationIntensity": "Light",
        "shortPhrase": "Cloudy with a few showers",
        "longPhrase": "Cloudy with a couple of showers, mainly later",
        "precipitationProbability": 75,
        "thunderstormProbability": 20,
        "rainProbability": 75,
        "snowProbability": 40,
        "iceProbability": 0,
        "wind": {
          "direction": {
            "degrees": 160,
            "localizedDescription": "SSE"
          },
          "speed": {
            "value": 16.7,
            "unit": "km/h",
            "unitType": 7
          }
        },
        "windGust": {
          "direction": {
            "degrees": 160,
            "localizedDescription": "SSE"
          },
          "speed": {
            "value": 48.2,
            "unit": "km/h",
            "unitType": 7
          }
        },
        "totalLiquid": {
          "value": 6.1,
          "unit": "mm",
          "unitType": 3
        },
        "rain": {
          "value": 6.1,
          "unit": "mm",
          "unitType": 3
        },
        "snow": {
          "value": 0,
          "unit": "cm",
          "unitType": 4
        },
        "ice": {
          "value": 0,
          "unit": "mm",
          "unitType": 3
        },
        "hoursOfPrecipitation": 3.5,
        "hoursOfRain": 3.5,
        "hoursOfSnow": 0,
        "hoursOfIce": 0,
        "cloudCover": 100
      },
      "night": {
        "iconCode": 12,
        "iconPhrase": "Showers",
        "hasPrecipitation": true,
        "precipitationType": "Rain",
        "precipitationIntensity": "Light",
        "shortPhrase": "Breezy early; cloudy",
        "longPhrase": "Breezy this evening; otherwise, low clouds",
        "precipitationProbability": 65,
        "thunderstormProbability": 0,
        "rainProbability": 64,
        "snowProbability": 40,
        "iceProbability": 0,
        "wind": {
          "direction": {
            "degrees": 181,
            "localizedDescription": "S"
          },
          "speed": {
            "value": 20.4,
            "unit": "km/h",
            "unitType": 7
          }
        },
        "windGust": {
          "direction": {
            "degrees": 170,
            "localizedDescription": "S"
          },
          "speed": {
            "value": 42.6,
            "unit": "km/h",
            "unitType": 7
          }
        },
        "totalLiquid": {
          "value": 4,
          "unit": "mm",
          "unitType": 3
        },
        "rain": {
          "value": 4,
          "unit": "mm",
          "unitType": 3
        },
        "snow": {
          "value": 0,
          "unit": "cm",
          "unitType": 4
        },
        "ice": {
          "value": 0,
          "unit": "mm",
          "unitType": 3
        },
        "hoursOfPrecipitation": 2.5,
        "hoursOfRain": 2.5,
        "hoursOfSnow": 0,
        "hoursOfIce": 0,
        "cloudCover": 98
      },
      "sources": [
        "AccuWeather"
      ]
    }
  ]
}

Definicje

Nazwa	Opis
AirAndPollen	Obiekt AirAndPollen dostarcza kompleksowych danych środowiskowych. Identyfikuje różne typy pyłków, takie jak drzewa, trawy, ambrozja i pleśń, a także zanieczyszczenia, w tym PM2.5, PM10, O3, NO2, SO2 i CO. Dodatkowo raportuje indeks UV w skali od 1 do 10, oferuje jakościowe opisy jakości powietrza lub poziomu pyłków oraz zapewnia numeryczne pomiary stężenia zanieczyszczeń lub pyłków w powietrzu. Te szczegółowe informacje pomagają użytkownikom ocenić jakość powietrza i warunki pyłkowe wzdłuż trasy podróży.
DailyForecast	Dostarcza szczegółowe informacje pogodowe na konkretny dzień, takie jak temperatura, wiatr, opady, jakość powietrza oraz wskaźnik UV.
DailyForecastResult
DailyForecastSummary	Podsumowanie głównych warunków dla wnioskowanego okresu. Zwróć uwagę, że podsumowanie może obejmować tylko część okresu.
DayOrNight
DegreeDaySummary
ErrorAdditionalInfo	Dodatkowe informacje o błędzie zarządzania zasobami.
ErrorDetail	Szczegóły błędu.
ErrorResponse	Odpowiedź na błąd
IconCode	Wartość liczbowa reprezentująca obraz, który odpowiada bieżącym warunkom pogodowym opisanym `Phrase` przez właściwość. Aby uzyskać więcej informacji, zobacz Usługi pogodowe w Azure Maps. Może mieć wartość NULL.
JsonFormat	Żądany format odpowiedzi. Obsługiwany jest tylko format `json`.
LocalSource	Informacje o lokalnym dostawcy danych pogodowych.
PrecipitationType	Określa rodzaj opadów. Prawidłowe wartości to Deszcz, Śnieg, Lód lub Mieszanie. Ta właściwość jest uwzględniana w odpowiedzi, gdy wartość dBZ jest większa od zera.
UnitType	Liczba całkowita reprezentująca typ jednostki. Na przykład 17 dla stopni Celsjusza, 18 dla stopni Fahrenheita. Może być używany do przeliczania jednostek. Aby uzyskać pełną listę, zobacz Usługi pogodowe w Azure Maps.
WeatherDataUnit	Określa, że dane mają być zwracane w jednostkach metrycznych lub jednostkach imperialnych. Wartość domyślna to metric.
WeatherUnit	Konkretna wartość danej jednostki związana z pogodą.
WeatherUnitRange	Zwrócone wartości temperatury.
WindDetails	Zwracane są szczegóły wiatru, w tym prędkość i kierunek.
WindDirection	Kierunek wiatru

AirAndPollen

Sprzeciwiać się

Obiekt AirAndPollen dostarcza kompleksowych danych środowiskowych. Identyfikuje różne typy pyłków, takie jak drzewa, trawy, ambrozja i pleśń, a także zanieczyszczenia, w tym PM2.5, PM10, O3, NO2, SO2 i CO. Dodatkowo raportuje indeks UV w skali od 1 do 10, oferuje jakościowe opisy jakości powietrza lub poziomu pyłków oraz zapewnia numeryczne pomiary stężenia zanieczyszczeń lub pyłków w powietrzu. Te szczegółowe informacje pomagają użytkownikom ocenić jakość powietrza i warunki pyłkowe wzdłuż trasy podróży.

Nazwa	Typ	Opis
category	string	Zawiera jednowyrazowy jakościowy opis jakości powietrza lub poziomu pyłków dla okresu prognozy w określonym języku. Ta własność klasyfikuje jakość powietrza lub liczbę pyłków na różne poziomy, takie jak niskie, wysokie, dobre, umiarkowane, niezdrowe, niebezpieczne, dając użytkownikom łatwą do zrozumienia ocenę aktualnych warunków.
categoryValue	integer (int32)	Zapewnia numeryczne przedstawienie jakości powietrza lub poziomu pyłków. Ta wartość odpowiada właściwości jakościowej `category` , oferując precyzyjny sposób ilościowego określenia jakości powietrza lub poziomu pyłków. Wartości te wahają się od 1 do 6, gdzie 1 oznacza dobre warunki, a 6 oznacza warunki niebezpieczne.
name	string	Jeśli chodzi o pyłek: Zwraca nazwę pyłku, takiego jak drzewo, trawa, ambrozia lub pleśń. Jeśli chodzi o zanieczyszczenia: Gdy własność `name` to `AirQuality`, nazwa zanieczyszczenia jest zwracana w tej `type` właściwości. Do ważnych zanieczyszczeń należą: PM2.5, PM10, O3, NO2, SO2 oraz CO. Jeśli chodzi o indeks UV: Gdy własność `name` wynosi `UVIndex`, indeks UV jest zwracany w tej `value` własności. Prawidłowe wartości indeksu UV wahają się od 0 do 11+ i reprezentują intensywność promieniowania ultrafioletowego. Wartości indeksu UV są kategoryzowane następująco: 0-2: Niska 3-5: Umiarkowany 6-7: Wysoka 8-10: Bardzo wysoka 11+: Ekstremalne
type	string	Określa rodzaj mierzonego zanieczyszczenia powietrza. Używa się tylko wtedy, gdy własność `name` jest równa jakości powietrza. Przykładami zanieczyszczeń powietrza są cząstki stałe (PM2.5, PM10), ozon (O3), dwutlenek azotu (NO2), dwutlenek siarki (SO2) oraz tlenek węgla (CO).
value	integer (int32)	Zapewnia numeryczne pomiary stężenia zanieczyszczeń lub pyłku w powietrzu. Ta wartość jest zazwyczaj wyrażana w jednostkach istotnych dla rodzaju mierzonego zanieczyszczenia lub pyłku, takich jak mikrogramy na metr sześcienny (μg/m³) dla cząstek lub części na miliard (ppb) dla gazów, takich jak ozon. Zarówno jakość powietrza, jak i promieniowanie UV są wskaźnikami, więc są niejednostkowe.

DailyForecast

Sprzeciwiać się

Dostarcza szczegółowe informacje pogodowe na konkretny dzień, takie jak temperatura, wiatr, opady, jakość powietrza oraz wskaźnik UV.

Nazwa	Typ	Opis
airAndPollen	AirAndPollen[]	Lista zawierająca zanieczyszczenia, poziom pyłku oraz indeks UV do codziennej prognozy. Każdy element listy zawiera prognozowane ilości i kategorie (np. niskie, wysokie, dobre, umiarkowane, niezdrowe, niebezpieczne), aby ocenić potencjalne zagrożenia zdrowotne.
date	string (date-time)	Data i godzina aktualnego obserwacji, wyświetlane w formacie ISO 8601 (yyyy-mm-ddThh:mm:ss-hh:mm). Na przykład 2025-04-29T07:00:00-07:00.
day	DayOrNight	Dostarcza szczegółowe informacje pogodowe do prognozy pogody na dzień, w tym temperaturę, opady, wiatr i inne kluczowe cechy.
degreeDaySummary	DegreeDaySummary	Zawiera podsumowanie dni temperatur ogrzewania i chłodzenia. Dni w stopniu ogrzewania (HDD) mierzą zapotrzebowanie na energię do ogrzewania budynku, obliczane na podstawie średniej temperatury dziennej poniżej 65°F/18°C. Dni chłodzenia (CDD) mierzą zapotrzebowanie na energię do chłodzenia budynku, obliczane na podstawie średniej temperatury powyżej 65°F/18°C. To podsumowanie pomaga w zarządzaniu energią i planowaniu.
hoursOfSun	number (float)	Zapewnia oczekiwaną liczbę godzin słońca na określony dzień.
night	DayOrNight	Dostarcza szczegółowe informacje pogodowe do prognozy nocnej, w tym temperaturę, opady, wiatr i inne kluczowe cechy.
realFeelTemperature	WeatherUnitRange	Dostarcza wartości temperatury RealFeel™ dla określonego dnia, mierzone w stopniach Celsjusza (C) lub Fahrenheita (F), w zależności od jednostki określonej w żądaniu. Ten wskaźnik, opracowany przez AccuWeather, uwzględnia ponad tuzin czynników, w tym wilgotność, prędkość wiatru, zachmurzenie i intensywność słońca, aby zapewnić kompleksową miarę tego, jak faktycznie wygląda pogoda.
realFeelTemperatureShade	WeatherUnitRange	Dostarcza wartości temperatury RealFeel™ dla określonego dnia w zacienionych miejscach. Ten wskaźnik, opracowany przez AccuWeather, uwzględnia ponad tuzin czynników, w tym wilgotność, prędkość wiatru, zachmurzenie i intensywność słońca, aby dać kompleksową miarę tego, jak pogoda faktycznie wygląda w cieniu.
sources	string[]	Lista źródeł przyczyniających się do danych prognozowych pogody.
temperature	WeatherUnitRange	Podawa prognozowane temperatury maksymalne i minimalne na dzień, w stopniach Celsjusza (C) lub Fahrenheita (F), w zależności od wymagań `unit` w prośbie.

DailyForecastResult

Sprzeciwiać się

Nazwa	Typ	Opis
forecasts	DailyForecast[]	Dane prognozy dla każdego żądanego dnia.
summary	DailyForecastSummary	Podsumowanie głównych warunków dla wnioskowanego okresu. Zwróć uwagę, że podsumowanie może obejmować tylko część okresu.

DailyForecastSummary

Sprzeciwiać się

Podsumowanie głównych warunków dla wnioskowanego okresu. Zwróć uwagę, że podsumowanie może obejmować tylko część okresu.

Nazwa	Typ	Opis
category	string	Zawiera jedno- lub dwuwyrazowe podsumowanie prognozowanych warunków pogodowych, takich jak słoneczne, częściowo pochmurno, deszcz lub śnieg.
endDate	string (date-time)	Data i godzina zakończenia podsumowania prognozy, w formacie ISO 8601 (yyyy-mm-ddThh:mm:ss-hh:mm). Na przykład 2025-04-29T07:00:00-07:00.
phrase	string	Zawiera krótkie tekstowe podsumowanie codziennych warunków pogodowych, przedstawione w podanym języku.
severity	integer (int32)	Wskazuje nasilenie prognozowanej pogody jako liczbę całkowitą. Niższe liczby oznaczają wyższy poziom nasilenia: 0 = Nieznane, 1 = Istotne, 2 = Poważne, 3 = Umiarkowane, 4 = Drobne, 5 = Minimalne, 6 = Nieistotne, 7 = Informacyjne.
startDate	string (date-time)	Data i godzina rozpoczęcia podsumowania prognozy, w formacie ISO 8601 (yyyy-mm-ddThh:mm:ss-hh:mm). Na przykład 2025-04-29T07:00:00-07:00.

DayOrNight

Sprzeciwiać się

Nazwa	Typ	Opis
cloudCover	integer (int32)	Procent reprezentujący zachmurzenie.
hasPrecipitation	boolean	Wartość boolowa wskazująca, czy w określonym czasie spodziewane są opady (deszcz, śnieg, deszcz ze śniegiem lub grad). Zwraca prawdziwe, jeśli spodziewane są opady, w przeciwnym razie jest fałszywe.
hoursOfIce	number (float)	Godziny lodu.
hoursOfPrecipitation	number (float)	Godziny opadów
hoursOfRain	number (float)	Godziny deszczu.
hoursOfSnow	number (float)	Godziny śniegu.
ice	WeatherUnit	Ice
iceProbability	integer (int32)	Procent reprezentujący prawdopodobieństwo wystąpienia lodu. Na przykład "30".
iconCode	IconCode (int32)	Wartość liczbowa reprezentująca obraz, który odpowiada bieżącym warunkom pogodowym opisanym `Phrase` przez właściwość. Aby uzyskać więcej informacji, zobacz Usługi pogodowe w Azure Maps. Może mieć wartość NULL.
iconPhrase	string	Opis frazy ikony. Wyświetlane w określonym języku. Na przykład "Słoneczny".
localSource	LocalSource	Informacje o lokalnym dostawcy danych pogodowych.
longPhrase	string	Fraza opisu prognozy w określonym języku. Azure Maps próbuje utrzymać tę frazę o długości poniżej 100 znaków, ale niektóre języki/zdarzenia pogodowe mogą powodować dłuższą długość frazy, przekraczającą 100 znaków.
precipitationIntensity	string	Opis intensywności.
precipitationProbability	integer (int32)	Procent reprezentujący prawdopodobieństwo wystąpienia opadów. Na przykład "20".
precipitationType	PrecipitationType	Określa rodzaj opadów. Prawidłowe wartości to Deszcz, Śnieg, Lód lub Mieszanie. Ta właściwość jest uwzględniana w odpowiedzi, gdy wartość dBZ jest większa od zera.
rain	WeatherUnit	Rain
rainProbability	integer (int32)	Procent reprezentujący prawdopodobieństwo wystąpienia deszczu. Na przykład "40".
shortPhrase	string	Fraza opisu prognozy w określonym języku. Azure Maps próbuje zachować tę frazę o długości poniżej 30 znaków, ale niektóre języki/zdarzenia pogodowe mogą powodować dłuższą długość frazy, przekraczającą 30 znaków.
snow	WeatherUnit	Snow
snowProbability	integer (int32)	Procent reprezentujący prawdopodobieństwo wystąpienia opadów śniegu. Na przykład "30".
thunderstormProbability	integer (int32)	Procent reprezentujący prawdopodobieństwo wystąpienia burzy. Na przykład "80".
totalLiquid	WeatherUnit	Całkowity płynny ekwiwalent opadów w okresie prognozy.
wind	WindDetails	Zwracane są szczegóły wiatru, w tym prędkość i kierunek.
windGust	WindDetails	Podmuch wiatru. Podmuch wiatru to nagły, krótkotrwały wzrost prędkości wiatru.

DegreeDaySummary

Sprzeciwiać się

Nazwa	Typ	Opis
cooling	WeatherUnit	Liczba stopni, w których średnia temperatura przekracza 65 stopni F/ 18 stopni C.
heating	WeatherUnit	Liczba stopni, w których średnia temperatura jest niższa niż 65 stopni F/ 18 stopni C.

ErrorAdditionalInfo

Sprzeciwiać się

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

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

ErrorDetail

Sprzeciwiać się

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

Sprzeciwiać się

Odpowiedź na błąd

Nazwa	Typ	Opis
error	ErrorDetail	Obiekt błędu.

IconCode

Wyliczenie

Wartość liczbowa reprezentująca obraz, który odpowiada bieżącym warunkom pogodowym opisanym Phrase przez właściwość. Aby uzyskać więcej informacji, zobacz Usługi pogodowe w Azure Maps. Może mieć wartość NULL.

Wartość	Opis
1	Sunny
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)
9
10
11	Fog
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	Rain
19	Flurries
20	Głównie pochmurne z Flurries
21	Częściowo słonecznie z flurries
22	Snow
23	Głównie pochmurne z śniegiem
24	Ice
25	Sleet
26	Marznący deszcz
27
28
29	Deszcz i śnieg
30	Hot
31	Cold
32	Windy
33	Clear
34	W większości jasne
35	Deszcz
36	Przerywane chmury (noc)
37	Mgliste światło księżyca
38	Przeważnie pochmurno (noc)
39	Częściowo pochmurne z prysznicami
40	Przeważnie pochmurno z przelotnymi opadami deszczu (noc)
41	Częściowo pochmurne z burzemi
42	Przeważnie pochmurno z burzami (noc)
43	Przeważnie pochmurno z burzami (noc)
44	Przeważnie pochmurno ze śniegiem (noc)

JsonFormat

Wyliczenie

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

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

LocalSource

Sprzeciwiać się

Informacje o lokalnym dostawcy danych pogodowych.

Nazwa	Typ	Opis
id	integer (int32)	Identyfikator numeryczny, unikatowy dla lokalnego dostawcy danych.
name	string	Nazwa lokalnego dostawcy danych. Nazwa jest wyświetlana w języku określonym przez kod języka w adresie URL, jeśli jest dostępny. W przeciwnym razie nazwa jest wyświetlana w języku angielskim lub w języku, w którym nazwa została podana.
weatherCode	string	Kod pogodowy dostarczony przez lokalnego dostawcę danych. Ten kod pogody umożliwia dopasowanie prognozy do ikon dostarczonych przez lokalnego dostawcę danych zamiast ikon Azure Maps.

PrecipitationType

Wyliczenie

Określa rodzaj opadów. Prawidłowe wartości to Deszcz, Śnieg, Lód lub Mieszanie. Ta właściwość jest uwzględniana w odpowiedzi, gdy wartość dBZ jest większa od zera.

Wartość	Opis
Ice	Ice
Mix	Mix
Rain	Rain
Snow	Snow

UnitType

Wyliczenie

Liczba całkowita reprezentująca typ jednostki. Na przykład 17 dla stopni Celsjusza, 18 dla stopni Fahrenheita. Może być używany do przeliczania jednostek. Aby uzyskać pełną listę, zobacz 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	Celsius
18	Fahrenheit
19	kelvin
20	percent
21	float
22	liczba całkowita
31	MicrogramsPerCubicMeterOfAir

WeatherDataUnit

Wyliczenie

Określa, że dane mają być zwracane w jednostkach metrycznych lub jednostkach imperialnych. Wartość domyślna to metric.

Wartość	Opis
imperial	Zwracaj dane przy użyciu jednostek imperialnych, takich jak stopnie Fahrenheita (F) dla temperatury i mila (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.

WeatherUnit

Sprzeciwiać się

Konkretna wartość danej jednostki związana z pogodą.

Nazwa	Typ	Opis
unit	string	Typ jednostki dla zwracanej wartości.
unitType	UnitType (int32)	Liczba całkowita reprezentująca typ jednostki. Na przykład 17 dla stopni Celsjusza, 18 dla stopni Fahrenheita. Może być używany do przeliczania jednostek. Aby uzyskać pełną listę, zobacz Usługi pogodowe w Azure Maps.
value	number (float)	Wartość zaokrąglona.

WeatherUnitRange

Sprzeciwiać się

Zwrócone wartości temperatury.

Nazwa	Typ	Opis
maximum	WeatherUnit	Maksymalna temperatura w danym okresie czasu
minimum	WeatherUnit	Minimalna temperatura dla tego okresu.

WindDetails

Sprzeciwiać się

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

Sprzeciwiać się

Kierunek wiatru

Nazwa	Typ	Opis
degrees	integer (int32)	Kierunek wiatru w stopniach azymutu, rozpoczynający się na prawdziwej północy i kontynuujący w kierunku zgodnym 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 od 0 do 359.
localizedDescription	string	Skrót kierunku w określonym języku.

Udostępnij przez

Weather - Get Daily Forecast

Parametry identyfikatora URI

Nagłówek żądania

Odpowiedzi

Zabezpieczenia

AADToken

Notes

Zakresów

subscription-key

SAS Token

Przykłady

Successfully retrieve detailed daily weather forecast for a given coordinate location

Przykładowe zapytanie

Przykładowa odpowiedź

Definicje

AirAndPollen

DailyForecast

DailyForecastResult

DailyForecastSummary

DayOrNight

DegreeDaySummary

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

IconCode

JsonFormat

LocalSource

PrecipitationType

UnitType

WeatherDataUnit

WeatherUnit

WeatherUnitRange

WindDetails

WindDirection