diff --git a/source/_components/geo_location.markdown b/source/_components/geo_location.markdown index 99f9c3af2d7..79ef2c4c09c 100644 --- a/source/_components/geo_location.markdown +++ b/source/_components/geo_location.markdown @@ -22,6 +22,7 @@ The [Geolocation trigger](/docs/automation/trigger/#geolocation-trigger) can be | Platform | Source | |---------------------------------------------------|-------------------------------| | GeoJSON Events | `geo_json_events` | +| IGN Sismología | `ign_sismologia` | | NSW Rural Fire Service Incidents | `nsw_rural_fire_service_feed` | | U.S. Geological Survey Earthquake Hazards Program | `usgs_earthquakes_feed` | diff --git a/source/_components/ign_sismologia.markdown b/source/_components/ign_sismologia.markdown new file mode 100644 index 00000000000..193aa76d157 --- /dev/null +++ b/source/_components/ign_sismologia.markdown @@ -0,0 +1,96 @@ +--- +layout: page +title: "IGN Sismología" +description: "Instructions on how to integrate the Instituto Geográfico Nacional Sismología (Earthquakes) Feed feed into Home Assistant." +date: 2019-04-04 08:00 +sidebar: true +comments: false +sharing: true +footer: true +logo: ign-sismologia.png +ha_category: Geolocation +ha_iot_class: Cloud Polling +ha_release: 0.92 +--- + +The `ign_sismologia` platform lets you integrate a GeoRSS feed provided by the +Spanish [Instituto Geográfico Nacional](http://www.ign.es/) with information +about seismic events like earthquakes on the Iberian Peninsula and Canary +Islands. 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 +`ign_sismologia`. The distance in kilometers is available as the state +of each entity. + +

+ +

+ +The data is updated every 5 minutes. + +## {% linkable_title Configuration %} + +To integrate the IGN Sismología feed, add the following lines to your `configuration.yaml`. + +```yaml +# Example configuration.yaml entry +geo_location: + - platform: ign_sismologia +``` + +{% configuration %} +minimum_magnitude: + description: The minimum magnitude of an earthquake to be included. + required: false + type: float + default: 0.0 +radius: + description: The distance in kilometers around Home Assistant's coordinates in which seismic events are included. + required: false + type: float + default: 50.0 +latitude: + description: Latitude of the coordinates around which events are considered. + required: false + type: string + default: Latitude defined in your `configuration.yaml` +longitude: + description: Longitude of the coordinates around which events are considered. + required: false + type: string + default: Longitude defined in your `configuration.yaml` +{% endconfiguration %} + + +## {% linkable_title State Attributes %} + +The following state attributes are available for each entity in addition to +the standard ones: + +| Attribute | Description | +|--------------------|-------------| +| latitude | Latitude of the earthquake. | +| longitude | Longitude of the earthquake. | +| source | `ign_sismologia` to be used in conjunction with `geo_location` automation trigger. | +| external_id | The external ID used in the feed to identify the earthquake in the feed. | +| title | Original title from the feed. | +| region | Textual description of named geographic region near to the event. | +| magnitude | Reported magnitude of the earthquake. | +| publication_date | Date and time when this event occurred. | +| image_url | URL to a map supplied in the feed marking the location of the event. This could for example be used in notifications. | + + +## {% linkable_title Full Configuration %} + +```yaml +# Example configuration.yaml entry +geo_location: + - platform: ign_sismologia + radius: 100 + minimum_magnitude: 2.0 + latitude: 37.39 + longitude: -5.99 +``` diff --git a/source/images/screenshots/ign-sismologia-feed-map.png b/source/images/screenshots/ign-sismologia-feed-map.png new file mode 100644 index 00000000000..820d4b9a0be Binary files /dev/null and b/source/images/screenshots/ign-sismologia-feed-map.png differ diff --git a/source/images/supported_brands/ign-sismologia.png b/source/images/supported_brands/ign-sismologia.png new file mode 100644 index 00000000000..ce89a8cf2c2 Binary files /dev/null and b/source/images/supported_brands/ign-sismologia.png differ