Skip to main content

Using Home Assistant with GeoPulse

This integration allows you to leverage Home Assistant's powerful device tracking capabilities to send location updates to GeoPulse. This is particularly useful if you already have device trackers configured in Home Assistant (e.g., for mobile apps, router-based tracking, etc.).

This guide will walk you through the required configuration in both GeoPulse and your Home Assistant setup.

Step 1: Configure GeoPulse​

First, you need to create a new location source in GeoPulse that will receive the data from Home Assistant.

  1. In your GeoPulse account, navigate to Settings -> Location Sources.
  2. Click Add New Source and select Home Assistant.
  3. Enter a secure and unique Token. This token will be used to authorize requests from Home Assistant.
  4. Click Save to create the new location source. Make sure to copy the generated token for the next step.

Step 2: Configure Home Assistant​

After setting up the source in GeoPulse, you will need to modify your Home Assistant configuration files (configuration.yaml and automations.yaml) to send location data to GeoPulse.

2.1: Update configuration.yaml​

Add the following rest_command entry to your configuration.yaml file. This defines a service that Home Assistant can call to send data to GeoPulse.

rest_command:
  send_gps_data:
    url: "https://geopulse.yourdomain.com/api/homeassistant"
    method: POST
    headers:
      content-type: "application/json"
      Authorization: Bearer YOUR_CONFIGURED_TOKEN
    payload: >
      {
        "device_id": "iphone_16",
        "timestamp": "{{ now().isoformat() }}",
        "location": {
          "latitude": {{ state_attr('device_tracker.iphone_16', 'latitude') }},
          "longitude": {{ state_attr('device_tracker.iphone_16', 'longitude') }},
          "accuracy": {{ state_attr('device_tracker.iphone_16', 'gps_accuracy') | default(0, true) }},
          "altitude": {{ state_attr('device_tracker.iphone_16', 'altitude') | default(0, true) }},
          "speed": {{ state_attr('device_tracker.iphone_16', 'speed') | default(0, true) }}
        },
        "battery": {
          "level": {{ state_attr('device_tracker.iphone_16', 'battery_level') | default(states('sensor.iphone_16_battery_level'), true) | default(0, true) }}
        }
      }

Important Replacements:

  • Replace https://geopulse.yourdomain.com with the actual domain of your GeoPulse server.
  • Replace YOUR_CONFIGURED_TOKEN with the token you generated in GeoPulse in Step 1.
  • Replace iphone_16 with the actual entity_id of your device tracker in Home Assistant.

2.2: Update automations.yaml​

Next, add an automation that triggers the send_gps_data service whenever your device tracker's state changes.

- alias: Send GPS data to GeoPulse
  trigger:
    - platform: state
      entity_id: device_tracker.iphone_16 # Replace with your device tracker's entity_id
  action:
    - service: rest_command.send_gps_data

2.3: Restart Home Assistant​

After modifying configuration.yaml and automations.yaml, you must restart your Home Assistant server for the changes to take effect.

Once Home Assistant restarts, it will begin sending location updates to your GeoPulse account, which will be automatically processed to build your timeline.