Method: publicAlerts.lookup

지정된 위치의 공개 날씨 알림을 반환합니다.

HTTP 요청

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

URL은 gRPC 트랜스코딩 구문을 사용합니다.

쿼리 매개변수

매개변수
location

object (LatLng)

필수 항목입니다. 공공 날씨 알림을 가져올 위치입니다. 서비스는 영향을 받는 지역이 이 위치와 교차하는 알림을 반환합니다.
pageSize

integer

선택사항입니다. 페이지당 반환할 최대 공개 날씨 알림 레코드 수입니다.
pageToken

string

선택사항입니다. 이전 publicAlerts.lookup 호출에서 수신한 페이지 토큰입니다. 후속 페이지를 검색하려면 이를 입력합니다. 페이지로 나누는 경우, publicAlerts.lookup에 제공하는 다른 모든 매개변수가 페이지 토큰을 제공한 호출과 일치해야 합니다.
languageCode

string

선택사항입니다. 클라이언트가 대답의 언어를 선택할 수 있습니다. 해당 언어의 데이터를 제공할 수 없는 경우 API는 가장 근접한 일치 항목을 사용합니다. 허용되는 값은 IETF BCP-47 표준을 따릅니다. 기본값은 'en'입니다.

요청 본문

요청 본문은 비어 있어야 합니다.

응답 본문

publicAlerts.lookup RPC의 응답입니다.

성공한 경우 응답 본문은 다음과 같은 구조의 데이터를 포함합니다.

JSON 표현 
{
  "weatherAlerts": [
    {
      object (PublicAlerts)
    }
  ],
  "regionCode": string,
  "nextPageToken": string
}
필드
weatherAlerts[]

object (PublicAlerts)

요청에 지정된 알림 수 및 페이지 크기에 따른 공개 날씨 알림 레코드입니다.
regionCode

string

요청에 제공된 위치에 해당하는 지역의 ISO_3166-1 alpha-2 코드입니다. 지역은 ISO_3166-1_alpha-2를 사용하여 명시됩니다.
nextPageToken

string

다음 페이지를 검색하기 위해 pageToken으로 전송할 수 있는 토큰입니다. 이 필드를 생략하면 후속 페이지가 표시되지 않습니다.

승인 범위

다음 OAuth 범위가 필요합니다.

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

PublicAlerts

공개 날씨 알림을 나타냅니다.

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)
}
필드
alertId

string

이 알림의 고유 식별자입니다.
alertTitle

object (LocalizedText)

알림의 현지화된 제목입니다.
eventType

enum (WeatherEventType)

날씨 이벤트 유형입니다.
areaName

string

알림이 발송된 지역의 이름입니다.
instruction[]

string

게시자가 추천하는 안내입니다. 이 필드는 현지화되어야 하지만 현지화가 보장되지는 않습니다.
safetyRecommendations[]

object (SafetyRecommendation)

사용자에게 제공되는 안전 권장사항 지침입니다. 게시자 또는 기타 기관에서 제공할 수 있습니다.
timezoneOffset

string

