Weather - Get Daily Forecast

  • Referens
Service:
Maps
API Version:
1.1

Använd för att få en daglig detaljerad väderprognos för de kommande 1, 5, 10, 15, 25 eller 45 dagarna.

API:et Get Daily Forecast är en HTTP-begäran GET som returnerar detaljerad väderprognos, till exempel temperatur och vind per dag för de kommande 1, 5, 10, 15, 25 eller 45 dagarna för en viss koordinatplats. Svaret innehåller information som temperatur, vind, nederbörd, luftkvalitet och UV-index. Mer information finns i Begära dagliga väderprognosdata.

Om du använder prisnivån Gen1 S0 kan du begära daglig prognos för de kommande 1, 5, 10 och 15 dagarna. Om du använder prisnivån Gen1 S1 eller Gen2 kan du också begära daglig prognos för de kommande 25 dagarna och 45 dagarna.

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

URI-parametrar

Name I Obligatorisk Typ Description
format
 path True

JsonFormat

Önskat format för svaret. Endast json format stöds.
api-version
 query True

string

Versionsnummer för Azure Maps API.
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".
duration
 query

integer

Anger hur många dagar de dagliga prognossvaren returneras. Tillgängliga värden är

  • 1 – Returnera prognosdata för nästa dag. Returneras som standard.
  • 5 – Returnera prognosdata för de kommande 5 dagarna.
  • 10 – Returnera prognosdata för de kommande 10 dagarna.
  • 25 – Returnera prognosdata för de kommande 25 dagarna. Endast tillgängligt i S1 SKU.
  • 45 – Returnera prognosdata för de kommande 45 dagarna. Endast tillgängligt i S1 SKU.
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å det angivna språket 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 måttenheter eller kejserliga 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 tillsammans med Microsoft Entra ID säkerhetsmodell. Den representerar ett unikt ID för Azure Maps-kontot och kan hämtas från Azure Maps hanteringsplans konto-API. Information om hur du använder Microsoft Entra ID säkerhet i Azure Maps finns i följande artiklar.

Svar

Name Typ Description
200 OK

DailyForecastResult

OK
Other Status Codes

ErrorResponse

Det uppstod ett oväntat fel.

Säkerhet

AADToken

Det här är Microsoft Entra OAuth 2.0-flöden. När den är kopplad till rollbaserad åtkomstkontroll i Azure kan den användas för att styra åtkomsten till Azure Maps REST-API:er. Rollbaserade åtkomstkontroller i Azure används för att ange åtkomst till en eller flera Azure Maps resurskonto eller underresurser. 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 för att 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.

Kommentarer

  • Den här säkerhetsdefinitionen x-ms-client-idkräver att huvudet används för att ange vilken Azure Maps resurs som programmet begär åtkomst till. Detta kan hämtas från Maps Management-API :et.

Authorization URL är specifikt för den offentliga Azure-molninstansen. Nationella moln har unika auktoriserings-URL:er och Microsoft Entra ID konfigurationer. * Den rollbaserade Azure-åtkomstkontrollen konfigureras från Azure-hanteringsplanet via Azure Portal, 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.

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

Name Description
https://atlas.microsoft.com/.default 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 Portal 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:et. Med andra ord kan den här nyckeln användas som en huvudnyckel i det konto som de utfärdas i.

För offentligt exponerade program rekommenderar vi att du använder metoden för konfidentiella klientprogram för att komma åt Azure Maps REST-API:er så att din nyckel kan lagras på ett säkert sätt.

Type: apiKey
In: query

SAS Token

Det här är en signaturtoken för delad åtkomst som skapas från åtgärden Lista SAS på den Azure Maps resursen via Azure-hanteringsplanet via Azure Portal, 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 av 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 återgivningsmissbruk och regelbundet förnya SAS-token.

Type: apiKey
In: header

Exempel

Successfully retrieve detailed daily weather forecast for a given coordinate location

Sample Request

GET https://atlas.microsoft.com/weather/forecast/daily/json?api-version=1.1&query=62.6490341,30.0734812&duration=5

Sample Response

