README

基于高德开放平台的 PHP 天气信息组件

安装

$ composer require memory/weather -vvv

配置

在使用本扩展之前，你需要去高德开放平台注册账号，然后创建应用，获取应用的 Api Key。

使用

use Memory\Weather\Weather;

$key = 'xxxxxxx';

$weather = new Weather($key);

获取实时天气

$response = $weather->getWeather('深圳');

示例：

{
    status: "1",
    count: "1",
    info: "OK",
    infocode: "10000",
    lives: [
        {
            province: "广东",
            city: "深圳市",
            adcode: "440300",
            weather: "小雨",
            temperature: "24",
            winddirection: "西南",
            windpower: "≤3",
            humidity: "92",
            reporttime: "2019-04-30 13:14:34"
        }
    ]
}

获取近期天气预报

$response = $weather->getWeather('深圳', 'all');

示例：

{
    status: "1",
    count: "1",
    info: "OK",
    infocode: "10000",
    forecasts: [
        {
            city: "深圳市",
            adcode: "440300",
            province: "广东",
            reporttime: "2019-04-30 13:14:34",
            casts: [
                {
                    date: "2019-04-30",
                    week: "2",
                    dayweather: "大雨-暴雨",
                    nightweather: "雷阵雨",
                    daytemp: "29",
                    nighttemp: "23",
                    daywind: "无风向",
                    nightwind: "无风向",
                    daypower: "≤3",
                    nightpower: "≤3"
                },
                {
                    date: "2019-05-01",
                    week: "3",
                    dayweather: "雷阵雨",
                    nightweather: "雷阵雨",
                    daytemp: "27",
                    nighttemp: "23",
                    daywind: "无风向",
                    nightwind: "无风向",
                    daypower: "≤3",
                    nightpower: "≤3"
                },
                {
                    date: "2019-05-02",
                    week: "4",
                    dayweather: "阵雨",
                    nightweather: "阵雨",
                    daytemp: "26",
                    nighttemp: "22",
                    daywind: "东",
                    nightwind: "东",
                    daypower: "4",
                    nightpower: "4"
                },
                {
                    date: "2019-05-03",
                    week: "5",
                    dayweather: "阵雨",
                    nightweather: "阵雨",
                    daytemp: "27",
                    nighttemp: "23",
                    daywind: "东",
                    nightwind: "东",
                    daypower: "4",
                    nightpower: "4"
                }
            ]
        }
    ]
}

获取 XML 格式返回值

第三个参数为返回值类型，可选 json 与 xml，默认 json：

$response = $weather->getWeather('深圳', 'all', 'xml');

示例：

<response>
    <status>1</status>
    <count>1</count>
    <info>OK</info>
    <infocode>10000</infocode>
    <lives type="list">
        <live>
            <province>广东</province>
            <city>深圳市</city>
            <adcode>440300</adcode>
            <weather>中雨</weather>
            <temperature>27</temperature>
            <winddirection>西南</winddirection>
            <windpower>5</windpower>
            <humidity>94</humidity>
            <reporttime>2018-08-21 16:00:00</reporttime>
        </live>
    </lives>
</response>

参数说明

array|string getWeather(string $city, string $type = 'base', string $format = 'json')

$city - 城市名，比如：“深圳”；

$type - 返回内容类型：base: 返回实况天气 / all:返回预报天气；

$format - 输出的数据格式，默认为 json 格式，当 output 设置为 “xml” 时，输出的为 XML 格式的数据。

在 Laravel 中使用

在 Laravel 中使用也是同样的安装方式，配置写在 config/services.php 中：

.
.
.
 'weather' => [
    'key' => env('WEATHER_API_KEY'),
],

然后在 .env 中配置 WEATHER_API_KEY ：

WEATHER_API_KEY=xxxxxxxxxxxxxxxxxxxxx

可以用两种方式来获取 Memory\Weather\Weather 实例：

方法参数注入

.
.
.
public function edit(Weather $weather) 
{
    $response = $weather->getWeather('深圳');
}
.
.
.

服务名访问

.
.
.
public function edit() 
{
    $response = app('weather')->getWeather('深圳');
}
.
.
.

参考

高德开放平台天气接口

License

MIT

memory / weather

Maintainers

Details