Thay thế Google Maps API tại Việt Nam

Ba lý do lặp đi lặp lại trong các dự án chúng tôi tiếp nhận: chi phí tính bằng USD nên đội lên mỗi khi tỷ giá biến động, không xuất được hoá đơn VAT hợp lệ cho kế toán Việt Nam, và dữ liệu ngõ ngách trong nước thường thiếu hoặc lỗi thời so với thực tế.

Với ứng dụng giao vận hoặc gọi xe, chi phí Geocoding và Distance Matrix chiếm phần lớn hoá đơn hạ tầng. Chuyển sang nhà cung cấp trong nước thường cắt được quá nửa khoản này mà không phải đánh đổi độ chính xác — vì dữ liệu địa chỉ Việt Nam vốn là thứ nhà cung cấp nội địa làm tốt hơn.

• Giá niêm yết cố định bằng VNĐ, không chịu rủi ro tỷ giá
• Hoá đơn điện tử VAT hợp pháp cho mọi gói dịch vụ
• Máy chủ đặt tại Việt Nam, độ trễ dưới 18ms, không đi qua cáp quang biển
• Địa chỉ cập nhật theo đơn vị hành chính mới sau sáp nhập 2025

Các endpoint tương thích giữ nguyên đường dẫn của Google. Bạn chỉ thay tên miền và khoá API:

// Trước — Google Maps Platform
const url = "https://maps.googleapis.com/maps/api/geocode/json"
  + "?address=" + encodeURIComponent(diaChi)
  + "&key=" + GOOGLE_KEY;

// Sau — ViGo Maps, giữ nguyên phần còn lại của code
const url = "https://routing.vigodev.online/maps/api/geocode/json"
  + "?address=" + encodeURIComponent(diaChi)
  + "&api_key=" + VIGO_KEY;

const { results, status } = await (await fetch(url)).json();
// results[0].address_components, .formatted_address ... đều giữ nguyên

• Phường / xã trả về song song hai nhãn administrative_area_level_3 và sublocality_level_1, để code cũ đọc theo nhãn nào cũng chạy.
• Mọi phản hồi đều trả HTTP 200; mã trạng thái nằm trong trường status của body, giống cách Google làm.
• Các trường chưa hỗ trợ (ảnh, đánh giá, giờ mở cửa) bị lược bỏ hẳn thay vì trả về rỗng — hãy kiểm tra tồn tại trước khi đọc.