Weather - Get Hourly Forecast

Odwołanie

Usługa:: Maps

Wersja interfejsu API:: 1.1

Użyj polecenia , aby uzyskać szczegółową prognozę pogody godzinową przez maksymalnie 24 godziny lub dzienną prognozę przez maksymalnie 10 dni.

Interfejs Get Hourly Forecast API jest protokołem HTTP GET , który żąda szczegółowej prognozy pogody według godziny dla następnych 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óły, takie jak temperatura, wilgotność, wiatr, opady i indeks ultrafioletowy (UV). Aby uzyskać więcej informacji, zobacz Request hourly weather forecast data (Żądanie danych prognozy pogody godzinowej).

Jeśli używasz warstwy cenowej Gen1 S0, możesz zażądać prognozy godzinowej dla następnych 1, 12, 24 godzin (1 dzień) i 72 godzin (3 dni). Jeśli używasz warstwy cenowej Gen1 S1 lub Gen2, możesz również zażądać prognozy godzinowej dla następnych 120 (5 dni) i 240 godzin (10 dni).

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

Z parametrami opcjonalnymi:

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

Parametry identyfikatora URI

Nazwa	W	Wymagane	Typ	Opis
format	path	True	JsonFormat	Żądany format odpowiedzi. Obsługiwany jest tylko `json` format.
api-version	query	True	string	Numer wersji interfejsu API usługi Azure Maps.
query	query	True	number[]	Odpowiednie zapytanie określone jako ciąg rozdzielany przecinkami składające się z szerokości geograficznej, po której następuje długość geograficzna, np. "47.641268,-122.125679".
duration	query		integer	Przedział czasu zwróconej prognozy pogody. Domyślnie dane prognozy dla następnej godziny zostaną zwrócone. Dostępne wartości to `1` — Zwracanie danych prognozy przez następną godzinę. Wartość domyślna. `12` - Prognoza godzinowa powrotu na następne 12 godzin. `24` - Prognoza godzinowa powrotu na następne 24 godziny. `72` - Prognoza godzinowa zwracana przez następne 72 godziny (3 dni). `120` - Prognoza godzinowa zwracana przez następne 120 godzin (5 dni). Dostępne tylko w jednostce SKU S1. `240` - Prognoza godzinowa powrotu na następne 240 godzin (10 dni). Dostępne tylko w jednostce SKU S1.
language	query		string	Język, w którym powinny być zwracane wyniki wyszukiwania. Powinien być jednym z obsługiwanych tagów języka IETF, bez uwzględniania wielkości liter. Jeśli dane w określonym języku nie są dostępne dla określonego pola, używany jest język domyślny. Aby uzyskać szczegółowe informacje, zapoznaj się z tematem Obsługiwane języki .
unit	query		WeatherDataUnit	Określa, aby zwracać dane w jednostkach metryk lub jednostkach imperialnych. Wartość domyślna to metryka.

Nagłówek żądania

Nazwa	Wymagane	Typ	Opis
x-ms-client-id		string	Określa, które konto jest przeznaczone do użycia w połączeniu z modelem zabezpieczeń Microsoft Entra ID. Reprezentuje unikatowy identyfikator konta usługi Azure Maps i można go pobrać z interfejsu API konta płaszczyzny zarządzania usługi Azure Maps. Aby użyć zabezpieczeń microsoft Entra ID w usłudze Azure Maps, zobacz następujące artykuły , aby uzyskać wskazówki.

Odpowiedzi

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

Zabezpieczenia

AADToken

Są to przepływy protokołu Microsoft Entra OAuth 2.0 . W połączeniu z kontrolą dostępu opartą na rolach platformy Azure może służyć do kontrolowania dostępu do interfejsów API REST usługi Azure Maps. Mechanizmy kontroli dostępu oparte na rolach platformy Azure służą do wyznaczania dostępu do co najmniej jednego konta zasobów usługi Azure Maps lub zasobów podrzędnych. Każdy użytkownik, grupa lub jednostka usługi może 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 pojęć dotyczących uwierzytelniania. Podsumowując, ta definicja zabezpieczeń udostępnia 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.

Uwagi

Ta definicja zabezpieczeń wymaga użycia nagłówka x-ms-client-id , aby wskazać, do którego zasobu usługi Azure Maps aplikacja żąda dostępu. Można to uzyskać za pomocą interfejsu API zarządzania mapami .

