Weather API 概览

借助 Weather API，您可以请求全球各地的实时超本地化天气数据，为实时天气信息中心、天气更新应用、路线天气叠加层以及基于天气的健康或活动追踪器提供支持。天气信息包括当前温度、降水、相对湿度、风速、紫外线指数等。

对于给定纬度和经度的位置，该 API 会为下表中的数据提供端点 (https://weather.googleapis.com/v1/...)。

REST 端点概览

API 端点	网址	说明	记录的参数
当前天气状况	`https://weather.googleapis.com/v1/currentConditions:lookup`	实时天气状况	`location.latitude`、`location.longitude`
每小时天气预报	`https://weather.googleapis.com/v1/forecast/hours:lookup`	未来长达 240 小时的天气预报	`location.latitude`、`location.longitude`
每日天气预报	`https://weather.googleapis.com/v1/forecast/days:lookup`	最多可预测未来 10 天的天气状况	`location.latitude`、`location.longitude`
每小时历史记录	`https://weather.googleapis.com/v1/history/hours:lookup`	最多可缓存 24 小时的过往状况	`location.latitude`、`location.longitude`
恶劣天气预警	`https://weather.googleapis.com/v1/publicAlerts:lookup`	恶劣天气预警	`key`、`location.latitude`、`location.longitude`

实时天气和天气更新信息中心：使用 GPS 坐标（location.latitude 和 location.longitude）或经过地理编码的城市坐标查询 currentConditions:lookup、forecast/hours:lookup 和 forecast/days:lookup，以显示自动更新的温度、湿度和风速。
路线天气叠加层：从 Routes API 沿路线多段线对纬度和经度航点进行采样，并在每个航点的预计到达时间调用 currentConditions:lookup 或 forecast/hours:lookup，以提醒驾驶员注意不断变化的天气状况。
基于天气的健康、补水和活动追踪器：从 currentConditions:lookup 提取本地 temperature、feelsLikeTemperature、relativeHumidity、heatIndex 和 uvIndex，以调整每日补水目标或户外锻炼建议。

Weather API 数据包括以下内容：

天气状况和图标：weatherCondition中指示当前天气状况（例如“多云”或“局部阵雪”）的说明和相应图标。
温度：当前温度 (temperature)、最低和最高温度（每日预报中的 minTemperature 和 maxTemperature，或 currentConditionsHistory 内的温度）以及体感温度 (feelsLikeTemperature)。
降水：总降水量和降水类型（雪、雨、冰、混合）。
风：风寒指数 (windChill)、风向 (wind.direction)、风速 (wind.speed) 和阵风 (wind.gust)。
冰层厚度：冰层的厚度。
湿度： (dewPoint)、热度指数 (heatIndex)、湿球温度 (wetBulbTemperature) 和相对湿度 (relativeHumidity)。
紫外线指数：紫外线 (UV) 指数 (uvIndex)。
雷暴概率：发生雷暴的概率。
能见度：能清晰看到物体的距离。
气压：平均海平面气压。
太阳和月亮事件：日出、日落、月出和月落时间。
云量：云层覆盖天空的百分比。

1	设置	从设置 Google Cloud 项目开始，然后完成后续说明。
2	获取当前天气状况	请参阅获取当前天气状况。
3	获取每小时天气预报	请参阅获取每小时天气预报。
4	获取每日天气预报	请参阅获取每日预测。
5	获取每小时历史记录	请参阅获取每小时历史记录。
6	接收天气警报	请参阅接收天气提醒。