Weather - Get Current Conditions
Mevcut hava koşullarını almak için kullanın.
API Get Current Conditions , belirli bir koordinat konumu için yağış, sıcaklık ve rüzgar gibi ayrıntılı mevcut hava koşullarını döndüren bir HTTP GET isteğidir. Ayrıca, belirli bir konum için son 6 veya 24 saatlik gözlemler alınabilir. Yanıtla 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 indeksi 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 {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}
URI Parametreleri
| Name | İçinde | Gerekli | Tür | Description |
|---|---|---|---|---|
|
endpoint
|
path | True |
string (uri) |
Azure Haritalar service hostname. Azure açık bulut için |
|
format
|
path | True |
Yanıtın istenen biçimi. Yalnızca |
|
|
api-version
|
query | True |
string minLength: 1 |
Bu işlem için kullanılacak API sürümü. |
|
query
|
query | True |
number[] |
Enlem ve ardından "47.641268,-122.125679" gibi boylamlardan oluşan virgülle ayrılmış bir dize olarak belirtilen geçerli sorgu. Hava durumu bilgileri genellikle karadaki konumlar, karayla çevrili su kütleleri ve bir kıyı şeridinin yaklaşık 50 deniz mili içindeki okyanus alanları için kullanılabilir. |
|
details
|
query |
string |
Mevcut koşullar için tüm ayrıntıları döndürün. Kullanılabilir değerler şunlardır
|
|
|
duration
|
query |
integer (int32) |
İade edilen 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:
|
|
|
language
|
query |
string |
Arama sonuçlarının döndürülmesi gereken dil. Desteklenen IETF dil etiketlerinden biri olmalıdır ve büyük/küçük harfe duyarsız 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 bakın. |
|
|
unit
|
query |
Verilerin metrik birimler veya İngiliz ölçü birimleri cinsinden döndürüleceğini belirtir. Varsayılan değer metriktir. |
İstek Başlığı
| Name | Gerekli | Tür | Description |
|---|---|---|---|
| x-ms-client-id |
string |
Microsoft Entra ID güvenlik modeliyle kullanılmak üzere tasarlanmış hesabı gösterir. Azure Haritalar hesabı için bu benzersiz ID, Azure Haritalar yönetim düzlemi Hesap API'dan alınabilir. Azure Haritalar'de Microsoft Entra ID güvenliği kullanımı hakkında daha fazla bilgi için bkz. Doğrulamayı Azure Haritalar içinde yönetin. |
Yanıtlar
| Name | Tür | Description |
|---|---|---|
| 200 OK |
İstek başarılı oldu. |
|
| Other Status Codes |
Beklenmeyen bir hata yanıtı. |
Güvenlik
AadToken
Bunlar Microsoft Entra OAuth 2.0 Akışlarıdır. Azure rol tabanlı erişim kontrolüyle eşleştirildiğinde, Azure Haritalar REST API'lerine erişimi kontrol etmek için kullanılabilir. Azure rol tabanlı erişim kontrolleri, bir veya daha fazla Azure Haritalar kaynak hesabına veya alt kaynağa erişim belirlemek için kullanılır. Tüm kullanıcılara, gruplara veya hizmet sorumlularına yerleşik bir rol veya Azure Haritalar REST API'leri için bir veya daha fazla izinden oluşan özel bir rol aracılığıyla erişim verilebilir.
Senaryoları uygulamak için
Note
- Bu güvenlik tanımı kullanılmasını gerektirir. Bu, Haritalar yönetim API'sindenedinilebilir.
-
Authorization URL, Azure genel bulut örneğine özgüdür. Egemen bulutlar benzersiz Yetkilendirme URL'lerine ve Microsoft Entra ID yapılandırmalarına sahiptir. - 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 platformuna genel bakış.
Tür:
oauth2
Akış:
implicit
Yetkilendirme URL’si:
https://login.microsoftonline.com/common/oauth2/authorize
Kapsamlar
| Name | Description |
|---|---|
| https://atlas.microsoft.com/.default |
subscription-key
Bu, Azure portalında Azure Haritalar hesabı oluşturma 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 Azure Haritalar REST API'lerine erişmek için gizli istemci uygulamaları yaklaşımını kullanmanızı öneririz.
Tür:
apiKey
İçinde:
header
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ğı Sas Listeleme işleminden oluşturulur.
Bu belirteçle, tüm uygulamalar Azure rol tabanlı erişim denetimleri ve belirli bir belirteç için kullanım süre sonu, oran ve bölgelere ayrıntılı denetim ile erişim yetkisine sahiptir. 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, Eşleme hesabı kaynağında izin verilen kaynakların belirli bir listesini yapılandırmayı işleme kötüye kullanımını sınırlamak ve SAS Belirtecini düzenli olarak yenilemektir.
Tür:
apiKey
İçinde:
header
Örnekler
Successfully retrieve detailed current weather conditions for a given coordinate location
Örnek isteği
GET https://atlas.microsoft.com/weather/currentConditions/json?api-version=1.1&query=47.641268,-122.125679
Örnek yanıt
{
"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
}
}
}
]
}
Tanımlar
| Name | Description |
|---|---|
|
Current |
Güncel hava koşulları verileri. |
|
Current |
Mevcut hava koşulları ortaya çıktı. |
|
Error |
Kaynak yönetimi hatası ek bilgileri. |
|
Error |
Hata ayrıntısı. |
|
Error |
Tüm Azure Resource Manager API'lerinin başarısız işlemler için hata detaylarını döndürmesi için yaygın hata yanıtı. (Bu, OData hata yanıt biçimini de izler.). |
|
Icon |
Mülk tarafından açıklanan mevcut hava durumuna karşılık gelen bir görüntüyü temsil eden |
|
Json |
Yanıtın istenen biçimi. Yalnızca |
|
Past |
Son saatlerdeki sıcaklık dalgalanmalarının özeti. |
|
Precipitation |
Yağış miktarlarının özeti. |
|
Pressure |
Atmosfer basıncı eğilimi. |
|
Temperature |
Sıcaklık dalgalanmalarının özeti. |
|
Unit |
Birim türünü temsil eden bir tamsayı. Örneğin, Celsius için 17, Fahrenheit için 18. Birim çevirisi için kullanılabilir. Tam bir liste için bkz. Weather Services in Azure Haritalar. |
|
Weather |
Hava durumu verileri için ölçüm birimi. |
|
Weather |
Hava durumu ile ilgili belirli bir birimin belirli değeri. |
|
Wind |
Hız ve yön dahil olmak üzere rüzgar ayrıntıları döndürülüyor. |
|
Wind |
Rüzgar yönü |
CurrentConditions
Güncel hava koşulları verileri.
| Name | Tür | Description |
|---|---|---|
| apparentTemperature |
Belirtilen birimde hava sıcaklığı, bağıl nem ve rüzgar hızının birleşiminden kaynaklanan algılanan dış ortam sıcaklığı. |
|
| ceiling |
Belirtilen birimde bulut tavanı. Tavan, en düşük bulutların tabanının yüksekliğinin bir ölçüsüdür. |
|
| cloudCover |
integer (int32) |
Bulut örtüsünü temsil eden yüzde. |
| dateTime |
string (date-time) |
Mevcut gözlemin tarihi ve saati ISO 8601 formatında gösteriliyor, örneğin 2019-10-27T19:39:57-08:00. |
| dewPoint |
Belirtilen birimdeki çiy noktası sıcaklığı. Çiy noktası sıcaklığı, doygunluğa ulaşmak için havanın soğutulması gereken sıcaklıktır. |
|
| hasPrecipitation |
boolean |
Belirlenen zaman diliminde yağışın (yağmur, kar, beri ya da dolu) beklenip beklenmeyeceğini gösteren bir boolean değeri. Yağıntı bekleniyorsa doğru döner, aksi takdirde yanlış. |
| iconCode |
Mülk tarafından açıklanan mevcut hava durumuna karşılık gelen bir görüntüyü temsil eden |
|
| isDayTime |
boolean |
Günün saatini gösterir. Doğru 'gündüz', yanlış ise 'gece' anlamına gelir. |
| obstructionsToVisibility |
string |
Sınırlı görünürlüğün nedeni. Olası değerler:
|
| pastTwentyFourHourTemperatureDeparture |
Belirtilen birimde 24 saat önce gözlemlenen sıcaklıktan ayrılma. |
|
| phrase |
string |
Mevcut hava durumu açıklaması. Belirtilen dilde görüntülenir. |
| precipitationSummary |
Son 24 saatteki yağış miktarlarının özeti. |
|
| pressure |
Belirtilen birimde atmosferik basınç. |
|
| pressureTendency |
Atmosferik basınç değişimi. |
|
| realFeelTemperature |
RealFeel™ Sıcaklığı geri döndürülüyor. |
|
| realFeelTemperatureShade |
RealFeel™ Sıcaklığı geri döndürülüyor. Gölgede sıcaklığın nasıl gerçekten hissedildiğini açıklar. |
|
| relativeHumidity |
integer (int32) |
Bağıl nem, aynı sıcaklıkta doygunluk için gereken miktarın yüzdesi olarak ifade edilen havada bulunan su buharı miktarıdır. |
| temperature |
Sıcaklık geri döndürülüyor. |
|
| temperatureSummary |
Son 6, 12 ve 24 saatteki sıcaklık dalgalanmalarının özeti. |
|
| uvIndex |
integer (int32) |
Güneşten gelen ultraviyole radyasyonun gücünün ölçüsü. Desteklenen değerler şunlardır:
|
| uvIndexPhrase |
string |
ile ilişkili |
| visibility |
Belirtilen birimde görünürlük. Bir nesnenin veya ışığın net bir şekilde ayırt edilebileceği mesafenin bir ölçüsü. |
|
| wetBulbTemperature |
Havanın, doygunluğa ulaşana kadar sabit basınçta içine su buharlaştırılarak soğutulabileceği sıcaklık. |
|
| wind |
Hız ve yön dahil olmak üzere rüzgar ayrıntıları döndürülüyor. |
|
| windChillTemperature |
Rüzgar nedeniyle maruz kalan ciltte algılanan hava sıcaklığı. |
|
| windGust |
Rüzgar dalgası. Rüzgar esintisi, rüzgarın hızındaki ani, kısa bir artıştır. |
CurrentConditionsResult
Mevcut hava koşulları ortaya çıktı.
| Name | Tür | Description |
|---|---|---|
| results |
Ayrıntılı güncel hava koşulları. |
ErrorAdditionalInfo
Kaynak yönetimi hatası ek bilgileri.
| Name | Tür | Description |
|---|---|---|
| info |
Ek bilgiler. |
|
| type |
string |
Ek bilgi türü. |
ErrorDetail
Hata ayrıntısı.
| Name | Tür | Description |
|---|---|---|
| additionalInfo |
Hata ek bilgileri. |
|
| code |
string |
Hata kodu. |
| details |
Hata ayrıntıları. |
|
| message |
string |
Hata iletisi. |
| target |
string |
Hata hedefi. |
ErrorResponse
Tüm Azure Resource Manager API'lerinin başarısız işlemler için hata detaylarını döndürmesi için yaygın hata yanıtı. (Bu, OData hata yanıt biçimini de izler.).
| Name | Tür | Description |
|---|---|---|
| error |
Hata nesnesi. |
IconCode
Mülk tarafından açıklanan mevcut hava durumuna karşılık gelen bir görüntüyü temsil eden Phrase sayısal değer. Daha fazla bilgi için bkz. Weather Services in Azure Haritalar. NULL olabilir.
| Değer | Description |
|---|---|
| 1 |
Güneşli |
| 2 |
Çoğunlukla güneşli |
| 3 |
Parçalı güneşli |
| 4 |
Aralıklı Bulutlar |
| 5 |
Puslu Güneş Işığı |
| 6 |
Parçalı bulutlu |
| 7 |
Cloudy |
| 8 |
kasvetli (bulutlu) |
| 11 |
Sis |
| 12 |
Showers |
| 13 |
Çoğunlukla Duşlu Bulutlu |
| 14 |
Duşlu Kısmen Güneşli |
| 15 |
Thunderstorms |
| 16 |
Çoğunlukla Fırtınalı Bulutlu |
| 17 |
Thunderstorms ile Kısmen Güneşli |
| 18 |
Yağmur |
| 19 |
Flurries |
| 20 |
Flurries ile Çoğunlukla Bulutlu |
| 21 |
Flurries ile Kısmen Güneşli |
| 22 |
Snow |
| 23 |
Çoğunlukla Karlı Bulutlu |
| 24 |
Buz |
| 25 |
Sleet |
| 26 |
Dondurucu yağmur |
| 29 |
Yağmur ve Kar |
| 30 |
Hot |
| 31 |
Cold |
| 32 |
Windy |
| 33 |
Açık |
| 34 |
Çoğunlukla Açık |
| 35 |
Parçalı bulutlu |
| 36 |
Aralıklı Bulutlar (Gece) |
| 37 |
Puslu Ay Işığı |
| 38 |
Parçalı bulutlu (Gece) |
| 39 |
Duşlu Kısmen Bulutlu |
| 40 |
Parçalı Bulutlu ve Sağanak Yağışlı (Gece) |
| 41 |
Thunderstorms ile Kısmen Bulutlu |
| 42 |
Parçalı Bulutlu ve Gök Gürültülü Sağanak Yağışlı (Gece) |
| 43 |
Parçalı Bulutlu ve Sağanak Yağışlı (Gece) |
| 44 |
Parçalı Bulutlu ve Kar Yağışlı (Gece) |
JsonFormat
Yanıtın istenen biçimi. Yalnızca json biçimi desteklenir.
| Değer | Description |
|---|---|
| json |
PastHoursTemperature
Son saatlerdeki sıcaklık dalgalanmalarının özeti.
| Name | Tür | Description |
|---|---|---|
| maximum |
maksimum |
|
| minimum |
minimum |
PrecipitationSummary
Yağış miktarlarının özeti.
| Name | Tür | Description |
|---|---|---|
| past12Hours |
Son 12 saat içinde düşen yağış miktarı (sıvı eşdeğeri). |
|
| past18Hours |
Son 18 saat içinde düşen yağış miktarı (sıvı eşdeğeri). |
|
| past24Hours |
Son 24 saat içinde düşen yağış miktarı (sıvı eşdeğeri). |
|
| past3Hours |
Son üç saat içinde düşen yağış miktarı (sıvı eşdeğeri). |
|
| past6Hours |
Son altı saat içinde düşen yağış miktarı (sıvı eşdeğeri). Metrik ve İngiliz ölçü ölçü değerlerini içerir. |
|
| past9Hours |
Son dokuz saat içinde düşen yağış miktarı (sıvı eşdeğeri). |
|
| pastHour |
Son bir saat içinde düşen yağış miktarı (sıvı eşdeğeri). |
PressureTendency
Atmosfer basıncı eğilimi.
| Name | Tür | Description |
|---|---|---|
| code |
string |
Dilden bağımsız olarak basınç eğilimi kodu. Biri f=düşüyor, s=sabit, r=yükseliyor. |
| localizedDescription |
string |
Belirtilen dilde basınç eğiliminin açıklaması |
TemperatureSummary
Sıcaklık dalgalanmalarının özeti.
| Name | Tür | Description |
|---|---|---|
| past12Hours |
Son 12 saatteki sıcaklık dalgalanmalarının özeti. |
|
| past24Hours |
Son 24 saatteki sıcaklık dalgalanmalarının özeti. |
|
| past6Hours |
Son 6 saatteki sıcaklık dalgalanmalarının özeti. |
UnitType
Birim türünü temsil eden bir tamsayı. Örneğin, Celsius için 17, Fahrenheit için 18. Birim çevirisi için kullanılabilir. Tam bir liste için bkz. Weather Services in Azure Haritalar.
| Değer | Description |
|---|---|
| 0 |
feet |
| 1 |
inches |
| 2 |
miles |
| 3 |
millimeter |
| 4 |
centimeter |
| 5 |
meter |
| 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 |
yüzmek |
| 22 |
tamsayı |
| 31 |
MicrogramsPerCubicMeterOfAir |
WeatherDataUnit
Hava durumu verileri için ölçüm birimi.
| Değer | Description |
|---|---|
| imperial |
Sıcaklık için Fahrenheit (F) ve mesafe için mil (mi) gibi İngiliz ölçü birimlerini kullanarak verileri döndürün. |
| metric |
Sıcaklık için Santigrat (C) ve mesafe için kilometre (km) gibi metrik birimleri kullanarak verileri döndürün. |
WeatherValue
Hava durumu ile 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 |
Birim türünü temsil eden bir tamsayı. Örneğin, Celsius için 17, Fahrenheit için 18. Birim çevirisi için kullanılabilir. Tam bir liste için bkz. Weather Services in Azure Haritalar. |
|
| value |
number (float) |
Yuvarlanmış değer. |
WindDetails
Hız ve yön dahil olmak üzere rüzgar ayrıntıları döndürülüyor.
| Name | Tür | Description |
|---|---|---|
| direction |
Rüzgar yönü |
|
| speed |
Belirtilen birimde rüzgarın hızı. |
WindDirection
Rüzgar yönü
| Name | Tür | Description |
|---|---|---|
| degrees |
integer (int32) |
Azimut derecesinde rüzgar yönü, gerçek kuzeyden başlar ve 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ı. |