Fx.location
Fx.location：和查询归属地有关的API
1. 查询单个号码归属地
Fx.location.findByMobile(<String mobile>)
参数说明
| 参数 | 类型 | 说明 |
|---|---|---|
| mobile | String | 手机号码 |
返回值类型
APIResult
返回值说明
Map
Java举例
APIResult ret = Fx.location.findByMobile("11111111111");
if (ret.isError()) {
log.info(ret.message());
} else {
log.info(ret.getData());
}
Groovy举例
def(Boolean error, Map result, String errroMessage) = Fx.location.findByMobile("11111111111")
//返回值新增两个参数
//province_code String 类型，省份的地区码
//city_code String 类型，市的地区码
2. 批量查询号码归属地
Fx.location.findByMobiles(<List mobile>)
参数说明
| 参数 | 类型 | 说明 |
|---|---|---|
| mobile | List | 手机号码列表 |
返回值类型
APIResult
返回值说明
List
Java举例
APIResult ret = Fx.location.findByMobiles(Lists.newArrayList("11111111111", "12252225222"));
if (ret.isError()) {
log.info(ret.message());
} else {
log.info(ret.getData());
}
Groovy举例
def(Boolean error, Map result, String errroMessage) = Fx.location.findByMobiles(["11111111111", "12252225222"])
3. 根据经纬度，计算两点间的距离
Fx.location.distance(<BigDecimal longitude1>, <BigDecimal latitude1>, <BigDecimal longitude2>, <BigDecimal latitude2>)
参数说明
| 参数 | 类型 | 说明 |
|---|---|---|
| longitude1 | BigDecimal | 第一个点的经度 |
| latitude1 | BigDecimal | 第一个点的纬度 |
| longitude2 | BigDecimal | 第二个点的经度 |
| latitude2 | BigDecimal | 第二个点的纬度 |
返回值类型
APIResult
返回值说明
BigDecimal
Java举例
BigDecimal longitude1 = BigDecimal.valueOf(116.374409); //地点1的精度
BigDecimal latitude1 = BigDecimal.valueOf(39.942939); //地点1的纬度
BigDecimal longitude2 = BigDecimal.valueOf(116.375721); //地点2的精度
BigDecimal latitude2 = BigDecimal.valueOf(39.942925); //地点2的纬度
APIResult ret = Fx.location.distance(longitude1,latitude1,longitude2,latitude2);
if (ret.isError()) {
log.info(ret.message());
} else {
log.info(ret.getData());
}
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)
}
4. 根据地区码，查询地区省市中文
Fx.location.findCountryAreaLabel(<String code>, <String type>)
参数说明
| 参数 | 类型 | 说明 |
|---|---|---|
| code | String | 地区码 |
| type | String | country 国家 province省 city市 district区 town 区 |
返回值类型
String
返回值说明
String(返回国家省市区的名字 ， 查询不到返回空)
Java举例
String label = Fx.location.findCountryAreaLabel("249","province");
Groovy举例
String label = Fx.location.findCountryAreaLabel("249","province")
5. 根据地区省市中文，查询地区码
Fx.location.findCountryAreaCode(<String label>, <String type>)
参数说明
| 参数 | 类型 | 说明 |
|---|---|---|
| label | String | 地区省市名 |
| type | String | country 国家 province省 city市 district区 town 区 |
返回值类型
String
返回值说明
String(返回国家省市区的地区码 ， 查询不到返回空)
Java举例
String provinceCode = Fx.location.findCountryAreaCode("黑龙江","province");
Groovy举例
String provinceCode = Fx.location.findCountryAreaCode("黑龙江","province")
6. 查询国家省市区
Fx.location.getCountryAreaOptions()
返回值类型
APIResult
返回值说明
Map
Java举例
APIResult ret = Fx.location.getCountryAreaOptions();
if (ret.isError()) {
log.info(ret.message());
} else {
log.info(ret.getData());
}
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'])
7. 根据省市区的Label查标准行政区划编码
Fx.location.getZoningCodeByLabel(<String type>, <String label>)
参数说明
| 参数 | 类型 | 说明 |
|---|---|---|
| type | String | 地区类型：只支持省:province ,市:city , 区:district |
| label | String | 地区名称 |
返回值类型
APIResult
返回值说明
Map
Java举例
APIResult ret = Fx.location.getZoningCodeByLabel("city", "北京市");
if (ret.isError()) {
log.info(ret.message());
} else {
log.info(ret.getData());
}
Groovy举例
def(Boolean error, Map data, String mesage) = Fx.location.getZoningCodeByLabel("city", "北京市")
if (error) {
log.info("error: " + mesage)
}
log.info(data)