Status code:
200 
{
  "summary": {
    "startDate": "2019-11-17T09:00:00-08:00",
    "endDate": "2019-11-17T15:00:00-08:00",
    "severity": 5,
    "phrase": "Rain Sunday evening",
    "category": "rain"
  },
  "forecasts": [
    {
      "date": "2019-11-13T21:00:00-08:00",
      "temperature": {
        "minimum": {
          "value": 0.8,
          "unit": "C",
          "unitType": 17
        },
        "maximum": {
          "value": 5.3,
          "unit": "C",
          "unitType": 17
        }
      },
      "realFeelTemperature": {
        "minimum": {
          "value": -3.4,
          "unit": "C",
          "unitType": 17
        },
        "maximum": {
          "value": 1.3,
          "unit": "C",
          "unitType": 17
        }
      },
      "realFeelTemperatureShade": {
        "minimum": {
          "value": -3.4,
          "unit": "C",
          "unitType": 17
        },
        "maximum": {
          "value": 1.6,
          "unit": "C",
          "unitType": 17
        }
      },
      "hoursOfSun": 1.1,
      "degreeDaySummary": {
        "heating": {
          "value": 15,
          "unit": "C",
          "unitType": 17
        },
        "cooling": {
          "value": 0,
          "unit": "C",
          "unitType": 17
        }
      },
      "airAndPollen": [
        {
          "name": "AirQuality",
          "value": 0,
          "category": "Good",
          "categoryValue": 1,
          "type": "Ozone"
        },
        {
          "name": "Grass",
          "value": 0,
          "category": "Low",
          "categoryValue": 1
        },
        {
          "name": "Mold",
          "value": 0,
          "category": "Low",
          "categoryValue": 1
        },
        {
          "name": "Ragweed",
          "value": 0,
          "category": "Low",
          "categoryValue": 1
        },
        {
          "name": "Tree",
          "value": 0,
          "category": "Low",
          "categoryValue": 1
        },
        {
          "name": "UVIndex",
          "value": 0,
          "category": "Low",
          "categoryValue": 1
        }
      ],
      "day": {
        "iconCode": 12,
        "iconPhrase": "Showers",
        "hasPrecipitation": true,
        "precipitationType": "Rain",
        "precipitationIntensity": "Light",
        "shortPhrase": "Cloudy with a few showers",
        "longPhrase": "Cloudy with a couple of showers, mainly later",
        "precipitationProbability": 75,
        "thunderstormProbability": 20,
        "rainProbability": 75,
        "snowProbability": 40,
        "iceProbability": 0,
        "wind": {
          "direction": {
            "degrees": 160,
            "localizedDescription": "SSE"
          },
          "speed": {
            "value": 16.7,
            "unit": "km/h",
            "unitType": 7
          }
        },
        "windGust": {
          "direction": {
            "degrees": 160,
            "localizedDescription": "SSE"
          },
          "speed": {
            "value": 48.2,
            "unit": "km/h",
            "unitType": 7
          }
        },
        "totalLiquid": {
          "value": 6.1,
          "unit": "mm",
          "unitType": 3
        },
        "rain": {
          "value": 6.1,
          "unit": "mm",
          "unitType": 3
        },
        "snow": {
          "value": 0,
          "unit": "cm",
          "unitType": 4
        },
        "ice": {
          "value": 0,
          "unit": "mm",
          "unitType": 3
        },
        "hoursOfPrecipitation": 3.5,
        "hoursOfRain": 3.5,
        "hoursOfSnow": 0,
        "hoursOfIce": 0,
        "cloudCover": 100
      },
      "night": {
        "iconCode": 12,
        "iconPhrase": "Showers",
        "hasPrecipitation": true,
        "precipitationType": "Rain",
        "precipitationIntensity": "Light",
        "shortPhrase": "Breezy early; cloudy",
        "longPhrase": "Breezy this evening; otherwise, low clouds",
        "precipitationProbability": 65,
        "thunderstormProbability": 0,
        "rainProbability": 64,
        "snowProbability": 40,
        "iceProbability": 0,
        "wind": {
          "direction": {
            "degrees": 181,
            "localizedDescription": "S"
          },
          "speed": {
            "value": 20.4,
            "unit": "km/h",
            "unitType": 7
          }
        },
        "windGust": {
          "direction": {
            "degrees": 170,
            "localizedDescription": "S"
          },
          "speed": {
            "value": 42.6,
            "unit": "km/h",
            "unitType": 7
          }
        },
        "totalLiquid": {
          "value": 4,
          "unit": "mm",
          "unitType": 3
        },
        "rain": {
          "value": 4,
          "unit": "mm",
          "unitType": 3
        },
        "snow": {
          "value": 0,
          "unit": "cm",
          "unitType": 4
        },
        "ice": {
          "value": 0,
          "unit": "mm",
          "unitType": 3
        },
        "hoursOfPrecipitation": 2.5,
        "hoursOfRain": 2.5,
        "hoursOfSnow": 0,
        "hoursOfIce": 0,
        "cloudCover": 98
      },
      "sources": [
        "AccuWeather"
      ]
    }
  ]
}

