Method: publicAlerts.lookup

Belirli bir konum için herkese açık hava durumu uyarılarını döndürür.

HTTP isteği

GET https://weather.googleapis.com/v1/publicAlerts:lookup

URL, gRPC Kod Dönüştürme söz dizimini kullanır.

Sorgu parametreleri

Parametreler
location

object (LatLng)

Zorunlu. Herkese açık hava durumu uyarılarının alınacağı konum. Hizmet, etkilenen alanı bu konumla kesişen uyarıları döndürür.
pageSize

integer

İsteğe bağlıdır. Sayfa başına döndürülecek maksimum kamuya açık hava durumu uyarısı kaydı sayısı.
pageToken

string

İsteğe bağlıdır. Önceki bir publicAlerts.lookup çağrısından alınan sayfa jetonu. Sonraki sayfayı almak için bunu sağlayın. Sayfalara ayırma işlemi yapılırken publicAlerts.lookup öğesine sağlanan diğer tüm parametreler, sayfa jetonunu sağlayan çağrıyla eşleşmelidir.
languageCode

string

İsteğe bağlıdır. İstemcinin yanıtın dilini seçmesine olanak tanır. Bu dil için veri sağlanamıyorsa API, en yakın eşleşmeyi kullanır. İzin verilen değerler IETF BCP-47 standardına dayanır. Varsayılan değer "en"dir.

İstek metni

İstek metni boş olmalıdır.

Yanıt metni

publicAlerts.lookup RPC'nin yanıtı.

Başarılı olursa yanıt metni aşağıdaki yapıyla birlikte verileri içerir:

JSON gösterimi 
{
  "weatherAlerts": [
    {
      object (PublicAlerts)
    }
  ],
  "regionCode": string,
  "nextPageToken": string
}
Alanlar
weatherAlerts[]

object (PublicAlerts)

İstekte belirtilen uyarı sayısına ve sayfa boyutuna göre herkese açık hava durumu uyarı kayıtları.
regionCode

string

İstekte belirtilen konuma karşılık gelen bölgenin ISO_3166-1 alfa-2 kodu. Bölge, ISO_3166-1_alpha-2 kullanılarak belirtilir.
nextPageToken

string

Sonraki sayfayı almak için pageToken olarak gönderilebilen bir jeton. Bu alan atlanırsa sonraki sayfa yoktur.

Yetkilendirme kapsamları

Aşağıdaki OAuth kapsamını gerektirir:

  • https://www.googleapis.com/auth/cloud-platform

PublicAlerts

Herkese açık hava durumu uyarılarını gösterir.

JSON gösterimi 
{
  "alertId": string,
  "alertTitle": {
    object (LocalizedText)
  },
  "eventType": enum (WeatherEventType),
  "areaName": string,
  "instruction": [
    string
  ],
  "safetyRecommendations": [
    {
      object (SafetyRecommendation)
    }
  ],
  "timezoneOffset": string,
  "startTime": string,
  "expirationTime": string,
  "dataSource": {
    object (DataSource)
  },
  "polygon": string,
  "description": string,
  "severity": enum (Severity),
  "certainty": enum (Certainty),
  "urgency": enum (Urgency)
}
Alanlar
alertId

string

Bu uyarı için benzersiz tanımlayıcı.
alertTitle

object (LocalizedText)

Uyarının yerelleştirilmiş başlığı.
eventType

enum (WeatherEventType)

Hava durumu etkinliğinin türü.
areaName

string

Uyarının yayınlandığı bölgenin adı.
instruction[]

string

Yayıncının önerdiği talimatlar. Bu alanın yerelleştirilmesi gerektiğini ancak bunun garanti edilmediğini lütfen unutmayın.
safetyRecommendations[]

object (SafetyRecommendation)

Kullanıcıya yönelik güvenlik önerileri (Yayıncı veya diğer yetkililer tarafından sağlanabilir.)
timezoneOffset

string

Uyarının konumunun UTC'ye göre saat dilimi farkı. Değer, "s" ile biten bir dize olarak biçimlendirilir. Örneğin: UTC'den 4 saat geride için "-14400s".
startTime

string (Timestamp format)

Etkinliğin başlangıç saati.

Zaman damgasında RFC 3339 kullanılır. Yani oluşturulan çıkış her zaman Z ile normalleştirilir ve 0, 3, 6 veya 9 kesirli basamak kullanılır. "Z" dışındaki zaman farkları da kabul edilir. Örnekler: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" veya "2014-10-02T15:01:23+05:30".
expirationTime

string (Timestamp format)

Etkinliğin geçerlilik bitiş zamanı.

Zaman damgasında RFC 3339 kullanılır. Yani oluşturulan çıkış her zaman Z ile normalleştirilir ve 0, 3, 6 veya 9 kesirli basamak kullanılır. "Z" dışındaki zaman farkları da kabul edilir. Örnekler: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" veya "2014-10-02T15:01:23+05:30".
dataSource

object (DataSource)

Uyarıyı yayınlayan yayıncının ayrıntıları.
polygon

string

