Weather - Get Hourly Forecast
Används för att få en detaljerad väderprognos per timme i upp till 24 timmar eller en daglig prognos för upp till 10 dagar.
API:et Get Hourly Forecast är en HTTP GET som begär detaljerad väderprognos per timme för de kommande 1, 12, 24 (1 dag), 72 (3 dagar), 120 (5 dagar) och 240 timmar (10 dagar) för den angivna koordinatplatsen. API:et returnerar information som temperatur, luftfuktighet, vind, nederbörd och ultraviolett (UV) index. Mer information finns i Begära väderprognosdata per timme.
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}
URI-parametrar
| Name | I | Obligatorisk | Typ | Description |
|---|---|---|---|---|
|
endpoint
|
path | True |
string (uri) |
Azure Maps-tjänstens värdnamn. Använd |
|
format
|
path | True |
Önskat format för svaret. Endast |
|
|
api-version
|
query | True |
string minLength: 1 |
Den API-version som ska användas för den här åtgärden. |
|
query
|
query | True |
number[] |
Den tillämpliga frågan som anges som en kommaavgränsad sträng som består av latitud följt av longitud, t.ex. "47.641268,-122.125679". Väderinformation är i allmänhet tillgänglig för platser på land, vattendrag omgivna av land och områden i havet som ligger inom cirka 50 nautiska mil från en kustlinje. |
|
duration
|
query |
integer (int32) |
Tidsram för den returnerade väderprognosen. Som standard returneras prognosdata för nästa timme. Tillgängliga värden är
|
|
|
language
|
query |
string |
Språk där sökresultat ska returneras. Bör vara en av IETF-språktaggar som stöds, skiftlägesokänsliga. När data på angivet språk inte är tillgängliga för ett visst fält används standardspråket. Mer information finns i språk som stöds. |
|
|
unit
|
query |
Anger att data ska returneras i antingen metriska enheter eller brittiska enheter. Standardvärdet är mått. |
Begärandehuvud
| Name | Obligatorisk | Typ | Description |
|---|---|---|---|
| x-ms-client-id |
string |
Anger vilket konto som är avsett för användning med Microsoft Entra ID-säkerhetsmodellen. Detta unika ID för Azure Maps-kontot kan erhållas från Azure Maps Management Plane Account API. För mer information om hur man använder Microsoft Entra ID säkerhet i Azure Maps, se Hantera autentisering i Azure Maps. |
Svar
| Name | Typ | Description |
|---|---|---|
| 200 OK |
Begäran har slutförts. |
|
| Other Status Codes |
Ett oväntat felsvar. |
Säkerhet
AadToken
Dessa är Microsoft Entra OAuth 2.0 flöden. När den kombineras med Azure rollbaserad åtkomst kontroll kan den användas för att kontrollera åtkomst till Azure Maps REST-API:er. Azure:s rollbaserade åtkomstkontroller används för att ange åtkomst till ett eller flera Azure Maps-resurskonton eller delresurser. Alla användare, grupper eller tjänstens huvudnamn kan beviljas åtkomst via en inbyggd roll eller en anpassad roll som består av en eller flera behörigheter till Azure Maps REST-API:er.
För att implementera scenarier rekommenderar vi att du visar autentiseringsbegrepp. Sammanfattningsvis tillhandahåller den här säkerhetsdefinitionen en lösning för modellering av program via objekt som kan få åtkomstkontroll för specifika API:er och omfång.
Note
- Den här säkerhetsdefinitionen kräver användningen av
x-ms-client-id-huvudet för att ange vilken Azure Maps-resurs programmet begär åtkomst till. Detta kan hämtas från Maps-hanterings-API:et. -
Authorization URLär specifik för den offentliga Azure-molninstansen. Suveräna moln har unika auktoriserings-URL:er och Microsoft Entra ID-konfigurationer. - Den rollbaserade åtkomstkontrollen i Azure konfigureras från Azure-hanteringsplan via Azure-portalen, PowerShell, CLI, Azure SDK:er eller REST-API:er.
- Användning av Azure Maps Web SDK möjliggör konfigurationsbaserad konfiguration av ett program för flera användningsfall.
- Mer information om Microsofts identitetsplattform finns i Översikt över Microsofts identitetsplattform.
Typ:
oauth2
Flow:
implicit
Auktoriseringswebbadress:
https://login.microsoftonline.com/common/oauth2/authorize
Omfattningar
| Name | Description |
|---|---|
| https://atlas.microsoft.com/.default |
subscription-key
Det här är en delad nyckel som etableras när du Skapa ett Azure Maps-konto i Azure-portalen eller med hjälp av PowerShell, CLI, Azure SDK:er eller REST API.
Med den här nyckeln kan alla program komma åt alla REST API:er. Med andra ord kan den här nyckeln användas som en huvudnyckel i det konto som de har utfärdats i.
För offentligt exponerade program rekommenderar vi att du använder konfidentiella klientprogram metod för åtkomst till Azure Maps REST-API:er så att din nyckel kan lagras på ett säkert sätt.
Typ:
apiKey
I:
header
SAS Token
Det här är en signaturtoken för delad åtkomst som skapas från sas-åtgärden Lista på Azure Maps-resursen via Azure-hanteringsplanet via Azure-portalen, PowerShell, CLI, Azure SDK:er eller REST-API:er.
Med den här token har alla program behörighet att komma åt med rollbaserade Åtkomstkontroller i Azure och detaljerad kontroll till förfallodatum, frekvens och region för användning för den specifika token. Med andra ord kan SAS-token användas för att tillåta program att styra åtkomsten på ett mer säkert sätt än den delade nyckeln.
För offentligt exponerade program rekommenderar vi att du konfigurerar en specifik lista över tillåtna ursprung på Map-kontoresursen för att begränsa återgivningsmissbruket och regelbundet förnya SAS-token.
Typ:
apiKey
I:
header
Exempel
Successfully retrieve detailed weather forecast by the hour
Exempelbegäran
GET https://atlas.microsoft.com/weather/forecast/hourly/json?api-version=1.1&query=47.632346,-122.138874&duration=12
Exempelsvar
{
"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
}
}
}
]
}
Definitioner
| Name | Description |
|---|---|
|
Error |
Ytterligare information om resurshanteringsfelet. |
|
Error |
Detaljerna om felet. |
|
Error |
Vanligt felsvar för alla Azure Resource Manager API:er för att returnera feldetaljer vid misslyckade operationer. (Detta följer även formatet för OData-felsvar.). |
|
Hourly |
Objektet |
|
Hourly |
Svaret återkom från Get Hourly Forecast-operationen, som innehöll tim-för-timme väderprognoser för en angiven plats. Antalet |
|
Icon |
Den numeriska väderkoden som identifierar vilken ikon som ska visas.
Varje värde i denna uppräkning motsvarar en Azure Maps-väderikon (såsom Sunny, Cloudy eller Thunderweathers) och paras ihop med en människoläsbar symbol För den kompletta listan över koder, ikonerna de mappar till och exempelbilder, se Weather services i Azure Maps. |
|
Json |
Önskat format för svaret. Endast |
|
Unit |
Ett heltalsvärde kopplat till typen av enhet som visas. Till exempel 17 för Celsius, 18 för Fahrenheit. Kan användas för enhetsöversättning. För mer information, se Vädertjänster i Azure Maps. |
|
Weather |
Specificerar om data ska returneras i metriska eller imperiala enheter, med metriska enheter som standard. Ett exempel:
|
|
Weather |
Värden för väderrelaterade mått såsom temperatur, daggpunkt och vindhastighet, presenterade i antingen metriska eller imperiala enheter, enligt angivna enhetsparametern URI. För mer information, se Enhetstyper i artikeln Vädertjänster i Azure Maps. |
|
Wind |
Tillhandahåller den prognostiserade vindhastigheten, mätt i enheter som kilometer per timme (km/h) eller miles per timme (mph), beroende på vilken enhet som anges i begäran. Indikerar också vindriktningen mätt i azimutgrader, med start i sann nord och medurs. Norr motsvarar 0°, öst till 90°, söder till 180° och väster till 270°. Möjliga värden varierar från 0° till 359°. |
|
Wind |
Ger detaljer om vindriktning, inklusive riktning i azimutgrader och en lokaliserad förkortning av vindriktningen. |
ErrorAdditionalInfo
Ytterligare information om resurshanteringsfelet.
| Name | Typ | Description |
|---|---|---|
| info |
Ytterligare information. |
|
| type |
string |
Ytterligare informationstyp. |
ErrorDetail
Detaljerna om felet.
| Name | Typ | Description |
|---|---|---|
| additionalInfo |
Ytterligare information om felet. |
|
| code |
string |
Felkoden. |
| details |
Felinformationen. |
|
| message |
string |
Felmeddelandet. |
| target |
string |
Felmålet. |
ErrorResponse
Vanligt felsvar för alla Azure Resource Manager API:er för att returnera feldetaljer vid misslyckade operationer. (Detta följer även formatet för OData-felsvar.).
| Name | Typ | Description |
|---|---|---|
| error |
Felobjektet. |
HourlyForecast
Objektet HourlyForecast ger timvisa väderdetaljer, inklusive datum och tid, förväntade och upplevda temperaturer samt daggpunkt. Den täcker vindhastighet och riktning, vindbyar, relativ luftfuktighet, sikt och sannolikhet för nederbörd. Den anger om nederbörd förväntas och specificerar dess typ. Ytterligare egenskaper inkluderar UV-index, molntäckeprocent och molntakhöjd. Den har också en ikonkod och fras som beskriver väderförhållandena.
| Name | Typ | Description |
|---|---|---|
| ceiling |
Höjden på det lägsta molnlagret ovanför marken, mätt i fot eller meter baserat på den enhet som anges i begäran. Denna mätning är avgörande för flyg- och väderprognoser. |
|
| cloudCover |
integer (int32) |
Andelen av himlen täckt av moln vid den angivna tidpunkten. Detta värde varierar från 0% (klar himmel) till 100% (helt mulet). Kan vara NULL. |
| date |
string (date-time) |
Datum och tid för prognosen i RFC 3339-format (yyyy-mm-ddThh:mm:ss±hh:mm). Till exempel, 2019-11-14T16:00:00-08:00. |
| dewPoint |
Den temperatur vid vilken luften blir mättad med fukt och dagg börjar bildas. Den mäts i grader Fahrenheit (°F) eller Celsius (°C), beroende på vilken enhet som anslås. Detta värde är avgörande för att förstå luftfuktighetsnivåerna, eftersom en högre daggpunkt indikerar mer fukt i luften, vilket gör att den känns fuktigare. |
|
| hasPrecipitation |
boolean |
Ett booleskt värde som anger om nederbörd (regn, snö, snöblandat regn eller hagel) förväntas under den angivna tidsramen. Returnerar true om nederbörd förväntas, annars falsk. |
| ice |
Returnerar uppskattad isansamling för varje timme i prognosen, mätt i millimeter (mm) eller tum (in), beroende på vilken enhet som anges i förfrågan. |
|
| iceProbability |
integer (int32) |
Visar sannolikheten för isbildning under den angivna timmen, uttryckt som en procentandel från 0 till 100. Ett värde på 0 betyder ingen risk för isbildning, medan 100 betyder att isbildning är säker. Denna information hjälper användare att bedöma risken för isiga förhållanden. |
| iconCode |
Ett numeriskt värde som motsvarar en bild som visar . |
|
| iconPhrase |
string |
En beskrivande term som motsvarar ett specifikt väderförhållanden, såsom Solig. Den paras ihop med en |
| isDaylight |
boolean |
Ett boolskt värde som anger om det är dagsljus under den angivna timmen. Returnerar true om det är dagsljus, annars false (sanna dagar). |
| precipitationProbability |
integer (int32) |
Visar sannolikheten för nederbörd under den angivna timmen, uttryckt som en procentandel från 0 till 100. Ett värde på 0 betyder ingen chans till nederbörd, medan 100 betyder att nederbörden är säker. Detta hjälper användare att bedöma sannolikheten för regn, snö eller andra former av nederbörd. |
| rain |
Returnerar den mängden nederbörd som förväntas under varje timme i prognosen, mätt i millimeter (mm) eller tum (in), beroende på vilken enhet som anges i begäran. |
|
| rainProbability |
integer (int32) |
Visar sannolikheten för regn under den angivna tidsramen, uttryckt som en procentandel från 0 till 100. Ett värde på 0 betyder ingen chans till regn, medan 100 betyder att regn är säkert. |
| realFeelTemperature |
Tillhandahåller RealFeel-temperaturvärden™ för den angivna timmen, mätta i grader Celsius (°C) eller Fahrenheit (°F), beroende på vilken enhet som anges i förfrågan. Detta mått, utvecklat av AccuWeather, inkluderar över ett dussin faktorer, inklusive luftfuktighet, vindhastighet, molntäcke och solintensitet, för att ge ett heltäckande mått på hur vädret faktiskt känns. För mer information, se Vad är AccuWeather RealFeel-temperatur? |
|
| relativeHumidity |
integer (int32) |
Mängden vattenånga som finns i luften, uttryckt som en procentandel av den maximala mängd luften kan hålla vid samma temperatur. Detta värde anger hur nära luften är att bli mättad med fukt, vilket påverkar hur behaglig eller fuktig miljön känns. |
| snow |
Returnerar den mängden snö som förväntas under den angivna timmen, mätt i millimeter (mm) eller tum (in), beroende på vilken enhet som anges i begäran. |
|
| snowProbability |
integer (int32) |
Visar sannolikheten för snö under den angivna timmen, uttryckt som en procentandel från 0 till 100. Ett värde på 0 betyder ingen chans till snö, medan 100 betyder att snö är säker. |
| temperature |
Den förväntade temperaturen för den angivna timmen, mätt i grader Celsius (°C) eller Fahrenheit (°F), beroende på vilken enhet som anges i begäran. |
|
| totalLiquid |
Returnerar den totala mängden flytande nederbörd (såsom regn) som förväntas under varje timme av prognosperioden, mätt i millimeter (mm) eller tum (in), beroende på vilken enhet som anges i begäran. |
|
| uvIndex |
integer (int32) |
Tillhandahåller ultraviolett (UV) index för varje timme av prognosperioden. Detta index visar nivån av förväntad ultraviolett strålning och hjälper användarna att förstå den potentiella risken för solexponering vid olika tider på dygnet. Värden som stöds är:
|
| uvIndexPhrase |
string |
Ger en beskrivande fras som anger nivån av UV-strålning, såsom låg, måttlig, hög eller mycket hög. |
| visibility |
Returnerar avståndet där ett objekt eller ljus tydligt kan urskiljas för varje timme av prognosperioden, mätt i kilometer (km) eller miles (mi), beroende på vilken enhet som anges i förfrågan. Detta visar hur långt man kan se, vilket är avgörande för aktiviteter som bilkörning och flygning. |
|
| wetBulbTemperature |
Återför den temperatur som ett luftpaket skulle ha om det kyldes ner till mättnad (100% relativ luftfuktighet) genom avdunstning av vatten i det. Denna egenskap är viktig för att förstå värmestress och avdunstningens kyleffekt. |
|
| wind |
Anger förväntad vindhastighet och riktning. Vindhastighet mäts i kilometer per timme (km/h) eller miles per timme (mph), baserat på den angivna enheten. Vindriktningen mäts i azimutgrader, från 0° (sann nord) till 359°, medurs (öst är 90°, söder är 180°, väst är 270°). |
|
| windGust |
Returnerar den förväntade maximala vindbyhastigheten under varje timme av prognosperioden, mätt i kilometer per timme (km/h) eller miles per timme (mph), baserat på den angivna enheten. Vindriktningen anges i azimutgrader, från 0° (sann nord) till 359°, medurs. Vindbyar är korta ökningar i vindhastighet, viktiga för att förstå kortsiktiga variationer som kan påverka aktiviteter som flyg, segling och utomhusevenemang. |
HourlyForecastResult
Svaret återkom från Get Hourly Forecast-operationen, som innehöll tim-för-timme väderprognoser för en angiven plats. Antalet HourlyForecast återkommande anmälningar matchar den begärda prognostiden – en på 1, 12, 24, 48, 72 eller 96 timmar (se HourlyDuration unionen).
| Name | Typ | Description |
|---|---|---|
| forecasts |
De timme-för-timme prognoserna, en per timme i det begärda fönstret, i kronologisk ordning. Varje post innehåller förväntad temperatur, RealFeel, daggpunkt, vind, nederbördsprognoser (sannolikhet och mängder för regn, snö och is), molntäcke, sikt, UV-index, tak och andra observationer för den timmen. Till exempel ger en varaktighet på 12 12 poster som börjar 2019-11-14T16:00:00-08:00 och går fram en timme i taget. |
IconCode
Den numeriska väderkoden som identifierar vilken ikon som ska visas.
Varje värde i denna uppräkning motsvarar en Azure Maps-väderikon (såsom Sunny, Cloudy eller Thunderweathers) och paras ihop med en människoläsbar symbol iconPhrase som returneras tillsammans med den. Samma kod kan förekomma i aktuella, timvisa, dagliga, kvartsdags- och minut-för-minut-svar, vilket gör att applikationer kan visa en konsekvent ikon som är inställd över alla vädertjänster.
För den kompletta listan över koder, ikonerna de mappar till och exempelbilder, se Weather services i Azure Maps.
| Värde | Description |
|---|---|
| 1 |
Sunny |
| 2 |
Mestadels soligt |
| 3 |
Delvis soligt |
| 4 |
Tillfälliga moln |
| 5 |
Disigt solsken |
| 6 |
Mestadels molnigt |
| 7 |
Cloudy |
| 8 |
Trist (mulet) |
| 11 |
Dimma |
| 12 |
Showers |
| 13 |
Mestadels molnigt med duschar |
| 14 |
Delvis soligt med skurar |
| 15 |
Thunderstorms |
| 16 |
Mestadels molnigt med åskväder |
| 17 |
Delvis soligt med åskväder |
| 18 |
Regn |
| 19 |
Flurries |
| 20 |
Mestadels molnigt med flurries |
| 21 |
Delvis soligt med flurries |
| 22 |
Snow |
| 23 |
Mestadels molnigt med snö |
| 24 |
Is |
| 25 |
Slask |
| 26 |
Underkylt regn |
| 29 |
Regn och snö |
| 30 |
Hot |
| 31 |
Kall |
| 32 |
Windy |
| 33 |
Klar |
| 34 |
Mestadels klart |
| 35 |
Delvis molnigt |
| 36 |
Tillfälliga moln |
| 37 |
Disigt månsken |
| 38 |
Mestadels molnigt |
| 39 |
Delvis molnigt med duschar |
| 40 |
Mestadels molnigt med duschar |
| 41 |
Delvis molnigt med åskväder |
| 42 |
Mestadels molnigt med åskväder |
| 43 |
Mestadels molnigt med flurries |
| 44 |
Mestadels molnigt med snö |
JsonFormat
Önskat format för svaret. Endast json format stöds.
| Värde | Description |
|---|---|
| json |
UnitType
Ett heltalsvärde kopplat till typen av enhet som visas. Till exempel 17 för Celsius, 18 för Fahrenheit. Kan användas för enhetsöversättning. För mer information, se Vädertjänster i Azure Maps.
| Värde | Description |
|---|---|
| 0 |
feet |
| 1 |
inches |
| 2 |
miles |
| 3 |
millimeter |
| 4 |
centimeter |
| 5 |
meter |
| 6 |
kilometer |
| 7 |
kilometersPerHour |
| 8 |
knots |
| 9 |
milesPerHour |
| 10 |
metersPerSecond |
| 11 |
hectoPascals |
| 12 |
inchesOfMercury |
| 13 |
kiloPascals |
| 14 |
millibars |
| 15 |
millimetersOfMercury |
| 16 |
poundsPerSquareInch |
| 17 |
Celsius |
| 18 |
Fahrenheit |
| 19 |
kelvin |
| 20 |
percent |
| 21 |
flyta/sväva |
| 22 |
integer |
| 31 |
MicrogramsPerCubicMeterOfAir |
WeatherDataUnit
Specificerar om data ska returneras i metriska eller imperiala enheter, med metriska enheter som standard. Ett exempel:
- Metrisk: millimeter (mm), meter (m), kilometer (km), Celsius (C)
- Imperial: tum (in), fot (ft), mile (mi), Fahrenheit (F)
| Värde | Description |
|---|---|
| imperial |
Returnera data med imperiala enheter som Fahrenheit (F) för temperatur och miles (mi) för avstånd. |
| metric |
Returnera data med hjälp av måttenheter som Celsius (C) för temperatur och kilometer (km) för avstånd. |
WeatherValue
Värden för väderrelaterade mått såsom temperatur, daggpunkt och vindhastighet, presenterade i antingen metriska eller imperiala enheter, enligt angivna enhetsparametern URI. För mer information, se Enhetstyper i artikeln Vädertjänster i Azure Maps.
| Name | Typ | Description |
|---|---|---|
| unit |
string |
Måttenheten som används i returvärdet, såsom "C" för Celsius, "F" för Fahrenheit. |
| unitType |
Ett heltal som representerar enhetstypen. Till exempel, 0 för fötter, 1 för tum, 2 för mil. För en komplett lista, se Enhetstyper i artikeln Vädertjänster i Azure Maps. |
|
| value |
number (float) |
Det uppmätta värdet uttryckt i den angivna enheten. |
WindDetails
Tillhandahåller den prognostiserade vindhastigheten, mätt i enheter som kilometer per timme (km/h) eller miles per timme (mph), beroende på vilken enhet som anges i begäran. Indikerar också vindriktningen mätt i azimutgrader, med start i sann nord och medurs. Norr motsvarar 0°, öst till 90°, söder till 180° och väster till 270°. Möjliga värden varierar från 0° till 359°.
| Name | Typ | Description |
|---|---|---|
| direction |
Vindriktningen målas i azimutgrader, med start vid sann nord (0°) och medurs. Öst motsvarar 90°, söder till 180° och väst till 270°. Möjliga värden varierar från 0° till 359°. Denna egenskap ger ett heltal som representerar vindriktningen. |
|
| speed |
Den förväntade vindhastigheten, mätt i kilometer per timme (km/h) eller miles per timme (mph), beroende på vilken enhet som anges i begäran. |
WindDirection
Ger detaljer om vindriktning, inklusive riktning i azimutgrader och en lokaliserad förkortning av vindriktningen.
| Name | Typ | Description |
|---|---|---|
| degrees |
integer (int32) |
Vindriktningen målas i azimutgrader, med start i sann nord och medurs. Nord motsvarar 0 grader, öst till 90 grader, söder till 180 grader och väst till 270 grader. Möjliga värden varierar från 0 till 359 grader. |
| localizedDescription |
string |
En lokaliserad förkortning av vindriktningen, returnerad på det språk som anges i förfrågan. Till exempel |