Skip to content

Custom Home Assistant Integration for the HERE Destination Weather API

License

Notifications You must be signed in to change notification settings

eifinger/hass-here-weather

Repository files navigation

here_weather

GitHub Release GitHub Activity License

hacs HACS Installs Project Maintenance BuyMeCoffee

Discord Community Forum

Component to integrate with HERE Destination Weather API.

Weather

example

Sensors

moonphases

Setup

You need to register for an API key here.

HERE offers a Freemium Plan which includes 250,000 free Transactions per month. For the Destination Weather API, one transaction equals one request.

By default HERE will deactivate your account if you exceed the free Transaction limit for the month.

Account Creation

  1. When logged in, select "Projects Manager" from the top right corner image
  2. Create a new Project and select it or select an existing one (I already have my "old" one) image
  3. Under "Resources->Services" click "Link a Service" image
  4. Find "HERE Destination Weather" and click "Link" image

Installation

  1. Using the tool of choice open the directory (folder) for your HA configuration (where you find configuration.yaml).
  2. If you do not have a custom_components directory (folder) there, you need to create it.
  3. In the custom_components directory (folder) create a new folder called here_weather.
  4. Download all the files from the custom_components/here_weather/ directory (folder) in this repository.
  5. Place the files you downloaded in the new directory (folder) you created.
  6. Restart Home Assistant
  7. In the HA UI go to "Configuration" -> "Integrations" click "+" and search for "HERE Destination Weather"

Using your HA configuration directory (folder) as a starting point you should now also have this:

custom_components/here_weather/translations/en.json
custom_components/here_weather/translations/de.json
custom_components/here_weather/__init__.py
custom_components/here_weather/config_flow.py
custom_components/here_weather/const.py
custom_components/here_weather/manifest.json
custom_components/here_weather/sensor.py
custom_components/here_weather/utils.py
custom_components/here_weather/weather.py

Additional entities

The integration provides the following four modes:

  • Astronomy: Sunrise, Sunset and Moonphase
  • Hourly: Weather forecast in an hourly format
  • Daily: Weather forecast in a dailyformat
  • Daily Simple: Like Daily but with high/low temp, UV-index and pressure
  • Observation: Detailed precipitation for the next 24h

By default only the Daily Simple weather and sensor entities are enabled. To enable more entities go to the entities tab and enable them by hand:

disabled_entities_img enable_entity_img

Contributions are welcome!

If you want to contribute to this please read the Contribution guidelines


Buy Me A Coffee