Weather - Get Current Conditions

Service:: Maps

API-versie:: 1.1

Gebruik om de huidige weersomstandigheden te krijgen.
De Get Current Conditions API is een HTTP-verzoek GET dat gedetailleerde huidige weersomstandigheden retourneert, zoals neerslag, temperatuur en wind voor een bepaalde coördinaatlocatie. Ook kunnen waarnemingen van de afgelopen 6 of 24 uur voor een bepaalde locatie worden opgehaald. De basisinformatie die met het antwoord wordt geretourneerd, omvat details zoals de datum en tijd van de observatie, een korte beschrijving van de weersomstandigheden, het weerpictogram, neerslagindicatorvlaggen en temperatuur. Aanvullende details zoals RealFeel-temperatuur™ en UV-index worden ook geretourneerd. Zie voor meer informatie Real-time weergegevens aanvragen

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

Met optionele parameters:

GET {endpoint}/weather/currentConditions/json?api-version=1.1&query={query}&unit={unit}&details={details}&duration={duration}&language={language}

URI-parameters

Naam	In	Vereist	Type	Description
endpoint	path	True	string (uri)	De hostnaam van de Azure Maps-service. Gebruik `https://atlas.microsoft.com` voor de Azure publieke cloud. Om een specifieke Azure Maps geografie of een soevereine cloud te targeten, zie Azure Maps geografische reikwijdte.
format	path	True	JsonFormat	Gewenste indeling van het antwoord. Alleen `json` indeling wordt ondersteund.
api-version	query	True	string minLength: 1	De API-versie die voor deze bewerking moet worden gebruikt.
query	query	True	number[]	De toepasselijke query die is opgegeven als een door komma's gescheiden tekenreeks die is samengesteld door breedtegraad gevolgd door lengtegraad, bijvoorbeeld '47,641268,-125679'. Weersinformatie is over het algemeen beschikbaar voor locaties op het land, watermassa's omgeven door land en delen van de oceaan die zich binnen ongeveer 50 zeemijl van een kustlijn bevinden.
details	query		string	Stuur de volledige details terug voor de huidige omstandigheden. Beschikbare waarden zijn `true` - Geeft alle details terug. Standaard worden alle gegevens geretourneerd. `false` - Retourneert een ingekorte versie van de gegevens over de huidige toestand, waaronder observatiedatum, tijd, weerzin, pictogramcode, neerslagindicator, vlag en temperatuur.
duration	query		integer (int32)	Tijdsbestek van de teruggekeerde weersomstandigheden. Standaard worden de meest actuele weersomstandigheden geretourneerd. De standaardwaarde is 0. Ondersteunde waarden zijn: `0` - Retourneer de meest actuele weersomstandigheden. `6` - Terugkeer weersomstandigheden van de afgelopen 6 uur. `24` - Terugkeer weersomstandigheden van de afgelopen 24 uur.
language	query		string	Taal waarin zoekresultaten moeten worden geretourneerd. Moet een van de ondersteunde IETF-taaltags zijn, niet hoofdlettergevoelig. Wanneer gegevens in de opgegeven taal niet beschikbaar zijn voor een specifiek veld, wordt de standaardtaal gebruikt. Raadpleeg ondersteunde talen voor meer informatie.
unit	query		WeatherDataUnit	Geeft aan dat de gegevens moeten worden geretourneerd in metrische eenheden of Engelse eenheden. De standaardwaarde is metrisch.

Aanvraagkoptekst

Naam	Vereist	Type	Description
x-ms-client-id		string	Geeft het account aan dat bedoeld is voor gebruik met het Microsoft Entra ID-beveiligingsmodel. Deze unieke ID voor het Azure Maps-account kan worden verkregen via de Azure Maps beheerplane Account API. Voor meer informatie over het gebruik van Microsoft Entra ID beveiliging in Azure Maps, zie Beheer authenticatie in Azure Maps.

Antwoorden

Naam	Type	Description
200 OK	CurrentConditionsResult	De aanvraag is voltooid.
Other Status Codes	ErrorResponse	Een onverwachte foutreactie.

Beveiliging

AadToken

Dit zijn de Microsoft Entra OAuth 2.0 stromen. In combinatie met Azure rolgebaseerde toegang control kan het worden gebruikt om de toegang tot Azure Maps REST-API's te controleren. Azure rolgebaseerde toegangscontroles worden gebruikt om toegang aan een of meer Azure Maps-resourceaccounts of subresources aan te wijzen. Elke gebruiker, groep of service-principal kan toegang krijgen via een ingebouwde rol of een aangepaste rol die bestaat uit een of meer machtigingen voor Azure Maps REST API's.

