Method: publicAlerts.lookup

Trả về cảnh báo thời tiết công khai cho một vị trí cụ thể.

Yêu cầu HTTP

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

URL sử dụng cú pháp Chuyển mã gRPC.

Tham số truy vấn

Thông số
location

object (LatLng)

Bắt buộc. Vị trí mà bạn muốn nhận cảnh báo thời tiết công khai. Dịch vụ này sẽ trả về những cảnh báo có khu vực bị ảnh hưởng trùng với vị trí này.
pageSize

integer

Không bắt buộc. Số lượng tối đa các bản ghi cảnh báo thời tiết công khai cần trả về trên mỗi trang.
pageToken

string

Không bắt buộc. Mã thông báo trang nhận được từ một lệnh gọi publicAlerts.lookup trước đó. Cung cấp thông tin này để truy xuất trang tiếp theo. Khi phân trang, tất cả các tham số khác được cung cấp cho publicAlerts.lookup phải khớp với lệnh gọi đã cung cấp mã thông báo trang.
languageCode

string

Không bắt buộc. Cho phép ứng dụng chọn ngôn ngữ cho câu trả lời. Nếu không thể cung cấp dữ liệu cho ngôn ngữ đó, API sẽ sử dụng ngôn ngữ phù hợp nhất. Các giá trị được phép dựa trên tiêu chuẩn IETF BCP-47. Giá trị mặc định là "en".

Nội dung yêu cầu

Nội dung yêu cầu phải trống.

Nội dung phản hồi

Phản hồi cho RPC publicAlerts.lookup.

Nếu thành công, phần nội dung phản hồi sẽ chứa dữ liệu có cấu trúc sau:

Biểu diễn dưới dạng JSON 
{
  "weatherAlerts": [
    {
      object (PublicAlerts)
    }
  ],
  "regionCode": string,
  "nextPageToken": string
}
Trường
weatherAlerts[]

object (PublicAlerts)

Các bản ghi cảnh báo thời tiết công khai, theo số lượng cảnh báo và kích thước trang được chỉ định trong yêu cầu.
regionCode

string

Mã ISO_3166-1 alpha-2 của khu vực tương ứng với vị trí được cung cấp trong yêu cầu. Khu vực được nêu bằng ISO_3166-1_alpha-2.
nextPageToken

string

Một mã thông báo có thể được gửi dưới dạng pageToken để truy xuất trang tiếp theo. Nếu bạn bỏ qua trường này, thì sẽ không có trang tiếp theo.

Phạm vi uỷ quyền

Yêu cầu phạm vi OAuth sau:

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

PublicAlerts

Biểu thị cảnh báo thời tiết công khai.

Biểu diễn dưới dạng 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)
}
Trường
alertId

string

Giá trị nhận dạng riêng biệt của cảnh báo này.
alertTitle

object (LocalizedText)

Tiêu đề đã bản địa hoá của cảnh báo.
eventType

enum (WeatherEventType)

Loại sự kiện thời tiết.
areaName

string

Tên của khu vực nơi phát cảnh báo.
instruction[]

string

Hướng dẫn do nhà xuất bản đề xuất. Xin lưu ý rằng mặc dù trường này phải được bản địa hoá, nhưng không có gì đảm bảo rằng trường này sẽ được bản địa hoá.
safetyRecommendations[]

object (SafetyRecommendation)

Chỉ thị về các đề xuất an toàn cho người dùng, những chỉ thị này có thể do nhà xuất bản hoặc các cơ quan khác cung cấp.
timezoneOffset

string

Độ lệch múi giờ so với giờ UTC cho vị trí của cảnh báo. Giá trị này được định dạng dưới dạng một chuỗi kết thúc bằng "s", ví dụ: "-14400s" cho 4 giờ sau giờ UTC.
startTime

string (Timestamp format)

Thời gian bắt đầu sự kiện.

