Method: publicAlerts.lookup

Menampilkan peringatan cuaca publik untuk lokasi tertentu.

Permintaan HTTP

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

URL ini menggunakan sintaksis gRPC Transcoding.

Parameter kueri

Parameter
location

object (LatLng)

Wajib. Lokasi untuk mendapatkan peringatan cuaca publik. Layanan ini akan menampilkan peringatan yang area terdampaknya beririsan dengan lokasi ini.
pageSize

integer

Opsional. Jumlah maksimum data peringatan cuaca publik yang akan ditampilkan per halaman.
pageToken

string

Opsional. Token halaman yang diterima dari panggilan publicAlerts.lookup sebelumnya. Berikan ini untuk mengambil halaman selanjutnya. Saat melakukan penomoran halaman, semua parameter lain yang disediakan untuk publicAlerts.lookup harus sesuai dengan panggilan yang memberikan token halaman.
languageCode

string

Opsional. Memungkinkan klien memilih bahasa untuk respons. Jika data tidak dapat disediakan untuk bahasa tersebut, API akan menggunakan kecocokan terdekat. Nilai yang diizinkan mengandalkan standar IETF BCP-47. Nilai defaultnya adalah "en".

Isi permintaan

Isi permintaan harus kosong.

Isi respons

Respons untuk RPC publicAlerts.lookup.

Jika berhasil, isi respons memuat data dengan struktur berikut:

Representasi JSON 
{
  "weatherAlerts": [
    {
      object (PublicAlerts)
    }
  ],
  "regionCode": string,
  "nextPageToken": string
}
Kolom
weatherAlerts[]

object (PublicAlerts)

Catatan peringatan cuaca publik, sesuai dengan jumlah peringatan dan ukuran halaman yang ditentukan dalam permintaan.
regionCode

string

Kode alpha-2 ISO_3166-1 wilayah yang sesuai dengan lokasi yang diberikan dalam permintaan. Wilayah dinyatakan menggunakan ISO_3166-1_alpha-2.
nextPageToken

string

Token yang dapat dikirim sebagai pageToken untuk mengambil halaman berikutnya. Jika kolom ini dihilangkan, tidak akan ada halaman berikutnya.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut:

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

PublicAlerts

Mewakili peringatan cuaca publik.

Representasi JSON 
{
  "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)
}
Kolom
alertId

string

ID unik untuk pemberitahuan ini.
alertTitle

object (LocalizedText)

Judul yang dilokalkan untuk notifikasi.
eventType

enum (WeatherEventType)

Jenis peristiwa cuaca.
areaName

string

Nama area tempat peringatan dikeluarkan.
instruction[]

string

Petunjuk yang direkomendasikan oleh penayang. Perhatikan bahwa meskipun kolom ini harus dilokalkan, tidak ada jaminan bahwa kolom ini akan dilokalkan.
safetyRecommendations[]

object (SafetyRecommendation)

Arahan rekomendasi keselamatan kepada pengguna, yang dapat diberikan oleh penayang atau otoritas lainnya.
timezoneOffset

string

Offset zona waktu dari UTC untuk lokasi notifikasi. Nilai diformat sebagai string yang diakhiri dengan 's', misalnya, "-14400s" untuk 4 jam di belakang UTC.
startTime

string (Timestamp format)

Waktu mulai acara.

Menggunakan RFC 3339 yang outputnya akan selalu dinormalisasi Z dan menggunakan 0, 3, 6, atau 9 digit pecahan. Offset selain "Z" juga diterima. Contoh: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z", atau "2014-10-02T15:01:23+05:30".
expirationTime

string (Timestamp format)

Waktu habis masa berlaku acara.

Menggunakan RFC 3339 yang outputnya akan selalu dinormalisasi Z dan menggunakan 0, 3, 6, atau 9 digit pecahan. Offset selain "Z" juga diterima. Contoh: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z", atau "2014-10-02T15:01:23+05:30".
dataSource

object (DataSource)

Detail penayang yang mengeluarkan pemberitahuan.
polygon

string

Representasi GeoJSON dari area tempat pemberitahuan dikeluarkan.

Data GeoJSON harus dalam format RFC 7946 dan merepresentasikan Poligon (untuk satu area yang berdekatan) atau MultiPoligon (untuk beberapa area yang berbeda).

Contoh:

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

Contoh string GeoJson MultiPolygon terlihat seperti:

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

string

Teks terbaru yang menjelaskan peringatan yang dikeluarkan oleh otoritas resmi. Perhatikan bahwa meskipun kolom ini harus dilokalkan, tidak ada jaminan bahwa kolom ini akan dilokalkan.
severity

