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

CODEBLOCK0

Examples:

CODEBLOCK1

Workflow

1. 1. Identify the facility type from the request.

1. 2. Extract the place keywords.

1. 3. If the user shared live location or latitude+longitude, prefer using the coordinates to rank facilities by physical distance.
2. Run the script.
3. Prefer the closest or best-matching few entries rather than a huge list.
4. Include Google Maps links when they help the user navigate.
5. If the user asks for accessible / universal toilets, use the relevant flags.
6. 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:

• - INLINECODE2
• INLINECODE3
• INLINECODE4

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.