UI Elements Required for The Home Remote – Reverse Geocoding Plugin
--------------------------------------------------------------------

This document describes the user interface elements (Labels, Buttons)
that should be added in The Home Remote (THR) to display and control
the output of the Reverse Geocoding Plugin.

--------------------------------------------------------------------
1. Address Label (Required)
--------------------------------------------------------------------

This Label displays the resolved address returned by the plugin.

Recommended Name:
    lblAddress

Text Binding:
    @Device.THR_OUTPUT_DEVICE.THR_OUTPUT_ATTRIBUTE

Example (after replacing placeholders):
    @Device.GeoDecoder.Address

Purpose:
    Shows the human-readable address generated by the reverse
    geocoding API call.


--------------------------------------------------------------------
2. Refresh Button (Optional)
--------------------------------------------------------------------

A button to manually trigger a new reverse geocoding request.

Recommended Name:
    btnRefreshLocation

Button Text:
    Refresh Location

Event Trigger:
    Event: Pressed
    Action Type: Refresh
    Target Device: ReverseGeocode

Purpose:
    Allows the user to manually refresh the resolved address on demand.


--------------------------------------------------------------------
3. Latitude & Longitude Labels (Optional)
--------------------------------------------------------------------

These Labels show raw coordinate values from the Home Assistant device.

Latitude Label:
    Name: lblLatitude
    Text Binding:
        @Device.HA_GPS_DEVICE.HA_LATITUDE_ATTRIBUTE

Longitude Label:
    Name: lblLongitude
    Text Binding:
        @Device.HA_GPS_DEVICE.HA_LONGITUDE_ATTRIBUTE

Purpose:
    Displays the exact GPS values used by the reverse geocoding plugin.


--------------------------------------------------------------------
4. Status Label (Optional)
--------------------------------------------------------------------

You can add a status label if you want the plugin to display messages.

Recommended Name:
    lblStatus

Text Binding (only if implemented in plugin):
    @Device.ReverseGeocode.Status

Purpose:
    Shows status messages, warnings, or error details from your plugin.


--------------------------------------------------------------------
5. Summary
--------------------------------------------------------------------

UI Element           Required   Purpose
-------------------------------------------------------------
Address Label        YES        Shows the resolved address
Refresh Button       Optional   Manually updates the address
Latitude Label       Optional   Shows raw latitude value
Longitude Label      Optional   Shows raw longitude value
Status Label         Optional   Displays plugin status messages

--------------------------------------------------------------------
End of File
--------------------------------------------------------------------