API

API

The trail data is open. No key, no signup, CORS wide open.

Base URL

https://api.luwu.dev

Endpoints

GET /v1/meta

Dataset summary, sources, emergency numbers, disclaimer

GET /v1/trails ?q= &min_km= &max_km= &loop=true &fields=slim

All 119 trails

GET /v1/trails/{id}

A single trail

GET /v1/trails/{id}/geometry ?format=compact &include=elevation,distance_posts,escape_points

GeoJSON FeatureCollection, elevation as the third ordinate

GET /v1/trails/{id}/posts

AFCD distance posts — the reference rescue asks a caller for

GET /v1/itineraries

Ten HKTB editorial itineraries (not walkable routes)

Try it:

curl https://api.luwu.dev/v1/trails?fields=slim

Licence

Trail geometry derives from OpenStreetMap and is therefore ODbL 1.0. That means attribution is required, and if you redistribute this data — or a database derived from it — you must offer it under ODbL too. This data cannot be made proprietary.

The itineraries (/v1/itineraries) are paraphrased from Hong Kong Tourism Board material and are NOT ODbL. Elevation is NASA SRTM, public domain. Basemap tiles come from the HK Lands Department and are not redistributed here — the browser fetches them directly.