Element Authorization URL jest specyficzny dla wystąpienia chmury publicznej platformy Azure. Suwerenne chmury mają unikatowe adresy URL autoryzacji i konfiguracje identyfikatorów entra firmy Microsoft. * Kontrola dostępu oparta na rolach platformy Azure jest konfigurowana z poziomu 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 SDK sieci Web 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 Omówienie platformy tożsamości firmy Microsoft.

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

Zakresy

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

subscription-key

Jest to klucz współużytkowany podczas tworzenia 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 wszystkich interfejsów 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 podejścia do poufnych aplikacji klienckich w celu uzyskania dostępu do interfejsów API REST usługi Azure Maps, aby klucz mógł być bezpiecznie przechowywany.

Typ: apiKey
W: query

SAS Token

Jest to token sygnatury dostępu współdzielonego tworzony na podstawie operacji list SYGNATUR dostępu współdzielonego w 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 oraz 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 bezpieczny niż klucz wspólny.

W przypadku publicznie uwidocznionych aplikacji zalecamy skonfigurowanie określonej listy dozwolonych źródeł w zasobie konta mapy 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

HTTP

GET https://atlas.microsoft.com/weather/forecast/hourly/json?api-version=1.1&query=47.632346,-122.138874&duration=12

Przykładowa odpowiedź

Kod stanu:: 200

