装载GPSspg Api
地图坐标转换兼容 API
- 概述
- 使用限制
- 订阅
- 经纬度类型
- 坐标转换请求
- 坐标转换结果响应
- JSON
- JSONP
- XML
- 结果响应状态码
概述
地图坐标转换兼容是将某一地图坐标转换为另一地图坐标，实现经纬度数据兼容，以方便切换到喜欢的地图。支持地图经纬度坐标任意相互转换：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。
建议：在你的网站上进行 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>
结果响应状态码
| 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 | 超过套餐限额 | 可第二天使用或升级套餐 |
感谢使用
谢谢。