Hãy dùng RFC 3339, trong đó dữ liệu đầu ra được tạo sẽ luôn được chuẩn hoá theo múi giờ và sử dụng 0, 3, 6 hoặc 9 chữ số thập phân. Các khoảng lệch khác ngoài "Z" cũng được chấp nhận. Ví dụ: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" hoặc "2014-10-02T15:01:23+05:30".
expirationTime

string (Timestamp format)

Thời gian hết hạn của sự kiện.

Hãy dùng RFC 3339, trong đó dữ liệu đầu ra được tạo sẽ luôn được chuẩn hoá theo múi giờ và sử dụng 0, 3, 6 hoặc 9 chữ số thập phân. Các khoảng lệch khác ngoài "Z" cũng được chấp nhận. Ví dụ: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" hoặc "2014-10-02T15:01:23+05:30".
dataSource

object (DataSource)

Thông tin chi tiết về nhà xuất bản đã đưa ra cảnh báo.
polygon

string

Một biểu diễn GeoJSON của các khu vực nơi cảnh báo được đưa ra.

Dữ liệu GeoJSON phải ở định dạng RFC 7946 và thể hiện một Đa giác (cho một khu vực liền kề duy nhất) hoặc một Đa giác (cho nhiều khu vực riêng biệt).

Ví dụ:

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

Chuỗi GeoJson MultiPolygon mẫu có dạng như sau:

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

string

Văn bản mới nhất mô tả cảnh báo do cơ quan chính thức đưa ra. Xin lưu ý rằng mặc dù trường này phải được bản địa hoá, nhưng không có gì đảm bảo rằng trường này sẽ được bản địa hoá.
severity

enum (Severity)

Mức độ nghiêm trọng của cảnh báo.
certainty

enum (Certainty)

Độ chắc chắn của cảnh báo.
urgency

enum (Urgency)

Mức độ khẩn cấp của cảnh báo.

WeatherEventType

Loại sự kiện thời tiết.

