Weather - Get Daily Forecast
Gebruik dit om dagelijks een gedetailleerde weersvoorspelling te krijgen voor de komende 1, 5, 10, 15, 25 of 45 dagen.
De Get Daily Forecast API is een HTTP-verzoek GET dat gedetailleerde weersvoorspellingen retourneert, zoals temperatuur en wind per dag voor de komende 1, 5, 10, 15, 25 of 45 dagen voor een bepaalde coördinaatlocatie. De respons omvat details zoals temperatuur, wind, neerslag, luchtkwaliteit en UV-index. Zie Dagelijkse weersvoorspellingsgegevens opvragen voor meer informatie.
GET {endpoint}/weather/forecast/daily/json?api-version=1.1&query={query}
GET {endpoint}/weather/forecast/daily/json?api-version=1.1&query={query}&unit={unit}&duration={duration}&language={language}
URI-parameters
| Naam | In | Vereist | Type | Description |
|---|---|---|---|---|
|
endpoint
|
path | True |
string (uri) |
De hostnaam van de Azure Maps-service. Gebruik |
|
format
|
path | True |
Gewenste indeling van het antwoord. Alleen |
|
|
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. |
|
duration
|
query |
integer (int32) |
Hiermee geeft u op hoeveel dagen de dagelijkse prognosereacties worden geretourneerd. Beschikbare waarden zijn
|
|
|
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 |
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 |
De aanvraag is voltooid. |
|
| Other Status Codes |
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 URLis 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 daily weather forecast for a given coordinate location
Voorbeeldaanvraag
GET https://atlas.microsoft.com/weather/forecast/daily/json?api-version=1.1&query=62.6490341,30.0734812&duration=5
Voorbeeldrespons
{
"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"
}
}
Definities
| Naam | Description |
|---|---|
|
Air |
Een vermelding van
|
|
Daily |
De voorspelling voor één kalenderdag op de opgegeven locatie werd teruggegeven als één invoer per dag in de |
|
Daily |
Voorspellingsdetails voor een halve dag. Dezelfde vorm wordt gebruikt voor zowel |
|
Daily |
De reactie werd teruggegeven door de Get Daily Forecast-operatie, die een dag-tot-dag weersvoorspelling gaf voor een bepaalde locatie. Bevat een top-level |
|
Daily |
Een overzicht van de dominante weersomstandigheden binnen een deel of geheel van het gevraagde dagelijkse voorspellingsvenster. Het samengevat venster kan smaller zijn dan het volledige verzoek – bijvoorbeeld wanneer significant weer (zoals een stormsysteem) slechts een deel van de periode wordt verwacht – en wordt begrensd door |
|
Degree |
Totalen van verwarmings- en koeldag-graad voor één dag, gebruikt om de energievraag voor verwarming of koeling van een gebouw te schatten. Elke waarde is het aantal graden waarmee de gemiddelde temperatuur van de dag afwijkt van de 65°F (18°C) basislijn, in de temperatuureenheid die in het verzoek is gespecificeerd - graden onder de basislijn dragen bij aan |
|
Error |
Aanvullende informatie over de resourcebeheerfout. |
|
Error |
De foutdetails. |
|
Error |
Veelvoorkomende foutrespons voor alle Azure Resource Manager API's om foutdetails terug te geven bij mislukte bewerkingen. (Dit volgt ook de OData-foutreactieindeling.) |
|
Icon |
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 Voor de volledige lijst met codes, de iconen waaraan ze worden gekoppeld, en voorbeeldafbeeldingen, zie Weerservices in Azure Maps. |
|
Json |
Gewenste indeling van het antwoord. Alleen |
|
Local |
Informatie over een lokale weergegevensleverancier die wordt gebruikt om de voorspelling te verzamelen op |
|
Precipitation |
Specificeert het type neerslag. Geldige waarden zijn Regen,Sneeuw, IJs of Mix. Deze eigenschap wordt opgenomen in het antwoord wanneer dBZ groter is dan nul. |
|
Unit |
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. |
|
Weather |
Geeft aan of gegevens in metrische of imperiale eenheden moeten worden teruggegeven, met metriek als standaard. Voorbeeld:
|
|
Weather |
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. |
|
Weather |
Geeft de hoogste en laagste voorspelde temperaturen voor het opgegeven tijdsbestek, gemeten in graden Celsius (°C) of Fahrenheit (°F), gebaseerd op de eenheid die in het verzoek is gespecificeerd. |
|
Wind |
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°. |
|
Wind |
Geeft details over windrichting, inclusief de richting in azimutgraden en een gelokaliseerde afkorting van de windrichting. |
AirAndPollen
Een vermelding van DailyForecast.airAndPollen een enkele stuifmeel-, luchtkwaliteits- of UV-indexindicator voor de dag. De name eigenschap bepaalt welk soort indicator de invoer vertegenwoordigt:
-
Stuifmeel:
nameis boom, gras, ambrosia of schimmel.valuegeeft het voorspellingsbedrag encategory/categoryValuebeoordeel het van laag naar hoog. -
Luchtkwaliteit:
nameis luchtkwaliteit entypeidentificeert de gemeten verontreinigende stof (een van PM2,5, PM10, O3, NO2, SO2 of CO).category/categoryValueBeoordeel de luchtkwaliteit van Goed tot Gevaarlijk. -
UV-index:
nameis UVIndex.valueis de UV-index (0 tot 11+), encategory/categoryValuebeoordeel het blootstellingsrisico van Laag naar Extreem.
category is het kwalitatieve label voor de indicator en categoryValue is de overeenkomende 1-6 beoordeling, waarbij 1 de veiligste omstandigheden aangeeft en 6 de gevaarlijkste.
| Naam | Type | Description |
|---|---|---|
| category |
string |
Een kort kwalitatief label voor de indicator, teruggegeven in de taal die in het verzoek is gespecificeerd. Mogelijke waarden hangen af van
|
| categoryValue |
integer (int32) |
Een numerieke beoordeling van 1-6 die wordt gecombineerd met |
| name |
string |
Identificeert welke indicator deze vermelding vertegenwoordigt. Ofwel de naam van een pollenbron (boom, gras, ambrosia of schimmel), luchtkwaliteit (in dat geval |
| type |
string |
Wanneer
|
| value |
integer (int32) |
De numerieke meting voor deze indicator. De eenheid hangt af van
Zowel luchtkwaliteit als UV-index zijn zelf indices, dus worden ze als eenheidsloze getallen gerapporteerd. |
DailyForecast
De voorspelling voor één kalenderdag op de opgegeven locatie werd teruggegeven als één invoer per dag in de forecasts array op DailyForecastResult.
Bevat het maximum/laagtemperatuurbereik van de dag, RealFeel-waarden (normaal en schaduwrijk), verwachte zonneuren, totalen voor verwarming/koeling van de dag, een reeks luchtkwaliteits-, pollen- en UV-indexindicatoren, en aparte detailblokken voor de dag- en nachtdelen van de dag (neerslag, wind, bewolking en meer). De sources array vermeldt de dataproviders die bijdragen aan de voorspelling.
| Naam | Type | Description |
|---|---|---|
| airAndPollen |
Voorspelde luchtkwaliteit-, pollen- en UV-indexindicatoren voor de dag.
Elke vermelding vermeldt een naam (zoals Boom, Gras, Ambrosia, Schimmel, Luchtkwaliteit of UVIndex), een numerieke waarde en een kwalitatieve |
|
| date |
string (date-time) |
De kalenderdatum die deze voorspelling beslaat, is in ISO 8601-formaat ( |
| day |
De gedetailleerde voorspelling voor het dagdeel van de dag - inclusief temperatuur, neerslag, wind, bewolking en andere belangrijke kenmerken. |
|
| degreeDaySummary |
Totalen van de verwarmings- en koeldag voor de dag, gebruikt om de energievraag voor de klimaatregeling van het gebouw te schatten. |
|
| hoursOfSun |
number (float) |
Het verwachte aantal zonuren overdag, nuttig voor het plannen van buitenactiviteiten en het inschatten van de algehele dagomstandigheden. |
| night |
De gedetailleerde voorspelling voor het nachtelijke deel van de dag - inclusief temperatuur, neerslag, wind, bewolking en andere belangrijke eigenschappen. |
|
| realFeelTemperature |
De hoge en lage RealFeel™ Temperature-waarden voor de dag, 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 |
De hoge en lage RealFeel-temperatuurwaarden™ voor de dag in schaduwrijke gebieden, in graden Celsius (°C) of Fahrenheit (°F), afhankelijk van de eenheid die in het verzoek is gespecificeerd. Zoals |
|
| sources |
string[] |
De dataleveranciers die hebben bijgedragen aan de voorspelling van vandaag. |
| temperature |
De voorspelde hoge en lage luchttemperaturen voor de dag, in graden Celsius (°C) of Fahrenheit (°F), afhankelijk van de eenheid die in het verzoek is gespecificeerd. |
DailyForecastDetail
Voorspellingsdetails voor een halve dag. Dezelfde vorm wordt gebruikt voor zowel DailyForecast.day (zonsopgang tot zonsondergang) als DailyForecast.night (zonsondergang tot volgende zonsopgang), dus alle verwijzingen naar "deze periode" hieronder betekenen dat specifieke dag- of nachtgedeelte - nooit de volledige 24-uursdag. Bevat een voorspellingsicoon en woorden, neerslagtype / intensiteit / waarschijnlijkheden, totale hoeveelheden ophoping, uren neerslag, wind en bewolking.
| Naam | Type | Description |
|---|---|---|
| cloudCover |
integer (int32) |
Het percentage van de lucht dat in deze periode door wolken bedekt was, varieerde van 0 (heldere lucht) tot 100 (volledig bewolkt). Kan NUL zijn. |
| hasPrecipitation |
boolean |
|
| hoursOfIce |
number (float) |
Het totale aantal uren gedurende deze periode waarin ijsvorming wordt verwacht. |
| hoursOfPrecipitation |
number (float) |
Het totale aantal uren gedurende deze periode waarin neerslag (regen, sneeuw, ijzel of hagel) wordt verwacht. |
| hoursOfRain |
number (float) |
Het totale aantal uren gedurende deze periode waarin regen wordt verwacht. |
| hoursOfSnow |
number (float) |
Het totale aantal uren gedurende deze periode waarin sneeuw wordt verwacht. |
| ice |
De hoeveelheid ijsophoping die gedurende deze periode wordt verwacht, in millimeters (mm) of inches (in), afhankelijk van de eenheid die in het verzoek is gespecificeerd. |
|
| iceProbability |
integer (int32) |
De kans op ijsvorming in deze periode, uitgedrukt als een percentage van 0 tot 100, waarbij 0 betekent geen kans op ijs en 100 betekent dat ijzige omstandigheden zeker zijn. |
| iconCode |
Numerieke waarde die een afbeelding voorstelt die overeenkomt met de voorspelde weersomstandigheden voor deze periode, beschreven door de |
|
| iconPhrase |
string |
Een korte zin die het icoon beschrijft, teruggegeven in de taal die in het verzoek is gespecificeerd. Bijvoorbeeld, Sunny. |
| localSource |
Informatie over de lokale weergegevensleverancier waarvan de icooncode en weercode voor deze periode werden gebruikt, toen er één werd geselecteerd. |
|
| longPhrase |
string |
Een langere, meer beschrijvende uitdrukking voor deze periode, teruggegeven in de taal die in het verzoek is gespecificeerd. Azure Maps probeert deze zin onder de 100 tekens te houden, maar sommige talen of weersomstandigheden kunnen een langere reeks produceren. |
| precipitationIntensity |
string |
Een korte kwalitatieve beschrijving van de neerslagintensiteit voor deze periode - bijvoorbeeld Licht, Matig of Zwaar.
Teruggegeven in de taal die in het verzoek is gespecificeerd, en alleen wanneer |
| precipitationProbability |
integer (int32) |
De kans op neerslag in deze periode, uitgedrukt als een percentage van 0 tot 100, waarbij 0 betekent geen kans op neerslag en 100 betekent dat neerslag zeker is. |
| precipitationType |
Het dominante type neerslag dat in deze periode wordt verwacht - regen,sneeuw, ijs of mix. Alleen teruggegeven wanneer |
|
| rain |
De hoeveelheid neerslag die gedurende deze periode wordt verwacht, in millimeters (mm) of inches (in), afhankelijk van de eenheid die in het verzoek is gespecificeerd. |
|
| rainProbability |
integer (int32) |
De kans op regen in deze periode, uitgedrukt als een percentage van 0 tot 100, waarbij 0 betekent geen kans op regen en 100 betekent regen zeker is. |
| shortPhrase |
string |
Een korte zin die de voorspelling voor deze periode beschrijft, teruggegeven in de taal die in het verzoek is gespecificeerd. Azure Maps probeert deze zin onder de 30 tekens te houden, maar sommige talen of weersomstandigheden kunnen een langere string produceren. |
| snow |
De hoeveelheid sneeuwophoping die gedurende deze periode wordt verwacht, in centimeters (cm) of inches (in), afhankelijk van de eenheid die in het verzoek is gespecificeerd. |
|
| snowProbability |
integer (int32) |
De kans op sneeuw in deze periode, uitgedrukt als een percentage van 0 tot 100, waarbij 0 betekent geen kans op sneeuw en 100 betekent dat sneeuw zeker is. |
| thunderstormProbability |
integer (int32) |
De kans op een onweersbui in deze periode, uitgedrukt als een percentage van 0 tot 100, waarbij 0 betekent dat er geen kans op een onweersstorm is en 100 een onweersbui zeker is. |
| totalLiquid |
De totale hoeveelheid vloeibare neerslag (zoals regen, plus het vloeibare equivalent van sneeuw of ijs) die in deze periode wordt verwacht, wordt in millimeters (mm) of inches (in) afhankelijk van de eenheid die in het verzoek is gespecificeerd. |
|
| wind |
De voorspelde windsnelheid en -richting voor deze periode. De windsnelheid is in kilometers per uur (km/u) of mijl per uur (mph), afhankelijk van de eenheid die in het verzoek is gespecificeerd. De windrichting wordt gemeten in azimutgraden, van 0° (echt noord) tot 359°, met de klok mee bewegend - oost is 90°, zuid is 180°, west is 270°. |
|
| windGust |
De verwachte maximale korte-uitbarsting windsnelheid en -richting gedurende deze periode. Windstoten zijn plotselinge, korte toename van windsnelheid die belangrijk zijn voor activiteiten zoals luchtvaart, zeilen en vliegeren. Snelheid is in kilometers per uur (km/u) of mijl per uur (mph), afhankelijk van de eenheid die in het verzoek is gespecificeerd, en richting gebruikt dezelfde azimutconventie als |
DailyForecastResult
De reactie werd teruggegeven door de Get Daily Forecast-operatie, die een dag-tot-dag weersvoorspelling gaf voor een bepaalde locatie. Bevat een top-level summary die de dominante omstandigheden en ernst van het gevraagde venster beschrijft, plus een forecasts array met één DailyForecast invoer per dag.
Het aantal inschrijvingen komt overeen met de gevraagde duration (1, 5, 10, 15, 25 of 45 dagen; 25 en 45 dagen vereisen een S1 SKU).
| Naam | Type | Description |
|---|---|---|
| forecasts |
De per-dag voorspellingen, in chronologische volgorde met één vermelding per dag in de gevraagde |
|
| summary |
Een overzicht op hoog niveau van de dominante weersomstandigheden gedurende het gevraagde voorspellingsvenster. De samenvatting kan slechts een deel van het venster beslaan
|
DailyForecastSummary
Een overzicht van de dominante weersomstandigheden binnen een deel of geheel van het gevraagde dagelijkse voorspellingsvenster. Het samengevat venster kan smaller zijn dan het volledige verzoek – bijvoorbeeld wanneer significant weer (zoals een stormsysteem) slechts een deel van de periode wordt verwacht – en wordt begrensd door startDate en endDate. De voorwaarden zelf worden zowel beschreven als een vrije vorm phrase, een label van één of twee woorden category , als een numerieke severity beoordeling.
| Naam | Type | Description |
|---|---|---|
| category |
string |
Een label van één of twee woorden dat de dominante weersomstandigheden voor het samengevat venster categoriseert – bijvoorbeeld zonnig, deels bewolkt, regen of sneeuw. |
| endDate |
string (date-time) |
Het einde van het venster dat door deze samenvatting wordt behandeld, is in RFC 3339-formaat - bijvoorbeeld 2019-10-29T07:00:00-08:00. Kan eerder dan het einde van het gevraagde voorspellingsvenster zijn als het samengevat evenement vóór het einde eindigt. |
| phrase |
string |
Een korte, vrije tekstoverzicht van de dominante weersomstandigheden voor het samengevat venster, teruggegeven in de taal die in het verzoek is gespecificeerd. Verwacht bijvoorbeeld buien van dinsdag tot en met donderdag. |
| severity |
integer (int32) |
Een numerieke ernstbeoordeling voor het samengevat weersevenement. Lagere getallen (exclusief 0) duiden op een hogere ernst:
|
| startDate |
string (date-time) |
Het begin van het venster dat door deze samenvatting wordt behandeld, is in RFC 3339-formaat - bijvoorbeeld 2019-10-27T19:39:57-08:00. Het kan later zijn dan het begin van het gevraagde voorspellingsvenster als het samengevat evenement halverwege begint. |
DegreeDaySummary
Totalen van verwarmings- en koeldag-graad voor één dag, gebruikt om de energievraag voor verwarming of koeling van een gebouw te schatten. Elke waarde is het aantal graden waarmee de gemiddelde temperatuur van de dag afwijkt van de 65°F (18°C) basislijn, in de temperatuureenheid die in het verzoek is gespecificeerd - graden onder de basislijn dragen bij aan heating, graden erboven dragen bij aan cooling.
| Naam | Type | Description |
|---|---|---|
| cooling |
Afkoelingsdagen (CDD) - het aantal graden waarop de gemiddelde temperatuur van de dag boven de 18°C (65°F) uitkomt. Hogere waarden duiden op een grotere koelvraag. Gerapporteerd in graden Celsius (°C) of Fahrenheit (°F), afhankelijk van de eenheid die in het verzoek is gespecificeerd. |
|
| heating |
Verwarmingsgraden dagen (HDD) - het aantal graden dat de gemiddelde temperatuur van de dag onder de 65°F (18°C) basislijn ligt. Hogere waarden duiden op een grotere warmtevraag. Gerapporteerd in graden Celsius (°C) of Fahrenheit (°F), afhankelijk van de eenheid die in het verzoek is gespecificeerd. |
ErrorAdditionalInfo
Aanvullende informatie over de resourcebeheerfout.
| Naam | Type | Description |
|---|---|---|
| info |
De aanvullende informatie. |
|
| type |
string |
Het extra informatietype. |
ErrorDetail
De foutdetails.
| Naam | Type | Description |
|---|---|---|
| additionalInfo |
De fout bevat aanvullende informatie. |
|
| code |
string |
De foutcode. |
| details |
De foutdetails. |
|
| message |
string |
Het foutbericht. |
| target |
string |
Het foutdoel. |
ErrorResponse
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 |
Het foutobject. |
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.
| 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
Gewenste indeling van het antwoord. Alleen json indeling wordt ondersteund.
| Waarde | Description |
|---|---|
| json |
De Notatie Data Interchange-indeling voor JavaScript-objecten |
LocalSource
Informatie over een lokale weergegevensleverancier die wordt gebruikt om de voorspelling te verzamelen op DailyForecastDetail.localSource. Identificeert de provider (id, name) en stelt de native weatherCode van de provider bloot, zodat applicaties de eigen pictogrammenset van de provider kunnen weergeven in plaats van de standaard Azure Maps-iconen.
| Naam | Type | Description |
|---|---|---|
| id |
integer (int32) |
Een numerieke identificatie die de lokale gegevensleverancier uniek identificeert. |
| name |
string |
De naam van de lokale dataprovider, teruggegeven in de taal die in het verzoek is gespecificeerd indien beschikbaar; anders teruggegeven in het Engels of in de taal waarin de provider het leverde. |
| weatherCode |
string |
De provider-native weercode voor deze voorspelling, geschikt om te mappen naar de eigen pictogramset van de provider in plaats van de standaard Azure Maps |
PrecipitationType
Specificeert het type neerslag. Geldige waarden zijn Regen,Sneeuw, IJs of Mix. Deze eigenschap wordt opgenomen in het antwoord wanneer dBZ groter is dan nul.
| Waarde | Description |
|---|---|
| Ice |
Ice |
| Mix |
Mix |
| Rain |
Rain |
| Snow |
Snow |
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.
| 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
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
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 |
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. |
WeatherValueRange
Geeft de hoogste en laagste voorspelde temperaturen voor het opgegeven tijdsbestek, gemeten in graden Celsius (°C) of Fahrenheit (°F), gebaseerd op de eenheid die in het verzoek is gespecificeerd.
| Naam | Type | Description |
|---|---|---|
| maximum |
Geeft de maximale temperatuur voor het opgegeven tijdsbestek, gemeten in graden Celsius (°C) of Fahrenheit (°F), gebaseerd op de eenheid die in het verzoek is gespecificeerd. |
|
| minimum |
Geeft de minimale temperatuur voor de opgegeven tijdsperiode, gemeten in graden Celsius (°C) of Fahrenheit (°F), gebaseerd op de eenheid die in het verzoek is gespecificeerd. |
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°.
| Naam | Type | Description |
|---|---|---|
| direction |
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 |
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
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 |