Weather - Get Current Conditions

Används för att få aktuella väderförhållanden.
API:et Get Current Conditions är en HTTP-begäran GET som returnerar detaljerade aktuella väderförhållanden som nederbörd, temperatur och vind för en viss koordinatplats. Dessutom kan observationer från de senaste 6 eller 24 timmarna för en viss plats hämtas. Den grundläggande informationen som returneras med svaret innehåller information som observationsdatum och tid, kort beskrivning av väderförhållandena, väderikon, flaggor för nederbördsindikator och temperatur. Ytterligare information som RealFeel™ Temperature och UV-index returneras också. Mer information finns i Begära väderdata i realtid

GET {endpoint}/weather/currentConditions/json?api-version=1.1&query={query}
GET {endpoint}/weather/currentConditions/json?api-version=1.1&query={query}&unit={unit}&details={details}&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.

details
query

string

Returnera fullständig information om de aktuella villkoren. Tillgängliga värden är

  • true - Returnerar fullständig information. Som standard returneras all information.
  • false - Returnerar en trunkerad version av data för det aktuella tillståndet, som inkluderar observationsdatum, tid, väderfras, ikonkod, nederbördsindikatorflagga och temperatur.
duration
query

integer (int32)

Tidsram för de returnerade väderförhållandena. Som standard returneras de senaste väderförhållandena. Standardvärdet är 0. Värden som stöds är:

  • 0 - Returnera de senaste väderförhållandena.
  • 6 - Returnera väderförhållanden från de senaste 6 timmarna.
  • 24 - Återgå till väderförhållanden från de senaste 24 timmarna.
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

CurrentConditionsResult

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 current weather conditions for a given coordinate location

Exempelbegäran

GET https://atlas.microsoft.com/weather/currentConditions/json?api-version=1.1&query=47.641268,-122.125679

Exempelsvar

{
  "results": [
    {
      "apparentTemperature": {
        "unit": "C",
        "unitType": 17,
        "value": 16.1
      },
      "ceiling": {
        "unit": "m",
        "unitType": 5,
        "value": 4359
      },
      "cloudCover": 95,
      "dateTime": "2019-11-14T15:08:00-08:00",
      "dewPoint": {
        "unit": "C",
        "unitType": 17,
        "value": 9.2
      },
      "hasPrecipitation": false,
      "iconCode": 7,
      "isDayTime": true,
      "obstructionsToVisibility": "",
      "pastTwentyFourHourTemperatureDeparture": {
        "unit": "C",
        "unitType": 17,
        "value": 1.8
      },
      "phrase": "Cloudy",
      "precipitationSummary": {
        "past12Hours": {
          "unit": "mm",
          "unitType": 3,
          "value": 0.8
        },
        "past18Hours": {
          "unit": "mm",
          "unitType": 3,
          "value": 0.8
        },
        "past24Hours": {
          "unit": "mm",
          "unitType": 3,
          "value": 0.8
        },
        "past3Hours": {
          "unit": "mm",
          "unitType": 3,
          "value": 0.8
        },
        "past6Hours": {
          "unit": "mm",
          "unitType": 3,
          "value": 0.8
        },
        "past9Hours": {
          "unit": "mm",
          "unitType": 3,
          "value": 0.8
        },
        "pastHour": {
          "unit": "mm",
          "unitType": 3,
          "value": 0.5
        }
      },
      "pressure": {
        "unit": "mb",
        "unitType": 14,
        "value": 1014.9
      },
      "pressureTendency": {
        "code": "S",
        "localizedDescription": "Steady"
      },
      "realFeelTemperature": {
        "unit": "C",
        "unitType": 17,
        "value": 13.6
      },
      "realFeelTemperatureShade": {
        "unit": "C",
        "unitType": 17,
        "value": 13.6
      },
      "relativeHumidity": 75,
      "temperature": {
        "unit": "C",
        "unitType": 17,
        "value": 13.7
      },
      "temperatureSummary": {
        "past12Hours": {
          "maximum": {
            "unit": "C",
            "unitType": 17,
            "value": 13.7
          },
          "minimum": {
            "unit": "C",
            "unitType": 17,
            "value": 5.9
          }
        },
        "past24Hours": {
          "maximum": {
            "unit": "C",
            "unitType": 17,
            "value": 13.7
          },
          "minimum": {
            "unit": "C",
            "unitType": 17,
            "value": 5.9
          }
        },
        "past6Hours": {
          "maximum": {
            "unit": "C",
            "unitType": 17,
            "value": 13.7
          },
          "minimum": {
            "unit": "C",
            "unitType": 17,
            "value": 8.3
          }
        }
      },
      "uvIndex": 0,
      "uvIndexPhrase": "Low",
      "visibility": {
        "unit": "km",
        "unitType": 6,
        "value": 8
      },
      "wetBulbTemperature": {
        "unit": "C",
        "unitType": 17,
        "value": 11.4
      },
      "wind": {
        "direction": {
          "degrees": 315,
          "localizedDescription": "NW"
        },
        "speed": {
          "unit": "km/h",
          "unitType": 7,
          "value": 3.6
        }
      },
      "windChillTemperature": {
        "unit": "C",
        "unitType": 17,
        "value": 13.9
      },
      "windGust": {
        "speed": {
          "unit": "km/h",
          "unitType": 7,
          "value": 4.9
        }
      }
    }
  ]
}

