# 其他

# 一、数据&流程相关

# 1. 免费用户可以调用哪些数据

• 国内 370 个地级市
• 天气实况（2 项)
• 3 天天气预报
• 生活指数（基础 6 项)

# 2. API 访问量如何计算

每调用一次任意 API 接口，即计一次访问，即 10 万次访问量即可以调用 10 万次 API 接口。 比如：无论是调用 weather/now.json 还是 location/search.json 都是记一次访问量。 访问量余额不足时，API 服务会自动终止，请及时关注您的访问量余额，避免影响使用。

# 3. 数据更新频率是多少

在数据源更新正常的情况下:

• 天气实况接口：更新频率为 30 分钟左右⼀次。
• 天气预报接口：每天更新 4 次，更新时段为：6，10，12，17。
• 24 小时逐小时天气预报接口：更新频率为 45-60 分钟⼀次。
• 空气质量实况接口：更新频率为 1 小时一次。
• 逐日、逐小时空气质量预报接口：更新频率为 24 小时一次，更新时间 23-24 点。
• 气象灾害预警接口：更新频率为 3 分钟一次。
• 公里级天气实况：更新频率是 1 小时。
• 公里级天气预报：更新频率为一天两次，分别为早 8 晚 8。

# 4. 灾害预警提前多长时间？

灾害预警由各级政府部门提前提交到国家预警中心，经预警中心汇集、核实，再由心知天气发布。 心知这边每分钟会查询国家预警中心的接口，做到第一时间发布。 提前的时间取决于各级政府部门的效率，比如大雨预警由气象局发布，一般都提前一到两天，但泥石流预警就提前不了多久。

# 5. 钉钉 心知机器人如何设置

所有钉钉用户都可在群聊中添加心知机器人，并自定义关注地点和每日天气的推送时间。同时心知科技和国家预警信息发布中心达成合作， 通过钉钉的心知机器人中发布突发事件预警，可在机器人设置中自行开启。 如需更改心知机器人设置，请联系添加人或管理员更改。心知科技感谢您的关注与支持！

---

# 二、技术相关

# 1. 如何接入心知天气 API

需注册心知官网得到 API 密钥，然后直接通过 http 协议，发送 request 请求来访问 API。 接口的具体地址见 API 文档。

# 2. 是否有 SDK？

心知暂时不提供 SDK，建议直接通过 http 协议，发送 request 请求来访问 API。

# 3. 心知的服务器和端口是什么？

心知的 API 目前基于 http 协议，域名是 api.seniverse.com，端口是缺省的 80(http)和 443(https)。

# 4. 为什么我的签名错误

您可以参考 API 文档中各个语言的示例代码，对比一下，便于寻找问题：https://github.com/seniverse/seniverse-api-demos。 签名错误的常见问题：

• 签名值发送 API 时没有做 urlencode.
• hash_hmac 加密不正确。
• 签名失效时间太短。建议最好 300 秒以上。
• 没有绑定一个域名，如果是在本地测试的话，可以绑定一个本地域名，比如 127.0.0.1.
• 没有 API 接口权限。

# 5. AJAX 跨域如何解决？

请参考心知 GitHub 账户中出现跨域问题的解决方法：https://github.com/seniverse/seniverse-api-demos。

# 6. 城市的拼音相同是如何查询？

您可以采用以下几种方法：

• 地名拼音前面加省和空格，如 shanxi yulin。
• 输入中文名来查询天气，中文不用加空格，如陕西榆林。
• 使用其他方法，如城市 ID，城市中文名，城市拼音/英文名，城市拼音缩写，经纬度，IP 地址。

# 7. 有没有批量接口？

目前心知不支持批量返回数据，每次访问只能返回一个城市的数据。

# 8. 天气网页插件常见问题

• 插件可以免费使用吗，有无访问次数的限制

完全免费，没有访问次数的限制。

• 插件的样式可以更改吗

可以通过覆盖 CSS 调整字体大小样式。

• 复制代码后不能正常显示

在本地测试时，必须使用 HTTP 协议或者 HTTPS 协议。不能使用 file 协议。

• 插件只能默认城市，能搜索城市么

开启城市定位，可以通过用户的 ip 地址定位城市。

• 背景颜色

插件的背景颜色会随天气变化，以表示不同的天气现象。

---

# 三、气象应用类

# 1. 什么是降水强度？

降水强度，是一个类似“速度”的概念，即未来 1 分钟的降水将以怎样的速度降落，单位是 mm/h。

# 2. 什么是“网格”？

目前国家气象观测站点都建在各省市区县规划的特定位置上，即气象站点。举个例子，北京朝阳的气温取的是朝阳区内某一个观测站的气温值。 那么要如何实现站点与站点之间任意一个位置的天气预报，通过一些网格插值方法，在空间上实现更加精细化的预报。于是就有了“网格”的概念，可将网格看作虚拟的“站点”。

# 3. 城市级数据和网格级数据有何不同？

适用场景不同。城市级的数据来源为观测站点实测的数据，包括全国自动观测气象站、国家基准站、地方站、一般站等等， 适用于对空间分辨率不高，有一定区域范围的场景。而网格级的数据来源为统计插值或模式模拟，适用于对空间分辨率较高，街道级更精细化的场景。

# 4. 网格预报数据能不能更加精细化？

目前一般天气预报最精细的情况为：未来 24 小时逐小时，未来 3 ～ 10 天逐 3 小时，未来 5 ～ 15 天逐 6/12 小时，未来 15 ～ 30 天逐周，未来 30 ～ 180 天逐月。 随着预报时间延长，预报误差会增加，只能抓住天气趋势，也就是一段时间平均状态随时间的演变趋势，因此目前不同预报时长数据的精度如前所述。

# 5. 网格数据的经纬度标准？

国际标准的WGS-84（GPS坐标）