Weather - Get Daily Forecast

Referentie

Service:: Maps

API Version:: 1.1

Gebruik dit om een dagelijkse gedetailleerde weersvoorspelling te krijgen voor de komende 1, 5, 10, 15, 25 of 45 dagen.

De Get Daily Forecast API is een HTTP-aanvraag GET die gedetailleerde weersvoorspellingen retourneert, zoals temperatuur en wind per dag voor de volgende 1, 5, 10, 15, 25 of 45 dagen voor een bepaalde coördinatenlocatie. De reactie bevat details zoals temperatuur, wind, neerslag, luchtkwaliteit en UV-index. Zie Dagelijkse weersvoorspellingsgegevens aanvragen voor meer informatie.

Als u de prijscategorie Gen1 S0 gebruikt, kunt u een dagelijkse prognose aanvragen voor de komende 1, 5, 10 en 15 dagen. Als u de prijscategorie Gen1 S1 of Gen2 gebruikt, kunt u ook een dagelijkse prognose aanvragen voor de komende 25 dagen en 45 dagen.

GET https://atlas.microsoft.com/weather/forecast/daily/json?api-version=1.1&query={query}

With optional parameters:

GET https://atlas.microsoft.com/weather/forecast/daily/json?api-version=1.1&query={query}&unit={unit}&duration={duration}&language={language}

URI-parameters

Name	In	Vereist	Type	Description
format	path	True	JsonFormat	Gewenste indeling van het antwoord. Alleen `json` de indeling wordt ondersteund.
api-version	query	True	string	Versienummer van Azure Maps API.
query	query	True	number[]	De toepasselijke query die is opgegeven als een door komma's gescheiden tekenreeks, samengesteld door breedtegraad gevolgd door lengtegraad, bijvoorbeeld '47,641268,-122,125679'.
duration	query		integer	Hiermee geeft u op hoeveel dagen de dagelijkse prognoseantwoorden worden geretourneerd. Beschikbare waarden zijn `1` - Retourneer prognosegegevens voor de volgende dag. Standaard geretourneerd. `5` - Retourneer prognosegegevens voor de komende 5 dagen. `10` - Retourneer prognosegegevens voor de komende 10 dagen. `25` - Retourneer prognosegegevens voor de komende 25 dagen. Alleen beschikbaar in S1 SKU. `45` - Retourneer prognosegegevens voor de komende 45 dagen. Alleen beschikbaar in S1 SKU.
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	Hiermee geeft u op om de gegevens in metrische eenheden of imperiale eenheden te retourneren. De standaardwaarde is metrische waarde.

Aanvraagkoptekst

Name	Vereist	Type	Description
x-ms-client-id		string	Hiermee geeft u op welk account is bedoeld voor gebruik in combinatie met het Microsoft Entra ID-beveiligingsmodel. Het vertegenwoordigt een unieke id voor het Azure Maps-account en kan worden opgehaald uit de Azure Maps beheervlak Account-API. Als u Microsoft Entra ID-beveiliging in Azure Maps raadpleegt u de volgende artikelen voor hulp.

Antwoorden

Name	Type	Description
200 OK	DailyForecastResult	OK
Other Status Codes	ErrorResponse	Er is een onverwachte fout opgetreden.

Beveiliging

AADToken

Dit zijn de Microsoft Entra OAuth 2.0-stromen. In combinatie met op rollen gebaseerd toegangsbeheer van Azure kan het worden gebruikt om de toegang tot Azure Maps REST API's te beheren. Op rollen gebaseerd toegangsbeheer van Azure wordt gebruikt om toegang tot een of meer Azure Maps resourceaccount 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.

Als u scenario's wilt implementeren, raden we u aan om verificatieconcepten te bekijken. Samengevat biedt deze beveiligingsdefinitie een oplossing voor het modelleren van toepassingen via objecten die toegangsbeheer kunnen hebben voor specifieke API's en bereiken.

Notities

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 via de Beheer-API van Maps .

