GeoNet NZ Quakes

    The GeoNet NZ Quakes integration lets you use a GeoJSON feed provided by New Zealand's GeoNet with information about quakes in the New Zealand region that happened within the last 7 days. It retrieves incidents from a feed and shows information of those incidents filtered by distance to Home Assistant's location.

    Entities are generated, updated and removed automatically with each update from the feed. Each entity defines latitude and longitude and will be shown on the default map automatically, or on a map card by defining the source geonetnz_quakes. The distance is available as the state of each entity, and converted to the unit (kilometers or miles) configured in Home Assistant.

    The data is updated every 5 minutes.

    Note

    The material used by this integration is provided under the Creative Commons Attribution 3.0 New Zealand (CC BY 3.0 NZ) license. It has only been modified for the purpose of presenting the material in Home Assistant. Please refer to the creator's disclaimer notice and data policy for more information.

    We acknowledge the New Zealand GeoNet project and its sponsors EQC, GNS Science and LINZ, for providing data/images used in this integration.

    ::: :::note 配置 此集成可通过 UI 配置。前往 设置 > 设备与服务 添加。

    State attributes

    The following state attributes are available for each entity in addition to the standard ones:

    AttributeDescription
    latitudeLatitude of the quake.
    longitudeLongitude of the quake.
    sourcegeonetnz_quakes to be used in conjunction with geo_location automation trigger.
    external_idThe external ID used in the feed to identify the quake in the feed.
    titleTitle of this entry.
    mmiThe calculated MMI shaking at the closest locality in the New Zealand region.
    magnitudeThe summary magnitude for the quake.
    depthThe depth of the quake in km.
    timeThe origin date and time of the quake.
    localityDistance and direction to the nearest locality.
    qualityThe quality of this information: best, good, caution, deleted.

    Please note that the reported MMI may be lower than the minimum requested MMI. This integration is passing the requested MMI value to the feed source and displays all entries retrieved without further filtering by MMI.

    Sensor

    This integration automatically creates a sensor that shows how many entities are currently managed by this integration. In addition to that the sensor has some useful attributes that indicate the currentness of the data retrieved from the feed.

    AttributeDescription
    statusStatus of last update from the feed ("OK" or "ERROR").
    last updateTimestamp of the last update from the feed.
    last update successfulTimestamp of the last successful update from the feed.
    last timestampTimestamp of the latest entry from the feed.
    createdNumber of entities that were created during last update (optional).
    updatedNumber of entities that were updated during last update (optional).
    removedNumber of entities that were removed during last update (optional).

    Full configuration

    # Example configuration.yaml entry
geonetnz_quakes:
  radius: 100
  mmi: 4
  minimum_magnitude: 4.5
  latitude: -41.2
  longitude: 174.7