Place

Place phiên bản 3.0¶

Endpoint Place API trả về thông tin chi tiết của địa điểm theo mã định danh (refid).

Quan trọng

Chúng tôi khuyên dùng Place v4 API cho tích hợp mới. Place v3 API sẽ ngừng hỗ trợ trong tương lai.

URL¶

https://maps.vietmap.vn/api/place/v3?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` duy nhất lấy từ kết quả của API tìm kiếm	vm:ADDRESS:8D92EB120DDE9996

Ví dụ¶

Đầu vào:

 https://maps.vietmap.vn/api/place/v3?apikey={your-apikey}&refid=vm:ADDRESS:8D92EB120DDE9996

Phản hồi:

{
    "display": "3 Đường Trần Nhân Tôn Phường 9,Quận 5,Thành Phố Hồ Chí Minh",
    "name": "3 Đường Trần Nhân Tôn",
    "hs_num": "3",
    "street": "Đường Trần Nhân Tôn",
    "address": "",
    "city_id": 12,
    "city": "Thành Phố Hồ Chí Minh",
    "district_id": 1292,
    "district": "Quận 5",
    "ward_id": 984332,
    "ward": "Phường 9",
    "lat": 10.759011645000044,
    "lng": 106.67545328800009
}

Mô tả phản hồi¶

Parameter	Type	Description
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
district	string	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ỉ