NDAMaps Platform Blog https://docs.ndamaps.vn/blog NDAMaps Platform Blog Wed, 05 Nov 2025 03:09:40 GMT https://validator.w3.org/feed/docs/rss2.html https://github.com/jpmonette/feed vi <![CDATA[NDAMaps cập nhật dữ liệu sáp nhập tỉnh mới]]> https://docs.ndamaps.vn/blog/openmap-updates-administrative-boundary-data https://docs.ndamaps.vn/blog/openmap-updates-administrative-boundary-data Wed, 05 Nov 2025 03:09:40 GMT Chúng tôi rất vui mừng thông báo rằng NDAMaps đã được cập nhật với dữ liệu mới nhất về việc sáp nhập các tỉnh thành tại Việt Nam. Với bản cập nhật này, các nhà phát triển có thể dễ dàng chuyển đổi giữa dữ liệu cũ và mới chỉ bằng cách thêm một tham số đơn giản.

🎯 Tính năng mới: Tham số admin_v2​

Để hỗ trợ việc chuyển đổi giữa dữ liệu cũ và mới, chúng tôi đã thêm tham số admin_v2 vào tất cả các API liên quan:

Các API được cập nhật:​

  • Autocomplete API - Google format & OSM format
  • Forward Geocoding API - Google format & OSM format
  • Reverse Geocoding API - Google format & OSM format
  • Place Detail API
  • Nearby Search API
  • Children API
  • Routing API
  • Optimized Route API

Cách sử dụng:​

# Sử dụng dữ liệu cũ (mặc định)
GET /autocomplete?input=Hà Nội&apikey=YOUR_API_KEY

# Sử dụng dữ liệu mới sau sáp nhập
GET /autocomplete?input=Hà Nội&admin_v2=true&apikey=YOUR_API_KEY

📊 Thông tin tham số​

Tham sốLoạiBắt buộcMặc địnhMô tả
admin_v2booleankhôngfalseTrả về thông tin địa điểm mới sau sát nhập địa giới hành chính

🔄 Ví dụ chuyển đổi​

Trước khi sáp nhập (dữ liệu cũ):​

{
  "bbox": [105.777981, 21.022776999999998, 105.79798100000001, 21.042777],
  "errors": null,
  "features": [
    {
      "geometry": {
        "coordinates": [105.787981, 21.032777],
        "type": "Point"
      },
      "properties": {
        "category": ["corporate_office"],
        "continent": "Asia",
        "country": "Việt Nam",
        "country_code": "VN",
        "county": "quận Cầu Giấy",
        "distance": null,
        "has_child": false,
        "housenumber": null,
        "id": "BFMhbS2hGqAeWlxPGNjnClF6aYQk3F1-nXJxZZjAncYpdqHZSNzpfi0W3RCU",
        "label": "Công Ty TNHH Công Nghệ 44+, 12 Ngõ 1 Dịch Vọng Hậu, phường Dịch Vọng Hậu, quận Cầu Giấy, thành phố Hà Nội",
        "locality": "phường Dịch Vọng Hậu",
        "name": "Công Ty TNHH Công Nghệ 44+",
        "phone": "+84838777777",
        "postalcode": null,
        "region": "thành phố Hà Nội",
        "short_address": "12 Ngõ 1 Dịch Vọng Hậu",
        "sid": "6b5a5645ae59810e",
        "source": "ndamapvn",
        "street": null,
        "website": "https://44plus.vn/"
      },
      "type": "Feature"
    }
  ],
  "type": "FeatureCollection"
}

Sau khi sáp nhập (dữ liệu mới):​

{
  "bbox": [105.777981, 21.022776999999998, 105.79798100000001, 21.042777],
  "errors": null,
  "features": [
    {
      "geometry": {
        "coordinates": [105.787981, 21.032777],
        "type": "Point"
      },
      "properties": {
        "category": ["corporate_office"],
        "continent": "Asia",
        "country": "Việt Nam",
        "country_code": "VN",
        "county": "",
        "distance": null,
        "has_child": false,
        "housenumber": null,
        "id": "BFMhbS2hGqAeWlxPGNjnClF6aYQk3F1-nXJxZZjAncYpdqHZSNzpfi0W3RCU",
        "label": "Công Ty TNHH Công Nghệ 44+, 12 Ngõ 1 Dịch Vọng Hậu, phường Cầu Giấy, thành phố Hà Nội",
        "locality": "phường Cầu Giấy",
        "name": "Công Ty TNHH Công Nghệ 44+",
        "phone": "+84838777777",
        "postalcode": null,
        "region": "thành phố Hà Nội",
        "short_address": "12 Ngõ 1 Dịch Vọng Hậu",
        "sid": "6b5a5645ae59810e",
        "source": "ndamapvn",
        "street": null,
        "website": "https://44plus.vn/"
      },
      "type": "Feature"
    }
  ],
  "type": "FeatureCollection"
}

🚀 Lợi ích​

  1. Tương thích ngược: Các ứng dụng hiện tại vẫn hoạt động bình thường
  2. Linh hoạt: Dễ dàng chuyển đổi giữa dữ liệu cũ và mới
  3. Cập nhật tự động: Dữ liệu mới nhất về ranh giới hành chính
  4. Đơn giản: Chỉ cần thêm một tham số boolean

📝 Lưu ý quan trọng​

  • Tham số admin_v2 là tùy chọn và mặc định là false
  • Khi admin_v2=true, API sẽ trả về dữ liệu mới nhất sau sáp nhập
  • Khi admin_v2=false hoặc không có, API sẽ trả về dữ liệu cũ
  • Tất cả các API đều hỗ trợ tham số này

🔗 Tài liệu chi tiết​

Để biết thêm thông tin chi tiết về cách sử dụng tham số admin_v2 trong từng API cụ thể, vui lòng tham khảo:

💬 Hỗ trợ​

Nếu bạn có bất kỳ câu hỏi nào về tính năng mới này, đừng ngần ngại liên hệ với chúng tôi:

Cập nhật lần cuối: Tháng 12, 2024

]]> api update administrative-boundaries vietnam