shp-write.js 导出shp数据：原理介绍及示例代码

引言

Shapefile 是一种用于存储矢量地理信息的标准格式，被广泛应用于 GIS 领域。随着 Web 技术的发展，越来越多的应用场景要求能够在前端或者后端环境中生成 Shapefile 文件。本文将介绍如何使用 shapefile 库（有时也称为 shp-write.js）在 Node.js 环境中创建 Shapefile 文件，并提供一个详细的示例代码，同时总结一些重要的注意事项。

原理介绍

Shapefile 格式简介

Shapefile 由多个文件组成，最核心的是以下三种文件：

• .shp：存储几何数据。
• .shx：存储索引数据，帮助快速定位 .shp 文件中的几何数据。
• .dbf：存储属性数据。

此外，还可能有 .prj 文件用来存储投影信息，.cpg 文件定义字符集等。

shpwrite.js（shapefile 库）的工作原理

shapefile 库是一个用于创建和读取 Shapefile 文件的 Node.js 库。它的主要功能包括：

• 创建 .shp 和 .shx 文件，处理几何数据。
• 创建 .dbf 文件，管理属性数据。
• 支持多种几何类型，如点(Point)、线(LineString)、多边形(Polygon)等。

该库通过流式接口来处理文件，使得开发者可以方便地集成到现有的数据处理流程中。

示例代码

接下来，我们将通过一个具体的例子来演示如何使用 shapefile 库创建一个包含点坐标数据的 Shapefile 文件。

准备工作

首先，确保已经安装了 shapefile 库。可以通过 npm 安装：

npm install shp-write

示例代码

const options = {
        folder: "my-shp", //文件夹名称
        types: {
            point: "myPoint", //type为point的shp文件名称
            polygon: "myPolyline",//type为polyline的shp文件名称
            line: "mylines",//type为line的shp文件名称 
        },
    }
 
 
    const geoJsonPoint = {
        type: "FeatureCollection",
        features:
            [
                {
                    type: 'Feature',
                    geometry: {
                        type: 'Point',
                        coordinates: [117.2152, 36.1254]
                    },//图形坐标
                    properties: {
                        name: '测试点1',
                    }//属性
                },
                {
                    type: 'Feature',
                    geometry: {
                        type: 'Point',
                        coordinates: [117.2254, 36.1312]
                    },//图形坐标
                    properties: {
                        name: '测试点2',
                    }//属性
                },
            ]
    }
    const geoJsonPolyline = {
        type: "FeatureCollection",
        features:
            [
                {
                    type: 'Feature',
                    geometry: {
                        type: 'LineString',//注意，这里不能写Line或Polyline,只能是LineString
                        coordinates: [[[117.2152, 36.1254], [117.2254, 36.1312]]]
                    },//图形坐标
                    properties: {
                        name: '测试线路1',
                    }//属性
                },
                {
                    type: 'Feature',
                    geometry: {
                        type: 'LineString',
                        coordinates: [[[117.2254, 36.3112], [117.2452, 36.3312]]]
                    },//图形坐标
                    properties: {
                        name: '测试线路2',
                    }//属性
                },
            ]
    }
 
    const geoJsonPolygon = {
        type: "FeatureCollection",
        features:
            [
                {
                    type: 'Feature',
                    geometry: {
                        type: 'Polygon',
                        coordinates: [[[1, 1], [1, 2], [2, 2], [2, 1], [1, 1]]]
                    },//图形坐标
                    properties: {
                        name: '测试图形1',
                    }//属性
                },
                {
                    type: 'Feature',
                    geometry: {
                        type: 'Polygon',
                        coordinates: [[[1, 1], [1, 5], [5, 5], [5, 1], [1, 1]]]
                    },//图形坐标
                    properties: {
                        name: '测试图形2',
                    }//属性
                },
            ]
    }
    shpwrite.download(geoJsonPoint, options);//下载point的shp文件
    shpwrite.download(geoJsonPolyline, options);//下载polyline的shp文件
    shpwrite.download(geoJsonPolygon, options);//下载polygon的shp文件

注意事项

1. 几何类型一致性：确保你写入的几何数据类型与你定义的几何字段类型一致。例如，如果定义了 Point 类型，则只应写入点类型的几何数据。
2. 属性字段长度：.dbf 文件中的每个字段都有长度限制，添加字段时应注意字段长度的设置。
3. 编码问题：尽管大多数情况下 .dbf 文件使用默认编码即可，但某些场景下可能需要指定特定的字符集。
4. 文件完整性检查：创建完 Shapefile 文件后，最好使用 GIS 工具打开并检查文件是否完整无误。
5. 错误处理：示例代码中未包含错误处理逻辑，实际开发时应考虑异常情况并妥善处理。

总结

通过 shapefile 库，我们可以轻松地在 Node.js 环境中创建 Shapefile 文件，这对于地理信息系统开发来说非常有用。

补：中文乱码解决方法：解决shp-write导出shp属性表中文乱码问题_shp数据乱码_巧克力曲奇的博客-CSDN博客