Definitioner

Name Description
CurrentConditions

En enda väderobservation för den angivna platsen, returnerad av funktionen Get Current Conditions. Beroende på begäran durationkan denna observation vara den senaste (senaste) avläsningen eller en av de föregående timobservationerna. Som standard returneras en förenklad delmängd: observationsdatum och -tid, väderfras, ikonkod, nederbördsindikator och temperatur. När förfrågan begär fullständiga detaljer inkluderas varje fastighet, med tillägg av mått som RealFeel, daggpunkt, vind, sikt, molntäcke, tryck samt rullande nederbörds- och temperatursammanfattningar för de senaste timmarna.

CurrentConditionsResult

Svaret returneras av operationen Get Current Conditions, som innehåller en eller flera observationer med aktuella villkor för en specificerad plats. Som standard returneras en enda observation för nuvarande tid; när parametern duration sätts till 6 eller 24 inkluderar svaret också en observation per föregående timme under det fönstret.

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.

PastHoursTemperature

De högsta och lägsta lufttemperaturerna som observerats under ett av de rullande fönstren (efter TemperatureSummary 6, 12 eller 24 timmar), i grader Celsius (°C) eller Fahrenheit (°F) beroende på vilken enhet som anges i begäran.

PrecipitationSummary

Den totala vätskeekvivalenta nederbörden som fallit på observationsplatsen över rullande fönster som slutar vid observationstiden. Varje värde täcker hela fönstret mätt bakåt från "nu" – till exempel past3Hours är det löpande totalvärdet för de senaste tre timmarna, inte bara den tredje timmen – så att fönstren överlappar och längre fönster inkluderar nederbörden som rapporterats för de kortare. Snö och is bidrar med sin smälta (flytande) motsvarighet. Rapporteras i millimeter (mm) eller tum (in) beroende på vilken enhet som anges i förfrågan.

PressureTendency

Den senaste trenden i atmosfärstryck – oavsett om trycket stiger, sjunker eller är stabilt – återkom både som en lokal fras och en enbokstavskod. Användbar för att förutse kortsiktiga väderförändringar; fallande tryck signalerar ofta försämrat väder, medan stigande tryck vanligtvis indikerar förbättrade förhållanden.

TemperatureSummary

De högsta och lägsta lufttemperaturerna som observerades på platsen över rullande fönster som slutade vid observationstiden. Varje värde täcker hela fönstret som mäts bakåt från "nu" – till exempel rapporterar past12Hours de högsta och lägsta under de senaste 12 timmarna, inte bara den tolfte timmen – så att fönstren överlappar och längre fönster inkluderar de temperaturer som rapporteras för de kortare. Rapporteras i grader Celsius (°C) eller Fahrenheit (°F) beroende på vilken enhet som anges i begäran.

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.

