Vietmap Reverse Geocoding API Playground

    Reverse API

    Xác định địa điểm từ tọa độ với Vietmap Reverse API

    Kết quả Reverse Geocoding

    Nhấp "Tra cứu ngược" để xem kết quả cho tọa độ đã chọn

    Code mẫu

    curl 'https://maps.vietmap.vn/api/reverse/v4?apikey=YOUR_API_KEY&lat=10.7778046&lng=106.7019192&display_type=6'

    Thay YOUR_API_KEY bằng API key của bạn trước khi chạy.

    // Khi đưa vào sản phẩm, đọc key từ biến môi trường thay vì ghi cứng.
    const API_KEY = "YOUR_API_KEY";
    
    const params = new URLSearchParams([
      ["apikey", API_KEY],
      ["lat", "10.7778046"],
      ["lng", "106.7019192"],
      ["display_type", "6"],
    ]);
    
    const response = await fetch(`https://maps.vietmap.vn/api/reverse/v4?${params}`);
    if (!response.ok) {
      throw new Error(`Vietmap ${response.status}: ${await response.text()}`);
    }
    const data = await response.json();
    console.log(data);

    Thay YOUR_API_KEY bằng API key của bạn trước khi chạy.

    import requests
    
    # Khi đưa vào sản phẩm, đọc key từ biến môi trường thay vì ghi cứng.
    API_KEY = "YOUR_API_KEY"
    
    params = [
        ("apikey", API_KEY),
        ("lat", "10.7778046"),
        ("lng", "106.7019192"),
        ("display_type", "6"),
    ]
    
    response = requests.get("https://maps.vietmap.vn/api/reverse/v4", params=params, timeout=30)
    response.raise_for_status()
    print(response.json())

    Thay YOUR_API_KEY bằng API key của bạn trước khi chạy.

    https://maps.vietmap.vn/api/reverse/v4?apikey=YOUR_API_KEY&lat=10.7778046&lng=106.7019192&display_type=6

    Thay YOUR_API_KEY bằng API key của bạn trước khi chạy.

    Tôi cần tích hợp Reverse API v4 của Vietmap vào ứng dụng của mình.
    
    Tài liệu chính thức: https://maps.vietmap.vn/docs/map-api/reverse-version/reverse-v4/
    
    Đây là một request mẫu đã chạy được trên Vietmap API Playground:
    
    GET https://maps.vietmap.vn/api/reverse/v4?apikey=YOUR_API_KEY&lat=10.7778046&lng=106.7019192&display_type=6
    
    Tham số đang dùng:
    - lat = 10.7778046
    - lng = 106.7019192
    - display_type = 6
    
    Hãy viết code bằng [ngôn ngữ / framework của tôi] để gọi API này, với các yêu cầu:
    1. Đọc API key từ biến môi trường VIETMAP_API_KEY, không ghi cứng trong code.
    2. Truyền tham số qua query string đúng như request mẫu; tham số lặp lại (như `point`) phải giữ nguyên thứ tự.
    3. Xử lý lỗi theo mã HTTP của Vietmap:
       - 401: API key sai hoặc đã bị thu hồi.
       - 403: key bị giới hạn theo domain / IP không khớp.
       - 423: API chưa được bật cho consumer của key, HOẶC tài khoản hết credit — phân biệt bằng nội dung phản hồi (có cụm "exceeded credit" là hết credit).
       - 429: vượt giới hạn tần suất — thử lại với backoff tăng dần.
    4. Đặt timeout cho request, và định nghĩa kiểu dữ liệu (type / interface / dataclass) cho phản hồi.
    
    Nếu không chắc tên một trường, tra trong tài liệu ở link trên thay vì đoán.

    Dán vào ChatGPT, Claude… để sinh code tích hợp. Prompt không bao giờ chứa API key của bạn.

    Reverse Geocoding API là gì?

    Reverse Geocoding API làm ngược lại Geocoding: từ một tọa độ trả về địa chỉ và tên địa điểm gần nhất. Phiên bản v4 có display_type để lấy địa chỉ theo đơn vị hành chính mới, cũ hoặc cả hai — tiện khi dữ liệu cần khớp với hệ thống đang dùng địa giới cũ. Thường dùng sau khi lấy vị trí GPS của thiết bị hoặc khi người dùng chạm vào một điểm trên bản đồ.

    Dùng để làm gì

    • Hiển thị địa chỉ hiện tại của tài xế, shipper.
    • Điền sẵn địa chỉ khi người dùng chọn điểm trên bản đồ.
    • Gắn địa chỉ cho dữ liệu GPS, ảnh chụp hiện trường.
    • Xác định tỉnh, phường của một vị trí để tính phí.

    Request mẫu

    GET https://maps.vietmap.vn/api/reverse/v4?apikey=YOUR_API_KEY&lat=21.028511&lng=105.854165&display_type=1

    Bản v3 vẫn dùng được để đối chiếu; trang này cho chuyển qua lại.

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

    Reverse geocoding là gì?
    Reverse geocoding (tra địa chỉ ngược) là chuyển một tọa độ vĩ độ, kinh độ thành địa chỉ đọc được. Thường dùng sau khi lấy vị trí GPS của điện thoại, thiết bị giám sát, hoặc khi người dùng chạm vào một điểm trên bản đồ.
    Có lấy được địa chỉ theo đơn vị hành chính cũ không?
    Có. Tham số display_type của v4 chọn trả địa chỉ theo đơn vị hành chính mới, cũ hoặc cả hai, tiện khi hệ thống của bạn vẫn lưu địa giới cũ.
    Reverse v3 và v4 khác nhau thế nào?
    v4 là bản mới, có display_type cho địa chỉ mới và cũ. v3 vẫn hoạt động; trang này cho chuyển qua lại giữa hai bản để so sánh kết quả trên cùng một điểm.
    Dùng thử Reverse Geocoding API có mất phí không?
    Trên Playground có sẵn API key demo để gọi thử Reverse Geocoding 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á.