基本信息

• 华风爱科 API提供给用户一个简洁的RESTful Web接口，用以访问基于位置的天气数据。

• 用户可以搜索世界各地的地区 ， 国家 ， 行政区域和位置。

• 有三种类型的位置可以查询： 城市 ， 兴趣点 ，和邮政编码 。

• 如果在URL中指定了类型，则结果将只返回该类型。

• 任何类型的位置皆可以通过华风爱科提供的location key来检索。

• 特定位置的location key可以通过文本搜索，城市搜索，geolookup搜索，邮政编码搜索或搜索兴趣点的应答来获得。

• 使用GeoLookup通过经度和纬度坐标进行搜索。GeoLookups在中国大陆地区应使用GCJ-02坐标系，在其他地区应使用WGS-84坐标系统。

• 数据支持超过100个语言和方言

• 默认情况下，将不返回如选定的市场区域，车站代码，人口等位置的具体细节。请通过传递“details=true”查看该位置的相关细节。

城市

• 超过350万可搜索的位置，其中包括170万VerifiedLocations 。

• 许多城市有定义的备用名称或别名，以在搜索特定位置时提供灵活性。别名用于解释常见的替代拼写（圣路易斯，圣路易斯，圣路易斯），历史名称（胡志明市，西贡）和接受的替代名称（德里，伦敦德里）。

• 只有经过验证的地点才会用于GeoLookup和AutoComplete搜索。

• 只有经过验证的地点才支持本地化（翻译）。

• 城市搜索将以rank为排序返回 ，在顶部列出最重要的城市。

• 请参阅位置API指南 ，了解如何搜索城市的例子。

邮政编码

• 已验证的邮政编码搜索适用于以下国家/地区，代码的根级别为红色：
  • 加拿大 -遵循格式A0A 0A0。所有查询都基于正向分拣区域，或FSA，邮政编码的一部分。
  • 德国 -遵循格式00000。许多邮政编码名称都提供德语和英语。
  • 英国 -遵循格式A0 0 AA，A00 0 AA，AA0 0 AA，AA00 0 AA，A0A 0 AA，或AA0A 0 AA。所有查询都基于邮编扇区。英国邮政编码系统还支持以下几个区域：根西岛，马恩岛和泽西岛。
  • 美国 -遵循格式00000。美国邮政编码系统还包括对以下区域的支持：美属萨摩亚，密克罗尼西亚联邦，关岛，马绍尔群岛，北马里亚纳群岛，帕劳，波多黎各和美属维尔京群岛。

• 未经验证的邮政编码搜索仅支持以下国家：安道尔，阿根廷，澳大利亚，奥地利，比利时，巴西，保加利亚，克罗地亚，捷克共和国，丹麦，芬兰，法国，危地马拉，匈牙利，意大利，卢森堡，墨西哥，摩尔多瓦，荷兰，新西兰，挪威，波兰，俄罗斯，斯洛伐克，斯洛文尼亚，西班牙，瑞典，瑞士。

• 一个邮政编码可以指向多个位置;使用Location Key可返回一个特定的邮政编码。

• 在许多情况下，特定邮政编码的名称来自负责该邮政编码的邮局的位置。 这些名称通常与位于同一地区的城市不同。这些名称经常从设在该同一区域的城市不同。

• 由于邮政编码可以覆盖大面积，得出的数据是基于最能代表邮政编码的整个区域映射的。

兴趣点

• 缩写为POI，兴趣点经常用于指商业位置，旅游地点或其他众所周知的站点。可用的POI的常见示例是机场，体育场和公园。

• 超过50,000个可搜索的兴趣点。

• 超过12,000个全球机场，包括能够按机场代码搜索（支持美国联邦航空局FAA，国际民航组织ICAO，国际航空运输协会IATA代码）。

• 主要集中在美国，在不久的将来计划扩展到其他国家，包括支持本地化名称

• 支持POI类型的列表，请点击这里 。

• 兴趣点不会在GeoPosition（纬度/经度）搜索中返回。

时区信息

• 时区信息是通过位置api与预报点的位置信息一同返回的。

• 通过对位置api的时区查询，可获得任何纬度/经度的时区信息，包括海洋区域和没有预测点的区域。