Hava durumu uyarıları alma

publicAlerts uç noktası, yetkili ulusal ve uluslararası kurumlar tarafından yayınlanan belirli hava durumu olaylarıyla ilgili uyarıların ayrıntılarını sağlar. Bu uyarılar, hayat kurtarabilecek önemli bilgiler verir.

Uç nokta, belirli bir enlem ve boylam için gerçek zamanlı 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, don, rüzgar soğuğu 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: Seller, tsunamiler, fırtına dalgaları, kıyı tehlikeleri ve daha fazlası
• Jeofiziksel ve jeolojik olaylar: Depremler, heyelanlar 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 bölümüne bakın.

Uyarılar, veri kaynağında mevcut olan 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ısı kaynakları hakkında daha fazla bilgi için Veri kaynakları bölümüne bakın.

API, belirli bir hava durumu uyarısı için aşağıdaki bilgileri döndürür:

• Uyarıyla ilişkili hava durumu olayının türü
• Etkilenen bölgelerin listesi ve bu bölgelerin coğrafi sınırlarını tanımlayan koordinatlar
• Hava durumu olayının tek cümlelik özeti
• Önem, kesinlik ve aciliyet düzeyleri
• Hedef kitle için işlem önerisi talimatlarının açıklaması
• Güvenlik önerileri
• Uyarının başlangıç ve bitiş zamanları
• Yayınlayan yetkilinin adı ve web sitesi

API Gezgini, API ve API seçeneklerini tanıyabilmeniz için canlı istekler göndermenize olanak tanır:

Hava durumu uyarısı istekleri hakkında

Hava durumu uyarısı bilgilerini 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ısı yanıtları hakkında

Weather API, yanıt gövdesinde aşağıdaki alanları döndürür:

Veri kaynakları

Hava durumu uyarıları uç noktası, aşağıdaki tabloda listelenen sağlayıcı girişleri tarafından yayınlanan verileri döndürür. İstekte sağlanan enlem ve boylam koordinatlarına göre yanıt gövdesi, uygun yerel yetkiliden gelen verileri gösterir.

Feed'e dahil edilen sağlayıcılar Google'ın Kamu Uyarıları yönergelerine uyar. Google, sağlayıcı listesini dilediği zaman güncelleyebilir.

İlişkilendirme

Müşteri uygulaması, verilerin sunulduğu tüm ekranlarda dataSource alanını kullanarak orijinal kaynağa atıfta bulunmalıdır:

"dataSource": {
        "publisher": "NOAA",
        "name": "National Weather Service",
        "authorityUri": "https://www.weather.gov/"
      }

Atıf, veri kaynağının tam adını (name alanında belirtildiği şekilde) ve authorityUri alanında belirtilen URL'yi kullanarak veri kaynağına yönlendiren köprüyü (ör. "Ulusal Hava Durumu Hizmeti") içermelidir.

Hava durumu etkinliği türleri

Aşağıdaki hava durumu etkinliği türleri desteklenir:

Yanıt çeviri davranışı

Google, yalnızca alertTitle alanı için çeviri sağlar. Orijinal veri kaynağının dil desteğine bağlı olarak eventType, areaName, instruction ve safetyRecommendations gibi diğer alanlar da çevrilebilir ancak Google bu alanlar için bağımsız çeviriler sağlayamaz.

İstekte yer alan languageCode parametresine bağlı olarak alertTitle alanı için aşağıdaki davranışlar beklenir:

• Destekleniyor languageCode: İstenen languageCode hem sağlanıyor hem de destekleniyorsa yanıt, istenen dilde döndürülür.
• Desteklenmiyor languageCode: İstenen languageCode desteklenmiyorsa ve yakın bir alternatif bulunamıyorsa uç nokta, yanıtı varsayılan olarak İngilizce döndürür.
• languageCode sağ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 Karolina'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 gövdesi 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çeneklerini tanıyabilmeniz için örnek istekler göndermenize olanak tanır.

1. Sayfanın sağ tarafındaki API simgesini api seçin.

2. İsterseniz istek parametrelerini düzenleyebilirsiniz.

3. Execute (Yürüt) düğmesini seçin. İletişim kutusunda, isteği göndermek için kullanmak istediğiniz hesabı seçin.

4. API Gezgini panelinde, API Gezgini penceresini genişletmek için tam ekran simgesini fullscreen seçin.