Weather - Get Hourly Forecast
Umożliwia korzystanie z wyszukiwarki i umożliwia uzyskanie szczegółowej godzinowej prognozy pogody na okres do 24 godzin lub prognozy dziennej na okres do 10 dni.
Interfejs Get Hourly Forecast API to protokół HTTP GET , który żąda szczegółowej prognozy pogody co godzinę na następne 1, 12, 24 (1 dzień), 72 (3 dni), 120 (5 dni) i 240 godzin (10 dni) dla danej lokalizacji współrzędnych. Interfejs API zwraca szczegółowe informacje, takie jak temperatura, wilgotność, wiatr, opady i indeks ultrafioletu (UV). Aby uzyskać więcej informacji, zobacz Żądanie danych godzinowej prognozy pogody.
GET {endpoint}/weather/forecast/hourly/json?api-version=1.1&query={query}
GET {endpoint}/weather/forecast/hourly/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 |
|
format
|
path | True |
Żądany format odpowiedzi. Obsługiwany jest tylko format |
|
|
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) |
Ramy czasowe zwróconej prognozy pogody. Domyślnie zostaną zwrócone dane prognozy na następną godzinę. Dostępne wartości to
|
|
|
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 |
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 |
Żądanie zakończyło się pomyślnie. |
|
| Other Status Codes |
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-idw 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 URLjest 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 weather forecast by the hour
Przykładowe żądanie
GET https://atlas.microsoft.com/weather/forecast/hourly/json?api-version=1.1&query=47.632346,-122.138874&duration=12
Przykładowa odpowiedź
{
"forecasts": [
{
"ceiling": {
"unit": "m",
"unitType": 5,
"value": 3901
},
"cloudCover": 100,
"date": "2019-11-14T16:00:00-08:00",
"dewPoint": {
"unit": "C",
"unitType": 17,
"value": 8.4
},
"hasPrecipitation": false,
"ice": {
"unit": "mm",
"unitType": 3,
"value": 0
},
"iceProbability": 0,
"iconCode": 7,
"iconPhrase": "Cloudy",
"isDaylight": true,
"precipitationProbability": 39,
"rain": {
"unit": "mm",
"unitType": 3,
"value": 0
},
"rainProbability": 39,
"realFeelTemperature": {
"unit": "C",
"unitType": 17,
"value": 14.1
},
"relativeHumidity": 72,
"snow": {
"unit": "cm",
"unitType": 4,
"value": 0
},
"snowProbability": 0,
"temperature": {
"unit": "C",
"unitType": 17,
"value": 13.4
},
"totalLiquid": {
"unit": "mm",
"unitType": 3,
"value": 0
},
"uvIndex": 0,
"uvIndexPhrase": "Low",
"visibility": {
"unit": "km",
"unitType": 6,
"value": 16.1
},
"wetBulbTemperature": {
"unit": "C",
"unitType": 17,
"value": 10.9
},
"wind": {
"direction": {
"degrees": 311,
"localizedDescription": "NW"
},
"speed": {
"unit": "km/h",
"unitType": 7,
"value": 3.7
}
},
"windGust": {
"speed": {
"unit": "km/h",
"unitType": 7,
"value": 5.6
}
}
},
{
"ceiling": {
"unit": "m",
"unitType": 5,
"value": 4054
},
"cloudCover": 94,
"date": "2019-11-14T17:00:00-08:00",
"dewPoint": {
"unit": "C",
"unitType": 17,
"value": 7.8
},
"hasPrecipitation": false,
"ice": {
"unit": "mm",
"unitType": 3,
"value": 0
},
"iceProbability": 0,
"iconCode": 7,
"iconPhrase": "Cloudy",
"isDaylight": false,
"precipitationProbability": 34,
"rain": {
"unit": "mm",
"unitType": 3,
"value": 0
},
"rainProbability": 34,
"realFeelTemperature": {
"unit": "C",
"unitType": 17,
"value": 12.8
},
"relativeHumidity": 73,
"snow": {
"unit": "cm",
"unitType": 4,
"value": 0
},
"snowProbability": 0,
"temperature": {
"unit": "C",
"unitType": 17,
"value": 12.5
},
"totalLiquid": {
"unit": "mm",
"unitType": 3,
"value": 0
},
"uvIndex": 0,
"uvIndexPhrase": "Low",
"visibility": {
"unit": "km",
"unitType": 6,
"value": 16.1
},
"wetBulbTemperature": {
"unit": "C",
"unitType": 17,
"value": 10.2
},
"wind": {
"direction": {
"degrees": 281,
"localizedDescription": "W"
},
"speed": {
"unit": "km/h",
"unitType": 7,
"value": 5.6
}
},
"windGust": {
"speed": {
"unit": "km/h",
"unitType": 7,
"value": 7.4
}
}
},
{
"ceiling": {
"unit": "m",
"unitType": 5,
"value": 4176
},
"cloudCover": 94,
"date": "2019-11-14T18:00:00-08:00",
"dewPoint": {
"unit": "C",
"unitType": 17,
"value": 7.4
},
"hasPrecipitation": false,
"ice": {
"unit": "mm",
"unitType": 3,
"value": 0
},
"iceProbability": 0,
"iconCode": 7,
"iconPhrase": "Cloudy",
"isDaylight": false,
"precipitationProbability": 29,
"rain": {
"unit": "mm",
"unitType": 3,
"value": 0
},
"rainProbability": 29,
"realFeelTemperature": {
"unit": "C",
"unitType": 17,
"value": 11.3
},
"relativeHumidity": 77,
"snow": {
"unit": "cm",
"unitType": 4,
"value": 0
},
"snowProbability": 0,
"temperature": {
"unit": "C",
"unitType": 17,
"value": 11.3
},
"totalLiquid": {
"unit": "mm",
"unitType": 3,
"value": 0
},
"uvIndex": 0,
"uvIndexPhrase": "Low",
"visibility": {
"unit": "km",
"unitType": 6,
"value": 16.1
},
"wetBulbTemperature": {
"unit": "C",
"unitType": 17,
"value": 9.5
},
"wind": {
"direction": {
"degrees": 206,
"localizedDescription": "SSW"
},
"speed": {
"unit": "km/h",
"unitType": 7,
"value": 7.4
}
},
"windGust": {
"speed": {
"unit": "km/h",
"unitType": 7,
"value": 9.3
}
}
},
{
"ceiling": {
"unit": "m",
"unitType": 5,
"value": 4542
},
"cloudCover": 93,
"date": "2019-11-14T19:00:00-08:00",
"dewPoint": {
"unit": "C",
"unitType": 17,
"value": 7
},
"hasPrecipitation": false,
"ice": {
"unit": "mm",
"unitType": 3,
"value": 0
},
"iceProbability": 0,
"iconCode": 7,
"iconPhrase": "Cloudy",
"isDaylight": false,
"precipitationProbability": 20,
"rain": {
"unit": "mm",
"unitType": 3,
"value": 0
},
"rainProbability": 20,
"realFeelTemperature": {
"unit": "C",
"unitType": 17,
"value": 9.8
},
"relativeHumidity": 79,
"snow": {
"unit": "cm",
"unitType": 4,
"value": 0
},
"snowProbability": 0,
"temperature": {
"unit": "C",
"unitType": 17,
"value": 10.4
},
"totalLiquid": {
"unit": "mm",
"unitType": 3,
"value": 0
},
"uvIndex": 0,
"uvIndexPhrase": "Low",
"visibility": {
"unit": "km",
"unitType": 6,
"value": 16.1
},
"wetBulbTemperature": {
"unit": "C",
"unitType": 17,
"value": 8.8
},
"wind": {
"direction": {
"degrees": 169,
"localizedDescription": "S"
},
"speed": {
"unit": "km/h",
"unitType": 7,
"value": 7.4
}
},
"windGust": {
"speed": {
"unit": "km/h",
"unitType": 7,
"value": 11.1
}
}
},
{
"ceiling": {
"unit": "m",
"unitType": 5,
"value": 4389
},
"cloudCover": 92,
"date": "2019-11-14T20:00:00-08:00",
"dewPoint": {
"unit": "C",
"unitType": 17,
"value": 6.9
},
"hasPrecipitation": false,
"ice": {
"unit": "mm",
"unitType": 3,
"value": 0
},
"iceProbability": 0,
"iconCode": 7,
"iconPhrase": "Cloudy",
"isDaylight": false,
"precipitationProbability": 20,
"rain": {
"unit": "mm",
"unitType": 3,
"value": 0
},
"rainProbability": 20,
"realFeelTemperature": {
"unit": "C",
"unitType": 17,
"value": 9.2
},
"relativeHumidity": 80,
"snow": {
"unit": "cm",
"unitType": 4,
"value": 0
},
"snowProbability": 0,
"temperature": {
"unit": "C",
"unitType": 17,
"value": 10.1
},
"totalLiquid": {
"unit": "mm",
"unitType": 3,
"value": 0
},
"uvIndex": 0,
"uvIndexPhrase": "Low",
"visibility": {
"unit": "km",
"unitType": 6,
"value": 16.1
},
"wetBulbTemperature": {
"unit": "C",
"unitType": 17,
"value": 8.6
},
"wind": {
"direction": {
"degrees": 170,
"localizedDescription": "S"
},
"speed": {
"unit": "km/h",
"unitType": 7,
"value": 9.3
}
},
"windGust": {
"speed": {
"unit": "km/h",
"unitType": 7,
"value": 11.1
}
}
},
{
"ceiling": {
"unit": "m",
"unitType": 5,
"value": 4481
},
"cloudCover": 91,
"date": "2019-11-14T21:00:00-08:00",
"dewPoint": {
"unit": "C",
"unitType": 17,
"value": 7.1
},
"hasPrecipitation": false,
"ice": {
"unit": "mm",
"unitType": 3,
"value": 0
},
"iceProbability": 0,
"iconCode": 7,
"iconPhrase": "Cloudy",
"isDaylight": false,
"precipitationProbability": 20,
"rain": {
"unit": "mm",
"unitType": 3,
"value": 0
},
"rainProbability": 20,
"realFeelTemperature": {
"unit": "C",
"unitType": 17,
"value": 9
},
"relativeHumidity": 82,
"snow": {
"unit": "cm",
"unitType": 4,
"value": 0
},
"snowProbability": 0,
"temperature": {
"unit": "C",
"unitType": 17,
"value": 10.1
},
"totalLiquid": {
"unit": "mm",
"unitType": 3,
"value": 0
},
"uvIndex": 0,
"uvIndexPhrase": "Low",
"visibility": {
"unit": "km",
"unitType": 6,
"value": 16.1
},
"wetBulbTemperature": {
"unit": "C",
"unitType": 17,
"value": 8.8
},
"wind": {
"direction": {
"degrees": 170,
"localizedDescription": "S"
},
"speed": {
"unit": "km/h",
"unitType": 7,
"value": 9.3
}
},
"windGust": {
"speed": {
"unit": "km/h",
"unitType": 7,
"value": 13
}
}
},
{
"ceiling": {
"unit": "m",
"unitType": 5,
"value": 4481
},
"cloudCover": 92,
"date": "2019-11-14T22:00:00-08:00",
"dewPoint": {
"unit": "C",
"unitType": 17,
"value": 7.2
},
"hasPrecipitation": false,
"ice": {
"unit": "mm",
"unitType": 3,
"value": 0
},
"iceProbability": 0,
"iconCode": 7,
"iconPhrase": "Cloudy",
"isDaylight": false,
"precipitationProbability": 20,
"rain": {
"unit": "mm",
"unitType": 3,
"value": 0
},
"rainProbability": 20,
"realFeelTemperature": {
"unit": "C",
"unitType": 17,
"value": 8.5
},
"relativeHumidity": 84,
"snow": {
"unit": "cm",
"unitType": 4,
"value": 0
},
"snowProbability": 0,
"temperature": {
"unit": "C",
"unitType": 17,
"value": 9.8
},
"totalLiquid": {
"unit": "mm",
"unitType": 3,
"value": 0
},
"uvIndex": 0,
"uvIndexPhrase": "Low",
"visibility": {
"unit": "km",
"unitType": 6,
"value": 16.1
},
"wetBulbTemperature": {
"unit": "C",
"unitType": 17,
"value": 8.6
},
"wind": {
"direction": {
"degrees": 174,
"localizedDescription": "S"
},
"speed": {
"unit": "km/h",
"unitType": 7,
"value": 9.3
}
},
"windGust": {
"speed": {
"unit": "km/h",
"unitType": 7,
"value": 13
}
}
},
{
"ceiling": {
"unit": "m",
"unitType": 5,
"value": 3688
},
"cloudCover": 94,
"date": "2019-11-14T23:00:00-08:00",
"dewPoint": {
"unit": "C",
"unitType": 17,
"value": 7
},
"hasPrecipitation": false,
"ice": {
"unit": "mm",
"unitType": 3,
"value": 0
},
"iceProbability": 0,
"iconCode": 7,
"iconPhrase": "Cloudy",
"isDaylight": false,
"precipitationProbability": 20,
"rain": {
"unit": "mm",
"unitType": 3,
"value": 0
},
"rainProbability": 20,
"realFeelTemperature": {
"unit": "C",
"unitType": 17,
"value": 8.5
},
"relativeHumidity": 82,
"snow": {
"unit": "cm",
"unitType": 4,
"value": 0
},
"snowProbability": 0,
"temperature": {
"unit": "C",
"unitType": 17,
"value": 9.8
},
"totalLiquid": {
"unit": "mm",
"unitType": 3,
"value": 0
},
"uvIndex": 0,
"uvIndexPhrase": "Low",
"visibility": {
"unit": "km",
"unitType": 6,
"value": 16.1
},
"wetBulbTemperature": {
"unit": "C",
"unitType": 17,
"value": 8.5
},
"wind": {
"direction": {
"degrees": 175,
"localizedDescription": "S"
},
"speed": {
"unit": "km/h",
"unitType": 7,
"value": 9.3
}
},
"windGust": {
"speed": {
"unit": "km/h",
"unitType": 7,
"value": 13
}
}
},
{
"ceiling": {
"unit": "m",
"unitType": 5,
"value": 2926
},
"cloudCover": 97,
"date": "2019-11-15T00:00:00-08:00",
"dewPoint": {
"unit": "C",
"unitType": 17,
"value": 6.9
},
"hasPrecipitation": false,
"ice": {
"unit": "mm",
"unitType": 3,
"value": 0
},
"iceProbability": 0,
"iconCode": 7,
"iconPhrase": "Cloudy",
"isDaylight": false,
"precipitationProbability": 20,
"rain": {
"unit": "mm",
"unitType": 3,
"value": 0
},
"rainProbability": 20,
"realFeelTemperature": {
"unit": "C",
"unitType": 17,
"value": 8.8
},
"relativeHumidity": 81,
"snow": {
"unit": "cm",
"unitType": 4,
"value": 0
},
"snowProbability": 0,
"temperature": {
"unit": "C",
"unitType": 17,
"value": 10.1
},
"totalLiquid": {
"unit": "mm",
"unitType": 3,
"value": 0
},
"uvIndex": 0,
"uvIndexPhrase": "Low",
"visibility": {
"unit": "km",
"unitType": 6,
"value": 16.1
},
"wetBulbTemperature": {
"unit": "C",
"unitType": 17,
"value": 8.6
},
"wind": {
"direction": {
"degrees": 176,
"localizedDescription": "S"
},
"speed": {
"unit": "km/h",
"unitType": 7,
"value": 9.3
}
},
"windGust": {
"speed": {
"unit": "km/h",
"unitType": 7,
"value": 13
}
}
},
{
"ceiling": {
"unit": "m",
"unitType": 5,
"value": 2164
},
"cloudCover": 99,
"date": "2019-11-15T01:00:00-08:00",
"dewPoint": {
"unit": "C",
"unitType": 17,
"value": 6.8
},
"hasPrecipitation": false,
"ice": {
"unit": "mm",
"unitType": 3,
"value": 0
},
"iceProbability": 0,
"iconCode": 7,
"iconPhrase": "Cloudy",
"isDaylight": false,
"precipitationProbability": 21,
"rain": {
"unit": "mm",
"unitType": 3,
"value": 0
},
"rainProbability": 21,
"realFeelTemperature": {
"unit": "C",
"unitType": 17,
"value": 8.5
},
"relativeHumidity": 81,
"snow": {
"unit": "cm",
"unitType": 4,
"value": 0
},
"snowProbability": 0,
"temperature": {
"unit": "C",
"unitType": 17,
"value": 9.9
},
"totalLiquid": {
"unit": "mm",
"unitType": 3,
"value": 0
},
"uvIndex": 0,
"uvIndexPhrase": "Low",
"visibility": {
"unit": "km",
"unitType": 6,
"value": 16.1
},
"wetBulbTemperature": {
"unit": "C",
"unitType": 17,
"value": 8.5
},
"wind": {
"direction": {
"degrees": 177,
"localizedDescription": "S"
},
"speed": {
"unit": "km/h",
"unitType": 7,
"value": 9.3
}
},
"windGust": {
"speed": {
"unit": "km/h",
"unitType": 7,
"value": 13
}
}
},
{
"ceiling": {
"unit": "m",
"unitType": 5,
"value": 1737
},
"cloudCover": 100,
"date": "2019-11-15T02:00:00-08:00",
"dewPoint": {
"unit": "C",
"unitType": 17,
"value": 6.8
},
"hasPrecipitation": false,
"ice": {
"unit": "mm",
"unitType": 3,
"value": 0
},
"iceProbability": 0,
"iconCode": 7,
"iconPhrase": "Cloudy",
"isDaylight": false,
"precipitationProbability": 21,
"rain": {
"unit": "mm",
"unitType": 3,
"value": 0
},
"rainProbability": 21,
"realFeelTemperature": {
"unit": "C",
"unitType": 17,
"value": 8.5
},
"relativeHumidity": 82,
"snow": {
"unit": "cm",
"unitType": 4,
"value": 0
},
"snowProbability": 0,
"temperature": {
"unit": "C",
"unitType": 17,
"value": 9.8
},
"totalLiquid": {
"unit": "mm",
"unitType": 3,
"value": 0
},
"uvIndex": 0,
"uvIndexPhrase": "Low",
"visibility": {
"unit": "km",
"unitType": 6,
"value": 16.1
},
"wetBulbTemperature": {
"unit": "C",
"unitType": 17,
"value": 8.4
},
"wind": {
"direction": {
"degrees": 172,
"localizedDescription": "S"
},
"speed": {
"unit": "km/h",
"unitType": 7,
"value": 9.3
}
},
"windGust": {
"speed": {
"unit": "km/h",
"unitType": 7,
"value": 13
}
}
},
{
"ceiling": {
"unit": "m",
"unitType": 5,
"value": 1311
},
"cloudCover": 100,
"date": "2019-11-15T03:00:00-08:00",
"dewPoint": {
"unit": "C",
"unitType": 17,
"value": 6.9
},
"hasPrecipitation": false,
"ice": {
"unit": "mm",
"unitType": 3,
"value": 0
},
"iceProbability": 0,
"iconCode": 7,
"iconPhrase": "Cloudy",
"isDaylight": false,
"precipitationProbability": 26,
"rain": {
"unit": "mm",
"unitType": 3,
"value": 0
},
"rainProbability": 26,
"realFeelTemperature": {
"unit": "C",
"unitType": 17,
"value": 8.6
},
"relativeHumidity": 83,
"snow": {
"unit": "cm",
"unitType": 4,
"value": 0
},
"snowProbability": 0,
"temperature": {
"unit": "C",
"unitType": 17,
"value": 9.7
},
"totalLiquid": {
"unit": "mm",
"unitType": 3,
"value": 0
},
"uvIndex": 0,
"uvIndexPhrase": "Low",
"visibility": {
"unit": "km",
"unitType": 6,
"value": 16.1
},
"wetBulbTemperature": {
"unit": "C",
"unitType": 17,
"value": 8.4
},
"wind": {
"direction": {
"degrees": 161,
"localizedDescription": "SSE"
},
"speed": {
"unit": "km/h",
"unitType": 7,
"value": 9.3
}
},
"windGust": {
"speed": {
"unit": "km/h",
"unitType": 7,
"value": 13
}
}
}
]
}
Definicje
| Nazwa | Opis |
|---|---|
|
Error |
Dodatkowe informacje o błędzie zarządzania zasobami. |
|
Error |
Szczegóły błędu. |
|
Error |
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). |
|
Hourly |
Obiekt |
|
Hourly |
Odpowiedź otrzymała operacja Get Hourly Forecast, zawierająca godzinowe prognozy pogody dla określonej lokalizacji. Liczba zwróconych |
|
Icon |
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 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. |
|
Json |
Żądany format odpowiedzi. Obsługiwany jest tylko format |
|
Unit |
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. |
|
Weather |
Określa, czy zwracać dane w jednostkach metrycznych czy imperialnych, z metryką jako domyślną. Przykład:
|
|
Weather |
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. |
|
Wind |
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°. |
|
Wind |
Zawiera szczegóły dotyczące kierunku wiatru, w tym kierunek w stopniach azymutu oraz zlokalizowany skrót kierunku wiatru. |
ErrorAdditionalInfo
Dodatkowe informacje o błędzie zarządzania zasobami.
| Nazwa | Typ | Opis |
|---|---|---|
| info |
Dodatkowe informacje. |
|
| type |
string |
Dodatkowy typ informacji. |
ErrorDetail
Szczegóły błędu.
| Nazwa | Typ | Opis |
|---|---|---|
| additionalInfo |
Dodatkowe informacje o błędzie. |
|
| code |
string |
Kod błędu. |
| details |
Szczegóły błędu. |
|
| message |
string |
Komunikat o błędzie. |
| target |
string |
Element docelowy 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).
| Nazwa | Typ | Opis |
|---|---|---|
| error |
Obiekt błędu. |
HourlyForecast
Obiekt HourlyForecast dostarcza godzinowych informacji o pogodzie, w tym datę i godzinę, oczekiwane i postrzegane temperatury oraz punkt rosy. Obejmuje prędkość i kierunek wiatru, porywy wiatru, wilgotność względną, widoczność oraz prawdopodobieństwo opadów. Wskazuje, czy spodziewane są opady i określa ich rodzaj. Dodatkowe właściwości to indeks UV, procent zachmurzenia oraz wysokość sufitu chmur. Zawiera także kod ikony oraz frazę opisującą warunki pogodowe.
| Nazwa | Typ | Opis |
|---|---|---|
| ceiling |
Wysokość najniższej warstwy chmur nad ziemią, mierzona w stopach lub metrach, zgodnie z jednostką określoną w prośbie. Ten pomiar jest kluczowy dla lotnictwa i prognozowania pogody. |
|
| cloudCover |
integer (int32) |
Procent nieba pokryty chmurami o określonej godzinie. Ta wartość waha się od 0% (bezchmurne niebo) do 100% (całkowicie pochmurne). Może mieć wartość NULL. |
| date |
string (date-time) |
Data i godzina prognozy w formacie RFC 3339 (yyyy-mm-ddThh:mm:ss±hh:mm). Na przykład, 2019-11-14T16:00:00-08:00. |
| dewPoint |
Temperatura, przy której powietrze nasyca się wilgocią i rosą zaczyna się tworzyć. Mierzy się ją w stopniach Fahrenheita (°F) lub Celsjusza (°C), w zależności od podanej jednostki. Ta wartość jest kluczowa dla określenia poziomu wilgotności, ponieważ wyższy punkt rosy oznacza więcej wilgoci w powietrzu, przez co atmosfera jest bardziej wilgotna. |
|
| 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. |
| ice |
Zwroty szacowane nagromadzenie lodu na każdą godzinę w prognozie, mierzone w milimetrach (mm) lub calach (in), w zależności od jednostki określonej w żądaniu. |
|
| iceProbability |
integer (int32) |
Pokazuje prawdopodobieństwo powstawania lodu w określonej godzinie, wyrażone w procentach od 0 do 100. Wartość 0 oznacza brak szans na powstawanie lodu, natomiast 100 oznacza pewną możliwość powstawania lodu. Te informacje pomagają użytkownikom ocenić potencjał powstawania warunków oblodzenia. |
| iconCode |
Wartość numeryczna odpowiadająca obrazowi wyświetlającemu . |
|
| iconPhrase |
string |
Termin opisowy odpowiadający konkretnym warunkom pogodowym, takim jak słoneczne. Jest on powiązany z , |
| isDaylight |
boolean |
Wartość boolowska, która wskazuje, czy w danej godzinie jest światło dzienne. Zwraca prawdę, jeśli jest światło dzienne, w przeciwnym razie fałszywa. |
| precipitationProbability |
integer (int32) |
Pokazuje prawdopodobieństwo opadów w określonej godzinie, wyrażone w procentach od 0 do 100. Wartość 0 oznacza brak szans na opady, natomiast 100 oznacza pewność opadów. Pomaga to użytkownikom ocenić prawdopodobieństwo opadów deszczu, śniegu lub innych opadów. |
| rain |
Zwraca ilość opadów spodziewana w każdej godzinie w prognozie, mierzoną w milimetrach (mm) lub calach (in), w zależności od jednostki określonej w żądaniu. |
|
| rainProbability |
integer (int32) |
Pokazuje prawdopodobieństwo opadów w określonym czasie, wyrażone jako procent od 0 do 100. Wartość 0 oznacza brak szans na deszcz, natomiast 100 oznacza pewny deszcz. |
| realFeelTemperature |
Dostarcza wartości temperatury RealFeel™ dla określonej godziny, 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. Więcej informacji znajdziesz w artykule Jaka jest temperatura AccuWeather RealFeel? |
|
| relativeHumidity |
integer (int32) |
Ilość pary wodnej obecnej w powietrzu wyrażona jako procent maksymalnej ilości wody, jaką powietrze może utrzymać przy tej samej temperaturze. Ta wartość wskazuje, jak blisko jest nasycenie powietrzem wilgocią, co wpływa na to, jak komfortowo lub wilgotno jest środowisko. |
| snow |
Zwraca ilość spodziewanego nagromadzenia śniegu w określonej godzinie, wymierzoną w milimetrach (mm) lub calach (in), w zależności od jednostki wskazanej w żądaniu. |
|
| snowProbability |
integer (int32) |
Pokazuje prawdopodobieństwo wystąpienia śniegu w określonej godzinie, wyrażone w procentach od 0 do 100. Wartość 0 oznacza brak ryzyka śniegu, natomiast 100 oznacza pewność, że śnieg jest pewny. |
| temperature |
Oczekiwana temperatura na określoną godzinę, mierzona w stopniach Celsjusza (°C) lub Fahrenheita (°F), w zależności od jednostki określonej w żądaniu. |
|
| totalLiquid |
Zwraca całkowitą ilość opadów ciekłych (takich jak deszcz) oczekiwaną w każdej godzinie okresu prognozy, wymierzoną w milimetrach (mm) lub calach (in), w zależności od jednostki określonej w żądaniu. |
|
| uvIndex |
integer (int32) |
Dostarcza indeks ultrafioletu (UV) dla każdej godziny okresu prognozy. Ten indeks wskazuje poziom oczekiwanego promieniowania ultrafioletowego, pomagając użytkownikom zrozumieć potencjalne ryzyko ekspozycji na słońce o różnych porach dnia. Obsługiwane wartości to:
|
| uvIndexPhrase |
string |
Zawiera opisowe wyrażenie wskazujące poziom promieniowania UV, takie jak niski, umiarkowany, wysoki lub bardzo wysoki. |
| visibility |
Zwraca odległość, na której obiekt lub światło można wyraźnie rozpoznać dla każdej godziny okresu prognozy, mierzone w kilometrach (km) lub milach (mi), w zależności od jednostki określonej w żądaniu. To pokazuje, jak daleko można wyraźnie widzieć, co jest kluczowe przy takich zajęciach jak jazda samochodem czy lotnictwo. |
|
| wetBulbTemperature |
Zwraca temperaturę, jaką miałaby pojem powietrza, gdyby został schłodzony do nasycenia (100% wilgotności względnej) przez parowanie wody do niego. Ta właściwość jest istotna dla zrozumienia stresu cieplnego i efektu chłodzenia parowania. |
|
| wind |
Dostarcza oczekiwaną prędkość i kierunek wiatru. Prędkość wiatru mierzona jest w kilometrach na godzinę (km/h) lub milach na godzinę (mph), w zależności od określonej jednostki. 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 |
Zwraca oczekiwaną maksymalną prędkość porywu wiatru w każdej godzinie okresu prognozy, mierzoną w kilometrach na godzinę (km/h) lub milach na godzinę (mph), w zależności od podanej jednostki. Kierunek wiatru podawany jest w stopniach azymutu, od 0° (prawdziwa północ) do 359°, poruszając się zgodnie z ruchem wskazówek zegara. Podmuchy wiatru to krótkotrwałe przyrosty prędkości wiatru, ważne dla zrozumienia krótkotrwałych zmian, które mogą wpływać na aktywności takie jak lotnictwo, żeglarstwo czy wydarzenia na świeżym powietrzu. |
HourlyForecastResult
Odpowiedź otrzymała operacja Get Hourly Forecast, zawierająca godzinowe prognozy pogody dla określonej lokalizacji. Liczba zwróconych HourlyForecast zgłoszeń odpowiada żądanemu prognozowanemu czasowi – 1, 12, 24, 48, 72 lub 96 godzin (zobacz HourlyDuration zjednoczenie).
| Nazwa | Typ | Opis |
|---|---|---|
| forecasts |
Prognozy są wpisy godzinowe, po jednym na godzinę w żądanym oknie, w kolejności chronologicznej. Każdy wpis zawiera oczekiwaną temperaturę, RealFeel, punkt rosy, wiatr, prognozę opadów (prawdopodobieństwo i ilości opadów, śniegu i lodu), pokrywę chmur, widoczność, wskaźnik UV, sufit oraz inne obserwacje na daną godzinę. Na przykład czas trwania 12 zwraca 12 wpisów zaczynających się od 2019-11-14T16:00:00-08:00 i przesuwając się o godzinę na raz. |
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.
| 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
Żądany format odpowiedzi. Obsługiwany jest tylko format json.
| Wartość | Opis |
|---|---|
| json |
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.
| 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
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
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 |
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
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 |
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 |
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
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 |