Enum
WEATHER_EVENT_TYPE_UNSPECIFIED Loại sự kiện thời tiết chưa được chỉ định.
ACID_RAIN Sự kiện mưa axit.
AFTERSHOCK Sự kiện dư chấn.
AVALANCHE Sự kiện Avalanche.
BLIZZARD Sự kiện bão tuyết.
BLOWING_SNOW Hiện tượng tuyết thổi.
BUSHFIRE Sự kiện cháy rừng.
COASTAL_FLOOD Sự kiện lũ lụt ven biển.
COASTAL_HAZARD Sự kiện nguy hiểm ven biển.
COLD Sự kiện lạnh.
CYCLONE Sự kiện lốc xoáy.
DROUGHT Sự kiện hạn hán.
DUST_STORM Trận bão bụi.
EARTHQUAKE Sự kiện động đất.
EXTRATROPICAL_CYCLONE Sự kiện bão xoáy ngoài vùng nhiệt đới.
FIRE Sự kiện Fire.
FIRE_WEATHER Sự kiện thời tiết gây cháy.
FLASH_FLOOD Sự kiện lũ quét.
FLOOD Sự kiện lũ lụt.
FOG Sự kiện sương mù.
FREEZING Sự kiện bị treo.
FREEZING_AIR_TEMPERATURE Sự kiện nhiệt độ không khí đóng băng.
FREEZING_DRIZZLE Sự kiện mưa phùn băng.
FREEZING_RAIN_EVENT Hiện tượng mưa băng giá.
FROST Sự kiện sương giá.
GALE Sự kiện gió giật.
GLAZE Sự kiện Glaze.
HAIL Sự kiện mưa đá.
HAZARDOUS_SEAS Sự kiện nguy hiểm trên biển.
HEAT Sự kiện nhiệt.
HUMIDITY Sự kiện độ ẩm.
HURRICANE Sự kiện bão.
ICE_STORM Sự kiện bão băng.
INDUSTRIAL_FIRE Sự kiện hỏa hoạn công nghiệp.
LAKE_EFFECT_SNOW Sự kiện tuyết rơi do hiệu ứng hồ.
LANDSLIDE Sự kiện lở đất.
MONSOON Sự kiện gió mùa.
MUDDY_FLOOD Trận lũ lụt có nhiều bùn.
OUTFLOW Sự kiện dòng chảy ra.
RADIATION Sự kiện bức xạ.
RAIN_EVENT Sự kiện mưa.
RIVER_FLOODING Sự kiện lũ lụt trên sông.
SEVERE_THUNDERSTORM_WARNING Cảnh báo dông dữ dội.
SNOWSQUALL Sự kiện bão tuyết.
SNOW_EVENT Sự kiện tuyết.
STORM Sự kiện bão.
STORM_SURGE Sự kiện nước dâng do bão.
THUNDER Sự kiện sấm sét.
THUNDERSTORM Sự kiện bão có sấm sét.
TORNADO Sự kiện lốc xoáy.
TORNADO_WARNING Sự kiện cảnh báo lốc xoáy.
TROPICAL_CYCLONE Sự kiện bão xoáy nhiệt đới.
TROPICAL_CYCLONE_WARNINGS_AND_WATCHES Sự kiện cảnh báo và theo dõi bão xoáy nhiệt đới.
TROPICAL_DISTURBANCE Sự kiện vùng nhiễu động nhiệt đới.
TROPICAL_STORM Bão nhiệt đới.
TSUNAMI Sự kiện sóng thần.
TYPHOON Sự kiện bão.
VOLCANIC_ASH Sự kiện tro núi lửa.
VOLCANIC_ERUPTION Sự kiện núi lửa phun trào.
WILDFIRE Sự kiện cháy rừng.
WIND Sự kiện gió.
WIND_CHILL Sự kiện gió lạnh.
WIND_WAVE Sự kiện sóng gió.
WINTER_STORM Sự kiện bão mùa đông.

Mức độ nghiêm trọng

Mã biểu thị mức độ nghiêm trọng của sự kiện liên quan trong thông báo cảnh báo.

Enum
SEVERITY_UNKNOWN Không xác định được mức độ nghiêm trọng.
EXTREME Mối đe doạ đặc biệt nghiêm trọng đến tính mạng hoặc tài sản.
SEVERE Mối đe doạ nghiêm trọng đến tính mạng hoặc tài sản.
MODERATE Có thể đe doạ đến tính mạng hoặc tài sản.
MINOR Mối đe doạ nhỏ đối với tính mạng hoặc tài sản.

Độ chắc chắn

Mã biểu thị mức độ chắc chắn của sự kiện chủ đề trong thông báo cảnh báo.

Enum
CERTAINTY_UNKNOWN Không xác định được mức độ chắc chắn.
OBSERVED Được xác định là đã xảy ra hoặc đang diễn ra.
VERY_LIKELY Rất có thể.
LIKELY Có khả năng (p > ~50%).
POSSIBLE Có thể nhưng không chắc (p <= ~50%).
UNLIKELY Không có khả năng (p ~ 0%).

Khẩn cấp

Mã biểu thị mức độ khẩn cấp của sự kiện chủ đề trong thông báo cảnh báo.

Enum
URGENCY_UNKNOWN Không xác định được mức độ khẩn cấp.
IMMEDIATE Bạn NÊN hành động ngay lập tức.
EXPECTED Bạn NÊN sớm thực hiện hành động phản hồi (trong vòng một giờ tới).
FUTURE Bạn NÊN thực hiện hành động phản hồi trong thời gian tới.
PAST Bạn không cần phải làm gì cả.

SafetyRecommendation

Biểu thị một đề xuất về an toàn.

Biểu diễn dưới dạng JSON 
{
  "directive": string,
  "subtext": string
}
Trường
directive

string

