生活指数
产品介绍
什么是生活指数?
服务详情
获取指定城市的基本、交通、生活、运动、健康 5 大类共 27 项生活指数,预测至未来5天,仅支持中国城市。
付费用户可获取全部数据; 免费用户只返回 6 项基本类生活指数,且只有 brief,没有 details。
- 基本类:穿衣、紫外线强度、洗车、旅游、感冒、运动
- 交通类:交通、路况
- 生活类:晾晒、雨伞、空调开启、啤酒、逛街、夜生活、约会
- 运动类:晨练、钓鱼、划船、放风筝
- 健康类:过敏、美发、化妆、风寒、防晒、空气污染扩散条件、舒适度、心情
使用场景
核心优势
什么是生活指数接口?
由服务使用方的应用程序发起,以Restful风格为主、通过公网HTTP协议调用生活指数,从而实现程序的自动化交互,提高服务效率。
使用指南
接口更新频率和滞后时间
数据类型 |
更新频率 |
滞后时间 |
天气实况接口 |
国内城市15分钟左右国际城市20分钟左右 |
30-60分钟 |
分钟级降水预报接口 |
10分钟左右 |
无 |
未来15天逐日预报接口 |
每天3-4次 |
无 |
24小时逐小时预报接口 |
1小时 |
无 |
过去24小时历史天气接口 |
1小时 |
无 |
15天逐3小时精细化天气预报 |
每天3-4次 |
无 |
空气质量实况接口 |
1小时 |
30分钟左右 |
未来5天逐日空气质量预报接口 |
每天一次 |
无 |
未来5天逐小时空气质量预报接口 |
1小时 |
无 |
过去24小时历史空气质量 |
1小时 |
无 |
生活指数接口 |
每天一次 |
无 |
气象灾害预警接口 |
5-8 分钟左右 |
10分钟 |
气象灾害预警(增量更新) |
1-3分钟左右 |
见接口文档 |
逐小时潮汐接口 |
1小时 |
无 |
公里级网格天气实况 |
1 小时 |
一小时 |
公里级网格天气预报 |
每天两次 |
无 |
过去24小时公里级天气数据 |
1小时 |
一小时 |
产品问答
?
数据覆盖范围是全球性的吗?
是的,我们的API服务覆盖全球范围。无论用户身在何处,都可以通过我们的API服务获取到相关的生活指数数据。
?
API服务的稳定性如何?
我们致力于确保API服务的稳定性和可靠性。我们采取了各种技术手段和措施,包括负载均衡、故障转移、实时监控等,以确保API服务始终保持稳定运行。
?
如何获取技术支持和反馈?
我们提供多种渠道供用户获取技术支持和提供反馈,包括电子邮件、在线聊天和社区论坛等。我们的技术团队随时准备回答用户的问题,并且欢迎用户提出任何建议或改进建议。
?
免费用户可以调用哪些数据?
国内 370 个主要城市 1. 天气实况,包括天气现象文字、代码和气温 3 项数据 2. 未来 3 天天气预报,包括白天天气现象文字及代码、晚间天气现象文字及代码、当天最高温度和最低温度、风向风速 3. 6 项基本类生活指数,包括穿衣、紫外线强度、洗车、旅游、感冒、运动指数。
关于我们
北京心知科技有限公司
企业
心知天气成立于2016年,隶属于北京心知科技有限公司,是国内领先的气象服务提供商,是中国气象局授权企业和国家级高新技术企业,致力于利用气象等自然界大数据和人工智能技术,帮助企业优化运营,提高收益,降低风险,助力人类绿色可持续发展。
联系信息
服务时间: 0:00:00至24:00:00
电话号码: 400-022-5889
邮箱: hi@seniverse.com
微信二维码:
查看
×
心知天气成立于2016年,
隶属于北京心知科技有限公司,
是国内领先的气象服务提供商,
是中国气象局授权企业和国家级高新技术企业,
致力于利用气象等自然界大数据和人工智能技术,
帮助企业优化运营,提高收益,降低风险,
助力人类绿色可持续发展。
API接口列表
生活指数
1.1 简要描述
获取指定城市的基本、交通、生活、运动、健康 5 大类共 27 项生活指数,预测至未来5天,仅支持中国城市。
1.2 请求URL
https://api.seniverse.com/v3/life/suggestion.json
1.3 请求方式
POST
1.4 入参
参数名 |
参数类型 |
默认值 |
是否必传 |
描述 |
---|---|---|---|---|
key |
String |
无 |
是 |
你的 API 密钥 |
location |
String |
无 |
是 |
所查询的位置 |
language |
String |
zh-Hans |
否 |
语言 |
1.5 出参
参数名 |
参数类型 |
默认值 |
描述 |
---|---|---|---|
suggestion.ac |
String |
空调开启:长时间开启、部分时间开启、较少开启、开启制暖空调 |
|
suggestion.air_pollution |
String |
空气污染扩散条件:优、良、中、较差、很差 |
|
suggestion.airing |
String |
晾晒:极适宜、适宜、基本适宜、较适宜、不太适宜、不适宜、不宜 |
|
suggestion.allergy |
String |
过敏:极不易发、不易发、较易发、易发、极易发 |
|
suggestion.beer |
String |
啤酒:不适宜、较不适宜、较适宜、适宜 |
|
suggestion.boating |
String |
划船:适宜、较适宜、不适宜 |
|
suggestion.car_washing |
String |
洗车:适宜、较适宜、较不宜、不宜 |
|
suggestion.chill |
String |
风寒:凉、冷、寒冷、非常寒冷、严寒、冰冻严寒、无 |
|
suggestion.comfort |
String |
舒适度:舒适、较舒适、较不舒适、不舒适、很不舒适、极不舒适、非常不舒适 |
|
suggestion.dating |
String |
约会:适宜、较适宜、较不适宜、不适宜、暂无 |
|
suggestion.dressing |
String |
穿衣:炎热、热、舒适、较舒适、较冷、冷、寒冷 |
|
suggestion.fishing |
String |
钓鱼:适宜、较适宜、不宜 |
|
suggestion.flu |
String |
感冒:少发、较易发、易发、极易发 |
|
suggestion.hair_dressing |
String |
美发:极适宜、适宜、一般 |
|
suggestion.kiteflying |
String |
放风筝:适宜、较适宜、不宜 |
|
suggestion.makeup |
String |
化妆:保湿、保湿防晒、滋润保湿、防晒、去油、去油防晒、防脱水、防脱水防晒 |
|
suggestion.mood |
String |
心情:好、较好、较差、差、暂无 |
|
suggestion.morning_sport |
String |
晨练:适宜、较适宜、较不宜、不宜 |
|
suggestion.night_life |
String |
夜生活:适宜、较适宜、较不适宜、暂无 |
|
suggestion.road_condition |
String |
路况:干燥、潮湿、湿滑、积雪、积冰 |
|
suggestion.shopping |
String |
购物:适宜、较适宜、较不宜、不适宜 |
|
suggestion.sport |
String |
运动:适宜、较适宜、较不宜 |
|
suggestion.sunscreen |
String |
防晒:弱、较弱、中等、强、极强 |
|
suggestion.traffic |
String |
交通:良好、较好、一般、较差、很差、暂无 |
|
suggestion.travel |
String |
旅游:适宜、较适宜、一般、较不宜、不太适宜、不适宜 |
|
suggestion.umbrella |
String |
雨伞:不带伞、带伞、暂无 |
|
suggestion.uv |
String |
紫外线:最弱、弱、中等、强、很强 |
1.6 错误码
错误码 |
错误信息 |
描述 |
---|---|---|
E010001 |
400 |
Wrong parameters |
E010002 |
400 |
Some required parameters are missing |
E010003 |
400 |
Wrong syntax for parameter fields |
E010004 |
400 |
Can not apply parameter fields to upstream data |
E020001 |
403 |
The signature is invalid |
E020002 |
403 |
The signature is stale |
E020003 |
403 |
You do not have access to some data in fields |
E020004 |
403 |
Unknown website |
E020005 |
403 |
Invalid request user-agent |
E020006 |
403 |
You do not have access to data of some location |
E020007 |
403 |
Your membership has been expired |
E020008 |
403 |
You have exceeded your usage quota |
E020009 |
429 |
You have exceeded your rate limit |
E020010 |
403 |
Unknown public key |
E030001 |
404 |
The requested api does not exist |
E030002 |
404 |
Some fields do not exist |
E030003 |
404 |
Some location can not be found |
E030004 |
404 |
The location for requested IP can not be found |
E030005 |
404 |
The requested coordinate is out of range |
E100001 |
500 |
Internal server error: requested data is missing |
E100002 |
500 |
Internal server error: invalid data from upstream E100003 502 Internal server error: bad gateway |
E100003 |
502 |
Internal server error: bad gateway |
E100004 |
504 |
Internal server error: timeout for upstream request |
E100005 |
503 |
Internal server error: service is unavailable for now |
E100006 |
500 |
Internal server error |
1.7 示例
请求参数{
"key": "",
"location": "",
"language": ""
}
返回参数
{
"suggestion.ac": "",
"suggestion.air_pollution": "",
"suggestion.airing": "",
"suggestion.allergy": "",
"suggestion.beer": "",
"suggestion.boating": "",
"suggestion.car_washing": "",
"suggestion.chill": "",
"suggestion.comfort": "",
"suggestion.dating": "",
"suggestion.dressing": "",
"suggestion.fishing": "",
"suggestion.flu": "",
"suggestion.hair_dressing": "",
"suggestion.kiteflying": "",
"suggestion.makeup": "",
"suggestion.mood": "",
"suggestion.morning_sport": "",
"suggestion.night_life": "",
"suggestion.road_condition": "",
"suggestion.shopping": "",
"suggestion.sport": "",
"suggestion.sunscreen": "",
"suggestion.traffic": "",
"suggestion.travel": "",
"suggestion.umbrella": "",
"suggestion.uv": ""
}
错误码
{
"E010001": "400",
"E010002": "400",
"E010003": "400",
"E010004": "400",
"E020001": "403",
"E020002": "403",
"E020003": "403",
"E020004": "403",
"E020005": "403",
"E020006": "403",
"E020007": "403",
"E020008": "403",
"E020009": "429",
"E020010": "403",
"E030001": "404",
"E030002": "404",
"E030003": "404",
"E030004": "404",
"E030005": "404",
"E100001": "500",
"E100002": "500",
"E100003": "502",
"E100004": "504",
"E100005": "503",
"E100006": "500"
}
使用指南
接口更新频率和滞后时间
数据类型 |
更新频率 |
滞后时间 |
天气实况接口 |
国内城市15分钟左右国际城市20分钟左右 |
30-60分钟 |
分钟级降水预报接口 |
10分钟左右 |
无 |
未来15天逐日预报接口 |
每天3-4次 |
无 |
24小时逐小时预报接口 |
1小时 |
无 |
过去24小时历史天气接口 |
1小时 |
无 |
15天逐3小时精细化天气预报 |
每天3-4次 |
无 |
空气质量实况接口 |
1小时 |
30分钟左右 |
未来5天逐日空气质量预报接口 |
每天一次 |
无 |
未来5天逐小时空气质量预报接口 |
1小时 |
无 |
过去24小时历史空气质量 |
1小时 |
无 |
生活指数接口 |
每天一次 |
无 |
气象灾害预警接口 |
5-8 分钟左右 |
10分钟 |
气象灾害预警(增量更新) |
1-3分钟左右 |
见接口文档 |
逐小时潮汐接口 |
1小时 |
无 |
公里级网格天气实况 |
1 小时 |
一小时 |
公里级网格天气预报 |
每天两次 |
无 |
过去24小时公里级天气数据 |
1小时 |
一小时 |
依赖服务
产品问答
?
数据覆盖范围是全球性的吗?
是的,我们的API服务覆盖全球范围。无论用户身在何处,都可以通过我们的API服务获取到相关的生活指数数据。
?
API服务的稳定性如何?
我们致力于确保API服务的稳定性和可靠性。我们采取了各种技术手段和措施,包括负载均衡、故障转移、实时监控等,以确保API服务始终保持稳定运行。
?
如何获取技术支持和反馈?
我们提供多种渠道供用户获取技术支持和提供反馈,包括电子邮件、在线聊天和社区论坛等。我们的技术团队随时准备回答用户的问题,并且欢迎用户提出任何建议或改进建议。
?
免费用户可以调用哪些数据?
国内 370 个主要城市 1. 天气实况,包括天气现象文字、代码和气温 3 项数据 2. 未来 3 天天气预报,包括白天天气现象文字及代码、晚间天气现象文字及代码、当天最高温度和最低温度、风向风速 3. 6 项基本类生活指数,包括穿衣、紫外线强度、洗车、旅游、感冒、运动指数。
关于我们
北京心知科技有限公司
企业
心知天气成立于2016年,隶属于北京心知科技有限公司,是国内领先的气象服务提供商,是中国气象局授权企业和国家级高新技术企业,致力于利用气象等自然界大数据和人工智能技术,帮助企业优化运营,提高收益,降低风险,助力人类绿色可持续发展。
联系信息
心知天气成立于2016年,
隶属于北京心知科技有限公司,
是国内领先的气象服务提供商,
是中国气象局授权企业和国家级高新技术企业,
致力于利用气象等自然界大数据和人工智能技术,
帮助企业优化运营,提高收益,降低风险,
助力人类绿色可持续发展。
合作案例