Chuẩn bị dữ liệu

Trước khi tải dữ liệu cửa hàng lên Store Directory, bạn cần chuẩn bị file đúng định dạng. Đây là bước quan trọng nhất — phần lớn lỗi khi tải lên đều bắt nguồn từ file chưa chuẩn. Dành vài phút làm đúng ở đây sẽ giúp các bước sau diễn ra trơn tru.

Hệ thống nhận dữ liệu dạng nào?

Định dạng	Dùng khi nào
CSV	Bạn có danh sách cửa hàng dạng bảng (tên, địa chỉ, tọa độ, điện thoại...). Đây là cách phổ biến nhất.
Shapefile	Bạn đã có sẵn lớp điểm bán dạng GIS từ phần mềm bản đồ chuyên dụng.
GeoJSON · KML · GPKG · GML	Dữ liệu đã có sẵn tọa độ, tải thẳng không cần cấu hình gì thêm.
Google Sheet	Bảng tính đang nằm trên Google Drive — dán đường dẫn, không phải xuất ra tệp.

Dù tải lên bằng định dạng nào, mỗi bản ghi trên bản đồ đều là một điểm — một cửa hàng, một chi nhánh, một điểm bán. Với file CSV, mỗi dòng là một điểm kèm tọa độ.

Chuẩn bị file CSV

Nguyên tắc cơ bản

• Dòng đầu tiên là tiêu đề cột (tên các trường): ví dụ Tên, Địa chỉ, Điện thoại, Kinh độ, Vĩ độ.
• Mỗi dòng tiếp theo là một cửa hàng.
• Mỗi cột là một thông tin (thuộc tính) của cửa hàng.

Ví dụ:

Tên,Địa chỉ,Điện thoại,Kinh độ,Vĩ độ
Cửa hàng A,"123 Đường Số 1, Khu A",0900000001,106.700,10.776
Cửa hàng B,"456 Đường Số 2, Khu B",0900000002,106.686,10.782

Cột tọa độ là bắt buộc

Đây là phần quan trọng nhất với file CSV. Bạn cần hai cột tọa độ để hệ thống biết đặt cửa hàng ở đâu trên bản đồ:

• Kinh độ (Longitude) — ví dụ 106.700.
• Vĩ độ (Latitude) — ví dụ 10.776.

Yêu cầu về tọa độ:

