Weather - Get Minute Forecast

Usługa:: Maps

Wersja interfejsu API:: 1.1

Umożliwia ustawienie ikony , aby uzyskać prognozę minuta po minucie na następne 120 minut w odstępach 1, 5 i 15 minut.
Interfejs Get Minute Forecast API to żądanie HTTP GET , które zwraca prognozy minuta po minucie dla danej lokalizacji na następne 120 minut. Użytkownicy mogą żądać prognozy pogody w odstępach 1, 5 i 15 minut. Odpowiedź będzie zawierać szczegóły, takie jak rodzaj opadów (w tym deszcz, śnieg lub mieszanina obu), czas rozpoczęcia i wartość intensywności opadów (dBZ). Aby uzyskać więcej informacji, zobacz Żądanie danych prognozy pogody minuta po minucie.

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

Z parametrami opcjonalnymi:

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

Parametry identyfikatora URI

Nazwa	W	Wymagane	Typ	Opis
endpoint	path	True	string (uri)	Nazwa hosta usługi Azure Maps. Użyj `https://atlas.microsoft.com` do Azure chmury publicznej. Aby skupić się na konkretnej Azure Maps geografii lub chmurze suwerennej, zobacz Azure Maps zakres geograficzny.
format	path	True	JsonFormat	Żądany format odpowiedzi. Obsługiwany jest tylko format `json`.
api-version	query	True	string minLength: 1	Wersja interfejsu API do użycia dla tej operacji.
query	query	True	number[]	Odpowiednie zapytanie określone jako ciąg rozdzielony przecinkami składające się z szerokości geograficznej, po której następuje długość geograficzna, np. "47.641268,-122.125679". Informacje o pogodzie są ogólnie dostępne dla lokalizacji na lądzie, zbiorników wodnych otoczonych lądem oraz obszarów oceanu, które znajdują się w odległości około 50 mil morskich od linii brzegowej.
interval	query		integer (int32)	Określa przedział czasu w minutach dla zwróconej prognozy pogody. Obsługiwane wartości to `1` - Pobieranie prognozy dla interwałów 1-minutowych. Zwracane domyślnie. `5` - Pobieranie prognoz dla interwałów 5-minutowych. `15` - Pobieranie prognoz dla interwałów 15-minutowych.
language	query		string	Język, w którym powinny być zwracane wyniki wyszukiwania. Powinien być jednym z obsługiwanych tagów języka IETF, bez uwzględniania wielkości liter. Jeśli dane w określonym języku nie są dostępne dla określonego pola, używany jest język domyślny. Aby uzyskać szczegółowe informacje, zobacz Obsługiwane języki.

Nagłówek żądania

Nazwa	Wymagane	Typ	Opis
x-ms-client-id		string	Wskazuje konto przeznaczone do użycia z modelem bezpieczeństwa Microsoft Entra ID. Ten unikalny identyfikator konta Azure Maps można uzyskać z API Azure Maps Account API na płaszczyźnie zarządzania. Więcej informacji na temat korzystania z Microsoft Entra ID zabezpieczeń w Azure Maps można znaleźć w Manage authentication in Azure Maps.

Odpowiedzi

Nazwa	Typ	Opis
200 OK	MinuteForecastResult	Żądanie zakończyło się pomyślnie.
Other Status Codes	ErrorResponse	Nieoczekiwana odpowiedź na błąd.

Zabezpieczenia

AadToken

Są to przepływy Microsoft Entra OAuth 2.0. W połączeniu z Azure zarządzaniem dostępem opartym na rolach może być używany do kontroli dostępu do Azure Maps API REST. Kontrola dostępu oparta na rolach Azure służy do wyznaczania dostępu do jednego lub więcej kont zasobów lub podzasobów Azure Maps. Każdy użytkownik, grupa lub jednostka usługi mogą mieć dostęp za pośrednictwem wbudowanej roli lub roli niestandardowej składającej się z co najmniej jednego uprawnienia do interfejsów API REST usługi Azure Maps.

Aby zaimplementować scenariusze, zalecamy wyświetlenie koncepcji uwierzytelniania . Podsumowując, ta definicja zabezpieczeń zawiera rozwiązanie do modelowania aplikacji za pośrednictwem obiektów, które mogą kontrolować dostęp do określonych interfejsów API i zakresów.

