# 心知天气
预报指定城市未来几天的天气预报，包含"获取当前天气状况"、"获取未来天气预报"执行动作。
#### 连接参数
心知天气连接器使用APIkey认证，创建心知天气连接时连接参数说明如[表1]所示。
 表1连接参数说明 
| 名称   | 必填 | 说明           | 示例值/默认值                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
|:---|:---|:---|:---|
| 连接名称 | 是  | 设置连接名称。      | 心知天气的连接。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| 描述   | 否  | 对于连接的信息描述说明。 | description。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| key  | 是  | API密钥。       | 1. 访问<https://www.seniverse.com/pricing>后，注册账号并登录。  2. 选择"数据API产品版本"，单击"立即申请"或"立即购买"。  3. 申请或购买完成后，单击"控制台"。  4. 在控制台界面，单击"产品管理"目录下对应的版本。  5. 在"基本信息"页签的"API密钥"处查看并获取私钥。  6. 在集成工作台中创建"心知天气"连接时，输入获取的私钥，单击"保存"完成连接创建。   |
   
#### 获取当前天气状况
获取指定地区当前天气状况。
- 输入参数 用户配置获取当前天气状况执行动作，相关参数说明如[表2]所示。
   表2获取当前天气状况输入参数说明 
  | 参数   | 必填 | 说明                                                                                                                                                                                                                                          | 示例值/默认值 |
  |:---|:---|:---|:---|
  | 城市   | 是  | 请输入预报的城市。                                                                                                                                                                                                                                   | 南京      |
  | 语言   | 否  | 请输入语言信息，默认简体中文。 - 简体中文：zh-Hans  - 英文：en   | zh-Hans |
  | 度数单位 | 否  | 请输入度数单位，默认值c，摄氏度：c；华氏度：f。                                                                                                                                                                                                                   | c       |
     
  
- 输出参数 用户可以在之后的执行动作中调用该输出参数，输出参数说明请参考[表3]。
   表3获取当前天气状况输出参数说明 
  | 参数 | 说明  | 示例值/默认值 |
  |:---|:---|:---|
  | 城市 | 城市。 | 南京      |
  | 国家 | 国家。 | CN      |
  | 天气 | 天气。 | 多云      |
  | 温度 | 温度。 | 37      |
     
  
 
#### 获取未来天气预报
获取指定区域内未来天气状况。
- 输入参数 用户配置获取未来天气预报执行动作，相关参数说明如[表4]所示。
   表4获取未来天气状况输入参数说明 
  | 参数     | 必填 | 说明                                                                                                                                                                                                                                | 示例值/默认值 |
  |:---|:---|:---|:---|
  | 城市     | 是  | 请输入预报的城市。                                                                                                                                                                                                                         | 南京      |
  | 语言     | 否  | 请输入语言信息，默认简体中文。 - 简体中文：zh-Hans  - 英文：en   | zh-Hans |
  | 度数单位   | 否  | 请输入度数单位，默认值c。 - 摄氏度：c  - 华氏度：f                | c       |
  | 预报起始时间 | 否  | 请输入预报起始时间，默认值今天。 - 今天：0  - 明天：1           | 0       |
  | 预报天数   | 否  | 请输入预报天数，默认值3天，最大值3。                                                                                                                                                                                                               | 3       |
     
  
- 输出参数
  用户可以在之后的执行动作中调用该输出参数，输出参数说明请参考[表5]。
   表5获取未来天气预报输出参数说明 
  | 参数     | 说明        |
  |:---|:---|
  | 城市     | 所需要查询的城市。 |
  | 国家     | 所需要查询的国家。 |
  | 今天日期   | 今天日期。     |
  | 今天最高气温 | 今天最高气温。   |
  | 今天最低气温 | 今天最低气温。   |
  | 今天降水概率 | 今天白天降水概率。 |
  | 今天白天天气 | 今天白天的天气。  |
  | 今天夜间天气 | 今天夜间天气。   |
  | 明天日期   | 明天日期。     |
  | 明天最高气温 | 明天最高气温。   |
  | 明天最低气温 | 明天最低气温。   |
  | 明天降水概率 | 明天白天降水概率。 |
  | 明天白天天气 | 明天白天的天气。  |
  | 明天夜间天气 | 明天夜间天气。   |
  | 明天夜间风向 | 明天夜间风向。   |
  | 后天日期   | 后天日期。     |
  | 后天最高气温 | 后天最高气温。   |
  | 后天最低气温 | 后天最低气温。   |
  | 后天降水概率 | 后天白天降水概率。 |
  | 后天白天天气 | 后天白天的天气。  |
  | 后天夜间天气 | 后天夜间天气。   |