Ưu ĐãiƯu đãi tháng: Tặng ngay 25.000 lượt gọi API miễn phí trải nghiệm cho doanh nghiệp!

Geocoding API cho địa chỉ Việt Nam

Geocoding là bước biến một dòng địa chỉ do người dùng gõ thành cặp kinh độ - vĩ độ mà hệ thống dùng được. Với địa chỉ Việt Nam, phần khó không nằm ở thuật toán tìm kiếm mà ở việc hiểu cách người Việt thật sự viết địa chỉ.

Geocoding và Reverse Geocoding khác nhau thế nào

Geocoding (còn gọi là forward geocoding, mã hoá địa lý) đi từ địa chỉ ra toạ độ: đưa vào chuỗi “Số 1 Đại Cồ Việt, Hai Bà Trưng, Hà Nội”, nhận về cặp kinh độ - vĩ độ để ghim marker lên bản đồ hoặc tính quãng đường.

Reverse geocoding đi ngược lại: đưa vào toạ độ GPS lấy từ điện thoại tài xế, nhận về địa chỉ hành chính đầy đủ để in lên đơn hàng hoặc biên lai. Cùng một endpoint, khác tham số.

bash
# Địa chỉ -> toạ độ
curl "https://routing.vigodev.online/Geocode?address=so%201%20dai%20co%20viet%20hbt%20hn&api_key=API_KEY"

# Toạ độ -> địa chỉ
curl "https://routing.vigodev.online/Geocode?latlng=21.0057,105.8438&api_key=API_KEY"

Cái khó của địa chỉ Việt Nam

Người dùng gõ địa chỉ theo thói quen chứ không theo chuẩn. Một bộ geocoder chỉ khớp chuỗi sẽ trượt gần hết các trường hợp thật:

Người dùng gõHệ thống phải hiểu là
ngo 120/42/15 hoang quoc vietNgách 15, Ngõ 120/42 Hoàng Quốc Việt, P. Nghĩa Tân, Q. Cầu Giấy, Hà Nội
q1 p ben nghe d cmt8Đường Cách Mạng Tháng 8, P. Bến Nghé, Quận 1, TP. Hồ Chí Minh
so 1 dai co viet hbt hnSố 1 Đại Cồ Việt, P. Lê Đại Hành, Q. Hai Bà Trưng, Hà Nội

ViGo Maps xử lý bằng mô hình ngôn ngữ huấn luyện riêng trên địa danh 63 tỉnh thành: bỏ dấu, viết tắt cấp hành chính (q., p., tt., đ.), ngõ - ngách - hẻm lồng nhau, tên đường cũ đã đổi, và lỗi chính tả phổ biến. Độ chính xác đo được là 99.8%, thời gian phản hồi reverse khoảng 12ms.

Ứng dụng thực tế

  • Thương mại điện tử: chuẩn hoá địa chỉ giao hàng ngay lúc khách đặt đơn, giảm đơn giao hỏng vì địa chỉ mơ hồ.
  • Giao vận: chuyển hàng nghìn địa chỉ đơn hàng thành toạ độ để đưa vào bài toán tối ưu lộ trình.
  • Tài chính - bảo hiểm: xác minh địa chỉ khách hàng, chấm điểm rủi ro theo khu vực.
  • Bán lẻ: chấm toàn bộ cửa hàng lên bản đồ để phân tích vùng phủ và chọn mặt bằng mới.

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

Geocoding API là gì?

Geocoding API là dịch vụ chuyển thông tin địa chỉ dạng văn bản thành toạ độ địa lý (kinh độ, vĩ độ) và ngược lại. Đây là nền tảng cho mọi tính năng liên quan tới vị trí: hiển thị bản đồ, tính khoảng cách, chỉ đường và phân tích vùng phủ.

Gõ địa chỉ không dấu có ra kết quả đúng không?

Có. Bộ chuẩn hoá xử lý tiếng Việt không dấu, chữ viết tắt cấp hành chính và lỗi chính tả thường gặp, trả về địa chỉ đầy đủ có dấu kèm toạ độ.

Địa chỉ theo đơn vị hành chính cũ có tra được không?

Được. Ngoài Geocoding, ViGo Maps có Migrate Address API chuyển đổi hai chiều giữa đơn vị hành chính cũ và mới sau đợt sáp nhập tỉnh xã 2025, giữ nguyên số nhà và ngách hẻm.

Xem thêm

Cần tư vấn cho khối lượng lớn?

Đội kỹ sư trực 24/7, hỗ trợ tích hợp và báo giá theo lưu lượng thực tế.

Hotline 0972289864