地理位置识别服务 LBS¶
简介¶
LBS 提供地理位置识别服务，提供根据经纬度查询地址信息、根据地址查询经纬度和根据基站信息查询经纬度及地址信息等功能。
应用场景¶
前端应用地理位置上报¶
适合基于地址位置的前端应用以及风控和合规要求的应用，这些前端应用通过移动端 SDK、web 端上报地址位置。
应用案例
App+ SDK 等其它移动端 SDK，通过上报地理位置信息，供风控使用。
常见问题¶
接口参数¶
除了公用参数 userToken 和 signature 外，其它参数需要带入前缀 param.。
API 文档¶
请求地址¶
公共参数¶
所有接口均包含公共参数，为减少冗余，单独提出。
公共请求参数
名称 |
类型 |
是否必须 |
限制 |
描述 |
|---|---|---|---|---|
userToken |
String |
是 |
40 |
用户 token 以app-开头的一串16进制编码 |
signature |
String |
是 |
64 |
64位16进制数，签名生成方式见下方说明 |
param.* |
String |
原接口的参数，如merId、productId、longitude和latitude等 |
Sigature
1.明文拼接规则
请求方法名+’:’+请求参数按照字母顺序以冒号为分隔符拼接
如请求addressQuery时，参数分别为city, address, merId,productId和busdepId，则明文 = addressQuery:<address>:<busdepId>:<city>:<merId>:<productId>。
例如：
请求addressQuery，city为上海，address为宜山路700号，则明文为：“addressQuery:宜山路700号::上海::”，最终请求链接为：
http://192.168.16.143:9090/lbsapi/api/addressQuery?userToken=app-a8187ae7-5671-4888-4321-2cc8c4d476ba \
&signature=c79cdfed3001f6d3d03c7d966baa295315244904cd7742b0f9afba4380246df6¶m.city=上海¶m.address=宜山路700号
2.明文加签规则
见章节“API签名”
根据经纬度查询地址信息¶
HTTP Request
GET http://192.168.16.143:9090/lbsapi/api/lbsQuery
请求参数
名称 |
类型 |
是否必须 |
限制 |
描述 |
|---|---|---|---|---|
longitude |
String |
是 |
20 |
纬度，如 31.1657241340 |
latitude |
String |
是 |
20 |
经度，如 117.1657241340 |
productId |
String |
否 |
20 |
产品号，M00001 |
busdepId |
String |
否 |
20 |
汇付事业部编号 |
merId |
String |
否 |
20 |
汇付商户号 |
响应参数
名称 |
类型 |
是否必须 |
限制 |
描述 |
|---|---|---|---|---|
code |
String |
是 |
3 |
请求返回码， 000为成功，099为失败，100为验证失败 |
provinceName |
String |
否 |
省份名称 |
|
provinceCode |
String |
否 |
省份编码 |
|
areaName |
String |
否 |
地区名称 |
|
areaCode |
String |
否 |
地区编码 |
|
standardCode |
String |
否 |
六位国际码 |
|
resultDesc |
String |
否 |
结果描述 |
|
country |
String |
否 |
国家 |
|
address |
String |
否 |
详细地址 |
根据地址信息查询经纬度¶
HTTP Request
GET http://192.168.16.143:9090/lbsapi/api/addressQuery
请求参数
名称 |
类型 |
是否必须 |
限制 |
描述 |
|---|---|---|---|---|
city |
String |
是 |
255 |
城市名 ，如青岛 |
address |
String |
是 |
255 |
地址 ，如青岛四方区海泊路24号 |
productId |
String |
否 |
20 |
产品号，M00001 |
busdepId |
String |
否 |
20 |
汇付事业部编号 |
merId |
String |
否 |
20 |
汇付商户号 |
响应参数
名称 |
类型 |
是否必须 |
限制 |
描述 |
|---|---|---|---|---|
code |
String |
是 |
3 |
请求返回码， 000为成功，099为失败，100为验证失败 |
longitude |
String |
是 |
20 |
纬度，如 31.1657241340 |
latitude |
String |
是 |
20 |
经度，如 117.1657241340 |
standardCode |
String |
否 |
六位国际码 |
|
lbsStat |
String |
是 |
1 |
结果类型 ， 0-失败，1-调用接口并成功，2-调用缓存并成功 |
根据基站信息查询经纬度及地址信息¶
HTTP Request
GET http://192.168.16.143:9090/lbsapi/api/baseStationQuery
请求参数
名称 |
类型 |
是否必须 |
限制 |
描述 |
|---|---|---|---|---|
mcc |
String |
是 |
20 |
移动基站 |
mnc |
String |
是 |
20 |
移动基站 |
lac |
String |
是 |
20 |
移动基站 |
cellid |
String |
是 |
20 |
移动基站 |
productId |
String |
否 |
20 |
产品号，M00001 |
busdepId |
String |
否 |
20 |
汇付事业部编号 |
merId |
String |
否 |
20 |
汇付商户号 |
响应参数
名称 |
类型 |
是否必须 |
限制 |
描述 |
|---|---|---|---|---|
code |
String |
是 |
3 |
请求返回码， 000为成功，099为失败，100为验证失败 |
longitude |
String |
是 |
20 |
纬度，如 31.1657241340 |
latitude |
String |
是 |
20 |
经度，如 117.1657241340 |
provinceName |
String |
否 |
省份名称 |
|
provinceCode |
String |
否 |
省份编码 |
|
areaName |
String |
否 |
地区名称 |
|
areaCode |
String |
否 |
地区编码 |
|
standardCode |
String |
否 |
六位国际码 |
|
resultDesc |
String |
否 |
结果描述 |
|
country |
String |
否 |
国家 |
|
address |
String |
否 |
详细地址 |
|
lbsStat |
String |
是 |
1 |
结果类型 ， 0-失败，1-调用接口并成功，2-调用缓存并 |
