一个用于Darksky Weather API的简单PythonAPI包装器
darkskyapi-p的Python项目详细描述
暗黑API包装器
Darkskyapi天气包装器是由Darksky提供动力的并提供使用Python3.6访问天气详细信息的简单方法。
安装
pip install darkskyapi-py
更改日志
v1.1.0
- 添加了分钟数据锁
- 添加了语言支持
- 排除添加的数据锁
- 在dsf类中添加的precipintensityerror数据点
- 已处理的url现在是客户端的属性
- 不再需要为current、daily等创建单独的实例。current、daily、hourly和minutely现在是darkskyclient类的属性。仍然可以为自定义的日、小时或分钟值创建单独的实例。
使用v1.1.0
客户端实例
首先从darkskyapi模块导入darkskyclient类。如果您还没有用于darksky api的api密钥,请在这里免费获取一个。这将允许您每天拨打1000个电话。
fromDarkSkyAPI.DarkSkyAPIimportDarkSkyClient
接下来,使用api_键作为第一个参数,使用包含位置纬度和经度的元组作为第二个参数来创建客户机实例。第三个参数是可选的,将设置单位(摄氏度/华氏度)。第四个参数是可选的,将设置要排除的数据锁(例如:"minutely")。第五个参数是可选的,将设置天气摘要的语言(默认为英语)。单元选项如下:
- 自动:根据地理位置自动选择单位
- ca:与si相同,只是风速和阵风的单位是公里/小时
- UK2:与国际单位制相同,只是最近的风暴距离和能见度以英里为单位,风速和阵风以英里/小时为单位。
- 美国:英制单位
- 国际单位制(默认) 如果没有提供单位,则默认为"si"。
client=DarkSkyClient(api_key,(lat,lon),units="si",exclude=["minutely","hourly"],lang="nl")
客户端实例已保存原始天气响应,并且可以由client.raw_数据访问。
client.raw_data
此外,它还跟踪当天剩余的api调用。
client.API_calls_remaining
处理后的url可以这样获得
client.url
当前数据
当前天气详细信息的所有数据点都会自动设置为实例的属性。这允许您使用数据点之类的属性。
当前数据有多种访问方式。最简单的方法是使用客户端实例的当前属性
client.currently.temperature
可以通过调用当前实例的weekday属性来访问weekday。这将返回完整的工作日名称(英语)。要返回短工作日名称(即周一、周二),请使用weekday_short属性。
client.currently.weekdayclient.currently.weekday_short
或者,您可以设置这样一个单独的实例
currently=client.get_current()
pip install darkskyapi-py
0
日、时、分数据
要自定义返回的小时、天或分钟数,只需将n小时/天/分钟数作为int传递给该方法即可。
pip install darkskyapi-py
1
daily、hourly和minutely类的行为方式相同,因为它们继承自同一个基类。因此,只记录每日实例。小时/日/分钟和小时/日/分钟这两个术语可以互换使用。
可以通过各种方式访问预测数据点。要按天或小时获取数据,您可以使用day/hour/minute属性或Forecast实例的数据列表。
pip install darkskyapi-py
2
所有实例还将每个日期点设置为属性。这些属性包含单个数据点值的列表。
pip install darkskyapi-py
3
或者,有几种方法可用于获取一个或多个数据点的数据集合。这些方法对每日和每小时的实例都有效。当前可用的方法有:
- 数据对:将返回包含firstl的值对元组的列表y是日期时间,其次是数据点的值。此方法接受三个参数。第一个参数是数据点(必需)。第二个参数是date-fmt参数,它将设置datetime值的格式(默认值-%d-%m-%y%h:%m")。第三个参数是graph参数,如果设置为true,它将返回日期时间和数据点值的图形友好dict(默认值为false)。
- data_single:将返回单个数据点值的列表。此方法接受三个参数。第一个参数是要获取其值的数据点。第二个参数是一个布尔值,如果设置为true(默认值:false),它将把数据点转换为百分比。第三个参数是一个布尔值,如果设置为true(默认值:false),它会将数据点转换为日期时间字符串。
- data_combined:将返回包含每天/小时数据点值列表的dict。此方法接受两个参数。第一个是数据点列表。第二个是日期,因为数据点是时间。如果您不提供数据点列表,它将返回所有数据点。
- DateTimes:将返回包含天/小时的所有日期时间的列表。此方法接受一个dateformat参数(默认值-%d-%m-%y%h:%m")
数据对方法
pip install darkskyapi-py
4
数据单一方法
pip install darkskyapi-py
5
数据组合法
pip install darkskyapi-py
6
日期时间方法
pip install darkskyapi-py
7
pip install darkskyapi-py
pip install darkskyapi-py
5
数据组合法
pip install darkskyapi-py
6
日期时间方法
pip install darkskyapi-py
7
pip install darkskyapi-py
pip install darkskyapi-py