地图坐标转换兼容 API

概述

地图坐标转换兼容是将某一地图坐标转换为另一地图坐标，实现经纬度数据兼容，以方便切换到喜欢的地图。支持地图经纬度坐标任意相互转换：WGS84(Google Earth)，Google Maps谷歌地图，百度地图，腾讯地图 / 高德地图 / 阿里地图，MapBar图吧地图。

使用限制

我们对这些请求设置了次数限制（视订阅套餐限制请求次数），以防出现滥用服务的现象。并且此限制以后可能会在不另作通知的情况下发生变化。此外，我们还设定了请求速率限制，以防滥用此服务。如果您超出了 24小时限制次数或以其他方式滥用此服务，坐标转换 API 可能会临时停止运行。如果您继续超出此限制，那么系统将阻止您访问坐标转换 API。不能注册多个账户使用免费服务进行大量请求，否则永久封锁账号或IP。

注意：不能以采集目的使用此API。否则你的账户或IP可能被永久锁定。

经纬度类型

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。
建议：在你的网站上进行 JSONP 跨域请求，请绑定网址；在固定 IP 上请求，请绑定 IP。
output：输出格式
    json（默认），用于表示以 JavaScript 对象表示法 (JSON) 的形式输出。
    jsonp，用于以 JavaScript 对象跨域访问数据。
    xml，用于表示以 XML 的形式输出。
callback：1~60位英文数字下划线。在输出JSONP时需指定，默认值为 callback。

坐标转换结果响应

返回的结果响应格式由网址请求的参数中的 output 标记指定。默认为json。

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 输出格式

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 ] })

XML 输出格式

在此示例中，查询请求了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 如下所示：

<?xml version="1.0" encoding="UTF8"?> <ResultResponse> <status>200</status> <result> <results> <lat>84.21</lat> <lng>38.70</lng> <match>0</match> </results> <results> <lat>22.95849076</lat> <lng>113.98106657</lng> <match>1</match> </results> <results> <lat>39.91809989</lat> <lng>116.34455588</lng> <match>1</match> </results> </result> </ResultResponse>

结果响应状态码

status	错误描述	备注
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	超过套餐限额	可第二天使用或升级套餐

感谢使用

谢谢。

装载GPSspg Api