Uyarının verildiği alanların GeoJSON gösterimi.

GeoJSON verileri RFC 7946 biçiminde olmalı ve Polygon (tek bir bitişik alan için) veya MultiPolygon'u (birden fazla ayrı alan için) temsil etmelidir.

Örnek:

{ "type": "Polygon", "coordinates": [ [ [-1, -1], [-1, 0], [0, 0], [-1, -1] ] ] }

Örnek bir MultiPolygon GeoJson dizesi şu şekilde görünür:

{ "type": "MultiPolygon", "coordinates": [ [ [0, 0], [-1, 0], [-1, 1], [0, 0] ], [ [0, 0], [-2, 0], [-2, 2], [0, 0] ] ]
description

string

Resmi makam tarafından yayınlanan uyarıyı açıklayan en son metin. Bu alanın yerelleştirilmesi gerektiğini ancak bunun garanti edilmediğini lütfen unutmayın.
severity

enum (Severity)

Uyarının önem düzeyi.
certainty

enum (Certainty)

Uyarının kesinliği.
urgency

enum (Urgency)

Uyarının aciliyeti.

WeatherEventType

Hava durumu etkinliğinin türü.

Sıralamalar
WEATHER_EVENT_TYPE_UNSPECIFIED Belirtilmemiş hava durumu etkinliği türü.
ACID_RAIN Asit yağmuru olayı.
AFTERSHOCK Artçı sarsıntı etkinliği.
AVALANCHE Çığ olayı.
BLIZZARD Blizzard etkinliği.
BLOWING_SNOW Kar fırtınası
BUSHFIRE Orman yangını etkinliği.
COASTAL_FLOOD Kıyı bölgesi sel olayı.
COASTAL_HAZARD Kıyı şeridi tehlikesi olayı.
COLD Soğuk etkinlik.
CYCLONE Siklon olayı.
DROUGHT Kurutma etkinliği.
DUST_STORM Toz fırtınası
EARTHQUAKE Deprem etkinliği.
EXTRATROPICAL_CYCLONE Ekstra tropikal siklon olayı.
FIRE Etkinliği tetikler.
FIRE_WEATHER Yangın hava durumu olayı.
FLASH_FLOOD Ani sel olayı.
FLOOD Sel olayı.
FOG Sis etkinliği.
FREEZING Donma etkinliği.
FREEZING_AIR_TEMPERATURE Hava sıcaklığının donma noktasına düşmesi.
FREEZING_DRIZZLE Donan çisenti olayı.
FREEZING_RAIN_EVENT Donan yağmur olayı.
FROST Don olayı.
GALE Gale etkinliği.
GLAZE Sırlama etkinliği.
HAIL Dolu olayı.
HAZARDOUS_SEAS Tehlikeli deniz olayı
HEAT Isı olayı.
HUMIDITY Nem olayı.
HURRICANE Kasırga etkinliği.
ICE_STORM Buz fırtınası etkinliği.
INDUSTRIAL_FIRE Endüstriyel yangın olayı.
LAKE_EFFECT_SNOW Göl etkili kar yağışı.
LANDSLIDE Heyelan.
MONSOON Muson etkinliği.
MUDDY_FLOOD Çamurlu sel olayı.
OUTFLOW Çıkış etkinliği.
RADIATION Radyasyon olayı.
RAIN_EVENT Yağmur olayı.
RIVER_FLOODING Nehirde sel olayı.
SEVERE_THUNDERSTORM_WARNING Şiddetli gök gürültülü fırtına uyarısı etkinliği.
SNOWSQUALL Kar fırtınası etkinliği.
SNOW_EVENT Kar etkinliği.
STORM Fırtına olayı.
STORM_SURGE Fırtına kabarması olayı.
THUNDER Gök gürültüsü olayı.
THUNDERSTORM Gök gürültülü fırtına
TORNADO Hortum etkinliği.
TORNADO_WARNING Hortum uyarısı etkinliği.
TROPICAL_CYCLONE Tropikal siklon olayı.
TROPICAL_CYCLONE_WARNINGS_AND_WATCHES Tropikal siklon uyarıları ve gözlem etkinlikleri.
TROPICAL_DISTURBANCE Tropikal rahatsızlık olayı.
TROPICAL_STORM Tropikal fırtına olayı.
TSUNAMI Tsunami etkinliği.
TYPHOON Tayfun etkinliği.
VOLCANIC_ASH Volkanik kül olayı.
VOLCANIC_ERUPTION Yanardağ patlaması etkinliği.
WILDFIRE Orman yangını etkinliği.
WIND Rüzgar olayı.
WIND_CHILL Soğuk rüzgar olayı.
WIND_WAVE Rüzgar dalgası olayı.
WINTER_STORM Kış fırtınası etkinliği.

Önem derecesi

Uyarı mesajının konu etkinliğinin önem derecesini gösteren kod.

Sıralamalar
SEVERITY_UNKNOWN Önem düzeyi bilinmiyor.
EXTREME Cana veya mala karşı olağanüstü tehdit
SEVERE Cana veya mala yönelik ciddi tehdit
MODERATE Cana veya mala yönelik olası tehdit.
MINOR Cana veya mala yönelik küçük tehditler

Kesinlik

Uyarı mesajının konu etkinliğinin kesinliğini gösteren kod.

Sıralamalar
CERTAINTY_UNKNOWN Kesinlik bilinmiyor.
OBSERVED Gerçekleştiği veya devam ettiği belirlenmiş olmalıdır.
VERY_LIKELY Çok yüksek olasılık.
LIKELY Olası (p > ~%50).
POSSIBLE Olası ancak muhtemel değil (p <= ~%50).
UNLIKELY Düşük olasılık (p ~ %0).

Öncelik

Uyarı mesajının konu etkinliğinin aciliyetini gösteren kod.

Sıralamalar
URGENCY_UNKNOWN Aciliyet bilinmiyor.
IMMEDIATE Hemen yanıt verilmelidir.
EXPECTED Kısa süre içinde (önümüzdeki bir saat içinde) yanıt verilmelidir.
FUTURE Yakın gelecekte yanıt verilmelidir.
PAST Artık yanıt vermeniz gerekmiyor.

SafetyRecommendation

Güvenlik önerisini gösterir.

JSON gösterimi 
{
  "directive": string,
  "subtext": string
}
Alanlar
directive

string

Kullanıcıya yönelik bir talimat. Bu alanın yerelleştirilmesi gerektiğini ancak bunun garanti edilmediğini lütfen unutmayın.
subtext

string

Yönerge için isteğe bağlı bir alt metin. Bu metin, kullanıcıya ek bağlam bilgisi sağlayabilir. Bu alanın yerelleştirilmesi gerektiğini ancak bunun garanti edilmediğini lütfen unutmayın.

DataSource

Veri kaynağına giden bir bağlantıyı temsil eder.

JSON gösterimi 
{
  "publisher": enum (Publisher),
  "name": string,
  "authorityUri": string
}
Alanlar
publisher

enum (Publisher)

Uyarının yayıncısı.
name

string

Resmi yayıncı adı. Bu alanın yerelleştirilmesi gerektiğini ancak bunun garanti edilmediğini lütfen unutmayın.
authorityUri

string

Yetkilinin web sitesinin URL'si.

Yayıncı

Uyarının yayıncısı.

Sıralamalar
PUBLISHER_UNSPECIFIED Yayıncı belirtilmemiş.
AUSTRALIA_ACT_ESA Avustralya Avustralya Başkent Bölgesi
AUSTRALIA_NSW_RFS Yeni Güney Galler
AUSTRALIA_QLD_QFES Queensland
AUSTRALIA_SA_CFS Güney Avustralya
METEO_ALARM_AT Meteoalarm / EUMETNET Avusturya
METEO_ALARM_BS Bosna
BRAZIL_CENAD Brezilya'daki Brezilya Afet Ajansı
BRAZIL_INMET Brezilya'daki Meteoroloji Ajansı
UK_ENV_AGENCY İngiltere
METEO_ALARM_BG Meteoalarm / EUMETNET Bulgaristan
METEO_ALARM_CR Hırvatistan
METEO_ALARM_CY Güney Kıbrıs Rum Yönetimi
METEO_ALARM_CS Çekya
METEO_ALARM_DK Danimarka
EC_INAMHI Ekvador
METEO_ALARM_FI Meteoalarm / EUMETNET Finlandiya
METEO_ALARM_FR Fransa
DE_DWD Almanya
METEO_ALARM_GB Meteoalarm / EUMETNET Büyük Britanya
METEO_ALARM_GR Yunanistan
METEO_ALARM_HU Macaristan
METEO_ALARM_IS İzlanda
METEO_ALARM_IE İrlanda
METEO_ALARM_IT İtalya
JM_JMS Jamaika
JMA Japonya
METEO_ALARM_NL Meteoalarm / EUMETNET Netherlands
METEO_ALARM_LV Letonya
METEO_ALARM_LT Litvanya
METEO_ALARM_LU Lüksemburg
MEXICO_CIRES Meksika Meksika CIRES
NZ_GEONET Yeni Zelanda Yeni Zelanda GeoNet
NZ_NMS MetService
METEO_ALARM_MK Meteoalarm / EUMETNET Kuzey Makedonya
METEO_ALARM_NO Norveç
PHILIPPINES_PAGASA Filipinler
METEO_ALARM_PL Meteoalarm / EUMETNET Polonya
METEO_ALARM_PT Portekiz
METEO_ALARM_RO Romanya
METEO_ALARM_RS Sırbistan
SG_MSS Singapur
METEO_ALARM_SK Meteoalarm / EUMETNET Slovakya
METEO_ALARM_SI Slovenya
SB_MET Solomon Adaları
METEO_ALARM_ES Meteoalarm / EUMETNET İspanya
METEO_ALARM_SE İsveç
METEO_ALARM_CH İsviçre
TAIWAN_NCDR Tayvan
NOAA ABD NOAA
WCATWC Ulusal Tsunami Uyarı Merkezi