地图坐标前台（JS）转换工具

地理坐标系转换工具，支持WGS84/GCJ02/BD09等常用坐标系互转

https://github.com/hujiulong/gcoord

 

 README.md

 

Gcoord

    

gcoord(geographic coordinates)是一个处理地理坐标系的JS库，用来修正百度地图、高德地图及其它互联网地图坐标系不统一的问题。

支持转换坐标数组和GeoJSON数据，能在node环境以及所有现代浏览器（IE8+）中运行，gzip后仅3kb。

更多信息可以阅读地理坐标系

Install

通过npm安装:

npm install gcoord --save

或者直接在页面中引入:

<script src="https://unpkg.com/gcoord/dist/gcoord.js"></script>

Import

CommonJS:

const gcoord = require('gcoord');
// 或者
const { transform, WGS84, GCJ02 } = require('gcoord');

ES Module:

import gcoord from 'gcoord'
// 或者
import { transform, WGS84, GCJ02 } from 'gcoord'

同时也支持AMD和CMD规范

Usage

例如从手机的GPS得到一个经纬度坐标，需要将其展示在百度地图上，则应该将当前坐标从WGS-84坐标系转换为BD-09坐标系

var result = gcoord.transform(
  [116.403988, 39.914266],    // 经纬度坐标
  gcoord.WGS84,               // 当前坐标系
  gcoord.BD09                 // 目标坐标系
);

console.log(result);  // [116.41661560068297, 39.92196580126834]

同时gcoord还可以转换GeoJSON对象的坐标系，详细使用方式可以参考API

API

transform(input, from, to)

进行坐标转换

参数

• input GeoJSON | string | Array<number> GeoJSON对象，或GeoJSON字符串，或经纬度数组
• from CRS 当前坐标系
• to CRS 目标坐标系

返回值

GeoJSON | Array<number>

示例

// 将GCJ02坐标转换为WGS84坐标
var result = gcoord.transform([123, 45], gcoord.GCJ02, gcoord.WGS84);
console.log(result);  // [122.99395597, 44.99804071]

// 转换GeoJSON坐标
var geojson = {
  "type": "Point",
  "coordinates": [123, 45]
}
gcoord.transform(geojson, gcoord.GCJ02, gcoord.WGS84);
console.log(geojson.coordinates); // [122.99395597, 44.99804071]

返回数组或GeoJSON对象（由输入决定），注意：当输入为GeoJSON时，transform会改变输入对象

CRS

CRS为坐标系，目标支持以下几种坐标系

CRS	坐标格式	说明
gcoord.WGS84	[lng,lat]	WGS-84坐标系，GPS设备获取的经纬度坐标
gcoord.GCJ02	[lng,lat]	GCJ-02坐标系，google中国地图、soso地图、aliyun地图、mapabc地图和高德地图所用的经纬度坐标
gcoord.BD09	[lng,lat]	BD-09坐标系，百度地图采用的经纬度坐标
gcoord.BD09LL	[lng,lat]	同BD09
gcoord.BD09MC	[x,y]	BD-09米制坐标，百度地图采用的米制坐标，单位：米
gcoord.BD09Meter	[x,y]	同BD09MC
gcoord.Baidu	[lng,lat]	百度坐标系，BD-09坐标系别名，同BD-09
gcoord.BMap	[lng,lat]	百度地图，BD-09坐标系别名，同BD-09
gcoord.AMap	[lng,lat]	高德地图，同GCJ-02
gcoord.WebMercator	[x,y]	Web Mercator投影，墨卡托投影，同EPSG3857，单位：米
gcoord.WGS1984	[lng,lat]	WGS-84坐标系别名，同WGS-84
gcoord.EPSG4326	[lng,lat]	WGS-84坐标系别名，同WGS-84
gcoord.EPSG3857	[x,y]	Web Mercator投影，同WebMercator，单位：米
gcoord.EPSG900913	[x,y]	Web Mercator投影，同WebMercator，单位：米

支持更多坐标系？ gcoord的目标是处理web地图中的坐标，目前支持的坐标系已经能满足绝大部分要求了，同时gcoord也能保持轻量。如果需要更专业的坐标系处理工具，可以使用proj4js等开源库

LICENSE

MIT

 

 

 

---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------

提供了百度坐标（BD09）、国测局坐标（火星坐标，GCJ02）、和WGS84坐标系之间的转换

https://github.com/wandergis/coordtransform#%E5%9C%B0%E7%90%83%E5%9D%90%E6%A0%87-wgs84

 

 README.md

coordtransform 坐标转换

---

一个提供了百度坐标（BD09）、国测局坐标（火星坐标，GCJ02）、和WGS84坐标系之间的转换的工具模块。

python版本：https://github.com/wandergis/coordTransform_py

命令行版本(支持模块或在命令行直接转换geojson数据)：https://github.com/wandergis/coordtransform-cli

go语言社区版本：https://github.com/qichengzx/coordtransform

---

支持node、浏览器（AMD方式和直接引用方式）

• GitHub地址：https://github.com/wandergis/coordtransform
• npm地址：https://www.npmjs.com/package/coordtransform
• 项目主页：http://wandergis.github.io/coordtransform/

为什么写这个模块

随着移动互联网的兴起，几乎每一个app都会去收集用户位置，如果恰好你在处理与地理定位相关的代码，并且不了解地理坐标系的话，肯定要被我大天朝各种坐标系搞晕。写这个模块的目的也是因为项目中app获取的坐标是百度sdk获取的，在做webgis可视化的时候各种偏，各种坐标不对，叠加错位。

