Open data

The approved survey data of the Tiếp Cận project is public so anyone can use it: download it to analyse, build it into an app, or check it and add it to OpenStreetMap.

Loading the figures...

Licence and attribution

The data is under the ODbL 1.0 licence (like OpenStreetMap): you may use, copy and adapt it, including commercially, provided you credit the source and share derived databases under the same licence.

Suggested credit line: © Dự án Tiếp Cận (người đóng góp khảo sát), dữ liệu theo giấy phép ODbL 1.0

Not in the open data: photos (the rights belong to the photographers), surveyor names and emails, information about companions, Google Maps data, and fictional sample places.

Download

GeoJSON maps, JOSM, QGIS
CSV spreadsheets (Excel, Google Sheets), UTF-8
JSON the fullest, for programming

Up to 1000 places per download; for more use the offset parameter (see the API section). Sample data to try things out: sample GeoJSON (fictional).

Open API (v1)

No sign-up or API key; read-only (GET); callable from browsers (CORS); limited to 60 requests per minute per IP address. Responses are cached for 5 minutes.

Endpoint	Description
`GET /api/v1/places`	List of places (GeoJSON by default; ?format=json or csv)
`GET /api/v1/places/{slug-hoặc-id}`	One place (a GeoJSON Feature)
`GET /api/v1/meta`	Summary figures, licence, list of parameters

Filters

city=ha-noi, type=hotel, level=full|partial|no
ribbon=1 (only places with the Blue ribbon)
bbox=105.8,21.0,105.9,21.1 (min longitude, min latitude, max longitude, max latitude)
limit (default 200, max 1000), offset; the total is in the header X-Total-Count
format=geojson|json|csv, download=1 (download as a file)

Examples

curl "https://denduoc.buba.vn/api/v1/places?city=ha-noi&level=full&limit=50"
curl "https://denduoc.buba.vn/api/v1/places?format=csv&bbox=105.80,21.00,105.90,21.06" -o dia-diem.csv
curl "https://denduoc.buba.vn/api/v1/places/mau-01?demo=1"

Data fields

Field	Meaning
`id, slug, url`	Place id, URL slug and detail page address
`name, name_en, address, address_en`	Name and address (Vietnamese / English if available)
`city, type`	City code; type of place (hotel, restaurant, museum, heritage, attraction, station, bus_station, airport, bus_stop, office, public_service, hospital, clinic, disability_facility, disability_center, university, inclusive_school, special_school)
`level, wheelchair`	Project accessibility level: full / partial / no; wheelchair as the OSM tag: yes / limited / no
`survey_date, comment, comment_en`	Survey date and the surveyor's comment
`ribbon`	true when the place declares it employs people with disabilities (Blue ribbon)
`measurements`	All public survey answers by question code (steps_count, door_width_cm, lift_btn_max_cm, wc_accessible...); measurements in cm
`osm_tags`	Suggested OpenStreetMap tags (see the table below)
`demo`	true for a fictional sample place (only with ?demo=1)

Suggested OpenStreetMap tags

The osm_tags field is a SUGGESTION for OpenStreetMap contributors, based on OSM's wheelchair tag. Check it against reality, find the object that already exists on the map and follow the OSM community's import guidelines; the project never uploads data to OSM by itself.

Tag	Source
`tourism / amenity / railway / historic / aeroway / highway`	From the type (hotel → tourism=hotel, restaurant → amenity=restaurant, museum → tourism=museum...)
`wheelchair`	Fully → yes, Partly → limited, Not accessible → no
`toilets:wheelchair`	Accessible toilet → yes / no
`door:width`	Clear width of the main door, in metres
`step_count, ramp:wheelchair`	Steps at the main entrance; ramp → yes/no
`wheelchair:description(:en)`	The surveyor's comment
`survey:date, source`	Survey date; source "Tiếp Cận on-site survey"
`tiepcan:ribbon`	The project's own tag (OSM has no standard one): employs