Radar warning for HomeAssistant

Radar warning integration for HomeAssistant

Introduction

This integration has not yet been tested and is in beta phase

I give no guarantee for the functionality and no promise of lifelong maintenance, as I do the whole thing in my free time. Of course, I am happy about every contribution and PR.

This integration enables the detection and display of mobile speed cameras or radar traps within a specified radius around a given latitude and longitude. The speed cameras or radar traps are dynamically shown on the standard Home Assistant (HA) map.

Additionally, with the use of the Google Geocoding API, formatted addresses of these radar traps are retrieved and displayed, offering precise location details. This enhances the overall user experience by providing both map visualizations and detailed address information within the monitored zone.

Installation

HACS

The Radar integeration is not available in HACS (Home Assistant Community Store) by default, but you can add it as custom repositories.

1. Install HACS if you don't have it already
2. Open HACS in Home Assistant
3. Add this repository (https://github.com/MelleD/ha-radar-warning) via HACS Custom repositories (How to add Custom Repositories)

Google Geocoding API Setup

The Google Geocoding API allows you to determine and process location data. This is optional and improves the adress data for the POIs. This guide outlines the steps to set up and use the Google Geocoding API.

Prerequisites

• A Google Cloud account
• A Google Cloud project
• Access to the Google Cloud Console

Step-by-Step Guide

1. Create a Google Cloud Project

• Go to the Google Cloud Console.
• Click on the project dropdown menu at the top of the page and select "New Project".
• Enter a project name and billing account (if prompted), then click "Create".
• Make a note of your Project ID, as you'll need it later.

2. Enable the Geocoding API

• In the Google Cloud Console, navigate to the "API & Services" section.
• Click on "Library" to view available APIs.
• Search for "Geocoding API" in the search bar.
• Click on "Geocoding API" and then click "Enable".

3. Set Up Billing

Google Cloud requires billing information to use most of its APIs.

• In the Google Cloud Console, go to the "Billing" section.
• Link your project to a billing account if you haven't already done so.

4. Create API Credentials

• In the Google Cloud Console, go to the "API & Services" > "Credentials" section.
• Click on "Create Credentials" and select "API Key".
• Copy the API key that is generated. You will need this key to authenticate your API requests and copy it to the config in HA.

‼️ Danger ‼️

You can (currently) make 40.000 request per month for free. After that you have to pay for the request, but you can restrict your API key and setup alerting:

• In the Google Cloud Console, navigate to "API & Services" > "Dashboard".
• Here you can monitor your API usage and set up alerts if needed.
• To manage quotas, go to "API & Services" > "Quotas" and adjust your settings as necessary. e.g. 1250 request per day

Support

Clone and create a PR to help make the card even better.

Please ⭐️ or sponsor this repo when you like it.

Sponsor ❤️