当前互联网地图的坐标系现状

地球坐标 (WGS84)

• 国际标准，从 GPS 设备中取出的数据的坐标系
• 国际地图提供商使用的坐标系

火星坐标 (GCJ-02)也叫国测局坐标系

• 中国标准，从国行移动设备中定位获取的坐标数据使用这个坐标系
• 国家规定： 国内出版的各种地图系统（包括电子形式），必须至少采用GCJ-02对地理位置进行首次加密。

百度坐标 (BD-09)

• 百度标准，百度 SDK，百度地图，Geocoding 使用
• (本来就乱了，百度又在火星坐标上来个二次加密)

开发过程需要注意的事

• 从设备获取经纬度（GPS）坐标

    	如果使用的是百度sdk那么可以获得百度坐标（bd09）或者火星坐标（GCJ02),默认是bd09
    	如果使用的是ios的原生定位库，那么获得的坐标是WGS84
    	如果使用的是高德sdk,那么获取的坐标是GCJ02
  

• 互联网在线地图使用的坐标系

    火星坐标系：
    		iOS 地图（其实是高德）
    		Google国内地图（.cn域名下）
    		搜搜、阿里云、高德地图、腾讯
    百度坐标系：
    		当然只有百度地图
    WGS84坐标系：
    		国际标准，谷歌国外地图、osm地图等国外的地图一般都是这个
  

举个例子

笔者所在的公司app使用的是百度的sdk,需要对定位坐标做web可视化效果，百度地图提供的js api满足不了需求，选用leaflet来做可视化，这里要说到百度地图了，它使用的坐标系和切图的原点都不一致，并且其加偏还是非线性的，因此无法利用常用的加载方法去加载，放弃使用它的底图，选用了符合标准的高德底图，高德底图使用的是国测局坐标也就是GCJ02坐标系，如果简单的将app获取的经纬度叠加上去，就有可能你本来在百度大厦的位置就显示在西二旗地铁站了甚至更远，因此需要将bd09转成gcj02坐标系，这个时候这个库就有了用武之地，对点批量转换再加载到底图上，就可以让点显示在本应该出现的位置。

另外如果你拿到了一些WGS84的坐标，想加载到各种底图上就可以根据这个库在底图坐标系和你的数据坐标系之间进行转换。希望对大家有用吧。

---

安装（install）

npm install coordtransform

示例用法（Example&Usage）

1 NodeJs用法

//国测局坐标(火星坐标,比如高德地图在用),百度坐标,wgs84坐标(谷歌国外以及绝大部分国外在线地图使用的坐标)
var coordtransform=require('coordtransform');
//百度经纬度坐标转国测局坐标
var bd09togcj02=coordtransform.bd09togcj02(116.404, 39.915);
//国测局坐标转百度经纬度坐标
var gcj02tobd09=coordtransform.gcj02tobd09(116.404, 39.915);
//wgs84转国测局坐标
var wgs84togcj02=coordtransform.wgs84togcj02(116.404, 39.915);
//国测局坐标转wgs84坐标
var gcj02towgs84=coordtransform.gcj02towgs84(116.404, 39.915);
console.log(bd09togcj02);
console.log(gcj02tobd09);
console.log(wgs84togcj02);
console.log(gcj02towgs84);
//result
//bd09togcj02:   [ 116.39762729119315, 39.90865673957631 ]
//gcj02tobd09:   [ 116.41036949371029, 39.92133699351021 ]
//wgs84togcj02:  [ 116.41024449916938, 39.91640428150164 ]
//gcj02towgs84:  [ 116.39775550083061, 39.91359571849836 ]

2 浏览器用法 直接引用目录内的index.js，会有一个coordtransform的全局对象暴露出来，也支持用AMD加载器加载

<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <title>coordTransform</title>
</head>
<body>
<h1>请按F12打开控制台查看结果</h1>
<script src="index.js"></script>
<script>
    //国测局坐标(火星坐标,比如高德地图在用),百度坐标,wgs84坐标(谷歌国外以及绝大部分国外在线地图使用的坐标)
    //百度经纬度坐标转国测局坐标
    var bd09togcj02 = coordtransform.bd09togcj02(116.404, 39.915);
    //国测局坐标转百度经纬度坐标
    var gcj02tobd09 = coordtransform.gcj02tobd09(116.404, 39.915);
    //wgs84转国测局坐标
    var wgs84togcj02 = coordtransform.wgs84togcj02(116.404, 39.915);
    //国测局坐标转wgs84坐标
    var gcj02towgs84 = coordtransform.gcj02towgs84(116.404, 39.915);
    console.log(bd09togcj02);
    console.log(gcj02tobd09);
    console.log(wgs84togcj02);
    console.log(gcj02towgs84);
    //result
    //bd09togcj02:   [ 116.39762729119315, 39.90865673957631 ]
    //gcj02tobd09:   [ 116.41036949371029, 39.92133699351021 ]
    //wgs84togcj02:  [ 116.41024449916938, 39.91640428150164 ]
    //gcj02towgs84:  [ 116.39775550083061, 39.91359571849836 ]
</script>
</body>
</html>

todos

• 墨卡托坐标
• geojson转换
• 批量转换
• turf插件
• leaflet插件

sometipes

对于做GIS的人来说，底图对我们还是很重要的，有时候看国外的底图很好看，换上之后发现坐标位置全部不对，因此写了这个包帮助大家完成坐标的转换，也准备写成一个leaflet的扩展，方便大家的使用，喜欢的童鞋请star。