De Authorization URL is specifiek voor het azure-exemplaar van de openbare cloud. Onafhankelijke clouds hebben unieke autorisatie-URL's en Microsoft Entra ID configuraties. * Op rollen gebaseerd 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 configuratie van een toepassing mogelijk voor meerdere gebruiksscenario's.

Zie Microsoft identity platform overzicht voor meer informatie over Microsoft identity platform.

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

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

subscription-key

Dit is een gedeelde sleutel die wordt ingericht wanneer u een Azure Maps-account Creatie in de 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 zijn uitgegeven.

Voor openbaar beschikbare toepassingen wordt aanbevolen om de vertrouwelijke clienttoepassingen te gebruiken voor toegang tot Azure Maps REST API's, zodat uw sleutel veilig kan worden opgeslagen.

Type: apiKey
In: query

SAS Token

Dit is een shared access signature-token dat wordt gemaakt op basis van de SAS-bewerking List 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 om toegang te krijgen met op rollen gebaseerd toegangsbeheer van Azure en fijnmazige controle over het verloop, de snelheid en de gebruiksregio(s) voor het specifieke token. Met andere woorden, het SAS-token kan worden gebruikt om toepassingen in staat te stellen toegang op een veiligere manier te beheren dan de gedeelde sleutel.

Voor openbaar beschikbaar gemaakte toepassingen wordt aanbevolen om een specifieke lijst met toegestane oorsprongen te configureren op de resource Van het account toewijzen om misbruik van het genereren 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

Sample Request

HTTP

GET https://atlas.microsoft.com/weather/forecast/daily/json?api-version=1.1&query=62.6490341,30.0734812&duration=5

Sample Response

Status code:: 200

