 |
生活指数
专用API
【更新时间: 2024.03.22】
获取指定城市的基本、交通、生活、运动、健康 5 大类共 27 项生活指数，预测至未来5天，仅支持中国城市。
免费
去服务商官网采购>
|
服务星级：6星
浏览次数
135
采购人数
1
试用次数
0
SLA: N/A
响应: N/A
适用于个人&企业
收藏
×
完成
取消
×
书签名称
确定
|
相似API
水质查询-API Space
14
水质查询 可支持对全国大多数监测站点的水质量进行查询，涵盖了诸如 PH 值、溶解氧、氨氮、高锰酸钾指数以及总有机碳含量等重要指标，能为用户提供全面且详细的水质相关信息，以满足不同的需求。
空气质量查询-API Space
67
可获取指定城市的整点观测空气质量，包含空气质量指数（AQI）、首要污染物、空气质量等级（优、良、轻度污染、中度污染、重度污染、严重污染）、6要素（CO、NO₂、O₃、PM10、PM2.5、SO₂）浓度（除了CO浓度单位为mg/m³之外，其余5种单位均为μg/m³）等。空气质量为优时，无首要污染物。
未来7天生活指数-API Space
42
未来7天生活指数可获取指定城市未来7天共计22种天气生活指数，包括晨练、洗车、穿衣、感冒、运动、旅游、舒适度、紫外线、钓鱼、晾晒、过敏、啤酒等12项指数。
- API详情
- 接口文档
- 使用指南
- 常见 FAQ
- 关于我们
- 相关推荐
产品介绍
什么是生活指数?
服务详情
获取指定城市的基本、交通、生活、运动、健康 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 项基本类生活指数，包括穿衣、紫外线强度、洗车、旅游、感冒、运动指数。
关于我们
北京心知科技有限公司
企业
北京心知科技有限公司是一家专业提供企业级高精度气象数据服务的高新技术企业。公司通过创新的气象数据服务产品，如HyperData、HyperBot和HyperInsights，为各行业提供精细化运营和高效率增长支持。心知科技的气象数据服务具有公里级精度、分钟级更新频率，以及AI增强的准确性，融合了CMA、GFS、EC等多数据源，确保数据的准确、稳定和全面。公司服务覆盖新能源、交通、农业、零售、广告、保险、移动互联网、智能硬件和车联网等多个行业，致力于通过专业的气象数据服务助力企业应对天气变化，优化运营决策。
联系信息
服务时间：
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 项基本类生活指数，包括穿衣、紫外线强度、洗车、旅游、感冒、运动指数。
关于我们
北京心知科技有限公司
企业
北京心知科技有限公司是一家专业提供企业级高精度气象数据服务的高新技术企业。公司通过创新的气象数据服务产品，如HyperData、HyperBot和HyperInsights，为各行业提供精细化运营和高效率增长支持。心知科技的气象数据服务具有公里级精度、分钟级更新频率，以及AI增强的准确性，融合了CMA、GFS、EC等多数据源，确保数据的准确、稳定和全面。公司服务覆盖新能源、交通、农业、零售、广告、保险、移动互联网、智能硬件和车联网等多个行业，致力于通过专业的气象数据服务助力企业应对天气变化，优化运营决策。
联系信息
服务时间：
0:00:00至24:00:00
电话号码：
400-022-5889
邮箱：
hi@seniverse.com
微信二维码：
查看
心知天气成立于2016年，
隶属于北京心知科技有限公司，
是国内领先的气象服务提供商，
是中国气象局授权企业和国家级高新技术企业，
致力于利用气象等自然界大数据和人工智能技术，
帮助企业优化运营，提高收益，降低风险，
助力人类绿色可持续发展。
合作案例
