专用词汇表

Rank

Rank值是表明一个城市或地区排名的数字，基于多种因素综合计算而来，例如：人口、面积、GDP、搜索热度等。取值范围为1-10，在定位搜索服务中，返回的结果除了关键字的相关性以外，也会参考该城市的Rank值。数值越大代表该城市或地区的人口越多、面积更大或更加热门。例如陕西省西安市的Rank值就要比黑龙江省牡丹江市西安区更高，当使用“西安”作为关键字定位的时候，西安市的排名要高于西安区。

坐标

• 中国大陆地区应使用GCJ-02坐标系，在其他地区应使用WGS-84坐标系。
• 查询格式：经度,纬度（经度在前纬度在后，英文逗号分隔，十进制格式，北纬东经为正，南纬西经为负）。例如：location=116.41,39.92

行政区划

在全球各个国家中，都有不同的行政等级划分，为了便于理解和方便查询到正确的的天气信息，和风天气的所有城市都会属于至少2个行政区划等级。请注意，和风天气的行政区划等级不完全等于各国的实际行政区划等级。

• 代码adm1，代表一级行政区划，一般为各国的一级行政区划，例如省/州/府/构成国，是国家之下的第一个行政区划，也包括直辖市/首都/特区等特殊城市。
• 代码adm2，代表次级行政区划，一般为具体城市或地区的直属行政区划，例如余杭区的次级行政区划是杭州市，曼哈顿区的次级行政区划是纽约市。如果一个城市的直属行政区划等于一级行政区划，则这个城市的直属上级行政区划就是该城市本身，例如深圳市的一级行政区划是广东省，次级行政区划是深圳市。

LocationID

LocationID或locid，是城市、地区或POI点的ID，一般由数字或字母+数字组成，是一个地点的唯一标识。LocationID可以通过定位搜索服务获取，中国地区、热门海外城市、一些POI点的LocationID还可以通过城市列表下载。

Adcode

Adcode是中国行政区域编码。

ISO 3166

ISO 3166是国际标准化组织（ISO）发布的全球国家代码标准，正式名称是国家名称和其分支的代码。该标准规定了国家名称、附属领土、地理利益的特殊区域以及它们的主要分支（如省或州）的名称。国家代码有二位字母代码、三位字母代码、以及三位数字代码，和风天气采用的是其中的二位字母代码（alpha-2）。

完整的二位数字ISO 3166可通过我们的Github下载。

POI

Point of Interest，兴趣点。在和风天气的兴趣点概念中包括：机场、港口、火车站、中国空气质量监测站和中国景点。

日期和时间

和风天气在v7版本及以上使用ISO8601:2004作为所有日期和时间表达格式。日期和时间均为当地时间。

• 日期格式：YYYY-MM-DD，例如 2019-12-30，代表2019年12月30日。
• 长时间格式：YYYY-MM-DDTHH:MM±timezone，例如 2019-12-30T08:35+0800，代表东八区2019年12月30日上午8点35分。
• 短时间格式：HH:MM，例如 20:31

Timezone

Timezone（时区），在API中的字段名为tz，该时区的表达规范采用了tz database格式，或称IANA time zone database。

夏令时

isDST表示当前是否处于夏令时。天气数据中的时间已经对夏令时做了调整，你不需要再进行任何转换。

UTC Offset

在城市搜索接口中，utcOffset字段表示该地区/城市当前时间与UTC时间的偏移，该偏移已经考虑了一些国家在进入夏令时的情况，因此这个偏移与时区偏移不完全一样。例如纽约的时区是America/New_York，与UTC相差-5小时，当纽约在每年3月的第二个星期日进入夏令时后，纽约当地时间与UTC相差-4小时，此时utcOffset的值是-04:00

Public Time

数据发布时间，是观测站或数据源发布的时间，代表当前数据是在什么时刻发布的。

Update Time

和风天气数据更新时间，与pubTime不同，该时间是和风天气系统进行数据更新的时间，表示当前获取的数据最近一次更新的时间。

• 可以通过相同的更新时间来判断数据内容是否有变化，但不能依靠不同的更新时间来判断数据内容一定有变化，在有些情况下，气象模型计算结果有可能在不同的更新时间得到相同的结果。
• 由于天气数据的特殊性以及数据更新的持续性，无法确定精确的更新时间，请以接口返回数据的updateTime字段为准。

iOS Bundle identifier

Xcode切换到Info下，可查看Bundle Identifier。

请注意Bundle ID仅限英文字母、数字、短横线和下划线。

Android Package Name

打开Android 应用工程的AndroidManifest.xml配置文件，package属性所对应的内容为应用包名。

请注意Android Package Name仅限英文字母、数字、短横线和下划线。

最大连接数

API或SDK服务能够承载的最大连接数量。当连接超过当前应用版本所限制的最大连接数时，新建连接请求将被丢弃。

QPM

QPM (Query Per Minute)，每分钟请求数，超过每分钟请求数量的请求将返回错误代码，在下一分钟后恢复。

• 不同订阅的QPM不相同。参考订阅对比。
• QPM以单独项目计算，一个项目下所有数据KEY共享QPM，不同项目分别计算QPM。

风力等级

风力等级用于直接展示，不建议作为枚举项使用；例如以后出现更高等级风力或者变更了风力等级的标准，采用枚举项的方式则会出现匹配不到的情况，此情况请谨慎使用。

风力等级依据风速而来，可参考风力等级与风速对照，和风天气采用 KM/H 为单位。

当风力等级为0时，风向角度为-1，风向为无持续风向。