CurrentConditions

En enda väderobservation för den angivna platsen, returnerad av funktionen Get Current Conditions. Beroende på begäran durationkan denna observation vara den senaste (senaste) avläsningen eller en av de föregående timobservationerna. Som standard returneras en förenklad delmängd: observationsdatum och -tid, väderfras, ikonkod, nederbördsindikator och temperatur. När förfrågan begär fullständiga detaljer inkluderas varje fastighet, med tillägg av mått som RealFeel, daggpunkt, vind, sikt, molntäcke, tryck samt rullande nederbörds- och temperatursammanfattningar för de senaste timmarna.

Name Typ Description
apparentTemperature

WeatherValue

Den upplevda temperaturen vid observationstillfället – hur luften faktiskt känns för människor, med hänsyn till lufttemperatur, relativ luftfuktighet och vindhastighet. Mäts i grader Celsius (°C) eller Fahrenheit (°F), beroende på vilken enhet som anges i begäran.

ceiling

WeatherValue

Molntaket vid observationstiden – höjden över marken på det lägsta molnlagret – i fot (fot) eller meter (m) beroende på enheten som specificeras i begäran. Viktigt för flyget, eftersom det påverkar flygets sikt och operationer.

cloudCover

integer (int32)

Andelen av himlen täckt av moln vid observationstillfället, från 0 (klart) till 100 (mulet). Kan vara NULL.

dateTime

string (date-time)

Datum och tid för denna observation, i RFC 3339-format (yyyy-mm-ddThh:mm:ss-hh:mm). Till exempel, 2025-04-29T07:00:00-07:00.

dewPoint

WeatherValue

Daggpunkten vid observationstiden – temperaturen till vilken luften måste kylas för att bli mättad (100% relativ luftfuktighet). Mäts i grader Celsius (°C) eller Fahrenheit (°F), beroende på vilken enhet som anges i begäran. En högre daggpunkt indikerar mer fukt i luften.

hasPrecipitation

boolean

true om nederbörd (regn, snö, snöblandat regn eller hagel) förekommer vid observationstiden; annars false.

iconCode

IconCode

Den representativa väderikonkoden för denna observation, ihopparad med egenskapen phrase . 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.

isDayTime

boolean

true om det är dagtid på den angivna platsen vid observationstiden; false om det är natt.

obstructionsToVisibility

string

En kod som identifierar den dominerande faktorn som minskar sikten vid observationstidpunkten, såsom dimma, rök, dis eller nederbörd. Användbart för aktiviteter som är beroende av klar sikt, som bilkörning och flygning.

Möjliga värden:

  • A = kraftigt åskväder/hagel
  • BD = blåsa damm
  • BN = blåsande sand
  • BS = blåsa snö
  • D = damm
  • F = dimma
  • GF = markdimma
  • HZ = dimma
  • I = is
  • IC = iskristaller
  • IF = isdimma
  • IP = ispellets
  • IPW = ispelletsdusch
  • K = rök
  • L = duggregn
  • R = regn
  • RS = regn/snö
  • RW = regnskur
  • S = snö
  • SG = snögranulat
  • SP = snöpellets
  • SW = snöregn
  • T = åskväder
  • UP = odefinierad nederbörd
  • ZL = iskallt duggregn
  • ZR = frostregn
  • + = tungt
  • - = ljus
pastTwentyFourHourTemperatureDeparture

WeatherValue

Förändringen i lufttemperatur jämfört med för 24 timmar sedan, i grader Celsius (°C) eller Fahrenheit (°F), beroende på vilken enhet som anges i förfrågan. Positiva värden indikerar att luften är varmare än igår samtidigt; negativa värden indikerar att den är svalare.

phrase

string

En kort beskrivande term för väderförhållandena vid observationstiden – till exempel soligt eller delvis molnigt. Parar med iconCode, som identifierar den matchande väderikonen. För mer information, se Vädertjänster i Azure Maps.

