地理坐标系转换工具,支持WGS84/GCJ02/BD09等常用坐标系互转
/hujiulong/gcoord
README.md
Gcoord
gcoord(geographiccoordinates)是一个处理地理坐标系的JS库,用来修正百度地图、高德地图及其它互联网地图坐标系不统一的问题。
支持转换坐标数组和GeoJSON数据,能在node环境以及所有现代浏览器(IE8+)中运行,gzip后仅3kb。
更多信息可以阅读地理坐标系
Install
通过npm安装:
npm install gcoord --save
或者直接在页面中引入:
<script src="/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为坐标系,目标支持以下几种坐标系
支持更多坐标系?gcoord的目标是处理web地图中的坐标,目前支持的坐标系已经能满足绝大部分要求了,同时gcoord也能保持轻量。如果需要更专业的坐标系处理工具,可以使用proj4js等开源库
LICENSE
MIT
---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------
提供了百度坐标(BD09)、国测局坐标(火星坐标,GCJ02)、和WGS84坐标系之间的转换
/wandergis/coordtransform#%E5%9C%B0%E7%90%83%E5%9D%90%E6%A0%87-wgs84
README.md
coordtransform 坐标转换
一个提供了百度坐标(BD09)、国测局坐标(火星坐标,GCJ02)、和WGS84坐标系之间的转换的工具模块。
python版本:/wandergis/coordTransform_py
命令行版本(支持模块或在命令行直接转换geojson数据):/wandergis/coordtransform-cli
go语言社区版本:/qichengzx/coordtransform
支持node、浏览器(AMD方式和直接引用方式)
GitHub地址:/wandergis/coordtransformnpm地址:coordtransform - npm项目主页:Coordtransform by wandergis为什么写这个模块
随着移动互联网的兴起,几乎每一个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。