Weather - Get Current Conditions

Odwołanie

Usługa:: Maps

Wersja interfejsu API:: 1.1

Użyj polecenia , aby uzyskać bieżące warunki pogodowe.

Interfejs Get Current Conditions API to żądanie HTTP GET zwracające szczegółowe bieżące warunki pogodowe, takie jak opady, temperatura i wiatr dla danej lokalizacji współrzędnych. Ponadto można pobrać obserwacje z ostatnich 6 lub 24 godzin dla określonej lokalizacji. Podstawowe informacje zwrócone za pomocą odpowiedzi zawierają szczegółowe informacje, takie jak data i godzina obserwacji, krótki opis warunków pogodowych, ikona pogody, flagi wskaźnika opadów i temperatura. Zwracane są również dodatkowe szczegóły, takie jak Temperatura RealFeel™ i indeks UV. Aby uzyskać więcej informacji, zobacz Żądanie danych pogodowych w czasie rzeczywistym

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

Z parametrami opcjonalnymi:

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

Parametry identyfikatora URI

Nazwa	W	Wymagane	Typ	Opis
format	path	True	JsonFormat	Żądany format odpowiedzi. Obsługiwany jest tylko `json` format.
api-version	query	True	string	Numer wersji interfejsu API usługi Azure Maps.
query	query	True	number[]	Odpowiednie zapytanie określone jako ciąg rozdzielany przecinkami składa się z szerokości geograficznej, po której następuje długość geograficzna, np. "47.641268,-122.125679".
details	query		string	Zwróć pełne szczegóły dotyczące bieżących warunków. Dostępne wartości to `true` — Zwraca pełne szczegóły. Domyślnie wszystkie szczegóły są zwracane. `false` — Zwraca obciętą wersję bieżących danych warunku, która obejmuje datę obserwacji, frazę pogodową, kod ikony, flagę wskaźnika opadów i temperaturę.
duration	query		integer	Przedział czasu zwróconych warunków pogodowych. Domyślnie zostaną zwrócone najbardziej aktualne warunki pogodowe. Wartość domyślna to 0. Obsługiwane wartości to: `0` - Zwróć najbardziej aktualne warunki pogodowe. `6` - Warunki pogodowe powrotu z ostatnich 6 godzin. `24` - Warunki pogodowe powrotu z ostatnich 24 godzin.
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. Gdy 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 .
unit	query		WeatherDataUnit	Określa, aby zwracać dane w jednostkach metryk lub jednostkach imperialnych. Wartość domyślna to metryka.

Nagłówek żądania

Nazwa	Wymagane	Typ	Opis
x-ms-client-id		string	Określa, które konto jest przeznaczone do użycia w połączeniu z modelem zabezpieczeń Microsoft Entra ID. Reprezentuje unikatowy identyfikator konta usługi Azure Maps i można go pobrać z interfejsu API konta płaszczyzny zarządzania usługi Azure Maps. Aby użyć zabezpieczeń microsoft Entra ID w usłudze Azure Maps, zobacz następujące artykuły , aby uzyskać wskazówki.

Odpowiedzi

Nazwa	Typ	Opis
200 OK	CurrentConditionsResult	OK
Other Status Codes	ErrorResponse	Wystąpił nieoczekiwany błąd.

Zabezpieczenia

AADToken

Są to przepływy protokołu Microsoft Entra OAuth 2.0 . W połączeniu z kontrolą dostępu opartą na rolach platformy Azure może służyć do kontrolowania dostępu do interfejsów API REST usługi Azure Maps. Mechanizmy kontroli dostępu oparte na rolach platformy Azure służą do wyznaczania dostępu do co najmniej jednego konta zasobów usługi Azure Maps lub zasobów podrzędnych. Każdy użytkownik, grupa lub jednostka usługi może 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 pojęć dotyczących uwierzytelniania. Podsumowując, ta definicja zabezpieczeń udostępnia 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.

Uwagi

Ta definicja zabezpieczeń wymaga użycia nagłówka x-ms-client-id , aby wskazać, do którego zasobu usługi Azure Maps aplikacja żąda dostępu. Można to uzyskać za pomocą interfejsu API zarządzania mapami .