Definitioner

Name Description
AirAndPollen
DailyForecast
DailyForecastResult
DailyForecastSummary

Sammanfattning av de viktigaste villkoren för den begärda tidsperioden. Observera att sammanfattningen endast kan omfatta en del av tidsperioden.
DayOrNight
DegreeDaySummary
ErrorAdditionalInfo

Ytterligare information om resurshanteringsfelet.
ErrorDetail

Felinformationen.
ErrorResponse

Felsvar
IconCode

Numeriskt värde som representerar en bild som visar iconPhrase. Mer information finns i Vädertjänster i Azure Maps.
JsonFormat

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

Information om lokala väderdataprovider.
PrecipitationType

Anger typen av nederbörd ("Regn" "Snö" "Is" eller "Blandning"). Om dbz är noll finns precipitationType inte i svaret.
UnitType

Numeriskt ID-värde som är associerat med den typ av enhet som visas. Kan användas för enhetsöversättning. Mer information finns i Vädertjänster i Azure Maps.
WeatherDataUnit

Anger att data ska returneras i antingen måttenheter eller kejserliga enheter. Standardvärdet är mått.
WeatherUnit

Specifikt värde för en viss enhet som är relaterad till väder.
WeatherUnitRange

Returnerade temperaturvärden.
WindDetails

Vinddetaljer returneras inklusive hastighet och riktning.
WindDirection

Vindriktning

AirAndPollen

Name Typ Description
category

string

Kategori av luftkvalitet eller föroreningstyp. Till exempel låg, hög, bra, måttlig, ohälsosam, farlig.
categoryValue

integer

Värde som är kopplat till luftkvalitets- eller föroreningskategorin. Dessa värden sträcker sig från 1 till 6. 1 innebär goda förhållanden, 6 vilket innebär farliga förhållanden.
name

string

Namnet på pollen eller förorening. Till exempel gräs, mögel, ogräs, luftkvalitet, träd och UV-index.
type

string

Det finns bara för luftkvaliteten. Exempel är ozon- och partikelföroreningar.
value

integer

Värdet för den angivna typen ovan. Värden som är associerade med mögel, gräs, gräs och träd är i enheter av delar per kubikmeter. Både luftkvalitet och UV är index, så de är enhetslösa.

DailyForecast

Name Typ Description
airAndPollen

AirAndPollen[]

Luftkvalitet
date

string

Datum och tid för den aktuella observationen visas i ISO 8601-format, till exempel 2019-10-27T19:39:57-08:00.
day

DayOrNight

Information om dagprognos
degreeDaySummary

DegreeDaySummary

Sammanfattning av genomsnittlig temperatur för information om dag- eller kylningsdag för värmegrad eller kylning
hoursOfSun

number

Timmar av sol.
night

DayOrNight

Nattprognosinformation
realFeelTemperature

WeatherUnitRange

RealFeel™ Temperature returneras.
realFeelTemperatureShade

WeatherUnitRange

RealFeel™ Temperature returneras. Beskriver hur temperaturen verkligen känns i skuggan.
sources

string[]

Källor för prognosdata.
temperature

