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.

GET {endpoint}/weather/forecast/daily/json?api-version=1.1&query={query}
Z parametrami opcjonalnymi: 
GET {endpoint}/weather/forecast/daily/json?api-version=1.1&query={query}&unit={unit}&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.
duration
 query

integer (int32)

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.
  • 45 - Zwróć dane prognozy na następne 45 dni.
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

DailyForecastResult

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

Przykładowe żądanie

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

Definicje

Nazwa Opis
AirAndPollen

Jeden wpis opisujący DailyForecast.airAndPollen pojedynczy wskaźnik pyłku, jakości powietrza lub indeksu UV na dany dzień. Właściwość określa, name jaki rodzaj wskaźnika reprezentuje wpis:

  • Pyłek: name to drzewo, trawa, ambrozia lub pleśń. valuedaje prognozowaną kwotę i ocenia category / categoryValue ją od Niskiej do Wysokiej.
  • Jakość powietrza: name to jakość powietrza i identyfikuje type mierzony zanieczyszczenie ( PM2.5, PM10, O3, NO2, SO2 lub CO). category / categoryValue Oceniaj jakość powietrza od Dobrej do Niebezpiecznej.
  • Indeks UV: name to UVIndex. value to indeks UV (od 0 do 11+) i oceniają category / categoryValue ryzyko narażenia od Niskiego do Ekstremalnego.

category to jakościowa etykieta dla wskaźnika, a categoryValue to odpowiadająca ocena 1-6, gdzie 1 oznacza najbezpieczniejsze warunki, a 6 najbardziej niebezpieczne.
DailyForecast

Prognoza na jeden dzień kalendarzowy w podanej lokalizacji zwracała jako jeden wpis na dzień w tablicy forecasts w .DailyForecastResult Zawiera zakres temperatur wysokich/niskich w ciągu dnia, zakresy RealFeel (regularne i zacienione), oczekiwane godziny nasłonecznienia, sumy dni ogrzewania/chłodzenia, szereg wskaźników jakości powietrza, pyłków i indeksów UV oraz oddzielne bloki szczegółów dla części dziennej i nocnej (opady, wiatr, zachmurzenie i inne). Tablica wymienia sources dostawców danych przyczyniających się do prognozy.
DailyForecastDetail

Szczegóły prognozy na pół dnia. Ten sam kształt używany jest zarówno dla DailyForecast.day (od wschodu do zachodu słońca), jak i DailyForecast.night (od zachodu do następnego wschodu słońca), więc wszystkie odniesienia do "tego okresu" poniżej oznaczają konkretną część dnia lub nocy – nigdy pełny 24-godzinny dzień. Zawiera ikonę prognozy i frazy, typ / intensywność / prawdopodobieństwa opadów, sumy opadów, godziny opadów, wiatr i zachmurzenie.
DailyForecastResult

Odpowiedź powróciła przez operację Get Daily Forecast, dostarczającą prognozę pogody dzień po dniu dla określonego miejsca. Zawiera górny poziom summary opisujący dominujące warunki i nasilenie dla żądanego okna, a także tablicę forecasts z jednym DailyForecast wpisem dziennie. Liczba zgłoszeń odpowiada wymaganym duration (1, 5, 10, 15, 25 lub 45 dni; 25 i 45 wymagają SKU S1).
DailyForecastSummary

Wysoki poziom podsumowania dominujących warunków pogodowych w części lub całości żądanego okna prognozy dziennej. Okno podsumowane może być węższe niż pełne żądanie – na przykład, gdy znaczące warunki pogodowe (takie jak system burzowy) są spodziewane tylko w części okresu – i jest ograniczone przez startDate i endDate. Same warunki opisywane są zarówno jako wolna forma phrase, jedno- lub category dwuwyrazowa etykieta, jak i ocena liczbowa severity .
DegreeDaySummary

