实时天气数据-OpenWeather
专用API
【更新时间: 2024.03.20】
获取地球上任何位置的当前天气数据！我们从全球和当地的天气模型、卫星、雷达和大量的气象站等不同来源收集和处理天气数据。数据可用的格式包括JSON、XML或HTML。
|
相似API
天气预警-API Space
0
天气预警，能够获取指定城市当前正在生效的各类天气预警信息，比如台风、暴雨、暴雪、大风、高温、雷电、大雾、寒潮等等。它可为相关决策和行动提供及时且关键的天气预警数据支持，以便更好地应对各种天气状况。
未来7天生活指数-API Space
0
未来7天生活指数可获取指定城市未来7天共计22种天气生活指数，包括晨练、洗车、穿衣、感冒、运动、旅游、舒适度、紫外线、钓鱼、晾晒、过敏、啤酒等12项指数。
智能家居信息-中指云
0
智能家居信息，涵盖了丰富的内容，如智能门锁的详细信息、可视对讲的相关数据、智能开关的具体情况、安防系统的各项内容，还有智能系统配套量以及型号数据等，全方位满足对智能家居相关信息的查询需求。
- API详情
- 接口文档
- 定价
- 使用指南
- 常见 FAQ
- 关于我们
- 相关推荐
产品介绍
什么是OpenWeather的实时天气数据?
服务详情
当前天气数据API服务是 OpenWeather 提供的一项服务，旨在向用户提供即时的天气信息。通过该API，用户可以获取特定位置的当前天气状况，包括温度、湿度、气压、风速和风向等信息。
核心功能
- 通过经纬度能够查询特定位置的当前天气信息
- 通过城市id查询特定城市当前天气信息
核心优势
- 全球覆盖：能够获取地球上任何地点的当前天气数据，无论是城市、乡村还是偏远地区，都可以获得实时天气信息。
- 多来源数据：数据来源广泛，包括全球和本地天气模型、卫星、雷达以及庞大的气象站网络。这意味着用户可以获得来自多种数据源的天气信息，提高了数据的准确性和全面性。
- 多格式支持：提供多种数据格式选择，包括 JSON、XML 或 HTML 格式。这样的灵活性使得用户可以根据自己的偏好或应用需求选择合适的数据格式进行使用和处理。
- 实时更新：提供的天气数据是实时更新的，反映了当前地点的最新天气状况。这样的及时性保证了用户获取到的天气信息是最准确、最新的。
- 灵活性：能够满足不同用户的需求，无论是普通用户、开发者还是企业用户，都可以根据自身需求获取和处理天气数据，从而实现各种应用场景。
什么是OpenWeather的实时天气数据？
由服务使用方的应用程序发起，以Restful风格为主、通过公网HTTP协议调用OpenWeather的实时天气数据，从而实现程序的自动化交互，提高服务效率。
产品价格
使用指南
使用注意事项
如果您需要自动将城市名称和邮政编码转换为地理坐标，或者反之亦然，请使用Geocoder API 。
请注意，内置地理编码器已被弃用。尽管它仍然可以使用，但错误修复和更新不再适用于此功能。
API响应
如果您在 API 响应中没有看到某些参数，则意味着这些天气现象在所选城市或位置的测量时间内并未发生。API 响应中仅显示实际测量或计算的数据。
支持的语言
af南非荷兰语al阿尔巴尼亚语ar阿拉伯az阿塞拜疆语bg保加利亚语ca加泰罗尼亚语cz捷克语da丹麦语de德语el希腊语en英语eu巴斯克fa波斯语（波斯语）fi芬兰fr法语gl加利西亚语he希伯来语hi印地语hr克罗地亚语hu匈牙利id印度尼西亚it意大利语ja日本人kr韩国人la拉脱维亚语lt立陶宛语mk马其顿语no挪威nl荷兰语pl抛光pt葡萄牙语pt_br巴西葡萄牙语ro罗马尼亚语ru俄语sv, se瑞典sk斯洛伐克语sl斯洛文尼亚语sp, es西班牙语sr塞尔维亚th泰国tr土耳其ua, uk乌克兰vi越南语zh_cn简体中文zh_tw中国传统的zu祖鲁语
产品问答
?
是否支持多语言输出？
您可以使用lang 参数以您的语言获取输出。对城市名称和描述字段应用翻译。
?
响应格式是否支持不同格式输出？
默认使用 JSON 格式。要获取 XML 格式的数据，只需设置 mode = xml。
关于我们
OpenWeather
企业
OpenWeather是一家总部位于英国伦敦的气象服务公司，由IT专家和数据科学家团队组成，专注于深度气象数据科学。该公司为全球每个地点提供历史、当前和预测的气象数据，通过快速的API接口实现数据访问。OpenWeather的技术包括“时间机器”，能够提供长达45年的气象数据。此外，公司还提供基于AI和卫星图像的农业分析服务，以及天气地图和仪表板等产品。OpenWeather致力于通过技术创新，为用户提供准确、高质量的气象信息服务。
联系信息
服务时间：
0:00:00至24:00:00
邮箱：
info@openweathermap.org
API接口列表
获取当前天气数据
1.1 简要描述
根据纬度获取当前位置天气信息
1.2 请求URL
https://api.openweathermap.org/data/2.5/weather
1.3 请求方式
POST
1.4 入参
| 参数名 | 参数类型 | 默认值 | 是否必传 | 描述 |
|---|---|---|---|---|
| lat | String | 是 | 纬度 | |
| lon | String | 是 | 经度 | |
| appid | String | 是 | 您唯一的 | |
| mode | String | 否 | 响应格式。可能的值为xml和html。如果不使用mode参数格式默认为JSON。 | |
| units | String | 否 | 测量单位。standard，metric并且imperial | |
| lang | String | 否 | 您可以使用此参数获取您的语言的输出。 |
1.5 出参
| 参数名 | 参数类型 | 默认值 | 描述 |
|---|---|---|---|
| coord.lon | String | 地点的经度 | |
| coord.lat | String | 地点的纬度 | |
| weather.id | String | 天气状况 | |
| weather.main | String | 天气参数组（雨、雪、云等） | |
| weather.description | String | 团体内的天气状况。请在这里找到更多信息。您可以获得您的语言的输出。了解更多 | |
| weather.icon | String | 天气图标 | |
| base | String | 内部参数 | |
| main.temp | String | 温度。单位默认：开尔文，公制：摄氏度，英制：华氏度 | |
| main.feels_like | String | 温度。该温度参数解释了人类对天气的感知。单位默认：开尔文，公制：摄氏度，英制：华氏度 | |
| main.pressure | String | 海平面大气压，hPa | |
| main.humidity | String | 湿度， | |
| main.temp_min | String | 目前最低温度。这是目前观测到的最低温度（在大都市和城市地区）。请在此处查找更多信息。单位默认：开尔文，公制：摄氏度，英制：华氏度 | |
| main.temp_max | String | 当前最高温度。这是目前观测到的最高温度（在大都市和城市地区）。请在此处查找更多信息。单位默认：开尔文，公制：摄氏度，英制：华氏度 | |
| main.sea_level | String | 海平面大气压，hPa | |
| main.grnd_level | String | 地面大气压，hPa | |
| visibility | String | 能见度，米。能见度最大值为10公里 | |
| wind.speed | String | 风速。单位默认：米/秒，公制：米/秒，英制：英里/小时 | |
| wind.deg | String | 风向、度（气象） | |
| wind.gust | String | 阵风。单位默认：米/秒，公制：米/秒，英制：英里/小时 | |
| clouds.all | String | 云度，% | |
| rain.1h | String | （如果有）过去 | |
| rain.3h | String | （如果有）过去 | |
| snow.1h | String | （如果有）过去 | |
| snow.3h | String | （如果有）过去 | |
| dt | String | 数据计算时间，unix，UTC | |
| sys.type | String | 内部参数 | |
| sys.id | String | 内部参数 | |
| sys.message | String | 内部参数 | |
| sys.country | String | 国家代码（GB、JP | |
| sys.sunrise | String | 日出时间，unix，UTC | |
| sys.sunset | String | 日落时间，unix，UTC | |
| timezone | String | 与UTC | |
| id | String | 城市ID。 | |
| name | String | 城市名。 | |
| cod | String | 内部参数 |
1.6 错误码
| 错误码 | 错误信息 | 描述 |
|---|---|---|
| 400 | 错误 | 400 |
| 401 | 错误 | 401 |
| 404 | 未找到错误404。 | 如果服务数据库中不存在请求参数（lat、等）的数据，您可能会收到 |
| 429 | 错误 | 429 |
| 5xx | 错误 | 5xx |
1.7 示例
请求参数{
"lat": "",
"lon": "",
"appid": "",
"mode": "",
"units": "",
"lang": ""
}
返回参数
{
"coord.lon": "地点的经度",
"coord.lat": "",
"weather.id": "",
"weather.main": "",
"weather.description": "",
"weather.icon": "",
"base": "",
"main.temp": "",
"main.feels_like": "",
"main.pressure": "",
"main.humidity": "",
"main.temp_min": "",
"main.temp_max": "",
"main.sea_level": "",
"main.grnd_level": "",
"visibility": "",
"wind.speed": "",
"wind.deg": "",
"wind.gust": "",
"clouds.all": "",
"rain.1h": "",
"rain.3h": "",
"snow.1h": "",
"snow.3h": "",
"dt": "",
"sys.type": "",
"sys.id": "",
"sys.message": "",
"sys.country": "",
"sys.sunrise": "",
"sys.sunset": "",
"timezone": "",
"id": "",
"name": "",
"cod": ""
}
错误码
{
"400": "错误",
"401": "错误",
"404": "未找到错误404。如果服务数据库中不存在请求参数（",
"429": "错误",
"5xx": "错误"
}
产品价格
使用指南
使用注意事项
如果您需要自动将城市名称和邮政编码转换为地理坐标，或者反之亦然，请使用Geocoder API 。
请注意，内置地理编码器已被弃用。尽管它仍然可以使用，但错误修复和更新不再适用于此功能。
API响应
如果您在 API 响应中没有看到某些参数，则意味着这些天气现象在所选城市或位置的测量时间内并未发生。API 响应中仅显示实际测量或计算的数据。
支持的语言
af南非荷兰语al阿尔巴尼亚语ar阿拉伯az阿塞拜疆语bg保加利亚语ca加泰罗尼亚语cz捷克语da丹麦语de德语el希腊语en英语eu巴斯克fa波斯语（波斯语）fi芬兰fr法语gl加利西亚语he希伯来语hi印地语hr克罗地亚语hu匈牙利id印度尼西亚it意大利语ja日本人kr韩国人la拉脱维亚语lt立陶宛语mk马其顿语no挪威nl荷兰语pl抛光pt葡萄牙语pt_br巴西葡萄牙语ro罗马尼亚语ru俄语sv, se瑞典sk斯洛伐克语sl斯洛文尼亚语sp, es西班牙语sr塞尔维亚th泰国tr土耳其ua, uk乌克兰vi越南语zh_cn简体中文zh_tw中国传统的zu祖鲁语
依赖服务
产品问答
?
是否支持多语言输出？
您可以使用lang 参数以您的语言获取输出。对城市名称和描述字段应用翻译。
?
响应格式是否支持不同格式输出？
默认使用 JSON 格式。要获取 XML 格式的数据，只需设置 mode = xml。
关于我们
OpenWeather
企业
OpenWeather是一家总部位于英国伦敦的气象服务公司，由IT专家和数据科学家团队组成，专注于深度气象数据科学。该公司为全球每个地点提供历史、当前和预测的气象数据，通过快速的API接口实现数据访问。OpenWeather的技术包括“时间机器”，能够提供长达45年的气象数据。此外，公司还提供基于AI和卫星图像的农业分析服务，以及天气地图和仪表板等产品。OpenWeather致力于通过技术创新，为用户提供准确、高质量的气象信息服务。
联系信息
服务时间：
0:00:00至24:00:00
邮箱：
info@openweathermap.org
