Weather - Get Current Conditions

Tjänst:: Maps

API-version:: 1.1

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}

Med valfria parametrar:

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
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. Varje användare, grupp eller tjänstehuvudperson kan beviljas åtkomst via en inbyggd roll eller en anpassad roll bestående av en eller flera behörigheter för att Azure Maps REST-API:er.\n\nFör att implementera scenarier rekommenderar vi att man tittar på autentiseringskoncept. Sammanfattningsvis erbjuder denna säkerhetsdefinition en lösning för modellering av applikationer via objekt som kan åtkomstkontroll på specifika API:er och scopes.\n\n#### Anteckningar\n* Denna säkerhetsdefinition kräver användning av x-ms-client-id-headern för att ange vilken Azure Maps resurs applikationen begär åtkomst till. Detta kan hämtas från Maps management API.\n* \nAuthorization URL är specifik för den Azure publika molninstansen. Suveräna moln har unika auktoriserings-URL:er och Microsoft Entra ID-konfigurationer. \n* \nDen Azure rollbaserade åtkomstkontrollen konfigureras från Azure hanteringsplanet via Azure portal, PowerShell, CLI, Azure-SDK:er eller REST API:er.\n* \nAnvändning av Azure Maps Web SDK möjliggör konfigurationsbaserad installation av en applikation för flera användningsområden.\n* För mer information om Microsofts identitetsplattform, se Microsofts identitetsplattform översikt.

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

Omfattningar

Name	Description
https://atlas.microsoft.com/.default

subscription-key

Detta är en delad nyckel som provisioneras när du Skapa ett Azure Maps-konto i Azure-portalen eller med PowerShell, CLI, Azure-SDK:er eller REST API.\n\n Med denna nyckel kan vilken applikation som helst komma åt alla REST API:er. Med andra ord kan denna nyckel användas som en huvudnyckel i det konto där de utfärdas.\n\n För offentligt exponerade applikationer rekommenderar vi att använda konfidentiella klientapplikationer för att komma åt Azure Maps REST-API:er så att din nyckel kan lagras säkert.

Typ: apiKey
I: header

SAS Token

Detta är en delad åtkomstsignaturtoken som skapas från List SAS-operationen på Azure Maps-resursen via Azure hanteringsplanet via Azure portal, PowerShell, CLI, Azure-SDK:er eller REST-API:er.\n\n Med denna token är varje applikation auktoriserad att få åtkomst med Azure rollbaserade åtkomstkontroller och finkornig kontroll till utgångsdatum, hastighet och region(er) för användning för den specifika token. Med andra ord kan SAS-token användas för att låta applikationer kontrollera åtkomsten på ett säkrare sätt än den delade nyckeln.\n\n För offentligt exponerade applikationer är vår rekommendation att konfigurera en specifik lista över tillåtna ursprung på Map-kontots resurs för att begränsa renderingsmissbruk och regelbundet förnya SAS-token.

Typ: apiKey
I: header

Exempel

Successfully retrieve detailed current weather conditions for a given coordinate location

Exempelbegäran

HTTP

GET {endpoint}/weather/currentConditions/json?api-version=1.1&query=47.641268,-122.125679

Exempelsvar

Statuskod:: 200

