装载GPSspg Api

欢迎访问 GPSspg API

地图坐标转换兼容 API

  1. 概述
  2. 使用限制
  3. 订阅
  4. 经纬度类型
  5. 坐标转换请求
  6. 坐标转换结果响应
    1. JSON
    2. JSONP
    3. XML
  7. 结果响应状态码

概述

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

使用限制

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

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

订阅

需要先在用户后台 API 下面订阅,订阅成功后,在 我订阅的API 下面可以看到OIDKEY。一个账户只能订阅一个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 如下所示:

  200   84.21 38.70 0   22.95849076 113.98106657 1   39.91809989 116.34455588 1    

结果响应状态码

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)