Weather - Get Daily Forecast

Tjänst:: Maps

API-version:: 1.1

Används 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 inkluderar detaljer som temperatur, vind, nederbörd, luftkvalitet och UV-index. Mer information finns i Begära dagliga väderprognosdata.

GET {endpoint}/weather/forecast/daily/json?api-version=1.1&query={query}

Med valfria parametrar:

GET {endpoint}/weather/forecast/daily/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)	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. `45` - Returnera prognosdata för de kommande 45 dagarna.
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	DailyForecastResult	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 daily weather forecast for a given coordinate location

Exempelbegäran

HTTP

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

Exempelsvar

Statuskod:: 200

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

Definitioner

Name	Description
AirAndPollen	En post i `DailyForecast.airAndPollen` beskrivningen av en enda pollen-, luftkvalitets- eller UV-indexindikator för dagen. Egenskapen `name` avgör vilken typ av indikator posten representerar: Pollen: `name` är träd, gräs, ambrosia eller mögel. `value`ger prognosbeloppet och `category` / `categoryValue` betygsätt det från låg till hög. Luftkvalitet: `name` är luftkvalitet och `type` identifierar den förorening som mäts (en av PM2,5, PM10, O3, NO2, SO2 eller CO). `category` / `categoryValue`Betygsätt luftkvaliteten från Bra till Farlig. UV-index: `name` är UVIndex. `value`är UV-indexet (0 till 11+), och `category` / `categoryValue` bedöm exponeringsrisken från låg till extrem. `category` är den kvalitativa etiketten för indikatorn och `categoryValue` är den matchande betyget 1-6, där 1 indikerar de säkraste förhållandena och 6 den farligaste.
DailyForecast	Prognosen för en kalenderdag på den angivna platsen returnerades som en post per dag i matrisen `forecasts` på `DailyForecastResult`. Inkluderar dagens högsta och låga temperaturintervall, RealFeel-intervall (vanliga och skuggade), förväntade soltimmar, uppvärmning/kylning av gradsnivåer under dagen, en rad indikatorer för luftkvalitet, pollen och UV-index samt separata detaljblock för dag- och nattperioder (nederbörd, vind, molntäcke och mer). Arrayen `sources` listar de dataleverantörer som bidrar till prognosen.
DailyForecastDetail	Prognosdetaljer för en halv dag. Samma form används för både `DailyForecast.day` (soluppgång till solnedgång) och `DailyForecast.night` (solnedgång till nästa soluppgång), så alla referenser till "denna period" nedan betyder just den delen dagtid eller natt – aldrig hela dygnet runt. Innehåller en prognosikon och fraser, nederbördstyp / intensitet / sannolikheter, ackumuleringssummor, nederbördstimmar, vind och molntäcke.
DailyForecastResult	Svaret återkom av Get Daily Forecast-verksamheten, som gav en dag-för-dag väderprognos för en angiven plats. Inkluderar en toppnivå `summary` som beskriver de dominerande förhållandena och svårighetsgraden för det begärda fönstret, plus en `forecasts` array med en `DailyForecast` post per dag. Antalet poster matchar det begärda `duration` (1, 5, 10, 15, 25 eller 45 dagar; 25 och 45 kräver en S1-SKU).
DailyForecastSummary	En översikt på hög nivå av de dominerande väderförhållandena över delar eller hela det begärda dagliga prognosfönstret. Det sammanfattade fönstret kan vara smalare än hela begäran – till exempel när betydande väderförhållanden (såsom ett stormsystem) förväntas under endast en del av perioden – och avgränsas av `startDate` och `endDate`. Villkoren själva beskrivs både som en fri form `phrase`, en etikett med ett eller två ord `category` och en numerisk `severity` klassificering.
DegreeDaySummary	Uppvärmnings- och kylningsgrader för en enda dag, som används för att uppskatta energibehovet för uppvärmning eller kylning av en byggnad. Varje värde är antalet grader med vilka dagens medeltemperatur skiljer sig från baslinjen på 65°F (18°C), i den temperaturenhet som anges i begäran – grader under baslinjen bidrar till `heating`, grader över den bidrar till `cooling`.
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.).
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.
LocalSource	Information om en lokal väderdataleverantör som används för att hämta prognosen på `DailyForecastDetail.localSource`. Identifierar leverantören (`id`, `name`) och exponerar leverantörens native `weatherCode` så att applikationer kan rendera leverantörens egen ikonuppsättning istället för standardikonerna i Azure Maps.
PrecipitationType	Anger typen av nederbörd. Giltiga värden är Regn,Snö, Is eller Blandning. Den här egenskapen ingår i svaret när dBZ är större än noll.
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.
WeatherValueRange	Tillhandahåller de högsta och lägsta prognostiserade temperaturerna för den angivna tidsramen, mätt i grader Celsius (°C) eller Fahrenheit (°F), baserat på den enhet som anges i förfrågan.
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.

