常用公共服务接口与java调用实现

概述:

本节讲述日常生活中常用的一些公众服务的查询接口,其中包括天气查询,pm2.5情况查询,身份证查询、电话归属地查询,IP来源于地址查询等。

查询接口:

一、天气查询

a、提供以下天气信息:1. 当前时间2. 当前气温3. 最高气温4. 最低气温5. 天气情况,晴,,多云等6. 风向7. 风速8. 经纬度、海拔9. 日出日落时间

b、提供接口

1. 天气查询——根据城市代码

接口地址:

请求方法:GET

请求参数:

参数名类型必填参数位置描述默认值

cityidstring是urlParam城市代码101010100

请求示例:?cityid=101010100

2.天气查询——根据城市名称

接口地址:

请求方法:GET

请求参数:

参数名类型必填参数位置描述默认值

citynamestring是urlParam城市名称北京

请求示例:?cityname=北京

3.天气查询——根据城市拼音

接口地址:

请求方法:GET

请求参数:

参数名类型必填参数位置描述默认值

citypinyinstring是urlParam城市拼音beijing

请求示例:?citypinyin=beijing

天气查询返回的数据如下:

JSON返回示例:

{errNum: 0,errMsg: "success",retData: { city: "北京", //城市 pinyin: "beijing", //城市拼音 citycode: "101010100", //城市编码date: "15-02-11", //日期 time: "11:00", //发布时间 postCode: "100000", //邮编 longitude: 116.391, //经度 latitude: 39.904, //维度 altitude: "33", //海拔weather: "晴", //天气情况 temp: "10", //气温 l_tmp: "-4", //最低气温 h_tmp: "10", //最高气温 WD: "无持续风向", //风向 WS: "微风(<10m/h)", //风力 sunrise: "07:12", //日出时间 sunset: "17:44" //日落时间 }}

4. 城市信息查询——根据城市名称

接口地址:

请求方法:GET

请求参数:

参数名类型必填参数位置描述默认值

citynamestring是urlParam城市名称北京

请求示例:?cityname=北京

城市信息查询返回的信息如下:

JSON返回示例:

{errNum: 0,retMsg: "success",retData: {cityName: "北京",provinceName: "北京",cityCode: "101010100", //天气预报城市代码zipCode: "100000",//邮编telAreaCode: "010"//电话区号}}

二、PM2.5查询

a、空气质量指数服务支持以下功能:1、实时查询空气质量,小时粒度;2、实时给出空气质量AQI指数,并给出空气质量级别和首要污染物;

b、查询接口

接口地址:

请求方法:GET

请求参数:

参数名类型必填参数位置描述默认值

citystring是urlParam城市名,具体支持城市请查看基本介绍北京

请求示例:?city=北京

返回的数据为:

JSON返回示例:

{errNum: 0, //非0表示失败retMsg: "success",retData: {city: "北京", //城市,支持城市列表,请参考基本信息说明time: "2014-12-04T13:00:00Z", //数据采集时间aqi: 38, //空气质量指数level: "优", //空气等级core: "" //首要污染物}}

三、身份证信息查询

a、提供以下功能:1、身份证归属地信息查询

b、查询接口

接口地址:

请求方法:GET

请求参数:

参数名类型必填参数位置描述默认值

idstring是urlParam身份证号420984198704207896

请求示例:?id=420984198704207896

返回信息如下:

JSON返回示例:

{"errNum": 0,"retMsg": "success","retData": {"sex": "M", //M-男,F-女,N-未知"birthday": "1987-04-20","address": "湖北省孝感市汉川市"}}

三、电话归属地查询

a、功能

提供手机号码归属地的查询,获取号码在的省份以及对应的运营商

b、调用接口

接口地址:

请求方法:GET

请求参数:

参数名类型必填参数位置描述默认值

telstring是urlParam手机号码15846530170

请求示例:?tel=15846530170

返回结果为:

JSON返回示例:

{errNum: 0,errMsg: "success",retData: { telString: "15846530170", //手机号码 province: "黑龙江", //省份 carrier: "黑龙江移动" //运营商 }}

四、IP查询

a、功能简介

1. 显示查询的IP地址号2. 显示IP地址所在的国家3. 显示IP地址所在的大的区域,比如华北,华南4. 显示IP地址所在的省,市5. 显示具体的区6. 显示运营商

b、调用接口

接口地址:

请求方法:GET

请求参数:

参数名类型必填参数位置描述默认值

ipstring是urlParamip地址117.89.35.58

请求示例:?ip=117.89.35.58

返回数据:于千万年之中,于千万人之中,在时间无涯的荒野中,

常用公共服务接口与java调用实现

相关文章:

你感兴趣的文章:

标签云: