Weather - Get Current Conditions

Başvuru

Service:: Maps

API Version:: 1.1

Geçerli hava koşullarını almak için kullanın.

Get Current Conditions API, belirli bir koordinat konumu için yağış, sıcaklık ve rüzgar gibi ayrıntılı geçerli hava koşullarını döndüren bir HTTP GET isteğidir. Ayrıca, belirli bir konum için son 6 veya 24 saat içinde gözlemler alınabilir. Yanıt ile döndürülen temel bilgiler gözlem tarihi ve saati, hava koşullarının kısa açıklaması, hava durumu simgesi, yağış göstergesi bayrakları ve sıcaklık gibi ayrıntıları içerir. RealFeel™ Sıcaklık ve UV dizini gibi ek ayrıntılar da döndürülür. Daha fazla bilgi için bkz. Gerçek zamanlı hava durumu verileri isteme

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

With optional parameters:

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

URI Parametreleri

Name	İçinde	Gerekli	Tür	Description
format	path	True	JsonFormat	Yanıtın istenen biçimi. Yalnızca `json` biçim desteklenir.
api-version	query	True	string	Azure Haritalar API'sinin sürüm numarası.
query	query	True	number[]	Enlem ve ardından boylam tarafından oluşturulan virgülle ayrılmış bir dize olarak belirtilen ilgili sorgu; örneğin, "47.641268,-122.125679".
details	query		string	Geçerli koşullar için tüm ayrıntıları döndür. Kullanılabilir değerler şunlardır: `true` - Tüm ayrıntıları döndürür. Varsayılan olarak tüm ayrıntılar döndürülür. `false` - Geçerli koşul verilerinin, gözlem tarihi saati, hava durumu tümceciği, simge kodu, yağış göstergesi bayrağı ve sıcaklığı içeren kesilmiş bir sürümünü döndürür.
duration	query		integer	Döndürülen hava koşullarının zaman çerçevesi. Varsayılan olarak, en güncel hava koşulları döndürülür. Varsayılan değer 0'dır. Desteklenen değerler şunlardır: `0` - En güncel hava koşullarını iade edin. `6` - Son 6 saat içinde hava koşullarını iade edin. `24` - Son 24 saat içinde hava koşullarını iade edin.
language	query		string	Arama sonuçlarının döndürülmesi gereken dil. Büyük/küçük harfe duyarsız, desteklenen IETF dil etiketlerinden biri olmalıdır. Belirtilen dildeki veriler belirli bir alan için kullanılabilir olmadığında, varsayılan dil kullanılır. Ayrıntılar için lütfen Desteklenen Diller'e bakın.
unit	query		WeatherDataUnit	Verileri ölçüm birimlerinde veya emperyal birimlerde döndürmeyi belirtir. Varsayılan değer ölçümdür.

İstek Başlığı

Name	Gerekli	Tür	Description
x-ms-client-id		string	Hangi hesabın Microsoft Entra ID güvenlik modeliyle birlikte kullanıma yönelik olduğunu belirtir. Azure Haritalar hesabı için benzersiz bir kimliği temsil eder ve Azure Haritalar yönetim düzlemi Hesap API'sinden alınabilir. Azure Haritalar Microsoft Entra ID güvenliğini kullanmak için kılavuz için aşağıdaki makalelere bakın.

Yanıtlar

Name	Tür	Description
200 OK	CurrentConditionsResult	Tamam
Other Status Codes	ErrorResponse	Beklenmeyen bir hata oluştu.

Güvenlik

AADToken

Bunlar Microsoft Entra OAuth 2.0 Akışlarıdır. Azure rol tabanlı erişim denetimiyle eşleştirildiğinde, Azure Haritalar REST API'lerine erişimi denetlemek için kullanılabilir. Azure rol tabanlı erişim denetimleri, bir veya daha fazla Azure Haritalar kaynak hesabına veya alt kaynağına erişimi tanımlamak için kullanılır. Herhangi bir kullanıcı, grup veya hizmet sorumlusuna yerleşik bir rol veya REST API'lerini Azure Haritalar için bir veya daha fazla izinden oluşan özel bir rol aracılığıyla erişim verilebilir.

Senaryoları uygulamak için kimlik doğrulama kavramlarını görüntülemenizi öneririz. Özetle, bu güvenlik tanımı belirli API'ler ve kapsamlar üzerinde erişim denetimi yapabilen nesneler aracılığıyla uygulamaları modellemeye yönelik bir çözüm sağlar.

Notlar