AirAndPollen

Objekt

En post i DailyForecast.airAndPollen beskrivningen av en enda pollen-, luftkvalitets- eller UV-indexindikator för dagen. Egenskapen name avgör vilken typ av indikator posten representerar:

Pollen: name är träd, gräs, ambrosia eller mögel. valueger prognosbeloppet och category / categoryValue betygsätt det från låg till hög.
Luftkvalitet: name är luftkvalitet och type identifierar den förorening som mäts (en av PM2,5, PM10, O3, NO2, SO2 eller CO). category / categoryValueBetygsätt luftkvaliteten från Bra till Farlig.
UV-index: name är UVIndex. valueär UV-indexet (0 till 11+), och category / categoryValue bedöm exponeringsrisken från låg till extrem.

category är den kvalitativa etiketten för indikatorn och categoryValue är den matchande betyget 1-6, där 1 indikerar de säkraste förhållandena och 6 den farligaste.

Name	Typ	Description
category	string	En kort kvalitativ etikett för indikatorn, returnerad på det språk som anges i förfrågan. Möjliga värden beror på `name`: Pollen: Låg, måttlig, hög eller mycket hög. Luftkvalitet: Bra, måttlig, ohälsosam för känsliga grupper, ohälsosam, mycket ohälsosam eller farlig. UV-index: Lågt, Måttligt, Högt, Mycket högt eller Extremt.
categoryValue	integer (int32)	En numerisk rating från 1 till 6 som paras med `category`, där 1 anger de säkraste förhållandena och 6 de farligaste. Använd detta när ett stabilt, språkoberoende numeriskt värde behövs istället för den lokaliserade `category` etiketten.
name	string	Identifierar vilken indikator denna post representerar. Antingen namnet på en pollenkälla (träd, gräs, ambrosia eller mögel), luftkvalitet (i så fall `type` identifierar föroreningen) eller UVIndex.
type	string	När `name` är luftkvalitet, den specifika föroreningen som mäts en av PM2,5, PM10, O3 (ozon), NO2 (kvävedioxid), SO2 (svaveldioxid) eller CO (kolmonoxid). Inte returnerad för pollen- eller UV-index-inträden.
value	integer (int32)	Den numeriska mätningen för denna indikator. Enheten beror på `name`: För pollen, prognosen för pollenantalet. För luftkvalitet anges föroreningskoncentrationen i enheter som är lämpliga för föroreningen – vanligtvis mikrogram per kubikmeter (μg/m³) för partiklar och delar per miljard (ppb) för gaser som ozon. För UV-index, ett indexvärde från 0 till 11+. Både luftkvalitet och UV-index är i sig index, så de rapporteras som enhetslösa siffror.

DailyForecast

Objekt

Prognosen för en kalenderdag på den angivna platsen returnerades som en post per dag i matrisen forecasts på DailyForecastResult. Inkluderar dagens högsta och låga temperaturintervall, RealFeel-intervall (vanliga och skuggade), förväntade soltimmar, uppvärmning/kylning av gradsnivåer under dagen, en rad indikatorer för luftkvalitet, pollen och UV-index samt separata detaljblock för dag- och nattperioder (nederbörd, vind, molntäcke och mer). Arrayen sources listar de dataleverantörer som bidrar till prognosen.

