# Earthquake alerts

The following sections describe earthquake alerts.

## Alert area

> [!NOTE]
> **Note:** Specify the value of the `<area>` entity as the alerting area, not the incident area. To identify the users who receive an earthquake alert, Google uses the `<area>` entity.

- If you use a `<circle>` entity to specify an earthquake's epicenter, add a
  non-zero radius instead of a single point:

  - Zero-radius circles are considered empty objective areas that Google Public
    Alerts doesn't support.

  - Depending on an earthquake's magnitude of depth, your system can select a
    radius from a set of predetermined radii values.

- Many earthquakes are centered in remote or offshore locations. Therefore, we
  recommend that you specify the value of the `<areaDesc>` element in terms of
  the epicenter's distance and direction from a more populated or better known
  area.

  Example:
  `<areaDesc>10 km SW of Christchurch</areaDesc>`
- If you have an intensity shakemap image, epicenter map image, or other rich
  media sources, then you can use the `<resource>` element to specify the type
  and content of the resource file.

## Additional parameters

To describe the earthquake's strength and intensity in `<parameter>` objects,
Public Alerts also accepts the element value pairs shown in the following code
snippet.

    <parameter>
          <valueName>Magnitude</valueName>
          <value>6.1</value>
    </parameter>
    <parameter>
          <valueName>EventDepth</valueName>
          <value>12 km</value>
    </parameter>

## Examples

    <?xml version="1.0" encoding="UTF-8"?>
    <alert xmlns="urn:oasis:names:tc:emergency:cap:1.2">
      <identifier>Indonesia-InaTEWS-earthquakes-20230415221056</identifier>
      <sender>info_inatews@bmkg.go.id</sender>
      <sent>2023-04-15T22:10:56+07:00</sent>
      <status>Actual</status>
      <msgType>Alert</msgType>
      <scope>Public</scope>
      <addresses>0</addresses>
      <code>profile:BMKG-Versi:1</code>
      <info>
          <language>id</language>
          <category>Geo</category>
          <event>Gempabumi</event>
          <urgency>Past</urgency>
          <severity>Unknown</severity>
          <certainty>Observed</certainty>
          <onset>2023-04-15T22:10:56+07:00</onset>
          <expires>2023-04-23T08:10:56+07:00</expires>
          <senderName>BMKG</senderName>
          <headline>Info Gempa kekuatan:6.2 SR, 15-Apr-23 22:07:07 WIB, (64 km
           BaratDaya KAUR-BENGKULU) ::BMKG -- Informasi sementara</headline>
          <description>Telah Terjadi gempabumi dengan kekuatan: 6.2 SR, 64 km
           BaratDaya KAUR-BENGKULU, waktu gempa: 15-Apr-23 22:07:07 WIB, Gempa
           ini tidak berpotensi TSUNAMI (Event ini sudah direview oleh
           seismologist.)</description>
          <instruction>Hati-hati terhadap gempabumi susulan yang mungkin
           terjadi</instruction>
          <web>https://inatews.bmkg.go.id</web>
          <contact>https://bmkg-content-inatews.storage.googleapis.com/kontakbmkg.html</contact>
          <parameter>
            <valueName>EventLocationName</valueName>
            <value>Lima wilayah terdekat: 64 km BaratDaya KAUR-BENGKULU, 70 km
             BaratDaya BENGKULUSELATAN, 99 km Tenggara SELUMA-BENGKULU, 142 km
             Tenggara BENGKULU-BENGKULU, dan 462 km BaratLaut
             JAKARTA-INDONESIA</value>
          </parameter>
          <parameter>
            <valueName>ShortLocationName</valueName>
            <value>64 km BaratDaya KAUR-BENGKULU</value>
          </parameter>
          <parameter>
            <valueName>EventOriginTime</valueName>
            <value>2023-04-15T22:07:07+07:00</value>
          </parameter>
          <parameter>
            <valueName>EventMagnitude</valueName>
            <value>6.2</value>
          </parameter>
          <parameter>
            <valueName>EventDepth</valueName>
            <value>23 km</value>
          </parameter>
          <resource>
            <resourceDesc>Peta Episenter</resourceDesc>
            <mimeType>image/gif</mimeType>
            <uri>https://bmkg-content-inatews.storage.googleapis.com/20230415221056.gif</uri>
          </resource>
          <resource>
            <resourceDesc>Peta Intensitas Guncangan</resourceDesc>
            <mimeType>image/jpeg</mimeType>
            <uri>https://bmkg-content-inatews.storage.googleapis.com/20230415221056.mmi.jpg</uri>
          </resource>
          <resource>
            <resourceDesc>Peta Peak Ground Acceleration</resourceDesc>
            <mimeType>image/jpeg</mimeType>
            <uri>https://bmkg-content-inatews.storage.googleapis.com/20230415221056.pga.jpg</uri>
          </resource>
          <resource>
            <resourceDesc>Peta Peak Ground Velocity</resourceDesc>
            <mimeType>image/jpeg</mimeType>
            <uri>https://bmkg-content-inatews.storage.googleapis.com/20230415221056.pgv.jpg</uri>
          </resource>
          <area>
            <areaDesc>64 km BaratDaya KAUR-BENGKULU, 70 km BaratDaya
             BENGKULUSELATAN, 99 km Tenggara SELUMA-BENGKULU, 142 km Tenggara
             BENGKULU-BENGKULU, dan 462 km BaratLaut
             JAKARTA-INDONESIA</areaDesc>
            <circle>-4.93,102.85 300.0</circle>
          </area>
      </info>
      <info>
          <language>en</language>
          <category>Geo</category>
          <event>Earthquake</event>
          <urgency>Past</urgency>
          <severity>Unknown</severity>
          <certainty>Observed</certainty>
          <onset>2023-04-15T22:10:56+07:00</onset>
          <expires>2023-04-23T08:10:56+07:00</expires>
          <senderName>BMKG</senderName>
          <headline>Earthquake mag:6.2, 15-Apr-23 15:07:07 UTC, (64 km SouthWest
           KAUR-BENGKULU) ::BMKG -- PRELIMINARY REPORT</headline>
          <description>An earthquake has occurred with magnitude: 6.2 SR, 64 km
           SouthWest KAUR-BENGKULU, at: 15-Apr-23 15:07:07 UTC, No TSUNAMI
           threat (This event has been reviewed by a
           seismologist.)</description>
          <instruction>Be careful of aftershocks</instruction>
          <web>https://inatews.bmkg.go.id</web>
          <contact>https://bmkg-content-inatews.storage.googleapis.com/kontakbmkg.html</contact>
          <parameter>
            <valueName>EventLocationName</valueName>
            <value>Five nearest area: 64 km SouthWest KAUR-BENGKULU, 70 km
             SouthWest BENGKULUSELATAN, 99 km SouthEast SELUMA-BENGKULU, 142 km
             SouthEast BENGKULU-BENGKULU, and 462 km NorthWest
             JAKARTA-INDONESIA</value>
          </parameter>
          <parameter>
            <valueName>ShortLocationName</valueName>
            <value>Southern Sumatra, Indonesia </value>
          </parameter>
          <parameter>
            <valueName>EventOriginTime</valueName>
            <value>2023-04-15T22:07:07+07:00</value>
          </parameter>
          <parameter>
            <valueName>EventMagnitude</valueName>
            <value>6.2</value>
          </parameter>
          <parameter>
            <valueName>EventDepth</valueName>
            <value>23 km</value>
          </parameter>
          <resource>
            <resourceDesc>Epicenter Map</resourceDesc>
            <mimeType>image/gif</mimeType>
            <uri>https://bmkg-content-inatews.storage.googleapis.com/20230415221056.gif</uri>
          </resource>
          <resource>
            <resourceDesc>Intensity Shakemap</resourceDesc>
            <mimeType>image/jpeg</mimeType>
            <uri>https://bmkg-content-inatews.storage.googleapis.com/20230415221056.mmi.jpg</uri>
          </resource>
          <resource>
            <resourceDesc>Peak Ground Acceleration Shakemap</resourceDesc>
            <mimeType>image/jpeg</mimeType>
            <uri>https://bmkg-content-inatews.storage.googleapis.com/20230415221056.pga.jpg</uri>
          </resource>
          <resource>
            <resourceDesc>Peak Ground Velocity Shakemap</resourceDesc>
            <mimeType>image/jpeg</mimeType>
            <uri>https://bmkg-content-inatews.storage.googleapis.com/20230415221056.pgv.jpg</uri>
          </resource>
          <area>
            <areaDesc>64 km SouthWest KAUR-BENGKULU, 70 km SouthWest
             BENGKULUSELATAN, 99 km SouthEast SELUMA-BENGKULU, 142 km SouthEast
             BENGKULU-BENGKULU, and 462 km NorthWest
             JAKARTA-INDONESIA</areaDesc>
            <circle>-4.93,102.85 300.0</circle>
          </area>
      </info>
    </alert>