Dela via

Weather - Get Daily Forecast

  • Referens
Tjänst:
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}
Med valfria parametrar: 
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å 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 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äkerhetsmodellen. Det representerar ett unikt ID för Azure Maps-kontot och kan hämtas från Konto-API:et för Azure Maps-hanteringsplan. 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 REST-API:er för Azure Maps. Rollbaserade åtkomstkontroller i Azure används för att ange åtkomst till ett eller flera Azure Maps-resurskonton 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 till Rest-API:er för Azure Maps.

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 ha å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 programmet begär åtkomst till. Detta kan hämtas från MAPS-hanterings-API :et.

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

Typ: oauth2
Flow: implicit
Auktoriseringswebbadress: https://login.microsoftonline.com/common/oauth2/authorize

Omfattningar

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 skapar ett Azure Maps-konto i Azure-portalen eller använder 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 huvudnyckel i det konto som de har utfärdats i.

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

Typ: apiKey
I: query

SAS Token

Det här är en signaturtoken för delad åtkomst som skapas från åtgärden List SAS 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 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 säkrare 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 daily weather forecast for a given coordinate location

Exempelbegäran

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

Exempelsvar

Statuskod:
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 ("Rain" "Snow" "Ice" eller "Mix"). Om dbz är noll finns inte precipitationType 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 som 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 luftkvaliteten eller föroreningskategorin. Dessa värden sträcker sig från 1 till 6. 1 innebär goda förhållanden, 6 som 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

Finns endast för luftkvalitet. 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, ogräs och träd finns i 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 som 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 uppvärmningsgrader dag eller kylningsgrad dag
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älla för prognosdata.
temperature

WeatherUnitRange

Temperaturvärden för dagen.

DailyForecastResult

Name Typ Description
forecasts

DailyForecast[]

Prognostisera data 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 då 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 tillämpas, 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örekomsten eller frånvaron av nederbörd. True anger förekomsten av nederbörd, false anger frånvaron av nederbörd.
hoursOfIce

number

Timmar av is.
hoursOfPrecipitation

number

Nederbördstimmar
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öker 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 ("Regn" "Snö" "Is" eller "Blandning"). Om dbz är noll finns precipitationType inte 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öker 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 åska. Till exempel "80".
totalLiquid

WeatherUnit

Total vätskeekvivalent för nederbörd under prognosperioden.
wind

WindDetails

Vinddetaljer returneras inklusive hastighet och riktning.
windGust

WindDetails

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

Den ytterligare informationen.
type

string

Ytterligare informationstyp.

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, 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 med ikoner som tillhandahålls av den lokala dataleverantören i stället för Azure Maps-ikoner.

PrecipitationType

Anger typen av nederbörd ("Rain" "Snow" "Ice" eller "Mix"). Om dbz är noll finns inte precipitationType 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 i det kejserliga systemet ä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 som 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. Norr ä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.