Name	Typ	Description
airAndPollen	AirAndPollen[]	Prognoser för luftkvalitet, pollen och UV-index för dagen. Varje post rapporterar ett namn (såsom Träd, Gräs, Ambrosia, Mögel, Luftkvalitet eller UVIndex), ett numeriskt värde och ett kvalitativt `category` värde (såsom Låg, Måttligt, Hög,Bra, Ohälsosamt eller Farligt) så att ansökningar kan flagga potentiella hälsorisker.
date	string (date-time)	Kalenderdatumet som denna prognos täcker, i ISO 8601-format (`yyyy-mm-ddThh:mm:ss-hh:mm`). Till exempel, 2025-04-29T07:00:00-07:00.
day	DailyForecastDetail	Den detaljerade prognosen för dagens dagsdel – inklusive temperatur, nederbörd, vind, molntäcke och andra viktiga egenskaper.
degreeDaySummary	DegreeDaySummary	Uppvärmnings- och kylningsgrader för dagen används för att uppskatta energibehovet för byggnadens klimatanläggning.
hoursOfSun	number (float)	Det förväntade antalet soltimmar under dagen, användbart för att planera utomhusaktiviteter och bedöma de allmänna dagtiderna.
night	DailyForecastDetail	Den detaljerade prognosen för nattens del av dagen – inklusive temperatur, nederbörd, vind, molntäcke och andra viktiga egenskaper.
realFeelTemperature	WeatherValueRange	De höga och låga RealFeel-temperaturvärdena™ för dagen, i grader Celsius (°C) eller Fahrenheit (°F), beroende på vilken enhet som anges i förfrågan. Utvecklat av AccuWeather kombinerar RealFeel lufttemperatur med luftfuktighet, vind, molntäcke, solintensitet och andra faktorer för att visa hur vädret faktiskt känns. För mer information, se Vad är AccuWeather RealFeel-temperatur?
realFeelTemperatureShade	WeatherValueRange	De höga och låga RealFeel-temperaturvärdena™ för dagen i skuggade områden, i grader Celsius (°C) eller Fahrenheit (°F), beroende på vilken enhet som anges i förfrågan. Som `realFeelTemperature`, men utesluter den varma effekten av direkt solljus, vilket ger en mer exakt känsla av hur vädret känns i skuggan.
sources	string[]	Dataleverantörerna som bidrog till dagens prognos.
temperature	WeatherValueRange	De prognostiserade höga och låga lufttemperaturerna för dagen, i grader Celsius (°C) eller Fahrenheit (°F), beroende på vilken enhet som anges i begäran.

DailyForecastDetail

Objekt

Prognosdetaljer för en halv dag. Samma form används för både DailyForecast.day (soluppgång till solnedgång) och DailyForecast.night (solnedgång till nästa soluppgång), så alla referenser till "denna period" nedan betyder just den delen dagtid eller natt – aldrig hela dygnet runt. Innehåller en prognosikon och fraser, nederbördstyp / intensitet / sannolikheter, ackumuleringssummor, nederbördstimmar, vind och molntäcke.

Name	Typ	Description
cloudCover	integer (int32)	Andelen av himlen täckt av moln under denna period, från 0 (klar himmel) till 100 (helt mulet). Kan vara NULL.
hasPrecipitation	boolean	`true` om någon nederbörd (regn, snö, snöblandat regn eller hagel) förväntas under denna period; `false` annars.
hoursOfIce	number (float)	Det totala antalet timmar under denna period då isbildning förväntas.
hoursOfPrecipitation	number (float)	Det totala antalet timmar under denna period då nederbörd (regn, snö, snöblandat regn eller hagel) förväntas.
hoursOfRain	number (float)	Det totala antalet timmar under denna period då regn förväntas.
hoursOfSnow	number (float)	Det totala antalet timmar under denna period då snö förväntas.
ice	WeatherValue	Mängden isbildning som förväntas under denna period, i millimeter (mm) eller tum (in) beroende på vilken enhet som anges i begäran.
iceProbability	integer (int32)	Sannolikheten för isbildning under denna period, uttryckt som en procentandel från 0 till 100, där 0 betyder ingen risk för is och 100 betyder att isförhållandena är säkra.
iconCode	IconCode	Numeriskt värde som representerar en bild som motsvarar det prognostiserade väderläget för denna period, beskrivet av egenskapen `iconPhrase` . Det numeriska värdet motsvarar en Azure Maps-väderikon – för den kompletta listan, se Vädertjänster i Azure Maps. Kan vara NULL.
iconPhrase	string	En kort fras som beskriver ikonen, returnerad på det språk som anges i förfrågan. Till exempel Sunny.
localSource	LocalSource	Information om den lokala väderdataleverantören vars ikon- och väderkod användes under denna period, när en sådan valdes ut.
longPhrase	string	En längre, mer beskrivande fras för denna period, återlämnad på det språk som angavs i begäran. Azure Maps försöker hålla denna fras under 100 tecken, men vissa språk eller väderhändelser kan producera en längre sträng.
precipitationIntensity	string	En kort kvalitativ beskrivning av nederbördsintensiteten för denna period – till exempel lätt, måttlig eller kraftig. Returneras i det språk som anges i begäran, och endast när `hasPrecipitation` är `true`.
precipitationProbability	integer (int32)	Sannolikheten för nederbörd under denna period, uttryckt som en procentandel från 0 till 100, där 0 betyder ingen chans till nederbörd och 100 betyder att nederbörden är säker.
precipitationType	PrecipitationType	Den dominerande typen av nederbörd som förväntas under denna period – regn,snö,is eller blandning. Returneras endast när `hasPrecipitation` är `true`.
rain	WeatherValue	Mängden nederbörd som förväntas under denna period, i millimeter (mm) eller tum (in) beroende på vilken enhet som anges i begäran.
rainProbability	integer (int32)	Sannolikheten för regn under denna period, uttryckt som en procentandel från 0 till 100, där 0 betyder ingen chans till regn och 100 betyder att regn är säkert.
shortPhrase	string	En kort fras som beskriver prognosen för denna period, returnerad på det språk som anges i förfrågan. Azure Maps försöker hålla denna fras under 30 tecken, men vissa språk eller väderhändelser kan producera en längre sträng.
snow	WeatherValue	Mängden snö som förväntas under denna period, i centimeter (cm) eller tum (in) beroende på vilken enhet som anges i begäran.
snowProbability	integer (int32)	Sannolikheten för snö under denna period, uttryckt som en procentandel från 0 till 100, där 0 betyder ingen chans till snö och 100 betyder att snö är säker.
thunderstormProbability	integer (int32)	Sannolikheten för åskväder under denna period, uttryckt som en procentandel från 0 till 100, där 0 betyder ingen chans för åskväder och 100 betyder att ett åskväder är säkert.
totalLiquid	WeatherValue	Den totala mängden flytande nederbörd (såsom regn, plus vätskemotsvarigheten till eventuell snö eller is) som förväntas under denna period, i millimeter (mm) eller tum (in) beroende på vilken enhet som anges i begäran.
wind	WindDetails	Den prognostiserade vindhastigheten och riktningen för denna period. Vindhastigheten är i kilometer per timme (km/h) eller miles per timme (mph) beroende på vilken enhet som anges i förfrågan. Vindriktningen målas i azimutgrader, från 0° (sann nord) till 359°, medurs – öster är 90°, söder är 180°, väst är 270°.
windGust	WindDetails	Den förväntade maximala korta vindhastigheten och riktningen under denna period. Vindbyar är plötsliga, korta ökningar i vindhastighet som är viktiga för aktiviteter som flyg, segling och drakeflygning. Hastigheten anges i kilometer per timme (km/h) eller miles per timme (mph) beroende på vilken enhet som anges i begäran, och riktningen använder samma azimutkonvention som `wind`.

