【请勿相信任何手机号定位】【谨防被骗】
基站API
客服
QQ: 315508161, Skype: crackl168
API接口价格
套餐选项价格请求限制
0 体验测试5.00 积分/天1000 次/天
1150.00 积分/月2000 次/天
2300.00 积分/月5000 次/天
3600.00 积分/月10000 次/天
41000.00 积分/月50000 次/天
51999.00 积分/月100000 次/天
63999.00 积分/月200000 次/天
77999.00 积分/月500000 次/天
812000.00 积分/月1000000 次/天
920000.00 积分/月10000000 次/天
本站扶持开发中的项目,在开发期间的测试,可以免费。
你也可以使用本站 基站数据库 ,自行搭建基站API平台。

概述

GPSspg 基站地理定位 API 通过相关参数返回基于基站的客户端位置。通常在不能接受到GPS信号的情况下,用于获得基于基站的粗略位置,精确度取决于客户端设备和基站之间的距离。

相比于其它平台,GPSspg 基站地理定位 API 的特色:可输出供多种地图使用的经纬度坐标,如 Google Earth(WGS84) / Google Maps / 百度地图 / 腾讯高德地图 ;输出6位中国行政区划代码及12位统计用区划代码;使用 DNSpod 域名解析及 Azure 构建平台随时扩充可响应海量请求,为你的业务提高稳定性。

本接口支持单基站多基站定位查询请求。

使用限制

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

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

订阅 (开通API)

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

基站地理定位请求

请求采用以下形式:

http://api.gpsspg.com/bs/?parameters

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

参数名含义规则说明必填缺省值
oid订阅 id
key订阅 key未在控制后台绑定IP或网址时必须传入
type网络类型可选值:gsm、umts、lte、cdma。cdma 时必填。
bs基站信息 GSM/UMTS: MCC,MNC,LAC,CIMCC,MNC,LAC,CI,dBm
LTE: MCC,MNC,TAC,CIMCC,MNC,TAC,CI,dBm
CDMA: MCC,SID,NID,BIDMCC,MNC,TAC,CI,dBm
多基站分隔符号: |
hex进制10进制或16进制,MCC / MNC / dbm 必须为10进制。10
to坐标类型0 WGS84 / GPS坐标,适用于谷歌地球 Google Earth。
1 Google 坐标,适用于 Google Maps 地图模式。
2 百度坐标,适用于百度地图。
3 高德腾讯坐标,适用于高德地图/腾讯地图。
0
output返回数据格式推荐:json / jsonp / xml,试验性:html / txt json
callbackjs 回调函数jsonp 时有效。jQuery 发起 jsonp 跨域请求时会自动附加此参数。callback

参数值范围解释

  • OID:订阅之OID。在 我订阅的API 下面查看。
  • MCC:移动设备国家代码(Mobile Country Code,MCC),中国 = 460。详见:全球移动设备国家代码 MCC
  • MNC:移动设备网络代码(Mobile Network Code,MNC),中国移动 = 00,中国联通 = 01, 中国电信 = 11。详见:全球移动设备网络代码 MNC
  • LAC/TAC1~65535,LTE 时取 TAC。
  • CI (CELL Identity):
    GSM = 1~65535
    UMTS = 1~268435455,UMTS CI = RNCID * 65536 + Cell ID,CELL ID = CI mod 65536。
    LTE = 1~268435455,LTE CI = eNodBeId * 256 + Cell ID,eNodBeId = CI / 256 取整。
  • CDMA 时:
    SID0~32767,SID由国际电联管理分配。CN 号码一共1280个,包括:13568(3500)到14335(37FF),共768个;25600(6400)到26111(65FF),共512个。
    NID0~65535
    BID1~65535
  • dBm 信号值:-140~0
    GSM:RSSI in dBm in the range of -51 to -113 or ASU in the range of 0 to 31。ASU 换算关系:2 * ASU - 113 = dBm 。
    UMTS:RSCP in dBm in the range of -25 to -121 or ASU in the range of -5 to 91。ASU 换算关系:ASU - 116 = dBm 。
    LTE:RSRP in dBm in the range of -45 to -137 or ASU in the range of 0 to 95。ASU 换算关系:ASU - 140 = dBm 。
    CDMA:RSSI in dBm in the range of -75 to -100 or ASU in the range of 1 to 16
        RSSI [dBm] >= -75: ASU = 16,
        RSSI [dBm] >= -82: ASU = 8,
        RSSI [dBm] >= -90: ASU = 4,
        RSSI [dBm] >= -95: ASU = 2,
        RSSI [dBm] >= -100: ASU = 1

基站地理定位 API 结果响应

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

返回结果中的 lat lng 对应请求参数 to 的坐标类型。当 to=0(GPS坐标) 时,会附加一个 lats/lngs,用于 Google 地图模式下显示用坐标。当 to=1(Google 地图模式坐标)时,会附加一个 lats/lngs,用于 Google Maps 卫星图模式下显示用坐标。

返回结果中的 roads 少部份可能无结果会空。

