CAP 형식의 알림 생성

CAP 표준 외에도 CAP 파일의 Google 관련 요구사항을 준수하여 알림이 올바르게 처리되도록 하세요.

알림을 생성하는 방법에는 두 가지가 있습니다.

  1. 자동 생성: 데이터베이스 정보를 동적으로 형식 지정하여 CAP 피드로 변환하고 Google에 자동으로 제출하도록 시스템을 설정합니다.
  2. 수동 생성: 웹 기반 애플리케이션을 통해 필요에 따라 알림 콘텐츠를 수동으로 만들고 제출합니다.

자동 생성

Google CAP 라이브러리를 확인하여 원하는 언어로 시작해 보세요. 이 라이브러리는 CAP 피드의 생성, 파싱, 유효성 검사를 지원합니다.

Google팀에서 구현하는 동안 지원을 제공할 수 있습니다. Google팀 또는 google-public-alerts@google.com으로 문의하세요.

수동 생성

  1. IT팀과 협력하여 웹 서버에 CAPCreator™ 오픈소스 웹 애플리케이션을 설치합니다. 또는 자체 웹 애플리케이션을 만들 수도 있습니다.
  2. 이벤트가 발생하면 애플리케이션의 URL로 이동하여 인터페이스를 사용하여 CAP 형식의 알림을 만듭니다.
  3. 애플리케이션이 웹 위치에 피드를 게시하면 Google에서 게시된 피드에서 해당 정보를 가져옵니다.

알림 요소

알림 분석

알림에는 다음과 같은 주요 질문에 대한 답변이 포함되어야 합니다.

  1. 현재 어떤 상황이 진행되고 있나요?
  2. 언제 진행되나요?
  3. 사용자는 어떻게 해야 하나요?
  4. 알림은 어디로 전송되나요?

다음은 알림의 간단한 예입니다.

    <alert xmlns="urn:oasis:names:tc:emergency:cap:1.1">
        <identifier>AL20110412020900TornadoWarning</identifier>
        <sender>w-nws.webmaster@noaa.gov</sender>
        <sent>2011-04-11T21:18:07-05:00</sent>
        <status>Actual</status>
        <msgType>Alert</msgType>
        <scope>Public</scope>
        <info>
            <language>en-US</language>
            <category>Met</category>
            <event>Tornado</event>
            <urgency>Immediate</urgency>
            <severity>Extreme</severity>
            <certainty>Observed</certainty>
            <effective>2011-04-11T21:09:00-05:00</effective>
            <expires>2011-04-11T21:30:00-05:00</expires>
            <headline>Tornado Warning issued April 11 at
            9:30PM CDT by NWS Birmingham</headline>
            <instruction>
                Do not wait to see or hear the tornado.
            For your protection, move to an interior room on the
            lowest floor of your home or business.</instruction>
            <area>
                <areaDesc>Cleburne</areaDesc>
                <polygon>33.61,-85.58 33.65,-85.58 33.72,-85.58
                33.81,-85.36 33.7,-85.34 33.7,-85.33 33.68,-85.33
                33.61,-85.58</polygon>
            </area>
        </info>
    </alert>

샘플 CAP 알림에서 작동하는 알림의 다양한 예시를 확인해 보세요.

이벤트

CAP <event> 문자열 (또는 <headline>)이 알림 제목에 표시됩니다. 짧고(35자(영문 기준) 미만) 대중들이 이해하기에 충분히 설명적이어야 합니다. 자세한 요구사항은 참조 가이드의 <info> 요소 및 하위 요소를 참고하세요.

날짜

시간대 필드는 모든 날짜/시간 값(예: <effective>, <expires>, <onset>)에 포함되어야 합니다. <area> 블록에 언급된 위치가 단일 시간대에 속하는 경우 <effective>는 해당 시간대의 시간을 지정해야 하며, 해당하는 경우 일광 절약 시간도 고려해야 합니다. 메시지 콘텐츠가 여러 시간대에 적용되는 경우 메시지 생산자는 현지 시간보다 UTC 시간을 사용해야 합니다.

안내