WeatherUnitRange

Temperaturvärden för dagen.

DailyForecastResult

Name Typ Description
forecasts

DailyForecast[]

Prognosdata för varje begärd dag.
summary

DailyForecastSummary

Sammanfattning av de viktigaste villkoren för den begärda tidsperioden. Observera att sammanfattningen endast kan omfatta en del av tidsperioden.

DailyForecastSummary

Sammanfattning av de viktigaste villkoren för den begärda tidsperioden. Observera att sammanfattningen endast kan omfatta en del av tidsperioden.

Name Typ Description
category

string

ett eller två ord för att sammanfatta frasen.
endDate

string

Datum och tid som sammanfattningsperioden slutar, visas i ISO 8601-format, till exempel 2019-10-27T19:39:57-08:00.
phrase

string

Sammanfattningsfras för den dagliga prognosen. Visas på angivet språk.
severity

integer

allvarlighetsgrad
startDate

string

Datum och tid då sammanfattningen gäller, visas i ISO 8601-format, till exempel 2019-10-27T19:39:57-08:00.

DayOrNight

Name Typ Description
cloudCover

integer

Procent som representerar molntäcke.
hasPrecipitation

boolean

Anger förekomst eller frånvaro av nederbörd. Sant anger förekomsten av nederbörd, false anger frånvaron av nederbörd.
hoursOfIce

number

Timmar av is.
hoursOfPrecipitation

number

Timmar av nederbörd
hoursOfRain

number

Timmar av regn.
hoursOfSnow

number

Timmar av snö.
ice

WeatherUnit

Ice
iceProbability

integer

Procent som representerar sannolikheten för is. Till exempel "30".
iconCode

IconCode

Numeriskt värde som representerar en bild som visar iconPhrase. Mer information finns i Vädertjänster i Azure Maps.
iconPhrase

string

Frasbeskrivning av ikonen. Visas på angivet språk. Till exempel "Sunny".
localSource

LocalSource

Information om lokala väderdataprovider.
longPhrase

string

Frasbeskrivning av prognosen på angivet språk. Azure Maps försök att hålla den här frasen under 100 tecken lång, men vissa språk/väderhändelser kan resultera i en längre fraslängd som överstiger 100 tecken.
precipitationIntensity

string

Beskrivning av intensiteten.
precipitationProbability

integer

Procent som representerar sannolikheten för nederbörd. Till exempel "20".
precipitationType

PrecipitationType

Anger typen av nederbörd ("Rain" "Snow" "Ice" eller "Mix"). Om dbz är noll finns inte precipitationType i svaret.
rain

WeatherUnit

Regn
rainProbability

integer

Procent som representerar sannolikheten för regn. Till exempel "40".
shortPhrase

string

Frasbeskrivning av prognosen på angivet språk. Azure Maps försök att hålla den här frasen under 30 tecken lång, men vissa språk/väderhändelser kan resultera i en längre fraslängd som överstiger 30 tecken.
snow

WeatherUnit

Snö
snowProbability

integer

Procent som representerar sannolikheten för snö. Till exempel "30".
thunderstormProbability

integer

Procent som representerar sannolikheten för åskväder. Till exempel "80".
totalLiquid

WeatherUnit

Total vätskeekvivalent av nederbörd under prognosperioden.
wind

WindDetails

Vinddetaljer som returneras inklusive hastighet och riktning.
windGust

WindDetails

Vindbyar. Vindbyar är en plötslig, kort ökning av vindens hastighet.

DegreeDaySummary

Name Typ Description
cooling

WeatherUnit

Antal grader som medeltemperaturen är över 65 grader F/ 18 grader C.
heating

WeatherUnit

Antal grader som medeltemperaturen är under 65 grader F/ 18 grader C.

ErrorAdditionalInfo

Ytterligare information om resurshanteringsfelet.

Name Typ Description
info

object

Ytterligare information.
type

string

Den ytterligare informationstypen.

ErrorDetail

Felinformationen.

Name Typ Description
additionalInfo

ErrorAdditionalInfo[]

Ytterligare information om felet.
code

string

Felkoden.
details

ErrorDetail[]