precipitationSummary

PrecipitationSummary

En sammanfattning av vätskeekvivalenta nederbördsmängder vid observationsplatsen över rullande fönster under de senaste 1, 3, 6, 9, 12, 18 och 24 timmarna, i millimeter (mm) eller tum (in) beroende på vilken enhet som anges i begäran.

pressure

WeatherValue

Det atmosfäriska (luft)trycket vid marknivå vid observationstillfället, i millibar (mb) eller tum kvicksilver (inHg), beroende på vilken enhet som anges i begäran.

pressureTendency

PressureTendency

Den senaste trenden i atmosfärstrycket – stigande, sjunkande eller stadigt. Användbar för att förutse kortsiktiga väderförändringar; fallande tryck signalerar ofta försämrat väder, medan stigande tryck vanligtvis indikerar förbättrade förhållanden.

realFeelTemperature

WeatherValue

RealFeel-temperaturen™ vid observationstidpunkten, i grader Celsius (°C) eller Fahrenheit (°F), beroende på vilken enhet som anges i begäran. 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

WeatherValue

RealFeel-temperaturen™ vid observationstiden 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.

relativeHumidity

integer (int32)

Den relativa luftfuktigheten vid observationstillfället, uttryckt som en procentandel från 0 till 100 av den maximala mängden vattenånga som luften kan hålla vid samma temperatur.

temperature

WeatherValue

Lufttemperaturen vid observationstillfället, i grader Celsius (°C) eller Fahrenheit (°F), beroende på vilken enhet som anges i begäran.

temperatureSummary

TemperatureSummary

En sammanfattning av de högsta och lägsta lufttemperaturerna som observerats på denna plats över rullande fönster under de senaste 6, 12 och 24 timmarna, i grader Celsius (°C) eller Fahrenheit (°F) beroende på enheten som anges i begäran.

uvIndex

integer (int32)

Ultraviolett (UV) index vid observationstillfället, vilket indikerar risken för skador från oskyddad solexponering. Värden som stöds är:

  • 0-2: Låg risk från solens UV-strålar för en genomsnittlig 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

En kort beskrivande etikett för uvIndex – till exempel Låg, Måttlig, Hög,Mycket Hög eller Extrem.

visibility

WeatherValue

Den horisontella sikten vid observationstiden – avståndet där ett objekt eller ljus tydligt kan urskiljas – i kilometer (km) eller miles (mi) beroende på vilken enhet som anges i begäran.

wetBulbTemperature

WeatherValue

Våtbulbens temperatur vid observationstillfället – den temperatur luften skulle nå om den kyldes ner till mättnad (100% relativ luftfuktighet) genom att avdunsta vatten i den vid konstant tryck. Mäts i grader Celsius (°C) eller Fahrenheit (°F), beroende på vilken enhet som anges i begäran. Användbart för att bedöma värmestress och avdunstningskylning.

wind

WindDetails

Vindhastighet och riktning vid observationstidpunkten. Hastigheten anges i kilometer per timme (km/h) eller miles per timme (mph) beroende på vilken enhet som anges i begäran; riktningen är i azimutgrader, mätt medurs från sann nord (0° = N, 90° = E, 180° = S, 270° = V).

windChillTemperature

WeatherValue

Vindkylningstemperaturen vid observationstiden – hur kall luften känns på exponerad hud på grund av den kombinerade effekten av vind och låg temperatur. Vanligtvis lägre än den faktiska lufttemperaturen. Mäts i grader Celsius (°C) eller Fahrenheit (°F), beroende på vilken enhet som anges i begäran.

windGust

WindDetails

Den maximala korta vindbyhastigheten och riktningen vid observationstidpunkten, med samma enheter och azimutkonvention som wind. Vindbyar är korta toppar i vindhastighet som kan påverka aktiviteter som flygning, segling, drakeflygning och andra utomhusaktiviteter.

CurrentConditionsResult

