gmapTìm kiếm địa chỉ & địa điểm
Tìm theo tên đường, số nhà, tên địa điểm hoặc khu vực; kết quả là GeoJSON với tọa độ và nhãn địa chỉ đầy đủ.
Tài liệuGMap Cloud · Địa chỉ & POI
API tìm kiếm địa chỉ và địa điểm (POI) tại Việt Nam
Người dùng gõ địa chỉ hoặc chọn một điểm, API trả về địa chỉ đầy đủ, tọa độ và đơn vị hành chính. Một kết quả có thể kèm cả cách ghi mới (2 cấp) lẫn cách ghi cũ (3 cấp).
Khả năng chính
Gợi ý khi gõ
Hiện gợi ý ngay khi người dùng gõ, hợp với ô nhập địa chỉ lúc đặt hàng hay đăng ký.
Tài liệuTra cứu ngược từ tọa độ
Tìm địa chỉ và địa điểm gần một vị trí; chọn bộ dữ liệu addr34, addr63, poi34 hoặc poi63.
Tài liệuMã bưu chính & tọa độ VN-2000
Kết quả có mã bưu chính; tra cứu ngược kèm tọa độ VN-2000 theo múi chiếu của tỉnh.
Tài liệuVí dụ API
Tìm một địa điểm
curl --get 'https://cloud.gmap.vn/api/idunn/v1/search' \
--header 'x-api-key: public-gmap-cloud-x-api-key-demo' \
--data-urlencode 'q=Hồ Hoàn Kiếm' \
--data-urlencode 'lang=vi'{
"type": "FeatureCollection",
"features": [{
"type": "Feature",
"geometry": { "type": "Point", "coordinates": [105.8538789, 21.0282616] },
"properties": {
"geocoding": {
"type": "poi",
"name": "Hồ Gươm - Hồ Hoàn Kiếm",
"label": "Hồ Gươm - Hồ Hoàn Kiếm, Phường Hoàn Kiếm, Thành phố Hà Nội, Việt Nam",
"postcode": "11024"
}
}
}]
}Trích các trường chính từ phản hồi API demo ngày 11/10/2026. GeoJSON đặt kinh độ trước vĩ độ.
Tra cứu ngược: địa chỉ theo 63 tỉnh và 34 tỉnh tại cùng tọa độ
curl 'https://cloud.gmap.vn/api/idunn/v1/reverse/21.0282616:105.8538789?lang=vi&subtype=addr63' \
--header 'x-api-key: public-gmap-cloud-x-api-key-demo'[{
"type": "address",
"subtype": "addr63",
"name": "79 Đinh Tiên Hoàng",
"address": {
"label": "79 Đinh Tiên Hoàng, Phường Lý Thái Tổ, Quận Hoàn Kiếm, Thành phố Hà Nội, Việt Nam"
},
"coord_vn2000": { "x": 588588.625, "y": 2326322.464, "epsg": "EPSG:5897", "zone_key": "vn2000-tm3-482" }
}]
// subtype=addr34 → "79 Đinh Tiên Hoàng, Phường Hoàn Kiếm, Thành phố Hà Nội, Việt Nam"Ứng dụng thường gặp
Ô nhập địa chỉ khi đặt hàng
Gợi ý địa chỉ đúng chính tả và trả tọa độ để tính phí giao hàng.
Cập nhật dữ liệu khách hàng sau sáp nhập
Đối chiếu địa chỉ đang lưu theo mô hình cũ với nhãn địa chỉ mới tại cùng vị trí.
Hiển thị địa điểm quanh người dùng
Tra cứu POI theo bán kính hoặc khung nhìn bản đồ để hiển thị cửa hàng, dịch vụ gần nhất.
Hướng dẫn liên quan
- Năm phút đầu tiên với GMap Cloud: gọi API và hiện bản đồDùng khóa demo để tìm một địa điểm, đọc kết quả GeoJSON và hiện nó trên bản đồ Việt Nam bằng MapLibre, chỉ với vài dòng mã.
- Địa chỉ sau sáp nhập: đối chiếu địa chỉ cũ và mới bằng APITừ 01/07/2025 Việt Nam còn 34 tỉnh và bỏ cấp huyện. Cách dùng tọa độ và API tra cứu ngược để đối chiếu địa chỉ 63 tỉnh với địa chỉ 34 tỉnh.
- Làm ô nhập địa chỉ có gợi ý cho trang đặt hàngMã JavaScript cho ô nhập địa chỉ gợi ý khi gõ: chờ người dùng ngừng gõ, hủy yêu cầu cũ, lưu nhãn và tọa độ vào đơn hàng.
- Chuyển từ Google Maps Platform sang GMap Cloud: bảng đối chiếu APIBảng đối chiếu Maps JavaScript, Geocoding, Places Autocomplete, Directions và Distance Matrix với API GMap Cloud, kèm những khác biệt cần sửa trong mã.
Câu hỏi thường gặp
API có trả về địa chỉ cũ và mới không?
Tra cứu ngược với subtype=addr34 trả địa chỉ theo mô hình 34 tỉnh, hai cấp; subtype=addr63 trả địa chỉ theo mô hình 63 tỉnh, ba cấp. Khả năng có đủ cả hai phiên bản phụ thuộc từng bản ghi.
Tọa độ trong kết quả theo thứ tự nào?
geometry.coordinates theo chuẩn GeoJSON: kinh độ trước, vĩ độ sau. Đường dẫn tra cứu ngược nhận vĩ độ trước, kinh độ sau: /reverse/{lat}:{lon}.
Khóa demo có giới hạn gì?
Khóa demo công khai dùng để đánh giá và có giới hạn lưu lượng. Khóa cho môi trường vận hành được cấp theo nhóm API, khu vực và lưu lượng thống nhất với GMap.