{
  "forecasts": [
    {
      "date": "2019-11-14T16:00:00-08:00",
      "iconCode": 7,
      "iconPhrase": "Cloudy",
      "hasPrecipitation": false,
      "isDaylight": true,
      "temperature": {
        "value": 13.4,
        "unit": "C",
        "unitType": 17
      },
      "realFeelTemperature": {
        "value": 14.1,
        "unit": "C",
        "unitType": 17
      },
      "wetBulbTemperature": {
        "value": 10.9,
        "unit": "C",
        "unitType": 17
      },
      "dewPoint": {
        "value": 8.4,
        "unit": "C",
        "unitType": 17
      },
      "wind": {
        "direction": {
          "degrees": 311,
          "localizedDescription": "NW"
        },
        "speed": {
          "value": 3.7,
          "unit": "km/h",
          "unitType": 7
        }
      },
      "windGust": {
        "speed": {
          "value": 5.6,
          "unit": "km/h",
          "unitType": 7
        }
      },
      "relativeHumidity": 72,
      "visibility": {
        "value": 16.1,
        "unit": "km",
        "unitType": 6
      },
      "cloudCover": 100,
      "ceiling": {
        "value": 3901,
        "unit": "m",
        "unitType": 5
      },
      "uvIndex": 0,
      "uvIndexPhrase": "Low",
      "precipitationProbability": 39,
      "rainProbability": 39,
      "snowProbability": 0,
      "iceProbability": 0,
      "totalLiquid": {
        "value": 0,
        "unit": "mm",
        "unitType": 3
      },
      "rain": {
        "value": 0,
        "unit": "mm",
        "unitType": 3
      },
      "snow": {
        "value": 0,
        "unit": "cm",
        "unitType": 4
      },
      "ice": {
        "value": 0,
        "unit": "mm",
        "unitType": 3
      }
    },
    {
      "date": "2019-11-14T17:00:00-08:00",
      "iconCode": 7,
      "iconPhrase": "Cloudy",
      "hasPrecipitation": false,
      "isDaylight": false,
      "temperature": {
        "value": 12.5,
        "unit": "C",
        "unitType": 17
      },
      "realFeelTemperature": {
        "value": 12.8,
        "unit": "C",
        "unitType": 17
      },
      "wetBulbTemperature": {
        "value": 10.2,
        "unit": "C",
        "unitType": 17
      },
      "dewPoint": {
        "value": 7.8,
        "unit": "C",
        "unitType": 17
      },
      "wind": {
        "direction": {
          "degrees": 281,
          "localizedDescription": "W"
        },
        "speed": {
          "value": 5.6,
          "unit": "km/h",
          "unitType": 7
        }
      },
      "windGust": {
        "speed": {
          "value": 7.4,
          "unit": "km/h",
          "unitType": 7
        }
      },
      "relativeHumidity": 73,
      "visibility": {
        "value": 16.1,
        "unit": "km",
        "unitType": 6
      },
      "cloudCover": 94,
      "ceiling": {
        "value": 4054,
        "unit": "m",
        "unitType": 5
      },
      "uvIndex": 0,
      "uvIndexPhrase": "Low",
      "precipitationProbability": 34,
      "rainProbability": 34,
      "snowProbability": 0,
      "iceProbability": 0,
      "totalLiquid": {
        "value": 0,
        "unit": "mm",
        "unitType": 3
      },
      "rain": {
        "value": 0,
        "unit": "mm",
        "unitType": 3
      },
      "snow": {
        "value": 0,
        "unit": "cm",
        "unitType": 4
      },
      "ice": {
        "value": 0,
        "unit": "mm",
        "unitType": 3
      }
    },
    {
      "date": "2019-11-14T18:00:00-08:00",
      "iconCode": 7,
      "iconPhrase": "Cloudy",
      "hasPrecipitation": false,
      "isDaylight": false,
      "temperature": {
        "value": 11.3,
        "unit": "C",
        "unitType": 17
      },
      "realFeelTemperature": {
        "value": 11.3,
        "unit": "C",
        "unitType": 17
      },
      "wetBulbTemperature": {
        "value": 9.5,
        "unit": "C",
        "unitType": 17
      },
      "dewPoint": {
        "value": 7.4,
        "unit": "C",
        "unitType": 17
      },
      "wind": {
        "direction": {
          "degrees": 206,
          "localizedDescription": "SSW"
        },
        "speed": {
          "value": 7.4,
          "unit": "km/h",
          "unitType": 7
        }
      },
      "windGust": {
        "speed": {
          "value": 9.3,
          "unit": "km/h",
          "unitType": 7
        }
      },
      "relativeHumidity": 77,
      "visibility": {
        "value": 16.1,
        "unit": "km",
        "unitType": 6
      },
      "cloudCover": 94,
      "ceiling": {
        "value": 4176,
        "unit": "m",
        "unitType": 5
      },
      "uvIndex": 0,
      "uvIndexPhrase": "Low",
      "precipitationProbability": 29,
      "rainProbability": 29,
      "snowProbability": 0,
      "iceProbability": 0,
      "totalLiquid": {
        "value": 0,
        "unit": "mm",
        "unitType": 3
      },
      "rain": {
        "value": 0,
        "unit": "mm",
        "unitType": 3
      },
      "snow": {
        "value": 0,
        "unit": "cm",
        "unitType": 4
      },
      "ice": {
        "value": 0,
        "unit": "mm",
        "unitType": 3
      }
    },
    {
      "date": "2019-11-14T19:00:00-08:00",
      "iconCode": 7,
      "iconPhrase": "Cloudy",
      "hasPrecipitation": false,
      "isDaylight": false,
      "temperature": {
        "value": 10.4,
        "unit": "C",
        "unitType": 17
      },
      "realFeelTemperature": {
        "value": 9.8,
        "unit": "C",
        "unitType": 17
      },
      "wetBulbTemperature": {
        "value": 8.8,
        "unit": "C",
        "unitType": 17
      },
      "dewPoint": {
        "value": 7,
        "unit": "C",
        "unitType": 17
      },
      "wind": {
        "direction": {
          "degrees": 169,
          "localizedDescription": "S"
        },
        "speed": {
          "value": 7.4,
          "unit": "km/h",
          "unitType": 7
        }
      },
      "windGust": {
        "speed": {
          "value": 11.1,
          "unit": "km/h",
          "unitType": 7
        }
      },
      "relativeHumidity": 79,
      "visibility": {
        "value": 16.1,
        "unit": "km",
        "unitType": 6
      },
      "cloudCover": 93,
      "ceiling": {
        "value": 4542,
        "unit": "m",
        "unitType": 5
      },
      "uvIndex": 0,
      "uvIndexPhrase": "Low",
      "precipitationProbability": 20,
      "rainProbability": 20,
      "snowProbability": 0,
      "iceProbability": 0,
      "totalLiquid": {
        "value": 0,
        "unit": "mm",
        "unitType": 3
      },
      "rain": {
        "value": 0,
        "unit": "mm",
        "unitType": 3
      },
      "snow": {
        "value": 0,
        "unit": "cm",
        "unitType": 4
      },
      "ice": {
        "value": 0,
        "unit": "mm",
        "unitType": 3
      }
    },
    {
      "date": "2019-11-14T20:00:00-08:00",
      "iconCode": 7,
      "iconPhrase": "Cloudy",
      "hasPrecipitation": false,
      "isDaylight": false,
      "temperature": {
        "value": 10.1,
        "unit": "C",
        "unitType": 17
      },
      "realFeelTemperature": {
        "value": 9.2,
        "unit": "C",
        "unitType": 17
      },
      "wetBulbTemperature": {
        "value": 8.6,
        "unit": "C",
        "unitType": 17
      },
      "dewPoint": {
        "value": 6.9,
        "unit": "C",
        "unitType": 17
      },
      "wind": {
        "direction": {
          "degrees": 170,
          "localizedDescription": "S"
        },
        "speed": {
          "value": 9.3,
          "unit": "km/h",
          "unitType": 7
        }
      },
      "windGust": {
        "speed": {
          "value": 11.1,
          "unit": "km/h",
          "unitType": 7
        }
      },
      "relativeHumidity": 80,
      "visibility": {
        "value": 16.1,
        "unit": "km",
        "unitType": 6
      },
      "cloudCover": 92,
      "ceiling": {
        "value": 4389,
        "unit": "m",
        "unitType": 5
      },
      "uvIndex": 0,
      "uvIndexPhrase": "Low",
      "precipitationProbability": 20,
      "rainProbability": 20,
      "snowProbability": 0,
      "iceProbability": 0,
      "totalLiquid": {
        "value": 0,
        "unit": "mm",
        "unitType": 3
      },
      "rain": {
        "value": 0,
        "unit": "mm",
        "unitType": 3
      },
      "snow": {
        "value": 0,
        "unit": "cm",
        "unitType": 4
      },
      "ice": {
        "value": 0,
        "unit": "mm",
        "unitType": 3
      }
    },
    {
      "date": "2019-11-14T21:00:00-08:00",
      "iconCode": 7,
      "iconPhrase": "Cloudy",
      "hasPrecipitation": false,
      "isDaylight": false,
      "temperature": {
        "value": 10.1,
        "unit": "C",
        "unitType": 17
      },
      "realFeelTemperature": {
        "value": 9,
        "unit": "C",
        "unitType": 17
      },
      "wetBulbTemperature": {
        "value": 8.8,
        "unit": "C",
        "unitType": 17
      },
      "dewPoint": {
        "value": 7.1,
        "unit": "C",
        "unitType": 17
      },
      "wind": {
        "direction": {
          "degrees": 170,
          "localizedDescription": "S"
        },
        "speed": {
          "value": 9.3,
          "unit": "km/h",
          "unitType": 7
        }
      },
      "windGust": {
        "speed": {
          "value": 13,
          "unit": "km/h",
          "unitType": 7
        }
      },
      "relativeHumidity": 82,
      "visibility": {
        "value": 16.1,
        "unit": "km",
        "unitType": 6
      },
      "cloudCover": 91,
      "ceiling": {
        "value": 4481,
        "unit": "m",
        "unitType": 5
      },
      "uvIndex": 0,
      "uvIndexPhrase": "Low",
      "precipitationProbability": 20,
      "rainProbability": 20,
      "snowProbability": 0,
      "iceProbability": 0,
      "totalLiquid": {
        "value": 0,
        "unit": "mm",
        "unitType": 3
      },
      "rain": {
        "value": 0,
        "unit": "mm",
        "unitType": 3
      },
      "snow": {
        "value": 0,
        "unit": "cm",
        "unitType": 4
      },
      "ice": {
        "value": 0,
        "unit": "mm",
        "unitType": 3
      }
    },
    {
      "date": "2019-11-14T22:00:00-08:00",
      "iconCode": 7,
      "iconPhrase": "Cloudy",
      "hasPrecipitation": false,
      "isDaylight": false,
      "temperature": {
        "value": 9.8,
        "unit": "C",
        "unitType": 17
      },
      "realFeelTemperature": {
        "value": 8.5,
        "unit": "C",
        "unitType": 17
      },
      "wetBulbTemperature": {
        "value": 8.6,
        "unit": "C",
        "unitType": 17
      },
      "dewPoint": {
        "value": 7.2,
        "unit": "C",
        "unitType": 17
      },
      "wind": {
        "direction": {
          "degrees": 174,
          "localizedDescription": "S"
        },
        "speed": {
          "value": 9.3,
          "unit": "km/h",
          "unitType": 7
        }
      },
      "windGust": {
        "speed": {
          "value": 13,
          "unit": "km/h",
          "unitType": 7
        }
      },
      "relativeHumidity": 84,
      "visibility": {
        "value": 16.1,
        "unit": "km",
        "unitType": 6
      },
      "cloudCover": 92,
      "ceiling": {
        "value": 4481,
        "unit": "m",
        "unitType": 5
      },
      "uvIndex": 0,
      "uvIndexPhrase": "Low",
      "precipitationProbability": 20,
      "rainProbability": 20,
      "snowProbability": 0,
      "iceProbability": 0,
      "totalLiquid": {
        "value": 0,
        "unit": "mm",
        "unitType": 3
      },
      "rain": {
        "value": 0,
        "unit": "mm",
        "unitType": 3
      },
      "snow": {
        "value": 0,
        "unit": "cm",
        "unitType": 4
      },
      "ice": {
        "value": 0,
        "unit": "mm",
        "unitType": 3
      }
    },
    {
      "date": "2019-11-14T23:00:00-08:00",
      "iconCode": 7,
      "iconPhrase": "Cloudy",
      "hasPrecipitation": false,
      "isDaylight": false,
      "temperature": {
        "value": 9.8,
        "unit": "C",
        "unitType": 17
      },
      "realFeelTemperature": {
        "value": 8.5,
        "unit": "C",
        "unitType": 17
      },
      "wetBulbTemperature": {
        "value": 8.5,
        "unit": "C",
        "unitType": 17
      },
      "dewPoint": {
        "value": 7,
        "unit": "C",
        "unitType": 17
      },
      "wind": {
        "direction": {
          "degrees": 175,
          "localizedDescription": "S"
        },
        "speed": {
          "value": 9.3,
          "unit": "km/h",
          "unitType": 7
        }
      },
      "windGust": {
        "speed": {
          "value": 13,
          "unit": "km/h",
          "unitType": 7
        }
      },
      "relativeHumidity": 82,
      "visibility": {
        "value": 16.1,
        "unit": "km",
        "unitType": 6
      },
      "cloudCover": 94,
      "ceiling": {
        "value": 3688,
        "unit": "m",
        "unitType": 5
      },
      "uvIndex": 0,
      "uvIndexPhrase": "Low",
      "precipitationProbability": 20,
      "rainProbability": 20,
      "snowProbability": 0,
      "iceProbability": 0,
      "totalLiquid": {
        "value": 0,
        "unit": "mm",
        "unitType": 3
      },
      "rain": {
        "value": 0,
        "unit": "mm",
        "unitType": 3
      },
      "snow": {
        "value": 0,
        "unit": "cm",
        "unitType": 4
      },
      "ice": {
        "value": 0,
        "unit": "mm",
        "unitType": 3
      }
    },
    {
      "date": "2019-11-15T00:00:00-08:00",
      "iconCode": 7,
      "iconPhrase": "Cloudy",
      "hasPrecipitation": false,
      "isDaylight": false,
      "temperature": {
        "value": 10.1,
        "unit": "C",
        "unitType": 17
      },
      "realFeelTemperature": {
        "value": 8.8,
        "unit": "C",
        "unitType": 17
      },
      "wetBulbTemperature": {
        "value": 8.6,
        "unit": "C",
        "unitType": 17
      },
      "dewPoint": {
        "value": 6.9,
        "unit": "C",
        "unitType": 17
      },
      "wind": {
        "direction": {
          "degrees": 176,
          "localizedDescription": "S"
        },
        "speed": {
          "value": 9.3,
          "unit": "km/h",
          "unitType": 7
        }
      },
      "windGust": {
        "speed": {
          "value": 13,
          "unit": "km/h",
          "unitType": 7
        }
      },
      "relativeHumidity": 81,
      "visibility": {
        "value": 16.1,
        "unit": "km",
        "unitType": 6
      },
      "cloudCover": 97,
      "ceiling": {
        "value": 2926,
        "unit": "m",
        "unitType": 5
      },
      "uvIndex": 0,
      "uvIndexPhrase": "Low",
      "precipitationProbability": 20,
      "rainProbability": 20,
      "snowProbability": 0,
      "iceProbability": 0,
      "totalLiquid": {
        "value": 0,
        "unit": "mm",
        "unitType": 3
      },
      "rain": {
        "value": 0,
        "unit": "mm",
        "unitType": 3
      },
      "snow": {
        "value": 0,
        "unit": "cm",
        "unitType": 4
      },
      "ice": {
        "value": 0,
        "unit": "mm",
        "unitType": 3
      }
    },
    {
      "date": "2019-11-15T01:00:00-08:00",
      "iconCode": 7,
      "iconPhrase": "Cloudy",
      "hasPrecipitation": false,
      "isDaylight": false,
      "temperature": {
        "value": 9.9,
        "unit": "C",
        "unitType": 17
      },
      "realFeelTemperature": {
        "value": 8.5,
        "unit": "C",
        "unitType": 17
      },
      "wetBulbTemperature": {
        "value": 8.5,
        "unit": "C",
        "unitType": 17
      },
      "dewPoint": {
        "value": 6.8,
        "unit": "C",
        "unitType": 17
      },
      "wind": {
        "direction": {
          "degrees": 177,
          "localizedDescription": "S"
        },
        "speed": {
          "value": 9.3,
          "unit": "km/h",
          "unitType": 7
        }
      },
      "windGust": {
        "speed": {
          "value": 13,
          "unit": "km/h",
          "unitType": 7
        }
      },
      "relativeHumidity": 81,
      "visibility": {
        "value": 16.1,
        "unit": "km",
        "unitType": 6
      },
      "cloudCover": 99,
      "ceiling": {
        "value": 2164,
        "unit": "m",
        "unitType": 5
      },
      "uvIndex": 0,
      "uvIndexPhrase": "Low",
      "precipitationProbability": 21,
      "rainProbability": 21,
      "snowProbability": 0,
      "iceProbability": 0,
      "totalLiquid": {
        "value": 0,
        "unit": "mm",
        "unitType": 3
      },
      "rain": {
        "value": 0,
        "unit": "mm",
        "unitType": 3
      },
      "snow": {
        "value": 0,
        "unit": "cm",
        "unitType": 4
      },
      "ice": {
        "value": 0,
        "unit": "mm",
        "unitType": 3
      }
    },
    {
      "date": "2019-11-15T02:00:00-08:00",
      "iconCode": 7,
      "iconPhrase": "Cloudy",
      "hasPrecipitation": false,
      "isDaylight": false,
      "temperature": {
        "value": 9.8,
        "unit": "C",
        "unitType": 17
      },
      "realFeelTemperature": {
        "value": 8.5,
        "unit": "C",
        "unitType": 17
      },
      "wetBulbTemperature": {
        "value": 8.4,
        "unit": "C",
        "unitType": 17
      },
      "dewPoint": {
        "value": 6.8,
        "unit": "C",
        "unitType": 17
      },
      "wind": {
        "direction": {
          "degrees": 172,
          "localizedDescription": "S"
        },
        "speed": {
          "value": 9.3,
          "unit": "km/h",
          "unitType": 7
        }
      },
      "windGust": {
        "speed": {
          "value": 13,
          "unit": "km/h",
          "unitType": 7
        }
      },
      "relativeHumidity": 82,
      "visibility": {
        "value": 16.1,
        "unit": "km",
        "unitType": 6
      },
      "cloudCover": 100,
      "ceiling": {
        "value": 1737,
        "unit": "m",
        "unitType": 5
      },
      "uvIndex": 0,
      "uvIndexPhrase": "Low",
      "precipitationProbability": 21,
      "rainProbability": 21,
      "snowProbability": 0,
      "iceProbability": 0,
      "totalLiquid": {
        "value": 0,
        "unit": "mm",
        "unitType": 3
      },
      "rain": {
        "value": 0,
        "unit": "mm",
        "unitType": 3
      },
      "snow": {
        "value": 0,
        "unit": "cm",
        "unitType": 4
      },
      "ice": {
        "value": 0,
        "unit": "mm",
        "unitType": 3
      }
    },
    {
      "date": "2019-11-15T03:00:00-08:00",
      "iconCode": 7,
      "iconPhrase": "Cloudy",
      "hasPrecipitation": false,
      "isDaylight": false,
      "temperature": {
        "value": 9.7,
        "unit": "C",
        "unitType": 17
      },
      "realFeelTemperature": {
        "value": 8.6,
        "unit": "C",
        "unitType": 17
      },
      "wetBulbTemperature": {
        "value": 8.4,
        "unit": "C",
        "unitType": 17
      },
      "dewPoint": {
        "value": 6.9,
        "unit": "C",
        "unitType": 17
      },
      "wind": {
        "direction": {
          "degrees": 161,
          "localizedDescription": "SSE"
        },
        "speed": {
          "value": 9.3,
          "unit": "km/h",
          "unitType": 7
        }
      },
      "windGust": {
        "speed": {
          "value": 13,
          "unit": "km/h",
          "unitType": 7
        }
      },
      "relativeHumidity": 83,
      "visibility": {
        "value": 16.1,
        "unit": "km",
        "unitType": 6
      },
      "cloudCover": 100,
      "ceiling": {
        "value": 1311,
        "unit": "m",
        "unitType": 5
      },
      "uvIndex": 0,
      "uvIndexPhrase": "Low",
      "precipitationProbability": 26,
      "rainProbability": 26,
      "snowProbability": 0,
      "iceProbability": 0,
      "totalLiquid": {
        "value": 0,
        "unit": "mm",
        "unitType": 3
      },
      "rain": {
        "value": 0,
        "unit": "mm",
        "unitType": 3
      },
      "snow": {
        "value": 0,
        "unit": "cm",
        "unitType": 4
      },
      "ice": {
        "value": 0,
        "unit": "mm",
        "unitType": 3
      }
    }
  ]
}