Note

Ta definicja zabezpieczeń wymaga użycia nagłówka x-ms-client-id w celu wskazania, do którego zasobu usługi Azure Maps aplikacja żąda dostępu. Można to uzyskać za pomocą interfejsu API zarządzania usługami Maps.
Authorization URL jest specyficzna dla wystąpienia chmury publicznej platformy Azure. Suwerenne chmury mają unikalne adresy URL autoryzacji oraz konfiguracje Microsoft Entra ID.
Kontrola dostępu oparta na rolach platformy Azure jest konfigurowana na podstawie płaszczyzny zarządzania platformy Azure za pośrednictwem witryny Azure Portal, programu PowerShell, interfejsu wiersza polecenia, zestawów AZURE SDK lub interfejsów API REST.
Użycie zestawu Web SDK usługi Azure Maps umożliwia skonfigurowanie aplikacji na podstawie konfiguracji dla wielu przypadków użycia.
Aby uzyskać więcej informacji na temat platformy tożsamości firmy Microsoft, zobacz Platforma tożsamości Microsoft overview.

Typ: oauth2
Flow: implicit
Adres URL autoryzacji: https://login.microsoftonline.com/common/oauth2/authorize

Zakresy

Nazwa	Opis
https://atlas.microsoft.com/.default

subscription-key

Jest to klucz wspólny aprowizowany podczas tworzenie konta usługi Azure Maps w witrynie Azure Portal lub przy użyciu programu PowerShell, interfejsu wiersza polecenia, zestawów SDK platformy Azure lub interfejsu API REST.

Za pomocą tego klucza każda aplikacja może uzyskiwać dostęp do całego interfejsu API REST. Innymi słowy, ten klucz może służyć jako klucz główny na koncie, w którym są wystawiane.

W przypadku publicznie uwidocznionych aplikacji zalecamy użycie poufnych aplikacji klienckich podejście do uzyskiwania dostępu do interfejsów API REST usługi Azure Maps, aby klucz mógł być bezpiecznie przechowywany.

Typ: apiKey
W: header

SAS Token

Jest to token sygnatury dostępu współdzielonego tworzony na podstawie operacji List SAS na zasobie usługi Azure Maps za pośrednictwem płaszczyzny zarządzania platformy Azure za pośrednictwem witryny Azure Portal, programu PowerShell, interfejsu wiersza polecenia, zestawów AZURE SDK lub interfejsów API REST.

Dzięki temu tokenowi każda aplikacja jest autoryzowana do uzyskiwania dostępu za pomocą kontroli dostępu opartej na rolach platformy Azure i szczegółowej kontroli wygaśnięcia, szybkości i regionów użycia dla określonego tokenu. Innymi słowy, token SAS może służyć do umożliwienia aplikacjom kontrolowania dostępu w sposób bardziej zabezpieczony niż klucz wspólny.

W przypadku publicznie uwidocznionych aplikacji zalecamy skonfigurowanie określonej listy dozwolonych źródeł w zasobie Mapowanie konta w celu ograniczenia nadużyć renderowania i regularnego odnawiania tokenu SAS.

Typ: apiKey
W: header

Przykłady

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

Przykładowe żądanie

HTTP

GET https://atlas.microsoft.com/weather/forecast/minute/json?api-version=1.1&query=47.632346,-122.138874&interval=15

Przykładowa odpowiedź

Kod stanu:: 200

{
  "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"
  }
}

Definicje