{
  "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	Aktuella väderdata.
CurrentConditionsResult	Nuvarande väderförhållanden är resultatet.
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	Numeriskt värde som representerar en bild som motsvarar det aktuella väderförhållandet som beskrivs av egenskapen `Phrase` . För mer information, se Vädertjänster i Azure Maps. Kan vara NULL.
JsonFormat	Önskat format för svaret. Endast `json` format stöds.
PastHoursTemperature	Sammanfattning av temperaturfluktuationer under antalet senaste timmar.
PrecipitationSummary	Sammanfattning av nederbördsmängder.
PressureTendency	Atmosfärstryckstendens.
TemperatureSummary	Sammanfattning av temperaturfluktuationer.
UnitType	Ett heltal som representerar enhetstypen. Till exempel 17 för Celsius, 18 för Fahrenheit. Kan användas för enhetsöversättning. För en komplett lista, se Vädertjänster i Azure Maps.
WeatherDataUnit	Måttenhet för väderdata.
WeatherValue	Specifikt värde för en viss enhet relaterat till väder.
WindDetails	Vindinformation returneras, inklusive hastighet och riktning.
WindDirection	Vindriktning

CurrentConditions

Objekt

Aktuella väderdata.

Name	Typ	Description
apparentTemperature	WeatherValue	Upplevd utomhustemperatur orsakad av kombinationen av lufttemperatur, relativ luftfuktighet och vindhastighet i specificerad enhet.
ceiling	WeatherValue	Molntak i angiven enhet. Taket är ett mått på höjden på de lägsta molnens bas.
cloudCover	integer (int32)	Procent som representerar molntäcke.
dateTime	string (date-time)	Datum och tid för den aktuella observationen visas i ISO 8601-format , till exempel 2019-10-27T19:39:57-08:00.
dewPoint	WeatherValue	Daggpunktstemperaturen i angiven enhet. Daggpunktstemperaturen är den temperatur som luften måste kylas till för att nå mättnad.
hasPrecipitation	boolean	Ett booleskt värde som anger om nederbörd (regn, snö, snöblandat regn eller hagel) förväntas under den angivna tidsramen. Returnerar true om nederbörd förväntas, annars falsk.
iconCode	IconCode	Numeriskt värde som representerar en bild som motsvarar det aktuella väderförhållandet som beskrivs av egenskapen `Phrase` . För mer information, se Vädertjänster i Azure Maps. Kan vara NULL.
isDayTime	boolean	Anger tiden på dygnet. Sant anger 'dag',', falskt anger 'natt.
obstructionsToVisibility	string	Orsak till begränsad sikt. Möjliga värden: A = kraftigt åskväder/hagel BD = blåser damm BN = blåsande sand BS = blåser snö D = damm F = dimma GF = markdimma HZ = dis I = is IC = iskristaller IF = isdimma IP = ispellets IPW = dusch med ispellets K = rök L = duggregn R = regn RS = regn/snö RW = regnskur S = snö SG = snögranulat SP = snöpellets SW = snöbyar T = åska UP = odefinierad nederbörd ZL = iskallt duggregn ZR = underkylt regn + = tung - = ljus
pastTwentyFourHourTemperatureDeparture	WeatherValue	Avvikelse från den temperatur som observerades för 24 timmar sedan i angiven enhet.
phrase	string	Fras beskrivning av det aktuella väderförhållandet. Visas på angivet språk.
precipitationSummary	PrecipitationSummary	Sammanställning av nederbördsmängder under de senaste 24 timmarna.
pressure	WeatherValue	Atmosfärstryck i specificerad enhet.
pressureTendency	PressureTendency	Förändring av atmosfärstrycket.
realFeelTemperature	WeatherValue	RealFeel™-temperaturen återlämnas.
realFeelTemperatureShade	WeatherValue	RealFeel™-temperaturen återlämnas. Beskriver hur temperaturen verkligen känns i skuggan.
relativeHumidity	integer (int32)	Relativ luftfuktighet är mängden vattenånga som finns i luften uttryckt i procent av den mängd som behövs för mättnad vid samma temperatur.
temperature	WeatherValue	Temperaturen återges.
temperatureSummary	TemperatureSummary	Sammanfattning av temperaturfluktuationer under de senaste 6, 12 och 24 timmarna.
uvIndex	integer (int32)	Mått på styrkan på den ultravioletta strålningen från solen. Värden som stöds är: `0-2` - Låg fara från solens UV-strålar eller den genomsnittliga personen. `3-5` - Måttlig risk för skador på grund av oskyddad solexponering. `6-7` - Hög risk för skador på grund av oskyddad solexponering. `8-10` - Mycket hög risk för skador på grund av oskyddad solexponering. `11+` - Extrem risk för skador på grund av oskyddad solexponering.
uvIndexPhrase	string	Fras som `uvIndex`är associerad med .
visibility	WeatherValue	Sikt i angiven enhet. Ett mått på det avstånd på vilket ett föremål eller ljus tydligt kan urskiljas.
wetBulbTemperature	WeatherValue	Den temperatur till vilken luft kan kylas genom att förånga vatten i den vid konstant tryck tills den når mättnad.
wind	WindDetails	Vindinformation returneras, inklusive hastighet och riktning.
windChillTemperature	WeatherValue	Upplevd lufttemperatur på exponerad hud på grund av vind.
windGust	WindDetails	Vindby. Vindbyar är en plötslig, kort ökning av vindens hastighet.

CurrentConditionsResult

Objekt

Nuvarande väderförhållanden är resultatet.

Name	Typ	Description
results	CurrentConditions[]	Detaljerade aktuella väderförhållanden.

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

Numeriskt värde som representerar en bild som motsvarar det aktuella väderförhållandet som beskrivs av egenskapen Phrase . För mer information, se Vädertjänster i Azure Maps. Kan vara NULL.

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 (natt)
37	Disigt månsken
38	Mestadels molnigt (natt)
39	Delvis molnigt med duschar
40	Mestadels molnigt med skurar (natt)
41	Delvis molnigt med åskväder
42	Mestadels molnigt med åska (natt)
43	Mestadels molnigt med stormbyar (natt)
44	Mestadels molnigt med snö (natt)

JsonFormat

Uppräkning

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

Värde	Description
json	JavaScript-objekt notationens datautbytesformat

PastHoursTemperature

Objekt

Sammanfattning av temperaturfluktuationer under antalet senaste timmar.

Name	Typ	Description
maximum	WeatherValue	maximal
minimum	WeatherValue	minimum

PrecipitationSummary

Objekt

Sammanfattning av nederbördsmängder.

Name	Typ	Description
past12Hours	WeatherValue	Mängden nederbörd (vätskeekvivalent) som har fallit under de senaste 12 timmarna.
past18Hours	WeatherValue	Mängden nederbörd (vätskeekvivalent) som har fallit under de senaste 18 timmarna.
past24Hours	WeatherValue	Mängden nederbörd (vätskeekvivalent) som har fallit under de senaste 24 timmarna.
past3Hours	WeatherValue	Mängden nederbörd (vätskeekvivalent) som har fallit under de senaste tre timmarna.
past6Hours	WeatherValue	Mängden nederbörd (vätskeekvivalent) som har fallit under de senaste sex timmarna. Innehåller metriska och brittiska värden.
past9Hours	WeatherValue	Mängden nederbörd (vätskeekvivalent) som har fallit under de senaste nio timmarna.
pastHour	WeatherValue	Mängden nederbörd (vätskeekvivalent) som har fallit under den senaste timmen.

PressureTendency

Objekt

Atmosfärstryckstendens.

Name	Typ	Description
code	string	Trycktendenskod oavsett språk. En av F = Fallande, S = Stadig, R = Stigande.
localizedDescription	string	Beskrivning av trycktendensen på angivet språk

TemperatureSummary

Objekt

Sammanfattning av temperaturfluktuationer.

Name	Typ	Description
past12Hours	PastHoursTemperature	Sammanfattning av temperaturfluktuationer under de senaste 12 timmarna.
past24Hours	PastHoursTemperature	Sammanfattning av temperaturfluktuationer under de senaste 24 timmarna.
past6Hours	PastHoursTemperature	Sammanfattning av temperaturfluktuationer under de senaste 6 timmarna.

UnitType

Uppräkning

Ett heltal som representerar enhetstypen. Till exempel 17 för Celsius, 18 för Fahrenheit. Kan användas för enhetsöversättning. För en komplett lista, 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

Måttenhet för väderdata.

Värde	Description
imperial	Returnera data med imperialistiska enheter som Fahrenheit (F) för temperatur och mil (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

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

Name	Typ	Description
unit	string	Typ av enhet för det returnerade värdet.
unitType	UnitType	Ett heltal som representerar enhetstypen. Till exempel 17 för Celsius, 18 för Fahrenheit. Kan användas för enhetsöversättning. För en komplett lista, se Vädertjänster i Azure Maps.
value	number (float)	Avrundat värde.

WindDetails

Objekt

Vindinformation returneras, inklusive hastighet och riktning.

Name	Typ	Description
direction	WindDirection	Vindriktning
speed	WeatherValue	Vindens hastighet i specificerad enhet.

WindDirection

Objekt

Vindriktning

Name	Typ	Description
degrees	integer (int32)	Vindriktning i azimutgrader, med början vid äkta nord och fortsätter medurs. 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.