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: 

curl "https://rsapi.goong.io/v2/place/detail?place_id=Hobn8WqBW6rsKtKq2PDrVKp4BJNRtiILxTQbB__muXgRB3v8GRDTfkp_6lc4cbLw%2F5PUgWrMDrSI%2FxlqDBt5XA%3D%3D.ZXhwYW5kMA%3D%3D&api_key={YOUR_API_KEY}&administrative_unit=old"

Tham số	Mô tả	Ví dụ
place_id	ID duy nhất của địa điểm, dùng để truy vấn thông tin chi tiết của địa điểm đó.	Hobn8WqBW6rsKtKq2PDrVKp4BJNRtiILxTQbB__muXgRB3v8GRDTfkp_ 6lc4cbLw/5PUgWrMDrSI/xlqDBt5XA==.ZXhwYW5kMA==
api_key	Khóa truy cập API cá nhân của bạn, dùng để xác thực khi gọi API.	api_key của bạn
administrative_unit	Đây là tham số không bắt buộc. Để mặc định hoặc administrative_unit= new sẽ trả về kết quả là đơn vị hành chính mới sau khi đã sáp nhập. Thêm tham số administrative_unit=old sẽ trả về kết quả đơn vị hành chính cũ trước khi sáp nhập.	administrative_unit=old

Tham số trong response trả về:

Tham số	Mô tả	Ví dụ
place_id	Mã định danh duy nhất của địa điểm trong hệ thống Goong	Hobn8WqBW6rsKtKq2…xlqDBt5XA==.ZXhwYW5kMA==
formatted_address	Địa chỉ đầy đủ của địa điểm, đã được cập nhật theo địa giới hành chính mới nếu có	“Phường Sao Đỏ, Thành phố Chí Linh, Thành phố Hải Dương”
location.lat	Vĩ độ (latitude) của địa điểm	21.122.345.678
location.lng	Kinh độ (longitude) của địa điểm	106.315.678.901
name	Tên của địa điểm	“91 Nguyễn Trãi”
status	Trạng thái phản hồi API (OK nếu thành công, lỗi khác nếu thất bại)	“OK”