Sumy dni ogrzewania i chłodzenia w ciągu jednego dnia służą do oszacowania zapotrzebowania na energię na ogrzewanie lub chłodzenie budynku. Każda wartość to liczba stopni, o które średnia temperatura dnia różni się od wartości wyjściowej 65°F (18°C), w jednostce temperatury podanej w żądaniu – stopnie poniżej tej wartości przyczyniają się do heating, a stopnie powyżej tej wartości do cooling.
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.
LocalSource

Informacje o lokalnym dostawcy danych pogodowych użytych do pozyskiwania prognozy na DailyForecastDetail.localSource. Identyfikuje dostawcę (id, name) i udostępnia natywne weatherCode dane dostawcy, aby aplikacje mogły renderować własny zestaw ikon dostawcy zamiast domyślnych ikon Azure Maps.
PrecipitationType

Określa rodzaj opadów. Wartościowe wartości to Deszcz, Śnieg, Lód lub Mieszanka. Ta właściwość jest uwzględniana w odpowiedzi, gdy wartość dBZ jest większa od zera.
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.
WeatherValueRange

Dostarcza najwyższe i najniższe prognozowane temperatury na określony czas, mierzone w stopniach Celsjusza (°C) lub Fahrenheita (°F), na podstawie jednostki określonej w żądaniu.
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.

AirAndPollen

Objekt

Jeden wpis opisujący DailyForecast.airAndPollen pojedynczy wskaźnik pyłku, jakości powietrza lub indeksu UV na dany dzień. Właściwość określa, name jaki rodzaj wskaźnika reprezentuje wpis:

  • Pyłek: name to drzewo, trawa, ambrozia lub pleśń. valuedaje prognozowaną kwotę i ocenia category / categoryValue ją od Niskiej do Wysokiej.
  • Jakość powietrza: name to jakość powietrza i identyfikuje type mierzony zanieczyszczenie ( PM2.5, PM10, O3, NO2, SO2 lub CO). category / categoryValue Oceniaj jakość powietrza od Dobrej do Niebezpiecznej.
  • Indeks UV: name to UVIndex. value to indeks UV (od 0 do 11+) i oceniają category / categoryValue ryzyko narażenia od Niskiego do Ekstremalnego.

category to jakościowa etykieta dla wskaźnika, a categoryValue to odpowiadająca ocena 1-6, gdzie 1 oznacza najbezpieczniejsze warunki, a 6 najbardziej niebezpieczne.

Nazwa Typ Opis
category

string

Krótka jakościowa etykieta wskaźnika, zwracana w języku określonym w żądaniu. Możliwe wartości zależą od name:

  • Pyłek: niski, umiarkowany, wysoki lub bardzo wysoki.
  • Jakość powietrza: dobra, umiarkowana, niezdrowa dla wrażliwych grup, niezdrowa, bardzo niezdrowalub niebezpieczna.
  • Indeks UV: niski, umiarkowany, wysoki, bardzo wysoki lub ekstremalny.
categoryValue

integer (int32)

Ocena liczbowa 1-6, która łączy się z category, gdzie 1 oznacza najbezpieczniejsze warunki, a 6 najbardziej niebezpieczne. Używaj tego, gdy potrzebna jest stabilna, niezależna od języka wartość liczbowa zamiast zlokalizowanej category etykiety.
name

string

Wskazuje, który wskaźnik reprezentuje ten wpis. To albo nazwa źródła pyłku (drzewo, trawa, ambrozja lub pleśń), jakość powietrza (w takim przypadku type identyfikacja zanieczyszczenia) lub UVIndex.
type

string

Kiedy namejest AirQuality, czyli konkretny zanieczyszczenie mierzony

  • jeden z PM2.5, PM10, O3 (ozon), NO2 (dwutlenek azotu), SO2 (dwutlenek siarki) lub CO (tlenek węgla). Nie zwraca się do wpisów o pyłkach ani indeksie UV.
value

integer (int32)

