全国天气预报数据API调用PHP示例

本代码示例是基于PHP的聚合数据全国天气预报API服务请求的代码样例，使用前你需要： 
①：通过https://www.juhe.cn/docs/api/id/39 申请一个天气预报API的appkey

样例代码包含了获取支持城市列表、根据城市获取天气预报、根据IP地址请求天气预报、根据GPS坐标请求天气、城市3小时天气预报的实现。示例代码主要是解析一些常用字段，如需要完整或其他未包含的字段，可以自行参考官方的接口，进行修改。

首先：引入封装好的天气调用类

header('Content-type:text/html;charset=utf-8');
include 'class.juhe.weather.php'; //引入天气请求类  

//接口基本信息配置
$appkey = '**********'; //您申请的天气查询appkey
$weather = new weather($appkey);

一、获取支持的城市列表 
由于支持的城市列表基本不会这么变化，大家可以获取到列表后内置到自己的应用中，就不用每次都去请求API。

$citysResult = $weather->getCitys();
if($citysResult['error_code'] == 0){    //以下可根据实际业务需求，自行改写
    //////////////////////////////////////////////////////////////////////
    $citys = $citysResult['result'];
    foreach($citys as $ckey =>$c){
        echo "ID：".$c['id'].",省份：".$c['province'].",城市：".$c['city'].",区域：".$c['district']."<br>";
    }
}else{    //以下可根据实际业务需求，自行改写
    //////////////////////////////////////////////////////////////////////
    echo $citysResult['error_code'].":".$citysResult['reason'];
}

二、根据城市/ID获取天气预报 
通过城市的名称或城市的ID来获取天气预报，城市id就是获取城市支持列表中返回的字段ID

