客服
QQ: 315508161, Skype: crackl168
API接口价格
套餐选项价格请求限制
0 免费0 积分/天2000 次/天
15.00 积分/天10000 次/天
250.00 积分/天86400 次/天
319.00 积分/月5000 次/天
430.00 积分/月10000 次/天
560.00 积分/月20000 次/天
690.00 积分/月30000 次/天
7150.00 积分/月50000 次/天
8300.00 积分/月100000 次/天
9600.00 积分/月200000 次/天

概述

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

使用限制

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

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

订阅

需要先在用户后台 API 下面订阅,订阅成功后,在 我订阅的API 下面可以看到OIDKEY。一个账户只能订阅一个API。订阅之套餐级别可随时更改。

坐标转换请求

请求采用以下形式:

http://api.gpsspg.com/convert/coord/?parameters

支持 GET 或 POST 方式的请求,但所有参数只能通过一种方式传送。
有些参数是必填的,有些则是可选的。根据网址的标准,所有参数均使用和号字符 (&) 进行分隔。下面的列表枚举了这些参数及其可能的值。

参数名含义规则说明必填缺省值
oid订阅 id
key订阅 key未在控制后台绑定IP或网址时必须传入
from输入坐标类型0 = GPS 坐标 / WGS84,适用于谷歌地球 Google Earth。
1 = Google 坐标,适用于 Google Maps 地图模式。
2 = 百度坐标,适用于百度地图。
3 = 高德坐标 / 腾讯坐标,适用于高德地图 / 腾讯地图。
4 = Mapbar 图吧坐标,适用于图吧地图。
to输出坐标类型0 = GPS 坐标 / WGS84,适用于谷歌地球 Google Earth。
1 = Google 坐标,适用于 Google Maps 地图模式。
2 = 百度坐标,适用于百度地图。
3 = 高德坐标 / 腾讯坐标,适用于高德地图 / 腾讯地图。
4 = Mapbar 图吧坐标,适用于图吧地图。
latlng坐标组每组纬度在前,经度在后。最大20组。分隔符;
单组如:22.9621107600,113.9826665700
多组如:22.9621107600,113.9826665700;39.9173698900,116.3489858800
output返回数据格式推荐:json / jsonp / xml,试验性(存在修改可能):html / txt json
callbackjs 回调函数jsonp 时有效。jQuery 发起 jsonp 跨域请求时会自动附加此参数。callback

坐标转换结果响应

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

返回结果中的 match:1 = 匹配,0 = 未执行转换。

JSON 输出格式

在此示例中,查询请求了3组坐标的 json 响应:

http://api.gpsspg.com/convert/coord/?oid=我的oid&from=0&to=4&latlng=84.21,38.70;22.9621107600,113.9826665700;39.9173698900,116.3489858800

此请求返回的 JSON 如下所示:请注意,实际的 JSON 可能包含较少的空白。您不应假定请求之间的空白数量或格式。

{
    "status": 200,
    "msg": "ok",
    "count": 3,
    "result": [
        {
            "lat": "84.21",
            "lng": "38.70",
            "match": "0"
        },
        {
            "lat": "22.95849076",
            "lng": "113.98106657",
            "match": "1"
        },
        {
            "lat": "39.91809989",
            "lng": "116.34455588",
            "match": "1"
        }
    ]
}
JSONP 输出格式

JSONP是一个非官方的协议,它允许在服务器端集成Script tags返回至客户端,通过javascript callback的形式实现跨域访问(这仅仅是JSONP简单的实现形式)。

在此示例中,查询请求了3组坐标的 jsonp 响应:

http://api.gpsspg.com/convert/coord/?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,
    "msg": "ok",
    "count": 3,
    "result": [
        {
            "lat": "84.21",
            "lng": "38.70",
            "match": "0"
        },
        {
            "lat": "22.95849076",
            "lng": "113.98106657",
            "match": "1"
        },
        {
            "lat": "39.91809989",
            "lng": "116.34455588",
            "match": "1"
        }
    ]
})
XML 输出格式

在此示例中,查询请求了3组坐标的 xml 响应:

http://api.gpsspg.com/convert/coord/?oid=我的oid&from=0&to=4&latlng=84.21,38.70;22.9621107600,113.9826665700;39.9173698900,116.3489858800&output=xml

此请求返回的 XML 如下所示:

<Response>
<status>200</status>
<msg>ok</msg>
<count>3</count>
<results>
<result>
<lat>84.21</lat>
<lng>38.70</lng>
<match>0</match>
</result>
<result>
<lat>22.95849076</lat>
<lng>113.98106657</lng>
<match>1</match>
</result>
<result>
<lat>39.91809989</lat>
<lng>116.34455588</lng>
<match>1</match>
</result>
</results>
</Response>

结果响应状态码

建议:在检查状态码 status = 200 后再处理相关结果。

status错误描述备注
0未知错误
100站点数据维护中
110参数格式错误
120参数超过限量最大只能20组纬度经度
121数值验证错误如经纬度不在标准范围:纬度-90~90,经度-180~180
150验证数值时出错
200OK
300SQL数据连接错误
301读取SQL数据时出错
701未订阅该api服务订阅后才可以使用
702订阅过期继续订阅
709违规暂停账户违规锁定或因违规当天暂停
900拒绝请求KEY不正确或IP/网址未绑定
901超过套餐限额可第二天使用或升级套餐

感谢使用

谢谢。

相关链接
© 2016 GPSspg - 联系我们