Dữ liệu mở

Dữ liệu khảo sát đã được duyệt của dự án Tiếp Cận được công khai để ai cũng dùng được: tải về để phân tích, đưa vào ứng dụng, hoặc đối chiếu rồi đưa lên OpenStreetMap.

Đang tải số liệu...

Giấy phép và ghi nguồn

Dữ liệu theo giấy phép ODbL 1.0 (giống OpenStreetMap): được dùng, sao chép, sửa, kể cả thương mại, với điều kiện ghi nguồn và chia sẻ lại dữ liệu phái sinh theo cùng giấy phép.

Câu ghi nguồn gợi ý: © 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

Không có trong dữ liệu mở: ảnh (quyền thuộc người chụp), tên và email khảo sát viên, thông tin người đi cùng, dữ liệu của Google Maps, và các địa điểm mẫu hư cấu.

Tải về

GeoJSON bản đồ, JOSM, QGIS
CSV bảng tính (Excel, Google Sheets), mã hoá UTF-8
JSON đầy đủ nhất, cho lập trình

Mỗi lần tải tối đa 1000 địa điểm; nhiều hơn thì dùng tham số offset (xem phần API). Dữ liệu mẫu để thử: GeoJSON mẫu (hư cấu).

API mở (v1)

Không cần đăng ký hay khoá API; chỉ đọc (GET); cho phép gọi từ trình duyệt (CORS); giới hạn 60 lượt mỗi phút cho mỗi địa chỉ IP. Dữ liệu được lưu đệm 5 phút.

Địa chỉ	Mô tả
`GET /api/v1/places`	Danh sách địa điểm (GeoJSON mặc định; ?format=json hoặc csv)
`GET /api/v1/places/{slug-hoặc-id}`	Một địa điểm (GeoJSON Feature)
`GET /api/v1/meta`	Số liệu tổng quát, giấy phép, danh sách tham số

Tham số lọc

city=ha-noi, type=hotel, level=full|partial|no
ribbon=1 (chỉ địa điểm có Ruy băng xanh)
bbox=105.8,21.0,105.9,21.1 (kinh độ nhỏ, vĩ độ nhỏ, kinh độ lớn, vĩ độ lớn)
limit (mặc định 200, tối đa 1000), offset; tổng số nằm ở tiêu đề X-Total-Count
format=geojson|json|csv, download=1 (tải thành tệp)

Ví dụ

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"

Các trường dữ liệu

Trường	Ý nghĩa
`id, slug, url`	Mã địa điểm, đoạn đường dẫn và địa chỉ trang chi tiết
`name, name_en, address, address_en`	Tên và địa chỉ (tiếng Việt / tiếng Anh nếu có)
`city, type`	Mã thành phố; loại địa điểm (hotel, restaurant, museum, heritage, attraction, station, bus_station, airport, bus_stop)
`level, wheelchair`	Mức tiếp cận của dự án: full / partial / no; wheelchair theo thẻ OSM: yes / limited / no
`survey_date, comment, comment_en`	Ngày khảo sát và nhận xét của khảo sát viên
`ribbon`	true khi địa điểm khai có tuyển dụng người khuyết tật (Ruy băng xanh)
`measurements`	Mọi câu trả lời khảo sát công khai theo mã câu hỏi (steps_count, door_width_cm, lift_btn_max_cm, wc_accessible...); số đo tính bằng cm
`osm_tags`	Thẻ OpenStreetMap gợi ý (xem bảng dưới)
`demo`	true nếu là địa điểm mẫu hư cấu (chỉ có khi gọi ?demo=1)

Thẻ OpenStreetMap gợi ý

Trường osm_tags là GỢI Ý cho người đóng góp OpenStreetMap, dựa trên thẻ wheelchair của OSM. Hãy tự đối chiếu với thực tế, tìm đối tượng đã có trên bản đồ và tuân theo hướng dẫn nhập dữ liệu của cộng đồng OSM; dự án không tự đăng dữ liệu lên OSM.

Thẻ	Nguồn
`tourism / amenity / railway / historic / aeroway / highway`	Theo loại địa điểm (hotel → tourism=hotel, restaurant → amenity=restaurant, museum → tourism=museum...)
`wheelchair`	Đầy đủ → yes, Một phần → limited, Không → no
`toilets:wheelchair`	Có nhà vệ sinh tiếp cận → yes / no
`door:width`	Chiều rộng thông thuỷ cửa chính, đổi sang mét
`step_count, ramp:wheelchair`	Số bậc ở lối vào chính; có đường dốc → yes/no
`wheelchair:description(:en)`	Nhận xét của khảo sát viên
`survey:date, source`	Ngày khảo sát; nguồn "Tiếp Cận khảo sát tại chỗ"
`tiepcan:ribbon`	Thẻ riêng của dự án (OSM không có thẻ chuẩn): employs