README

一个天气 SDK。

安装

$ composer require linsunnyday/weather -vvv

配置前

在使用此扩展之前，您需要前往金色开放平台注册您的账户，然后创建一个应用程序并获取该应用程序的 API 密钥。

用法

use Overtrue\Weather\Weather;

$key = 'xxxxxxxxxxxxxxxxxxxxxxxxxxx';

$weather = new Weather($key);

获取实时天气

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

示例：

{ "status": "1", "count": "1", "info": "OK", "infocode": "10000", "lives": [ { "province": "广东", "city": "深圳市", "adcode": "440300", "weather": "中雨", "temperature": "27", "winddirection": "西南", "windpower": "5", "humidity": "94", "reporttime": "2018-08-21 16:00:00" } ] }

获取最近天气预报

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

示例：

{ "status": "1", "count": "1", "info": "OK", "infocode": "10000", "forecasts": [ { "city": "深圳市", "adcode": "440300", "province": "广东", "reporttime": "2018-08-21 11:00:00", "casts": [ { "date": "2018-08-21", "week": "2", "dayweather": "雷阵雨", "nightweather": "雷阵雨", "daytemp": "31", "nighttemp": "26", "daywind": "无风向", "nightwind": "无风向", "daypower": "≤3", "nightpower": "≤3" }, { "date": "2018-08-22", "week": "3", "dayweather": "雷阵雨", "nightweather": "雷阵雨", "daytemp": "32", "nighttemp": "27", "daywind": "无风向", "nightwind": "无风向", "daypower": "≤3", "nightpower": "≤3" }, { "date": "2018-08-23", "week": "4", "dayweather": "雷阵雨", "nightweather": "雷阵雨", "daytemp": "32", "nighttemp": "26", "daywind": "无风向", "nightwind": "无风向", "daypower": "≤3", "nightpower": "≤3" }, { "date": "2018-08-24", "week": "5", "dayweather": "雷阵雨", "nightweather": "雷阵雨", "daytemp": "31", "nighttemp": "26", "daywind": "无风向", "nightwind": "无风向", "daypower": "≤3", "nightpower": "≤3" } ] } ] }

获取 XML 格式的返回值

第三个参数是返回值类型，JSON 和 XML 可选，默认 json

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

示例：

参数说明

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

城市 - 城市名称，例如 "深圳";

$type - 返回内容类型：base：返回实时天气 / all：返回预报天气;

$format - 输出数据格式，默认为 JSON 格式，输出设置为 "xml" 时，输出数据以 XML 格式。

在 Laravel 中使用

在 Laravel 中使用相同的安装，配置写在 config/services.php 中

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

然后在 .env 中配置 WEATHER_API_KEY

WEATHER_API_KEY=xxxxxxxxxxxxxxxxxxxxx

获取 Linsunnyday\Weather\Weather 实例有两种方式

方法参数注入

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

服务名称访问

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

参考资源

金色开放平台天气接口

贡献

您可以通过以下三种方式之一进行贡献

1. 使用 问题跟踪器 提交错误报告。
2. 在 问题跟踪器 上回答问题或修复错误。
3. 贡献新功能或更新 wiki。

代码贡献过程并不非常正式。您只需确保遵循 PSR-0、PSR-1 和 PSR-2 编码指南。任何新的代码贡献都必须附有适用时的单元测试。

许可证

MIT