enum (Severity)

Tingkat keparahan pemberitahuan.
certainty

enum (Certainty)

Kepastian pemberitahuan.
urgency

enum (Urgency)

Urgensi pemberitahuan.

WeatherEventType

Jenis peristiwa cuaca.

Enum
WEATHER_EVENT_TYPE_UNSPECIFIED Jenis peristiwa cuaca tidak ditentukan.
ACID_RAIN Peristiwa hujan asam.
AFTERSHOCK Peristiwa gempa susulan.
AVALANCHE Acara longsoran salju.
BLIZZARD Peristiwa badai salju.
BLOWING_SNOW Peristiwa embusan salju.
BUSHFIRE Peristiwa kebakaran hutan.
COASTAL_FLOOD Peristiwa banjir pesisir.
COASTAL_HAZARD Peristiwa bahaya pesisir.
COLD Peristiwa dingin.
CYCLONE Acara Cyclone.
DROUGHT Peristiwa kekeringan.
DUST_STORM Peristiwa badai debu.
EARTHQUAKE Peristiwa gempa bumi.
EXTRATROPICAL_CYCLONE Peristiwa siklon ekstratropis.
FIRE Peristiwa kebakaran.
FIRE_WEATHER Peristiwa cuaca kebakaran.
FLASH_FLOOD Peristiwa banjir bandang.
FLOOD Peristiwa banjir.
FOG Peristiwa kabut.
FREEZING Acara pembekuan.
FREEZING_AIR_TEMPERATURE Peristiwa suhu udara beku.
FREEZING_DRIZZLE Peristiwa gerimis beku.
FREEZING_RAIN_EVENT Peristiwa hujan beku.
FROST Peristiwa embun beku.
GALE Acara Gale.
GLAZE Acara glasir.
HAIL Peristiwa hujan es.
HAZARDOUS_SEAS Peristiwa laut berbahaya.
HEAT Peristiwa panas.
HUMIDITY Peristiwa kelembapan.
HURRICANE Peristiwa badai.
ICE_STORM Peristiwa badai es.
INDUSTRIAL_FIRE Peristiwa kebakaran industri.
LAKE_EFFECT_SNOW Peristiwa salju efek danau.
LANDSLIDE Peristiwa tanah longsor.
MONSOON Acara Monsoon.
MUDDY_FLOOD Bencana banjir berlumpur.
OUTFLOW Peristiwa keluar.
RADIATION Peristiwa radiasi.
RAIN_EVENT Peristiwa hujan.
RIVER_FLOODING Peristiwa banjir sungai.
SEVERE_THUNDERSTORM_WARNING Peristiwa peringatan badai petir parah.
SNOWSQUALL Peristiwa badai salju.
SNOW_EVENT Acara salju.
STORM Peristiwa badai.
STORM_SURGE Peristiwa gelombang badai.
THUNDER Peristiwa petir.
THUNDERSTORM Peristiwa badai petir.
TORNADO Peristiwa tornado.
TORNADO_WARNING Peristiwa peringatan tornado.
TROPICAL_CYCLONE Peristiwa siklon tropis.
TROPICAL_CYCLONE_WARNINGS_AND_WATCHES Acara peringatan dan pengamatan siklon tropis.
TROPICAL_DISTURBANCE Peristiwa gangguan cuaca tropis.
TROPICAL_STORM Peristiwa badai tropis.
TSUNAMI Peristiwa tsunami.
TYPHOON Peristiwa angin topan.
VOLCANIC_ASH Peristiwa abu vulkanis.
VOLCANIC_ERUPTION Peristiwa letusan gunung berapi.
WILDFIRE Peristiwa kebakaran hutan.
WIND Acara angin.
WIND_CHILL Peristiwa angin dingin.
WIND_WAVE Peristiwa gelombang angin.
WINTER_STORM Acara badai musim dingin.

Keparahan

Kode yang menunjukkan tingkat keparahan peristiwa subjek pesan pemberitahuan.

Enum
SEVERITY_UNKNOWN Tingkat keparahan tidak diketahui.
EXTREME Ancaman luar biasa terhadap nyawa atau properti.
SEVERE Ancaman signifikan terhadap nyawa atau properti.
MODERATE Kemungkinan ancaman terhadap nyawa atau properti.
MINOR Ancaman kecil terhadap nyawa atau properti.

Kepastian

Kode yang menunjukkan kepastian peristiwa subjek pesan pemberitahuan.

