JAVA的免费天气api接口调用示例

2023-01-09 12:30:37

step1:选择本文所示例的接口"免费天气api" url:https://www.juhe.cn/docs/api/id/39/aid/87

step2:每个接口都需要传入一个参数key,相当于用户的令牌,所以第一步你需要申请一个key

step3:看文档!!!学过java的同学们都知道,当我们对一个类或者方法不明白其意图和思想时,我们可以去查看文档,这里也不例外,而且对于英文不是特别好的同学来说很幸运的是,聚合网站上的文档都是中文版本的,比起阅读java源码里的英文文档应该轻松很多.

全国天气预报接口下面有六个子接口,打开第一个接口链接,看文档发现需要传入一个城市名或者城市ID参数,这个参数我们可以通过第六个子接口获取(接口之间参数的调用类似于java中方法之间的调用),即支持城市列表获取.所以示例中我们先调用这个接口.调用接口涉及到请求网络资源的问题,这里我封装了一个工具类,包含GET和POST两种方法

step4:上代码

Demo1:网络访问工具类(封装get和post方法)

  1. package juheAPI;
  2. import java.io.BufferedReader;
  3. import java.io.BufferedWriter;
  4. import java.io.InputStream;
  5. import java.io.InputStreamReader;
  6. import java.io.OutputStream;
  7. import java.io.OutputStreamWriter;
  8. import java.net.HttpURLConnection;
  9. import java.net.URL;
  10. import java.util.Map;
  11. /**
  12. * 网络访问工具类
  13. * @author silk
  14. *
  15. */
  16. public class PureNetUtil {
  17. /**
  18. * get方法直接调用post方法
  19. * @param url 网络地址
  20. * @return 返回网络数据
  21. */
  22. public static String get(String url){
  23. return post(url,null);
  24. }
  25. /**
  26. * 设定post方法获取网络资源,如果参数为null,实际上设定为get方法
  27. * @param url 网络地址
  28. * @param param 请求参数键值对
  29. * @return 返回读取数据
  30. */
  31. public static <K, V> String post(String  url,Map<K,V>   param){
  32. HttpURLConnection conn=null;
  33. try {
  34. URL u=new URL(url);
  35. conn=(HttpURLConnection) u.openConnection();
  36. StringBuffer sb=null;
  37. if(param!=null){//如果请求参数不为空
  38. sb=new StringBuffer();
  39. /*A URL connection can be used for input and/or output.  Set the DoOutput
  40. * flag to true if you intend to use the URL connection for output,
  41. * false if not.  The default is false.*/
  42. //默认为false,post方法需要写入参数,设定true
  43. conn.setDoOutput(true);
  44. //设定post方法,默认get
  45. conn.setRequestMethod("POST");
  46. //获得输出流
  47. OutputStream out=conn.getOutputStream();
  48. //对输出流封装成高级输出流
  49. BufferedWriter writer=new BufferedWriter(new OutputStreamWriter(out));
  50. //将参数封装成键值对的形式
  51. for(Map.Entry s:param.entrySet()){
  52. sb.append(s.getKey()).append("=").append(s.getValue()).append("&");
  53. }
  54. //将参数通过输出流写入
  55. writer.write(sb.deleteCharAt(sb.toString().length()-1).toString());
  56. writer.close();//一定要关闭,不然可能出现参数不全的错误
  57. sb=null;
  58. }
  59. conn.connect();//建立连接
  60. sb=new StringBuffer();
  61. //获取连接状态码
  62. int recode=conn.getResponseCode();
  63. BufferedReader reader=null;
  64. if(recode==200){
  65. //Returns an input stream that reads from this open connection
  66. //从连接中获取输入流
  67. InputStream in=conn.getInputStream();
  68. //对输入流进行封装
  69. reader=new BufferedReader(new InputStreamReader(in));
  70. String str=null;
  71. sb=new StringBuffer();
  72. //从输入流中读取数据
  73. while((str=reader.readLine())!=null){
  74. sb.append(str).append(System.getProperty("line.separator"));
  75. }
  76. //关闭输入流
  77. reader.close();
  78. if (sb.toString().length() == 0) {
  79. return null;
  80. }
  81. return sb.toString().substring(0,
  82. sb.toString().length() - System.getProperty("line.separator").length());
  83. }
  84. } catch (Exception e) {
  85. e.printStackTrace();
  86. return null;
  87. }finally{
  88. if(conn!=null)//关闭连接
  89. conn.disconnect();
  90. }
  91. return null;
  92. }
  93. }

