Place Autocomplete API cho tiếng Việt
Ô nhập địa chỉ là nơi đơn hàng hay bị hỏng nhất. Người dùng gõ vội, không dấu, viết tắt — nếu ô tìm kiếm không gợi ý được thì họ gõ đại, và bên giao hàng lãnh hậu quả.
Gợi ý theo từng ký tự, hiểu tiếng Việt không dấu
Autocomplete trả kết quả trong dưới 15ms nên gọi được ngay trên mỗi lần gõ phím. Bộ tìm kiếm khớp cả chuỗi không dấu với dữ liệu có dấu, nên gõ “nguyen hue q1” vẫn ra “Đường Nguyễn Huệ, Quận 1”.
curl "https://routing.vigodev.online/v2/place/autocomplete\
?input=nguyen%20hue%20q1\
&location=10.7769,106.7009\
&limit=8\
&api_key=API_KEY"Truyền thêm location là toạ độ hiện tại của người dùng để ưu tiên địa điểm quanh họ. Bỏ tham số này thì kết quả xếp theo độ nổi tiếng.
Ba API tạo thành một luồng hoàn chỉnh
| Bước | Endpoint | Nhiệm vụ |
|---|---|---|
| 1. Gợi ý khi gõ | /v2/place/autocomplete | Trả danh sách gợi ý kèm place_id |
| 2. Lấy chi tiết | /v2/place/detail | Từ place_id lấy địa chỉ chuẩn hoá và toạ độ |
| 3. Tìm quanh đây | /v2/place/nearby | Liệt kê POI quanh một toạ độ, lọc theo nhóm ngành |
Nearby POI phục vụ các tính năng kiểu “quán gần tôi”, tìm trạm sạc, cây xăng, ATM hay nhà thuốc. Kết quả đã sắp sẵn theo khoảng cách tăng dần nên phía ứng dụng không phải tính lại.
Cơ sở dữ liệu địa điểm
- Hơn 6 triệu điểm POI trên toàn quốc: toà nhà, trường học, bệnh viện, cây xăng, ATM, nhà thuốc
- Bao phủ đủ 4 cấp hành chính, cập nhật theo đơn vị mới sau sáp nhập 2025
- Xếp hạng kết quả theo độ nổi tiếng, có thể đảo sang ưu tiên theo khoảng cách
Câu hỏi thường gặp
Autocomplete có hiểu tiếng Việt không dấu không?
Có. Bộ tìm kiếm khớp chuỗi không dấu với dữ liệu có dấu, đồng thời xử lý chữ viết tắt cấp hành chính, nên gõ vội vẫn ra đúng địa điểm.
Gọi API mỗi lần gõ phím có bị chậm hoặc tốn phí không?
Thời gian phản hồi dưới 15ms nên gọi theo từng ký tự vẫn mượt. Thực tế nên đặt debounce khoảng 200ms ở phía ứng dụng để giảm số lượt gọi mà người dùng không cảm nhận được độ trễ.
Sau khi người dùng chọn gợi ý thì lấy toạ độ ở đâu?
Mỗi gợi ý kèm một place_id. Gọi tiếp /v2/place/detail với place_id đó để nhận địa chỉ chuẩn hoá đầy đủ và toạ độ chính xác.
Xem thêm
Cần tư vấn cho khối lượng lớn?
Đội kỹ sư trực 24/7, hỗ trợ tích hợp và báo giá theo lưu lượng thực tế.
Hotline 0972289864