Câu hỏi thường gặp

Bản đồ không tải, hiện lỗi "Google Maps JavaScript API error"?

1. Kiểm tra API key đã cấu hình trong Settings → Map Configuration chưa.
2. Đảm bảo API key hợp lệ và chưa hết hạn trên Google Cloud Console.
3. API key cần được cấp quyền cho Maps JavaScript API. Kiểm tra trong Google Cloud Console → APIs & Services.
4. Nếu key bị restrict theo domain, đảm bảo domain ứng dụng nằm trong danh sách cho phép.

Geo field không hiển thị map picker trong form?

• Đảm bảo API key đã cấu hình — field widget cần load Google Maps API.
• Kiểm tra kết nối internet ổn định.
• Nếu dùng trong môi trường private network, Google Maps API cần accessible từ trình duyệt.

Marker clustering không hoạt động?

Marker clustering chỉ hoạt động khi có nhiều marker trên bản đồ. Nếu ít record hoặc các marker cách xa nhau, chúng hiển thị riêng lẻ thay vì gom nhóm.

Polygon/LineString vẽ không đúng hình dạng?

• Kiểm tra thứ tự tọa độ: [longitude, latitude] (lng trước, lat sau).
• Polygon cần ít nhất 3 điểm và điểm cuối tự động nối với điểm đầu.
• Nếu import dữ liệu, đảm bảo format tọa độ đúng chuẩn GeoJSON.

Có thể dùng provider khác ngoài Google Maps không?

Hiện tại plugin chỉ hỗ trợ Google Maps. Kiến trúc cho phép mở rộng thêm provider nhưng cần development effort.

Map block tải chậm?

Google Maps JavaScript API tải từ CDN — lần đầu có thể chậm. Sau đó trình duyệt cache lại. Nếu collection có nhiều record, sử dụng filter để giới hạn số lượng marker hiển thị.