ship-expert/app/data/controller/api/Weather.php

<?php

namespace app\data\controller\api;

use app\data\model\BasePostageRegion;
use app\data\service\WeatherSvc;
use hg\apidoc\annotation\Param;
use hg\apidoc\annotation\Returned;
use hg\apidoc\annotation\Title;
use think\admin\Controller;

/**
 * @Title("天气预报")
 */
class Weather extends Controller
{
    /**
     * @Title("天气预报")
     * @Param("name",desc="地区名称")
     * @Returned("index.date",desc="预报日期")
     * @Returned("index.name",desc="生活指数类型的名称")
     * @Returned("index.category",desc="生活指数预报级别名称")
     * @Returned("daily.fxDate",desc="预报日期")
     * @Returned("daily.fxWeek",desc="预报周")
     * @Returned("daily.textDay",desc="天气状况")
     * @Returned("daily.tempMax",desc="最高温度")
     * @Returned("daily.tempMin",desc="最低温度")
     * @Returned("daily.windDirDay",desc="预报白天风向")
     * @Returned("daily.windDirDay",desc="预报白天风向")
     * @Returned("daily.windScaleNight",desc="预报夜间风力等级")
     * @Returned("hourly.fxTime",desc="预报时间")
     * @Returned("hourly.temp",desc="温度，默认单位：摄氏度")
     * @Returned("hourly.windDir",desc="风向")
     * @Returned("hourly.windScale",desc="风力等级")
     * @Returned("hourly.category",desc="空气质量等级")
     * @Returned("now.humidity",desc="相对湿度，百分比数值")
     * @Returned("now.text",desc="天气状况的文字描述")
     * @Returned("now.temp",desc="温度")
     * @Returned("now.windDir",desc="风向")
     * @Returned("now.category",desc="空气质量等级")
     * @Returned("now.aqi",desc="空气质量指数")
     * @Returned("now.obsTime",desc="更新时间")
     * @Returned("now.tempMax",desc="最高温度")
     * @Returned("now.tempMin",desc="最低温度")
     * @Returned("now.tomorrow",desc="参考daily")
     */
    public function area(WeatherSvc $svc){
        $data=$this->_vali([
            'name.require'=>'地区名称必须',
        ]);
        $area=BasePostageRegion::level(2)->where('name|short',$data['name'])->find();
        if(!$area){
            $this->error('地区不存在');
        }
        $svc->setArea($area);
        $this->success('',$svc->getWeather());
    }
}