Autocomplete API
Tìm kiếm địa điểm với Vietmap Autocomplete API
Bản đồ
Kết quả tìm kiếm
0Nhập thông tin và bấm gửi yêu cầu để xem kết quả
Code mẫu
Ví dụ với tham số mẫu — điền tham số ở khung bên trái để có code đúng request của bạn.
curl 'https://maps.vietmap.vn/api/autocomplete/v4?apikey=YOUR_API_KEY&text=Vietmap&display_type=5&focus=10.7588867%2C106.6755666'Thay YOUR_API_KEY bằng API key của bạn trước khi chạy.
// Khi đưa vào sản phẩm, đọc key từ biến môi trường thay vì ghi cứng.
const API_KEY = "YOUR_API_KEY";
const params = new URLSearchParams([
["apikey", API_KEY],
["text", "Vietmap"],
["display_type", "5"],
["focus", "10.7588867,106.6755666"],
]);
const response = await fetch(`https://maps.vietmap.vn/api/autocomplete/v4?${params}`);
if (!response.ok) {
throw new Error(`Vietmap ${response.status}: ${await response.text()}`);
}
const data = await response.json();
console.log(data);Thay YOUR_API_KEY bằng API key của bạn trước khi chạy.
import requests
# Khi đưa vào sản phẩm, đọc key từ biến môi trường thay vì ghi cứng.
API_KEY = "YOUR_API_KEY"
params = [
("apikey", API_KEY),
("text", "Vietmap"),
("display_type", "5"),
("focus", "10.7588867,106.6755666"),
]
response = requests.get("https://maps.vietmap.vn/api/autocomplete/v4", params=params, timeout=30)
response.raise_for_status()
print(response.json())Thay YOUR_API_KEY bằng API key của bạn trước khi chạy.
https://maps.vietmap.vn/api/autocomplete/v4?apikey=YOUR_API_KEY&text=Vietmap&display_type=5&focus=10.7588867%2C106.6755666Thay YOUR_API_KEY bằng API key của bạn trước khi chạy.
Tôi cần tích hợp Autocomplete API v4 của Vietmap vào ứng dụng của mình.
Tài liệu chính thức: https://maps.vietmap.vn/docs/map-api/autocomplete-version/autocomplete-v4/
Đây là một request mẫu đã chạy được trên Vietmap API Playground:
GET https://maps.vietmap.vn/api/autocomplete/v4?apikey=YOUR_API_KEY&text=Vietmap&display_type=5&focus=10.7588867%2C106.6755666
Tham số đang dùng:
- text = Vietmap
- display_type = 5
- focus = 10.7588867,106.6755666
Hãy viết code bằng [ngôn ngữ / framework của tôi] để gọi API này, với các yêu cầu:
1. Đọc API key từ biến môi trường VIETMAP_API_KEY, không ghi cứng trong code.
2. Truyền tham số qua query string đúng như request mẫu; tham số lặp lại (như `point`) phải giữ nguyên thứ tự.
3. Xử lý lỗi theo mã HTTP của Vietmap:
- 401: API key sai hoặc đã bị thu hồi.
- 403: key bị giới hạn theo domain / IP không khớp.
- 423: API chưa được bật cho consumer của key, HOẶC tài khoản hết credit — phân biệt bằng nội dung phản hồi (có cụm "exceeded credit" là hết credit).
- 429: vượt giới hạn tần suất — thử lại với backoff tăng dần.
4. Đặt timeout cho request, và định nghĩa kiểu dữ liệu (type / interface / dataclass) cho phản hồi.
Nếu không chắc tên một trường, tra trong tài liệu ở link trên thay vì đoán.Dán vào ChatGPT, Claude… để sinh code tích hợp. Prompt không bao giờ chứa API key của bạn.
https://tools.vietmap.vn/playground/autocomplete?text=Vietmap&focus=10.7588867,106.6755666&display_type=5Mở Playground với đúng các tham số này — dùng để gắn vào tài liệu hoặc gửi đồng nghiệp. Link không chứa API key.
Nhập thông tin và bấm gửi yêu cầu để xem kết quả
Autocomplete API là gì?
Autocomplete API là gì?
Autocomplete API gợi ý địa điểm ngay khi người dùng gõ: tên cửa hàng, tòa nhà, số nhà, tên đường. Kết quả có thể ưu tiên theo vị trí hiện tại (focus), giới hạn trong một tỉnh, quận hoặc phường theo cả địa giới mới sau sáp nhập lẫn địa giới cũ, trong một vòng tròn bán kính tùy chọn, hoặc theo danh mục điểm (POI). Tham số display_type cho phép trả địa chỉ theo định dạng mới, cũ hoặc cả hai.
Dùng để làm gì
- Ô tìm địa chỉ giao hàng trong app thương mại điện tử.
- Chọn điểm đón, điểm đến trong app gọi xe.
- Tìm chi nhánh, cửa hàng gần người dùng.
- Chuẩn hóa địa chỉ khách nhập tay trong CRM.
Request mẫu
GET https://maps.vietmap.vn/api/autocomplete/v4?apikey=YOUR_API_KEY&text=Vietmap&focus=10.7588867,106.6755666Mỗi kết quả có ref_id để lấy tọa độ và chi tiết qua Place API.
Câu hỏi thường gặp về Autocomplete API
- Autocomplete API khác gì Geocoding API?
- Autocomplete dùng trong lúc người dùng đang gõ: mỗi lần gõ trả về danh sách gợi ý, mỗi gợi ý có ref_id để lấy tọa độ và chi tiết qua Place API. Geocoding dùng khi đã có địa chỉ đầy đủ và cần tìm vị trí của nó, ví dụ khi xử lý một danh sách địa chỉ có sẵn.
- Có gợi ý theo địa chỉ mới sau sáp nhập không?
- Có. Bộ lọc tỉnh, phường nhận cả địa giới mới lẫn địa giới cũ, và tham số display_type chọn trả địa chỉ theo định dạng mới, cũ hoặc cả hai.
- Làm sao để ưu tiên địa điểm gần người dùng?
- Truyền vị trí hiện tại vào tham số focus (vĩ độ,kinh độ) để kết quả gần điểm đó được xếp trước. Muốn giới hạn hẳn trong một khu vực thì dùng thêm bộ lọc vòng tròn bán kính hoặc tỉnh, phường.
- Dùng thử Autocomplete API có mất phí không?
- Trên Playground có sẵn API key demo để gọi thử Autocomplete API ngay trên trình duyệt, không cần đăng ký. Khi tích hợp vào sản phẩm, bạn đăng ký tài khoản VIETMAP để có API key riêng. Phí tính theo transaction, mỗi API quy đổi số request ra transaction theo tỉ lệ riêng; chi tiết và chương trình trải nghiệm miễn phí có trong bảng giá.