Weather - Get Severe Weather Alerts

Başvuru

Service:: Maps

API Version:: 1.1

Belirli bir konum için kasırgalar, fırtınalar, sel, yıldırım, ısı dalgaları veya orman yangınları gibi şiddetli hava koşulları hakkında bilgi almak için kullanın.

Şiddetli hava durumu olgusu günlük yaşamımızı ve iş operasyonlarımızı önemli ölçüde etkileyebilir. Örneğin, tropikal fırtınalar, yüksek rüzgarlar veya sel gibi şiddetli hava koşulları yolları kapatabilir ve lojistik şirketlerini filolarını yeniden yönlendirmeye zorlayarak varış noktalarına ulaşmada gecikmelere neden olabilir ve soğutmalı gıda ürünlerinin soğuk zincirini kırabilir.

Get Severe Weather Alerts API, hem resmi Devlet Meteoroloji Ajanslarından hem de küreselden bölgesel hava durumu uyarı sağlayıcılarına önderlik eden dünya çapında kullanılabilen şiddetli hava durumu uyarılarını döndüren bir HTTP GET isteğidir. Hizmet uyarı türü, kategori, düzey ve kasırgalar, fırtınalar, şimşekler, ısı dalgaları veya orman yangınları gibi istenen konum için etkin ciddi uyarılar hakkında ayrıntılı açıklama gibi ayrıntıları döndürebilir. Daha fazla bilgi için bkz . Şiddetli hava durumu uyarıları isteme

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