Voor het implementeren van scenario's raden we u aan om verificatieconceptente bekijken. Kortom, deze beveiligingsdefinitie biedt een oplossing voor het modelleren van toepassingen via objecten die toegangsbeheer kunnen uitvoeren voor specifieke API's en bereiken.

Note

Deze beveiligingsdefinitie vereist het gebruik van de x-ms-client-id-header om aan te geven tot welke Azure Maps-resource de toepassing toegang aanvraagt. Dit kan worden verkregen uit de Maps Management API-.
De Authorization URL is specifiek voor het exemplaar van de openbare Azure-cloud. Sovereign clouds hebben unieke autorisatie-URL's en Microsoft Entra ID-configuraties.
Het op rollen gebaseerde toegangsbeheer van Azure wordt geconfigureerd vanuit het Azure-beheervlak via Azure Portal, PowerShell, CLI, Azure SDK's of REST API's.
Gebruik van de Azure Maps Web SDK maakt configuratiegebaseerde installatie van een toepassing mogelijk voor meerdere gebruiksscenario's.
Zie Overzicht van Microsoft Identity Platformvoor meer informatie over het Microsoft Identity Platform.

Type: oauth2
Stroom: implicit
Autorisatie-URL: https://login.microsoftonline.com/common/oauth2/authorize

Bereiken

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

subscription-key

Dit is een gedeelde sleutel die wordt ingericht wanneer u Een Azure Maps-account maken in Azure Portal of met behulp van PowerShell, CLI, Azure SDK's of REST API.

Met deze sleutel heeft elke toepassing toegang tot alle REST API's. Met andere woorden, deze sleutel kan worden gebruikt als een hoofdsleutel in het account waarin ze worden uitgegeven.

Voor openbaar blootgestelde toepassingen is het raadzaam om de vertrouwelijke clienttoepassingen te gebruiken benadering voor toegang tot Azure Maps REST API's, zodat uw sleutel veilig kan worden opgeslagen.

Type: apiKey
In: header

SAS Token

Dit is een shared access Signature-token dat wordt gemaakt op basis van de bewerking List SAS op de Azure Maps-resource via het Azure-beheervlak via Azure Portal, PowerShell, CLI, Azure SDK's of REST API's.

Met dit token is elke toepassing gemachtigd voor toegang met op rollen gebaseerd toegangsbeheer van Azure en gedetailleerd beheer tot de vervaldatum, snelheid en regio(s) van gebruik voor het specifieke token. Met andere woorden, het SAS-token kan worden gebruikt om toepassingen toe te staan toegang op een veiligere manier te beheren dan de gedeelde sleutel.

Voor openbaar blootgestelde toepassingen wordt aangeraden een specifieke lijst met toegestane origins te configureren voor de resource van het Account toewijzen om het genereren van misbruik te beperken en het SAS-token regelmatig te vernieuwen.

Type: apiKey
In: header

Voorbeelden

Successfully retrieve detailed current weather conditions for a given coordinate location

Voorbeeldaanvraag

HTTP

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

Voorbeeldrespons

Statuscode:: 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
        }
      }
    }
  ]
}

Definities

