# geojson-preview

**Repository Path**: SmartMailer/geojson-preview

## Basic Information

- **Project Name**: geojson-preview
- **Description**: GeoJSON 在线预览编辑器 - 开源镜像（预览/编辑/导出 GeoJSON/KML/SVG/CSV/PNG），主站 https://geojsoncn.com
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: https://geojsoncn.com/preview.html
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-09-01
- **Last Updated**: 2026-09-01

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# GeoJSON Preview · 在线 GeoJSON 预览编辑器

一个**纯前端、离线可用**的 GeoJSON 预览与编辑工具。打开网页即可查看、编辑、合并、切分行政区划与任意 GeoJSON 数据，并一键导出为多种格式。所有计算都在浏览器本地完成，**不上传任何服务器**，关掉页面即不留存数据。

> 本仓库由 [geojsoncn.com](https://geojsoncn.com) 的 `preview.html` 功能整理开源，已移除原站的站点统计与后端反馈依赖，改为相对路径，开箱即用。

## ✨ 功能

- **导入**：支持 GeoJSON、KML、GPX、CSV（坐标表）四种格式，自动转为 GeoJSON 在地图上渲染。
- **地图预览**：基于 Leaflet 的矢量地图，支持底图切换、缩放、平移。
- **绘制**：点 / 线 / 面 / 矩形，落点即生成要素。
- **合并选中**：用 Turf.js 对多个相邻多边形做几何并集。
- **切分**：沿一条分割线把一个多边形拆成两块（基于 polygon-clipping）。
- **顶点编辑**：拖动顶点改形状，自动记入历史可撤销。
- **属性编辑**：双击要素属性字段（名称、行政区划代码等）即时修改，同步到地图与导出。
- **撤销 / 重做**：Ctrl+Z / Ctrl+Y，全部编辑操作可回退。
- **导出**：GeoJSON、KML、CSV（坐标表）、SHP（shapefile 压缩包，含 .prj 声明 WGS84 / .cpg 声明 UTF-8）、SVG 矢量图、PNG 透明底、JPG 白底，支持 1080p / 2K / 4K 分辨率。

## 🚀 使用

### 方式一：直接打开
双击 `preview.html` 用浏览器打开即可使用（推荐 Chrome / Edge / Firefox）。

### 方式二：本地静态服务器（避免个别浏览器对 `file://` 的限制）
```bash
# 进入仓库目录后任选其一
python3 -m http.server 8080
# 或
npx serve .
```
然后访问 `http://localhost:8080/preview.html`。

### 方式三：部署到任意静态托管
将整个仓库（含 `leaflet/`、`turf/`、`vendor/`）上传到 GitHub Pages / Netlify / Vercel / Cloudflare Pages 等任意静态托管即可。

## 📁 目录结构

```
geojson-preview/
├── preview.html                 # 主程序（自包含，含内联 CSS/JS）
├── leaflet/                     # Leaflet 地图库（vendored）
│   ├── leaflet.js
│   ├── leaflet.css
│   └── images/
├── turf/                        # Turf.js 几何运算库（vendored, MIT）
│   └── turf.min.js
├── vendor/                      # 第三方依赖（vendored）
│   └── polygon-clipping.umd.js  # 多边形布尔运算（MIT）
├── LICENSE                      # MIT
├── NOTICE                       # 第三方库许可证声明
└── README.md
```

## 🔒 隐私
所有 GeoJSON / KML / CSV 解析、合并、切分、导出均在浏览器端完成，数据不会发送到任何远程服务器。

## 📄 许可证
本项目自身代码以 **MIT** 许可证开源，详见 [LICENSE](./LICENSE)。
第三方依赖的许可证见 [NOTICE](./NOTICE)：
- Leaflet — BSD-2-Clause
- Turf.js — MIT
- polygon-clipping — MIT
## ✨ 我的网站 
[全国省市区县乡镇行政区划边界数据丨高清地图、SHP矢量图免费下载](https://geojsoncn.com)，这是我的主站，欢迎大家多多支持。