介绍一个比较有实用的天气接口。地址 ：https://www.apixu.com/

先说明一下他的一些优势：

0.免费，但有次数限制（5000次/月）；
1.可查询多个国家城市的天气情况；
2.可查询多达 30 天的历史天气；
3.可查询 10 天内的天气预报，并包括每小时的天气情况。
4.当然也可以查询当天实现天气情况。
5.有比较全的数据字段，并且可自选是否返回。

当然有也一些不方便的地方。这个接口是国外的，请求接口所花时间较长。有时他们接口也会自行维护，但没有发送邮箱。次数限制 5000 次/月。不过总的来说，做开源项目，或者个人项目是不错的。但不建议商用。说到这，安利一个用 Apixu 接口做的天气应用 SimpleWeather。

简单使用

首先简单登录注册后，打开个人主页得到 Api Key, 之后就可以 happy 的使用了。

login

my

个人体验接口：
实时天气：http://api.apixu.com/v1/current.json?key=bd6cf545b42d43cb96184023172905&lang=zh&q=beijing
7天内的天气预报：https://api.apixu.com/v1/forecast.json?key=bd6cf545b42d43cb96184023172905&lang=zh&q=beijing&days=7

相关接口说明

0.请求说明

0.1 请求 URL

请求 Apixu API 由基础 URL 和 API 方法组成。 您可以向 API 发出 HTTP 或 HTTPS 请求。
基础 URL ： http://api.apixu.com/v1

0.2 请求参数

<table>
<tr>
<th>Parameter</th>
<th> </th>
<th>Description</th>
</tr>
<tr>
<td>key</td>
<td>Required</td>
<td>API Key</td>
</tr>
<tr>
<td> q </td>
<td>Required</td>
<td>
查询城市对应的参数。

1.经纬度 e.g: q=48.8567,2.3508

2.城市名称 e.g.: q=Paris

3.美国邮编 e.g.: q=10001

4.英国邮编 e.g: q=SW1

5.加拿大邮政编码 e.g: q=G2J

6.metar:metar code e.g: q=metar:EGLL

7.iata:3 digit airport code e.g: q=iata:DXB

8.auto:ip IP lookup e.g: q=auto:ip

9.IP address (IPv4 and IPv6 supported) e.g: q=100.0.0.1

</td>
<tr>
<td>days</td>
<td>仅用于预测 API 请求</td>
<td>
需要预测的天数。


天参数值范围介于1到10。 e.g：days= 5


如果没有提供天数参数，那么仅返回今天的天气。</td>
</tr>
<tr>
<td>dt (历史 API 必要参数)</td>
<td>用于限制 history and forecast API 天气日期输出（格式为 yyyy-MM-dd）</td>
<td>
1. history API 用于检当天历史天气

2. forecast API 用于限制查询，今天到输入的日期之间。
</td>
</tr>
<tr>
<td>unixdt(可选项)</td>
<td>用于限制 history and forecast API 的 Unix 时间戳。</td>
<td>
unixdt 与 dt 参数具有相同的限制。 请通过'dt'或'unixdt'，而不是在同一请求中。e.g：unixdt = 1490227200。
</td>
</tr>

<tr>
    <td> end_dt (可选项，可用于 history API)</td>
    <td>限制 forecast API 的日期输出（格式为 yyyy-MM-dd）</td>
    <td>
 对于 history API（dt = 2015-01-01）在 2015 年 1 月 1 日或之后。<br/>

'end_dt'应该大于'dt'参数，两个日期之间不应超过30天。
</td>
</tr>

<tr>
    <td> unixend_dt (可选项)</td>
    <td>用于 forecast API </td>
    <td>
unixend_dt 与 end_dt 参数具有相同的限制。<br/> 请通过 end_dt 或 unixend_dt ，而不是两者都在相同的请求中。 例如：unixend_dt = 1490227200
    </td>
</tr>

<tr>
    <td> hour (可选项)</td>
    <td> 将 history or forecast 输出限制在指定日期的特定时间。

</td>
<td>
hour 取值必须在 24 小时内。 例如:下午 5 点应该是 hour = 17，早上 6 点，hour = 6
</td>
</tr>

<tr>
    <td> lang (可选项)</td>
    <td> "condition:text" 的返回参数中的语言

</td>
<td>
从下表（0.3）中选择 "lang code" e.g.: lang=zh
</td>
</tr>

</tr>

</table>

0.3 可选国家对应 lang code

1. 当前最新天气情况

1.0 返回总览

1.1 current Element（当前天气）

1.2 location Element（位置信息）

2.Forecast and History 天气预报与历史天气

因为请求返回的参数格式是一致的。所以到这个放在一起了

2.0 返回总览

2.1 forecastday element (天气预报)

2.2 day Element 类型数据

2.3 astro Element 天文元素详细

2.4 hour Element 每小时天气详情

ERRORS 错误码

如果有错误，API 响应包含错误消息，包括以下 4xx HTTP 状态代码的错误代码。

返回错误信息

{"error":{"code":1005,"message":"API URL is invalid."}}