Bỏ qua điều hướng
MapsLibVNBắt đầu

Điều hướng

$ npm i @mapslibvn/web

Bản đồ Việt Nam cho ứng dụng của bạn

API bản đồ, tìm kiếm địa điểm và dẫn đường dựng trên dữ liệu mở. Trả tiền bằng VND theo gói cố định, biết trước hoá đơn.

Bản dùng thử 2.000 lượt Places trong 30 ngày, không cần thẻ.

Bản đồ tương tác

Bản đồ khu vực trung tâm Thành phố Hồ Chí Minh do MapsLibVN dựng, nhãn đường và địa điểm bằng tiếng Việt

Bản đồ thật do MapsLibVN phục vụ.Mở trang thử đầy đủ →

Có sẵn những gì

Bảy mảng đang chạy thật, không phải lộ trình

AUTOCOMPLETE

Tìm kiếm hiểu tiếng Việt

Gõ tới đâu gợi ý tới đó, chịu được viết không dấu, viết tắt, cách viết địa phương và tên đơn vị hành chính cũ lẫn mới.
Tìm kiếm và autocomplete →

Rẻ hơn Google

Ở ba mức dùng đã đối chiếu, cùng khối lượng gọi API.

37–68%

GOOGLE MAPS PLATFORM

Chỗ Google hơn →

164 loại địa điểm

Gộp từ OpenStreetMap và Foursquare OS, mỗi địa điểm ghi rõ nguồn chính.

164

13 nhóm · 2 nguồn mở

Danh mục địa điểm →

PRECISION

Geocode nói thật

Mỗi kết quả kèm mức chính xác và độ tin cậy, thay vì một toạ độ trần để ứng dụng tự đoán.
{ "precision": "rooftop",
  "confidence": 0.94,
  "lat": 10.7797, "lng": 106.699 }
Độ chính xác geocode →

DIRECTIONS

Dẫn đường

Tính tuyến cho xe máy, ô tô và đi bộ, trả hướng dẫn từng chặng bằng tiếng Việt, dùng được cả trên web lẫn React Native.
  • Xe máy
  • Ô tô
  • Đi bộ
Hướng dẫn dẫn đường →

MATRIX

Giao hàng & vận tải

Ma trận khoảng cách N×M, thứ tự ghé tối ưu cho một chuyến và chia đơn cho cả đội xe, mỗi request tính một lượt.
Ma trận ≤ 50 cặpĐội xe ≤ 5 xe · 30 đơn1 lượt Chỉ đường
Hướng dẫn đội xe →

SDK

Bốn SDK, một API

Cùng một hợp đồng và một nguồn tiles trên trình duyệt, iOS và Android.
  • @mapslibvn/core
  • @mapslibvn/web
  • @mapslibvn/react
  • @mapslibvn/react-native
Cài đặt →

Bốn cách nhúng

Chọn cách hợp với dự án của bạn. Cả bốn dùng chung một khoá API và một hợp đồng dữ liệu.

<link rel="stylesheet" href="https://mapslibvn-docs.pages.dev/sdk/mapslibvn.css" />
<script src="https://mapslibvn-docs.pages.dev/sdk/mapslibvn.umd.js"></script>
<div id="map" style="height:400px"></div>
<script>
  const map = MapsLibVN.createMap({
    container: 'map',
    apiKey: 'mlv_live_…',
    apiBase: 'https://api.ai-solutions.io.vn',
    center: [106.7, 10.776],
    zoom: 13,
  });
</script>

Không cần build hay npm. Bản UMD đã gộp sẵn maplibre-gl và pmtiles.

Yêu cầu từng môi trường, bước worker của MapLibre cho bundler và bảng lỗi hay gặp nằm ởtrang Cài đặt.

Bảng giá

Giá theo lượt gọi, không theo đầu người

Bắt đầu bằng bản dùng thử 2.000 lượt Places trong 30 ngày, không cần thẻ thanh toán.

Starter

650.000đ / tháng

tham chiếu $25

30.000 lượt Places mỗi tháng

Chọn Starter

Được chọn nhiều nhất

Professional

2.600.000đ / tháng

tham chiếu $100

100.000 lượt Places mỗi tháng

Chọn Professional

Business

10.400.000đ / tháng

tham chiếu $400

400.000 lượt Places mỗi tháng

Chọn Business

FAQ

Câu hỏi thường gặp

Một lượt gọi API được tính thế nào?

Chỉ request thành công mới bị trừ lượt, kể cả khi kết quả rỗng hoặc lấy từ cache. Lỗi 4xx và 5xx không bị tính tiền.

Cấp thêm khoá API thì có thêm hạn mức không?

Không. Hạn mức tính theo thuê bao, mọi khoá của cùng một tổ chức dùng chung một hạn mức. Cấp nhiều khoá là để tách môi trường và thu hồi riêng khi lộ.

Có xuất hoá đơn VAT không?

Giai đoạn này chỉ có biên nhận thanh toán, chưa có hoá đơn điện tử VAT. Nếu bạn cần hoá đơn để hạch toán, hãy liên hệ trước khi mua.

Dữ liệu bản đồ lấy từ đâu?

Từ hai nguồn mở: OpenStreetMap theo giấy phép ODbL và Foursquare OS Places theo Apache-2.0. Ứng dụng của bạn phải giữ phần ghi nguồn mà SDK hiển thị sẵn.

Hết hạn mức thì chuyện gì xảy ra?

API trả lỗi có cấu trúc nói rõ nhóm nào đã hết và khi nào hồi, để ứng dụng xử lý tử tế. Bạn mua thêm lượt theo khối 1.000 hoặc nâng gói.

Thử trong năm phút

Đăng ký, tự lấy khoá API và gọi request đầu tiên mà không cần chờ ai duyệt.