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
python3 /home/jim/.openclaw/workspace/skills/hk-nearby-facilities/scripts/hk_nearby_facilities.py toilet <place-keywords>
Examples:
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
- Identify the facility type from the request.
- For now, only
toiletis implemented.
- For now, only
- Extract the place keywords.
- Accept district names, station names, estates, landmarks, street names, or short area phrases.
- If the user shared live location or latitude+longitude, prefer using the coordinates to rank facilities by physical distance.
- Run the script.
- Prefer the closest or best-matching few entries rather than a huge list.
- Include Google Maps links when they help the user navigate.
- If the user asks for accessible / universal toilets, use the relevant flags.
- 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=toiletgetAccessibleToilets.php?type=toiletgetUniversalToilets.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.
