klokantech/epsg.io

EPSG.io

概述

EPSG.io是一个用于处理全球坐标参考系统(CRS)的工具，主要提供坐标参考系统查询、坐标转换、数据导出等功能。通过Web界面和API接口，用户可以便捷地获取EPSG代码信息、进行坐标转换以及导出多种格式的数据。

核心功能和特性

• 支持EPSG代码查询，包括坐标参考系统(CRS)、转换、基准面、椭球体等多种类型
• 提供坐标转换服务，支持单点和多点转换
• 支持JSON/JSONP格式数据导出
• 多种URL访问方式，可直接通过URL获取特定CRS信息或转换结果
• 可基于EPSG数据库创建自定义索引

安装与部署

环境准备

bash
$ virtualenv venv
$ source venv/bin/activate
$ pip install -r requirements.txt

配置步骤

1. 从最新项目发布的.zip文件中复制"index"目录内容
2. 启动服务器：

   bash
   python app.py
   

   或使用gunicorn启动脚本：

   bash
   ./epsgio start
   

创建自定义EPSG索引

注意：此步骤非必需，可直接从发布版本下载现成索引使用

1. 从[[***]]下载最新EPSG数据库

   • 登录后，选择"export registry"，格式为"Export GML 3.2.1 with EPSG metadata"

2. 确保以下文件/文件夹位于同一目录：

   • 文件夹 extra_codes_proj4_4.8.0.2
   • 文件 CRS_exceptions.csv
   • 文件 CRS_exceptions.py
   • 文件 gml_parser.py
   • 文件 GmlDictionary.xml（从EPSG注册中心下载的数据库）

3. 执行索引创建：

   bash
   python gml_parser.py
   

4. 将生成的gml.sqlite文件移动到gml文件夹

URL类型

• http://epsg.io/ > 主页
• http://epsg.io/1623 > 转换或CRS
• http://epsg.io/5514-1623 > 带转换的CRS
• http://epsg.io/5514-1623.wkt > CRS 5514带转换1623的WKT页面
• http://epsg.io/5514-1623/map > CRS 5514带转换1623的地图页面
• http://epsg.io/8901-primem > 非转换或CRS类型（本初子午线、基准面等）
• http://epsg.io/ogp-op-1623 > OGC XML中的gml:id
• http://epsg.io/urn:ogc:def:coordinateOperation:EPSG::1623 > OGC XML中的gml:identifier

代码类型说明

• CRS和转换仅使用数字代码（如5514, 1623, 4326, 27700）
• 其他类型需添加后缀：
  • 基准面：如9315-datum
  • 本初子午线：如8901-primem
  • 椭球体：如7004-ellipsoid
  • 方法：如9840-method
  • 坐标系：如6422-cs
  • 轴：如106-axis
  • 区域：如1262-area
  • 单位：如9001-units

API接口

结果导出API

支持JSON和JSONP格式导出结果，示例：

http://epsg.io/?q=czech&format=json&trans=1&callback=jsonpFunction

参数说明：

• format=json：必选，指定JSON格式导出
• trans=1：可选，获取更详细的坐标参考系统转换信息
• callback=jsonpFunction：可选，指定JSONP回调函数名

/trans坐标转换API

单点转换

http://epsg.io/trans?x=50&y=17&z=0&s_srs=4326&t_srs=5514&callback=jsonpFunction

参数说明（均为可选）：

• x, y, z：待转换点坐标，默认值为0,0,0
• s_srs：源坐标参考系统，默认EPSG:4326
• t_srs：目标坐标参考系统，默认EPSG:4326
• callback=jsonpFunction：JSONP回调函数名

示例：http://epsg.io/trans将把(0,0,0)从EPSG:4326转换到EPSG:4326

多点转换

http://epsg.io/trans?data=17,50;17,50,300;17.132,50.456&s_srs=4326&&t_srs=5514

参数说明：

• data：点数据，格式为x,y;x,y,z;x.x,y.y
  • 点之间用;分隔
  • x,y,z之间用,分隔
  • 小数用.分隔

查询类型

kind:参数

其他查询参数

• deprecated: 0(默认), 1 - 筛选是否包含已弃用项
• code: EPSG编号（如5514, 4326等）
• name: 名称字符串（如wgs 84, jtsk, s-jtks）
• area: 使用区域字符串（如czech republic, world）
• area_trans: 转换使用区域字符串
• alt_title: 替代标题（如wgs84等）

查询组合示例

• 8901 kind:PRIMEM
• 1623 kind:COORDOP
• code:1625 kind:COORDOP deprecated:1