Pomiar numeryczny dla tego wskaźnika. Jednostka zależy od name:

  • Dla pyłku prognozowana liczba pyłków.
  • Jeśli chodzi o jakość powietrza, stężenie zanieczyszczeń jest wynoszone w jednostkach odpowiednich dla zanieczyszczenia – zazwyczaj mikrogramach na metr sześcienny (μg/m³) dla cząstek i częściach na miliard (ppb) dla gazów, takich jak ozon.
  • Dla indeksu UV wartość indeksu od 0 do 11+.

Zarówno jakość powietrza, jak i wskaźnik UV są same w sobie indeksami, więc podawane są jako liczby bez jednostki.

DailyForecast

Objekt

Prognoza na jeden dzień kalendarzowy w podanej lokalizacji zwracała jako jeden wpis na dzień w tablicy forecasts w .DailyForecastResult Zawiera zakres temperatur wysokich/niskich w ciągu dnia, zakresy RealFeel (regularne i zacienione), oczekiwane godziny nasłonecznienia, sumy dni ogrzewania/chłodzenia, szereg wskaźników jakości powietrza, pyłków i indeksów UV oraz oddzielne bloki szczegółów dla części dziennej i nocnej (opady, wiatr, zachmurzenie i inne). Tablica wymienia sources dostawców danych przyczyniających się do prognozy.

Nazwa Typ Opis
airAndPollen

AirAndPollen[]

Prognozowane wskaźniki jakości powietrza, pyłków i wskaźników UV na dzień. Każdy wpis podaje nazwę (np. Drzewo, Trawa, Ambrozja, Pleśń, Jakość powietrza lub UVIndex), wartość liczbową oraz wartość jakościową category (np. Niski,Umiarkowany, Wysoki,Dobry, Niezdrowy lub Niebezpieczny), aby aplikacje mogły wskazać potencjalne zagrożenia zdrowotne.
date

string (date-time)

Data kalendarzowa obejmuje ta prognoza, w formacie ISO 8601 (yyyy-mm-ddThh:mm:ss-hh:mm). Na przykład 2025-04-29T07:00:00-07:00.
day

DailyForecastDetail

Szczegółowa prognoza na część dnia – w tym temperatura, opady, wiatr, zachmurzenie i inne kluczowe cechy.
degreeDaySummary

DegreeDaySummary

Sumy dni ogrzewania i chłodzenia w ciągu dnia, używane do oszacowania zapotrzebowania na energię w budynkach z klimatyzacją.
hoursOfSun

number (float)

Oczekiwana liczba godzin słonecznych w ciągu dnia jest przydatna do planowania aktywności na świeżym powietrzu i oceny ogólnych warunków dziennych.
night

DailyForecastDetail

Szczegółowa prognoza na nocną część dnia – w tym temperatura, opady, wiatr, zachmurzenie i inne kluczowe cechy.
realFeelTemperature

WeatherValueRange

Wartości temperatury RealFeel™ na dzień wynoszą się w stopniach Celsjusza (°C) lub Fahrenheita (°F), w zależności od jednostki podanej w prośbie. 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

WeatherValueRange

Wartości temperatury RealFeel™ na dzień w zacienionych miejscach wynoszą stopnie Celsjusza (°C) lub Fahrenheita (°F), w zależności od jednostki określonej w prośbie. 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.
sources

string[]

Dostawcy danych, którzy przyczynili się do dzisiejszej prognozy.
temperature

WeatherValueRange

Prognozowane temperatury powietrza na dzień w stopniach Celsjusza (°C) lub Fahrenheita (°F), w zależności od jednostki wskazanej w zapytaniu.

DailyForecastDetail

Objekt

Szczegóły prognozy na pół dnia. Ten sam kształt używany jest zarówno dla DailyForecast.day (od wschodu do zachodu słońca), jak i DailyForecast.night (od zachodu do następnego wschodu słońca), więc wszystkie odniesienia do "tego okresu" poniżej oznaczają konkretną część dnia lub nocy – nigdy pełny 24-godzinny dzień. Zawiera ikonę prognozy i frazy, typ / intensywność / prawdopodobieństwa opadów, sumy opadów, godziny opadów, wiatr i zachmurzenie.

Nazwa Typ Opis
cloudCover

