publicAlerts
uç noktası, yetkili ulusal ve uluslararası kurumlar tarafından yayınlanan belirli hava durumu etkinliği uyarılarıyla ilgili ayrıntılar sağlar. Bu uyarılar, hayati önem taşıyan ve hayat kurtarabilecek bilgiler sunar.
Uç nokta, belirli bir enlem ve boylam için anlık olarak gerçekleşen hava durumu uyarılarını döndürür. Desteklenen hava durumu etkinlikleri şunlardır:
- Yağış: Yağmur, kar, dolu, kuraklık ve daha fazlası
- Aşırı sıcaklıklar: Soğuk, sıcak, donma, buzlanma, rüzgarın soğutucu etkisi ve nem
- Rüzgar ve fırtına olayları: Kar fırtınaları, kasırgalar, hortumlar, tropikal fırtınalar, gök gürültülü fırtınalar ve daha fazlası
- Görüş mesafesini etkileyen durumlar: Sis, toz fırtınaları ve tipi
- Suyla ilgili tehlikeler: Sel, tsunami, fırtına dalgalanması, kıyı şeridi tehlikeleri ve daha fazlası
- Jeofiziksel ve jeolojik olaylar: Depremler, toprak kaymaları ve volkanik faaliyetler
- Yangın olayları: Orman yangını, yangın hava durumu ve daha fazlası
Desteklenen hava durumu etkinliklerinin tam listesi için Hava durumu etkinlik türleri başlıklı makaleyi inceleyin.
Uyarılar, veri kaynağında bulunan bilgilere bağlı olarak yerelleştirilmiş açıklamalar içerebilir veya içermeyebilir. Veri kaynağı kısıtlamaları nedeniyle bilgiler olduğu gibi (ham içerik) sunulur. Hava durumu uyarı kaynakları hakkında daha fazla bilgi için Veri kaynakları başlıklı makaleyi inceleyin.
API, belirli bir hava durumu uyarısıyla ilgili aşağıdaki bilgileri döndürür:
- Uyarıyla ilişkili hava durumu etkinliğinin türü
- Etkilenen alanların listesi ve bu alanların coğrafi sınırlarını tanımlayan koordinatlar
- Hava durumu olayının tek cümlelik özeti
- Ciddiyet, kesinlik ve aciliyet seviyeleri
- Hedef kitleye yönelik işlem önerisi talimatlarının açıklaması
- Güvenlik önerileri
- Uyarının başlangıç ve bitiş zamanları
- Yayıncı kuruluşun adı ve web sitesi
API Gezgini, API ve API seçenekleri hakkında bilgi edinmek için canlı isteklerde bulunmanıza olanak tanır:
Hava durumu uyarı istekleri hakkında
Hava durumu uyarısı bilgisi istemek için şu adrese bir HTTP GET isteği gönderin:
https://weather.googleapis.com/v1/publicAlerts:lookup?key=YOUR_API_KEY&location.latitude=LATITUDE&location.longitude=LONGITUDE&languageCode=LANGUAGE_CODE
İstek URL'si parametrelerinize konumun enlem ve boylam koordinatlarını ekleyin.
Hava durumu uyarılarıyla ilgili yanıtlar hakkında
Weather API, yanıt metninde aşağıdaki alanları döndürür:
| Alan | Tür | Açıklama | Zorunlu veya isteğe bağlı |
|---|---|---|---|
alertId |
Dize | Uyarı kimliği. Bu bilgileri veri sağlayıcının web sitesinde de bulabilirsiniz. | Zorunlu |
alertTitle |
Dize | Hava durumu olayını açıklayan uyarı başlığı. Not: Bu, isteğe bir dil kodu parametresi dahil edildiğinde çevrilen tek dizedir. |
Zorunlu |
eventType |
Enum | Uyarıyla ilişkili hava durumu etkinliğinin türü. Desteklenen hava durumu etkinliklerinin tam listesi için Hava durumu etkinliği türleri başlıklı makaleye bakın. |
Zorunlu |
areaName |
Dize | İstenen konumu da içeren, uyarıdan etkilenen coğrafi alanın adı. | Zorunlu |
polygon |
Dize | Uyarı alanının kapalı boyutlu alanını tanımlayan koordinatlar. | İsteğe bağlı |
description |
Dize | Etkinlik açıklamasını belirtilen dilde özetleyen kısa bir ifade (örneğin, "Tornado uyarısı"). | İsteğe bağlı |
severity |
Enum | Uyarının önem düzeyi:
|
İsteğe bağlı |
certainty |
Enum | Uyarının kesinlik düzeyi:
|
İsteğe bağlı |
urgency |
Enum | Uyarının aciliyet düzeyi:
|
İsteğe bağlı |
instruction |
Dize | Hedef kitle için duyarlı işlem talimatlarının açıklaması. | İsteğe bağlı |
safetyRecommendations |
Dize | Kamu yetkilisi kodlarına dayalı güvenlik önerileri. Üst düzey yönergeler ve ek bilgiler içeren alt metinler yer alır. | İsteğe bağlı |
timezoneOffset |
Dize | Etkinliğin saat dilimi farkı, +/-SS:DD biçiminde. | Zorunlu |
startTime |
Tarih ve saat | Uyarı mesajındaki bilgilerin geçerli Epoch tarihi ve saati (UTC saati). | İsteğe bağlı |
expirationTime |
Tarih ve saat | Bir uyarının sona ermesinin beklendiği Epoch tarihi ve saati (UTC saati). Süresiz uzunluktaki etkinlikler için boş olabilir. Bu durumda başlık, etkinliğin "geçerli" olduğunu gösterir. | İsteğe bağlı |
dataSource |
Enum | Yayıncı, ad ve URL dahil olmak üzere yetkili ayrıntıları. | Zorunlu |
regionCode |
Enum | İstenen konumun bölge kodu. | İsteğe bağlı |
Veri kaynakları
Hava durumu uyarıları uç noktası, aşağıdaki tabloda listelenen sağlayıcılar tarafından yayınlanan verileri döndürür. Yanıt gövdesi, istekte sağlanan enlem ve boylam koordinatlarına göre uygun yerel yetkilinin verilerini gösterir.
Feed'e dahil edilen sağlayıcılar, Google'ın Kamu Uyarıları kurallarına uyar. Google, sağlayıcı listesini istediği zaman güncelleyebilir.
İlişkilendirme
Verilerin sunulduğu tüm ekranlarda, müşteri uygulaması dataSource alanı kullanılarak orijinal kaynağa atıfta bulunmalıdır:
"dataSource": {
"publisher": "NOAA",
"name": "National Weather Service",
"authorityUri": "https://www.weather.gov/"
}
İlişkilendirme, veri kaynağının tam adını (name alanında belirtildiği gibi) içermeli ve authorityUri alanında belirtilen URL kullanılarak veri kaynağına köprü oluşturulmalıdır (örneğin, "Ulusal Hava Durumu Servisi").
Hava durumu etkinlik türleri
Aşağıdaki hava durumu olay türleri desteklenir:
| Hava durumu etkinlik türleri | |
|---|---|
ACID_RAINAVALANCHEBLIZZARDBLOWING_SNOWCOASTAL_FLOODCOASTAL_HAZARDCOLDCYCLONEDROUGHTEXTRATROPICAL_CYCLONEFIRE_WEATHERFLASH_FLOODFLOODFOGFREEZINGFREEZING_AIR_TEMPERATUREFREEZING_DRIZZLEFREEZING_RAINFROSTGALEGLAZEHAILHAZARDOUS_SEASHEATHUMIDITYHURRICANEICE_STORMLAKE_EFFECT_SNOWMONSOONMUDDY_FLOODOUTFLOWRAIN
|
RIVER_FLOODINGSEVERE_THUNDERSTORM_WARNINGSNOWSNOWSQUALLSTORMSTORM_SURGETHUNDERTHUNDERSTORMTORNADOTORNADO_WARNINGTROPICAL_CYCLONETROPICAL_CYCLONE_WARNINGS_AND_WATCHESTROPICAL_DISTURBANCETROPICAL_STORMTYPHOONWINDWIND_CHILLWIND_WAVEWINTER_STORMWILDFIREBUSHFIREFIRELANDSLIDEEARTHQUAKEDUST_STORMAFTERSHOCKTSUNAMIVOLCANIC_ASHVOLCANIC_ERUPTIONRADIATION |
Yanıt çevirisi davranışı
Google yalnızca alertTitle alanı için çeviri sağlar. eventType, areaName, instruction ve safetyRecommendations gibi diğer alanlar da orijinal veri kaynağının dil desteğine bağlı olarak çevrilebilir ancak Google bu alanlar için bağımsız çeviriler sağlayamaz.
İsteğe dahil edilen languageCode parametresine göre, alertTitle alanı için aşağıdaki davranışlar beklenir:
- Destekleniyor
languageCode: İstenenlanguageCodehem sağlanıyor hem de destekleniyorsa yanıt, istenen dilde döndürülür. - Desteklenmiyor
languageCode: İstenenlanguageCodedesteklenmediğinde ve yakın bir alternatif bulunamadığında uç nokta, yanıtı varsayılan olarak İngilizce dilinde döndürür. languageCodesağlanmadı: Uç nokta, yanıtı varsayılan olarak İngilizce döndürür.
Hava durumu uyarısı isteği örneği
Aşağıdaki örnekte, Kuzey Carolina'daki bir kasaba için hava durumu uyarısı bilgileri istenmektedir:
curl -X GET "https://weather.googleapis.com/v1/publicAlerts:lookup?key=YOUR_API_KEY&location.latitude=35.824635 &location.longitude=-78.3168047 &languageCode=en"
Yanıt metni aşağıdaki gibidir:
{ "weatherAlerts": [ { "alertId": "urn:oid:2.49.0.1.840.0.2416b1b5a6f51d29ef4b94948328dca303fbbb5c.001.1", "alertTitle": { "text": "Flash Flood Warning", "languageCode": "en" }, "eventType": "FLASH_FLOOD", "areaName": "Franklin, NC; Johnston, NC; Nash, NC; Wake, NC", "polygon": "{\"type\":\"Polygon\",\"coordinates\":[[[-78.450000,35.820000],[-78.410000,35.730000],[-78.280000,35.660000],[-78.180000,35.740000],[-77.840000,36.150000],[-77.890000,36.140000],[-77.900000,36.160000],[-77.920000,36.170000], [-77.930000,36.190000], [-77.940000,36.190000],[-77.950000,36.180000],[-77.970000,36.190000],[-77.970000,36.180000], [-77.980000,36.180000],[-78.010000,36.210000],[-78.040000,36.210000],[-78.110000,36.210000],[-78.130000,36.230000], [-78.350000,35.940000],[-78.450000,35.820000]]]}", "description": "FFWRAH\n\nThe National Weather Service in Raleigh has issued a\n\n* Flash Flood Warning for... \nEastern Franklin County in central North Carolina...\nNorth Central Johnston County in central North Carolina... \nWestern Nash County in central North Carolina...\nEast Central Wake County in central North Carolina... \n\n* Until 530 PM EDT.\n\n* At 224 PM EDT, local law enforcement reported flash flooding in\nSpring Hope. Between 3 and 5 inches of rain have fallen. \nAdditional rainfall amounts of 1 to 3 inches are possible in the\nwarned area.\n\nHAZARD...Life threatening flash flooding. Heavy rain producing\nflash flooding.\n\nSOURCE...Law enforcement reported.\n\nIMPACT...Life threatening flash flooding of creeks and streams,\nurban areas, highways, streets and underpasses.\n\n* Some locations that will experience flash flooding include... \nZebulon, Bunn, Wendell, Spring Hope, Middlesex, Castalia,\nCenterville, Pilot, Emit and Aventon.", "severity": "SEVERE", "certainty": "LIKELY", "urgency": "IMMEDIATE", "instruction": [ "Turn around, don't drown when encountering flooded roads. Most flood\ndeaths occur in vehicles." ], "safetyRecommendations": [ { "directive": "Build an emergency kit and make a family communications plan.", "subtext": "Follow the instructions at http://www.ready.gov/build-a-kit for building an emergency kit and http://www.ready.gov/make-a-plan for a family communications plan." }, { "directive": "Be aware that flash flooding can occur. ", "subtext": "If there is any possibility of a flash flood, move immediately to higher ground. Do not wait for instructions to move." }, ... ], "timezoneOffset": "-14400s", "startTime": "2025-08-06T18:24:00Z", "expirationTime": "2025-08-06T21:30:00Z", "dataSource": { "publisher": "NOAA", "name": "National Weather Service", "authorityUri": "https://www.weather.gov/" } } ], "regionCode": "US" }
Deneyin.
API Gezgini, API ve API seçeneklerine alışabilmeniz için örnek istekler göndermenize olanak tanır.
Sayfanın sağ tarafındaki API simgesini api seçin.
İsteğe bağlı olarak istek parametrelerini düzenleyin.
Yürüt düğmesini seçin. İletişim kutusunda, isteği göndermek için kullanmak istediğiniz hesabı seçin.
API Gezgini penceresini genişletmek için API Gezgini panelinde tam ekran simgesini fullscreen seçin.