Element Authorization URL jest specyficzny dla wystąpienia chmury publicznej platformy Azure. Suwerenne chmury mają unikatowe adresy URL autoryzacji i konfiguracje identyfikatorów entra firmy Microsoft. * Kontrola dostępu oparta na rolach platformy Azure jest konfigurowana z 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 Sdk sieci Web usługi Azure Maps umożliwia konfigurację opartą na konfiguracji aplikacji w wielu przypadkach użycia.

Aby uzyskać więcej informacji na temat platformy tożsamości firmy Microsoft, zobacz Omówienie platformy tożsamości firmy Microsoft.

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

Zakresy

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

subscription-key

Jest to klucz wspólny aprowizowany podczas tworzenia 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.

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

W przypadku publicznie uwidocznionych aplikacji zalecamy użycie podejścia do poufnych aplikacji klienckich w celu uzyskania dostępu do interfejsów API REST usługi Azure Maps, aby można było bezpiecznie przechowywać klucz.

Typ: apiKey
W: query

SAS Token

Jest to token sygnatury dostępu współdzielonego tworzony na podstawie operacji listy sygnatur dostępu współdzielonego w 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 SDK platformy Azure lub interfejsów API REST.

Przy użyciu tego tokenu 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 sygnatury dostępu współdzielonego może służyć do umożliwienia aplikacjom kontrolowania dostępu w bardziej bezpieczny sposób niż klucz wspólny.

W przypadku publicznie uwidocznionych aplikacji zalecamy skonfigurowanie określonej listy dozwolonych źródeł w zasobie konta mapy w celu ograniczenia nadużyć renderowania i regularnego odnawiania tokenu SYGNATURy dostępu współdzielonego.

Typ: apiKey
W: header

Przykłady

Successfully retrieve detailed current weather conditions for a given coordinate location

Przykładowe żądanie

HTTP

GET https://atlas.microsoft.com/weather/currentConditions/json?api-version=1.1&query=47.641268,-122.125679

Przykładowa odpowiedź

Kod stanu:: 200

{
  "results": [
    {
      "dateTime": "2019-11-14T15:08:00-08:00",
      "phrase": "Cloudy",
      "iconCode": 7,
      "hasPrecipitation": false,
      "isDayTime": true,
      "temperature": {
        "value": 13.7,
        "unit": "C",
        "unitType": 17
      },
      "realFeelTemperature": {
        "value": 13.6,
        "unit": "C",
        "unitType": 17
      },
      "realFeelTemperatureShade": {
        "value": 13.6,
        "unit": "C",
        "unitType": 17
      },
      "relativeHumidity": 75,
      "dewPoint": {
        "value": 9.2,
        "unit": "C",
        "unitType": 17
      },
      "wind": {
        "direction": {
          "degrees": 315,
          "localizedDescription": "NW"
        },
        "speed": {
          "value": 3.6,
          "unit": "km/h",
          "unitType": 7
        }
      },
      "windGust": {
        "speed": {
          "value": 4.9,
          "unit": "km/h",
          "unitType": 7
        }
      },
      "uvIndex": 0,
      "uvIndexPhrase": "Low",
      "visibility": {
        "value": 8,
        "unit": "km",
        "unitType": 6
      },
      "obstructionsToVisibility": "",
      "cloudCover": 95,
      "ceiling": {
        "value": 4359,
        "unit": "m",
        "unitType": 5
      },
      "pressure": {
        "value": 1014.9,
        "unit": "mb",
        "unitType": 14
      },
      "pressureTendency": {
        "localizedDescription": "Steady",
        "code": "S"
      },
      "pastTwentyFourHourTemperatureDeparture": {
        "value": 1.8,
        "unit": "C",
        "unitType": 17
      },
      "apparentTemperature": {
        "value": 16.1,
        "unit": "C",
        "unitType": 17
      },
      "windChillTemperature": {
        "value": 13.9,
        "unit": "C",
        "unitType": 17
      },
      "wetBulbTemperature": {
        "value": 11.4,
        "unit": "C",
        "unitType": 17
      },
      "precipitationSummary": {
        "pastHour": {
          "value": 0.5,
          "unit": "mm",
          "unitType": 3
        },
        "pastThreeHours": {
          "value": 0.8,
          "unit": "mm",
          "unitType": 3
        },
        "pastSixHours": {
          "value": 0.8,
          "unit": "mm",
          "unitType": 3
        },
        "pastNineHours": {
          "value": 0.8,
          "unit": "mm",
          "unitType": 3
        },
        "pastTwelveHours": {
          "value": 0.8,
          "unit": "mm",
          "unitType": 3
        },
        "pastEighteenHours": {
          "value": 0.8,
          "unit": "mm",
          "unitType": 3
        },
        "pastTwentyFourHours": {
          "value": 0.8,
          "unit": "mm",
          "unitType": 3
        }
      },
      "temperatureSummary": {
        "pastSixHours": {
          "minimum": {
            "value": 8.3,
            "unit": "C",
            "unitType": 17
          },
          "maximum": {
            "value": 13.7,
            "unit": "C",
            "unitType": 17
          }
        },
        "pastTwelveHours": {
          "minimum": {
            "value": 5.9,
            "unit": "C",
            "unitType": 17
          },
          "maximum": {
            "value": 13.7,
            "unit": "C",
            "unitType": 17
          }
        },
        "pastTwentyFourHours": {
          "minimum": {
            "value": 5.9,
            "unit": "C",
            "unitType": 17
          },
          "maximum": {
            "value": 13.7,
            "unit": "C",
            "unitType": 17
          }
        }
      }
    }
  ]
}