Definicje

Nazwa	Opis
ErrorAdditionalInfo	Dodatkowe informacje o błędzie zarządzania zasobami.
ErrorDetail	Szczegóły błędu.
ErrorResponse	Odpowiedź na błąd
HourlyForecast
HourlyForecastResult
IconCode	Wartość liczbowa reprezentująca obraz, który wyświetla `iconPhrase`element . Szczegółowe informacje można znaleźć w artykule Weather services in Azure Maps (Usługi pogodowe w usłudze Azure Maps ).
JsonFormat	Żądany format odpowiedzi. Obsługiwany jest tylko `json` format.
UnitType	Wartość identyfikatora liczbowego skojarzona z wyświetlanym typem jednostki. Może być używany do tłumaczenia jednostkowego. Szczegółowe informacje można znaleźć w artykule Weather services in Azure Maps (Usługi pogodowe w usłudze Azure Maps ).
WeatherDataUnit	Określa, aby zwracać dane w jednostkach metryk lub jednostkach imperialnych. Wartość domyślna to metryka.
WeatherUnit	Określona wartość danej jednostki powiązanej z pogodą.
WindDetails	Szczegóły wiatru zwracane, w tym prędkość i kierunek.
WindDirection	Kierunek wiatru

ErrorAdditionalInfo

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

