publicAlerts 엔드포인트는 공신력 있는 국내 및 국제 기관에서 발행한 특정 날씨 이벤트 알림에 관한 세부정보를 제공합니다. 이러한 알림은 생명을 구할 수 있는 중요한 정보를 제공합니다.
엔드포인트는 지정된 위도와 경도에 대해 실시간으로 발생하는 날씨 알림을 반환합니다. 지원되는 날씨 이벤트는 다음과 같습니다.
- 강수량: 비, 눈, 우박, 가뭄 등
- 극단적인 온도: 추위, 더위, 영하, 서리, 풍속 냉각, 습도
- 바람 및 폭풍 이벤트: 눈보라, 허리케인, 토네이도, 열대성 폭풍, 뇌우 등
- 가시성 장애: 안개, 모래 폭풍, 눈보라
- 물 관련 위험: 홍수, 쓰나미, 폭풍 해일, 해안 재해 등
- 지구 물리학적 및 지질학적 이벤트: 지진, 산사태, 화산 활동
- 화재 사고: 산불, 화재 날씨 등
지원되는 날씨 이벤트의 전체 목록은 날씨 이벤트 유형을 참고하세요.
데이터 소스에서 제공되는 내용에 따라 알림에 현지화된 설명이 포함될 수도 있고 포함되지 않을 수도 있습니다. 데이터 소스 제한으로 인해 정보가 있는 그대로 (원시 콘텐츠) 제공됩니다. 날씨 알림 소스에 대한 자세한 내용은 데이터 소스를 참고하세요.
API는 지정된 날씨 알림에 대해 다음 정보를 반환합니다.
- 알림과 관련된 날씨 이벤트 유형
- 영향을 받는 지역 목록과 해당 지역의 지리적 경계를 정의하는 좌표
- 날씨 이벤트에 대한 한 문장 요약
- 심각도, 확실성, 긴급성 수준
- 타겟층에 대한 작업 추천 안내 설명
- 안전 권장사항
- 알림의 시작 시간 및 종료 시간
- 게시 기관의 이름과 웹사이트
API 탐색기를 사용하면 API와 API 옵션을 익힐 수 있도록 라이브 요청을 할 수 있습니다.
날씨 알림 요청 정보
날씨 알림 정보를 요청하려면 다음 주소로 HTTP GET 요청을 보냅니다.
https://weather.googleapis.com/v1/publicAlerts:lookup?key=YOUR_API_KEY&location.latitude=LATITUDE&location.longitude=LONGITUDE&languageCode=LANGUAGE_CODE
요청 URL 매개변수에 위치의 위도 및 경도 좌표를 포함합니다.
날씨 알림 응답 정보
날씨 API는 응답 본문에 다음 필드를 반환합니다.
| 필드 | 유형 | 설명 | 필수 또는 선택사항 |
|---|---|---|---|
alertId |
문자열 | 알림 ID입니다. 데이터 제공업체 웹사이트에서도 확인할 수 있습니다. | 필수 |
alertTitle |
문자열 | 날씨 이벤트를 설명하는 알림 제목입니다. 참고: 언어 코드 매개변수가 요청에 포함된 경우 번역되는 유일한 문자열입니다. |
필수 |
eventType |
열거형 | 알림과 연결된 날씨 이벤트 유형입니다. 지원되는 날씨 이벤트의 전체 목록은 날씨 이벤트 유형을 참고하세요. |
필수 |
areaName |
문자열 | 요청된 위치를 포함하여 알림의 영향을 받는 지리적 영역의 이름입니다. | 필수 |
polygon |
문자열 | 알림의 닫힌 차원 영역을 정의하는 좌표입니다. | 선택사항 |
description |
문자열 | 지정된 언어로 이벤트 설명을 요약하는 짧은 문구입니다 (예: '토네이도 경보'). | 선택사항 |
severity |
열거형 | 알림의 심각도 수준입니다.
|
선택사항 |
certainty |
열거형 | 알림의 확실성 수준입니다.
|
선택사항 |
urgency |
열거형 | 알림의 긴급성 수준입니다.
|
선택사항 |
instruction |
문자열 | 타겟 잠재고객을 위한 응답형 작업 안내에 대한 설명입니다. | 선택사항 |
safetyRecommendations |
문자열 | 공공 기관 코드를 기반으로 한 안전 권장사항 최상위 지시어와 추가 정보가 포함된 부텍스트가 포함됩니다. | 선택사항 |
timezoneOffset |
문자열 | 이벤트의 시간대 오프셋입니다. +/-HH:MM 형식입니다. | 필수 |
startTime |
일시 | 알림 메시지에 포함된 정보의 유효한 에포크 날짜 및 시간 (UTC 시간)입니다. | 선택사항 |
expirationTime |
일시 | 알림이 종료될 것으로 예상되는 에포크 날짜 및 시간 (UTC 시간)입니다. 무기한으로 긴 이벤트의 경우 null일 수 있으며, 이 경우 헤드라인에 이벤트가 '진행 중'이라고 표시됩니다. | 선택사항 |
dataSource |
열거형 | 게시자, 이름, URL을 포함한 기관 세부정보입니다. | 필수 |
regionCode |
열거형 | 요청된 위치의 지역 코드입니다. | 선택사항 |
데이터 소스
날씨 알림 엔드포인트는 다음 표에 나열된 제공자가 게시한 데이터를 반환합니다. 요청에 제공된 위도 및 경도 좌표를 기반으로 응답 본문은 적절한 현지 기관의 데이터를 표시합니다.
피드에 포함된 제공자는 Google의 공개 알림 가이드라인을 따릅니다. Google은 언제든지 제공업체 목록을 업데이트할 수 있습니다.
기여 분석
데이터가 표시되는 모든 디스플레이에서 고객 애플리케이션은 dataSource 필드를 사용하여 원본에 대한 저작자 표시를 포함해야 합니다.
"dataSource": {
"publisher": "NOAA",
"name": "National Weather Service",
"authorityUri": "https://www.weather.gov/"
}
출처 표시에는 데이터 소스의 전체 이름 (name 필드에 제공됨)과 authorityUri 필드에 제공된 URL을 사용하는 데이터 소스에 대한 하이퍼링크가 포함되어야 합니다 (예: '국립 기상청').
날씨 이벤트 유형
지원되는 날씨 이벤트 유형은 다음과 같습니다.
| 날씨 이벤트 유형 | |
|---|---|
ACID_RAINAVALANCHEBLIZZARDBLOWING_SNOWCOASTAL_FLOODCOASTAL_HAZARDCOLDCYCLONEDROUGHTEXTRATROPICAL_CYCLONEFIRE_WEATHERFLASH_FLOODFLOODFOGFREEZINGFREEZING_AIR_TEMPERATUREFREEZING_DRIZZLEFREEZING_RAINFROSTGALEGLAZEHAILHAZARDOUS_SEASHEATHUMIDITYHURRICANEICE_STORMLAKE_EFFECT_SNOWMONSOONMUDDY_FLOODOUTFLOWRAIN
|
RIVER_FLOODINGSEVERE_THUNDERSTORM_WARNINGSNOWSNOWSQUALLSTORMSTORM_SURGETHUNDERTHUNDERSTORMTORNADOTORNADO_WARNINGTROPICAL_CYCLONETROPICAL_CYCLONE_WARNINGS_AND_WATCHESTROPICAL_DISTURBANCETROPICAL_STORMTYPHOONWINDWIND_CHILLWIND_WAVEWINTER_STORMWILDFIREBUSHFIREFIRELANDSLIDEEARTHQUAKEDUST_STORMAFTERSHOCKTSUNAMIVOLCANIC_ASHVOLCANIC_ERUPTIONRADIATION |
응답 번역 동작
Google은 alertTitle 필드에 대해서만 번역을 제공합니다. eventType, areaName, instruction, safetyRecommendations과 같은 다른 필드도 원래 데이터 소스의 언어 지원에 따라 번역될 수 있지만 Google에서는 이러한 필드에 대한 독립적인 번역을 제공할 수 없습니다.
요청에 포함된 languageCode 매개변수에 따라 alertTitle 필드에 다음 동작이 예상됩니다.
- 지원되는
languageCode: 요청된languageCode이 제공되고 지원되는 경우 대답은 요청된 언어로 반환됩니다. - 지원되지 않는
languageCode: 요청된languageCode이 지원되지 않고 유사한 대체 항목을 찾을 수 없는 경우 엔드포인트는 기본적으로 영어로 응답을 반환합니다. languageCode이 제공되지 않음: 엔드포인트는 기본적으로 영어로 응답을 반환합니다.
날씨 알림 요청 예
다음 예에서는 노스캐롤라이나의 한 마을에 대한 날씨 알림 정보를 요청합니다.
curl -X GET "https://weather.googleapis.com/v1/publicAlerts:lookup?key=YOUR_API_KEY&location.latitude=35.824635 &location.longitude=-78.3168047 &languageCode=en"
응답 본문은 다음과 같습니다.
{ "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" }
기능을 사용해 보세요.
API 탐색기를 사용하면 API 및 API 옵션에 익숙해질 수 있도록 샘플 요청을 할 수 있습니다.
페이지 오른쪽에서 API 아이콘 api을 선택합니다.
원하는 경우 요청 매개변수를 수정합니다.
실행 버튼을 선택합니다. 대화상자에서 요청을 보낼 때 사용할 계정을 선택합니다.
API 탐색기 패널에서 전체 화면 아이콘 전체 화면을 선택하여 API 탐색기 창을 펼칩니다.