Skip to content

🌈 基于高德地图接口的 PHP 天气信息组件包 🌈

Notifications You must be signed in to change notification settings

yulinzhihou/weather

Repository files navigation

weather

🌈 基于高德地图接口的 PHP 天气信息组件包 🌈

Tests StyleCI build status

安装

$ composer require beans/weather -vvv

配置

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

使用

use Beans\Weather\Weather;

$key = "XXXXXXXXXXXXX";

$weather = new Weather($key);

$weather->getWeather('长沙');

获取实时天气

$weather->getWeather('长沙');

示例

{
    "status": "1",
    "count": "2",
    "info": "OK",
    "infocode": "10000",
    "lives": [
        {
            "province": "湖南",
            "city": "长沙市",
            "adcode": "430100",
            "weather": "",
            "temperature": "18",
            "winddirection": "",
            "windpower": "≤3",
            "humidity": "41",
            "reporttime": "2023-03-06 10:01:29",
            "temperature_float": "18.0",
            "humidity_float": "41.0"
        },
        {
            "province": "湖南",
            "city": "长沙县",
            "adcode": "430121",
            "weather": "",
            "temperature": "18",
            "winddirection": "",
            "windpower": "≤3",
            "humidity": "41",
            "reporttime": "2023-03-06 10:01:29",
            "temperature_float": "18.0",
            "humidity_float": "41.0"
        }
    ]
}

获取近期天气预报

$weather->getWeather('长沙','all');

示例

{
    "status": "1",
    "count": "2",
    "info": "OK",
    "infocode": "10000",
    "forecasts": [
        {
            "city": "长沙市",
            "adcode": "430100",
            "province": "湖南",
            "reporttime": "2023-03-06 11:31:28",
            "casts": [
                {
                    "date": "2023-03-06",
                    "week": "1",
                    "dayweather": "",
                    "nightweather": "",
                    "daytemp": "26",
                    "nighttemp": "10",
                    "daywind": "东南",
                    "nightwind": "东南",
                    "daypower": "≤3",
                    "nightpower": "≤3",
                    "daytemp_float": "26.0",
                    "nighttemp_float": "10.0"
                },
                {
                    "date": "2023-03-07",
                    "week": "2",
                    "dayweather": "小雨",
                    "nightweather": "小雨",
                    "daytemp": "20",
                    "nighttemp": "15",
                    "daywind": "",
                    "nightwind": "",
                    "daypower": "≤3",
                    "nightpower": "≤3",
                    "daytemp_float": "20.0",
                    "nighttemp_float": "15.0"
                },
                {
                    "date": "2023-03-08",
                    "week": "3",
                    "dayweather": "小雨",
                    "nightweather": "多云",
                    "daytemp": "22",
                    "nighttemp": "13",
                    "daywind": "东南",
                    "nightwind": "东南",
                    "daypower": "≤3",
                    "nightpower": "≤3",
                    "daytemp_float": "22.0",
                    "nighttemp_float": "13.0"
                },
                {
                    "date": "2023-03-09",
                    "week": "4",
                    "dayweather": "",
                    "nightweather": "",
                    "daytemp": "24",
                    "nighttemp": "15",
                    "daywind": "",
                    "nightwind": "",
                    "daypower": "≤3",
                    "nightpower": "≤3",
                    "daytemp_float": "24.0",
                    "nighttemp_float": "15.0"
                }
            ]
        },
        {
            "city": "长沙县",
            "adcode": "430121",
            "province": "湖南",
            "reporttime": "2023-03-06 11:31:28",
            "casts": [
                {
                    "date": "2023-03-06",
                    "week": "1",
                    "dayweather": "",
                    "nightweather": "",
                    "daytemp": "26",
                    "nighttemp": "10",
                    "daywind": "东南",
                    "nightwind": "东南",
                    "daypower": "≤3",
                    "nightpower": "≤3",
                    "daytemp_float": "26.0",
                    "nighttemp_float": "10.0"
                },
                {
                    "date": "2023-03-07",
                    "week": "2",
                    "dayweather": "小雨",
                    "nightweather": "小雨",
                    "daytemp": "20",
                    "nighttemp": "15",
                    "daywind": "",
                    "nightwind": "",
                    "daypower": "≤3",
                    "nightpower": "≤3",
                    "daytemp_float": "20.0",
                    "nighttemp_float": "15.0"
                },
                {
                    "date": "2023-03-08",
                    "week": "3",
                    "dayweather": "小雨",
                    "nightweather": "多云",
                    "daytemp": "22",
                    "nighttemp": "13",
                    "daywind": "东南",
                    "nightwind": "东南",
                    "daypower": "≤3",
                    "nightpower": "≤3",
                    "daytemp_float": "22.0",
                    "nighttemp_float": "13.0"
                },
                {
                    "date": "2023-03-09",
                    "week": "4",
                    "dayweather": "",
                    "nightweather": "",
                    "daytemp": "24",
                    "nighttemp": "15",
                    "daywind": "",
                    "nightwind": "",
                    "daypower": "≤3",
                    "nightpower": "≤3",
                    "daytemp_float": "24.0",
                    "nighttemp_float": "15.0"
                }
            ]
        }
    ]
}

获取 XML 格式返回值

第三个参数为返回值类型,可选 jsonxml ,默认 json

$response = $weather->getWeather('长沙','all','xml');

示例

<?xml version="1.0" encoding="UTF-8"?>\n
<response>
	<status>1</status>
	<count>2</count>
	<info>OK</info>
	<infocode>10000</infocode>
	<lives type="list">
		<live>
			<province>\u6e56\u5357</province>
			<city>\u957f\u6c99\u5e02</city>
			<adcode>430100</adcode>
			<weather>\u6674</weather>
			<temperature>20</temperature>
			<winddirection>\u897f\u5357</winddirection>
			<windpower>\u22643</windpower>
			<humidity>36</humidity>
			<reporttime>2023-03-06 11:31:28</reporttime>
			<temperature_float>20.0</temperature_float>
			<humidity_float>36.0</humidity_float>
		</live>
		<live>
			<province>\u6e56\u5357</province>
			<city>\u957f\u6c99\u53bf</city>
			<adcode>430121</adcode>
			<weather>\u6674</weather>
			<temperature>20</temperature>
			<winddirection>\u5357</winddirection>
			<windpower>4</windpower>
			<humidity>36</humidity>
			<reporttime>2023-03-06 11:31:28</reporttime>
			<temperature_float>20.0</temperature_float>
			<humidity_float>36.0</humidity_float>
		</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=XXXXXXXXXX

可以用两种方式来获取 Beans\Weather\Weather 实例:

方法注入

.
.
.

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

服务名访问

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

参考

贡献

您可以通过以下三种方式之一做出贡献:

  1. File bug reports using the issue tracker.
  2. Answer questions or fix bugs on the issue tracker.
  3. Contribute new features or update the wiki.

_The code contribution process is not very formal. You just need to make sure that you follow the PSR-0, PSR-1, and PSR-2 coding guidelines. Any new code contributions must be accompanied by unit tests where applicable.

License

MIT

About

🌈 基于高德地图接口的 PHP 天气信息组件包 🌈

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages