알림

현재 이벤트에 대한 기본 정보를 정의하려면 <alert> 항목을 사용합니다.

이벤트가 동시에 둘 이상의 진행 중인 위치를 점유하고 있다면 이벤트를 여러 alert 객체로 분할하는 것이 좋습니다. 예를 들어 산불이 여러 주에 걸쳐 발생하면 알림을 주별로 하나씩 여러 알림으로 나눌 수 있습니다. 이렇게 하면 각 주마다 구체적인 긴급 상황 정보를 제공하고 화재 상황을 더 정확하게 업데이트할 수 있습니다.

동쪽에서 서쪽으로 이동하는 허리케인처럼 이벤트가 빠르게 변경되면 알림을 주기적으로 업데이트하는 것이 좋습니다. 피드에서 기존 알림을 삭제하지 마세요. 대신 이전 알림을 참조하는 새 알림을 실행하세요.

속성

표 1에서는 <alert> 항목의 속성 값을 설명합니다.

표 1. 항목 속성 <alert>개

요소 이름 선택사항 유형 설명
xmlns:cap REQUIRED string

xmlns 속성은 CAP URN을 네임스페이스로 참조해야 합니다.

예:

<cap:alert xmlns:cap="urn:oasis:names:tc:emergency:cap:1.2"/>

요소

표 2는 <alert> 항목의 하위 요소 값을 설명합니다.

표 2. 항목 요소 <alert>개

요소 이름 선택사항 유형 CAP 및 Google 메모 및 요구사항
<identifier> REQUIRED string 이벤트를 나타내는 알림 ID를 제공합니다. <identifier> 요소의 값은 모든 이벤트에서 고유해야 합니다.
<sender> REQUIRED string <sender> 요소는 알림의 생성자를 식별합니다. 공백, 쉼표 또는 제한 문자를 포함할 수 없습니다.
<sent> REQUIRED dateTime

<area> 블록에 인용된 위치가 단일 시간대 내에 있으면 <sent> 요소를 사용하여 이 영역의 시간을 지정합니다. 해당하는 경우 일광 절약 시간을 허용합니다.

메시지 콘텐츠가 여러 시간대에 적용되는 경우 현지 시간보다 UTC 시간을 사용하세요.
<status> REQUIRED AlertStatus

Google은 <status> 요소 값이 Actual인 공개적으로 사용 가능한 알림만 게시합니다.
<msgType> REQUIRED AlertMsgType

UPDATE 또는 CANCEL <msgType>은 하나 이상의 <references> 요소를 포함해야 합니다. CAP 표준은 다음을 지정합니다.

  • 이전 알림을 업데이트하는 모든 알림 메시지는 UPDATE를 사용하고 <references> 요소 값을 <expires> 날짜에 도달하지 않은 모든 이전 메시지로 설정합니다.
  • UPDATE 또는 CANCEL <msgType> 요소는 만료되지 않은 알림에 적용되어야 합니다. 따라서 UPDATE 또는 CANCEL <msgType>이 실행되면 모든 관련 메시지와 만료되지 않은 알림을 참조해야 합니다.

자세한 내용은 이벤트 변경 또는 만료를 참고하세요.
<source> 선택사항(OPTIONAL) string <source> 요소는 알림의 특정 소스를 나타냅니다. 연산자 또는 특정 기기를 예로 들 수 있습니다.
<scope> REQUIRED AlertScope

<scope> 요소는 알림 메시지의 의도된 배포를 나타냅니다.
<restriction> 조건부 string <scope> 요소 값이 Restricted이면 <restriction> 요소가 필요합니다. 이 요소는 제한된 알림 메시지의 배포를 제한하는 규칙을 설명합니다.
<addresses> 조건부 string <scope> 요소 값이 Private이면 <addresses> 요소가 필요합니다. 이 요소에는 알림 메시지의 의도된 수신자가 나열됩니다. 공백으로 구분된 주소를 여러 개 포함할 수 있지만 공백이 포함된 주소는 큰따옴표로 묶어야 합니다.
<code> 선택사항(OPTIONAL) string

<code> 요소는 알림 메시지의 특수한 처리를 나타냅니다.
<note> 조건부 string

알림에 다음 요소 값 중 하나가 포함된 경우 <note> 요소가 필요합니다.

  • <status>Exercise></status>
  • <msgType>Error></msgType>
<references> 조건부 string

<msgType> 요소 값이 UPDATE 또는 CANCEL이면 <references> 요소가 필요합니다.

시스템이 다른 게시자의 CAP 콘텐츠를 다시 게시할 때 전체 CAP 알림을 포함합니다. 수정된 콘텐츠를 원본 소스에 연결하려면 <references> 태그를 사용합니다.

여러 메시지를 참조하는 경우 공백을 구분 기호로 사용합니다.
<incidents> 선택사항(OPTIONAL) string <incidents> 요소는 동일한 이슈의 다양한 측면을 참조하는 여러 메시지를 수집합니다.
<info>

필수*

 info <info> 요소가 1개 이상 있어야 합니다. 여러 <info> 블록은 모두 <category> 및 <event> 요소 값이 동일해야 합니다.

* Google에서는 굵은 빨간색 필수(선택사항) 요소를 요구하지만 이러한 요소는 CAP 표준에서 선택사항입니다.

예

<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 Warning</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>
        <description>Tornado is observed near Cleburne.</description>
        <instruction>
          Don't 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>