Naam	Description
CurrentConditions	Een enkele weerwaarneming voor de opgegeven locatie, teruggegeven door de Get Current Conditions-operatie. Afhankelijk van het verzoek `duration`, kan deze observatie de laatste (meest recente) meting zijn of een van de voorgaande uurwaarnemingen. Standaard wordt een vereenvoudigde subset teruggegeven: observatiedatum en -tijd, weersuitdrukking, icooncode, neerslagindicator en temperatuur. Wanneer het verzoek om volledige details vraagt, wordt elk pand opgenomen, met metingen zoals RealFeel, dauwpunt, wind, zicht, bewolking, druk en rollende neerslag- en temperatuuroverzichten van de afgelopen uren.
CurrentConditionsResult	Het antwoord dat wordt teruggegeven door de operatie Get Current Conditions, met één of meer current-conditions waarnemingen voor een gespecificeerde locatie. Standaard wordt één observatie voor het huidige tijdstip teruggegeven; wanneer de `duration` parameter op 6 of 24 wordt gezet, bevat de respons ook één observatie per voorgaande uur over dat venster.
ErrorAdditionalInfo	Aanvullende informatie over de resourcebeheerfout.
ErrorDetail	De foutdetails.
ErrorResponse	Veelvoorkomende foutrespons voor alle Azure Resource Manager API's om foutdetails terug te geven bij mislukte bewerkingen. (Dit volgt ook de OData-foutreactieindeling.)
IconCode	De numerieke weersconditiescode die aangeeft welk icoon getoond moet worden. Elke waarde in deze opsomming komt overeen met een Azure Maps-weerpictogram (zoals Zonnig, Bewolkt of Donderstormen) en wordt gecombineerd met een door mensen leesbare waarde `iconPhrase` die daarbij wordt teruggegeven. Dezelfde code kan verschijnen in huidige, uurlijke, dagelijkse, kwartaal- en minuten-voor-minuut antwoorden, waardoor applicaties een consistent pictogram kunnen weergeven dat over alle weerservices is gezet. Voor de volledige lijst met codes, de iconen waaraan ze worden gekoppeld, en voorbeeldafbeeldingen, zie Weerservices in Azure Maps.
JsonFormat	Gewenste indeling van het antwoord. Alleen `json` indeling wordt ondersteund.
PastHoursTemperature	De hoogste en laagste luchttemperaturen die tijdens een van de rolling windows aan `TemperatureSummary` zijn (na 6, 12 of 24 uur), in graden Celsius (°C) of Fahrenheit (°F), afhankelijk van de eenheid die in het verzoek is gespecificeerd.
PrecipitationSummary	De totale vloeistofequivalente neerslag die op de observatielocatie is gevallen over rollende ramen die eindigen op het waarnemingsmoment. Elke waarde dekt het volledige venster dat wordt teruggemeten vanaf "nu" - bijvoorbeeld `past3Hours` is het lopende totaal voor de meest recente drie uur, niet alleen het derde uur - dus de vensters overlappen en langere vensters bevatten de neerslag die voor de kortere wordt gerapporteerd. Sneeuw en ijs dragen hun gesmolten (vloeibare) equivalent bij. Gerapporteerd in millimeters (mm) of inches (in), afhankelijk van de eenheid die in het verzoek is gespecificeerd.
PressureTendency	De recente trend in atmosferische druk – of de druk nu stijgt, daalt of stabiel is – kwam terug als zowel een lokale uitdrukking als een eenletterige code. Nuttig voor het anticiperen op korte termijn weersveranderingen; dalende druk duidt vaak op verslechterend weer, terwijl stijgende druk doorgaans op betere omstandigheden wijst.
TemperatureSummary	De hoogste en laagste luchttemperaturen die op de locatie worden waargenomen over rollende ramen die eindigen bij het waarnemingsmoment. Elke waarde dekt het volledige venster dat van nu wordt gemeten – bijvoorbeeld rapporteert `past12Hours` het hoogste en laagste over de meest recente 12 uur, niet alleen het twaalfde uur – dus de vensters overlappen en langere vensters omvatten de gerapporteerde temperaturen voor de kortere vensters. Gerapporteerd in graden Celsius (°C) of Fahrenheit (°F), afhankelijk van de eenheid die in het verzoek is gespecificeerd.
UnitType	Een geheel getal dat is gekoppeld aan het type eenheid dat wordt weergegeven. Bijvoorbeeld 17 voor Celsius, 18 voor Fahrenheit. Kan worden gebruikt voor unitvertaling. Voor meer informatie, zie Weerdiensten in Azure Maps.
WeatherDataUnit	Geeft aan of gegevens in metrische of imperiale eenheden moeten worden teruggegeven, met metriek als standaard. Voorbeeld: Metrisch: millimeter (mm), meter (m), kilometer (km), Celsius (C) Keizerlijk: inch (inch), voet (ft), mijl (mijl), Fahrenheit (F)
WeatherValue	Waarden voor weersgerelateerde metrieken zoals temperatuur, dauwpunt en windsnelheid, weergegeven in metrische of imperiale eenheden, zoals gespecificeerd in de eenheids-URI-parameter. Voor meer informatie, zie Eenheidstypen in het artikel Weerservices in Azure Maps.
WindDetails	Geeft de voorspelde windsnelheid, gemeten in eenheden zoals kilometers per uur (km/u) of mijl per uur (mph), afhankelijk van de eenheid die in het verzoek is gespecificeerd. Geeft ook de windrichting aan, gemeten in azimutgraden, beginnend bij het ware noorden en met de klok mee bewegend. Noord komt overeen met 0°, oost met 90°, zuid met 180° en west met 270°. Mogelijke waarden variëren van 0° tot 359°.
WindDirection	Geeft details over windrichting, inclusief de richting in azimutgraden en een gelokaliseerde afkorting van de windrichting.

