地理位置预测开放接口

                                                                                                           

名词解释

1、用户位置预测:对用户的历史位置数据进行挖掘,发现用户的位置移动模式,对用户未来可能前往的位置进行预测。目前仅限分行IP访问,后续视需求开放。

2、用户下一跳位置预测:根据用户当前的位置,预测用户下一个可能前往的位置。

3、用户固定时间段位置预测:预测用户在工作日工作时间段、工作日休息时间段、周末工作时间段、周末休息时间段可能前往的位置。


用户下一跳位置预测

1、接口:

http://api.shenji.cmbchina.net:8080/LocationForcast/api/nextlocation

需开通生产环境防火墙访问权限。

2、参数格式:

接口
入参/返回类型参数说明是否必传
appId入参string应用ID,由手机银行客户端生成
latitude入参string用户当前位置的纬度
longitude入参string用户当前位置的经度
code返回int返回标识,200:请求成功,403:无权限,500:服务器错误
message返回string返回提示信息
locations返回string返回用户下一跳可能前往的一个或多个位置,JSON数组格式。单个JSON对象存放单个位置信息,其中lat为下一跳位置的纬度, lon为下一跳位置的经度,rate为用户前往该位置的概率,rate的取值范围为(0,1],值越大表示前往该位置的概率越大

3、接口请求类型:post

参数采用post方式传入,参数格式采用json类型

4、示例报文:

POST  http://api.shenji.cmbchina.net:8080/LocationForcast/api/nextlocation


params: {

appId: "0000000005020130925203027732fd13ec8f7552cebe1OJBK",

latitude:"39.96065464326296",

longitude:"116.47727214270058"

}


return

{

       code:200,

       message:”请求成功!”,

       datas: {

               appId: " 0000000005020130925203027732fd13ec8f7552cebe1OJBK",

               locations: [

                               {lat:"39.9093145110",lon: "116.6443595176",rate: 0.5},

                               {lat:"39.9093145110",lon: "116.6443595176",rate: 0.3},

                               {lat:"39.9093145110",lon: "116.6443595176",rate: 0.2},

               ]

       }

}



用户固定时间段位置预测

1、接口:

http://api.shenji.cmbchina.net:8080/LocationForcast/api/currentlocation

需开通生产环境防火墙访问权限。

2、参数格式:

接口
入参/返回
类型
参数说明
是否必传
appId入参string应用ID,由手机银行客户端生成
times入参int[]预测用户位置的时间段,int数组,0:工作日工作时间段(weekdayWork),1:工作日休息时间段(weekdayRest),2:周末工作时间段(weekendWork),3:周末休息时间段(weekendRest)。说明:周一至周五为工作日,08:00:00-18:00:00为工作时间否(默认为当前时间)
code返回int返回标识,200:请求成功,403:无权限,500:服务器错误
message返回string返回提示信息
locations返回string用户在不同时间段可能前往的一个或多个位置,JSON数组格式。单个JSON对象存放单个位置信息,其中lat为下一跳位置的纬度, lon为下一跳位置的经度,rate为用户前往该位置的概率,rate的取值范围为(0,1],值越大表示前往该位置的概率越大

3、接口请求类型:post

参数采用post方式传入,参数格式采用json类型

4、示例报文:

(1)、当前时间段不为空

     POST  http://api.shenji.cmbchina.net:8080/LocationForcast/api/currentlocation

     params: {

      appId: "0000000103220170607E5571090-EAD9-433F-A572-4BEB17E533880w8Pv6Zs=",

      times:[0,1]

     }


    return

    {

         code:200,

         message:”请求成功!”,

          datas: {

             appId: "0000000103220170607E5571090-EAD9-433F-A572-4BEB17E533880w8Pv6Zs=",

             locations: {

                   weekdayWork:[

                           {lat:"39.9093145110",lon: "116.6443595176",rate: 0.5},

                           {lat:"39.9093145110",lon: "116.6443595176",rate: 0.3},

                           {lat:"39.9093145110",lon: "116.6443595176",rate: 0.2},

                   ],

                   weekdayRest:[

                           {lat:"38.909314",lon: "116.6443595176",rate: 0.5},

                           {lat:"38.90935110",lon: "116.6443595",rate: 0.3},

                           {lat:"38.90931410",lon: "116.6443576",rate: 0.2},

                   ]

            }

       }

   }


(2)、 当前时间段为空


    POST  http://api.shenji.cmbchina.net:8080/LocationForcast/api/currentlocation

     params: {

      appId: "0000000103220170607E5571090-EAD9-433F-A572-4BEB17E533880w8Pv6Zs="

     }


    return

    {

         code:200,

         message:”请求成功!”,

          datas: {

             appId: "0000000103220170607E5571090-EAD9-433F-A572-4BEB17E533880w8Pv6Zs=",

             locations: [

                      {lat:"38.909314",lon: "116.6443595176",rate: 0.5},

                      {lat:"38.90935110",lon: "116.6443595",rate: 0.3},

                      {lat:"38.90931410",lon: "116.6443576",rate: 0.2},

            ]

      }

   }


用户常去商圈推荐

1、接口:


http://api.shenji.cmbchina.net:8080/LocationForcast/api/TradeAreaNum
需开通生产环境防火墙访问权限。


2、参数格式:

接口
入参/返回类型参数说明是否必传
appId入参string应用ID,由手机银行客户端生成
maxTradeAreaNum入参string返回常去商圈最大数量
code
返回int返回标识,200:请求成功,403:无权限,500:服务器错误
message返回string返回提示信息
tradeAera返回string用户常去商圈,JSON数组格式。单个JSON对象存放单个商圈信息,如果用户存在常去商圈,返回用户常去商圈编号USUALLY及频次valuevalue值越大表示用户前往该商圈越频繁;如果用户不存在常去商圈,返回用户常去位置距离最近的商圈编号NEAREST及距离valuevalue值越小表示用户前往该商圈附近越频繁。


3、接口请求类型:post


参数采用post方式传入,参数格式采用json类型



4、示例报文:


POST  http://api.shenji.cmbchina.net:8080/LocationForcast/api/TradeAreaNum
params: {
     appId: "000000000612013091257C5DFEC-2694-44DB-8956-20E371A9A6AD0iOTgvH8=",
     maxTradeAreaNum:10
 }

Return{
   "code":200,
   "message":"请求成功!",
   "datas":
   {
       "appId":"000000000612013091257C5DFEC-2694-44DB-8956-20E371A9A6AD0iOTgvH8=",
       "tradeAera":[
           {
               "USUALLY":"14",
               "value":"19.0"
           }
       ]
   }
}


后续计划开放接口

后续计划开放的接口包括:

1)地理围栏签到:提供自定义围栏功能,判断用户的地理位置是否处于定义的地理围栏内,可用于线下活动签到、上班打卡签到等场景。

2)地理围栏监控:提供自定义围栏功能,①对地理围栏内的用户群体进行监控,包括年龄、性别、教育程度、婚姻状态、财富状况、开卡比例、用户流量等特征;②对地理围栏状态进行监控,包括围栏登录时间类型、围栏所属场所类型(商务区、住宅区、商圈等)等特征。

3)地理围栏高端场所客群发现:根据自定义的高端场所,发现与高端场所之间具有较大黏性的潜在高端客群。

4)用户常驻位置发现:根据历史数据,发现用户常驻的位置,结合地图数据判断位置所属的具体场所类型(商务区、住宅区、商圈等)。


支持人员

接口相关支持可联系:杨继龙/01144163、邹航/80230515。