Weather - Get Current Conditions
Użyj, aby uzyskać aktualne warunki pogodowe.
Interfejs Get Current Conditions API to żądanie HTTP GET , które zwraca szczegółowe bieżące warunki pogodowe, takie jak opady, temperatura i wiatr dla danej lokalizacji współrzędnych. Można również pobrać obserwacje z ostatnich 6 lub 24 godzin dla określonej lokalizacji. Podstawowe informacje zwracane z odpowiedzią obejmują szczegóły, 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}
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 |
Żądany format odpowiedzi. Obsługiwany jest tylko 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 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. |
|
details
|
query |
string |
Zwróć pełne informacje o bieżących warunkach. Dostępne wartości to
|
|
|
duration
|
query |
integer |
Ramy czasowe zwracanych warunków pogodowych. Domyślnie zostaną zwrócone najbardziej aktualne warunki pogodowe. Wartość domyślna to 0. Obsługiwane wartości to:
|
|
|
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. |
|
|
unit
|
query |
Określa, że dane mają być zwracane w jednostkach metrycznych lub jednostkach imperialnych. Wartość domyślna to metric. |
Nagłówek żądania
| Nazwa | Wymagane | Typ | Opis |
|---|---|---|---|
| x-ms-client-id |
string |
Wskazuje konto przeznaczone do użycia z modelem zabezpieczeń Microsoft Entra ID. Ten unikatowy identyfikator konta Azure Maps można uzyskać z interfejsu API konta płaszczyzny zarządzania Azure Maps. Aby uzyskać więcej informacji na temat korzystania z zabezpieczeń Microsoft Entra ID w Azure Maps, zobacz Zarządzanie uwierzytelnianiem w Azure Maps. |
Odpowiedzi
| Nazwa | Typ | Opis |
|---|---|---|
| 200 OK |
OK |
|
| Other Status Codes |
Wystąpił nieoczekiwany błąd. |
Zabezpieczenia
AADToken
Są to przepływy Microsoft Entra OAuth 2.0. Po połączeniu z dostępem opartym na rolach platformy Azure kontroli może służyć do kontrolowania dostępu do interfejsów API REST usługi Azure Maps. Mechanizmy kontroli dostępu opartej na rolach platformy Azure służą do wyznaczania dostępu do co najmniej jednego konta zasobu usługi Azure Maps lub zasobów podrzędnych. 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.
Notes
- Ta definicja zabezpieczeń wymaga użycia nagłówka
x-ms-client-idw celu wskazania, do którego zasobu usługi Azure Maps aplikacja żąda dostępu. Można to uzyskać za pomocą interfejsu API zarządzania Maps.
Authorization URL jest specyficzna 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 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 konfigurację opartą na konfiguracji aplikacji w wielu przypadkach użycia.
- Aby uzyskać więcej informacji na temat platformy tożsamości firmy Microsoft, zobacz Microsoft identity platform overview.
Typ:
oauth2
Flow:
implicit
Adres URL autoryzacji:
https://login.microsoftonline.com/common/oauth2/authorize
Zakresów
| Nazwa | Opis |
|---|---|
| https://atlas.microsoft.com/.default | 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:
query
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 detailed current weather conditions for a given coordinate location
Przykładowe zapytanie
GET https://atlas.microsoft.com/weather/currentConditions/json?api-version=1.1&query=47.641268,-122.125679
Przykładowa odpowiedź
{
"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
},
"past3Hours": {
"value": 0.8,
"unit": "mm",
"unitType": 3
},
"past6Hours": {
"value": 0.8,
"unit": "mm",
"unitType": 3
},
"past9Hours": {
"value": 0.8,
"unit": "mm",
"unitType": 3
},
"past12Hours": {
"value": 0.8,
"unit": "mm",
"unitType": 3
},
"past18Hours": {
"value": 0.8,
"unit": "mm",
"unitType": 3
},
"past24Hours": {
"value": 0.8,
"unit": "mm",
"unitType": 3
}
},
"temperatureSummary": {
"past6Hours": {
"minimum": {
"value": 8.3,
"unit": "C",
"unitType": 17
},
"maximum": {
"value": 13.7,
"unit": "C",
"unitType": 17
}
},
"past12Hours": {
"minimum": {
"value": 5.9,
"unit": "C",
"unitType": 17
},
"maximum": {
"value": 13.7,
"unit": "C",
"unitType": 17
}
},
"past24Hours": {
"minimum": {
"value": 5.9,
"unit": "C",
"unitType": 17
},
"maximum": {
"value": 13.7,
"unit": "C",
"unitType": 17
}
}
}
}
]
}
Definicje
| Nazwa | Opis |
|---|---|
|
Current |
|
|
Current |
|
|
Error |
Dodatkowe informacje o błędzie zarządzania zasobami. |
|
Error |
Szczegóły błędu. |
|
Error |
Odpowiedź na błąd |
|
Icon |
Wartość liczbowa reprezentująca obraz, który odpowiada bieżącym warunkom pogodowym opisanym |
|
Json |
Żądany format odpowiedzi. Obsługiwany jest tylko format |
|
Past |
Podsumowanie wahań temperatury w ciągu ostatnich godzin. |
|
Precipitation |
|
|
Pressure |
|
|
Temperature |
|
|
Unit |
Liczba całkowita reprezentująca typ jednostki. Na przykład 17 dla stopni Celsjusza, 18 dla stopni Fahrenheita. Może być używany do przeliczania jednostek. Aby uzyskać pełną listę, zobacz Usługi pogodowe w Azure Maps. |
|
Weather |
Określa, że dane mają być zwracane w jednostkach metrycznych lub jednostkach imperialnych. Wartość domyślna to metric. |
|
Weather |
Konkretna wartość danej jednostki związana z pogodą. |
|
Wind |
Zwracane są szczegóły wiatru, w tym prędkość i kierunek. |
|
Wind |
Kierunek wiatru |
CurrentConditions
| Nazwa | Typ | Opis |
|---|---|---|
| apparentTemperature |
Odczuwalna temperatura zewnętrzna spowodowana kombinacją temperatury powietrza, wilgotności względnej i prędkości wiatru w określonej jednostce. |
|
| ceiling |
Pułap chmur w określonej jednostce. Pułap jest miarą wysokości podstawy najniższych chmur. |
|
| cloudCover |
integer (int32) |
Procent reprezentujący zachmurzenie. |
| dateTime |
string (date-time) |
Data i godzina aktualnego obserwacji wyświetlone w formacie ISO 8601 , na przykład 2019-10-27T19:39:57-08:00. |
| dewPoint |
Temperatura punktu rosy w określonej jednostce. Temperatura punktu rosy to temperatura, do której powietrze musi zostać schłodzone, aby osiągnąć nasycenie. |
|
| hasPrecipitation |
boolean |
Wartość boolowa wskazująca, czy w określonym czasie spodziewane są opady (deszcz, śnieg, deszcz ze śniegiem lub grad). Zwraca prawdziwe, jeśli spodziewane są opady, w przeciwnym razie jest fałszywe. |
| iconCode |
Icon |
Wartość liczbowa reprezentująca obraz, który odpowiada bieżącym warunkom pogodowym opisanym |
| isDayTime |
boolean |
Wskazuje porę dnia. Prawda oznacza 'dzień', false oznacza 'noc'. |
| obstructionsToVisibility |
string |
Przyczyna ograniczonej widoczności. Możliwe wartości:
|
| pastTwentyFourHourTemperatureDeparture |
Odchylenie od temperatury obserwowanej 24 godziny temu w określonej jednostce. |
|
| phrase |
string |
Fraza opisująca aktualne warunki pogodowe. Wyświetlane w określonym języku. |
| precipitationSummary |
Podsumowanie wielkości opadów w ciągu ostatnich 24 godzin. |
|
| pressure |
Ciśnienie atmosferyczne w określonej jednostce. |
|
| pressureTendency |
Zmiana ciśnienia atmosferycznego. |
|
| realFeelTemperature |
Przywracana jest temperatura RealFeel™. |
|
| realFeelTemperatureShade |
Przywracana jest temperatura RealFeel™. Opisuje, jaka jest naprawdę temperatura w cieniu. |
|
| relativeHumidity |
integer (int32) |
Wilgotność względna to ilość pary wodnej obecnej w powietrzu wyrażona jako procent ilości potrzebnej do nasycenia w tej samej temperaturze. |
| temperature |
Zwracana temperatura. |
|
| temperatureSummary |
Podsumowanie wahań temperatury w ciągu ostatnich 6, 12 i 24 godzin. |
|
| uvIndex |
integer (int32) |
Miara siły promieniowania ultrafioletowego ze słońca. Obsługiwane wartości to:
|
| uvIndexPhrase |
string |
Fraza skojarzona z . |
| visibility |
Widoczność w określonej jednostce. Miara odległości, z której można wyraźnie dostrzec obiekt lub światło. |
|
| wetBulbTemperature |
Temperatura, do której powietrze może być schładzane przez odparowanie do niego wody pod stałym ciśnieniem, aż do osiągnięcia nasycenia. |
|
| wind |
Zwracane są szczegóły wiatru, w tym prędkość i kierunek. |
|
| windChillTemperature |
Odczuwalna temperatura powietrza na odsłoniętej skórze z powodu wiatru. |
|
| windGust |
Podmuch wiatru. Podmuch wiatru to nagły, krótkotrwały wzrost prędkości wiatru. |
CurrentConditionsResult
| Nazwa | Typ | Opis |
|---|---|---|
| results |
Szczegółowe aktualne warunki pogodowe. |
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 |
Dodatkowe informacje o błędzie. |
|
| code |
string |
Kod błędu. |
| details |
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 |
Obiekt błędu. |
IconCode
Wartość liczbowa reprezentująca obraz, który odpowiada bieżącym warunkom pogodowym opisanym Phrase przez właściwość. Aby uzyskać więcej informacji, zobacz Usługi pogodowe w Azure Maps. Może mieć wartość NULL.
| Wartość | Opis |
|---|---|
| 1 |
Sunny |
| 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) |
| 9 | |
| 10 | |
| 11 |
Fog |
| 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 |
Rain |
| 19 |
Flurries |
| 20 |
Głównie pochmurne z Flurries |
| 21 |
Częściowo słonecznie z flurries |
| 22 |
Snow |
| 23 |
Głównie pochmurne z śniegiem |
| 24 |
Ice |
| 25 |
Sleet |
| 26 |
Marznący deszcz |
| 27 | |
| 28 | |
| 29 |
Deszcz i śnieg |
| 30 |
Hot |
| 31 |
Cold |
| 32 |
Windy |
| 33 |
Clear |
| 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) |
JsonFormat
Żądany format odpowiedzi. Obsługiwany jest tylko format json.
| Wartość | Opis |
|---|---|
| json |
PastHoursTemperature
Podsumowanie wahań temperatury w ciągu ostatnich godzin.
| Nazwa | Typ | Opis |
|---|---|---|
| maximum |
maximum |
|
| minimum |
minimum |
PrecipitationSummary
| Nazwa | Typ | Opis |
|---|---|---|
| past12Hours |
Ilość opadów (ekwiwalent cieczy), które spadły w ciągu ostatnich 12 godzin. |
|
| past18Hours |
Ilość opadów (ekwiwalent cieczy), które spadły w ciągu ostatnich 18 godzin. |
|
| past24Hours |
Ilość opadów (ekwiwalent cieczy), które spadły w ciągu ostatnich 24 godzin. |
|
| past3Hours |
Ilość opadów (ekwiwalent cieczy), która spadła w ciągu ostatnich trzech godzin. |
|
| past6Hours |
Ilość opadów (ekwiwalent cieczy), które spadły w ciągu ostatnich sześciu godzin. Zawiera wartości metryczne i imperialne. |
|
| past9Hours |
Ilość opadów (ekwiwalent cieczy), które spadły w ciągu ostatnich dziewięciu godzin. |
|
| pastHour |
Ilość opadów (ekwiwalent cieczy), które spadły w ciągu ostatniej godziny. |
PressureTendency
| Nazwa | Typ | Opis |
|---|---|---|
| code |
string |
Kod tendencji ciśnienia niezależnie od języka. jeden z F = Spadający, S = Stały, R = Rosnący. |
| localizedDescription |
string |
Opis tendencji ciśnienia w określonym języku |
TemperatureSummary
| Nazwa | Typ | Opis |
|---|---|---|
| past12Hours |
Podsumowanie wahań temperatury w ciągu ostatnich 12 godzin. |
|
| past24Hours |
Podsumowanie wahań temperatury w ciągu ostatnich 24 godzin. |
|
| past6Hours |
Podsumowanie wahań temperatury w ciągu ostatnich 6 godzin. |
UnitType
Liczba całkowita reprezentująca typ jednostki. Na przykład 17 dla stopni Celsjusza, 18 dla stopni Fahrenheita. Może być używany do przeliczania jednostek. Aby uzyskać pełną listę, zobacz Usługi pogodowe w Azure Maps.
| Wartość | Opis |
|---|---|
| 0 |
feet |
| 1 |
inches |
| 2 |
miles |
| 3 |
millimeter |
| 4 |
centimeter |
| 5 |
miernik |
| 6 |
kilometer |
| 7 |
kilometersPerHour |
| 8 |
knots |
| 9 |
milesPerHour |
| 10 |
metersPerSecond |
| 11 |
hectoPascals |
| 12 |
inchesOfMercury |
| 13 |
kiloPascals |
| 14 |
millibars |
| 15 |
millimetersOfMercury |
| 16 |
poundsPerSquareInch |
| 17 |
Celsius |
| 18 |
Fahrenheit |
| 19 |
kelvin |
| 20 |
percent |
| 21 |
float |
| 22 |
liczba całkowita |
| 31 |
MicrogramsPerCubicMeterOfAir |
WeatherDataUnit
Określa, że dane mają być zwracane w jednostkach metrycznych lub jednostkach imperialnych. Wartość domyślna to metric.
| Wartość | Opis |
|---|---|
| imperial |
Zwracaj dane przy użyciu jednostek imperialnych, takich jak stopnie Fahrenheita (F) dla temperatury i mila (mi) dla odległości. |
| metric |
Zwracanie danych przy użyciu jednostek metrycznych, takich jak stopnie Celsjusza (C) dla temperatury i kilometr (km) dla odległości. |
WeatherUnit
Konkretna wartość danej jednostki związana z pogodą.
| Nazwa | Typ | Opis |
|---|---|---|
| unit |
string |
Typ jednostki dla zwracanej wartości. |
| unitType |
Unit |
Liczba całkowita reprezentująca typ jednostki. Na przykład 17 dla stopni Celsjusza, 18 dla stopni Fahrenheita. Może być używany do przeliczania jednostek. Aby uzyskać pełną listę, zobacz Usługi pogodowe w Azure Maps. |
| value |
number (float) |
Wartość zaokrąglona. |
WindDetails
Zwracane są szczegóły wiatru, w tym prędkość i kierunek.
| Nazwa | Typ | Opis |
|---|---|---|
| direction |
Kierunek wiatru |
|
| speed |
Prędkość wiatru w określonej jednostce. |
WindDirection
Kierunek wiatru
| Nazwa | Typ | Opis |
|---|---|---|
| degrees |
integer (int32) |
Kierunek wiatru w stopniach azymutu, rozpoczynający się na prawdziwej północy i kontynuujący w kierunku zgodnym z ruchem 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 od 0 do 359. |
| localizedDescription |
string |
Skrót kierunku w określonym języku. |