CurrentConditions

Object

Een enkele weerwaarneming voor de opgegeven locatie, teruggegeven door de Get Current Conditions-operatie. Afhankelijk van het verzoek duration, kan deze observatie de laatste (meest recente) meting zijn of een van de voorgaande uurwaarnemingen. Standaard wordt een vereenvoudigde subset teruggegeven: observatiedatum en -tijd, weersuitdrukking, icooncode, neerslagindicator en temperatuur. Wanneer het verzoek om volledige details vraagt, wordt elk pand opgenomen, met metingen zoals RealFeel, dauwpunt, wind, zicht, bewolking, druk en rollende neerslag- en temperatuuroverzichten van de afgelopen uren.

Naam	Type	Description
apparentTemperature	WeatherValue	De schijnbare temperatuur op het moment van waarneming - hoe de lucht daadwerkelijk aanvoelt voor mensen, rekening houdend met luchttemperatuur, relatieve luchtvochtigheid en windsnelheid. Gemeten in graden Celsius (°C) of Fahrenheit (°F), afhankelijk van de eenheid die in het verzoek is gespecificeerd.
ceiling	WeatherValue	Het wolkenplafond op het observatiemoment - de hoogte boven de grond van de laagste wolkenlaag - in voet (ft) of meters (m), afhankelijk van de eenheid die in het verzoek is gespecificeerd. Belangrijk voor de luchtvaart, omdat het de zichtbaarheid en operaties beïnvloedt.
cloudCover	integer (int32)	Het percentage van de lucht dat op het moment van waarneming door wolken bedekt is, van 0 (helder) tot 100 (bewolkt). Kan NUL zijn.
dateTime	string (date-time)	De datum en tijd van deze waarneming, in RFC 3339-formaat (yyyy-mm-ddThh:mm:ss-hh:mm). Bijvoorbeeld, 2025-04-29T07:00:00-07:00.
dewPoint	WeatherValue	Het dauwpunt op het waarnemingsmoment - de temperatuur waartoe lucht moet afkoelen om verzadigd te raken (100% relatieve luchtvochtigheid). Gemeten in graden Celsius (°C) of Fahrenheit (°F), afhankelijk van de eenheid die in het verzoek is gespecificeerd. Een hoger dauwpunt geeft meer vocht in de lucht aan.
hasPrecipitation	boolean	`true` als er neerslag (regen, sneeuw, ijzel of hagel) valt op het waarnemingsmoment; anders `false`.
iconCode	IconCode	De representatieve weericoon code voor deze waarneming, gekoppeld aan de `phrase` eigenschap. De numerieke waarde komt overeen met een Azure Maps-weerpictogram - voor de volledige lijst, zie Weerdiensten in Azure Maps. Kan NUL zijn.
isDayTime	boolean	`true` als het dag is op de opgegeven locatie op het waarnemingstijd; `false` als het nacht is.
obstructionsToVisibility	string	Een code die de dominante factor identificeert die het zicht op het waarnemingsmoment vermindert, zoals mist, rook, nevel of neerslag. Handig voor activiteiten die afhankelijk zijn van helder zicht, zoals autorijden en luchtvaart. Mogelijke waarden: A = zware onweersstorm/hagel BD = stof blazen BN = waaiend zand BS = sneeuw blazen D = stof F = mist GF = grondmist HZ = nevel I = ijs IC = ijskristallen IF = ijsmist IP = ijspellets IPW = ijspelletsdouche K = rook L = motregen R = regen RS = regen/sneeuw RW = regenbui S = sneeuw SG = sneeuwkorrels SP = sneeuwkorrels SW = sneeuwbui T = onweersbui UP = ongedefinieerde neerslag ZL = ijzelmotregen ZR = vriesregen + = zwaar - = licht
pastTwentyFourHourTemperatureDeparture	WeatherValue	De verandering in luchttemperatuur vergeleken met 24 uur geleden, in graden Celsius (°C) of Fahrenheit (°F), afhankelijk van de eenheid die in het verzoek is gespecificeerd. Positieve waarden geven aan dat de lucht tegelijkertijd warmer is dan gisteren; negatieve waarden geven aan dat het koeler is.
phrase	string	Een korte beschrijvende term voor de weersomstandigheden op het waarnemingsmoment - bijvoorbeeld zonnig of gedeeltelijk bewolkt. Koppelt met `iconCode`, dat het bijbehorende weerpictogram identificeert. Voor meer informatie, zie Weerdiensten in Azure Maps.
precipitationSummary	PrecipitationSummary	Een samenvatting van vloeistofequivalente neerslaghoeveelheden op de observatielocatie over rollende vensters van de afgelopen 1, 3, 6, 9, 12, 18 en 24 uur, in millimeters (mm) of inches (in) afhankelijk van de eenheid die in het verzoek is gespecificeerd.
pressure	WeatherValue	De atmosferische (lucht)druk op grondniveau op het waarnemingstijdstip, in millibar (mb) of inches kwik (inHg), afhankelijk van de eenheid die in het verzoek is gespecificeerd.
pressureTendency	PressureTendency	De recente trend in atmosferische druk - stijgend, dalend of gestaag. Nuttig voor het anticiperen op korte termijn weersveranderingen; dalende druk duidt vaak op verslechterend weer, terwijl stijgende druk doorgaans op betere omstandigheden wijst.
realFeelTemperature	WeatherValue	De RealFeel-temperatuur™ op het waarnemingstijdstip, in graden Celsius (°C) of Fahrenheit (°F), afhankelijk van de eenheid die in het verzoek is gespecificeerd. Ontwikkeld door AccuWeather, combineert RealFeel luchttemperatuur met vochtigheid, wind, bewolking, zonintensiteit en andere factoren om aan te geven hoe het weer daadwerkelijk aanvoelt. Voor meer informatie, zie Wat is de AccuWeather RealFeel Temperatuur?
realFeelTemperatureShade	WeatherValue	De RealFeel-temperatuur™ op het waarnemingsmoment in schaduwrijke gebieden, in graden Celsius (°C) of Fahrenheit (°F), afhankelijk van de eenheid die in het verzoek is gespecificeerd. Zoals `realFeelTemperature`, maar sluit het verwarmingseffect van direct zonlicht uit, waardoor het een nauwkeuriger beeld krijgt van hoe het weer in de schaduw aanvoelt.
relativeHumidity	integer (int32)	De relatieve luchtvochtigheid op het waarnemingsmoment, uitgedrukt als een percentage van 0 tot 100 van de maximale hoeveelheid waterdamp die de lucht bij dezelfde temperatuur kan vasthouden.
temperature	WeatherValue	De luchttemperatuur op het waarnemingstijdstip is in graden Celsius (°C) of Fahrenheit (°F), afhankelijk van de eenheid die in het verzoek is gespecificeerd.
temperatureSummary	TemperatureSummary	Een samenvatting van de hoogste en laagste luchttemperaturen die op deze locatie zijn waargenomen over rollende ramen van de afgelopen 6, 12 en 24 uur, in graden Celsius (°C) of Fahrenheit (°F), afhankelijk van de eenheid die in het verzoek is gespecificeerd.
uvIndex	integer (int32)	De ultraviolet (UV) index op het waarnemingsmoment, wat het risico op schade door onbeschermde blootstelling aan de zon aangeeft. Ondersteunde waarden zijn: 0-2: Weinig gevaar door de UV-straling van de zon voor de gemiddelde persoon. 3-5: Matig risico op schade door onbeschermde blootstelling aan de zon. 6-7: Hoog risico op schade door onbeschermde blootstelling aan de zon. 8-10: Zeer hoog risico op schade door onbeschermde blootstelling aan de zon. 11+: Extreem risico op schade door onbeschermde blootstelling aan de zon.
uvIndexPhrase	string	Een kort beschrijvend label voor `uvIndex` - bijvoorbeeld Laag, Gematigd, Hoog, Zeer Hoog of Extreem.
visibility	WeatherValue	De horizontale zichtbaarheid op het waarnemingsmoment - de afstand waarop een object of licht duidelijk kan worden waargenomen - in kilometers (km) of mijlen (mijl), afhankelijk van de eenheid die in het verzoek is gespecificeerd.
wetBulbTemperature	WeatherValue	De natte boltemperatuur op het waarnemingsmoment - de temperatuur die de lucht zou bereiken als deze tot verzadiging (100% relatieve luchtvochtigheid) zou worden afgekoeld door water bij constante druk in te verdampen. Gemeten in graden Celsius (°C) of Fahrenheit (°F), afhankelijk van de eenheid die in het verzoek is gespecificeerd. Nuttig voor het beoordelen van hittestress en verdampingskoeling.
wind	WindDetails	De windsnelheid en -richting op het waarnemingsmoment. De snelheid is in kilometer per uur (km/u) of mijlen per uur (mph), afhankelijk van de eenheid die in het verzoek is gespecificeerd; de richting is in azimutgraden, gemeten met de klok mee vanaf het ware noorden (0° = N, 90° = O, 180° = Z, 270° = W).
windChillTemperature	WeatherValue	De temperatuur van de windtemperatuur op het moment van waarneming - hoe koud de lucht aanvoelt op blootgestelde huid door het gecombineerde effect van wind en lage temperatuur. Meestal lager dan de werkelijke luchttemperatuur. Gemeten in graden Celsius (°C) of Fahrenheit (°F), afhankelijk van de eenheid die in het verzoek is gespecificeerd.
windGust	WindDetails	De maximale korte-uitbarsting windvlaagsnelheid en -richting op het waarnemingsmoment, met dezelfde eenheden en azimutconventie als `wind`. Windstoten zijn korte pieken in windsnelheid die activiteiten zoals luchtvaart, zeilen, vliegeren en andere buitenactiviteiten kunnen beïnvloeden.