DailyForecastResult

Objekt

Svaret återkom av Get Daily Forecast-verksamheten, som gav en dag-för-dag väderprognos för en angiven plats. Inkluderar en toppnivå summary som beskriver de dominerande förhållandena och svårighetsgraden för det begärda fönstret, plus en forecasts array med en DailyForecast post per dag. Antalet poster matchar det begärda duration (1, 5, 10, 15, 25 eller 45 dagar; 25 och 45 kräver en S1-SKU).

Name Typ Description

forecasts

Name	Typ	Description
forecasts	DailyForecast[]	Prognoserna per dag, i kronologisk ordning med en post per dag i den begärda `duration`. Varje post rapporterar `DailyForecast` dagens högsta och lägsta temperatur, RealFeel-intervall, soltimmar, uppvärmning/kylning av grader under dagen, luft- och pollenindex, separata dag- och nattdetaljblock (nederbörd, vind, molntäcke och mer) samt de datakällor som bidrar till prognosen.
summary	DailyForecastSummary	En övergripande sammanfattning av de dominerande väderförhållandena under det begärda prognosfönstret. Sammanfattningen kan täcka endast en del av fönstret till exempel när betydande väder (som ett stormsystem) förväntas under en del av det – istället för hela perioden.

DailyForecast[]

Prognoserna per dag, i kronologisk ordning med en post per dag i den begärda duration. Varje post rapporterar DailyForecast dagens högsta och lägsta temperatur, RealFeel-intervall, soltimmar, uppvärmning/kylning av grader under dagen, luft- och pollenindex, separata dag- och nattdetaljblock (nederbörd, vind, molntäcke och mer) samt de datakällor som bidrar till prognosen.

summary

DailyForecastSummary

En övergripande sammanfattning av de dominerande väderförhållandena under det begärda prognosfönstret. Sammanfattningen kan täcka endast en del av fönstret

till exempel när betydande väder (som ett stormsystem) förväntas under en del av det – istället för hela perioden.

DailyForecastSummary

Objekt

En översikt på hög nivå av de dominerande väderförhållandena över delar eller hela det begärda dagliga prognosfönstret. Det sammanfattade fönstret kan vara smalare än hela begäran – till exempel när betydande väderförhållanden (såsom ett stormsystem) förväntas under endast en del av perioden – och avgränsas av startDate och endDate. Villkoren själva beskrivs både som en fri form phrase, en etikett med ett eller två ord category och en numerisk severity klassificering.