返回结果中的 match:1 = 匹配,2 = 推算,8 = 国家。

字段名描述示例说明
status状态码200=OK, 404=未收错, 其它=错误。
msg状态消息ok
match结果匹配级别1 = 匹配,2 = 推算,8 = 国家。
latitude纬度多基站定位请求时为综合计算结果。
longitude经度多基站定位请求时为综合计算结果。
以下为列表结果
lat纬度
lng经度
radius覆盖半径参考值如:1500 米。
address靠近地址描述云南省西双版纳傣族自治州景洪市嘎洒镇西双版纳金星啤酒有限公司
roads靠近道路描述026乡道西约536米
以下为 MCC = 460 时列表独有结果
rid6位行政区划代码532801,见国家统计局《县及县以上行政区划代码》。
rids12位区划代码532801502000,参考值,见国家统计局《统计用区划代码和城乡划分代码》。
lats附带纬度to = 0 或 1 时返回。
lngs附带经度to = 0 或 1 时返回。
JSON 输出格式

在此示例中,查询请求了 json 响应:

http://api.gpsspg.com/bs/?oid=我订阅的oid&bs=460,01,40977,2205409&output=json

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

{
    "status": 200,
    "msg": "ok",
    "count": 1,
    "result": [
        {
            "id": "460-001-40977-002205409",
            "lat": "39.98846436",
            "lng": "116.47560883",
            "radius": "670",
            "address": "北京市朝阳区望京街道方恒购物中心",
            "roads": "望京小街西北约49米",
            "lats": "39.989763",
            "lngs": "116.481719",
            "rid": "110105",
            "rids": "110105026000"
        }
    ],
    "latitude": "39.98846436",
    "longitude": "116.47560883",
    "match": "1"
}
JSONP 输出格式

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

在此示例中,我们使用 JQuery 查询请求 jsonp 响应:

    var o_r = [];

    //请求成功的处理
    function showAjaxOK() {
        //判断状态是否成功
        if (o_r.status == 200) {
            //成功后的处理显示位置等
        } else {
            if (o_r.status == 404) {
                //没有收录此数据的处理
            } else {
                //请求参数及其它错误的处理
            }
        }
    }

    //请求失败的处理
    function showAjaxError() {
        //******;
    }

    function ajaxGetBS() {
        $.ajax({
            type: "get",
            async: false,
            url: "http://api.gpsspg.com/bs/?oid=我订阅的oid&bs=460,00,34860,62041&to=1&output=jsonp",
            dataType: "jsonp",
            success: function (results) { o_r = results; showAjaxOK(); },
            error: function () { showAjaxError(); }
        });
    }        

最终 JQuery 发起的 JSONP 请求 URL :

http://api.gpsspg.com/bs/?oid=我订阅的oid&bs=460,00,34860,62041&to=1&output=jsonp&callback=jQuery110206804860695862498_1464020668749&_=1464020668750

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

jQuery110206804860695862498_1464020668749&&jQuery110206804860695862498_1464020668749({
    "status": 200,
    "msg": "ok",
    "count": 1,
    "result": [
        {
            "id": "460-000-34860-000062041",
            "lat": "22.016220",
            "lng": "100.749283",
            "radius": "1500",
            "address": "云南省西双版纳傣族自治州景洪市景洪工业园区万达西双版纳国际度假区",
            "roads": "026乡道西约535米",
            "lats": "22.01903000",
            "lngs": "100.74812500",
            "rid": "532801",
            "rids": "532801407000"
        }
    ],
    "latitude": "22.016220",
    "longitude": "100.749283",
    "match": "1"
})
XML 输出格式

在此示例中,查询请求了 xml 响应:

http://api.gpsspg.com/bs/?oid=我订阅的oid&bs=460,01,40977,2205409&to=1&output=xml

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

<?xml version="1.0" encoding="utf-8" ?>
<Response>
<status>200</status>
<msg>ok</msg>
<count>1</count>
<latitude>39.98846436</latitude>
<longitude>116.47560883</longitude>
<match>1</match>
<results>
<result>
<id>460-001-40977-002205409</id>
<lat>39.98846436</lat>
<lng>116.47560883</lng>
<radius>670</radius>
<address>北京市朝阳区望京街道方恒购物中心</address>
<roads>望京小街西北约49米</roads>
<lats>39.989763</lats>
<lngs>116.481719</lngs>
<rid>110105</rid>
<rids>110105026000</rids>
</result>
</results>
</Response>

结果响应状态码

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

status错误描述备注
0未知错误
100站点数据维护中
110参数格式错误一般为正则校验错误:字符、长度。
120参数校验错误一般为数据值范围或可选值错误。
200OK
300执行数据查询时出错
404未收录此数据
701未订阅该api服务订阅后才可以使用
702订阅过期继续订阅
709违规暂停账户违规锁定或因违规当天暂停
900拒绝请求KEY不正确或IP/网址未绑定
901超过套餐限额可第二天使用或升级套餐

感谢使用

谢谢。

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