基于PHP全国天气预报API调用示例
本代码示例是基于PHP的聚合数据全国天气预报API服务请求的代码样例，使用前你需要：
①：通过http://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']."
";
}
}else{ //以下可根据实际业务需求，自行改写
//////////////////////////////////////////////////////////////////////
echo $citysResult['error_code'].":".$citysResult['reason'];
}二、根据城市/ID获取天气预报
通过城市的名称或城市的ID来获取天气预报，城市id就是获取城市支持列表中返回的字段ID
$cityWeatherResult = $weather->getWeather('苏州');
if($cityWeatherResult['error_code'] == 0){ //以下可根据实际业务需求，自行改写
//
$data = $cityWeatherResult['result'];
echo "=======当前天气实况=======
";
echo "温度：".$data['sk']['temp']." ";
echo "风向：".$data['sk']['wind_direction']." （".$data['sk']['wind_strength']."）";
echo "湿度：".$data['sk']['humidity']." ";
echo "
";
echo "=======未来几天天气预报=======
";
foreach($data['future'] as $wkey =>$f){
echo "日期:".$f['date']." ".$f['week']." ".$f['weather']." ".$f['temperature']."
";
}
echo "
";
echo "=======相关天气指数=======
";
echo "穿衣指数：".$data['today']['dressing_index']." , ".$data['today']['dressing_advice']."
";
echo "紫外线强度：".$data['today']['uv_index']."
";
echo "舒适指数：".$data['today']['comfort_index']."
";
echo "洗车指数：".$data['today']['wash_index'];
echo "
";
}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 "=======当前城市=======
";
echo $data['today']['city'];
echo "
";
echo "=======当前天气实况=======
";
echo "温度：".$data['sk']['temp']." ";
echo "风向：".$data['sk']['wind_direction']." （".$data['sk']['wind_strength']."）";
echo "湿度：".$data['sk']['humidity']." ";
echo "
";
echo "=======未来几天天气预报=======
";
foreach($data['future'] as $wkey =>$f){
echo "日期:".$f['date']." ".$f['week']." ".$f['weather']." ".$f['temperature']."
";
}
echo "
";
echo "=======相关天气指数=======
";
echo "穿衣指数：".$data['today']['dressing_index']." , ".$data['today']['dressing_advice']."
";
echo "紫外线强度：".$data['today']['uv_index']."
";
echo "舒适指数：".$data['today']['comfort_index']."
";
echo "洗车指数：".$data['today']['wash_index'];
echo "
";
}else{
echo $ipWeatherResult['error_code'].":".$ipWeatherResult['reason'];
}四、根据GPS坐标来获取对应地区的天气
无论通过二、三、四获取的天气预报，因为聚合格式都是统一的，所以解析的流程是一致的，所以没有额外的操作，只是传参上有点的差异。
$geoWeatherResult = $weather->getWeatherByGeo(116.401394,39.916042);
if($geoWeatherResult['error_code'] == 0){ //以下可根据实际业务需求，自行改写
//
$data = $geoWeatherResult['result'];
echo "=======当前城市=======
";
echo $data['today']['city'];
echo "
";
echo "=======当前天气实况=======
";
echo "温度：".$data['sk']['temp']." ";
echo "风向：".$data['sk']['wind_direction']." （".$data['sk']['wind_strength']."）";
echo "湿度：".$data['sk']['humidity']." ";
echo "
";
echo "=======未来几天天气预报=======
";
foreach($data['future'] as $wkey =>$f){
echo "日期:".$f['date']." ".$f['week']." ".$f['weather']." ".$f['temperature']."
";
}
echo "
";
echo "=======相关天气指数=======
";
echo "穿衣指数：".$data['today']['dressing_index']." , ".$data['today']['dressing_advice']."
";
echo "紫外线强度：".$data['today']['uv_index']."
";
echo "舒适指数：".$data['today']['comfort_index']."
";
echo "洗车指数：".$data['today']['wash_index'];
echo "
";
}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"]."
";
}
}else{ //以下可根据实际业务需求，自行改写
//////////////////////////////////////////////////////////////////////
echo $forecastResult['error_code'].":".$forecastResult['reason'];
}通过上面的示例代码，大家应该对如果调用聚合数据天气预报API有了一个大体的了解。
最后放上class.juhe.weather.php完整代码：
// +----------------------------------------------------------------------
//----------------------------------
// 聚合数据天气预报接口请求类
//----------------------------------
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;
}
}