$cityWeatherResult = $weather->getWeather('苏州');
if($cityWeatherResult['error_code'] == 0){    //以下可根据实际业务需求，自行改写
    //////////////////////////////////////////////////////////////////////
    $data = $cityWeatherResult['result'];
    echo "=======当前天气实况=======<br>";
    echo "温度：".$data['sk']['temp']."    ";
    echo "风向：".$data['sk']['wind_direction']."    （".$data['sk']['wind_strength']."）";
    echo "湿度：".$data['sk']['humidity']."    ";
    echo "<br><br>";  

    echo "=======未来几天天气预报=======<br>";
    foreach($data['future'] as $wkey =>$f){
        echo "日期:".$f['date']." ".$f['week']." ".$f['weather']." ".$f['temperature']."<br>";
    }
    echo "<br><br>";  

    echo "=======相关天气指数=======<br>";
    echo "穿衣指数：".$data['today']['dressing_index']." , ".$data['today']['dressing_advice']."<br>";
    echo "紫外线强度：".$data['today']['uv_index'."<br>";
    echo "舒适指数：".$data['today']['comfort_index']."<br>";
    echo "洗车指数：".$data['today']['wash_index'];
    echo "<br><br>";  

}else{
    echo $cityWeatherResult['error_code'].":".$cityWeatherResult['reason'];
}

三、根据用户的IP地址请求对应的天气预报 
通过用户的IP地址获取用户所在地的天气预报，由于IP地址解析可能会有误差，所以有时定位到的城市不一定是用户实际的所在地。

$ipWeatherResult = $weather->getWeatherByIP('58.215.154.128');
if($ipWeatherResult['error_code'] == 0){    //以下可根据实际业务需求，自行改写
    //////////////////////////////////////////////////////////////////////
    $data = $ipWeatherResult['result'];
    echo "=======当前城市=======<br>";
    echo $data['today']['city'];
    echo "<br><br>";
    echo "=======当前天气实况=======<br>";
    echo "温度：".$data['sk']['temp']."    ";
    echo "风向：".$data['sk']['wind_direction']."    （".$data['sk']['wind_strength']."）";
    echo "湿度：".$data['sk']['humidity']."    ";
    echo "<br><br>";  

    echo "=======未来几天天气预报=======<br>";
    foreach($data['future'] as $wkey =>$f){
        echo "日期:".$f['date']." ".$f['week']." ".$f['weather']." ".$f['temperature']."<br>";
    }
    echo "<br><br>";  

    echo "=======相关天气指数=======<br>";
    echo "穿衣指数：".$data['today']['dressing_index']." , ".$data['today']['dressing_advice']."<br>";
    echo "紫外线强度：".$data['today']['uv_index']."<br>";
    echo "舒适指数：".$data['today']['comfort_index']."<br>";
    echo "洗车指数：".$data['today']['wash_index'];
    echo "<br><br>";  

}else{
    echo $ipWeatherResult['error_code'].":".$ipWeatherResult['reason'];
}

四、根据GPS坐标来获取对应地区的天气 
无论通过二、三、四获取的天气预报，因为聚合格式都是统一的，所以解析的流程是一致的，所以没有额外的操作，只是传参上有点的差异。

$geoWeatherResult = $weather->getWeatherByGeo(116.401394,39.916042);
if($geoWeatherResult['error_code'] == 0){    //以下可根据实际业务需求，自行改写
    //////////////////////////////////////////////////////////////////////
    $data = $geoWeatherResult['result'];
    echo "=======当前城市=======<br>";
    echo $data['today']['city'];
    echo "<br><br>";
    echo "=======当前天气实况=======<br>";
    echo "温度：".$data['sk']['temp']."    ";
    echo "风向：".$data['sk']['wind_direction']."    （".$data['sk']['wind_strength']."）";
    echo "湿度：".$data['sk']['humidity']."    ";
    echo "<br><br>";  

    echo "=======未来几天天气预报=======<br>";
    foreach($data['future'] as $wkey =>$f){
        echo "日期:".$f['date']." ".$f['week']." ".$f['weather']." ".$f['temperature']."<br>";
    }
    echo "<br><br>";  

    echo "=======相关天气指数=======<br>";
    echo "穿衣指数：".$data['today']['dressing_index']." , ".$data['today']['dressing_advice']."<br>";
    echo "紫外线强度：".$data['today']['uv_index']."<br>";
    echo "舒适指数：".$data['today']['comfort_index']."<br>";
    echo "洗车指数：".$data['today']['wash_index'];
    echo "<br><br>";  

}else{
    echo $geoWeatherResult['error_code'].":".$geoWeatherResult['reason'];
}

五、获取城市三小时预报 
就是城市每3小时的天气情况

$forecastResult = $weather->getForecast("苏州");
if($forecastResult['error_code'] == 0){    //以下可根据实际业务需求，自行改写
    //////////////////////////////////////////////////////////////////////
    $data = $forecastResult['result'];
    foreach($data as $key => $d){
        echo "日期：".$d['date']." (".$d['sh']."点-".$d['eh']."点)  ".$d['weather']." ".$d['temp1']."~".$d["temp2"]."<br>";
    }
}else{    //以下可根据实际业务需求，自行改写
    //////////////////////////////////////////////////////////////////////
    echo $forecastResult['error_code'].":".$forecastResult['reason'];
}

通过上面的示例代码，大家应该对如果调用聚合数据天气预报API有了一个大体的了解。 
最后放上class.juhe.weather.php完整代码：

<!--?php
// +----------------------------------------------------------------------
// | JuhePHP [ NO ZUO NO DIE ]
// +----------------------------------------------------------------------
// | Copyright (c) 2010-2015 http://juhe.cn All rights reserved.
// +----------------------------------------------------------------------
// | Author: Juhedata <info@juhe.cn-->
// +----------------------------------------------------------------------  

//----------------------------------
// 聚合数据天气预报接口请求类
//----------------------------------
class weather{
    private $appkey = false; //申请的聚合天气预报APPKEY  

    private $cityUrl = 'http://v.juhe.cn/weather/citys'; //城市列表API URL  

    private $weatherUrl = 'http://v.juhe.cn/weather/index'; //根据城市请求天气API URL  

    private $weatherIPUrl = 'http://v.juhe.cn/weather/ip'; //根据IP地址请求天气API URL  

    private $weatherGeoUrl = 'http://v.juhe.cn/weather/geo'; //根据GPS坐标获取天气API URL  

    private $forecast3hUrl = 'http://v.juhe.cn/weather/forecast3h'; //获取城市天气3小时预报API URL  

    public function __construct($appkey){
        $this->appkey = $appkey;
    }  

    /**
     * 获取天气预报支持城市列表
     * @return array
     */
    public function getCitys(){
        $params = 'key='.$this->appkey;
        $content = $this->juhecurl($this->cityUrl,$params);
        return $this->_returnArray($content);
    }  

    /**
     * 根据城市名称/ID获取详细天气预报
     * @param string $city [城市名称/ID]
     * @return array
     */
    public function getWeather($city){
        $paramsArray = array(
            'key'   => $this->appkey,
            'cityname'  => $city,
            'format'    => 2
        );
        $params = http_build_query($paramsArray);
        $content = $this->juhecurl($this->weatherUrl,$params);
        return $this->_returnArray($content);
    }  

    /**
     * 根据IP地址获取当地天气预报
     * @param string $ip [IP地址]
     * @return array
     */
    public function getWeatherByIP($ip){
         $paramsArray = array(
            'key'   => $this->appkey,
            'ip'  => $ip,
            'format'    => 2
        );
        $params = http_build_query($paramsArray);
        $content = $this->juhecurl($this->weatherIPUrl,$params);
        return $this->_returnArray($content);
    }  

    /**
     * 根据GPS坐标获取当地的天气预报
     * @param  string $lon [经度]
     * @param  string $lat [纬度]
     * @return array
     */
    public function getWeatherByGeo($lon,$lat){
        $paramsArray = array(
            'key'   => $this->appkey,
            'lon'  => $lon,
            'lat'   => $lat,
            'format'    => 2
        );
        $params = http_build_query($paramsArray);
        $content = $this->juhecurl($this->weatherGeoUrl,$params);
        return $this->_returnArray($content);
    }  

    /**
     * 获取城市三小时预报
     * @param  string $city [城市名称]
     * @return array
     */
    public function getForecast($city){
        $paramsArray = array(
            'key'   => $this->appkey,
            'cityname'  => $city,
            'format'    => 2
        );
        $params = http_build_query($paramsArray);
        $content = $this->juhecurl($this->forecast3hUrl,$params);
        return $this->_returnArray($content);
    }  

    /**
     * 将JSON内容转为数据，并返回
     * @param string $content [内容]
     * @return array
     */
    public function _returnArray($content){
        return json_decode($content,true);
    }  

    /**
     * 请求接口返回内容
     * @param  string $url [请求的URL地址]
     * @param  string $params [请求的参数]
     * @param  int $ipost [是否采用POST形式]
     * @return  string
     */
    public function juhecurl($url,$params=false,$ispost=0){
        $httpInfo = array();
        $ch = curl_init();  

        curl_setopt( $ch, CURLOPT_HTTP_VERSION , CURL_HTTP_VERSION_1_1 );
        curl_setopt( $ch, CURLOPT_USERAGENT , 'Mozilla/5.0 (Windows NT 10.0; WOW64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/41.0.2272.118 Safari/537.36' );
        curl_setopt( $ch, CURLOPT_CONNECTTIMEOUT , 30 );
        curl_setopt( $ch, CURLOPT_TIMEOUT , 30);
        curl_setopt( $ch, CURLOPT_RETURNTRANSFER , true );
        if( $ispost )
        {
            curl_setopt( $ch , CURLOPT_POST , true );
            curl_setopt( $ch , CURLOPT_POSTFIELDS , $params );
            curl_setopt( $ch , CURLOPT_URL , $url );
        }
        else
        {
            if($params){
                curl_setopt( $ch , CURLOPT_URL , $url.'?'.$params );
            }else{
                curl_setopt( $ch , CURLOPT_URL , $url);
            }
        }
        $response = curl_exec( $ch );
        if ($response === FALSE) {
            //echo "cURL Error: " . curl_error($ch);
            return false;
        }
        $httpCode = curl_getinfo( $ch , CURLINFO_HTTP_CODE );
        $httpInfo = array_merge( $httpInfo , curl_getinfo( $ch ) );
        curl_close( $ch );
        return $response;
    }  

}