• Dùng độ thập phân (decimal degrees), ví dụ 106.700 — không dùng định dạng độ-phút-giây (106°42'...).
• Dùng dấu chấm làm dấu thập phân (106.700), không dùng dấu phẩy.
• Hệ tọa độ WGS84 (chuẩn GPS thông dụng).
• Nếu cửa hàng hiện ra sai vị trí hoặc hai giá trị trông như bị đảo, khả năng cao bạn đã gán nhầm cột Kinh độ ↔ Vĩ độ.

Khi tải lên, hệ thống sẽ hỏi bạn cột nào là Kinh độ (Long), cột nào là Vĩ độ (Lat) — vì vậy bạn không bắt buộc phải đặt đúng tên, nhưng đặt tên rõ ràng sẽ giúp chọn nhanh hơn.

Dấu phân cách phải là dấu phẩy

Đây là cái bẫy hay gặp nhất mà lại khó đoán ra nhất.

Hệ thống tách các cột trong dòng tiêu đề theo dấu phẩy, và chỉ dấu phẩy. Nếu file của bạn dùng dấu chấm phẩy (;) để phân cách, cả dòng tiêu đề sẽ bị coi là một cột duy nhất — tới bước chọn cột tọa độ, ô chọn Kinh độ/Vĩ độ chỉ hiện đúng một dòng dài vô nghĩa và bạn không chọn được gì.

Mã hóa UTF-8 (tránh lỗi tiếng Việt)

Để tiếng Việt không bị lỗi font (thành ký tự lạ như Cá), hãy lưu file CSV ở mã hóa UTF-8. Xem cách làm ở phần Excel/Google Sheets.

Các cột thông tin nên có

Ngoài tọa độ, bạn nên chuẩn bị các cột thông tin để hiển thị cho khách hàng:

• Tên cửa hàng (nên có — dùng làm nhãn và tiêu đề popup).
• Địa chỉ.
• Số điện thoại.
• Giờ mở cửa (nếu có).
• Các thông tin khác: khu vực, loại cửa hàng, ghi chú...

Chuẩn bị Shapefile

Shapefile không phải một file đơn lẻ mà là một bộ nhiều file đi kèm nhau, thường gồm:

• .shp — hình học (vị trí các điểm).
• .shx — chỉ mục.
• .dbf — bảng thuộc tính.
• .prj — hệ tọa độ (nên có để định vị đúng).

Hãy giữ đủ bộ file (thường nén chung thành một file .zip) khi tải lên. Shapefile đã chứa sẵn tọa độ nên bạn không cần chỉ định cột Kinh độ/Vĩ độ.

Từ Excel / Google Sheets

Dữ liệu cửa hàng của bạn thường nằm trong Excel hoặc Google Sheets. Cách chuyển sang CSV chuẩn:

Trong Excel:

1. Sắp xếp dữ liệu: dòng đầu là tiêu đề cột, mỗi dòng một cửa hàng, có cột Kinh độ và Vĩ độ.
2. Chọn File → Save As / Lưu thành.
3. Chọn định dạng CSV UTF-8 (Comma delimited) (*.csv) — nhớ chọn đúng bản UTF-8 để không lỗi tiếng Việt.
4. Mở lại file bằng Notepad để kiểm tra dấu phân cách — xem mục trên. Bước này hay bị bỏ qua nhất mà lại là nguyên nhân tắc phổ biến nhất.

Trong Google Sheets — hai lựa chọn:

• Không cần xuất gì: dán thẳng đường dẫn bảng tính vào thẻ Google Sheet của hộp thoại tải lên. Nhớ chia sẻ bảng tính với quyền Viewer cho tài khoản dịch vụ mà hộp thoại hiển thị.
• Hoặc xuất tệp như cũ: File → Download → Comma-separated values (.csv). Google Sheets luôn xuất ở UTF-8 và luôn dùng dấu phẩy, nên không dính hai lỗi ở trên.

Danh sách kiểm tra trước khi tải lên

• Dòng đầu tiên là tiêu đề cột.
• Các cột phân cách bằng dấu phẩy, không phải dấu chấm phẩy (mở bằng Notepad kiểm tra).
• Mỗi dòng là một cửa hàng, không có dòng trống xen giữa.
• Có cột Kinh độ và cột Vĩ độ, dùng độ thập phân + dấu chấm.
• Tọa độ nằm trong vùng hợp lý cho khu vực của bạn, không bị đảo Kinh độ ↔ Vĩ độ.
• File lưu ở UTF-8 (tiếng Việt hiển thị đúng).
• Có cột Tên để làm nhãn/tiêu đề.
• Các cột phân loại dùng giá trị nhất quán.
• Shapefile: đủ bộ file (.shp, .shx, .dbf, .prj).

Lỗi thường gặp & cách tránh

Lỗi	Nguyên nhân & cách tránh
Ô chọn cột tọa độ chỉ hiện một dòng dài	File dùng dấu chấm phẩy thay vì dấu phẩy — xem mục dấu phân cách.
Tên cột hiện lỗi font ngay ở bước chọn cột	File không phải UTF-8. Lưu lại đúng CSV UTF-8.
Cửa hàng nằm sai vị trí / giữa biển	Đảo nhầm cột Kinh độ ↔ Vĩ độ, hoặc thiếu tọa độ. Kiểm tra lại giá trị.
Báo "chưa có Lat Long" khi tải	File CSV thiếu cột tọa độ, hoặc bạn chưa chọn cột Long/Lat ở bước thiết lập.
Tiếng Việt thành ký tự lạ	File không phải UTF-8 — lưu lại đúng CSV UTF-8.
Một số dòng không lên bản đồ	Dòng đó thiếu/sai tọa độ, hoặc tọa độ để trống.
Cột bị lệch / gộp sai	Trong dữ liệu có dấu phẩy (ví dụ địa chỉ) làm lệch cột CSV — đảm bảo các ô chứa dấu phẩy được đặt trong dấu ngoặc kép "...".

---

Tiếp theo: Tải lên tệp — đưa file đã chuẩn bị lên hệ thống.