myweather / forecast
Forecast.io API 的 PHP 封装。
Requires
- php: >=5.4.0
- guzzlehttp/guzzle: ~5.0
Requires (Dev)
- phpunit/phpunit: ~4.0
Suggests
- illuminate/support: Enables Laravel support (~5.0).
This package is not auto-updated.
Last update: 2024-09-28 17:12:32 UTC
README
MyWeather Forecast 由 Tyler Youschak 创建并维护。MyWeather Forecast 使用 Forecast.io 的天气 API,因此需要免费 API 密钥。我选择 Forecast.io 是因为它的 API 非常便宜,每天提供 1,000 次免费调用。如果您超过 1,000 次调用,则每次 10,000 次调用只需一分钱。
要求
在安装 Forecast 之前,您需要确保您的服务器已安装 cURL
!可能这项工作已经完成了!
安装
要获取 MyWeather Forecast 的最新版本,只需将以下行添加到您的 composer.json
文件的 require 块中
"myweather/forecast": "~1.0@dev"
然后,您需要运行 composer install
或 composer update
来下载它并更新自动加载器。
如果您使用 Laravel 5,则可以注册我们的服务提供者。打开 config/app.php
并将以下内容添加到 providers 数组中。
'MyWeather\ForecastServiceProvider'
使用方法
MyWeather Forecast 的使用非常简单。要开始使用,您必须首先 使用 我们的包。这将允许您开始使用我们的包,以下是一个示例:use MyWeather\ForecastClient;
好的!我们现在正在使用这个包,但我们将在哪里声明我们的 API 密钥(由 Forecast.io 提供)?让我们来看看
- 您可以使用以下代码使用它:
$client = ForecastClient($apiKey);
这将设置您的 API 密钥以供请求使用。 - 现在,您需要设置您要查找的位置的纬度(lat)和经度(lng)。最好使用 JavaScript 并询问用户是否可以使用他们的位置,或者您可以直接在地理定位查找中硬编码。下面是如何做到这一点:
$forecast = $client->get('lat','lng');
- 现在,让我们获取数据!既然您已经声明了 API 密钥和 lat & lng,您现在可以使用我们的
currently
、minutely
、hourly
和daily
选择器,它们将以数组的形式返回信息。
以下是一个所有这些功能的综合示例
use MyWeather\ForecastClient; $client = new ForecastClient($apiKey); $forecast = $client->get('lat','lng'); $currently = $forecast->currently();
贡献
您有没有想法添加新的数据选择器?或者您有没有让这个包变得更好的想法?请打开问题报告,我们将查看!