从Visual Crossing获取天气数据
项目描述
Visual Crossing天气API的Python包装器
此Python包装器从Visual Crossing API检索数据。Visual Crossing提供广泛的天气API，包括历史和预报天气数据，并且他们有一个免费层API密钥，每天最多可调用1000次。
要开始使用，您必须在Visual Crossing创建一个账户，然后创建一个API密钥。您可以通过访问此网站并点击免费计划来完成此操作。然后按照说明创建账户并将您的密钥保存在安全的地方。
用法
在终端中使用此命令安装模块： pip install pyVisualCrossing
然后查看test_module.py和async_test_module.py以获取用法示例，包括标准和异步用法。（异步示例尚未创建）
参数
# Initialise the module
vcapi = VisualCrossing(
api_key,
latitude,
longitude,
days=7,
language="da"
)
| 参数 | 必需 | 默认值 | 描述 |
|---|---|---|---|
api_key |
是 | None |
这是您从Visual Crossing注册的API密钥。请参阅上面的说明 |
latitude |
是 | None |
位置位置的纬度 |
longitude |
是 | None |
位置位置的经度 |
days |
否 | 14 |
要检索预报的天数。14天意味着今天加上接下来的14天。在免费计划中，这是最大天数 |
language |
否 | en |
返回文本字符串的语言。请参阅下面对有效语言的列表。 |
session |
否 | None |
会话变量。仅在异步函数中使用。 |
关于Visual Crossing API的详细介绍，请访问此处
语言
支持的语言包括：ar（阿拉伯语）、bg（保加利亚语）、cs（捷克语）、da（丹麦语）、de（德语）、el（现代希腊语）、en（英语）、es（西班牙语）、fa（波斯语）、fi（芬兰语）、fr（法语）、he（希伯来语）、hu（匈牙利语）、it（意大利语）、ja（日语）、ko（韩语）、nl（荷兰语）、pl（波兰语）、pt（葡萄牙语）、sr（塞尔维亚语）、sv（瑞典语）、tr（土耳其语）、uk（乌克兰语）、vi（越南语）和zh（中文）。
度量单位
所有记录均使用度量单位系统返回。目前无法进行转换。
| 天气变量 | 测量单位 |
|---|---|
| 日期时间 | UTC日期时间 |
| 温度、体感温度和风寒 | 摄氏度 |
| 降水量 | 毫米 |
| 雪 | 厘米 |
| 风速和阵风 | 每小时千米 |
| 能见度 | 千米 |
| 气压 | 百帕（百帕斯卡） |
| 太阳辐射 | 瓦/平方米 |
| 太阳能量 | 兆焦耳/平方米 |
图标
我们使用Iconset icons2，它提供了更详细的天气状况描述。
| 图标ID | 天气状况 |
|---|---|
| 雪 | 雪量大于零 |
| snow-showers-day | 白天有雪 |
| snow-showers-night | 夜间有雪 |
| thunder-rain | 白天或夜间有雷雨 |
| thunder-showers-day | 白天可能有雷雨 |
| thunder-showers-night | 夜间可能有雷雨 |
| rain | 降水量大于零 |
| showers-day | 白天有阵雨 |
| showers-night | 夜间有阵雨 |
| fog | 能见度低（低于一千米或一英里） |
| wind | 风速高（大于30千米/小时或英里/小时） |
| cloudy | 云层覆盖率大于90%覆盖 |
| partly-cloudy-day | 白天云层覆盖率大于20%覆盖 |
| partly-cloudy-night | 夜间云层覆盖率大于20%覆盖 |
| clear-day | 白天云层覆盖率小于20%覆盖 |
| clear-night | 夜间云层覆盖率小于20%覆盖 |
TODO
- 将所有可用项添加到数据结构中
- 在samples目录中创建
async_test_module.py