{
  "summary": {
    "startDate": "2019-11-17T09:00:00-08:00",
    "endDate": "2019-11-17T15:00:00-08:00",
    "severity": 5,
    "phrase": "Rain Sunday evening",
    "category": "rain"
  },
  "forecasts": [
    {
      "date": "2019-11-13T21:00:00-08:00",
      "temperature": {
        "minimum": {
          "value": 0.8,
          "unit": "C",
          "unitType": 17
        },
        "maximum": {
          "value": 5.3,
          "unit": "C",
          "unitType": 17
        }
      },
      "realFeelTemperature": {
        "minimum": {
          "value": -3.4,
          "unit": "C",
          "unitType": 17
        },
        "maximum": {
          "value": 1.3,
          "unit": "C",
          "unitType": 17
        }
      },
      "realFeelTemperatureShade": {
        "minimum": {
          "value": -3.4,
          "unit": "C",
          "unitType": 17
        },
        "maximum": {
          "value": 1.6,
          "unit": "C",
          "unitType": 17
        }
      },
      "hoursOfSun": 1.1,
      "degreeDaySummary": {
        "heating": {
          "value": 15,
          "unit": "C",
          "unitType": 17
        },
        "cooling": {
          "value": 0,
          "unit": "C",
          "unitType": 17
        }
      },
      "airAndPollen": [
        {
          "name": "AirQuality",
          "value": 0,
          "category": "Good",
          "categoryValue": 1,
          "type": "Ozone"
        },
        {
          "name": "Grass",
          "value": 0,
          "category": "Low",
          "categoryValue": 1
        },
        {
          "name": "Mold",
          "value": 0,
          "category": "Low",
          "categoryValue": 1
        },
        {
          "name": "Ragweed",
          "value": 0,
          "category": "Low",
          "categoryValue": 1
        },
        {
          "name": "Tree",
          "value": 0,
          "category": "Low",
          "categoryValue": 1
        },
        {
          "name": "UVIndex",
          "value": 0,
          "category": "Low",
          "categoryValue": 1
        }
      ],
      "day": {
        "iconCode": 12,
        "iconPhrase": "Showers",
        "hasPrecipitation": true,
        "precipitationType": "Rain",
        "precipitationIntensity": "Light",
        "shortPhrase": "Cloudy with a few showers",
        "longPhrase": "Cloudy with a couple of showers, mainly later",
        "precipitationProbability": 75,
        "thunderstormProbability": 20,
        "rainProbability": 75,
        "snowProbability": 40,
        "iceProbability": 0,
        "wind": {
          "direction": {
            "degrees": 160,
            "localizedDescription": "SSE"
          },
          "speed": {
            "value": 16.7,
            "unit": "km/h",
            "unitType": 7
          }
        },
        "windGust": {
          "direction": {
            "degrees": 160,
            "localizedDescription": "SSE"
          },
          "speed": {
            "value": 48.2,
            "unit": "km/h",
            "unitType": 7
          }
        },
        "totalLiquid": {
          "value": 6.1,
          "unit": "mm",
          "unitType": 3
        },
        "rain": {
          "value": 6.1,
          "unit": "mm",
          "unitType": 3
        },
        "snow": {
          "value": 0,
          "unit": "cm",
          "unitType": 4
        },
        "ice": {
          "value": 0,
          "unit": "mm",
          "unitType": 3
        },
        "hoursOfPrecipitation": 3.5,
        "hoursOfRain": 3.5,
        "hoursOfSnow": 0,
        "hoursOfIce": 0,
        "cloudCover": 100
      },
      "night": {
        "iconCode": 12,
        "iconPhrase": "Showers",
        "hasPrecipitation": true,
        "precipitationType": "Rain",
        "precipitationIntensity": "Light",
        "shortPhrase": "Breezy early; cloudy",
        "longPhrase": "Breezy this evening; otherwise, low clouds",
        "precipitationProbability": 65,
        "thunderstormProbability": 0,
        "rainProbability": 64,
        "snowProbability": 40,
        "iceProbability": 0,
        "wind": {
          "direction": {
            "degrees": 181,
            "localizedDescription": "S"
          },
          "speed": {
            "value": 20.4,
            "unit": "km/h",
            "unitType": 7
          }
        },
        "windGust": {
          "direction": {
            "degrees": 170,
            "localizedDescription": "S"
          },
          "speed": {
            "value": 42.6,
            "unit": "km/h",
            "unitType": 7
          }
        },
        "totalLiquid": {
          "value": 4,
          "unit": "mm",
          "unitType": 3
        },
        "rain": {
          "value": 4,
          "unit": "mm",
          "unitType": 3
        },
        "snow": {
          "value": 0,
          "unit": "cm",
          "unitType": 4
        },
        "ice": {
          "value": 0,
          "unit": "mm",
          "unitType": 3
        },
        "hoursOfPrecipitation": 2.5,
        "hoursOfRain": 2.5,
        "hoursOfSnow": 0,
        "hoursOfIce": 0,
        "cloudCover": 98
      },
      "sources": [
        "AccuWeather"
      ]
    }
  ]
}

Definities

Name	Description
AirAndPollen
DailyForecast
DailyForecastResult
DailyForecastSummary	Samenvatting van de belangrijkste voorwaarden voor de aangevraagde periode. U ziet dat samenvatting slechts een deel van de periode kan omvatten.
DayOrNight
DegreeDaySummary
ErrorAdditionalInfo	Aanvullende informatie over de resourcebeheerfout.
ErrorDetail	De foutdetails.
ErrorResponse	Foutreactie
IconCode	Numerieke waarde die een afbeelding vertegenwoordigt waarin de `iconPhrase`wordt weergegeven. Raadpleeg Weerservices in Azure Maps voor meer informatie.
JsonFormat	Gewenste indeling van het antwoord. Alleen `json` de indeling wordt ondersteund.
LocalSource	Informatie van de provider van lokale weergegevens.
PrecipitationType	Hiermee geeft u het type neerslag op ("Regen" "Sneeuw" "Ijs" of "Mix"). Als dbz nul is, is precipitationType niet aanwezig in het antwoord.
UnitType	Numerieke id-waarde die is gekoppeld aan het type eenheid dat wordt weergegeven. Kan worden gebruikt voor eenheidsvertaling. Raadpleeg Weerservices in Azure Maps voor meer informatie.
WeatherDataUnit	Hiermee geeft u op om de gegevens in metrische eenheden of imperiale eenheden te retourneren. De standaardwaarde is metrische waarde.
WeatherUnit	Specifieke waarde van een bepaalde eenheid met betrekking tot het weer.
WeatherUnitRange	Geretourneerde temperatuurwaarden.
WindDetails	Winddetails die worden geretourneerd, inclusief snelheid en richting.
WindDirection	Windrichting