Demo2:调用获取城市列表接口示例

  1. package juheAPI;
  2. import net.sf.json.JSONArray;
  3. import net.sf.json.JSONObject;
  4. /**
  5. * 获取城市列表
  6. * 全国天气预报接口调用JAVA示例
  7. *     dtype     string    N    返回数据格式：json或xml,默认json
  8. *     key        string     Y    你申请的key
  9. * @author silk
  10. *
  11. */
  12. public class GetCityList {
  13. /**
  14. * 调用获取城市列表接口,返回所有数据
  15. * @return 返回接口数据
  16. */
  17. public static String excute(){
  18. String url="http://v.juhe.cn/weather/citys?key=***a7558b2e0bedaa19673f74a6809ce";//接口URL
  19. //PureNetUtil是一个封装了get和post方法获取网络请求数据的工具类
  20. return PureNetUtil.get(url);//使用get方法
  21. }
  22. /**
  23. * 调用接口返回数据后,解析数据,根据输入城市名得到对应ID
  24. * @param cityName 城市名称
  25. * @return 返回对应ID
  26. */
  27. public static String getIDBycityName(String cityName) {
  28. String result=excute();//返回接口结果,得到json格式数据
  29. if(result!=null){
  30. JSONObject obj=JSONObject.fromObject(result);
  31. result=obj.getString("resultcode");//得到返回状态码
  32. if(result!=null&&result.equals("200")){//200表示成功返回数据
  33. result=obj.getString("result");//得到城市列表的json格式字符串数组
  34. JSONArray arr=JSONArray.fromObject(result);
  35. for(Object o:arr){//对arr进行遍历
  36. //将数组中的一个json个数字符串进行解析
  37. obj=JSONObject.fromObject(o.toString());
  38. /*此时obj如 {"id":"2","province":"北京","city":"北京","district":"海淀"}*/
  39. //以city这个key为线索判断所需要寻找的这条记录
  40. result=obj.getString("district");
  41. //防止输入城市名不全,如苏州市输入为苏州,类似与模糊查询
  42. if(result.equals(cityName)||result.contains(cityName)){
  43. result=obj.getString("id");//得到ID
  44. return result;
  45. }
  46. }
  47. }
  48. }
  49. return result;
  50. }
  51. public static void main(String[] args) {
  52. System.out.println(getIDBycityName("香港"));
  53. }
  54. }

Demo3:调用根据城市名/id查询天气

  1. package juheAPI;
  2. import net.sf.json.JSONObject;
  3. /**
  4. * 根据城市名/id查询天气
  5. * @author silk
  6. *
  7. */
  8. public class WeatherReportByCity {
  9. /**
  10. * 根据城市名获取
  11. * @param cityName
  12. * @return
  13. */
  14. public static String excute(String cityName){
  15. String url=//此处以返回json格式数据示例,所以format=2,以根据城市名称为例,cityName传入中文
  16. "http://v.juhe.cn/weather/index?cityname="+cityName+"&key=***a7558b2e0bedaa19673f74a6809ce";
  17. return PureNetUtil.get(url);//通过工具类获取返回数据
  18. }
  19. /**
  20. * 获取返回数据中的一个属性示例,此处以获取今日温度为例
  21. * "temperature": "8℃~20℃"     今日温度
  22. * @param args
  23. * @return
  24. */
  25. public static String GetTodayTemperatureByCity(String city) {
  26. String result=excute(city);
  27. if(result!=null){
  28. JSONObject obj=JSONObject.fromObject(result);
  29. /*获取返回状态码*/
  30. result=obj.getString("resultcode");
  31. /*如果状态码是200说明返回数据成功*/
  32. if(result!=null&&result.equals("200")){
  33. result=obj.getString("result");
  34. //此时result中数据有多个key,可以对其key进行遍历,得到对个属性
  35. obj=JSONObject.fromObject(result);
  36. //今日温度对应的key是today
  37. result=obj.getString("today");
  38. obj=JSONObject.fromObject(result);
  39. //今日温度对应当key是temperature
  40. result=obj.getString("temperature");
  41. return result;
  42. }
  43. }
  44. return result;
  45. }
  46. public static void main(String[] args) {
  47. System.out.println(GetTodayTemperatureByCity("苏州"));
  48. }
  49. }

Demo4:调用天气种类及表示列表接口示例

  1. package juheAPI;
  2. import net.sf.json.JSONArray;
  3. import net.sf.json.JSONObject;
  4. /**
  5. * 天气种类及标识列表接口调用JAVA示例
  6. * @author silk
  7. */
  8. public class GetWeatherSignAndTypeList {
  9. //接口地址,因为只需要传入一个固定的key为参数,所以设为常量
  10. private static final String URL= "http://v.juhe.cn/weather/uni?key=***a7558b2e0bedaa19673f74a6809ce";
  11. /**
  12. * 通过工具类获取数据
  13. * @return
  14. */
  15. public static String excute(){
  16. return PureNetUtil.get(URL);//调用工具类获取接口数据
  17. }
  18. /**
  19. * 利用遍历数组的方式获取
  20. * @param wid天气对应id
  21. * @return 天气名称
  22. */
  23. public static String getWeatherByWid(String wid) {
  24. String result=excute();//获取接口数据
  25. if(result!=null){
  26. JSONObject obj=JSONObject.fromObject(result);
  27. result=obj.getString("resultcode");
  28. /*获取返回状态码*/
  29. if(result!=null&&result.equals("200")){
  30. /*获取数组数据*/
  31. result=obj.getString("result");
  32. JSONArray arr=JSONArray.fromObject(result);
  33. for(Object o:arr){//遍历数组
  34. obj=JSONObject.fromObject(o.toString());
  35. //如果遍历到需要的数据后直接返回结果,根据key(wid)得到value判断是否等于传入参数
  36. if(obj.getString("wid").equals(wid)){
  37. result=obj.getString("weather");
  38. return result;
  39. }
  40. }
  41. }
  42. }
  43. return result;
  44. }
  45. public static void main(String[] args) {
  46. System.out.println(getWeatherByWid("10"));
  47. }
  48. }

step5:调用接口时候如果状态码不是200,仔细参考文档说明,也就是返回step3:看文档!

上一篇：微信小程序-基于高德地图API实现天气组件(动态效果)


下一篇：深入理解Java内存模型（三）——顺序一致性