hk-nearby-facilities

# HK Nearby Facilities Use the bundled script to search Hong Kong public-facility data by place keyword. ## Current scope - Public toilets (`toilet`) via FEHD official JSON endpoints. - Future-friendly structure for other facility types later. ## Quick start ```bash python3 /home/jim/.openclaw/workspace/skills/hk-nearby-facilities/scripts/hk_nearby_facilities.py toilet <place-keywords> ``` Examples: ```bash python3 /home/jim/.openclaw/workspace/skills/hk-nearby-facilities/scripts/hk_nearby_facilities.py toilet 大埔墟 python3 /home/jim/.openclaw/workspace/skills/hk-nearby-facilities/scripts/hk_nearby_facilities.py toilet 火炭站 python3 /home/jim/.openclaw/workspace/skills/hk-nearby-facilities/scripts/hk_nearby_facilities.py toilet Central --limit 5 python3 /home/jim/.openclaw/workspace/skills/hk-nearby-facilities/scripts/hk_nearby_facilities.py toilet 旺角 --accessible-only python3 /home/jim/.openclaw/workspace/skills/hk-nearby-facilities/scripts/hk_nearby_facilities.py toilet --lat 22.448628 --lng 114.164727 --limit 3 ``` ## Workflow 1. Identify the facility type from the request. - For now, only `toilet` is implemented. 2. Extract the place keywords. - Accept district names, station names, estates, landmarks, street names, or short area phrases. 3. If the user shared live location or latitude+longitude, prefer using the coordinates to rank facilities by physical distance. 4. Run the script. 5. Prefer the closest or best-matching few entries rather than a huge list. 6. Include Google Maps links when they help the user navigate. 7. If the user asks for accessible / universal toilets, use the relevant flags. 8. If there is no exact place match, say it is a nearby match instead of pretending it is exact. ## Reporting guidance - Keep it practical: name, address, district, and map link. - Say when the result is approximate or nearby rather than exact. - If the query is broad, return the top few likely matches. - Mention accessible / universal toilet status when available and relevant. ## Data source Public toilets currently use FEHD official endpoints, including: - `getMapData.php?type=toilet` - `getAccessibleToilets.php?type=toilet` - `getUniversalToilets.php?type=toilet` ## Limitations - This version is keyword-based, not GPS turn-by-turn routing. - It currently supports public toilets only. - Oil stations / petrol stations are not included yet because a comparable official government location dataset has not been confirmed. ## scripts/ - `scripts/hk_nearby_facilities.py` — search nearby Hong Kong facilities by place keyword.