Enum
CERTAINTY_UNKNOWN Kepastian tidak diketahui.
OBSERVED Ditentukan telah terjadi atau sedang berlangsung.
VERY_LIKELY Sangat mungkin.
LIKELY Kemungkinan (p > ~50%).
POSSIBLE Mungkin, tetapi tidak mungkin (p <= ~50%).
UNLIKELY Tidak mungkin (p ~ 0%).

Urgensi

Kode yang menunjukkan urgensi peristiwa subjek pesan pemberitahuan.

Enum
URGENCY_UNKNOWN Urgensi tidak diketahui.
IMMEDIATE Tindakan responsif HARUS segera dilakukan.
EXPECTED Tindakan responsif HARUS segera dilakukan (dalam satu jam ke depan).
FUTURE Tindakan responsif HARUS dilakukan dalam waktu dekat.
PAST Tindakan responsif tidak lagi diperlukan.

SafetyRecommendation

Merepresentasikan rekomendasi keamanan.

Representasi JSON 
{
  "directive": string,
  "subtext": string
}
Kolom
directive

string

Arahan kepada pengguna. Perhatikan bahwa meskipun kolom ini harus dilokalkan, tidak ada jaminan bahwa kolom ini akan dilokalkan.
subtext

string

Subteks opsional untuk arahan, yang dapat berisi konteks tambahan bagi pengguna. Perhatikan bahwa meskipun kolom ini harus dilokalkan, tidak ada jaminan bahwa kolom ini akan dilokalkan.

DataSource

Menunjukkan link ke sumber data.

Representasi JSON 
{
  "publisher": enum (Publisher),
  "name": string,
  "authorityUri": string
}
Kolom
publisher

enum (Publisher)

Penerbit pemberitahuan.
name

string

Nama resmi penayang. Perhatikan bahwa meskipun kolom ini harus dilokalkan, tidak ada jaminan bahwa kolom ini akan dilokalkan.
authorityUri

string

URL situs otoritas.

Penerbit

Penerbit pemberitahuan.

Enum
PUBLISHER_UNSPECIFIED Penayang tidak ditentukan.
AUSTRALIA_ACT_ESA Australia Australian Capital Territory
AUSTRALIA_NSW_RFS New South Wales
AUSTRALIA_QLD_QFES Queensland
AUSTRALIA_SA_CFS South Australia
METEO_ALARM_AT Meteoalarm / EUMETNET Austria
METEO_ALARM_BS Bosnia
BRAZIL_CENAD Badan Penanggulangan Bencana Brasil di Brasil
BRAZIL_INMET Badan Meteorologi di Brasil
UK_ENV_AGENCY Inggris Raya
METEO_ALARM_BG Meteoalarm / EUMETNET Bulgaria
METEO_ALARM_CR Kroasia
METEO_ALARM_CY Siprus
METEO_ALARM_CS Ceko
METEO_ALARM_DK Denmark
EC_INAMHI Ekuador
METEO_ALARM_FI Meteoalarm / EUMETNET Finlandia
METEO_ALARM_FR Prancis
DE_DWD Jerman
METEO_ALARM_GB Meteoalarm / EUMETNET Britania Raya
METEO_ALARM_GR Yunani
METEO_ALARM_HU Hungaria
METEO_ALARM_IS Islandia
METEO_ALARM_IE Irlandia
METEO_ALARM_IT Italia
JM_JMS Jamaika
JMA Jepang
METEO_ALARM_NL Meteoalarm / EUMETNET Belanda
METEO_ALARM_LV Latvia
METEO_ALARM_LT Lituania
METEO_ALARM_LU Luksemburg
MEXICO_CIRES Meksiko Mexico CIRES
NZ_GEONET New Zealand GeoNet Selandia Baru
NZ_NMS MetService
METEO_ALARM_MK Meteoalarm / EUMETNET Makedonia Utara
METEO_ALARM_NO Norwegia
PHILIPPINES_PAGASA Filipina
METEO_ALARM_PL Meteoalarm / EUMETNET Polandia
METEO_ALARM_PT Portugal
METEO_ALARM_RO Rumania
METEO_ALARM_RS Serbia
SG_MSS Singapura
METEO_ALARM_SK Meteoalarm / EUMETNET Slovakia
METEO_ALARM_SI Slovenia
SB_MET Kepulauan Solomon
METEO_ALARM_ES Meteoalarm / EUMETNET Spanyol
METEO_ALARM_SE Swedia
METEO_ALARM_CH Swiss
TAIWAN_NCDR Taiwan
NOAA NOAA Amerika Serikat
WCATWC National Tsunami Warning Center