Hướng dẫn phân tích không gian GeoPandas
Bộ quy tắc và CLI kiểm định giúp làm việc với GeoPandas an toàn: CRS, tính hợp lệ hình học, join và xuất dữ liệu.
Dữ liệu · Phân tíchNâng cao★ 33,030⑂ 3,248Điểm AI 8/10Cập nhật lần cuối: 9 thg 8, 2026
Làm được gì
Skill cung cấp quy tắc và công cụ ngăn các lỗi phổ biến khi xử lý dữ liệu vector (điểm/đường/vùng) bằng GeoPandas.
- Môi trường tái lập: đoạn lệnh
uv pip installghim chính xác GeoPandas 1.1.4 cùng numpy, pandas, shapely, pyproj, pyogrio - 8 cổng kiểm tra đúng đắn: nguồn gốc & hash, phân biệt hình học null/rỗng/không hợp lệ, bắt buộc có metadata CRS (
set_crskhácto_crs), đơn vị phẳng, chất lượng phép biến đổi, lưới độ chính xác, số lượng bản ghi sau join, hợp đồng đầu ra - Quyết định API: hướng của các predicate
sjoin(within/contains/covers/dwithin),sjoin_nearesttrả về mọi kết quả cùng khoảng cách,overlay/clip/dissolvecó thể đổi kiểu hình học và tạo sliver - I/O: pyogrio là mặc định, ưu tiên GeoPackage và GeoParquet (schema 1.0.0), PostGIS dùng SQL tham số hoá và transaction
- Cam kết quyền riêng tư: coi toạ độ chính xác, địa chỉ, lộ trình là dữ liệu nhạy cảm và phải tổng quát hoá trước khi công bố
- 6 CLI cục bộ: kiểm kê vector, kế hoạch tái chiếu CRS, báo cáo tính hợp lệ, audit spatial join, hợp đồng xuất dữ liệu, checklist toạ độ nhạy cảm
Dành cho ai
- Nhà phân tích, nghiên cứu viên xử lý dữ liệu hành chính, bất động sản, logistics, môi trường bằng GeoPandas
- Lập trình viên cần nâng cấp code từ GeoPandas 0.14 lên 1.x (có checklist: bỏ PyGEOS,
op=→predicate=,unary_union→union_all()) - Ai từng tính sai diện tích/khoảng cách vì dùng sai hệ toạ độ
- Nhóm phải công bố dữ liệu không gian có chứa thông tin vị trí cá nhân
Ví dụ sử dụng
- "Diện tích polygon trong file GeoPackage này sai lạ?" → Skill kiểm tra CRS có phải hệ địa lý EPSG:4326, hướng dẫn chuyển sang UTM/equal-area và chạy
geometry_validity_report.py - "Sau khi sjoin điểm với vùng, số dòng tăng lên" → dùng
spatial_join_audit.pyđể soi predicate, ID trùng lặp và quan hệ 1:N, rồi viết lại code với cardinality mong đợi - "Cần đưa bản đồ toạ độ khách hàng vào báo cáo" → chạy
sensitive_coordinates_checklist.pyrồi tạo bản đồ nháp tổng quát hoá vớiexplore(tiles=None, tooltip=False)
· · · Hướng dẫn cài đặt · · ·
Cài vào ứng dụng Claude (không cần terminal)
- Tải tệp ZIP bằng nút bên dưới.
- Trong Claude, mở Settings → Capabilities và bật 'Code execution and file creation'. (chỉ một lần)
- Vào Customize → Skills → + → 'Upload a skill' rồi tải tệp ZIP lên.
Cài vào Claude Code
Để Claude làm — dán câu dưới đây vào Claude Code
Hãy cài skill mình tìm thấy trên Claude Skill Mart. Copy thư mục skills/geopandas từ repo GitHub K-Dense-AI/scientific-agent-skills vào ~/.claude/skills/geopandas/ của mình. Sau khi cài xong, cho mình biết skill này làm được gì trong một câu.
Cài bằng lệnh thủ công
git clone https://github.com/K-Dense-AI/scientific-agent-skills.git /tmp/scientific-agent-skills && mkdir -p ~/.claude/skills && cp -r /tmp/scientific-agent-skills/skills/geopandas ~/.claude/skills/⚠ Đây là skill do người khác tạo. Hãy kiểm tra repo gốc trước khi cài.
- Mở terminal và đảm bảo đã cài Claude Code.
- Clone repo vào thư mục tạm:
git clone https://github.com/K-Dense-AI/scientific-agent-skills.git /tmp/scientific-agent-skills - Tạo thư mục skills:
mkdir -p ~/.claude/skills - Copy riêng skill này:
cp -r /tmp/scientific-agent-skills/skills/geopandas ~/.claude/skills/ - (Khuyến nghị) Tạo môi trường Python:
uv venv --python 3.12, sau đó chạy đúng lệnhuv pip installtrong SKILL.md. - Khởi động lại Claude Code và thử yêu cầu: "dùng skill geopandas kiểm tra file .gpkg này".
- Kiểm tra CLI:
python ~/.claude/skills/geopandas/scripts/vector_inventory.py --help - Nếu đã có project sẵn, hãy cài các phiên bản ghim trong virtualenv riêng để tránh xung đột thư viện.
Xem mã nguồn trên GitHub ↗Giấy phép: MIT