integer (int32)

Procent nieba pokrytego chmurami w tym okresie wynosi od 0 (bezchmurne niebo) do 100 (całkowicie zachmurzone). Może mieć wartość NULL.
hasPrecipitation

boolean

true jeśli w tym okresie spodziewane są opady (deszcz, śnieg, śnieg lub grad); false w przeciwnym razie.
hoursOfIce

number (float)

Całkowita liczba godzin w tym okresie, kiedy spodziewane jest powstawanie lodu.
hoursOfPrecipitation

number (float)

Łączna liczba godzin w tym okresie, kiedy spodziewane są opady (deszcz, śnieg, deszcz ze śniegiem lub grad).
hoursOfRain

number (float)

Łączna liczba godzin w tym okresie, kiedy spodziewany jest deszcz.
hoursOfSnow

number (float)

Łączna liczba godzin w tym okresie, kiedy spodziewany jest śnieg.
ice

WeatherValue

Ilość nagromadzenia lodu spodziewana w tym okresie wynosi milimetry (mm) lub cale (cale), w zależności od jednostki określonej w żądaniu.
iceProbability

integer (int32)

Prawdopodobieństwo powstawania lodu w tym okresie, wyrażone w procentach od 0 do 100, gdzie 0 oznacza brak szans na lód, a 100 oznacza pewne warunki lodowe.
iconCode

IconCode

Wartość numeryczna reprezentująca obraz odpowiadający prognozowanym warunkom pogodowym na ten okres, opisanym przez właściwość iconPhrase . 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.
iconPhrase

string

Krótka fraza opisująca ikonę, zwrócona w języku określonym w żądaniu. Na przykład Sunny.
localSource

LocalSource

Informacje o lokalnym dostawcy danych pogodowych, którego kod ikony i kod pogody były używane w tym okresie, gdy wybierano jednego z nich.
longPhrase

string

Dłuższe, bardziej opisowe wyrażenie na ten okres, zwrócone w języku określonym w prośbie. Azure Maps stara się utrzymać tę frazę poniżej 100 znaków, ale niektóre języki lub zjawiska pogodowe mogą generować dłuższy ciąg znaków.
precipitationIntensity

string

Krótki jakościowy opis intensywności opadów w tym okresie – na przykład lekki, umiarkowany lub ciężki. Zwraca w języku określonym w żądaniu i tylko wtedy, gdy hasPrecipitation jest .true
precipitationProbability

integer (int32)

Prawdopodobieństwo wystąpienia opadów w tym okresie, wyrażone w procentach od 0 do 100, gdzie 0 oznacza brak szans na opady, a 100 oznacza pewne opady.
precipitationType

PrecipitationType

Dominującym typem opadów spodziewanym w tym okresie są deszcz, śnieg, lód lub mieszanka. Zwraca się tylko wtedy, gdy hasPrecipitation jest .true
rain

WeatherValue

Ilość opadów spodziewana w tym okresie w milimetrach (mm) lub calach (in), w zależności od jednostki określonej w żądaniu.
rainProbability

integer (int32)

Prawdopodobieństwo deszczu w tym okresie, wyrażone w procentach od 0 do 100, gdzie 0 oznacza brak szansy na deszcz, a 100 oznacza pewny deszcz.
shortPhrase

string

Krótkie wyrażenie opisujące prognozę na ten okres, zwrócone w języku podanym w żądaniu. Azure Maps stara się utrzymać tę frazę poniżej 30 znaków, ale niektóre języki lub zjawiska pogodowe mogą generować dłuższy ciąg znaków.
snow

WeatherValue

Ilość opadu śniegu spodziewana w tym okresie w centymetrach (cm) lub calach (in), w zależności od jednostki określonej w żądaniu.
snowProbability

integer (int32)

Prawdopodobieństwo wystąpienia śniegu w tym okresie, wyrażone w procentach od 0 do 100, gdzie 0 oznacza brak szans na śnieg, a 100 oznacza pewność śniegu na pewno.
thunderstormProbability