With optional parameters:

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

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	Şiddetli hava durumu uyarıları 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` - Uyarı verilerinin kesilen bir sürümünü döndürür ve bu sürüm uyarı ayrıntılarının () alana özgü tam açıklamasını dışlar`alertDetails`.
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.

İ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'de Microsoft Entra ID güvenliği kullanmak için rehberlik için aşağıdaki makalelere bakın.

Yanıtlar

Name	Tür	Description
200 OK	SevereWeatherAlertsResult	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ğa erişim tanımlamak 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 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ı modellemek için bir çözüm sağlar.

Notlar

Bu güvenlik tanımı, uygulamanın erişim istediği Azure Haritalar kaynağı belirtmek için üst bilgi kullanımını x-ms-client-idgerektirir. Bu, Haritalar yönetim API'sinden alınabilir.

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 yönetim düzleminden Azure portal, PowerShell, CLI, Azure SDK'ları veya REST API'leri aracılığıyla 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'sini kullandığınızda 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 belirteç için kullanım süre sonu, oran ve bölgeler için ayrıntılı denetim ile erişim yetkisine sahip olur. Başka bir deyişle SAS Belirteci, uygulamaların paylaşılan anahtardan daha güvenli bir şekilde erişimi 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 severe weather alerts

Sample Request

HTTP

GET https://atlas.microsoft.com/weather/severe/alerts/json?api-version=1.1&query=48.057,-81.091

Sample Response

Status code:: 200

{
  "results": [
    {
      "countryCode": "CA",
      "alertId": 242621,
      "description": {
        "localized": "Heat Warning",
        "english": "Heat Warning"
      },
      "category": "NON-PRECIPITATION",
      "priority": 31,
      "source": "Environment Canada",
      "sourceId": 3,
      "alertAreas": [
        {
          "name": "Kirkland Lake - Englehart",
          "summary": "Heat Warning in effect until Thursday, 3:16 AM EDT.  Source: Environment Canada",
          "startTime": "2020-06-29T19:44:00+00:00",
          "endTime": "2020-07-02T07:16:03+00:00",
          "latestStatus": {
            "localized": "Continue",
            "english": "Continue"
          },
          "alertDetails": "\nA heat event continues through Thursday.\n\nDaytime high temperatures in the low thirties with overnight lows near 18 degrees Celsius are expected to continue until Thursday. Humidex values are expected to reach between 36 and 40 today. Cooler air will move into the region Thursday night. \n\nPlease refer to your public forecast for further details on expected temperatures.\n\nHot and humid air can also bring deteriorating air quality and can result in the air quality health index to approach the high risk category.\n\n###\n\nExtreme heat affects everyone.\n\nThe risks are greater for young children, pregnant women, older adults, people with chronic illnesses and people working or exercising outdoors.\n\nWatch for the effects of heat illness: swelling, rash, cramps, fainting, heat exhaustion, heat stroke and the worsening of some health conditions.\n\nPlease continue to monitor alerts and forecasts issued by Environment Canada. To report severe weather, send an email to ONstorm@canada.ca or tweet reports using #ONStorm.\n",
          "alertDetailsLanguageCode": "en-CA"
        }
      ]
    },
    {
      "countryCode": "CA",
      "alertId": 242633,
      "description": {
        "localized": "Heat Warning",
        "english": "Heat Warning"
      },
      "category": "NON-PRECIPITATION",
      "priority": 31,
      "source": "Environment Canada",
      "sourceId": 3,
      "alertAreas": [
        {
          "name": "Kirkland Lake - Englehart",
          "summary": "Heat Warning in effect until 9:25 PM EDT.  Source: Environment Canada",
          "startTime": "2020-07-01T09:25:59+00:00",
          "endTime": "2020-07-02T01:25:59+00:00",
          "latestStatus": {
            "localized": "New",
            "english": "New"
          },
          "alertDetails": "\nA heat event is expected through Thursday.  \n\nDaytime high temperatures in the low thirties on Wednesday and Thursday with overnight lows near 18 degrees Celsius are expected. This heat event may be extended into the weekend with daytime high temperatures near 30 degrees Celsius. \n\nPlease refer to your public forecast for further details on expected temperatures.  \n\nHot and humid air can also bring deteriorating air quality and can result in the Air Quality Health Index to approach the high risk category.\n\n###\n\nExtreme heat affects everyone.\n\nThe risks are greater for young children, pregnant women, older adults, people with chronic illnesses and people working or exercising outdoors.\n\nPlease continue to monitor alerts and forecasts issued by Environment Canada. To report severe weather, send an email to ONstorm@canada.ca or tweet reports using #ONStorm.\n",
          "alertDetailsLanguageCode": "en-CA"
        }
      ]
    }
  ]
}

Tanımlar

Name	Description
AlertArea	Etkilenen bölgelerde verilen şiddetli hava durumu uyarısı hakkında bilgi. Aynı konum için birden çok uyarı etkinse, uyarılar API yanıtının içinde sırasıyla `priority` döndürülür ve en yüksek öncelikli uyarı yanıtın en üstünde döndürülür.
ErrorAdditionalInfo	Kaynak yönetimi hatası ek bilgileri.
ErrorDetail	Hata ayrıntısı.
ErrorResponse	Hata yanıtı
JsonFormat	Yanıtın istenen biçimi. Yalnızca `json` biçim desteklenir.
LatestStatus	Geçerli alandaki uyarının en son durumu.
LatestStatusKeyword	Uyarının en son durumu için anahtar sözcük.
SevereWeatherAlert	Şiddetli bir hava durumu uyarısı hakkında bilgi.
SevereWeatherAlertDescription	Şiddetli hava durumu uyarısının açıklaması.
SevereWeatherAlertsResult	Bu nesne başarılı bir Get Severe Weather Alerts çağrısından döndürülür.

AlertArea

Etkilenen bölgelerde verilen şiddetli hava durumu uyarısı hakkında bilgi. Aynı konum için birden çok uyarı etkinse, uyarılar API yanıtının içinde sırasıyla priority döndürülür ve en yüksek öncelikli uyarı yanıtın en üstünde döndürülür.

Name	Tür	Description
alertDetails	string	Uyarıyla ilişkili tüm ayrıntılar. =Doğru ise `details`döndürülür. Bu alan her zaman veren sağlayıcı tarafından tercih edilen dillerde döndürülür ve Azure Haritalar yalnızca sağlayıcı tarafından oluşturulanları döndürür. Bazı ülkelerin/bölgelerin ana dili ve İngilizcesi olabileceğini lütfen unutmayın. Dil parametresi bu alana uygulanmaz.
alertDetailsLanguageCode	string	dilinin dili `alertDetails`. Bu alan, dilinin istenen dil `alertDetails` parametresinden farklı olabileceğini belirtmeye yardımcı olur. =Doğru ise `details`döndürülür. Dil kodu ISO 639-1 Alfa-2 kodlarından türetilmiştir.
endTime	string	Uyarının ISO 8601 biçimindeki bitiş tarihi ve saati; örneğin, 2019-10-27T19:39:57-08:00. Uyarı birden çok saat dilimini geçerse yanıtta döndürülen saat, istenen koordinat konumuna yerel saattir.
latestStatus	LatestStatus	Geçerli alandaki uyarının en son durumu.
name	string	Uyarıdan etkilenen bir alanın adı. İstenen konum uyarı alanının altında yer alır.
startTime	string	Iso 8601 biçiminde uyarının başlangıç tarihi ve saati; örneğin, 2019-10-27T19:39:57-08:00. Uyarı birden çok saat dilimini geçerse yanıtta döndürülen saat, istenen koordinat konumuna yerel saattir.
summary	string	Döndürülen alandaki uyarıyı özetleyen metin.

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.

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

LatestStatus

Geçerli alandaki uyarının en son durumu.

Name	Tür	Description
english	LatestStatusKeyword	Uyarı için en son durum anahtar sözcüğü, İngilizce (tr-TR).
localized	string	Belirtilen dilde uyarı için en son durum anahtar sözcüğü. Varsayılan olarak, İngilizce (tr-TR) olarak döndürülür.

LatestStatusKeyword

Uyarının en son durumu için anahtar sözcük.

Name	Tür	Description
Cancel	string	"İptal" - Uyarı, ilk sona erme tarihinden önce iptal edildi.
Continue	string	"Devam" - uyarı ilk verilmesinden bu yana güncelleştirildi, ancak , , `startTimeendTime`veya `class`üzerinde hiçbir değişiklik yapılmadı`alertDetails`.
Correct	string	"Doğru" - uyarı önceki bir hatayı düzeltecek şekilde değiştirildi.
Expire	string	"Süre sonu" - uyarının süresi doldu ve artık etkin değil.
Extend	string	"Genişlet" - uyarı ilk verilmesinden bu yana zaman, alan veya her ikisi için de genişletilmiştir.
New	string	"Yeni" - ilk verme işleminden sonra bir uyarının durumu.
Update	string	"Güncelleştir" - uyarı ilk verilmesinden bu yana güncelleştirildi.
Upgrade	string	"Yükselt" - uyarı ilk verilmesinden bu yana daha yüksek bir sınıfa veya kategoriye yükseltildi.

SevereWeatherAlert

Şiddetli bir hava durumu uyarısı hakkında bilgi.

Name	Tür	Description
alertAreas	AlertArea[]	Etkilenen alanlara özgü uyarı hakkında bilgi.
alertId	integer	Hava durumu uyarısı için benzersiz bir sayısal tanımlayıcı.
category	string	Uyarı kategorisi.
class	string	Uyarının sınıflandırması. Bu alan tüm ülkelerde kullanılamaz ve bu nedenle her zaman iade edilmez.
countryCode	string	2 karakterli ISO 3166-1 Alfa-2 ülke kodu, örneğin, "ABD".
description	SevereWeatherAlertDescription	Uyarının açıklaması.
disclaimer	string	Uyarı bilgilerinin kaynağıyla ilgili bir bildirim. Bu alan her zaman kullanılamaz. Örneğin, uyarı gecikmeler veya alarmla ilgili olası sorunlar hakkındaki ayrıntıları içerebilir.
level	string	Uyarının önem düzeyi. Bu alan tüm ülkelerde kullanılamaz ve bu nedenle her zaman iade edilmez.
priority	integer	Verilen uyarının kaynaklandığı ülke/bölge içindeki önemini veya sıralama sırasını belirten sayı. Daha düşük bir sayı, daha yüksek bir önceliğe işaret verir. Örneğin, en yüksek öncelik 1'dir. Sayı ülkeye/bölgeye göre değişir ve her ülke/bölge uyarı sistemlerini geliştikçe zaman içinde değişebilir.
source	string	Uyarı bilgilerinin sağlayıcısı. Varsayılan olarak kaynak İngilizce (tr-TR) olarak döndürülür. Uyarılar resmi Kamu Meteoroloji Ajansları ve önde gelen küresel hava durumu uyarısı sağlayıcılarından alınmaktadır.
sourceId	integer	Uyarı verilerinin kaynak sağlayıcı adıyla ilişkili sayısal tanımlayıcı.

SevereWeatherAlertDescription

Şiddetli hava durumu uyarısının açıklaması.

Name	Tür	Description
english	string	Uyarının İngilizce (tr-TR) olarak açıklaması.
localized	string	Belirtilen dilde uyarının açıklaması. İstekte dil parametresi belirtilmezse varsayılan olarak İngilizce (en-US) döndürülür.

SevereWeatherAlertsResult

Bu nesne başarılı bir Get Severe Weather Alerts çağrısından döndürülür.

Name	Tür	Description
results	SevereWeatherAlert[]	Sorgulanan konum için tüm ciddi hava durumu uyarılarının listesi.

Share via