CAP 알림의 <instruction> 필드는 알림 세부정보 페이지에 '권장 조치'로 표시됩니다. 이 요소의 콘텐츠는 알림의 성격과 강도, 영향을 받은 지역을 요약하는 데 더 적합한 <description>와 동일해서는 안 됩니다.

알림 영역

CAP 알림의 <area> 요소는 알림을 보낼 지리적 영역을 설명해야 하며,여기에는 사고 지역 외부의 위치가 포함될 수 있습니다. 예를 들어 산불 알림을 생각해 보세요. 산불은 현재 불이 나지 않은 지역으로 빠르게 확산될 수 있으므로 <area>는 화재 발생 지점이나 현재 화재 지역뿐만 아니라 잠재적 위험 지역 전체를 포함해야 합니다.

영역을 다각형으로 지정

경보 영역은 다각형으로 지정하는 것이 가장 좋습니다. 다각형이 더 정확한 경보 영역을 나타낼 수 있기 때문입니다. <area> 요소의 값은 행정 구역이나 도와 같이 사전 결정된 지정학적 지역이 아닌 현재 또는 예측된 조건의 영향을 받는 특정 지리적 영역으로 정의되는 것이 좋습니다. 이렇게 하면 알림을 보는 사용자가 자신의 위치와 관련이 있다고 생각할 수 있습니다. 예를 들어 천둥번개 또는 홍수 경보는 행정 구역의 일부에만 영향을 미칠 수 있으며, 눈 폭풍 경보는 특정 고도 위에 있는 사용자에게만 영향을 미칠 수 있습니다. 이 경우 전체 구역 또는 도 전체를 CAP 알림의 <area>로 지정하면 영향을 받는 지역이 과대평가되어 알림의 유용성이 떨어집니다.

경험에 비추어 볼 때 예측 전문가가 경고하려는 영역 위에 맞춤 다각형을 그릴 수 있는 알림 소프트웨어 또는 도구가 이상적입니다.

다각형을 사용하는 경우 위도/경도 좌표에 소수점 이하 5~6자리까지만 포함하는 것이 좋습니다. 이렇게 하면 대부분의 알림 시스템에서 타겟팅할 수 있는 것보다 더 높은 해상도가 생성됩니다. 또한 다각형이 유효한지 확인해야 합니다. 예를 들어 교차하는 가장자리가 없어야 합니다.

지역을 지오코드로 지정

<area>를 지오코드 또는 여러 지오코드 집합으로 지정해야 하는 경우 가능한 한 가장 상세한 수준의 지오코드를 사용하고 영향을 받을 가능성이 있는 특정 마을, 도시 등의 이름을 <description> 요소에 포함하세요. 기본 셰이프파일을 shapefile 형식으로 공유해야 합니다.

여러 언어 지원

여러 개의 <info> 블록(언어당 하나의 <info> 블록)이 포함된 <alert>를 하나 만드세요.

자세한 내용과 다국어 알림 샘플은 다국어 샘플을 참고하세요.

CAP 알림 유효성 검사

Google의 오픈소스 CAP 검사기 도구를 사용하여 CAP 알림의 유효성을 검사하는 것이 좋습니다. 이 도구를 통해 오류 알림 이메일을 구독할 수도 있습니다. 유효성 검사기는 여러 CAP 유효성 검사 옵션과 예시를 제공합니다.

검사기 스크린샷

Google 공지사항 CAP v1.0을 선택하여 CAP 피드에 대한 Google별 요구사항을 기준으로 유효성을 검사합니다.

오류 알림 이메일을 구독하려면 피드 유효성 검사 결과 구독을 클릭하거나 http://cap-validator.appspot.com/subscribe로 이동합니다. 피드 URL과 이메일 주소를 입력하고 Google 공지사항 CAP v1.0을 선택한 다음 구독을 클릭해야 합니다. CAP 피드에서 문제가 발견되면 알림이 전송됩니다.

알림 게시자는 CAP 라이브러리에서 최신 버전의 Google CAP 스키마를 다운로드하여 오프라인에서 검증할 수도 있습니다.

다음 단계: Google에 알리미 피드 전송하기