Weather - Get Hourly Forecast

Referencia

Szolgáltatás:: Maps

API-verzió:: 1.1

Használja a használatával részletes óránkénti időjárás-előrejelzést kaphat akár 24 órára, vagy napi előrejelzést kaphat akár 10 napra.

Az Get Hourly Forecast API egy HTTP, GET amely óránként részletes időjárás-előrejelzést kér a következő 1, 12, 24 (1 nap), 72 (3 nap), 120 (5 nap) és 240 óra (10 nap) számára az adott koordinátahelyen. Az API olyan részleteket ad vissza, mint a hőmérséklet, a páratartalom, a szél, a csapadék és az ultraibolya (UV) index. További információ: Óránkénti időjárás-előrejelzési adatok kérése.

Ha a Gen1 S0 tarifacsomagot használja, óránkénti előrejelzést kérhet a következő 1, 12, 24 órára (1 nap) és 72 órára (3 napra). Ha Gen1 S1 vagy Gen2 tarifacsomagot használ, óránkénti előrejelzést is kérhet a következő 120 (5 nap) és 240 órára (10 nap).

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

Opcionális paraméterekkel:

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

URI-paraméterek

Name	In	Kötelező	Típus	Description
format	path	True	JsonFormat	A válasz kívánt formátuma. Csak `json` formátum támogatott.
api-version	query	True	string	Az Azure Maps API verziószáma.
query	query	True	number[]	A megfelelő lekérdezés vesszővel elválasztott sztringként van megadva, amelyet szélesség és hosszúság követ, például:"47.641268,-122.125679". Az időjárási információk általában a szárazföldi helyekre, a szárazfölddel körülvett víztestekre és az óceán olyan területeire vonatkoznak, amelyek a partvonaltól körülbelül 50 tengeri mérföldön belül vannak.
duration	query		integer	A visszaküldött időjárás-előrejelzés időkerete. Alapértelmezés szerint a következő óra előrejelzési adatait adja vissza. A rendelkezésre álló értékek a következők: `1` - A következő óra előrejelzési adatainak visszaadása. Alapértelmezett érték. `12` - Óránkénti előrejelzés visszaadása a következő 12 órára. `24` - Óránkénti előrejelzés visszaadása a következő 24 órára. `72` - Óránkénti előrejelzés visszaadása a következő 72 órára (3 napra). `120` - Óránkénti előrejelzés visszaadása a következő 120 órára (5 napra). Csak az S1 termékváltozatban érhető el. `240` - Óránkénti előrejelzés visszaadása a következő 240 órára (10 napra). Csak az S1 termékváltozatban érhető el.
language	query		string	Az a nyelv, amelyben a keresési eredményeket vissza kell adni. A támogatott IETF nyelvi címkék egyikének kell lennie, a kis- és nagybetűk nem érzéketlenek. Ha a megadott nyelven lévő adatok nem érhetők el egy adott mezőhöz, a rendszer az alapértelmezett nyelvet használja. Részletekért tekintse meg támogatott nyelvek.
unit	query		WeatherDataUnit	Megadja, hogy az adatokat metrikus vagy angolszász mértékegységben adja vissza. Az alapértelmezett érték metrika.

Kérelem fejléce

Name	Kötelező	Típus	Description
x-ms-client-id		string	Megadja, hogy melyik fiók legyen a Microsoft Entra ID biztonsági modellel együtt használva. Az Azure Maps-fiók egyedi azonosítóját jelöli, amely az Azure Maps felügyeleti sík fiók API-jából kérhető le. A Microsoft Entra ID-biztonság Azure Mapsben való használatához az alábbi cikkeket útmutatásért.

Válaszok

Name	Típus	Description
200 OK	HourlyForecastResult	OKÉ
Other Status Codes	ErrorResponse	Váratlan hiba történt.

Biztonság

AADToken

Ezek a Microsoft Entra OAuth 2.0 folyamatok . Ha Azure-beli szerepköralapú hozzáférés- vezérléssel párosítva szabályozható az Azure Maps REST API-khoz való hozzáférés. Az Azure szerepköralapú hozzáférés-vezérlői egy vagy több Azure Maps-erőforrásfiókhoz vagy alerőforrásokhoz való hozzáférés kijelölésére szolgálnak. Bármely felhasználó, csoport vagy szolgáltatásnév hozzáférést kaphat egy beépített szerepkörön vagy egy vagy több Azure Maps REST API-ra vonatkozó engedélyből álló egyéni szerepkörön keresztül.

