坐标转换 API
WGS84 / GCJ02 / BD09 等坐标系互转。
1概述
提供融合定位等接口。协议默认规格有:
1、时间戳为int64,采用unix 时间戳(Unix epoch),单位为毫秒;
2、字符串都为UTF8 格式;
鉴权方式:
采用access_key 的方式,在URL 的Query Param 中添加access_key。
2坐标转换接口
转换经纬度坐标的坐标系,可在wgs84/gcj02/bd09 等坐标系之间相互转换。
2.1 请求参数
定位结果的获取,通过GET 请求下面的URL :
https://api.newayz.com/location/scenario/v1/coordinate_convertor?access_key={your_access_key}&locations=113.103815,32.396826|113.103815,32.396826|113.103815,32.396826&originSprf=bd09&targetSprf=gcj02
调用WAYZ 的API,需要提前获取KEY 信息。请求参数:
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| access_key | string | 是 | 调用API 所需的Key |
| locations | string | 是 | 经度和纬度用","分割,经度在前,纬度在后。多个坐标对之间用”|”分隔最多支持40 对坐标。 |
| originSprf | string | 是 | 输入坐标系,可选 wgs84、gcj02、bd09 |
| targetSprf | string | 否 | 输出坐标系,可选wgs84、gcj02、bd09 |
2.2 返回参数
返回参数是一个数组,与请求locations 顺序一致,返回示例如下:
[
{
"lon": 113.09722767030763,
"lat": 32.3911644889069
},
{
"lon": 113.09722767030763,
"lat": 32.3911644889069
},
{
"lon": 113.09722767030763,
"lat": 32.3911644889069
}
]
2.3 报错信息
| 错误参数 | 说明 |
|---|---|
| 400 | 参数异常 |
| 401 | Appkey 非法或不存在 |
| 403 | Appkey 权限异常 |
| 404 | 无法解析 |
| 500 | 服务器异常。可能由于服务器内部链路异常、请求超时所致。 |
401 报错信息:
{
"code": "401",
"message": "No API key found in request"
}
403 报错信息:
{
"code": "403",
"message": "Access key forbidden"
}