Nazwa	Opis
ColorValue	Wartość koloru przedstawiona jako RGB i szesnastkowa.
ErrorAdditionalInfo	Dodatkowe informacje o błędzie zarządzania zasobami.
ErrorDetail	Szczegóły błędu.
ErrorResponse	Wspólna odpowiedź na błędy dla wszystkich API Azure Resource Manager zwraca szczegóły błędów dla nieudanych operacji. (Jest to również zgodne z formatem odpowiedzi na błąd OData).
ForecastInterval	Prognozuj dane na określony przedział.
IconCode	Wartość liczbowa reprezentująca obraz, który odpowiada bieżącym warunkom pogodowym opisanym `Phrase` przez właściwość. Więcej informacji można znaleźć w Usługi pogodowe w Azure Maps. Może mieć wartość NULL.
IntervalSummary	Informacje podsumowujące dla przedziału prognozy.
JsonFormat	Żądany format odpowiedzi. Obsługiwany jest tylko format `json`.
MinuteForecastResult	Wyniki prognozy pogody minutę po minucie.
MinuteForecastSummary	Podsumowania fraz dla całego okresu prognozy.
PrecipitationType	Określa rodzaj opadów. Prawidłowe wartości to Deszcz, Śnieg, Lód lub Mieszanie. Ta właściwość jest uwzględniana w odpowiedzi, gdy wartość dBZ jest większa od zera.

ColorValue

Objekt

Wartość koloru przedstawiona jako RGB i szesnastkowa.

Nazwa	Typ	Opis
blue	integer (int32)	Niebieska składowa wartości RGB
green	integer (int32)	Zielona składowa wartości RGB.
hex	string	Szesnastkowa wartość koloru.
red	integer (int32)	Czerwony składnik wartości RGB.

ErrorAdditionalInfo

Objekt

Dodatkowe informacje o błędzie zarządzania zasobami.

Nazwa	Typ	Opis
info		Dodatkowe informacje.
type	string	Dodatkowy typ informacji.

ErrorDetail

Objekt

Szczegóły błędu.

Nazwa	Typ	Opis
additionalInfo	ErrorAdditionalInfo[]	Dodatkowe informacje o błędzie.
code	string	Kod błędu.
details	ErrorDetail[]	Szczegóły błędu.
message	string	Komunikat o błędzie.
target	string	Element docelowy błędu.

ErrorResponse

Objekt

Wspólna odpowiedź na błędy dla wszystkich API Azure Resource Manager zwraca szczegóły błędów dla nieudanych operacji. (Jest to również zgodne z formatem odpowiedzi na błąd OData).

Nazwa	Typ	Opis
error	ErrorDetail	Obiekt błędu.

ForecastInterval

Objekt

Prognozuj dane na określony przedział.

Nazwa	Typ	Opis
cloudCover	integer (int32)	Procent reprezentujący zachmurzenie.
color	ColorValue	Kolor w pełnym spektrum, który jest odwzorowywany na dBZ (decybele w stosunku do Z). Jeśli dBZ wynosi zero, kolor nie jest obecny w odpowiedzi.
dbz	number (double)	Jednostka reprezentująca prognozowaną intensywność opadów.
iconCode	IconCode	Wartość liczbowa reprezentująca obraz, który odpowiada bieżącym warunkom pogodowym opisanym `Phrase` przez właściwość. Więcej informacji można znaleźć w Usługi pogodowe w Azure Maps. Może mieć wartość NULL.
minute	integer (int32)	Pierwsza minuta do przerwy.
precipitationType	PrecipitationType	Określa rodzaj opadów. Prawidłowe wartości to Deszcz, Śnieg, Lód lub Mieszanie. Ta właściwość jest uwzględniana w odpowiedzi, gdy wartość dBZ jest większa od zera.
shortPhrase	string	Krótka fraza opisująca warunki opadów w danym przedziale.
simplifiedColor	ColorValue	Kolor pasma, który jest odwzorowywany na typ i próg opadów. Jeśli dBZ wynosi zero, nie występuje w odpowiedzi.
startTime	string (date-time)	Data i godzina rozpoczęcia interwału w formacie ISO 8601 , na przykład 2019-10-27T19:39:57-08:00.
threshold	string	Klucz określający wartość progową. Wraz z precipitationType można użyć do określenia wartości simplifiedColor. Jeśli dBZ wynosi zero, nie występuje w odpowiedzi.

IconCode

Wyliczenie

Wartość liczbowa reprezentująca obraz, który odpowiada bieżącym warunkom pogodowym opisanym Phrase przez właściwość. Więcej informacji można znaleźć w Usługi pogodowe w Azure Maps. Może mieć wartość NULL.

