# @geosolutions/proj4 中文文档

规范地址：https://npmcn.com/package/%40geosolutions/proj4/

版本：2\.4\.9
npm 元数据更新时间：2022-04-05T13:57:24.986Z
中文译文更新时间：2026-11-16T05:00:28.527Z
软件包许可：MIT

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40geosolutions/proj4
原文对照：https://npmcn.com/package/%40geosolutions/proj4/?lang=original
项目主页：https://github.com/geosolutions-it/proj4js#readme
源码仓库：https://github.com/geosolutions-it/proj4js

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：510 kB，119 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：未声明
- 运行依赖：2 个
- 首次发布：2019-11-27T16:25:52.835Z
- 最新版本发布：2021-01-18T19:23:14.296Z
- 近 30 天下载量：5687（2026-10-16 至 2026-11-14，npm 官方下载统计）
- 已发布版本数：5（近 12 个月 0 个）

## 中文简介

Proj4js是一个JavaScript库来将点坐标从一个坐标系统转换到另一个坐标系统,包括数据转换.

## 安装

```sh
npm install @geosolutions/proj4
```

也可以使用：`pnpm add @geosolutions/proj4`、`yarn add @geosolutions/proj4`、`bun add @geosolutions/proj4`

## README

# 叉线信息

这回贷被扣了,因为我们需要加注 [这个](https://github.com/geosolutions-it/proj4js/tree/5011a3af3a3cec821c93528a42a68614ac2a3e42) 修补 我们将出版 **释放** npm 地产登记册上的分支

# PROJ4JS 软件 [![Build Status](https://travis-ci.org/proj4js/proj4js.svg)](https://travis-ci.org/proj4js/proj4js)

Proj4js是一个JavaScript库来将点坐标从一个坐标系统转换到另一个坐标系统,包括数据转换. 原为 [PROJ. 4 采购](http://trac.osgeo.org/proj/) 财务报告和审定财务报表 [C组](http://edcftp.cr.usgs.gov/pub//software/gctpc) 这是 备注 [元数据](http://wiki.osgeo.org/wiki/MetaCRS) 一组项目.

## 安装

取决于你的喜好

```bash
npm install proj4
bower install proj4
component install proj4js/proj4js
```

或只是手动抓取文件 `proj4.js` 从 [最新发布](https://github.com/proj4js/proj4js/releases)是因为 `dist/` 文件夹.

如果您不想下载任何信息, Proj4js 也会在 [(简体中文)](http://www.cdnjs.com/libraries/proj4js) 用于浏览器应用程序中的直接使用.

## 使用

基本签名是:

```javascript
proj4(fromProjection[, toProjection, coordinates])
```

预测可以是proj或wkt字符串.

坐标可能为形式对象 `{x:x,y:y}` 或窗体的数组 `[x,y]`。 。 。 .

当给出所有3个参数时,结果是坐标由投影1变为投影2. 以同样的格式返回.

```javascript
var firstProjection = 'PROJCS["NAD83 / Massachusetts Mainland",GEOGCS["NAD83",DATUM["North_American_Datum_1983",SPHEROID["GRS 1980",6378137,298.257222101,AUTHORITY["EPSG","7019"]],AUTHORITY["EPSG","6269"]],PRIMEM["Greenwich",0,AUTHORITY["EPSG","8901"]],UNIT["degree",0.01745329251994328,AUTHORITY["EPSG","9122"]],AUTHORITY["EPSG","4269"]],UNIT["metre",1,AUTHORITY["EPSG","9001"]],PROJECTION["Lambert_Conformal_Conic_2SP"],PARAMETER["standard_parallel_1",42.68333333333333],PARAMETER["standard_parallel_2",41.71666666666667],PARAMETER["latitude_of_origin",41],PARAMETER["central_meridian",-71.5],PARAMETER["false_easting",200000],PARAMETER["false_northing",750000],AUTHORITY["EPSG","26986"],AXIS["X",EAST],AXIS["Y",NORTH]]';
var secondProjection = "+proj=gnom +lat_0=90 +lon_0=0 +x_0=6300000 +y_0=6300000 +ellps=WGS84 +datum=WGS84 +units=m +no_defs";
//I'm not going to redefine those two in latter examples.
proj4(firstProjection,secondProjection,[2,5]);
// [-2690666.2977344505, 3662659.885459918]
```

如果只给出了1个预测,则假定是预测 _从_ WGS84(来自项目是WGS84).

```javascript
proj4(firstProjection,[-71,41]);
// [242075.00535055372, 750123.32090043]
```

如果没有给一个有两种方法的物体提供坐标,则返回其方法 `forward` 从第一次预测到第二次预测 `inverse` 从第二到第一投影.

```javascript
proj4(firstProjection,secondProjection).forward([2,5]);
// [-2690666.2977344505, 3662659.885459918]
proj4(secondProjection,firstProjection).inverse([2,5]);
// [-2690666.2977344505, 3662659.885459918]
```

和上面一样,如果只给出一个投影, 假设它来自wgs84

```javascript
proj4(firstProjection).forward([-71,41]);
// [242075.00535055372, 750123.32090043]
proj4(firstProjection).inverse([242075.00535055372, 750123.32090043]);
//[-71, 40.99999999999986]
//the floating points to answer your question
```

## 命名预测

如果您喜欢将投影定义为字符串并以此来引用,您可以使用可被称作"双向"的proj4.defs方法,并带有名称和投影:

```js
proj4.defs('WGS84', "+title=WGS 84 (long/lat) +proj=longlat +ellps=WGS84 +datum=WGS84 +units=degrees");
```

或带数组

```js
proj4.defs([
  [
    'EPSG:4326',
    '+title=WGS 84 (long/lat) +proj=longlat +ellps=WGS84 +datum=WGS84 +units=degrees'],
  [
    'EPSG:4269',
    '+title=NAD83 (long/lat) +proj=longlat +a=6378137.0 +b=6356752.31414036 +ellps=GRS80 +datum=NAD83 +units=degrees'
  ]
]);
```

那你可以这么做

```js
proj4('EPSG:4326');
```

默认proj4没有写入整个proj定义,而是预设了以下预测:

-   'EPSG:4326',该词有以下别名:
    -   (第84工作组)
-   "EPSG: 4269" (英语)
-   'EPSG:3857',其别名如下: 相克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克
    -   'EPSG:3785' (英语)
    -   (歌声)
    -   'EPSG:900913' (英语)
    -   "EPSG:102113" (英语)

定义的预测也可以通过 proj4.defs 函数访问(`proj4.defs('EPSG:4326')`) (中文(简体) ).

proj4.defs也可以用来定义一个被命名的别名:

```javascript
proj4.defs('urn:x-ogc:def:crs:EPSG:4326', proj4.defs('EPSG:4326'));
```

## 类型脚本

类型脚本执行被添加到 [当然 已输入仓库](https://github.com/DefinitelyTyped/DefinitelyTyped)。 。 。 .

```bash
$ npm install --save @types/proj4
```

## 发展中国家

设置构建工具,确保您安装了节点和 grunt-cli,然后运行 `npm install`

进行完整的构建和浏览器测试

```bash
node_modules/.bin/grunt
```

运行节点测试运行

```bash
npm test
```

运行覆盖运行的节点测试

```bash
npm test --coverage
```

创建仅运行默认预测的构建( latlon and Mercator)

```bash
node_modules/.bin/grunt build
```

创建仅包含自定义预测的构建,包括一个逗号分隔的预测代码列表(在"lib/ projections"中的文件名,不含".js"),在结肠后,例如.

```bash
node_modules/.bin/grunt build:tmerc
#includes transverse Mercator
node_modules/.bin/grunt build:lcc
#includes lambert conformal conic
node_modules/.bin/grunt build:omerc,moll
#includes oblique Mercator and Mollweide
```

## 常见问题

### @geosolutions/proj4 是什么？

Proj4js是一个JavaScript库来将点坐标从一个坐标系统转换到另一个坐标系统,包括数据转换\.

### 如何安装 @geosolutions/proj4？

在项目目录运行 npm install @geosolutions/proj4，或使用 pnpm add / yarn add / bun add。

### @geosolutions/proj4 支持 TypeScript 吗？

该包的 package\.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/geosolutions\_\_proj4 是否存在。

### @geosolutions/proj4 支持 ESM 还是 CommonJS？

同时提供 ES Module 与 CommonJS 入口，import 和 require\(\) 都可以使用，打包工具会自动选择合适的版本。

### @geosolutions/proj4 可以商用吗？

@geosolutions/proj4 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

### @geosolutions/proj4 的下载量有多少？

根据 npm 官方下载统计，@geosolutions/proj4 在 2026/10/16 – 2026/11/14 这 30 天内被下载 5,687 次，日均约 190 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @geosolutions/proj4 还在维护吗？

最新版本 2\.4\.9 发布于 2021/01/19（5 年前）；至今共发布 5 个版本，其中过去 12 个月发布了 0 个；首次发布于 2019/11/28。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。