AirAndPollen

Name	Type	Description
category	string	Categorie van het type luchtkwaliteit of verontreiniging. Bijvoorbeeld laag, hoog, goed, gemiddeld, beschadigd, gevaarlijk.
categoryValue	integer	De waarde die samenhangt met de categorie luchtkwaliteit of verontreiniging. Deze waarden variëren van 1 tot 6. 1 impliceert goede omstandigheden, 6 impliceert gevaarlijke omstandigheden.
name	string	Naam van het stuifmeel of de verontreinigende stof. Bijvoorbeeld gras, schimmel, wiet, luchtkwaliteit, boom en UV-index.
type	string	Bestaat alleen voor luchtkwaliteit. Voorbeelden zijn ozon- en deeltjesvervuiling.
value	integer	De waarde van het bovenstaande type. Waarden voor schimmel, gras, wiet en boom zijn in eenheden van delen per kubieke meter. Zowel luchtkwaliteit als UV zijn indexen, dus ze zijn eenheidloos.

DailyForecast

Name	Type	Description
airAndPollen	AirAndPollen[]	Luchtkwaliteit
date	string	Datum en tijd van de huidige waarneming weergegeven in ISO 8601-notatie, bijvoorbeeld 2019-10-27T19:39:57-08:00.
day	DayOrNight	Details van dagprognose
degreeDaySummary	DegreeDaySummary	Samenvatting voor de informatie over de gemiddelde temperatuur van de verwarmings- of koelgraaddag
hoursOfSun	number	Uren zon.
night	DayOrNight	Details van nachtprognose
realFeelTemperature	WeatherUnitRange	RealFeel™ Temperatuur wordt geretourneerd.
realFeelTemperatureShade	WeatherUnitRange	RealFeel™ Temperatuur wordt geretourneerd. Beschrijft hoe de temperatuur echt voelt in de schaduw.
sources	string[]	Bron(en) van de prognosegegevens.
temperature	WeatherUnitRange	Temperatuurwaarden voor de dag.

DailyForecastResult

Name	Type	Description
forecasts	DailyForecast[]	Prognosegegevens voor elke aangevraagde dag.
summary	DailyForecastSummary	Samenvatting van de belangrijkste voorwaarden voor de aangevraagde periode. U ziet dat samenvatting slechts een deel van de periode kan omvatten.

DailyForecastSummary

Samenvatting van de belangrijkste voorwaarden voor de aangevraagde periode. U ziet dat samenvatting slechts een deel van de periode kan omvatten.

Name	Type	Description
category	string	een of twee woorden om de woordgroep samen te vatten.
endDate	string	De datum en tijd waarop de samenvattingsperiode eindigt, weergegeven in ISO 8601-indeling, bijvoorbeeld 2019-10-27T19:39:57-08:00.
phrase	string	Samenvattingszin van de dagelijkse prognose. Weergegeven in de opgegeven taal.
severity	integer	ernst
startDate	string	De datum en tijd waarop de samenvatting van kracht is, weergegeven in ISO 8601-indeling, bijvoorbeeld 2019-10-27T19:39:57-08:00.

DayOrNight

