简体中文
Fx.location
约 606 字大约 2 分钟
2026-01-09
目录
摘要
本文档的概要说明如下: 本文档介绍 Fx.location 的接口定义、使用方式及相关说明。
1. findByMobile 查询单个号码归属地
Fx.location.findByMobile()
Groovy 举例
def(Boolean error, Map result, String errroMessage) = Fx.location.findByMobile("11111111111")
//返回值新增两个参数
//province_code String 类型,省份的地区码
//city_code String 类型,市的地区码负责人:吕杰lvjie
2. findByMobiles 批量查询号码归属地
Fx.location.findByMobiles()
Groovy 举例
def(Boolean error, Map result, String errroMessage) = Fx.location.findByMobiles(["11111111111", "12252225222"])负责人:吕杰lvjie
3. distance 根据经纬度,计算两点间的距离
Fx.location.distance()
Groovy 举例
BigDecimal longitude1 = 116.374409 //地点1的精度
BigDecimal latitude1 = 39.942939//地点1的纬度
BigDecimal longitude2 = 116.375721//地点2的精度
BigDecimal latitude2 = 39.942925 //地点2的纬度
def (Boolean error,Long result,String errorMessage) = Fx.location.distance(longitude1,latitude1,longitude2,latitude2)
if( error ){
Fx.log.info("计算错误 : " + errorMessage)
}else{
Fx.log.info(result)
}负责人:吕杰lvjie
4. findCountryAreaLabel 根据地区码,查询地区省市中文
Fx.location.findCountryAreaLabel()
Groovy 举例
String label = Fx.location.findCountryAreaLabel("249","province")负责人:吕杰lvjie
5. findCountryAreaCode 根据地区省市中文,查询地区码
Fx.location.findCountryAreaCode()
Groovy 举例
String provinceCode = Fx.location.findCountryAreaCode("黑龙江","province")负责人:吕杰lvjie
6. getCountryAreaOptions 查询国家省市区
Fx.location.getCountryAreaOptions()
Groovy 举例
def(Boolean error, Map data, String mesage) = Fx.location.getCountryAreaOptions()
if (error) {
log.info("error: " + mesage)
}
log.info(data['country'])
log.info(data['province'])
log.info(data['city'])
log.info(data['district'])负责人:吕杰lvjie
7. getZoningCodeByLabel 根据省市区的Label查标准行政区划编码
Fx.location.getZoningCodeByLabel()
Groovy 举例
def(Boolean error, Map data, String mesage) = Fx.location.getZoningCodeByLabel("city", "北京市")
if (error) {
log.info("error: " + mesage)
}
log.info(data)负责人:吕杰lvjie
版本记录
| 版本 | 日期 | 变更内容 | 负责人 |
|---|---|---|---|
| v1.0 | 2026-05-19 | 初始版本 |
背景说明
本文档详细描述 Fx.location 的相关接口功能和使用方法,帮助开发者快速集成相关能力。
适用场景
具体适用场景由实际业务需求决定,开发者可根据需要选择相应的接口进行集成。
前置条件
- 已接入纷享销客开放平台
- 已完成应用授权与配置
- 了解相关业务领域基础知识
操作步骤
具体操作步骤请参考各接口的详细说明。
注意事项
- 调用接口前请确保满足前置条件
- 注意接口调用频率限制
- 异常情况请参考错误码说明进行处理
兼容性说明:当前版本暂无可用的废弃或兼容性说明。