integer (int32)

Prawdopodobieństwo burzy w tym okresie, wyrażone w procentach od 0 do 100, gdzie 0 oznacza brak szans na burzę, a 100 oznacza pewność burzy.
totalLiquid

WeatherValue

Całkowita ilość opadów ciekłych (takich jak deszcz, plus odpowiednik cieczy jakiegokolwiek śniegu lub lodu) spodziewana w tym okresie, w milimetrach (mm) lub calach (in), w zależności od jednostki określonej w żądaniu.
wind

WindDetails

Prognozowana prędkość i kierunek wiatru na ten okres. Prędkość wiatru wynosi w kilometrach na godzinę (km/h) lub milach na godzinę (mph), w zależności od jednostki określonej w zapytaniu. Kierunek wiatru mierzy się w stopniach azymutu, od 0° (prawdziwa północ) do 359°, poruszając się zgodnie z ruchem wskazówek zegara – wschód 90°, południe 180°, zachód 270°.
windGust

WindDetails

Oczekiwana maksymalna prędkość i kierunek krótkiego wiatru w tym okresie. Podmuchy wiatru to nagłe, krótkotrwałe przyrosty prędkości wiatru, które mają znaczenie przy takich aktywnościach jak lotnictwo, żeglowanie czy puszczanie latawców. Prędkość wynosi w kilometrach na godzinę (km/h) lub milach na godzinę (mph), w zależności od jednostki określonej w żądaniu, a kierunek stosuje tę samą konwencję azymutową co wind.

DailyForecastResult

Objekt

Odpowiedź powróciła przez operację Get Daily Forecast, dostarczającą prognozę pogody dzień po dniu dla określonego miejsca. Zawiera górny poziom summary opisujący dominujące warunki i nasilenie dla żądanego okna, a także tablicę forecasts z jednym DailyForecast wpisem dziennie. Liczba zgłoszeń odpowiada wymaganym duration (1, 5, 10, 15, 25 lub 45 dni; 25 i 45 wymagają SKU S1).

Nazwa Typ Opis
forecasts

DailyForecast[]

Prognozy na dzień, w kolejności chronologicznej z jednym wpisem dziennie w żądanym duration. Każdy wpis to DailyForecast raport o temperaturach wysokich/niskich w ciągu dnia, zakresie RealFeel, godzinach słonecznych, sumach dni w ciągu ogrzewania/chłodzenia, indeksach powietrza i pyłków, oddzielnych blokach szczegółowych dnia i nocy (opady, wiatr, zachmurzenie i inne) oraz źródłach danych wchodzących w prognozę.
summary

DailyForecastSummary

Wysoki poziom podsumowania dominujących warunków pogodowych w żądanym oknie prognozowym. Podsumowanie może obejmować tylko część okna

  • na przykład, gdy podczas części tego okresu – a nie całego okresu – spodziewana jest znacząca pogoda (np. system burzowy).

DailyForecastSummary

Objekt

Wysoki poziom podsumowania dominujących warunków pogodowych w części lub całości żądanego okna prognozy dziennej. Okno podsumowane może być węższe niż pełne żądanie – na przykład, gdy znaczące warunki pogodowe (takie jak system burzowy) są spodziewane tylko w części okresu – i jest ograniczone przez startDate i endDate. Same warunki opisywane są zarówno jako wolna forma phrase, jedno- lub category dwuwyrazowa etykieta, jak i ocena liczbowa severity .

Nazwa Typ Opis
category

string

Jedno- lub dwuwyrazowa etykieta kategoryzująca dominujące warunki pogodowe dla podsumowanego okna – na przykład: Słonecznie, Częściowo Pochmurno, Deszcz lub Śnieg.
endDate

string (date-time)

Koniec okna opisanego w tym podsumowaniu, w formacie RFC 3339 – na przykład 2019-10-29T07:00:00-08:00. Może nastąpić wcześniej niż koniec żądanego okna prognozy, jeśli podsumowane zdarzenie kończy się przed nim.
phrase

string

Krótkie, swobodne podsumowanie tekstowe dominujących warunków pogodowych dla podsumowanego okna, zwrócone w języku wskazanym w żądaniu. Na przykład, spodziewaj się opadów od wtorku do czwartku.
severity

integer (int32)

Numeryczna ocena nasilenia dla podsumowanego zdarzenia pogodowego. Niższe wartości (z wyłączeniem 0) wskazują na wyższą nasilenie:

  • 0: Nieznany
  • 1: Znaczące
  • 2: Major
  • 3: Umiarkowana
  • 4: Minor
  • 5: Minimalne
  • 6: Nieistotny
  • 7: Informacyjne
startDate

string (date-time)

Początek okna objętego tym podsumowaniem, w formacie RFC 3339 – na przykład 2019-10-27T19:39:57-08:00. Może nastąpić później niż początek żądanego okna prognozy, jeśli podsumowane zdarzenie rozpocznie się w jego trakcie.

DegreeDaySummary

Objekt

Sumy dni ogrzewania i chłodzenia w ciągu jednego dnia służą do oszacowania zapotrzebowania na energię na ogrzewanie lub chłodzenie budynku. Każda wartość to liczba stopni, o które średnia temperatura dnia różni się od wartości wyjściowej 65°F (18°C), w jednostce temperatury podanej w żądaniu – stopnie poniżej tej wartości przyczyniają się do heating, a stopnie powyżej tej wartości do cooling.

Nazwa Typ Opis
cooling

WeatherValue

Dni chłodzenia (CDD) – liczba stopni, o których średnia temperatura dnia przekracza 65°F (18°C). Wyższe wartości oznaczają większe zapotrzebowanie na chłodzenie. Podawane w stopniach Celsjusza (°C) lub Fahrenheita (°F), w zależności od jednostki określonej w żądaniu.
heating

WeatherValue

Dni stopni ogrzewania (HDD) – liczba stopni, w których średnia temperatura dnia spada poniżej 65°F (18°C) bazowej. Wyższe wartości oznaczają większe zapotrzebowanie na ciepło. Podawane w stopniach Celsjusza (°C) lub Fahrenheita (°F), w zależności od jednostki określonej w żądaniu.

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

LocalSource

Objekt

Informacje o lokalnym dostawcy danych pogodowych użytych do pozyskiwania prognozy na DailyForecastDetail.localSource. Identyfikuje dostawcę (id, name) i udostępnia natywne weatherCode dane dostawcy, aby aplikacje mogły renderować własny zestaw ikon dostawcy zamiast domyślnych ikon Azure Maps.

Nazwa Typ Opis
id

integer (int32)

Identyfikator numeryczny, który jednoznacznie identyfikuje lokalnego dostawcę danych.
name

string

Nazwa lokalnego dostawcy danych, zwracana w języku wskazanym w żądaniu, gdy jest dostępna; w przeciwnym razie zwracana w języku angielskim lub w języku, w którym dostarczony przez dostawcę.
weatherCode

string

Kod pogodowy dla dostawcy jest odpowiedni do mapowania na własny zestaw ikon dostawcy zamiast domyślnych Azure MapsiconCode.

PrecipitationType

Wyliczenie

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

Wartość Opis
Ice

Lód
Mix

Mix
Rain

Deszcz
Snow

Snow

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.

WeatherValueRange

Objekt

Dostarcza najwyższe i najniższe prognozowane temperatury na określony czas, mierzone w stopniach Celsjusza (°C) lub Fahrenheita (°F), na podstawie jednostki określonej w żądaniu.

Nazwa Typ Opis
maximum

WeatherValue

Podawa maksymalną temperaturę dla określonego okresu, mierzoną w stopniach Celsjusza (°C) lub Fahrenheita (°F), na podstawie jednostki określonej w żądaniu.
minimum

WeatherValue

Określa minimalną temperaturę na określony okres, mierzoną w stopniach Celsjusza (°C) lub Fahrenheita (°F), na podstawie jednostki określonej w żądaniu.

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.