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 https://atlas.microsoft.com för Azure publika molnet. För att rikta in dig på en specifik Azure Maps geografi eller ett suveränt moln, se Azure Maps geografisk omfattning.

format
path True

JsonFormat

Önskat format för svaret. Endast json format stöds.

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

  • 1 - Returnera prognosdata för nästa timme. Standardvärde.
  • 12 - Returnera timprognos för de kommande 12 timmarna.
  • 24 - Returnera timprognos för de kommande 24 timmarna.
  • 72 - Returnera timprognos för de kommande 72 timmarna (3 dagar).
  • 120 - Returnera timprognos för de kommande 120 timmarna (5 dagar).
  • 240 - Returnera timprognos för de kommande 240 timmarna (10 dagar).
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

WeatherDataUnit

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

HourlyForecastResult

Begäran har slutförts.

Other Status Codes

ErrorResponse

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
ErrorAdditionalInfo

Ytterligare information om resurshanteringsfelet.

ErrorDetail

Detaljerna om felet.

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

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.

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

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.

JsonFormat

Önskat format för svaret. Endast json format stöds.

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.

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

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

WindDirection

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

ErrorAdditionalInfo[]

Ytterligare information om felet.

code

string

Felkoden.

details

ErrorDetail[]

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

ErrorDetail

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

WeatherValue

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

WeatherValue

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

WeatherValue

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

IconCode

Ett numeriskt värde som motsvarar en bild som visar .iconPhrase För mer information, se Vädertjänster i Azure Maps.

iconPhrase

string

En beskrivande term som motsvarar ett specifikt väderförhållanden, såsom Solig. Den paras ihop med en iconCode, som är ett numeriskt värde som representerar en bild som visuellt visar väderförhållandena som beskrivs av .iconPhrase För mer information, se Vädertjänster i Azure Maps.

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

WeatherValue

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

WeatherValue

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

WeatherValue

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

WeatherValue

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

WeatherValue

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:

  • 0-2: Låg risk från solens UV-strålar eller från en vanlig person.
  • 3-5: Måttlig risk för skada från oskyddad solexponering.
  • 6-7: Hög risk för skador från oskyddad solexponering.
  • 8-10: Mycket hög risk för skador från oskyddad solexponering.
  • 11+: Extrem risk för skada från oskyddad solexponering.
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

WeatherValue

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

WeatherValue

Å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

WindDetails

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

WindDetails

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

HourlyForecast[]

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

JavaScript-objekt notationens datautbytesformat

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

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

WindDirection

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

WeatherValue

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 N för norr, E för öst, S för söder och W för väst.