Definicje

Nazwa	Opis
CurrentConditions
CurrentConditionsResult
ErrorAdditionalInfo	Dodatkowe informacje o błędzie zarządzania zasobami.
ErrorDetail	Szczegóły błędu.
ErrorResponse	Odpowiedź na błąd
IconCode	Wartość liczbowa reprezentująca obraz, który wyświetla element `iconPhrase`. Szczegółowe informacje można znaleźć w artykule Weather services in Azure Maps (Usługi pogodowe w usłudze Azure Maps ).
JsonFormat	Żądany format odpowiedzi. Obsługiwany jest tylko `json` format.
PastHoursTemperature	Podsumowanie wahań temperatury w ciągu ostatnich godzin.
PrecipitationSummary
PressureTendency
TemperatureSummary
UnitType	Wartość identyfikatora liczbowego skojarzona z wyświetlanym typem jednostki. Może być używany do tłumaczenia jednostkowego. Szczegółowe informacje można znaleźć w artykule Weather services in Azure Maps (Usługi pogodowe w usłudze Azure Maps ).
WeatherDataUnit	Określa, aby zwracać dane w jednostkach metryk lub jednostkach imperialnych. Wartość domyślna to metryka.
WeatherUnit	Określona wartość danej jednostki powiązanej z pogodą.
WindDetails	Zwracane są szczegóły wiatru, w tym prędkość i kierunek.
WindDirection	Kierunek wiatru

CurrentConditions

