TỔNG QUAN

Place Detail API V2 của Goong là phiên bản nâng cấp cho phép truy xuất thông tin chi tiết của một địa điểm, bao gồm: tên, địa chỉ, vị trí tọa độ, loại hình dịch vụ, giờ hoạt động và các thuộc tính liên quan.

Khác với phiên bản trước, V2 đã cập nhật dữ liệu theo đơn vị hành chính mới, phản ánh các thay đổi sau quá trình sáp nhập tỉnh, huyện, xã trên toàn quốc theo chủ trương của Chính phủ. Điều này giúp đảm bảo thông tin trả về phù hợp với hệ thống địa giới hành chính hiện hành – đặc biệt quan trọng với các hệ thống cần phân tích, quản lý hoặc hiển thị dữ liệu địa lý theo ranh giới hành chính mới.

API trả dữ liệu dưới dạng JSON, dễ tích hợp vào các hệ thống bản đồ số, ứng dụng logistics, phần mềm điều hành giao thông, nền tảng chính phủ số và các hệ thống quản lý có yêu cầu cao về tính chính xác của địa chỉ.

CÁCH THỨC TÍCH HỢP GOONG PLACE DETAIL

Bắt đầu:

Đầu tiên, bạn phải đăng ký tài khoản và tạo API key của Goong theo hướng dẫn chi tiết tại đây.

URL: https://rsapi.goong.io/v2/place/detail

Phương thức: GET

Tham số trong request truyền vào: 

https://rsapi.goong.io/v2/place/detail?place_id=ceemb00pVO95sWtNulG-8kaxRbG6WjCYdY94iKIH79BASozdSlnGY8EaIRS-VTZzjQbCmEmdwnJN0iJEJp1qivHrWTT2XY4iOdLBGUl1gkPl1ipAGVQaAkHeiXS2QB-vQ&api_key={YOUR_API_KEY}&has_deprecated_administrative_unit=true

Tham số trong response trả về:

{
    "result": {
        "place_id": "ceemb00pVO95sWtNulG-8kaxRbG6WjCYdY94iKIH79BASozdSlnGY8EaIRS-VTZzjQbCmEmdwnJN0iJEJp1qivHrWTT2XY4iOdLBGUl1gkPl1ipAGVQaAkHeiXS2QB-vQ",
        "formatted_address": "2/31 Ngô Gia Khảm, Bồ Đề, Hà Nội",
        "geometry": {
            "location": {
                "lat": 21.048178407000023,
                "lng": 105.87687658000004
            }
        },
        "plus_code": {
            "compound_code": "+6XTFW Ngọc Lâm, Long Biên, Hà Nội",
            "global_code": "LOEJ+6XTFW"
        },
        "compound": {
            "commune": "Bồ Đề",
            "province": "Hà Nội"
        },
        "name": "2/31 Ngô Gia Khảm",
        "url": "https://maps.goong.io/?pid=ceemb00pVO95sWtNulG-8kaxRbG6WjCYdY94iKIH79BASozdSlnGY8EaIRS-VTZzjQbCmEmdwnJN0iJEJp1qivHrWTT2XY4iOdLBGUl1gkPl1ipAGVQaAkHeiXS2QB-vQ",
        "types": [
            "house_number"
        ],
        "deprecated_description": "31 Ngõ 2 Ngô Gia Khảm, Ngọc Lâm, Long Biên, Hà Nội",
        "deprecated_compound": {
            "district": "Long Biên",
            "commune": "Ngọc Lâm",
            "province": "Hà Nội"
        }
    },
    "status": "OK"
}