Felinformationen.
message

string

Felmeddelandet.
target

string

Felmålet.

ErrorResponse

Felsvar

Name Typ Description
error

ErrorDetail

Felobjektet.

IconCode

Numeriskt värde som representerar en bild som visar iconPhrase. Mer information finns i Vädertjänster i Azure Maps.

Name Typ Description
1

Integer

10

Integer

11

Integer

12

Integer

13

Integer

14

Integer

15

Integer

16

Integer

17

Integer

18

Integer

19

Integer

2

Integer

20

Integer

21

Integer

22

Integer

23

Integer

24

Integer

25

Integer

26

Integer

27

Integer

28

Integer

29

Integer

3

Integer

30

Integer

31

Integer

32

Integer

33

Integer

34

Integer

35

Integer

36

Integer

37

Integer

38

Integer

39

Integer

4

Integer

40

Integer

41

Integer

42

Integer

43

Integer

44

Integer

5

Integer

6

Integer

7

Integer

8

Integer

9

Integer

JsonFormat

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

Name Typ Description
json

string

Datautbytesformat för JavaScript-objektnotation

LocalSource

Information om lokala väderdataprovider.

Name Typ Description
id

integer

Numerisk identifierare, unik för den lokala dataprovidern.
name

string

Namnet på den lokala dataprovidern. Namnet visas på det språk som anges av språkkoden i URL:en, om det är tillgängligt. Annars visas Namn på engelska eller på det språk där namnet angavs.
weatherCode

string

Väderkod som tillhandahålls av den lokala dataleverantören. Med den här väderkoden kan prognosen matchas mot ikoner som tillhandahålls av den lokala dataleverantören i stället för Azure Maps ikoner.

PrecipitationType

Anger typen av nederbörd ("Regn" "Snö" "Is" eller "Blandning"). Om dbz är noll finns precipitationType inte i svaret.

Name Typ Description
Ice

string

Ice
Mix

string

Mix
Rain

string

Regn
Snow

string

Snö

UnitType

Numeriskt ID-värde som är associerat med den typ av enhet som visas. Kan användas för enhetsöversättning. Mer information finns i Vädertjänster i Azure Maps.

Name Typ Description
0

Integer

1

Integer

10

Integer

11

Integer

12

Integer

13

Integer

14

Integer

15

Integer

16

Integer

17

Integer

18

Integer

19

Integer

2

Integer

20

Integer

21

Integer

22

Integer

3

Integer

31

Integer

4

Integer

5

Integer

6

Integer

7

Integer

8

Integer

9

Integer

WeatherDataUnit

Anger att data ska returneras i antingen måttenheter eller kejserliga enheter. Standardvärdet är mått.

Name Typ Description
imperial

string

Returnera data i kejserliga enheter. Några exempelenheter av imperialistiskt system är Fahrenheit och mile.
metric

string

Returnera data i måttenheter. Några exempelenheter för måttsystem är Celsius och kilometer.

WeatherUnit

Specifikt värde för en viss enhet som är relaterad till väder.

Name Typ Description
unit

string

Typ av enhet för det returnerade värdet.
unitType

UnitType

Numeriskt ID-värde som är associerat med den typ av enhet som visas. Kan användas för enhetsöversättning. Mer information finns i Vädertjänster i Azure Maps.
value

number

Avrundat värde.

WeatherUnitRange

Returnerade temperaturvärden.

Name Typ Description
maximum

WeatherUnit

Maximal temperatur för tidsperioden
minimum

WeatherUnit

Minimitemperatur för tidsperioden.

WindDetails

Vinddetaljer returneras inklusive hastighet och riktning.

Name Typ Description
direction

WindDirection

Vindriktning
speed

WeatherUnit

Vindhastighet i angiven enhet.

WindDirection

Vindriktning

Name Typ Description
degrees

integer

Vindriktning i Azimuth grader, börjar på true North och fortsätter i medurs riktning. Nord är 0 grader, öst är 90 grader, söder är 180 grader, väst är 270 grader. Möjliga värden 0–359.
localizedDescription

string

Riktningsförkortning på det angivna språket.