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 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.

duration
query

integer (int32)

Hiermee geeft u op hoeveel dagen de dagelijkse prognosereacties worden geretourneerd. Beschikbare waarden zijn

  • 1 - Retourneer voorspellingsgegevens voor de volgende dag. Standaard geretourneerd.
  • 5 - Retourneer voorspellingsgegevens voor de komende 5 dagen.
  • 10 - Retourneer voorspellingsgegevens voor de komende 10 dagen.
  • 25 - Retourneer prognosegegevens voor de komende 25 dagen.
  • 45 - Retourneer voorspellingsgegevens voor de komende 45 dagen.
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

DailyForecastResult

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 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
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: name is boom, gras, ambrosia of schimmel. value geeft het voorspellingsbedrag en category / categoryValue beoordeel het van laag naar hoog.
  • Luchtkwaliteit: name is luchtkwaliteit en type identificeert de gemeten verontreinigende stof (een van PM2,5, PM10, O3, NO2, SO2 of CO). category / categoryValueBeoordeel de luchtkwaliteit van Goed tot Gevaarlijk.
  • UV-index: name is UVIndex. valueis de UV-index (0 tot 11+), en category / categoryValue beoordeel 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.

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.

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.

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).

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.

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.

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.

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.

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.

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.

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.

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.

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: name is boom, gras, ambrosia of schimmel. value geeft het voorspellingsbedrag en category / categoryValue beoordeel het van laag naar hoog.
  • Luchtkwaliteit: name is luchtkwaliteit en type identificeert de gemeten verontreinigende stof (een van PM2,5, PM10, O3, NO2, SO2 of CO). category / categoryValueBeoordeel de luchtkwaliteit van Goed tot Gevaarlijk.
  • UV-index: name is UVIndex. valueis de UV-index (0 tot 11+), en category / categoryValue beoordeel 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 name:

  • Pollen: Laag, Middelig, Hoog of Zeer Hoog.
  • Luchtkwaliteit: Goed, gematigd, ongezond voor gevoelige groepen, ongezond, zeer ongezond of gevaarlijk.
  • UV-index: Laag, Middelmatig, Hoog, Zeer Hoog of Extreem.
categoryValue

integer (int32)

Een numerieke beoordeling van 1-6 die wordt gecombineerd met category, waarbij 1 de veiligste omstandigheden aangeeft en 6 de gevaarlijkste. Gebruik dit wanneer een stabiele, taalonafhankelijke numerieke waarde nodig is in plaats van het gelokaliseerde category label.

name

string

Identificeert welke indicator deze vermelding vertegenwoordigt. Ofwel de naam van een pollenbron (boom, gras, ambrosia of schimmel), luchtkwaliteit (in dat geval type identificeert de verontreinigende stof), of UVIndex.

type

string

Wanneer name is AirQuality, de specifieke verontreinigende stof die wordt gemeten

  • één van PM2.5, PM10, O3 (ozon), NO2 (stikstofdioxide), SO2 (zwaveldioxide) of CO (koolmonoxide). Niet teruggestuurd voor pollen- of UV-index-inzendingen.
value

integer (int32)

De numerieke meting voor deze indicator. De eenheid hangt af van name:

  • Voor pollen, de voorspelde pollentelling.
  • Voor luchtkwaliteit geldt de concentratie verontreinigende stoffen in eenheden die passend zijn voor de verontreinigende stof - meestal microgram per kubieke meter (μg/m³) voor deeltjes en delen per miljard (ppb) voor gassen zoals ozon.
  • Voor UV-index een indexwaarde van 0 tot 11+.

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

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 category waarde (zoals Laag, Middel,Hoog, Goed, Ongezond of Gevaarlijk) zodat applicaties potentiële gezondheidsrisico's kunnen aanwijzen.

date

string (date-time)

De kalenderdatum die deze voorspelling beslaat, is in ISO 8601-formaat (yyyy-mm-ddThh:mm:ss-hh:mm). Bijvoorbeeld, 2025-04-29T07:00:00-07:00.

day

DailyForecastDetail

De gedetailleerde voorspelling voor het dagdeel van de dag - inclusief temperatuur, neerslag, wind, bewolking en andere belangrijke kenmerken.

degreeDaySummary

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

DailyForecastDetail

De gedetailleerde voorspelling voor het nachtelijke deel van de dag - inclusief temperatuur, neerslag, wind, bewolking en andere belangrijke eigenschappen.

realFeelTemperature

WeatherValueRange

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

WeatherValueRange

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 realFeelTemperature, maar sluit het verwarmingseffect van direct zonlicht uit, waardoor het een nauwkeuriger beeld krijgt van hoe het weer in de schaduw aanvoelt.

sources

string[]

De dataleveranciers die hebben bijgedragen aan de voorspelling van vandaag.

temperature

WeatherValueRange

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

true als er in deze periode neerslag (regen, sneeuw, ijzel of hagel) wordt verwacht; false anders.

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

WeatherValue

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

IconCode

Numerieke waarde die een afbeelding voorstelt die overeenkomt met de voorspelde weersomstandigheden voor deze periode, beschreven door de iconPhrase eigenschap. De numerieke waarde komt overeen met een Azure Maps-weerpictogram - voor de volledige lijst, zie Weerdiensten in Azure Maps. Kan NUL zijn.

iconPhrase

string

Een korte zin die het icoon beschrijft, teruggegeven in de taal die in het verzoek is gespecificeerd. Bijvoorbeeld, Sunny.

localSource

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 hasPrecipitation is true.

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

PrecipitationType

Het dominante type neerslag dat in deze periode wordt verwacht - regen,sneeuw, ijs of mix. Alleen teruggegeven wanneer hasPrecipitation is true.

rain

WeatherValue

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

WeatherValue

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

WeatherValue

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

WindDetails

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

WindDetails

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 wind.

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

DailyForecast[]

De per-dag voorspellingen, in chronologische volgorde met één vermelding per dag in de gevraagde duration. Elke vermelding geeft de DailyForecast dag-hoogste/laagste temperatuur, RealFeel-bereik, zonneuren, verwarming/koeling dagtotalen, lucht- en pollenindexen, aparte dag- en nachtdetailblokken (neerslag, wind, bewolking en meer), en de databronnen die bijdragen aan de voorspelling.

summary

DailyForecastSummary

Een overzicht op hoog niveau van de dominante weersomstandigheden gedurende het gevraagde voorspellingsvenster. De samenvatting kan slechts een deel van het venster beslaan

  • bijvoorbeeld wanneer significant weer (zoals een stormsysteem) wordt verwacht tijdens een deel ervan - in plaats van gedurende de hele periode.

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:

  • 0: Onbekend
  • 1: Belangrijk
  • 2: Belangrijk
  • 3: Matig
  • 4: Klein
  • 5: Minimaal
  • 6: Onbeduidend
  • 7: Informatief
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

WeatherValue

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

WeatherValue

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

ErrorAdditionalInfo[]

De fout bevat aanvullende informatie.

code

string

De foutcode.

details

ErrorDetail[]

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

ErrorDetail

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 MapsiconCode.

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

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

WeatherValue

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

WeatherValue

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

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

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.