CurrentConditionsResult

Object

Het antwoord dat wordt teruggegeven door de operatie Get Current Conditions, met één of meer current-conditions waarnemingen voor een gespecificeerde locatie. Standaard wordt één observatie voor het huidige tijdstip teruggegeven; wanneer de duration parameter op 6 of 24 wordt gezet, bevat de respons ook één observatie per voorgaande uur over dat venster.

Naam	Type	Description
results	CurrentConditions[]	De waarnemingen van de huidige omstandigheden, in chronologische volgorde met de meest recente eerst. Standaard is het één enkele invoer - de laatste observatie wordt teruggestuurd; de reactie kan ook één invoer per uur bevatten over een recent doorlopend venster (meestal de afgelopen 6 of 24 uur), afhankelijk van het verzoek.

Naam

Type

Description

results

CurrentConditions[]

De waarnemingen van de huidige omstandigheden, in chronologische volgorde met de meest recente eerst. Standaard is het één enkele invoer - de laatste observatie

wordt teruggestuurd; de reactie kan ook één invoer per uur bevatten over een recent doorlopend venster (meestal de afgelopen 6 of 24 uur), afhankelijk van het verzoek.

ErrorAdditionalInfo

Object

Aanvullende informatie over de resourcebeheerfout.

Naam	Type	Description
info		De aanvullende informatie.
type	string	Het extra informatietype.