Nazwa	Typ	Opis
apparentTemperature	WeatherUnit	Postrzegana temperatura na zewnątrz spowodowana przez połączenie temperatury powietrza, wilgotności względnej i prędkości wiatru w określonej jednostce.
ceiling	WeatherUnit	Limit chmury w określonej jednostce. Sufit jest pomiarem wysokości podstawy najniższych chmur.
cloudCover	integer	Procent reprezentujący pokrycie chmury.
dateTime	string	Data i godzina bieżącej obserwacji wyświetlanej w formacie ISO 8601, na przykład 2019-10-27T19:39:57-08:00.
dewPoint	WeatherUnit	Temperatura punktu odwu w określonej jednostce. Temperatura punktu odwu to temperatura, do którego powietrze musi być chłodzone, aby osiągnąć nasycenie.
hasPrecipitation	boolean	Wskazuje obecność lub brak opadów. Wartość True wskazuje obecność opadów, wartość false wskazuje na brak opadów.
iconCode	IconCode	Wartość liczbowa reprezentująca obraz, który wyświetla element `iconPhrase`. Szczegółowe informacje można znaleźć w artykule Weather services in Azure Maps (Usługi pogodowe w usłudze Azure Maps ).
isDayTime	boolean	Wskazuje godzinę dnia. Wartość True oznacza "dzień", wartość false oznacza "noc".
obstructionsToVisibility	string	Przyczyna ograniczonej widoczności. Możliwe wartości: A = duża burza/grad BD = pyłu BN = piasku BS = śniegu D = pył F = mgła GF = mgła gruntowa HZ = mgła I = lód IC = kryształy lodu IF = mgła lodu IP = peletki lodowe IPW = peletki lodowe prysznic K = dym L = drizzle R = deszcz RS = deszcz/śnieg RW = prysznic deszczowy S = śnieg SG = granulki śniegu SP = peletki śniegu SW = deszcz śniegu T = burza z piorunami UP = niezdefiniowane opady ZL = mroźna mżawka ZR = mroźny deszcz + = ciężki - = światło
pastTwentyFourHourTemperatureDeparture	WeatherUnit	Odejście od temperatury zaobserwowanej 24 godziny temu w określonej jednostce.
phrase	string	Opis frazy bieżącego warunku pogodowego. Wyświetlane w określonym języku.
precipitationSummary	PrecipitationSummary	Podsumowanie ilości opadów w ciągu ostatnich 24 godzin.
pressure	WeatherUnit	Ciśnienie atmosferyczne w określonej jednostce.
pressureTendency	PressureTendency	Zmiany ciśnienia atmosferycznego.
realFeelTemperature	WeatherUnit	Zwracana temperatura RealFeel™.
realFeelTemperatureShade	WeatherUnit	Zwracana temperatura RealFeel™. Opisuje, jak temperatura naprawdę czuje się w cieniu.
relativeHumidity	integer	Względna wilgotność to ilość pary wodnej obecnej w powietrzu wyrażona jako procent ilości potrzebnej do nasycenia w tej samej temperaturze.
temperature	WeatherUnit	Zwracana temperatura.
temperatureSummary	TemperatureSummary	Podsumowanie wahań temperatury w ciągu ostatnich 6, 12 i 24 godzin.
uvIndex	integer	Miara siły promieniowania ultrafioletowego z słońca. Obsługiwane wartości to: `0-2` - Niskie niebezpieczeństwo przed promieniami UV słońca lub przeciętną osobą. `3-5` - Umiarkowane ryzyko uszkodzenia niechronionej ekspozycji na słońce. `6-7` - Wysokie ryzyko uszkodzenia przed niechronionym słońcem. `8-10` - Bardzo wysokie ryzyko uszkodzenia przed niechronionym słońcem. `11+` - Ekstremalne ryzyko uszkodzenia przed niechronionym słońcem.
uvIndexPhrase	string	Fraza skojarzona z elementem `uvIndex`.
visibility	WeatherUnit	Widoczność w określonej lekcji. Miara odległości, w której można wyraźnie rozpoznać obiekt lub światło.
wetBulbTemperature	WeatherUnit	Temperatura, do której powietrze może być chłodzone przez odparowanie wody do niego przy stałym ciśnieniem, dopóki nie osiągnie nasycenia.
wind	WindDetails	Zwracane są szczegóły wiatru, w tym prędkość i kierunek.
windChillTemperature	WeatherUnit	Postrzegana temperatura powietrza na odsłoniętej skórze z powodu wiatru.
windGust	WindDetails	Podmuch wiatru. Podmuch wiatru jest nagły, krótki wzrost prędkości wiatru.

CurrentConditionsResult

Nazwa	Typ	Opis
results	CurrentConditions[]	Szczegółowe informacje o bieżących warunkach pogodowych.

ErrorAdditionalInfo

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

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

ErrorDetail

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

Odpowiedź na błąd

Nazwa	Typ	Opis
error	ErrorDetail	Obiekt error.

IconCode

Wartość liczbowa reprezentująca obraz, który wyświetla element iconPhrase. Szczegółowe informacje można znaleźć w artykule Weather services in Azure Maps (Usługi pogodowe w usłudze Azure Maps ).

Nazwa	Typ	Opis
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

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

