Ô tìm địa điểm cho ứng dụng: gợi ý khi gõ, vị trí của tôi, địa điểm quanh đây

Trả lời nhanh: hiển thị bản đồ Việt Nam trong ứng dụng hoặc website của bạn miễn phí, không cần khóa. Khi người dùng cần tìm một địa điểm — gõ tên để chọn điểm đón, điểm giao, nhà hàng, dự án — bạn gọi API gợi ý của map.vapp.vn bằng khóa: mỗi gợi ý đã có tọa độ, nên chọn xong là ghim được ngay, không cần lệnh thứ hai.

Tạo khóa miễn phí (gói Developer, 20.000 lượt mỗi tháng) và chạy ba lệnh đầu tiên ngay trên trang nhà phát triển.

Dành cho: ứng dụng đặt xe, giao đồ ăn, giao hàng, đặt bàn, du lịch, trang tin bất động sản, và phần mềm có ô "chọn địa điểm".

Bốn phần

1. Bản đồ — miễn phí

Ứng dụng tải kiểu bản đồ https://map.vapp.vn/style.json bằng MapLibre (web, Android, iOS, Flutter). Bản đồ không cần khóa và không tính lượt; ghi công © OpenStreetMap hiện ở góc bản đồ. Làm theo: hướng dẫn tích hợp bản đồ vào ứng dụng Flutter.

2. Gợi ý khi gõ — một lượt mỗi lần gọi

GET /api/v1/autocomplete?q=… trả tên đường, địa danh và cơ sở kinh doanh khớp với chữ đang gõ, kèm loại và tọa độ (mặc định 6 gợi ý, tối đa 15 với limit). Gõ không dấu cũng tìm được: "nha tho duc ba" ra Nhà thờ Đức Bà. Mỗi lần gọi tính một lượt, kể cả khi ô còn trống, nên hãy đợi người dùng dừng gõ khoảng 300 ms và gõ đủ 2–3 ký tự rồi mới gọi: một lần tìm thường chỉ cần 3–5 lượt.

Gợi ý là địa điểm và đường, không phải địa chỉ đầy đủ đến số nhà. Cần đổi một địa chỉ có số nhà thành tọa độ, hoặc kiểm tra địa chỉ giao hàng sau sáp nhập: gói địa chỉ giao hàng.

3. "Vị trí của tôi" — một lượt mỗi lần gọi

GET /api/v1/reverse?lat=…&lng=… trả địa điểm có tên gần nhất với một tọa độ và khoảng cách tới nó, để ứng dụng hiện "Bạn đang ở gần …" khi người dùng bấm nút định vị hoặc kéo ghim.

4. "Quanh đây" — một lượt mỗi lần gọi

GET /api/v1/places?q=…&at=lng,lat trả các địa điểm theo loại (cà phê, nhà thuốc, ATM…) quanh một tọa độ, xếp theo khoảng cách.

Ví dụ

Một tháng có 30 ngày, mỗi lần tìm gọi gợi ý 4 lần. Gói được chọn khi cả hạn mức tháng và hạn mức ngày đều đủ.

Gói tính theo tháng, không tự động tính thêm tiền khi hết hạn mức (API trả mã 429). Hạn mức từng gói và cách nâng cấp: Bảng giá. So sánh với chi phí bạn đang trả cho API bản đồ khác: hướng dẫn tính chi phí.

Giữ khóa an toàn

• Trên website: gọi qua máy chủ của bạn, đừng để khóa trong mã trang web.
• Trong ứng dụng di động: khóa nằm trong ứng dụng đã build nên người khác vẫn lấy được. Vì vậy mỗi khóa có giới hạn theo phút và theo ngày; nếu khóa bị lộ, thu hồi nó trên trang nhà phát triển và tạo khóa mới.

Dữ liệu của người dùng

• Lệnh gợi ý, "vị trí của tôi" và "quanh đây" được ghi vào nhật ký truy vấn — chữ đã gõ, hoặc tọa độ — để cải thiện kết quả, và tự xoá sau 30 ngày (Chính sách bảo mật, mục 3 và 4).
• Chỉ gửi chữ đang gõ hoặc tọa độ: không gửi kèm tên, số điện thoại hay mã tài khoản của người dùng.

Bắt đầu

1. Dựng bản đồ trong ứng dụng theo hướng dẫn Flutter: không cần đăng ký.
2. Tạo khóa miễn phí trên trang nhà phát triển (gói Developer, 20.000 lượt mỗi tháng) và nối ô tìm của ứng dụng vào API gợi ý.
3. Khi cần gói trả phí: gửi yêu cầu báo giá ở trên, hoặc viết tới support@erpfit.com. ERPFit gửi báo giá, hai bên ký hợp đồng, bạn chuyển khoản theo hoá đơn. Không có giỏ hàng hay thanh toán trực tuyến.

Mục đích dùng thông tin: ERPFit chỉ dùng thông tin trong email của bạn để báo giá và liên hệ về báo giá đó, không dùng để gửi quảng cáo và không chia sẻ cho bên thứ ba. Khi gửi email, bạn đồng ý cho ERPFit xử lý thông tin đó cho mục đích trên. Bạn có thể yêu cầu xoá bất kỳ lúc nào qua cùng địa chỉ.