地图坐标转换兼容是将某一地图坐标转换为另一地图坐标,实现经纬度数据兼容,以方便切换到喜欢的地图。支持地图经纬度坐标任意相互转换:WGS84(Google Earth),Google Maps谷歌地图,百度地图,腾讯地图 / 高德地图 / 阿里地图,MapBar图吧地图。
我们对这些请求设置了次数限制(视订阅套餐限制请求次数),以防出现滥用服务的现象。并且此限制以后可能会在不另作通知的情况下发生变化。此外,我们还设定了请求速率限制,以防滥用此服务。如果您超出了 24小时 限制次数或以其他方式滥用此服务,坐标转换 API 可能会临时停止运行。如果您继续超出此限制,那么系统将阻止您访问 坐标转换 API。不能注册多个账户使用免费服务进行大量请求,否则永久封锁账号或IP。
注意:不能以采集目的使用此API。否则你的账户或IP可能被永久锁定。
需要先在用户后台 API 下面订阅,订阅成功后,在 我订阅的API 下面可以看到OID与KEY。一个账户只能订阅一个API。订阅之套餐级别可随时更改。
0
= WGS84 / GPS硬件 / Google Earth / Google Maps 卫星模式1
= Google Maps 地图模式2
= 百度地图坐标3
= QQ腾讯地图坐标 / 高德地图坐标 / 阿里云地图坐标4
= MapBar图吧地图坐标请求采用以下形式:
http://api.gpsspg.com/convert/latlng/?parameters
有些参数是必填的,有些则是可选的。根据网址的标准,所有参数均使用和号字符 (&) 进行分隔。下面的列表枚举了这些参数及其可能的值。
必填参数
oid
:订阅之OID。查看我订阅API的OID。from
:表示输入经纬度类型。to
:表示输出经纬度类型。latlng
:纬度/经度文本值。每次最大20组。单组如:22.9621107600,113.9826665700,多组如:22.9621107600,113.9826665700;39.9173698900,116.3489858800。选填参数
key
:32位文本值。在 我订阅的API 下面查看。如果附加了订阅之KEY参数,将只验证KEY是否相符(不验证绑定之IP与网址)。请勿暴露你的KEY。 output
:输出格式 json
(默认),用于表示以 JavaScript 对象表示法 (JSON) 的形式输出。 jsonp
,用于以 JavaScript 对象跨域访问数据。 xml
,用于表示以 XML 的形式输出。callback
:1~60位英文数字下划线。在输出JSONP时需指定,默认值为 callback。 返回的结果响应格式由网址请求的参数中的 output
标记指定。默认为json。
在此示例中,查询请求了3组坐标的 json
响应:
http://api.gpsspg.com/convert/latlng/?oid=我的oid&from=0&to=4&latlng=84.21,38.70;22.9621107600,113.9826665700;39.9173698900,116.3489858800
此请求返回的 JSON 如下所示:请注意,实际的 JSON 可能包含较少的空白。您不应假定请求之间的空白数量或格式。
{ "status": "200", "result": [ { "lat": 84.21, "lng": 38.7 }, { "lat": 22.95849076, "lng": 113.98106657 }, { "lat": 39.91809989, "lng": 116.34455588 } ], "match": [ 0, 1, 1 ] }
JSONP是一个非官方的协议,它允许在服务器端集成Script tags返回至客户端,通过javascript callback的形式实现跨域访问(这仅仅是JSONP简单的实现形式)。
在此示例中,查询请求了3组坐标的 jsonp
响应:
http://api.gpsspg.com/convert/latlng/?oid=我的oid&from=0&to=4&latlng=84.21,38.70;22.9621107600,113.9826665700;39.9173698900,116.3489858800&output=jsonp&callback=callback
此请求返回的 文本 如下所示:请注意,实际的 文本 可能包含较少的空白。您不应假定请求之间的空白数量或格式。
callback&&callback({ "status": "200", "result": [ { "lat": 84.21, "lng": 38.70 }, { "lat": 22.95849076, "lng": 113.98106657 }, { "lat": 39.91809989, "lng": 116.34455588 } ], "match": [ 0, 1, 1 ] })
在此示例中,查询请求了3组坐标的 xml
响应:
http://api.gpsspg.com/convert/latlng/?oid=我的oid&from=0&to=4&latlng=84.21,38.70;22.9621107600,113.9826665700;39.9173698900,116.3489858800&output=xml
此请求返回的 XML 如下所示:
200 84.21 38.70 0 22.95849076 113.98106657 1 39.91809989 116.34455588 1
0 | 未知错误 | |
100 | 站点数据维护中 | |
110 | 参数格式错误 | |
120 | 参数超过限量 | 最大只能20组纬度经度 |
121 | 数值验证错误 | 如经纬度不在标准范围:纬度-90~90,经度-180~180 |
150 | 验证数值时出错 | |
200 | OK | |
300 | SQL数据连接错误 | |
301 | 读取SQL数据时出错 | |
701 | 未订阅该api服务 | 订阅后才可以使用 |
702 | 订阅过期 | 继续订阅 |
709 | 违规暂停 | 账户违规锁定或因违规当天暂停 |
900 | 拒绝请求 | KEY不正确或IP/网址未绑定 |
901 | 超过套餐限额 | 可第二天使用或升级套餐 |
谢谢。