Forgatókönyvek implementálásához javasoljuk, hogy tekintse meg hitelesítési fogalmakat. Összefoglalva, ez a biztonsági definíció megoldást kínál az alkalmazások modellezésére olyan objektumokon keresztül, amelyek hozzáférés-vezérlésre képesek adott API-kon és hatókörökön.

Jegyzetek

Ez a biztonsági definíciós megköveteli, hogy a x-ms-client-id fejléc használatával jelezze, hogy melyik Azure Maps-erőforráshoz kér hozzáférést az alkalmazás. Ez a Maps felügyeleti API-ból szerezhető be.

A Authorization URL az Azure nyilvános felhőpéldányára jellemző. A szuverén felhők egyedi engedélyezési URL-címekkel és Microsoft Entra-azonosító konfigurációkkal rendelkeznek. * Az Azure szerepköralapú hozzáférés-vezérlés a Azure felügyeleti síkjáról van konfigurálva, az Azure Portalon, a PowerShellen, a parancssori felületen, az Azure SDK-kon vagy REST API-kon keresztül. * Az Azure Maps Web SDK használata lehetővé teszi egy alkalmazás konfigurációalapú beállítását több használati esethez.

További információ a Microsoft identitásplatformról: Microsoft Identitásplatform áttekintése.

Típus: oauth2
Folyamat: implicit
Engedélyezési URL: https://login.microsoftonline.com/common/oauth2/authorize

Hatókörök

Name	Description
https://atlas.microsoft.com/.default	https://atlas.microsoft.com/.default

subscription-key

Ez egy megosztott kulcs, amely akkor lesz kiépítve, ha Azure Maps-fiók létrehozása az Azure Portalon, vagy PowerShell, CLI, Azure SDK vagy REST API használatával.

Ezzel a kulccsal bármely alkalmazás hozzáférhet az összes REST API-hoz. Más szóval ez a kulcs használható főkulcsként abban a fiókban, amelyben ki vannak adva.

A nyilvánosan közzétett alkalmazások esetében javasoljuk, hogy használja a bizalmas ügyfélalkalmazásokat, megközelítést az Azure Maps REST API-k eléréséhez, hogy a kulcs biztonságosan tárolható legyen.

Típus: apiKey
In: query

SAS Token

Ez egy közös hozzáférésű jogosultságkód-jogkivonat a listázási SAS műveletből jön létre a Azure Maps-erőforráson az Azure felügyeleti síkon keresztül az Azure Portalon, a PowerShellen, a parancssori felületen, az Azure SDK-kon vagy a REST API-kon keresztül.

Ezzel a jogkivonattal minden alkalmazás jogosult az Azure szerepköralapú hozzáférés-vezérlőivel való hozzáférésre, valamint az adott jogkivonat lejáratának, sebességének és régióinak részletes szabályozására. Más szóval az SAS-jogkivonat segítségével az alkalmazások biztonságosabban szabályozhatják a hozzáférést, mint a megosztott kulcs.

A nyilvánosan közzétett alkalmazások esetében javasoljuk, hogy konfigurálja a -fiók erőforrás- engedélyezett forrásainak listáját a renderelési visszaélések korlátozása és az SAS-jogkivonat rendszeres megújítása érdekében.

Típus: apiKey
In: header

Példák

Successfully retrieve detailed weather forecast by the hour

Mintakérelem

HTTP

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

Mintaválasz

Állapotkód:: 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
      }
    }
  ]
}

Definíciók

Name	Description
ErrorAdditionalInfo	Az erőforrás-kezelési hiba további információi.
ErrorDetail	A hiba részletei.
ErrorResponse	Hibaválasz
HourlyForecast
HourlyForecastResult
IconCode	A `iconPhrase`. A részletekért tekintse meg az Azure Maps időjárási szolgáltatásait .
JsonFormat	A válasz kívánt formátuma. Csak `json` formátum támogatott.
UnitType	A megjelenített egység típusához társított numerikus azonosító érték. Egységfordításhoz használható. A részletekért tekintse meg az Azure Maps időjárási szolgáltatásait .
WeatherDataUnit	Megadja, hogy az adatokat metrikus vagy angolszász mértékegységben adja vissza. Az alapértelmezett érték metrika.
WeatherUnit	Egy adott mértékegység időjáráshoz kapcsolódó specifikus értéke.
WindDetails	A szél részletei visszakerülnek, beleértve a sebességet és az irányt.
WindDirection	Szélirány