Name	Type	Description
cloudCover	integer	Percentage dat de bewolking vertegenwoordigt.
hasPrecipitation	boolean	Geeft de aanwezigheid of afwezigheid van neerslag aan. True geeft de aanwezigheid van neerslag aan, onwaar geeft de afwezigheid van neerslag aan.
hoursOfIce	number	Uren ijs.
hoursOfPrecipitation	number	Uren neerslag
hoursOfRain	number	Uren regen.
hoursOfSnow	number	Uren sneeuw.
ice	WeatherUnit	Ice
iceProbability	integer	Percentage dat de waarschijnlijkheid van ijs vertegenwoordigt. Bijvoorbeeld '30'.
iconCode	IconCode	Een numerieke waarde die een afbeelding weergeeft waarin de `iconPhrase`wordt weergegeven. Raadpleeg Weerservices in Azure Maps voor meer informatie.
iconPhrase	string	Beschrijving van het pictogram. Weergegeven in de opgegeven taal. Bijvoorbeeld 'Zonnig'.
localSource	LocalSource	Informatie over de provider van lokale weergegevens.
longPhrase	string	Beschrijving van de prognose in de opgegeven taal. Azure Maps probeert deze zin minder dan 100 tekens lang te houden, maar sommige talen/weersomstandigheden kunnen leiden tot een langere woordgroepslengte van meer dan 100 tekens.
precipitationIntensity	string	Beschrijving van de intensiteit.
precipitationProbability	integer	Percentage dat de kans op neerslag vertegenwoordigt. Bijvoorbeeld '20'.
precipitationType	PrecipitationType	Hiermee geeft u het type neerslag op ("Regen" "Sneeuw" "Ijs" of "Mix"). Als dbz nul is, is precipitationType niet aanwezig in het antwoord.
rain	WeatherUnit	Regen
rainProbability	integer	Percentage dat de kans op regen vertegenwoordigt. Bijvoorbeeld '40'.
shortPhrase	string	Beschrijving van de prognose in de opgegeven taal. Azure Maps probeert deze woordgroep minder dan 30 tekens lang te houden, maar sommige talen/weersomstandigheden kunnen resulteren in een langere woordgroepslengte van meer dan 30 tekens.
snow	WeatherUnit	Sneeuw
snowProbability	integer	Percentage dat de kans op sneeuw vertegenwoordigt. Bijvoorbeeld '30'.
thunderstormProbability	integer	Percentage dat de kans op een onweer vertegenwoordigt. Bijvoorbeeld '80'.
totalLiquid	WeatherUnit	Totale vloeibare neerslagequivalent tijdens de prognoseperiode.
wind	WindDetails	Winddetails die worden geretourneerd, inclusief snelheid en richting.
windGust	WindDetails	Windvlaag. Windvlaag is een plotselinge, korte toename van de windsnelheid.

DegreeDaySummary

Name	Type	Description
cooling	WeatherUnit	Het aantal graden dat de gemiddelde temperatuur hoger is dan 65 graden F/ 18 graden C.
heating	WeatherUnit	Het aantal graden dat de gemiddelde temperatuur lager is dan 65 graden F/ 18 graden C.

ErrorAdditionalInfo

Aanvullende informatie over de resourcebeheerfout.

Name	Type	Description
info	object	De aanvullende informatie.
type	string	Het type aanvullende informatie.

ErrorDetail

De foutdetails.

Name	Type	Description
additionalInfo	ErrorAdditionalInfo[]	Aanvullende informatie over de fout.
code	string	De foutcode.
details	ErrorDetail[]	De foutdetails.
message	string	Het foutbericht.
target	string	Het foutdoel.

ErrorResponse

Foutreactie

Name	Type	Description
error	ErrorDetail	Het foutobject.

IconCode

Numerieke waarde die een afbeelding vertegenwoordigt waarin de iconPhrasewordt weergegeven. Raadpleeg Weerservices in Azure Maps voor meer informatie.