Nazwa	Typ	Opis
info	object	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

Odpowiedź na błąd

Nazwa	Typ	Opis
error	ErrorDetail	Obiekt błędu.

HourlyForecast

Nazwa	Typ	Opis
ceiling	WeatherUnit	Limit chmury w określonej jednostce. Sufit jest pomiarem wysokości podstawy najniższych chmur.
cloudCover	integer	Procent reprezentujący pokrycie chmury.
date	string	Data i godzina prognozy w formacie ISO 8601, na przykład 2019-10-27T19:39:57-08:00.
dewPoint	WeatherUnit	Temperatura punktu dewpoint w określonej jednostce. Temperatura punktu odwu to temperatura, do którego należy ochłodzić powietrze, aby osiągnąć nasycenie.
hasPrecipitation	boolean	Wskazuje obecność lub brak opadów. Prawda wskazuje obecność opadów, fałsz wskazuje brak opadów.
ice	WeatherUnit	Ice
iceProbability	integer	Procent reprezentujący prawdopodobieństwo śniegu. Na przykład "5".
iconCode	IconCode	Wartość liczbowa reprezentująca obraz, który wyświetla `iconPhrase`element . Szczegółowe informacje można znaleźć w artykule Weather services in Azure Maps (Usługi pogodowe w usłudze Azure Maps ).
iconPhrase	string	Opis frazy ikony pogody.
isDaylight	boolean	Określa, czy jest to światło dzienne. Wartość True wskazuje światło dnia.
precipitationProbability	integer	Procent reprezentujący prawdopodobieństwo opadów. Na przykład "20".
rain	WeatherUnit	Deszcz
rainProbability	integer	Procent reprezentujący prawdopodobieństwo deszczu. Na przykład "50".
realFeelTemperature	WeatherUnit	Zwracana jest temperatura RealFeel™. Opisuje, jak temperatura naprawdę wygląda w cieniu.
relativeHumidity	integer	Wilgotność względna jest ilością pary wodnej obecnej w powietrzu wyrażonej jako procent ilości wymaganej do nasycenia w tej samej temperaturze.
snow	WeatherUnit	Śnieg
snowProbability	integer	Procent reprezentujący prawdopodobieństwo śniegu. Na przykład "50".
temperature	WeatherUnit	Zwracana temperatura.
totalLiquid	WeatherUnit	Łączny płynny odpowiednik opadów w okresie prognozy.
uvIndex	integer	Miara siły promieniowania ultrafioletowego z słońca. Obsługiwane wartości to: `0-2` - Niskie niebezpieczeństwo przed promieniami UV słońca lub przeciętną osobą. `3-5` - Umiarkowane ryzyko uszkodzenia niechronionej ekspozycji na słońce. `6-7` - Wysokie ryzyko uszkodzenia niechronionej ekspozycji na słońce. `8-10` - Bardzo wysokie ryzyko uszkodzenia przed niechronionym narażeniem na słońce. `11+` - Ekstremalne ryzyko uszkodzenia przed niechronionym słońcem.
uvIndexPhrase	string	Fraza skojarzona z elementem `uvIndex`.
visibility	WeatherUnit	Widoczność w określonej lekcji. Miara odległości, w której można wyraźnie rozpoznać obiekt lub światło.
wetBulbTemperature	WeatherUnit	Temperatura, do której powietrze może być chłodzone przez parowanie wody do niej przy stałym ciśnieniu, aż osiągnie nasycenie.
wind	WindDetails	Szczegóły wiatru zwracane, w tym prędkość i kierunek.
windGust	WindDetails	Podmuch wiatru. Podmuch wiatru jest nagły, krótki wzrost prędkości wiatru.