Bu güvenlik tanımı, uygulamanın erişim isteğinde x-ms-client-id bulunduğu Azure Haritalar kaynağı belirtmek için üst bilginin kullanılmasını gerektirir. Bu, Haritalar yönetim API'sinden edinilebilir.

Authorization URL, Azure genel bulut örneğine özgüdür. Bağımsız bulutların benzersiz Yetkilendirme URL'leri ve Microsoft Entra ID yapılandırmaları vardır. * Azure rol tabanlı erişim denetimi Azure portal, PowerShell, CLI, Azure SDK'ları veya REST API'leri aracılığıyla Azure yönetim düzleminden yapılandırılır. * Azure Haritalar Web SDK'sının kullanımı, bir uygulamanın birden çok kullanım örneği için yapılandırma tabanlı kurulumuna olanak tanır.

Microsoft kimlik platformu hakkında daha fazla bilgi için bkz. Microsoft kimlik platformu genel bakış.

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

Name	Description
https://atlas.microsoft.com/.default	https://atlas.microsoft.com/.default

subscription-key

Bu, Azure portal bir Azure Haritalar hesabı İçerik Oluşturucu veya PowerShell, CLI, Azure SDK'ları veya REST API kullanarak sağlanan paylaşılan bir anahtardır.

Bu anahtarla, tüm uygulamalar tüm REST API'lere erişebilir. Başka bir deyişle, bu anahtar, verildikleri hesapta ana anahtar olarak kullanılabilir.

Herkese açık uygulamalar için, anahtarınızın güvenli bir şekilde depolanabilmesi için gizli istemci uygulamaları yaklaşımını kullanarak Azure Haritalar REST API'lerine erişmenizi öneririz.

Type: apiKey
In: query

SAS Token

Bu paylaşılan erişim imzası belirteci, Azure portal, PowerShell, CLI, Azure SDK'ları veya REST API'leri aracılığıyla Azure yönetim düzlemi aracılığıyla Azure Haritalar kaynağındaki Sas Listeleme işleminden oluşturulur.

Bu belirteçle, tüm uygulamalar Azure rol tabanlı erişim denetimleri ve belirli bir belirtecin kullanım süresi, oranı ve bölgelerine yönelik ayrıntılı denetim ile erişim yetkisine sahip olur. Başka bir deyişle SAS Belirteci, uygulamaların erişimi paylaşılan anahtardan daha güvenli bir şekilde denetlemesine izin vermek için kullanılabilir.

Herkese açık uygulamalar için önerimiz, uygunsuz işlemeyi sınırlamak ve SAS Belirtecini düzenli olarak yenilemek için Harita hesabı kaynağında izin verilen kaynakların belirli bir listesini yapılandırmanızdır.

Type: apiKey
In: header

Örnekler

Successfully retrieve detailed current weather conditions for a given coordinate location

Sample Request

HTTP

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

Sample Response

Status code:: 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
          }
        }
      }
    }
  ]
}

Tanımlar

Name	Description
CurrentConditions
CurrentConditionsResult
ErrorAdditionalInfo	Kaynak yönetimi hatası ek bilgileri.
ErrorDetail	Hata ayrıntısı.
ErrorResponse	Hata yanıtı
IconCode	öğesini görüntüleyen bir görüntüyü temsil eden `iconPhrase`sayısal değer. Ayrıntılar için lütfen Azure Haritalar hava durumu hizmetlerine bakın.
JsonFormat	Yanıtın istenen biçimi. Yalnızca `json` biçim desteklenir.
PastHoursTemperature	Son saat sayısındaki sıcaklık dalgalanmalarının özeti.
PrecipitationSummary
PressureTendency
TemperatureSummary
UnitType	Görüntülenen birim türüyle ilişkili sayısal kimlik değeri. Birim çevirisi için kullanılabilir. Ayrıntılar için lütfen Azure Haritalar hava durumu hizmetlerine bakın.
WeatherDataUnit	Verileri ölçüm birimlerinde veya emperyal birimlerde döndürmeyi belirtir. Varsayılan değer ölçümdür.
WeatherUnit	Hava durumuyla ilgili belirli bir birimin belirli değeri.
WindDetails	Hız ve yön de dahil olmak üzere rüzgar ayrıntıları döndürülüyor.
WindDirection	Rüzgar yönü

CurrentConditions

