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 {endpoint}/weather/currentConditions/json?api-version=1.1&query={query}
GET {endpoint}/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 |
|---|---|---|---|---|
|
endpoint
|
path | True |
string (uri) |
Nazwa hosta usługi Azure Maps. Użyj |
|
format
|
path | True |
Żądany format odpowiedzi. Obsługiwany jest tylko format |
|
|
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. |
|
details
|
query |
string |
Zwróć pełne informacje o bieżących warunkach. Dostępne wartości to
|
|
|
duration
|
query |
integer (int32) |
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 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 |
Żądanie zakończyło się pomyślnie. |
|
| Other Status Codes |
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-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 usługami Maps. -
Authorization URLjest 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 detailed current weather conditions for a given coordinate location
Przykładowe żądanie
GET https://atlas.microsoft.com/weather/currentConditions/json?api-version=1.1&query=47.641268,-122.125679
Przykładowa odpowiedź
{
"results": [
{
"apparentTemperature": {
"unit": "C",
"unitType": 17,
"value": 16.1
},
"ceiling": {
"unit": "m",
"unitType": 5,
"value": 4359
},
"cloudCover": 95,
"dateTime": "2019-11-14T15:08:00-08:00",
"dewPoint": {
"unit": "C",
"unitType": 17,
"value": 9.2
},
"hasPrecipitation": false,
"iconCode": 7,
"isDayTime": true,
"obstructionsToVisibility": "",
"pastTwentyFourHourTemperatureDeparture": {
"unit": "C",
"unitType": 17,
"value": 1.8
},
"phrase": "Cloudy",
"precipitationSummary": {
"past12Hours": {
"unit": "mm",
"unitType": 3,
"value": 0.8
},
"past18Hours": {
"unit": "mm",
"unitType": 3,
"value": 0.8
},
"past24Hours": {
"unit": "mm",
"unitType": 3,
"value": 0.8
},
"past3Hours": {
"unit": "mm",
"unitType": 3,
"value": 0.8
},
"past6Hours": {
"unit": "mm",
"unitType": 3,
"value": 0.8
},
"past9Hours": {
"unit": "mm",
"unitType": 3,
"value": 0.8
},
"pastHour": {
"unit": "mm",
"unitType": 3,
"value": 0.5
}
},
"pressure": {
"unit": "mb",
"unitType": 14,
"value": 1014.9
},
"pressureTendency": {
"code": "S",
"localizedDescription": "Steady"
},
"realFeelTemperature": {
"unit": "C",
"unitType": 17,
"value": 13.6
},
"realFeelTemperatureShade": {
"unit": "C",
"unitType": 17,
"value": 13.6
},
"relativeHumidity": 75,
"temperature": {
"unit": "C",
"unitType": 17,
"value": 13.7
},
"temperatureSummary": {
"past12Hours": {
"maximum": {
"unit": "C",
"unitType": 17,
"value": 13.7
},
"minimum": {
"unit": "C",
"unitType": 17,
"value": 5.9
}
},
"past24Hours": {
"maximum": {
"unit": "C",
"unitType": 17,
"value": 13.7
},
"minimum": {
"unit": "C",
"unitType": 17,
"value": 5.9
}
},
"past6Hours": {
"maximum": {
"unit": "C",
"unitType": 17,
"value": 13.7
},
"minimum": {
"unit": "C",
"unitType": 17,
"value": 8.3
}
}
},
"uvIndex": 0,
"uvIndexPhrase": "Low",
"visibility": {
"unit": "km",
"unitType": 6,
"value": 8
},
"wetBulbTemperature": {
"unit": "C",
"unitType": 17,
"value": 11.4
},
"wind": {
"direction": {
"degrees": 315,
"localizedDescription": "NW"
},
"speed": {
"unit": "km/h",
"unitType": 7,
"value": 3.6
}
},
"windChillTemperature": {
"unit": "C",
"unitType": 17,
"value": 13.9
},
"windGust": {
"speed": {
"unit": "km/h",
"unitType": 7,
"value": 4.9
}
}
}
]
}
Definicje
| Nazwa | Opis |
|---|---|
|
Current |
Aktualne dane o pogodzie. |
|
Current |
Obecne warunki pogodowe są skutkiem. |
|
Error |
Dodatkowe informacje o błędzie zarządzania zasobami. |
|
Error |
Szczegóły błędu. |
|
Error |
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). |
|
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 |
Podsumowanie ilości opadów. |
|
Pressure |
Tendencja ciśnienia atmosferycznego. |
|
Temperature |
Podsumowanie wahań temperatury. |
|
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. Pełną listę można znaleźć w Usługi pogodowe w Azure Maps. |
|
Weather |
Jednostka miary danych pogodowych. |
|
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
Aktualne dane o pogodzie.
| 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 |
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 miary. 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
Obecne warunki pogodowe są skutkiem.
| Nazwa | Typ | Opis |
|---|---|---|
| results |
Szczegółowe aktualne warunki pogodowe. |
ErrorAdditionalInfo
Dodatkowe informacje o błędzie zarządzania zasobami.
| Nazwa | Typ | Opis |
|---|---|---|
| info |
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
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 |
Obiekt błędu. |
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.
| 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) |
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 |
maksimum |
|
| minimum |
minimum |
PrecipitationSummary
Podsumowanie ilości opadów.
| 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
Tendencja ciśnienia atmosferycznego.
| 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
Podsumowanie wahań temperatury.
| 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. Pełną listę można znaleźć w 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 |
Stopnie Celsjusza |
| 18 |
Fahrenheit |
| 19 |
kelvin |
| 20 |
percent |
| 21 |
float |
| 22 |
liczba całkowita |
| 31 |
MicrogramsPerCubicMeterOfAir |
WeatherDataUnit
Jednostka miary danych pogodowych.
| 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. |
WeatherValue
Konkretna wartość danej jednostki związana z pogodą.
| Nazwa | Typ | Opis |
|---|---|---|
| unit |
string |
Typ jednostki dla zwracanej wartości. |
| 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. Pełną listę można znaleźć w 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. |