알림 위치의 UTC 시간대 오프셋입니다. 값은 's'로 끝나는 문자열로 형식이 지정됩니다(예: UTC보다 4시간 늦은 경우 '-14400s'
startTime

string (Timestamp format)

이벤트의 시작 시간입니다.

생성된 출력은 항상 Z-정규화되고 소수점 이하 0, 3, 6 또는 9자리인 RFC 3339를 사용합니다. 'Z' 이외의 오프셋도 허용됩니다. 예를 들면 "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" 또는 "2014-10-02T15:01:23+05:30"입니다.
expirationTime

string (Timestamp format)

이벤트의 만료 시간입니다.

생성된 출력은 항상 Z-정규화되고 소수점 이하 0, 3, 6 또는 9자리인 RFC 3339를 사용합니다. 'Z' 이외의 오프셋도 허용됩니다. 예를 들면 "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" 또는 "2014-10-02T15:01:23+05:30"입니다.
dataSource

object (DataSource)

알림을 발행한 게시자의 세부정보입니다.
polygon

string

알림이 발령된 지역의 GeoJSON 표현입니다.

GeoJSON 데이터는 RFC 7946 형식이어야 하며 다각형 (단일 연속 영역) 또는 MultiPolygon (여러 개별 영역)을 나타내야 합니다.

예:

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

샘플 MultiPolygon GeoJson 문자열은 다음과 같습니다.

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

string

공식 기관에서 발급한 알림을 설명하는 최신 텍스트입니다. 이 필드는 현지화되어야 하지만 현지화가 보장되지는 않습니다.
severity

enum (Severity)

알림의 심각도 수준입니다.
certainty

enum (Certainty)

알림의 확실성입니다.
urgency

enum (Urgency)

알림의 긴급성입니다.

WeatherEventType

날씨 이벤트의 유형입니다.

열거형
WEATHER_EVENT_TYPE_UNSPECIFIED 지정되지 않은 날씨 이벤트 유형입니다.
ACID_RAIN 산성비 이벤트입니다.
AFTERSHOCK 여진 이벤트입니다.
AVALANCHE 눈사태 이벤트입니다.
BLIZZARD 블리자드 이벤트입니다.
BLOWING_SNOW 눈보라 이벤트입니다.
BUSHFIRE 산불 이벤트입니다.
COASTAL_FLOOD 해안 침수 상황
COASTAL_HAZARD 해안 위험 이벤트입니다.
COLD 콜드 이벤트입니다.
CYCLONE 사이클론 이벤트입니다.
DROUGHT 가뭄 이벤트입니다.
DUST_STORM 모래 폭풍 이벤트입니다.
EARTHQUAKE 지진 이벤트입니다.
EXTRATROPICAL_CYCLONE 열대성 저기압 외 이벤트입니다.
FIRE 이벤트를 실행합니다.
FIRE_WEATHER 화재 기상 이벤트입니다.
FLASH_FLOOD 돌발 홍수 상황입니다.
FLOOD 홍수 발생
FOG 안개 이벤트입니다.
FREEZING 멈춤 이벤트입니다.
FREEZING_AIR_TEMPERATURE 기온이 영하로 내려가는 이벤트입니다.
FREEZING_DRIZZLE 진눈깨비 이벤트입니다.
FREEZING_RAIN_EVENT 우빙 이벤트입니다.
FROST 서리 이벤트입니다.
GALE 강풍 이벤트입니다.
GLAZE 글레이즈 이벤트입니다.
HAIL 우박 이벤트입니다.
HAZARDOUS_SEAS 위험한 해상 이벤트입니다.
HEAT 열 이벤트입니다.
HUMIDITY 습도 이벤트입니다.
HURRICANE 허리케인 이벤트입니다.
ICE_STORM 얼음 폭풍 이벤트입니다.
INDUSTRIAL_FIRE 산업 화재 이벤트입니다.
LAKE_EFFECT_SNOW 호수 효과 눈 이벤트입니다.
LANDSLIDE 산사태 이벤트입니다.
MONSOON 몬순 이벤트
MUDDY_FLOOD 진흙탕 홍수 상황
OUTFLOW 유출 이벤트입니다.
RADIATION 방사선 이벤트입니다.
RAIN_EVENT 강우 이벤트입니다.
RIVER_FLOODING 강 홍수 상황입니다.
SEVERE_THUNDERSTORM_WARNING 심한 뇌우 경보 이벤트입니다.
SNOWSQUALL 눈보라 이벤트입니다.
SNOW_EVENT 눈 이벤트입니다.
STORM 폭풍 이벤트입니다.
STORM_SURGE 폭풍해일 이벤트입니다.
THUNDER 천둥 이벤트입니다.
THUNDERSTORM 뇌우 이벤트입니다.
TORNADO 토네이도 이벤트입니다.
TORNADO_WARNING 토네이도 경고 이벤트입니다.
TROPICAL_CYCLONE 열대성 사이클론 이벤트입니다.
TROPICAL_CYCLONE_WARNINGS_AND_WATCHES 열대성 사이클론 경보 및 주의보 이벤트입니다.
TROPICAL_DISTURBANCE 열대 요란 이벤트입니다.
TROPICAL_STORM 열대성 폭풍 이벤트입니다.
TSUNAMI 지진 해일 이벤트입니다.
TYPHOON 태풍 이벤트입니다.
VOLCANIC_ASH 화산재 이벤트입니다.
VOLCANIC_ERUPTION 화산 폭발 이벤트입니다.
WILDFIRE 산불 이벤트입니다.
WIND 바람 이벤트입니다.
WIND_CHILL 낮은 체감온도 이벤트입니다.
WIND_WAVE 풍랑 이벤트입니다.
WINTER_STORM 겨울 폭풍 이벤트입니다.

심각도

알림 메시지의 주제 이벤트의 심각도를 나타내는 코드입니다.

열거형
SEVERITY_UNKNOWN 심각도를 알 수 없습니다.
EXTREME 생명 또는 재산에 대한 심각한 위협
SEVERE 생명 또는 재산에 대한 심각한 위협
MODERATE 생명 또는 재산이 위태로울 수 있습니다.
MINOR 생명 또는 재산에 대한 경미한 위협

확실성

알림 메시지의 주제 이벤트의 확실성을 나타내는 코드입니다.

열거형
CERTAINTY_UNKNOWN 확실성을 알 수 없습니다.
OBSERVED 발생했거나 진행 중인 것으로 확인되었습니다.
VERY_LIKELY 그럴 가능성이 매우 높습니다.
LIKELY 가능성 높음 (p > ~50%)
POSSIBLE 가능하지만 가능성이 낮습니다 (p <= ~50%).
UNLIKELY 가능성이 낮음 (p ~ 0%).

긴급

알림 메시지의 주제 이벤트의 긴급성을 나타내는 코드입니다.

열거형
URGENCY_UNKNOWN 긴급성을 알 수 없습니다.
IMMEDIATE 대응 조치를 즉시 취해야 합니다(SHOULD).
EXPECTED 대응 조치를 곧(다음 시간 내) 취해야 합니다(SHOULD).
FUTURE 조치를 취해야 합니다(SHOULD).
PAST 대응 조치가 더 이상 필요하지 않습니다.

SafetyRecommendation

안전 권장사항을 나타냅니다.

JSON 표현 
{
  "directive": string,
  "subtext": string
}
필드
directive

string

사용자에게 지시합니다. 이 필드는 현지화되어야 하지만 현지화가 보장되지는 않습니다.
subtext

string

명령어의 선택적 부텍스트로, 사용자에게 추가 컨텍스트를 제공할 수 있습니다. 이 필드는 현지화되어야 하지만 현지화가 보장되지는 않습니다.

DataSource

데이터 소스 링크를 나타냅니다.

JSON 표현 
{
  "publisher": enum (Publisher),
  "name": string,
  "authorityUri": string
}
필드
publisher

enum (Publisher)

알림의 게시자입니다.
name

string

공식 게시자 이름입니다. 이 필드는 현지화되어야 하지만 현지화가 보장되지는 않습니다.
authorityUri

string

기관 웹사이트의 URL입니다.

게시자

알림의 게시자입니다.

열거형
PUBLISHER_UNSPECIFIED 게시자가 지정되지 않았습니다.
AUSTRALIA_ACT_ESA 오스트레일리아 오스트레일리아 수도 준주
AUSTRALIA_NSW_RFS 뉴사우스웨일스
AUSTRALIA_QLD_QFES 퀸즐랜드
AUSTRALIA_SA_CFS 사우스오스트레일리아
METEO_ALARM_AT Meteoalarm / EUMETNET 오스트리아
METEO_ALARM_BS 보스니아
BRAZIL_CENAD 브라질 재난 기관(브라질)
BRAZIL_INMET 브라질 기상청
UK_ENV_AGENCY 영국
METEO_ALARM_BG Meteoalarm / EUMETNET 불가리아
METEO_ALARM_CR 크로아티아
METEO_ALARM_CY 키프로스
METEO_ALARM_CS 체코
METEO_ALARM_DK 덴마크
EC_INAMHI 에콰도르
METEO_ALARM_FI Meteoalarm / EUMETNET 핀란드
METEO_ALARM_FR 프랑스
DE_DWD 독일
METEO_ALARM_GB Meteoalarm / EUMETNET 영국
METEO_ALARM_GR 그리스
METEO_ALARM_HU 헝가리
METEO_ALARM_IS 아이슬란드
METEO_ALARM_IE 아일랜드
METEO_ALARM_IT 이탈리아
JM_JMS 자메이카
JMA 일본
METEO_ALARM_NL Meteoalarm / EUMETNET 네덜란드
METEO_ALARM_LV 라트비아
METEO_ALARM_LT 리투아니아
METEO_ALARM_LU 룩셈부르크
MEXICO_CIRES 멕시코 멕시코 CIRES
NZ_GEONET 뉴질랜드 뉴질랜드 GeoNet
NZ_NMS MetService
METEO_ALARM_MK Meteoalarm / EUMETNET 북마케도니아
METEO_ALARM_NO 노르웨이
PHILIPPINES_PAGASA 필리핀
METEO_ALARM_PL Meteoalarm / EUMETNET 폴란드
METEO_ALARM_PT 포르투갈
METEO_ALARM_RO 루마니아
METEO_ALARM_RS 세르비아
SG_MSS 싱가포르
METEO_ALARM_SK Meteoalarm / EUMETNET 슬로바키아
METEO_ALARM_SI 슬로베니아
SB_MET 솔로몬 군도
METEO_ALARM_ES Meteoalarm / EUMETNET 스페인
METEO_ALARM_SE 스웨덴
METEO_ALARM_CH 스위스
TAIWAN_NCDR 대만
NOAA 미국 NOAA
WCATWC 국가 지진 해일 경보 센터