HourlyForecastResult

Nazwa	Typ	Opis
forecasts	HourlyForecast[]	Prognozowanie danych dla każdej zwracanej godziny.

IconCode

Wartość liczbowa reprezentująca obraz, który wyświetla iconPhraseelement . Szczegółowe informacje można znaleźć w artykule Weather services in Azure Maps (Usługi pogodowe w usłudze Azure Maps ).

Nazwa	Typ	Opis
1	Integer
10	Integer
11	Integer
12	Integer
13	Integer
14	Integer
15	Integer
16	Integer
17	Integer
18	Integer
19	Integer
2	Integer
20	Integer
21	Integer
22	Integer
23	Integer
24	Integer
25	Integer
26	Integer
27	Integer
28	Integer
29	Integer
3	Integer
30	Integer
31	Integer
32	Integer
33	Integer
34	Integer
35	Integer
36	Integer
37	Integer
38	Integer
39	Integer
4	Integer
40	Integer
41	Integer
42	Integer
43	Integer
44	Integer
5	Integer
6	Integer
7	Integer
8	Integer
9	Integer

JsonFormat

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

Nazwa	Typ	Opis
json	string	Format wymiany danych notacji obiektów JavaScript

UnitType

Wartość identyfikatora liczbowego skojarzona z wyświetlanym typem jednostki. Może być używany do tłumaczenia jednostkowego. Szczegółowe informacje można znaleźć w artykule Weather services in Azure Maps (Usługi pogodowe w usłudze Azure Maps ).