ErrorAdditionalInfo

Objektum

Az erőforrás-kezelési hiba további információi.

Name	Típus	Description
info	object	A további információk.
type	string	A további információtípus.

ErrorDetail

Objektum

A hiba részletei.

Name	Típus	Description
additionalInfo	ErrorAdditionalInfo[]	A hiba további információi.
code	string	A hibakód.
details	ErrorDetail[]	A hiba részletei.
message	string	A hibaüzenet.
target	string	A hibacél.

ErrorResponse

Objektum

Hibaválasz

Name	Típus	Description
error	ErrorDetail	A hibaobjektum.

HourlyForecast

Objektum

Name	Típus	Description
ceiling	WeatherUnit	Felhő mennyezet meghatározott mértékegységben. A mennyezet a legalacsonyabb felhők alapjának magasságának mérése.
cloudCover	integer (int32)	A felhőtakarót képviselő százalék.
date	string (date-time)	Az előrejelzés dátuma és időpontja ISO 8601 formátumban, például 2019-10-27T19:39:57-08:00.
dewPoint	WeatherUnit	A harmatpont hőmérséklete a megadott mértékegységben. A harmatpont hőmérséklete az a hőmérséklet, amelyre a levegőt le kell hűteni a telítettség eléréséhez.
hasPrecipitation	boolean	Jelzi a csapadék jelenlétét vagy hiányát. Az igaz a csapadék jelenlétét, a hamis a csapadék hiányát jelzi.
ice	WeatherUnit	Jég
iceProbability	integer (int32)	A hó valószínűségét képviselő százalék. Például "5".
iconCode	IconCode (int32)	A `iconPhrase`. A részletekért tekintse meg az Azure Maps időjárási szolgáltatásait .
iconPhrase	string	Az időjárás ikon kifejezésleírása.
isDaylight	boolean	Megadja, hogy napfény van-e vagy sem. Az igaz nappali fényt jelez.
precipitationProbability	integer (int32)	A csapadék valószínűségét képviselő százalék. Például: "20".
rain	WeatherUnit	Eső
rainProbability	integer (int32)	Az eső valószínűségét képviselő százalék. Például "50".
realFeelTemperature	WeatherUnit	RealFeel™ Hőmérséklet visszaadása. Leírja, milyen a hőmérséklet valójában az árnyékban.
relativeHumidity	integer (int32)	A relatív páratartalom a levegőben lévő vízgőz mennyisége az azonos hőmérsékleten történő telítettséghez szükséges mennyiség százalékában kifejezve.
snow	WeatherUnit	Hó
snowProbability	integer (int32)	A hó valószínűségét képviselő százalék. Például "50".
temperature	WeatherUnit	A hőmérséklet visszaadódik.
totalLiquid	WeatherUnit	A csapadék teljes folyadékegyenértéke az előrejelzési időszakban.
uvIndex	integer (int32)	A nap ultraibolya sugárzásának erősségének mérése. A támogatott értékek a következők: `0-2` - Alacsony veszély a nap UV-sugarai vagy az átlagember számára. `3-5` - Mérsékelt kockázat a védtelen napsugárzás miatt. `6-7` - A védtelen napsugárzás magas ártalmának kockázata. `8-10` - Nagyon magas a védtelen napsugárzás okozta károsodás kockázata. `11+` - A védtelen napsugárzás rendkívüli károsodásának kockázata.
uvIndexPhrase	string	A `uvIndex`.
visibility	WeatherUnit	Láthatóság a megadott egységben. Annak a távolságnak a mértéke, amelynél egy tárgy vagy fény egyértelműen megkülönböztethető.
wetBulbTemperature	WeatherUnit	Az a hőmérséklet, amelyre a levegőt állandó nyomáson víz elpárologtatásával lehet lehűteni, amíg el nem éri a telítettséget.
wind	WindDetails	A szél részletei visszakerülnek, beleértve a sebességet és az irányt.
windGust	WindDetails	Széllökés. A széllökés a szél sebességének hirtelen, rövid növekedése.

HourlyForecastResult

Objektum

Name	Típus	Description
forecasts	HourlyForecast[]	Előrejelzési adatok minden visszaadott órához.

IconCode

Enumerálás