Nazwa	Typ	Opis
json	string	Format wymiany danych notacji obiektów JavaScript

PastHoursTemperature

Podsumowanie wahań temperatury w ciągu ostatnich godzin.

Nazwa	Typ	Opis
maximum	WeatherUnit	maksimum
minimum	WeatherUnit	minimum

PrecipitationSummary

Nazwa	Typ	Opis
pastEighteenHours	WeatherUnit	Ilość opadów (odpowiednik płynu), który spadł w ciągu ostatnich 18 godzin.
pastHour	WeatherUnit	Ilość opadów (odpowiednik cieczy), które spadły w ciągu ostatniej godziny.
pastNineHours	WeatherUnit	Ilość opadów (płynny odpowiednik), które spadły w ciągu ostatnich dziewięciu godzin.
pastSixHours	WeatherUnit	Ilość opadów (odpowiednik cieczy), które spadły w ciągu ostatnich sześciu godzin. Zawiera wartości metryki i imperialne.
pastThreeHours	WeatherUnit	Ilość opadów (odpowiednik płynu), który spadł w ciągu ostatnich trzech godzin.
pastTwelveHours	WeatherUnit	Ilość opadów (odpowiednik cieczy), który spadł w ciągu ostatnich 12 godzin.
pastTwentyFourHours	WeatherUnit	Ilość opadów (odpowiednik płynu), który spadł w ciągu ostatnich 24 godzin.

PressureTendency

Nazwa	Typ	Opis
code	string	Kod tendencji nacisku niezależnie od języka. Jeden z F=Falling, S=Steady, R=Rising.
localizedDescription	string	Opis tendencji ciśnienia w określonym języku

TemperatureSummary

Nazwa	Typ	Opis
pastSixHours	PastHoursTemperature	Podsumowanie wahań temperatury w ciągu ostatnich 6 godzin.
pastTwelveHours	PastHoursTemperature	Podsumowanie wahań temperatury w ciągu ostatnich 12 godzin.
pastTwentyFourHours	PastHoursTemperature	Podsumowanie wahań temperatury w ciągu ostatnich 24 godzin.

UnitType

Wartość identyfikatora liczbowego skojarzona z wyświetlanym typem jednostki. Może być używany do tłumaczenia jednostkowego. Szczegółowe informacje można znaleźć w artykule Weather services in Azure Maps (Usługi pogodowe w usłudze Azure Maps ).

Nazwa	Typ	Opis
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

Określa, aby zwracać dane w jednostkach metryk lub jednostkach imperialnych. Wartość domyślna to metryka.

Nazwa	Typ	Opis
imperial	string	Zwraca dane w jednostkach imperialnych. Przykładowe jednostki systemu cesarskiego to Fahrenheit i mile.
metric	string	Zwracanie danych w jednostkach metryk. Przykładowe jednostki systemu metryki to Stopnie Celsjusza i kilometr.

WeatherUnit

Określona wartość danej jednostki powiązanej z pogodą.

Nazwa	Typ	Opis
unit	string	Typ jednostki dla zwracanej wartości.
unitType	UnitType	Wartość identyfikatora liczbowego skojarzona z wyświetlanym typem jednostki. Można go użyć do tłumaczenia jednostkowego. Szczegółowe informacje można znaleźć w artykule Weather services in Azure Maps (Usługi pogodowe w usłudze Azure Maps ).
value	number	Zaokrąglona wartość.

WindDetails

Zwracane są szczegóły wiatru, w tym prędkość i kierunek.

Nazwa	Typ	Opis
direction	WindDirection	Kierunek wiatru
speed	WeatherUnit	Prędkość wiatru w określonej jednostce.

WindDirection

Kierunek wiatru

Nazwa	Typ	Opis
degrees	integer	Kierunek wiatru w stopniach Azimuth, zaczynając od prawdziwej Północy i kontynuując w kierunku wskazówek zegara. Północ jest 0 stopni, wschód jest 90 stopni, południe jest 180 stopni, zachód jest 270 stopni. Możliwe wartości 0–359.
localizedDescription	string	Skrót kierunku w określonym języku.

Udostępnij za pośrednictwem