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

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

Bereiken

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 minute-by-minute forecasts for a given location

GET https://atlas.microsoft.com/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

Een RGB-kleur, teruggegeven in zowel component- (red, green, ) blueals hexadecimale (hex) vorm. Gebruikt door de minuut-voor-minuut voorspelling om elk interval op een radar-achtige weergave te renderen - zie ForecastInterval.color voor de full-spectrum kleur die is afgebeeld op dbz, en ForecastInterval.simplifiedColor voor de grovere kleur afgeleid van precipitationType en threshold. Voor de onderliggende kleurmappings, zie Weerservices in Azure Maps.

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

Stelt een enkele tijdssnede voor binnen een minuut-voor-minuut voorspelling, die de verwachte weersomstandigheden tijdens dat interval beschrijft. Elk interval beslaat 1, 5 of 15 minuten - afhankelijk van de gevraagde resolutie - en bevat de starttijd, neerslagintensiteit (dbz), neerslagtype en drempel, een korte beschrijvende zin, een icooncode, bewolking en de full-spectrum en vereenvoudigde kleuren die worden gebruikt om de omstandigheden visueel weer te geven op een radar-achtige display.

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.

IntervalSummary

Beschrijft het weersvooruitzicht voor een aaneengesloten venster binnen de minuut-tot-minuut voorspelling - meestal een periode met vergelijkbare omstandigheden, zoals regen die eindigt na 25 minuten of lichte sneeuw die begint na 10 minuten. Elke samenvatting specificeert het venster in minuten vanaf de start van de voorspelling (startMinute, endMinute, totalMinutes), geeft frasebeschrijvingen in drie lengtes (kort, kort en lang) zodat het juiste detailniveau kan worden weergegeven voor de beschikbare UI-ruimte, en bevat een iconCode voor het representatieve weerpictogram. A MinuteForecastResult geeft één of meer IntervalSummary vermeldingen terug die samen de prognoseperiode bestrijken.

JsonFormat

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

MinuteForecastResult

De respons werd teruggegeven door de Get Minute Forecast-operatie, die een minuut-voor-minuut neerslagprognose gaf voor een gespecificeerde locatie over de volgende 120 minuten bij de gevraagde resolutie (1, 5 of 15 minuten). De respons is georganiseerd in drie lagen: een overall summary met frasebeschrijvingen en een representatief icoon voor de hele periode; een intervalSummaries array die opeenvolgende minuten groepeert in langere periodes van vergelijkbare omstandigheden (zoals Regen die over 25 minuten eindigt); en een intervals array met de gedetailleerde per-minuut voorspellingspunten, waaronder neerslagintensiteit (dbz), neerslagtype, bewolking en de kleuren die worden gebruikt om radarvisualisaties te maken.

MinuteForecastSummary

Biedt zinsoverzichten die de neerslagprognose voor de komende minuut-tot-minuut voorspellingsperiode beschrijven. Er zijn meerdere zinslengtes inbegrepen - kort (~25 tekens), kort (~60 tekens) en lang (60+ tekens) - zodat applicaties het detailniveau kunnen weergeven dat het beste past bij de beschikbare UI-ruimte. An iconCode geeft het representatieve weerpictogram voor die periode aan.

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.