Place v4

Place phiên bản dùng cho tìm kiếm địa chỉ sau sáp nhập¶

Endpoint API Place trả về thông tin chi tiết của một địa điểm trên bản đồ theo mã định danh (refid) lấy từ kết quả tìm kiếm địa chỉ hoặc geocoding.

URL¶

https://maps.vietmap.vn/api/place/v4?apikey={your-apikey}&refid={refid}

Method¶

GET

Tham số¶

Tham số	Kiểu	Bắt buộc	Mô tả	Ví dụ
apikey	string	có	API key VIETMAP cấp cho tài khoản của bạn. Đăng ký tại đây
refid	string	có	Mã `refid` lấy nguyên xi từ kết quả Autocomplete hoặc Geocode. Giữ cả tiền tố (`auto:`, `geocode:`) — tiền tố quyết định định dạng phản hồi	auto:RAkPcicmZ3d-NQ...

Ví dụ¶

Đầu vào:

 https://maps.vietmap.vn/api/place/v4?apikey={your-apikey}&refid=auto:RAkPcicmZ3d-NQhac2kADHYlbFAkBiEeAQAkCV0EXwdF_KakgoWOrg0FFWZfh4jFXA1kXfbZFlNRGFUYCAJXAF8BUQBVCAZUC18EA1VMAwUYXwJQBBQFBQVTHVFacANBQlU

Phản hồi:

Lưu ý: Cấu trúc phản hồi tự động khớp với định dạng của API đã sinh ra refid. Nếu refid lấy từ phản hồi định dạng mới thì phản hồi cũng theo định dạng mới, và ngược lại.

{
    "display": "197 Đường Trần Phú,Phường Chợ Quán,Thành Phố Hồ Chí Minh",
    "name": "",
    "hs_num": "197",
    "street": "Đường Trần Phú",
    "address": "197 Đường Trần Phú",
    "city_id": 12,
    "city": "Thành Phố Hồ Chí Minh",
    "district_id": 0,
    "district": "",
    "ward_id": 18700,
    "ward": "Phường Chợ Quán",
    "lat": 10.759222947000069,
    "lng": 106.67590269100003
}

Mô tả phản hồi¶

Trường	Kiểu	Mô tả
display	string	Tên hiển thị chứa đầy đủ thông tin của địa chỉ
name	string	Tên đường hoặc tên địa điểm
hs_num	string	Số nhà hoặc số tòa nhà
street	string	Tên đường
address	string	Thông tin địa chỉ bổ sung (nếu có)
city_id	int	Mã định danh của tỉnh/thành phố
city	string	Tên tỉnh/thành phố
district_id	int	Mã định danh của quận/huyện. Hiện luôn là `0` với định dạng hiển thị mới. Với định dạng cũ thì đây là mã quận/huyện.
district	string	Tên quận/huyện. Hiện luôn là chuỗi rỗng với định dạng hiển thị mới. Với định dạng cũ thì đây là tên quận/huyện.
ward_id	int	Mã định danh của phường/xã
ward	string	Tên phường/xã
lat	number	Vĩ độ của địa chỉ
lng	number	Kinh độ của địa chỉ