Weather - Get Minute Forecast

Gebruik dit diagram om een voorspelling van minuut tot minuut te krijgen voor de komende 120 minuten met intervallen van 1, 5 en 15 minuten.
De Get Minute Forecast API is een HTTP-verzoek GET dat van minuut tot minuut voorspellingen retourneert voor een bepaalde locatie voor de komende 120 minuten. Gebruikers kunnen weersvoorspellingen opvragen met tussenpozen van 1, 5 en 15 minuten. De respons bevat details zoals het type neerslag (inclusief regen, sneeuw of een combinatie van beide), de starttijd en de neerslagintensiteitswaarde (dBZ). Zie Weersvoorspellingsgegevens van minuut tot minuut opvragen voor meer informatie.

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

GET {endpoint}/weather/forecast/minute/json?api-version=1.1&query={query}&interval={interval}&language={language}

URI-parameters

Aanvraagkoptekst

Antwoorden

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 servicehoofd kan toegang krijgen via een ingebouwde rol of een aangepaste rol bestaande uit één of meer permissies om REST-API's te Azure Maps.\n\nOm scenario's te implementeren raden we aan om authenticatieconcepten te bekijken. Samengevat biedt deze beveiligingsdefinitie een oplossing voor het modelleren van applicatie(s) via objecten die toegang hebben tot specifieke API's en scopes.\n\n#### Notities\n* Deze beveiligingsdefinitie ree het gebruik van de x-ms-client-id header om aan te geven tot welke Azure Maps resource de applicatie toegang vraagt. Dit kan worden verkregen via de Maps management API.\n* \nDe Authorization URL is specifiek voor de Azure publieke cloud-instantie. Sovereign clouds hebben unieke autorisatie-URL's en Microsoft Entra ID-configuraties. \n* \nDe Azure rolgebaseerde toegangscontrole wordt geconfigureerd vanaf het Azure beheerplane via Azure portaal, PowerShell, CLI, Azure-SDK's of REST API's.\n* \nGebruik van de Azure Maps Web SDK maakt configuratie-gebaseerde opstelling van een applicatie voor meerdere gebruikssituaties mogelijk.\n* Voor meer informatie over Microsoft identity platform, zie Microsoft identity platform overzicht.

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

Bereiken

subscription-key

Dit is een gedeelde sleutel die wordt ingesteld wanneer je > aanmaakt in het Azure portaal of met PowerShell, CLI, Azure-SDK's of REST API.\n\n Met deze sleutel kan elke applicatie toegang krijgen tot alle REST API's. Met andere woorden, deze sleutel kan worden gebruikt als een hoofdsleutel in de rekening waarin ze worden uitgegeven.\n\n Voor publiek blootgestelde applicaties is onze aanbeveling om de confidential client applications benadering te gebruiken om toegang te krijgen tot Azure Maps REST-API's, zodat je sleutel veilig kan worden opgeslagen.

Type: apiKey
In: header

SAS Token

Dit is een shared access signature token dat wordt aangemaakt vanuit de List SAS-operatie op de Azure Maps resource via het Azure beheervlak via Azure portaal, PowerShell, CLI, Azure-SDK's of REST API's.\n\n Met dit token is elke applicatie gemachtigd om toegang te krijgen met Azure rolgebaseerde toegangscontroles en fijnmazige controle over de vervaldatum, snelheid en regio(s) van gebruik voor de betreffende token. Met andere woorden, de SAS Token kan worden gebruikt om applicaties toegang op een veiligere manier te laten beheren dan de gedeelde sleutel.\n\n Voor publiek blootgestelde applicaties is onze aanbeveling om een specifieke lijst van toegestane oorsprongen in de Map-accountresource te configureren om rendermisbruik te beperken en de SAS-token regelmatig te vernieuwen.

Type: apiKey
In: header

Voorbeelden

Successfully retrieve minute-by-minute forecasts for a given location

GET {endpoint}/weather/forecast/minute/json?api-version=1.1&query=47.632346,-122.138874&interval=15