Name	Tür	Description
apparentTemperature	WeatherUnit	Belirtilen ünitede hava sıcaklığı, göreli nem ve rüzgar hızının birleşiminden kaynaklanan dış mekan sıcaklığı algılandı.
ceiling	WeatherUnit	Belirtilen ünitede bulut tavanı. Tavan, en düşük bulutların tabanının yüksekliğinin ölçümüdür.
cloudCover	integer	Bulut kapağını temsil eden yüzde.
dateTime	string	ISO 8601 biçiminde görüntülenen geçerli gözlemin tarih ve saati; örneğin, 2019-10-27T19:39:57-08:00.
dewPoint	WeatherUnit	Belirtilen ünitedeki çiy noktası sıcaklığı. Çiy noktası sıcaklığı, doygunluğa ulaşmak için havanın soğutulmuş olması gereken sıcaklıktır.
hasPrecipitation	boolean	Yağışın varlığını veya yokluğunu gösterir. True, yağışın varlığını gösterir, false yağışın olmadığını gösterir.
iconCode	IconCode	öğesini görüntüleyen bir görüntüyü temsil eden `iconPhrase`sayısal değer. Ayrıntılar için lütfen Azure Haritalar hava durumu hizmetlerine bakın.
isDayTime	boolean	Günün saatini gösterir. True değeri 'day',' değerini, false değeri ise 'gece' değerini gösterir.
obstructionsToVisibility	string	Sınırlı görünürlük nedeni. Olası değerler: A = şiddetli fırtına/dolu BD = toz üfleme BN = kum üfleme BS = kar üfleme D = toz F = sis GF = yer sis HZ = pus I = buz IC = buz kristalleri IF = buz sisi IP = buz pelet'leri IPW = buz peletleri duşu K = duman L = drizzle R = yağmur RS = yağmur/kar RW = yağmur yağmuru S = kar SG = kar taneleri SP = kar peletleri SW = kar duşu T = fırtına UP = tanımsız yağış ZL = donma drizzle ZR = donma yağmuru + = ağır - = ışık
pastTwentyFourHourTemperatureDeparture	WeatherUnit	Belirtilen ünitede 24 saat önce gözlemlenen sıcaklıktan ayrılış.
phrase	string	Geçerli hava durumunun tümcecik açıklaması. Belirtilen dilde görüntülenir.
precipitationSummary	PrecipitationSummary	Son 24 saat içindeki yağış miktarlarının özeti.
pressure	WeatherUnit	Belirtilen ünitede atmosferik basınç.
pressureTendency	PressureTendency	Atmosferik basınç değişikliği.
realFeelTemperature	WeatherUnit	RealFeel™ Sıcaklık döndürülüyor.
realFeelTemperatureShade	WeatherUnit	RealFeel™ Sıcaklık döndürülüyor. Gölgede sıcaklığın gerçekten nasıl hissettirdiğini açıklar.
relativeHumidity	integer	Göreli nem, aynı sıcaklıkta doygunluk için gereken miktarın yüzdesi olarak ifade edilen havadaki su buharı miktarıdır.
temperature	WeatherUnit	Sıcaklık geri döndürülüyor.
temperatureSummary	TemperatureSummary	Son 6, 12 ve 24 saat içindeki sıcaklık dalgalanmalarının özeti.
uvIndex	integer	Ultraviyole radyasyonun güneşten gelen gücünün ölçüsü. Desteklenen değerler şunlardır: `0-2` - Güneşin UV ışınlarından veya ortalama bir kişiden kaynaklanan düşük tehlike. `3-5` - Korumasız güneşe maruz kalma kaynaklı orta derecede zarar riski. `6-7` - Korumasız güneşe maruz kalma kaynaklı yüksek zarar riski. `8-10` - Korumasız güneşe maruz kalma kaynaklı çok yüksek zarar riski. `11+` - Korumasız güneşe maruz kalma kaynaklı aşırı zarar riski.
uvIndexPhrase	string	ile `uvIndex`ilişkili tümcecik.
visibility	WeatherUnit	Belirtilen ünitede görünürlük. Bir nesnenin veya ışığın net bir şekilde ayırt edilebileceği uzaklık ölçüsü.
wetBulbTemperature	WeatherUnit	Havanın sıcaklığı, doygunluğa ulaşana kadar sabit basınçta su buharlaşarak soğutulabilir.
wind	WindDetails	Hız ve yön de dahil olmak üzere rüzgar ayrıntıları döndürülüyor.
windChillTemperature	WeatherUnit	Rüzgar nedeniyle maruz kalan ciltte algılanan hava sıcaklığı.
windGust	WindDetails	Rüzgar fışkırmış. Rüzgar ani, kısa bir rüzgar hızı artışıdır.

CurrentConditionsResult

Name	Tür	Description
results	CurrentConditions[]	Ayrıntılı güncel hava koşulları.

ErrorAdditionalInfo

Kaynak yönetimi hatası ek bilgileri.