Name	Typ	Description
category	string	En etikett på ett eller två ord som kategoriserar de dominerande väderförhållandena för det sammanfattade fönstret – till exempel Soligt, Delvis molnigt, Regn eller Snö.
endDate	string (date-time)	Slutet av fönstret som täcks av denna sammanfattning, i RFC 3339-format – till exempel 2019-10-29T07:00:00-08:00. Kan vara tidigare än slutet av det begärda prognosfönstret om den sammanfattade händelsen slutar innan det.
phrase	string	En kort, fri textsammanfattning av de dominerande väderförhållandena för det sammanfattade fönstret, återlämnad på det språk som anges i begäran. Till exempel, förvänta dig skurar tisdag till torsdag.
severity	integer (int32)	En numerisk allvarlighetsgrad för den sammanfattade väderhändelsen. Lägre siffror (exklusive 0) indikerar högre svårighetsgrad: 0: Okänd 1: Betydande 2: Större 3: Måttligt 4: Mindre 5: Minimalt 6: Obetydlig 7: Informationsmaterial
startDate	string (date-time)	Början av fönstret som täcks av denna sammanfattning, i RFC 3339-format – till exempel 2019-10-27T19:39:57-08:00. Kan vara senare än början av det begärda prognosfönstret om den sammanfattade händelsen börjar mitt i det.

DegreeDaySummary

Objekt

Uppvärmnings- och kylningsgrader för en enda dag, som används för att uppskatta energibehovet för uppvärmning eller kylning av en byggnad. Varje värde är antalet grader med vilka dagens medeltemperatur skiljer sig från baslinjen på 65°F (18°C), i den temperaturenhet som anges i begäran – grader under baslinjen bidrar till heating, grader över den bidrar till cooling.

Name	Typ	Description
cooling	WeatherValue	Kylande grader dagar (CDD) – antalet grader som dagens medeltemperatur stiger över 18°C (65°F). Högre värden indikerar större kylbehov. Rapporteras i grader Celsius (°C) eller Fahrenheit (°F) beroende på vilken enhet som anges i begäran.
heating	WeatherValue	Värmegradersdagar (HDD) – antalet grader medeltemperaturen under 18°C (65°F). Högre värden indikerar större värmebehov. Rapporteras i grader Celsius (°C) eller Fahrenheit (°F) beroende på vilken enhet som anges i begäran.

ErrorAdditionalInfo

Objekt

Ytterligare information om resurshanteringsfelet.

Name	Typ	Description
info		Ytterligare information.
type	string	Ytterligare informationstyp.

ErrorDetail

Objekt

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

Objekt

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.

IconCode

Uppräkning

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

Uppräkning

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

Värde	Description
json	JavaScript-objekt notationens datautbytesformat

LocalSource

Objekt

Information om en lokal väderdataleverantör som används för att hämta prognosen på DailyForecastDetail.localSource. Identifierar leverantören (id, name) och exponerar leverantörens native weatherCode så att applikationer kan rendera leverantörens egen ikonuppsättning istället för standardikonerna i Azure Maps.

Name	Typ	Description
id	integer (int32)	En numerisk identifierare som unikt identifierar den lokala dataleverantören.
name	string	Namnet på den lokala dataleverantören, returnerat på det språk som anges i begäran när det är tillgängligt; annars returnerat på engelska eller det språk som leverantören levererade det på.
weatherCode	string	Den leverantörsbaserade väderkoden för denna prognos, lämplig för att mappa till leverantörens egen ikonuppsättning istället för standardversionen av Azure Maps`iconCode`.

PrecipitationType

Uppräkning

Anger typen av nederbörd. Giltiga värden är Regn,Snö, Is eller Blandning. Den här egenskapen ingår i svaret när dBZ är större än noll.

Värde	Description
Ice	Is
Mix	Mix
Rain	Regn
Snow	Snow

UnitType

Uppräkning

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

Uppräkning

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

Objekt

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.

WeatherValueRange

Objekt

Tillhandahåller de högsta och lägsta prognostiserade temperaturerna för den angivna tidsramen, mätt i grader Celsius (°C) eller Fahrenheit (°F), baserat på den enhet som anges i förfrågan.

Name	Typ	Description
maximum	WeatherValue	Anger maximal temperatur för den angivna tidsramen, mätt i grader Celsius (°C) eller Fahrenheit (°F), baserat på enheten som anges i begäran.
minimum	WeatherValue	Anger minimitemperaturen för den angivna tidsramen, mätt i grader Celsius (°C) eller Fahrenheit (°F), baserat på enheten som anges i begäran.

WindDetails

Objekt

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

Objekt

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.