A iconPhrase. A részletekért tekintse meg az Azure Maps időjárási szolgáltatásait .

Érték	Description
1	Napfényes
10
11	Köd
12	Zuhanyzók
13	Többnyire felhős, záporokkal
14	Részben napos, záporral
15	Zivatarok
16	Többnyire felhős, zivatarokkal
17	Részben napos, zivatarokkal
18	Eső
19	Csapások
2	Többnyire napos
20	Többnyire felhős, viszállyal
21	Részben napos a viharokkal
22	Hó
23	Többnyire felhős, hó
24	Jég
25	Ónos eső
26	Ónos eső
27
28
29	Eső és hó
3	Részben napos
30	Forró
31	hideg
32	Szeles
33	Világos
34	Többnyire tiszta
35	Részben felhős
36	Időszakos felhők (éjszaka)
37	Ködös holdfény
38	Többnyire felhős (éjszaka)
39	Részben felhős, záporokkal
4	Időszakos felhők
40	Többnyire felhős, záporral (éjszaka)
41	Részben felhős, zivatarokkal
42	Többnyire felhős, zivatarokkal (éjszaka)
43	Többnyire felhős, viharral (éjszaka)
44	Többnyire felhős, havas (éjszaka)
5	Ködös napsütés
6	Többnyire felhős
7	Felhős
8	Szomorú (borús)
9

JsonFormat

Enumerálás

A válasz kívánt formátuma. Csak json formátum támogatott.

Érték	Description
json	A JavaScript objektum jelölési adatcseréjének formátuma

UnitType

Enumerálás

A megjelenített egység típusához társított numerikus azonosító érték. Egységfordításhoz használható. A részletekért tekintse meg az Azure Maps időjárási szolgáltatásait .

Érték	Description
0	Lábak
1	Hüvelyk
10	méterMásodpercenként
11	hektoPascal
12	hüvelyk higanyból
13	kiloPascal
14	millibar
15	milliméteres higanyból
16	fontNégyzethüvelykenként
17	Celsius fok
18	Fahrenheit
19	kelvin
2	Km
20	százalék
21	úsztat
22	egész szám
3	milliméter
31	MikrogrammPerCubicMeterOfAir
4	centiméter
5	mérőóra
6	kilométer
7	kilométer/óra
8	Csomó
9	mérföld/óra

WeatherDataUnit

Enumerálás

Megadja, hogy az adatokat metrikus vagy angolszász mértékegységben adja vissza. Az alapértelmezett érték metrika.

Érték	Description
imperial	Adja vissza az adatokat angolszász mértékegységben. Néhány példa a birodalmi rendszer mértékegységeire a Fahrenheit és a mérföld.
metric	Adatok visszaadása metrikus egységekben. A metrikus rendszer néhány példája a Celsius és a kilométer.

WeatherUnit

Objektum

Egy adott mértékegység időjáráshoz kapcsolódó specifikus értéke.

Name	Típus	Description
unit	string	A visszaadott érték mértékegységének típusa.
unitType	UnitType (int32)	A megjelenített egység típusához társított numerikus azonosító érték. Egységfordításhoz használható. A részletekért tekintse meg az Azure Maps időjárási szolgáltatásait .
value	number (float)	Kerekített érték.

WindDetails

Objektum

A szél részletei visszakerülnek, beleértve a sebességet és az irányt.

Name	Típus	Description
direction	WindDirection	Szélirány
speed	WeatherUnit	A szél sebessége a megadott mértékegységben.

WindDirection

Objektum

Szélirány

Name	Típus	Description
degrees	integer (int32)	A szél iránya azimut fokban, valódi északi irányban kezdődik és az óramutató járásával megegyező irányban folytatódik. Észak 0 fok, keleten 90 fok, délen 180 fok, nyugaton 270 fok. Lehetséges értékek 0-359.
localizedDescription	string	Irány rövidítése a megadott nyelven.

Megosztás a következőn keresztül:

Weather - Get Hourly Forecast

URI-paraméterek

Kérelem fejléce

Válaszok

Biztonság

AADToken

Jegyzetek

Hatókörök

subscription-key

SAS Token

Példák

Successfully retrieve detailed weather forecast by the hour

Mintakérelem

Mintaválasz

Definíciók

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

HourlyForecast

HourlyForecastResult

IconCode

JsonFormat

UnitType

WeatherDataUnit

WeatherUnit

WindDetails

WindDirection