Name	Tür	Description
info	object	Ek bilgiler.
type	string	Ek bilgi türü.

ErrorDetail

Hata ayrıntısı.

Name	Tür	Description
additionalInfo	ErrorAdditionalInfo[]	Hata ek bilgileri.
code	string	Hata kodu.
details	ErrorDetail[]	Hata ayrıntıları.
message	string	Hata iletisi.
target	string	Hata hedefi.

ErrorResponse

Hata yanıtı

Name	Tür	Description
error	ErrorDetail	Hata nesnesi.

IconCode

öğesini görüntüleyen bir görüntüyü temsil eden iconPhrasesayısal değer. Ayrıntılar için lütfen Azure Haritalar hava durumu hizmetlerine bakın.

Name	Tür	Description
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

Yanıtın istenen biçimi. Yalnızca json biçim desteklenir.

Name	Tür	Description
json	string	JavaScript Nesne Gösterimi Veri Değişim Biçimi

PastHoursTemperature

Son saat sayısındaki sıcaklık dalgalanmalarının özeti.

Name	Tür	Description
maximum	WeatherUnit	maksimum
minimum	WeatherUnit	minimum

PrecipitationSummary

Name	Tür	Description
pastEighteenHours	WeatherUnit	Son 18 saat içinde düşen yağış miktarı (sıvı eşdeğeri).
pastHour	WeatherUnit	Son bir saat içinde düşen yağış miktarı (sıvı eşdeğeri).
pastNineHours	WeatherUnit	Son dokuz saat içinde düşen yağış miktarı (sıvı eşdeğeri).
pastSixHours	WeatherUnit	Son altı saat içinde düşen yağış miktarı (sıvı eşdeğeri). Ölçüm ve emperyal değerler içerir.
pastThreeHours	WeatherUnit	Son üç saat içinde düşen yağış miktarı (sıvı eşdeğeri).
pastTwelveHours	WeatherUnit	Son 12 saat içinde düşen yağış miktarı (sıvı eşdeğeri).
pastTwentyFourHours	WeatherUnit	Son 24 saat içinde düşen yağış miktarı (sıvı eşdeğeri).

PressureTendency

Name	Tür	Description
code	string	Dilden bağımsız olarak basınç eğilimi kodu. Biri F=Düşen, S=Sabit, R=Yükselen.
localizedDescription	string	Belirtilen dilde basınç eğiliminin açıklaması

TemperatureSummary

Name	Tür	Description
pastSixHours	PastHoursTemperature	Son 6 saat içindeki sıcaklık dalgalanmalarının özeti.
pastTwelveHours	PastHoursTemperature	Son 12 saat içindeki sıcaklık dalgalanmalarının özeti.
pastTwentyFourHours	PastHoursTemperature	Son 24 saat içindeki sıcaklık dalgalanmalarının özeti.

UnitType

Görüntülenen birim türüyle ilişkili sayısal kimlik değeri. Birim çevirisi için kullanılabilir. Ayrıntılar için lütfen Azure Haritalar hava durumu hizmetlerine bakın.

Name	Tür	Description
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

Verileri ölçüm birimlerinde veya emperyal birimlerde döndürmeyi belirtir. Varsayılan değer ölçümdür.

Name	Tür	Description
imperial	string	verileri emperyal birimlerde döndürür. Emperyal sistemin bazı örnek birimleri Fahrenheit ve mil'dir.
metric	string	Ölçüm birimlerindeki verileri döndürme. Bazı örnek ölçüm sistemi birimleri Santigrat ve kilometredir.

WeatherUnit

Hava durumuyla ilgili belirli bir birimin belirli değeri.

Name	Tür	Description
unit	string	Döndürülen değer için birim türü.
unitType	UnitType	Görüntülenen birim türüyle ilişkili sayısal kimlik değeri. Birim çevirisi için kullanılabilir. Ayrıntılar için lütfen Azure Haritalar hava durumu hizmetlerine bakın.
value	number	Yuvarlatılmış değer.

WindDetails

Hız ve yön de dahil olmak üzere rüzgar ayrıntıları döndürülüyor.

Name	Tür	Description
direction	WindDirection	Rüzgar yönü
speed	WeatherUnit	Belirtilen ünitede rüzgarın hızı.

WindDirection

Rüzgar yönü

Name	Tür	Description
degrees	integer	Azimuth derecelerinde rüzgar yönü, gerçek Kuzey'den başlayıp saat yönünde devam eder. Kuzey 0 derece, doğu 90 derece, güney 180 derece, batı 270 derece. Olası değerler 0-359.
localizedDescription	string	Belirtilen dilde yön kısaltması.

Share via