From 1bf79d69be2cd45d411d5970224d0b9a8cc17ee9 Mon Sep 17 00:00:00 2001
From: Jacob Tomlinson <jacob@tom.linson.uk>
Date: Thu, 23 Mar 2017 20:51:03 +0000
Subject: [PATCH] Add metoffice

---
 source/_components/sensor.metoffice.markdown  | 51 +++++++++++++++++++
 source/_components/weather.metoffice.markdown | 34 +++++++++++++
 2 files changed, 85 insertions(+)
 create mode 100644 source/_components/sensor.metoffice.markdown
 create mode 100644 source/_components/weather.metoffice.markdown

diff --git a/source/_components/sensor.metoffice.markdown b/source/_components/sensor.metoffice.markdown
new file mode 100644
index 00000000000..71be85467de
--- /dev/null
+++ b/source/_components/sensor.metoffice.markdown
@@ -0,0 +1,51 @@
+---
+layout: page
+title: "Met Office Sensor"
+description: "Instructions on how to integrate Met Office weather conditions into Home Assistant."
+date: 2017-03-23 22:00
+sidebar: true
+comments: false
+sharing: true
+footer: true
+logo: metoffice.png
+ha_category: Weather
+ha_release: 0.41
+---
+
+The `metoffice` sensor platform uses the Met Office's [DataPoint API][datapoint] for weather data.
+
+- Each sensor will be given the `device_id` of "Met Office [condition]"
+- The sensor checks for new data every minute, starting 30 minutes after the timestamp of the most recent data as the data is updated every half-hour.
+
+To add the Met Office weather to your installation you'll need to register for a free api key at the link above and then add the following to your `configuration.yaml` file:
+
+```yaml
+# Example configuration.yaml entry
+sensor:
+  - platform: metoffice
+    api_key: "my-api-key"
+    monitored_conditions:
+      - weather
+      - temperature
+      - feels_like_temperature
+      - wind_speed
+      - wind_direction
+      - wind_gust
+      - visibility
+      - uv
+      - precipitation
+      - humidity
+```
+
+Your location will be detected from your home `latitude` and `longitude` settings.
+
+Configuration variables:
+
+- **api_key** (*Required*): Your personal API key from the [Datapoint website][datapoint].
+
+<p class='note'>
+This sensor is an alternative to the [`metoffice`](/components/weather.metoffice/) weather platform.
+The weather platform is easier to configure but less customisable.
+</p>
+
+[datapoint]: http://www.metoffice.gov.uk/datapoint
diff --git a/source/_components/weather.metoffice.markdown b/source/_components/weather.metoffice.markdown
new file mode 100644
index 00000000000..ba70579a9ae
--- /dev/null
+++ b/source/_components/weather.metoffice.markdown
@@ -0,0 +1,34 @@
+---
+layout: page
+title: "Met Office"
+description: "Instructions on how to integrate Met Office weather conditions into Home Assistant."
+date: 2017-03-23 22:00
+sidebar: true
+comments: false
+sharing: true
+footer: true
+logo: metoffice.png
+ha_category: Weather
+ha_release: 0.41
+---
+
+The `metoffice` weather platform uses the Met Office's [DataPoint API][datapoint] for weather data.
+
+To add the Met Office weather platform to your installation you'll need to register for a free api key at the link above and then add the following to your `configuration.yaml` file:
+
+```yaml
+weather:
+  - platform: metoffice
+    api_key: "my-api-key"
+```
+
+Configuration variables:
+  
+- **api_key** (*Required*): Your personal API key from the [Datapoint website][datapoint].
+
+<p class='note'>
+This platform is an alternative to the [`metoffice`](/components/sensor.metoffice/) sensor.
+The weather platform is easier to configure but less customisable.
+</p>
+
+[datapoint]: http://www.metoffice.gov.uk/datapoint