Reverse Geocoding Plugin – Placeholder Documentation (Text Version)

This document describes the placeholders used inside the Reverse Geocoding Plugin for The Home Remote.
Each placeholder must be replaced with the correct device and attribute names from your Home Assistant
integration and your virtual THR device.

------------------------------------------------------------
Placeholder Definitions
------------------------------------------------------------

HA_GPS_DEVICE
    The name of the Home Assistant device (as it appears in The Home Remote)
    that provides the GPS coordinates. Typically this is a `device_tracker`
    entity or any Home Assistant device reporting location data.

HA_LATITUDE_ATTRIBUTE
    The attribute inside the Home Assistant device that provides the latitude
    value. Use the attribute name exactly as it appears in THR (e.g. `Latitude`,
    `lat`, or `coordinate_lat`).

HA_LONGITUDE_ATTRIBUTE
    The attribute inside the Home Assistant device that provides the longitude
    value. Use the exact attribute name shown in THR (e.g. `Longitude`, `lon`,
    or `coordinate_lon`).

THR_OUTPUT_DEVICE
    The name of the virtual device in The Home Remote where the resolved address
    will be stored after reverse geocoding.

THR_OUTPUT_ATTRIBUTE
    The attribute inside the THR output device where the formatted address
    should be written. Typical examples: `Address`, `ResolvedAddress`.

------------------------------------------------------------
How to Use These Placeholders
------------------------------------------------------------

1. Identify the Home Assistant device in THR that provides latitude & longitude.
2. Note the exact attribute names for these coordinates.
3. Replace each placeholder in the plugin code with the real values:
       HA_GPS_DEVICE → your HA device name
       HA_LATITUDE_ATTRIBUTE → latitude attribute name
       HA_LONGITUDE_ATTRIBUTE → longitude attribute name
4. Replace the THR output placeholders:
       THR_OUTPUT_DEVICE → your THR virtual device
       THR_OUTPUT_ATTRIBUTE → attribute for storing the resolved address

------------------------------------------------------------
Example Mapping
------------------------------------------------------------

If your Home Assistant device is:
    device_tracker.my_car

And its coordinate attributes are:
    Latitude
    Longitude

And your THR output device is:
    GeoDecoder

And the output attribute is:
    Address

Then use the following replacements:

    HA_GPS_DEVICE → "device_tracker.my_car"
    HA_LATITUDE_ATTRIBUTE → "Latitude"
    HA_LONGITUDE_ATTRIBUTE → "Longitude"
    THR_OUTPUT_DEVICE → "GeoDecoder"
    THR_OUTPUT_ATTRIBUTE → "Address"

------------------------------------------------------------
End of Documentation
------------------------------------------------------------