Udostępnij przez


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

JsonFormat

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

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

  • true - Zwraca pełne szczegóły. Domyślnie zwracane są wszystkie szczegóły.
  • false - Zwraca skróconą wersję bieżących danych o stanie, która obejmuje datę obserwacji, godzinę i frazę pogody, kod ikony, flagę wskaźnika opadów i temperaturę.
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:

  • 0 - Zwróć najbardziej aktualne warunki pogodowe.
  • 6 - Wróć warunki pogodowe z ostatnich 6 godzin.
  • 24 - Wróć warunki pogodowe 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. 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

WeatherDataUnit

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

CurrentConditionsResult

OK

Other Status Codes

ErrorResponse

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

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

JsonFormat

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

PastHoursTemperature

Podsumowanie wahań temperatury w ciągu ostatnich godzin.

PrecipitationSummary
PressureTendency
TemperatureSummary
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.

WeatherDataUnit

Określa, że dane mają być zwracane w jednostkach metrycznych lub jednostkach imperialnych. Wartość domyślna to metric.

WeatherUnit

Konkretna wartość danej jednostki związana z pogodą.

WindDetails

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

WindDirection

Kierunek wiatru

CurrentConditions

Nazwa Typ Opis
apparentTemperature

WeatherUnit

Odczuwalna temperatura zewnętrzna spowodowana kombinacją temperatury powietrza, wilgotności względnej i prędkości wiatru w określonej jednostce.

ceiling

WeatherUnit

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

WeatherUnit

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

IconCode (int32)

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.

isDayTime

boolean

Wskazuje porę dnia. Prawda oznacza 'dzień', false oznacza 'noc'.

obstructionsToVisibility

string

Przyczyna ograniczonej widoczności.

Możliwe wartości:

  • A = silna burza/grad
  • BD = wydmuchiwanie pyłu
  • BN = nawiewany piasek
  • BS = nawiewany śnieg
  • D = pył
  • F = mgła
  • GF = mgła przyziemna
  • HZ = zamglenie
  • I = lód
  • IC = kryształki lodu
  • IF = lodowa mgła
  • IP = granulki lodu
  • IPW = prysznic z granulkami lodu
  • K = dym
  • L = mżawka
  • R = deszcz
  • RS = deszcz/śnieg
  • RW = deszczownica
  • S = śnieg
  • SG = granulki śniegu
  • SP = granulki śniegu
  • SW = opady śniegu
  • T = burza z piorunami
  • UP = niezdefiniowane opady
  • ZL = marznąca mżawka
  • ZR = marznący deszcz
  • + = ciężki
  • - = światło
pastTwentyFourHourTemperatureDeparture

WeatherUnit

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

PrecipitationSummary

Podsumowanie wielkości opadów w ciągu ostatnich 24 godzin.

pressure

WeatherUnit

Ciśnienie atmosferyczne w określonej jednostce.

pressureTendency

PressureTendency

Zmiana ciśnienia atmosferycznego.

realFeelTemperature

WeatherUnit

Przywracana jest temperatura RealFeel™.

realFeelTemperatureShade

WeatherUnit

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

WeatherUnit

Zwracana temperatura.

temperatureSummary

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:

  • 0-2 - Niskie zagrożenie ze strony promieni słonecznych UV lub przeciętnego człowieka.
  • 3-5 - Umiarkowane ryzyko szkód spowodowanych ekspozycją na słońce bez zabezpieczenia.
  • 6-7 - Wysokie ryzyko szkód spowodowanych niezabezpieczoną ekspozycją na słońce.
  • 8-10 - Bardzo wysokie ryzyko szkód spowodowanych niezabezpieczoną ekspozycją na słońce.
  • 11+ - Ekstremalne ryzyko szkód spowodowanych niezabezpieczoną ekspozycją na słońce.
uvIndexPhrase

string

Fraza skojarzona z .uvIndex

visibility

WeatherUnit

Widoczność w określonej jednostce. Miara odległości, z której można wyraźnie dostrzec obiekt lub światło.

wetBulbTemperature

WeatherUnit

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

WindDetails

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

windChillTemperature

WeatherUnit

Odczuwalna temperatura powietrza na odsłoniętej skórze z powodu wiatru.

windGust

WindDetails

Podmuch wiatru. Podmuch wiatru to nagły, krótkotrwały wzrost prędkości wiatru.

CurrentConditionsResult

Nazwa Typ Opis
results

CurrentConditions[]

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

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

format wymiany danych notacji obiektów JavaScript

PastHoursTemperature

Podsumowanie wahań temperatury w ciągu ostatnich godzin.

Nazwa Typ Opis
maximum

WeatherUnit

maximum

minimum

WeatherUnit

minimum

PrecipitationSummary

Nazwa Typ Opis
past12Hours

WeatherUnit

Ilość opadów (ekwiwalent cieczy), które spadły w ciągu ostatnich 12 godzin.

past18Hours

WeatherUnit

Ilość opadów (ekwiwalent cieczy), które spadły w ciągu ostatnich 18 godzin.

past24Hours

WeatherUnit

Ilość opadów (ekwiwalent cieczy), które spadły w ciągu ostatnich 24 godzin.

past3Hours

WeatherUnit

Ilość opadów (ekwiwalent cieczy), która spadła w ciągu ostatnich trzech godzin.

past6Hours

WeatherUnit

Ilość opadów (ekwiwalent cieczy), które spadły w ciągu ostatnich sześciu godzin. Zawiera wartości metryczne i imperialne.

past9Hours

WeatherUnit

Ilość opadów (ekwiwalent cieczy), które spadły w ciągu ostatnich dziewięciu godzin.

pastHour

WeatherUnit

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

PastHoursTemperature

Podsumowanie wahań temperatury w ciągu ostatnich 12 godzin.

past24Hours

PastHoursTemperature

Podsumowanie wahań temperatury w ciągu ostatnich 24 godzin.

past6Hours

PastHoursTemperature

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

UnitType (int32)

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

WindDirection

Kierunek wiatru

speed

WeatherUnit

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.