Vietmap Map matching API Playground

    Map matching API

    Làm sạch dữ liệu GPS theo đường đi thực tế với dữ liệu bản đồ. Giải pháp lý tưởng cho các ứng dụng giám sát, theo dõi đơn hàng, hoặc quản lý người dùng.

    Code mẫu

    Thêm đủ tham số bắt buộc để xem code mẫu.

    Phản hồi API

    Nhập thông tin và bấm gửi yêu cầu để xem kết quả

    Map Matching API là gì?

    Map Matching API (match-tolls) làm sạch dữ liệu GPS bằng cách khớp một chuỗi điểm GPS — thường lệch và thưa — vào đúng con đường xe đã đi, và cho biết xe đã qua những trạm thu phí nào cùng mức phí theo loại xe (từ loại 1 đến loại 5). Dữ liệu gửi lên là danh sách tọa độ theo thứ tự thời gian trong body JSON, dạng [kinh độ, vĩ độ].

    Dùng để làm gì

    • Đối soát phí cầu đường cho đội xe.
    • Vẽ lại hành trình thật từ dữ liệu thiết bị giám sát.
    • Tính quãng đường đã chạy chính xác hơn so với nối điểm GPS.
    • Phát hiện xe đi sai tuyến đã giao.

    Request mẫu

    POST https://maps.vietmap.vn/api/match-tolls?apikey=YOUR_API_KEY&vehicle=1
    body: [[106.65388, 10.76272], [106.65327, 10.76241], [106.65270, 10.76278]]

    Chú ý thứ tự [kinh độ, vĩ độ] — ngược với tham số point của Route.

    Câu hỏi thường gặp về Map Matching API

    Map matching là gì?
    Map matching (snap to road) là khớp chuỗi tọa độ GPS — thường bị lệch, nhảy hoặc thưa — vào đúng con đường mà phương tiện thực sự đã đi. Kết quả là hành trình sạch, bám theo mạng lưới đường, dùng để vẽ lại lộ trình và tính quãng đường chính xác.
    API tính phí cầu đường thế nào?
    Từ hành trình đã khớp, match-tolls trả về các trạm thu phí xe đã đi qua cùng mức phí theo loại xe, từ loại 1 đến loại 5, chọn qua tham số vehicle.
    Dữ liệu GPS gửi lên theo định dạng nào?
    Body JSON là mảng tọa độ theo thứ tự thời gian, mỗi điểm dạng [kinh độ, vĩ độ] — ngược với tham số point của Route API.
    Dùng thử Map Matching API có mất phí không?
    Trên Playground có sẵn API key demo để gọi thử Map Matching API ngay trên trình duyệt, không cần đăng ký. Khi tích hợp vào sản phẩm, bạn đăng ký tài khoản VIETMAP để có API key riêng. Phí tính theo transaction, mỗi API quy đổi số request ra transaction theo tỉ lệ riêng; chi tiết và chương trình trải nghiệm miễn phí có trong bảng giá.