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 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)

Ramy czasowe zwróconej prognozy pogody. Domyślnie zostaną zwrócone dane prognozy na następną godzinę. Dostępne wartości to

  • 1 - Zwracanie danych prognozy na następną godzinę. Wartość domyślna.
  • 12 - Zwróć prognozę godzinową na najbliższe 12 godzin.
  • 24 - Zwróć prognozę godzinową na najbliższe 24 godziny.
  • 72 - Zwróć prognozę godzinową na najbliższe 72 godziny (3 dni).
  • 120 - Zwróć prognozę godzinową na następne 120 godzin (5 dni).
  • 240 - Zwróć prognozę godzinową na następne 240 godzin (10 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

HourlyForecastResult

Żą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 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
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).

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.

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

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.

UnitType

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

WeatherDataUnit

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

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

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

WindDetails

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

WindDirection

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

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

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

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.

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

WeatherValue

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

WeatherValue

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

WeatherValue

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

IconCode

Wartość numeryczna odpowiadająca obrazowi wyświetlającemu .iconPhrase Więcej informacji można znaleźć w Usługi pogodowe w Azure Maps.

iconPhrase

string

Termin opisowy odpowiadający konkretnym warunkom pogodowym, takim jak słoneczne. Jest on powiązany z , iconCodeczyli wartością liczbową reprezentującą obraz wizualnie przedstawiający warunki pogodowe opisane przez .iconPhrase Więcej informacji można znaleźć w Usługi pogodowe w Azure Maps.

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

WeatherValue

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

WeatherValue

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

WeatherValue

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

WeatherValue

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

WeatherValue

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:

  • 0-2: Niskie zagrożenie ze strony promieni UV słonecznych lub przeciętnej osoby.
  • 3-5: Umiarkowane ryzyko uszkodzenia spowodowanego niechronionym słońcem.
  • 6-7: Wysokie ryzyko uszkodzenia spowodowanego niechronionym słońcem.
  • 8-10: Bardzo wysokie ryzyko uszkodzenia spowodowanego niechronionym słońcem.
  • 11+: Ekstremalne ryzyko uszkodzenia spowodowanego niechronionym słońcem.
uvIndexPhrase

string

Zawiera opisowe wyrażenie wskazujące poziom promieniowania UV, takie jak niski, umiarkowany, wysoki lub bardzo wysoki.

visibility

WeatherValue

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

WeatherValue

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

WindDetails

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

WindDetails

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

HourlyForecast[]

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

format wymiany danych notacji obiektów JavaScript

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

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

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

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.