Docs for Locate a Perosn

wiki/docs/extend-functionality/sentences/index.md

@@ -13,7 +13,8 @@ We encourage everyone to share their creations so that others might enjoy what y
 | [Broadcast](sentences/broadcast) | Broadcast messages to other View Assist Satellites |
 | [Device Functions](sentences/device-functions) | Extend device functions for media control, modes and repeat speech |
 | [Get Sports Scores](sentences/get-sports-scores) | Get sports scores from US major sports teams and custom definitions |
-| [How\'s the Weather](sentences/hows-the-weather) | Get current conditions and see the forecast on view enabled devices
+| [How\'s the Weather](sentences/hows-the-weather) | Get current conditions and see the forecast on view enabled devices |
+| [Locate a Person](sentences/locate-a-person) | Ask for the location of a family member and see it displayed on a map |
 | [List Management](sentences/list-management) | Add, remove, show items from your shopping or to do list |
 | [Play Music with Music Assistant](sentences/play-music-with-ma) | Play your music media using Music Assistant |
 | [Play TuneIn with Music Assistant](sentences/play-tunein-with-ma) | Play TuneIn radio using Music Assistant |

wiki/docs/extend-functionality/sentences/locate-a-person.md

@@ -0,0 +1,22 @@
+# Locate a Person
+
+![](../views/locate/locate_example.png)
+
+
+[![Open your Home Assistant instance and show the blueprint import dialog with a specific blueprint pre-filled.](https://my.home-assistant.io/badges/blueprint_import.svg)](https://my.home-assistant.io/redirect/blueprint_import/?blueprint_url=https://github.com/dinki/View-Assist/blob/main/View_Assist_custom_sentences/Locate_a_Person/blueprint-locateaperson.yaml)
+
+This blueprint enables you to display the location of a home assistant user on a map. The map also shows the geocoded address with most recent location update in relative time. If you choose to hold the view, it will provide real-time updates as the tracking device sends new location data.
+
+Optional requirements for the geocoded tracker sensor in the companion app:
+  * The **Background location** needs to be enabled. It can be found in the home assistant mobile app -> settings -> companion app -> Location sensors.
+  * The **Geolocation sensor** needs to be enabled along with it's setting to **Update sensor with location sensors**. It can be found in the home assistant mobile app -> settings -> companion app -> manage sensors.  
+  * The **Background access** also needs to be enabled. It can be found in the home assistant mobile app -> settings -> companion app -> other settings.
+
+Notes:
+  * The names should be defined phonetically, as the voice assistant interprets them, followed by the person's name as listed in the People menu under settings. To assist in determining the voice assistant's spelling of the name, a visual display of the name will be shown if it is incorrect.
+  *  The maps pinch-to-zoom and drag controls have been replaced with a tap to hold. The reset focus, along with the plus and minus buttons, function as expected.
+
+
+Required View: [locate view](../views/locate/index.md)
+
+All credit goes to @JimmyJamesBob and @colin715 for their collaboration on this cool blueprint

wiki/docs/extend-functionality/views/locate/index.md

@@ -0,0 +1,21 @@
+# Locate View
+
+![](./locate_example.png)
+
+* **Description**: Shows location of a person entity at their current location on a map
+* **Defaultname**:  locate
+* **Current Version**: v1.0.0
+* **Code link**:  [Webpage View Raw Code](https://raw.githubusercontent.com/dinki/View-Assist/refs/heads/main/View%20Assist%20dashboard%20and%20views/views/locate/locate.yaml)
+* **Special Requirements**: None
+
+## Installation 
+
+This card can be added by copy pasting the raw code into a new view.   
+
+## Changelog
+
+| Version | Description |
+| ------- | ----------- |
+| v 1.0.0 | Initial release |
+
+