服务简介
坐标转换插件版服务API为用户提供HTTP/HTTPS接口,即开发者可以通过这些接口使用各类型的坐标转换服务,实现各类坐标之间在线实时转化。
使用该服务前您需要申请服务端Key,申请地址:https://console.tianditu.gov.cn/api/key
调用方法
服务地址:https://www.bismct.top/BjCTAPIService/CoordinateTransformation/ExecuteTransformation
请求方式:post
请求示例:

{

    "transType": "1",

    "key": "500703e6799479d81e448fc08bb7e77e",

    "coordinate": {

        "name": "Z1",

        "hCoordinate": 473584.418,

        "vCoordinate": 296375.936

    },

    "coordinates": [

        {

            "name": "Z1",

            "hCoordinate": 473584.418,

            "vCoordinate": 296375.936

        },

        {

            "name": "Z2",

            "hCoordinate": 473656.795,

            "vCoordinate": 296361.531

        },

        {

            "name": "Z3",

            "hCoordinate": 473690.200,

            "vCoordinate": 296354.882

        }

    ]

}

参数说明
请求体参数说明:

参数名

示例值

参数类型

是否必填

参数描述

transType

1

String

转换类型值(值为1-16),代表不同坐标转换方式。其中:

 

第一部分:北京地方和北京2000互转(编号1-4)

1:北京地方坐标转北京2000坐标(单点)

2:北京2000坐标转北京地方坐标(单点)

3:北京地方坐标转北京2000坐标(多点)

4:北京2000坐标转北京地方坐标(多点)

 

第二部分:北京地方和国家2000平面互转(编号5-8)

5:北京地方坐标转国家2000平面坐标(单点)

6:国家2000平面坐标转北京地方坐标(单点)

7:北京地方坐标转国家2000平面坐标(多点)

8:国家2000平面坐标转北京地方坐标(多点)

 

第三部分:北京2000和国家2000平面互转(编号9-12)

9:北京2000坐标转国家2000平面坐标(单点)

10:国家2000平面坐标转北京2000坐标(单点)

11:北京2000坐标转国家2000平面坐标(多点)

12:国家2000平面坐标转北京2000坐标(多点)

 

第四部分:国家2000平面和国家2000经纬度互转(编号 13-16)

13:国家2000平面坐标转国家2000经纬度坐标(单点)

14:国家2000经纬度坐标转国家2000平面坐标(单点)

15:国家2000平面坐标转国家2000经纬度坐标(多点)

16:国家2000经纬度坐标转国家2000平面坐标(多点)

 

key

500703e6799479d81e448fc08bb7e77e

String

天地图北京申请的服务端的key

coordinate

 

Object

单点坐标对象,可空类型,单点模式使用

|-name

Z1

String

单点坐标名称

           |-hCoordinate

473584.418

Number

单点横坐标,平面代表Y坐标,经纬度代表B 纬度

          |-vCoordinate

296375.936

Number

单点纵坐标,平面代表X坐标,经纬度代表L 经度

coordinates

 

Array

多点坐标数组,可空类型,多点模式使用(最多300)

|-name

Z1

String

某点位坐标名称

            |-hCoordinate

473584.418

Number

某点位横坐标,平面代表Y坐标,经纬度代表B 纬度

           |-vCoordinate

296375.936

Number

某点位纵坐标,平面代表X坐标,经纬度代表L 经度

返回参数说明:(200)成功

参数名

示例值

参数类型

参数描述

statusCode

200

Integer

响应状态码

message

坐标转换成功

String

提示信息

data

 

Object

返回数据对象,可空

|-name

Z1

String

点位名称

            |-hCoordinate

770144

Number

点位横坐标,平面代表Y坐标,经纬度代表B 纬度

           |-vCoordinate

591958

Number

点位纵坐标,平面代表X坐标,经纬度代表L 经度

返回参数说明:(404)失败

参数名

示例值

参数类型

参数描述

statusCode

404

Integer

响应状态码

message

请输入服务端的Key

String

提示信息

data

null

Null

失败情况下,为空