{
  "intervalSummaries": [
    {
      "briefPhrase": "Rain ending in %minute_value min",
      "endMinute": 24,
      "iconCode": 12,
      "longPhrase": "Rain ending in %minute_value min",
      "shortPhrase": "Rain ending in %minute_value min",
      "startMinute": 0,
      "totalMinutes": 25
    },
    {
      "briefPhrase": "No precipitation for at least %MINUTE_VALUE min",
      "endMinute": 119,
      "iconCode": 7,
      "longPhrase": "No precipitation for at least %MINUTE_VALUE min",
      "shortPhrase": "No precip for %MINUTE_VALUE min",
      "startMinute": 25,
      "totalMinutes": 95
    }
  ],
  "intervals": [
    {
      "cloudCover": 100,
      "color": {
        "blue": 2,
        "green": 98,
        "hex": "#086202",
        "red": 8
      },
      "dbz": 23,
      "iconCode": 12,
      "minute": 0,
      "precipitationType": "Rain",
      "shortPhrase": "Light Rain",
      "simplifiedColor": {
        "blue": 39,
        "green": 190,
        "hex": "#23BE27",
        "red": 35
      },
      "startTime": "2019-11-14T15:18:00-08:00",
      "threshold": "LIGHT"
    },
    {
      "cloudCover": 100,
      "color": {
        "blue": 9,
        "green": 133,
        "hex": "#208509",
        "red": 32
      },
      "dbz": 18,
      "iconCode": 12,
      "minute": 15,
      "precipitationType": "Rain",
      "shortPhrase": "Light Rain",
      "simplifiedColor": {
        "blue": 39,
        "green": 190,
        "hex": "#23BE27",
        "red": 35
      },
      "startTime": "2019-11-14T15:33:00-08:00",
      "threshold": "LIGHT"
    },
    {
      "cloudCover": 100,
      "dbz": 0,
      "iconCode": 7,
      "minute": 30,
      "shortPhrase": "No Precipitation",
      "startTime": "2019-11-14T15:48:00-08:00"
    },
    {
      "cloudCover": 100,
      "dbz": 0,
      "iconCode": 7,
      "minute": 45,
      "shortPhrase": "No Precipitation",
      "startTime": "2019-11-14T16:03:00-08:00"
    },
    {
      "cloudCover": 100,
      "dbz": 0,
      "iconCode": 7,
      "minute": 60,
      "shortPhrase": "No Precipitation",
      "startTime": "2019-11-14T16:18:00-08:00"
    },
    {
      "cloudCover": 100,
      "dbz": 0,
      "iconCode": 7,
      "minute": 75,
      "shortPhrase": "No Precipitation",
      "startTime": "2019-11-14T16:33:00-08:00"
    },
    {
      "cloudCover": 100,
      "dbz": 0,
      "iconCode": 7,
      "minute": 90,
      "shortPhrase": "No Precipitation",
      "startTime": "2019-11-14T16:48:00-08:00"
    },
    {
      "cloudCover": 100,
      "dbz": 0,
      "iconCode": 7,
      "minute": 105,
      "shortPhrase": "No Precipitation",
      "startTime": "2019-11-14T17:03:00-08:00"
    }
  ],
  "summary": {
    "briefPhrase": "Rain ending in 25 min",
    "briefPhrase60": "Rain ending in 25 min",
    "iconCode": 12,
    "longPhrase": "Rain ending in 25 min",
    "shortPhrase": "Rain ending in 25 min"
  }
}

Definities

ColorValue

Kleurwaarde weergegeven als RGB en hexadecimaal.

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

ForecastInterval

Voorspel gegevens voor een specifiek interval.

IconCode

Numerieke waarde die een afbeelding weergeeft die overeenkomt met de huidige weersomstandigheden die door de Phrase accommodatie worden beschreven. Voor meer informatie, zie Weerdiensten in Azure Maps. Kan NUL zijn.

IntervalSummary

Samenvattende informatie voor een voorspellingsinterval.

JsonFormat

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

MinuteForecastResult

Weersvoorspelling minuut voor minuut.

MinuteForecastSummary

Samenvattingen voor de gehele prognoseperiode.

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.