ErrorDetail

Object

De foutdetails.

Naam	Type	Description
additionalInfo	ErrorAdditionalInfo[]	De fout bevat aanvullende informatie.
code	string	De foutcode.
details	ErrorDetail[]	De foutdetails.
message	string	Het foutbericht.
target	string	Het foutdoel.

ErrorResponse

Object

Veelvoorkomende foutrespons voor alle Azure Resource Manager API's om foutdetails terug te geven bij mislukte bewerkingen. (Dit volgt ook de OData-foutreactieindeling.)

Naam	Type	Description
error	ErrorDetail	Het foutobject.

IconCode

Opsomming

De numerieke weersconditiescode die aangeeft welk icoon getoond moet worden. Elke waarde in deze opsomming komt overeen met een Azure Maps-weerpictogram (zoals Zonnig, Bewolkt of Donderstormen) en wordt gecombineerd met een door mensen leesbare waarde iconPhrase die daarbij wordt teruggegeven. Dezelfde code kan verschijnen in huidige, uurlijke, dagelijkse, kwartaal- en minuten-voor-minuut antwoorden, waardoor applicaties een consistent pictogram kunnen weergeven dat over alle weerservices is gezet.

Voor de volledige lijst met codes, de iconen waaraan ze worden gekoppeld, en voorbeeldafbeeldingen, zie Weerservices in Azure Maps.