Một chỉ thị cho người dùng. Xin lưu ý rằng mặc dù trường này phải được bản địa hoá, nhưng không có gì đảm bảo rằng trường này sẽ được bản địa hoá.
subtext

string

Một phụ đề không bắt buộc cho chỉ thị, có thể chứa thêm ngữ cảnh cho người dùng. Xin lưu ý rằng mặc dù trường này phải được bản địa hoá, nhưng không có gì đảm bảo rằng trường này sẽ được bản địa hoá.

DataSource

Biểu thị một đường liên kết đến nguồn dữ liệu.

Biểu diễn dưới dạng JSON 
{
  "publisher": enum (Publisher),
  "name": string,
  "authorityUri": string
}
Trường
publisher

enum (Publisher)

Nhà xuất bản của cảnh báo.
name

string

Tên chính thức của nhà xuất bản. Xin lưu ý rằng mặc dù trường này phải được bản địa hoá, nhưng không có gì đảm bảo rằng trường này sẽ được bản địa hoá.
authorityUri

string

URL của trang web của cơ quan này.

Nhà xuất bản

Nhà xuất bản của cảnh báo.

Enum
PUBLISHER_UNSPECIFIED Nhà xuất bản không xác định.
AUSTRALIA_ACT_ESA Úc, Lãnh thổ Thủ đô Úc
AUSTRALIA_NSW_RFS New South Wales
AUSTRALIA_QLD_QFES Queensland
AUSTRALIA_SA_CFS Nam Úc
METEO_ALARM_AT Meteoalarm / EUMETNET Áo
METEO_ALARM_BS Bosnia
BRAZIL_CENAD Cơ quan quản lý thiên tai của Brazil
BRAZIL_INMET Cơ quan khí tượng ở Brazil
UK_ENV_AGENCY Vương quốc Anh
METEO_ALARM_BG Meteoalarm / EUMETNET Bulgaria
METEO_ALARM_CR Croatia
METEO_ALARM_CY Síp
METEO_ALARM_CS Cộng hoà Séc
METEO_ALARM_DK Đan Mạch
EC_INAMHI Ecuador
METEO_ALARM_FI Meteoalarm / EUMETNET Phần Lan
METEO_ALARM_FR Pháp
DE_DWD Đức
METEO_ALARM_GB Meteoalarm / EUMETNET Vương quốc Anh
METEO_ALARM_GR Hy Lạp
METEO_ALARM_HU Hungary
METEO_ALARM_IS Iceland
METEO_ALARM_IE Ireland
METEO_ALARM_IT Italy
JM_JMS Jamaica
JMA Nhật Bản
METEO_ALARM_NL Meteoalarm / EUMETNET Hà Lan
METEO_ALARM_LV Latvia
METEO_ALARM_LT Lithuania
METEO_ALARM_LU Luxembourg
MEXICO_CIRES Mexico Mexico CIRES
NZ_GEONET New Zealand New Zealand GeoNet
NZ_NMS MetService
METEO_ALARM_MK Meteoalarm / EUMETNET Bắc Macedonia
METEO_ALARM_NO Na Uy
PHILIPPINES_PAGASA Philippines
METEO_ALARM_PL Meteoalarm / EUMETNET Ba Lan
METEO_ALARM_PT Bồ Đào Nha
METEO_ALARM_RO Romania
METEO_ALARM_RS Serbia
SG_MSS Singapore
METEO_ALARM_SK Meteoalarm / EUMETNET Slovakia
METEO_ALARM_SI Slovenia
SB_MET Quần đảo Solomon
METEO_ALARM_ES Meteoalarm / EUMETNET Tây Ban Nha
METEO_ALARM_SE Thuỵ Điển
METEO_ALARM_CH Thuỵ Sĩ
TAIWAN_NCDR Đài Loan
NOAA NOAA của Hoa Kỳ
WCATWC Trung tâm Cảnh báo sóng thần quốc gia