알림

현재 이벤트에 관한 기본 정보를 정의하려면 <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> 요소가 하나 이상 있어야 합니다. 여러 <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>