Waarde	Description
1	Sunny
2	Meestal zonnig
3	Gedeeltelijk zonnig
4	Af en toe bewolkt
5	Wazige zonneschijn
6	Meestal bewolkt
7	Cloudy
8	Dreary (overcast)
11	Fog
12	Showers
13	Meestal bewolkt met douches
14	Gedeeltelijk zonnig met douches
15	Thunderstorms
16	Meestal bewolkt met onweersbuien
17	Gedeeltelijk zonnig met onweersbuien
18	Rain
19	Flurries
20	Meestal bewolkt met flurries
21	Gedeeltelijk zonnig met lichte sneeuwbuien
22	Snow
23	Meestal bewolkt met Sneeuw
24	Ice
25	Sleet
26	Vriesregen
29	Regen en sneeuw
30	Hot
31	Cold
32	Windy
33	Duidelijk
34	Meestal duidelijk
35	Gedeeltelijk bewolkt
36	Af en toe bewolkt
37	Wazig Maanlicht
38	Meestal bewolkt
39	Gedeeltelijk bewolkt met buien
40	Meestal bewolkt met douches
41	Gedeeltelijk bewolkt met onweersbuien
42	Meestal bewolkt met onweersbuien
43	Meestal bewolkt met flurries
44	Meestal bewolkt met Sneeuw

JsonFormat

Opsomming

Gewenste indeling van het antwoord. Alleen json indeling wordt ondersteund.

Waarde	Description
json	De Notatie Data Interchange-indeling voor JavaScript-objecten

PastHoursTemperature

Object

De hoogste en laagste luchttemperaturen die tijdens een van de rolling windows aan TemperatureSummary zijn (na 6, 12 of 24 uur), in graden Celsius (°C) of Fahrenheit (°F), afhankelijk van de eenheid die in het verzoek is gespecificeerd.

Naam	Type	Description
maximum	WeatherValue	De hoogste temperatuur die tijdens het venster werd geobserveerd.
minimum	WeatherValue	De laagste temperatuur die tijdens het venster werd gezien.

PrecipitationSummary

Object

De totale vloeistofequivalente neerslag die op de observatielocatie is gevallen over rollende ramen die eindigen op het waarnemingsmoment. Elke waarde dekt het volledige venster dat wordt teruggemeten vanaf "nu" - bijvoorbeeld past3Hours is het lopende totaal voor de meest recente drie uur, niet alleen het derde uur - dus de vensters overlappen en langere vensters bevatten de neerslag die voor de kortere wordt gerapporteerd. Sneeuw en ijs dragen hun gesmolten (vloeibare) equivalent bij. Gerapporteerd in millimeters (mm) of inches (in), afhankelijk van de eenheid die in het verzoek is gespecificeerd.

Naam	Type	Description
past12Hours	WeatherValue	Vloeistofequivalente neerslag die in de afgelopen 12 uur is gevallen.
past18Hours	WeatherValue	Vloeistofequivalente neerslag die in de afgelopen 18 uur is gevallen.
past24Hours	WeatherValue	Vloeistof-equivalent neerslag die in de afgelopen 24 uur is gevallen.
past3Hours	WeatherValue	Vloeistof-equivalent neerslag die in de afgelopen 3 uur is gevallen.
past6Hours	WeatherValue	Vloeibare equivalente neerslag die in de afgelopen 6 uur is gevallen.
past9Hours	WeatherValue	Vloeistofequivalente neerslag die in de afgelopen 9 uur is gevallen.
pastHour	WeatherValue	Vloeistof-equivalent neerslag die het afgelopen uur is gevallen.

PressureTendency

Object

De recente trend in atmosferische druk – of de druk nu stijgt, daalt of stabiel is – kwam terug als zowel een lokale uitdrukking als een eenletterige code. Nuttig voor het anticiperen op korte termijn weersveranderingen; dalende druk duidt vaak op verslechterend weer, terwijl stijgende druk doorgaans op betere omstandigheden wijst.

Naam	Type	Description
code	string	Een taalonafhankelijke eenletterige code voor de druktendens: F = Vallend, S = Gestaag, R = Opgaand.
localizedDescription	string	Een korte zin die de druktendens beschrijft – bijvoorbeeld Vallend, Stabiel of Opstijgend – werd teruggegeven in de taal die in het verzoek was gespecificeerd.

TemperatureSummary

Object

De hoogste en laagste luchttemperaturen die op de locatie worden waargenomen over rollende ramen die eindigen bij het waarnemingsmoment. Elke waarde dekt het volledige venster dat van nu wordt gemeten – bijvoorbeeld rapporteert past12Hours het hoogste en laagste over de meest recente 12 uur, niet alleen het twaalfde uur – dus de vensters overlappen en langere vensters omvatten de gerapporteerde temperaturen voor de kortere vensters. Gerapporteerd in graden Celsius (°C) of Fahrenheit (°F), afhankelijk van de eenheid die in het verzoek is gespecificeerd.