Nazwa	Typ	Opis
0	Integer
1	Integer
10	Integer
11	Integer
12	Integer
13	Integer
14	Integer
15	Integer
16	Integer
17	Integer
18	Integer
19	Integer
2	Integer
20	Integer
21	Integer
22	Integer
3	Integer
31	Integer
4	Integer
5	Integer
6	Integer
7	Integer
8	Integer
9	Integer

WeatherDataUnit

Określa, aby zwracać dane w jednostkach metryk lub jednostkach imperialnych. Wartość domyślna to metryka.

Nazwa	Typ	Opis
imperial	string	Zwraca dane w jednostkach imperialnych. Niektóre przykładowe jednostki systemu imperialnego to Fahrenheit i mile.
metric	string	Zwracanie danych w jednostkach metryk. Niektóre przykładowe jednostki systemu metryki to Stopnie Celsjusza i kilometr.

WeatherUnit

Określona wartość danej jednostki powiązanej z pogodą.

Nazwa	Typ	Opis
unit	string	Typ jednostki dla zwróconej wartości.
unitType	UnitType	Wartość identyfikatora liczbowego skojarzona z wyświetlanym typem jednostki. Może być używany do tłumaczenia jednostkowego. Szczegółowe informacje można znaleźć w artykule Weather services in Azure Maps (Usługi pogodowe w usłudze Azure Maps ).
value	number	Zaokrąglona wartość.

WindDetails

Szczegóły wiatru zwracane, w tym prędkość i kierunek.

Nazwa	Typ	Opis
direction	WindDirection	Kierunek wiatru
speed	WeatherUnit	Prędkość wiatru w określonej jednostce.

WindDirection

Kierunek wiatru

Nazwa	Typ	Opis
degrees	integer	Kierunek wiatru w stopniach Azimuth, zaczynając od prawdziwej Północy i kontynuując w kierunku wskazówek zegara. Północ jest 0 stopni, wschód jest 90 stopni, południe jest 180 stopni, zachód jest 270 stopni. Możliwe wartości 0–359.
localizedDescription	string	Skrót kierunku w określonym języku.

Udostępnij za pośrednictwem