Giới thiệu
Về MapsLibVN và người vận hành
MapsLibVN là nền tảng API bản đồ Việt Nam cho ứng dụng web và di động: bản đồ nền, tìm kiếm địa điểm, geocode, dẫn đường và ma trận khoảng cách, dựng trên dữ liệu mở OpenStreetMap và Foursquare OS Places. Dự án do Đỗ Tiến Phong xây dựng và vận hành, bắt đầu ngày 26/08/2026.
Thông tin nhanh
- Bắt đầu
- 26/08/2026
- Người vận hành
- Đỗ Tiến Phong
- Phạm vi
- Việt Nam, 34 tỉnh, thành sau sắp xếp năm 2025
- Dữ liệu
- OpenStreetMap (ODbL) và Foursquare OS Places (Apache-2.0)
- Cách dùng
- REST API và bốn SDK trên npm, xem Tính năng
Người vận hành
Đỗ Tiến Phong là người xây dựng và vận hành MapsLibVN, phụ trách từ thiết kế, dữ liệu, API, SDK tới máy chủ và hỗ trợ kỹ thuật. Phong trực tiếp quản lý các lượt cập nhật dữ liệu và duy trì các gói @mapslibvn trên npm.
Yêu cầu đặt ra từ ngày đầu
Bản thiết kế đầu tiên (26/08/2026) đặt ra ba yêu cầu mà người tích hợp thấy được ngay: nhúng được bằng một thẻ script hoặc một gói npm; dữ liệu lấy từ nguồn hợp pháp, đúng giấy phép dữ liệu mở; thể hiện đúng chủ quyền Việt Nam ở Hoàng Sa và Trường Sa.
Dữ liệu lấy từ đâu
- Bản đồ nền, đường, hẻm, ranh giới: OpenStreetMap (ODbL 1.0), thiết kế lớp bản đồ theo OpenMapTiles.
- Địa điểm: OpenStreetMap, Foursquare OS Places (Apache-2.0) và dữ liệu do người dùng đóng góp. Hiện có hơn 400.000 địa điểm đang hoạt động, thuộc 182 loại trong 14 nhóm.
- Hành chính: 34 tỉnh, thành và 3.321 đơn vị cấp xã theo sắp xếp 2025.
- Địa chỉ: 61.846 tuyến đường có tên, 59.060 hẻm và 146.223 mốc địa chỉ. Chỗ chưa có mốc đúng số nhà, geocode ước lượng theo hẻm hoặc từ các nhà đã có mốc trên cùng tuyến; không đủ dữ liệu thì trả về tuyến đường hoặc phường. Mức chính xác luôn ghi kèm kết quả.
- Chủ quyền: bước kiểm tra tự động chặn phát hành bản đồ nền nếu thiếu hai nhãn chủ quyền Hoàng Sa, Trường Sa, hoặc nếu vùng hai quần đảo còn chữ Hán hay tên gọi nước ngoài như Paracel, Spratly, Xisha, Nansha.
Ghi nguồn là bắt buộc và SDK tự hiển thị, xem Giấy phép và ghi nguồn; tám mức chính xác của geocode ở Độ chính xác.
Hệ thống đang chạy thế nào
- Bản đồ nền đặt trên Cloudflare, tải thẳng qua CDN.
- API chạy trên Cloudflare Workers; phần máy chủ phía sau do người vận hành trực tiếp quản lý.
- Chỉ request thành công mới bị trừ lượt; lỗi 4xx, 5xx không tính.
- Quy trình phát hành API tự dừng nếu bộ kiểm thử báo lỗi; bộ này chạy trên một cơ sở dữ liệu dựng riêng, không giả lập.
- Từ 20/09/2026, hệ thống tự kiểm tra sức khoẻ mỗi 5 phút và báo email cho người vận hành khi trạng thái đổi.
- MapsLibVN không nhận định danh người dùng cuối. Cơ sở dữ liệu không lưu địa chỉ IP dạng thô, chỉ lưu mã băm; với dữ liệu đóng góp, mã băm còn đổi theo ngày. Nhật ký chẩn đoán giữ tối đa 30 ngày, có toạ độ ứng dụng gửi lên, chỉ dùng để tìm lỗi.
MapsLibVN chưa cam kết SLA, chưa có giao thông thời gian thực, Street View, ảnh vệ tinh, và không phủ ngoài Việt Nam. Xem mục Những thứ chưa có.
Tự đánh giá trước khi chọn
- Chạy thử trên playground, không cần đăng ký.
- Khoá dùng thử 30 ngày có 2.000 lượt Places và 200 lượt tính tuyến, trần theo ngày ghi ở Bảng giá.
- Bài Độ chính xác geocode cho địa chỉ Việt Nam hướng dẫn tự đo chất lượng geocode của mọi nhà cung cấp.
Liên hệ người vận hành
Điện thoại
Thư điện tử
Giờ hỗ trợ và lưu ý khi gửi thư ở trang Liên hệ.