Svaret returneras av operationen Get Current Conditions, som innehåller en eller flera observationer med aktuella villkor för en specificerad plats. Som standard returneras en enda observation för nuvarande tid; när parametern duration sätts till 6 eller 24 inkluderar svaret också en observation per föregående timme under det fönstret.

Name Typ Description
results

CurrentConditions[]

Observationerna av aktuella förhållanden, i kronologisk ordning med den senaste först. Som standard en enda post – den senaste observationen

  • returneras; svaret kan också innehålla en post per timme under ett nyligen rullande fönster (vanligtvis de senaste 6 eller 24 timmarna), beroende på begäran.

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.

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

PastHoursTemperature

De högsta och lägsta lufttemperaturerna som observerats under ett av de rullande fönstren (efter TemperatureSummary 6, 12 eller 24 timmar), i grader Celsius (°C) eller Fahrenheit (°F) beroende på vilken enhet som anges i begäran.

Name Typ Description
maximum

WeatherValue

Den högsta temperaturen som observerades under fönstret.

minimum

WeatherValue

Den lägsta temperaturen som observerades under fönstret.

PrecipitationSummary

Den totala vätskeekvivalenta nederbörden som fallit på observationsplatsen över rullande fönster som slutar vid observationstiden. Varje värde täcker hela fönstret mätt bakåt från "nu" – till exempel past3Hours är det löpande totalvärdet för de senaste tre timmarna, inte bara den tredje timmen – så att fönstren överlappar och längre fönster inkluderar nederbörden som rapporterats för de kortare. Snö och is bidrar med sin smälta (flytande) motsvarighet. Rapporteras i millimeter (mm) eller tum (in) beroende på vilken enhet som anges i förfrågan.

Name Typ Description
past12Hours

WeatherValue

Vätskemotsvarande nederbörd som har fallit under de senaste 12 timmarna.

past18Hours

WeatherValue

Vätskemotsvarande nederbörd som har fallit under de senaste 18 timmarna.

past24Hours

WeatherValue

Vätskemotsvarande nederbörd som har fallit under de senaste 24 timmarna.

past3Hours

WeatherValue

Vätskemotsvarande nederbörd som har fallit de senaste 3 timmarna.

past6Hours

WeatherValue

Vätskemotsvarande nederbörd som har fallit de senaste 6 timmarna.

past9Hours

WeatherValue

Vätskemotsvarande nederbörd som har fallit de senaste 9 timmarna.

pastHour

WeatherValue

Vätskemotsvarande nederbörd som har fallit den senaste timmen.

PressureTendency

Den senaste trenden i atmosfärstryck – oavsett om trycket stiger, sjunker eller är stabilt – återkom både som en lokal fras och en enbokstavskod. Användbar för att förutse kortsiktiga väderförändringar; fallande tryck signalerar ofta försämrat väder, medan stigande tryck vanligtvis indikerar förbättrade förhållanden.

Name Typ Description
code

string

En språkoberoende enbokstavskod för trycktendensen: F = Fallande, S = Stadig, R = Stigande.

localizedDescription

string

En kort fras som beskriver trycktendensen – till exempel Fallande, Stabil eller Stigande – återvände på det språk som anges i begäran.

TemperatureSummary

De högsta och lägsta lufttemperaturerna som observerades på platsen över rullande fönster som slutade vid observationstiden. Varje värde täcker hela fönstret som mäts bakåt från "nu" – till exempel rapporterar past12Hours de högsta och lägsta under de senaste 12 timmarna, inte bara den tolfte timmen – så att fönstren överlappar och längre fönster inkluderar de temperaturer som rapporteras för de kortare. Rapporteras i grader Celsius (°C) eller Fahrenheit (°F) beroende på vilken enhet som anges i begäran.

Name Typ Description
past12Hours

PastHoursTemperature

Högsta och lägsta temperaturer observerade under de senaste 12 timmarna.

past24Hours

PastHoursTemperature

Högsta och lägsta temperaturer observerade under de senaste 24 timmarna.

past6Hours

PastHoursTemperature

Högsta och lägsta temperaturer observerade de senaste 6 timmarna.

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.