Naam	Type	Description
past12Hours	PastHoursTemperature	Hoogste en laagste temperaturen waargenomen in de afgelopen 12 uur.
past24Hours	PastHoursTemperature	Hoogste en laagste temperaturen waargenomen in de afgelopen 24 uur.
past6Hours	PastHoursTemperature	Hoogste en laagste temperaturen waargenomen in de afgelopen 6 uur.

UnitType

Opsomming

Een geheel getal dat is gekoppeld aan het type eenheid dat wordt weergegeven. Bijvoorbeeld 17 voor Celsius, 18 voor Fahrenheit. Kan worden gebruikt voor unitvertaling. Voor meer informatie, zie Weerdiensten in Azure Maps.

Waarde	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	zweven
22	geheel getal
31	MicrogramsPerCubicMeterOfAir

WeatherDataUnit

Opsomming

Geeft aan of gegevens in metrische of imperiale eenheden moeten worden teruggegeven, met metriek als standaard. Voorbeeld:

Metrisch: millimeter (mm), meter (m), kilometer (km), Celsius (C)
Keizerlijk: inch (inch), voet (ft), mijl (mijl), Fahrenheit (F)

Waarde	Description
imperial	Geef gegevens terug met imperiale eenheden zoals Fahrenheit (F) voor temperatuur en mijlen (mijl) voor afstand.
metric	Retourneer gegevens met behulp van metrische eenheden zoals Celsius (C) voor temperatuur en kilometer (km) voor afstand.

WeatherValue

Object

Waarden voor weersgerelateerde metrieken zoals temperatuur, dauwpunt en windsnelheid, weergegeven in metrische of imperiale eenheden, zoals gespecificeerd in de eenheids-URI-parameter. Voor meer informatie, zie Eenheidstypen in het artikel Weerservices in Azure Maps.

Naam	Type	Description
unit	string	De meeteenheid die in de retourwaarde wordt gebruikt, zoals "C" voor Celsius, "F" voor Fahrenheit.
unitType	UnitType	Een geheel getal dat het type eenheid voorstelt. Bijvoorbeeld, 0 voor voeten, 1 voor inches, 2 voor mijlen. Voor een volledige lijst, zie Eenheidstypen in het artikel Weerservices in Azure Maps.
value	number (float)	De gemeten waarde uitgedrukt in de gespecificeerde eenheid.

WindDetails

Object

Geeft de voorspelde windsnelheid, gemeten in eenheden zoals kilometers per uur (km/u) of mijl per uur (mph), afhankelijk van de eenheid die in het verzoek is gespecificeerd. Geeft ook de windrichting aan, gemeten in azimutgraden, beginnend bij het ware noorden en met de klok mee bewegend. Noord komt overeen met 0°, oost met 90°, zuid met 180° en west met 270°. Mogelijke waarden variëren van 0° tot 359°.

Naam	Type	Description
direction	WindDirection	De windrichting wordt gemeten in azimutgraden, beginnend bij het ware noorden (0°) en bewegend met de klok mee. Oost komt overeen met 90°, zuid met 180° en westen met 270°. Mogelijke waarden variëren van 0° tot 359°. Deze eigenschap geeft een geheel getal dat de windrichting vertegenwoordigt.
speed	WeatherValue	De verwachte windsnelheid, gemeten in kilometers per uur (km/u) of mijl per uur (mph), afhankelijk van de eenheid die in het verzoek is gespecificeerd.

WindDirection

Object

Geeft details over windrichting, inclusief de richting in azimutgraden en een gelokaliseerde afkorting van de windrichting.

Naam	Type	Description
degrees	integer (int32)	De windrichting wordt gemeten in azimutgraden, beginnend bij het ware noorden en bewegend met de klok mee. Noord komt overeen met 0 graden, oost met 90 graden, zuid met 180 graden en west met 270 graden. Mogelijke waarden variëren van 0 tot 359 graden.
localizedDescription	string	Een lokale afkorting van de windrichting, teruggegeven in de taal die in het verzoek is gespecificeerd. Bijvoorbeeld `N` voor Noord, `E` voor Oost, `S` voor Zuid en `W` voor West.