Wartość	Opis
1	Słoneczny
2	Przeważnie słonecznie
3	Częściowo słonecznie
4	Przerywane chmury
5	Mgliste słońce
6	Przeważnie pochmurno
7	Cloudy
8	Ponury (Pochmurny)
11	Mgła
12	Showers
13	Głównie pochmurne z prysznicami
14	Częściowo słonecznie z prysznicami
15	Thunderstorms
16	Głównie pochmurne z burzemi
17	Częściowo słonecznie z burzami
18	Deszcz
19	Flurries
20	Głównie pochmurne z Flurries
21	Częściowo słonecznie z flurries
22	Snow
23	Głównie pochmurne z śniegiem
24	Lód
25	Sleet
26	Marznący deszcz
29	Deszcz i śnieg
30	Hot
31	Cold
32	Windy
33	Przejrzysty
34	W większości jasne
35	Deszcz
36	Przerywane chmury (noc)
37	Mgliste światło księżyca
38	Przeważnie pochmurno (noc)
39	Częściowo pochmurne z prysznicami
40	Przeważnie pochmurno z przelotnymi opadami deszczu (noc)
41	Częściowo pochmurne z burzemi
42	Przeważnie pochmurno z burzami (noc)
43	Przeważnie pochmurno z burzami (noc)
44	Przeważnie pochmurno ze śniegiem (noc)

IntervalSummary

Objekt

Informacje podsumowujące dla przedziału prognozy.

Nazwa	Typ	Opis
briefPhrase	string	Krótkie zdanie podsumowujące. Długość frazy to około 60 znaków.
endMinute	integer (int32)	Ostatnia minuta, do której odnosi się podsumowanie.
iconCode	IconCode	Wartość liczbowa reprezentująca obraz, który odpowiada bieżącym warunkom pogodowym opisanym `Phrase` przez właściwość. Więcej informacji można znaleźć w Usługi pogodowe w Azure Maps. Może mieć wartość NULL.
longPhrase	string	Długa fraza podsumowująca. Długość frazy to 60+ znaków.
shortPhrase	string	Krótkie zdanie podsumowujące. Długość frazy wynosi około 25 znaków.
startMinute	integer (int32)	Pierwsza minuta, do której odnosi się streszczenie.
totalMinutes	integer (int32)	Liczba minut, do której odnosi się podsumowanie.

JsonFormat

Wyliczenie

Żądany format odpowiedzi. Obsługiwany jest tylko format json.

Wartość	Opis
json	format wymiany danych notacji obiektów JavaScript

MinuteForecastResult

Objekt

Wyniki prognozy pogody minutę po minucie.

Nazwa	Typ	Opis
intervalSummaries	IntervalSummary[]	Podsumowanie informacji dla każdego interwału w prognozie. Podsumowania przedstawiają każdy potencjalny przedział, w którym zaczyna się i kończy opady.
intervals	ForecastInterval[]	Dane prognozy dla każdego interwału w prognozie.
summary	MinuteForecastSummary	Podsumowania fraz dla całego okresu prognozy.

MinuteForecastSummary

Objekt

Podsumowania fraz dla całego okresu prognozy.

Nazwa	Typ	Opis
briefPhrase	string	Fraza podsumowująca na następne 120 minut. Długość frazy to około 60 znaków.
briefPhrase60	string	Fraza podsumowująca na następne 60 minut. Długość frazy to około 60 znaków.
iconCode	IconCode	Wartość liczbowa reprezentująca obraz, który odpowiada bieżącym warunkom pogodowym opisanym `Phrase` przez właściwość. Więcej informacji można znaleźć w Usługi pogodowe w Azure Maps. Może mieć wartość NULL.
longPhrase	string	Długa fraza podsumowująca na następne 120 minut. Długość frazy to 60+ znaków.
shortPhrase	string	Krótka fraza podsumowująca na następne 120 minut. Długość frazy wynosi około 25 znaków.

PrecipitationType

Wyliczenie

Określa rodzaj opadów. Prawidłowe wartości to Deszcz, Śnieg, Lód lub Mieszanie. Ta właściwość jest uwzględniana w odpowiedzi, gdy wartość dBZ jest większa od zera.

Wartość	Opis
Ice	Lód
Mix	Mix
Rain	Deszcz
Snow	Snow