Name	Type	Description
1	Integer
10	Integer
11	Integer
12	Integer
13	Integer
14	Integer
15	Integer
16	Integer
17	Integer
18	Integer
19	Integer
2	Integer
20	Integer
21	Integer
22	Integer
23	Integer
24	Integer
25	Integer
26	Integer
27	Integer
28	Integer
29	Integer
3	Integer
30	Integer
31	Integer
32	Integer
33	Integer
34	Integer
35	Integer
36	Integer
37	Integer
38	Integer
39	Integer
4	Integer
40	Integer
41	Integer
42	Integer
43	Integer
44	Integer
5	Integer
6	Integer
7	Integer
8	Integer
9	Integer

JsonFormat

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

Name	Type	Description
json	string	De JavaScript Object Notation Data Interchange-indeling

LocalSource

Informatie van de provider van lokale weergegevens.

Name	Type	Description
id	integer	Numerieke id, uniek voor de lokale gegevensprovider.
name	string	Naam van de lokale gegevensprovider. Naam wordt weergegeven in de taal die is opgegeven door taalcode in URL, indien beschikbaar. Anders wordt Naam weergegeven in het Engels of de taal waarin de naam is opgegeven.
weatherCode	string	De weergegevenscode die is opgegeven door de lokale gegevensprovider. Met deze weercode kan de prognose worden vergeleken met pictogrammen van de lokale gegevensprovider in plaats van Azure Maps pictogrammen.

PrecipitationType

Hiermee geeft u het type neerslag op ("Regen" "Sneeuw" "Ijs" of "Mix"). Als dbz nul is, is precipitationType niet aanwezig in het antwoord.

Name	Type	Description
Ice	string	Ice
Mix	string	Mix
Rain	string	Regen
Snow	string	Sneeuw

UnitType

Numerieke id-waarde die is gekoppeld aan het type eenheid dat wordt weergegeven. Kan worden gebruikt voor eenheidsvertaling. Raadpleeg Weerservices in Azure Maps voor meer informatie.

Name	Type	Description
0	Integer
1	Integer
10	Integer
11	Integer
12	Integer
13	Integer
14	Integer
15	Integer
16	Integer
17	Integer
18	Integer
19	Integer
2	Integer
20	Integer
21	Integer
22	Integer
3	Integer
31	Integer
4	Integer
5	Integer
6	Integer
7	Integer
8	Integer
9	Integer

WeatherDataUnit

Hiermee geeft u op om de gegevens in metrische eenheden of imperiale eenheden te retourneren. De standaardwaarde is metrische waarde.

Name	Type	Description
imperial	string	Gegevens retourneren in imperiale eenheden. Enkele voorbeelden van imperiale systeem zijn Fahrenheit en mijl.
metric	string	Gegevens retourneren in metrische eenheden. Enkele voorbeeldeenheden van een metriek systeem zijn Celsius en kilometer.

WeatherUnit

Specifieke waarde van een bepaalde eenheid met betrekking tot het weer.

Name	Type	Description
unit	string	Type eenheid voor de geretourneerde waarde.
unitType	UnitType	Numerieke id-waarde die is gekoppeld aan het type eenheid dat wordt weergegeven. Kan worden gebruikt voor eenheidsvertaling. Raadpleeg Weerservices in Azure Maps voor meer informatie.
value	number	Afgeronde waarde.

WeatherUnitRange

Geretourneerde temperatuurwaarden.

Name	Type	Description
maximum	WeatherUnit	Maximumtemperatuur voor de periode
minimum	WeatherUnit	Minimumtemperatuur voor de periode.

WindDetails

Winddetails die worden geretourneerd, inclusief snelheid en richting.

Name	Type	Description
direction	WindDirection	Windrichting
speed	WeatherUnit	Snelheid van de wind in opgegeven eenheid.

WindDirection

Windrichting

Name	Type	Description
degrees	integer	Windrichting in Azimuth graden, beginnend bij het ware noorden en doorgaand in rechtsom. Noord is 0 graden, oost is 90 graden, zuid 180 graden, west 270 graden. Mogelijke waarden 0-359.
localizedDescription	string	Richting afkorting in de opgegeven taal.