索引
Weather
(接口)AirPressure
(消息)CardinalDirection
(枚举)ForecastDay
(消息)ForecastDayPart
(消息)ForecastHour
(消息)HistoryHour
(消息)IceThickness
(消息)IceThickness.Unit
(枚举)LookupCurrentConditionsRequest
(消息)LookupCurrentConditionsResponse
(消息)LookupCurrentConditionsResponse.CurrentConditionsHistory
(消息)LookupForecastDaysRequest
(消息)LookupForecastDaysResponse
(消息)LookupForecastHoursRequest
(消息)LookupForecastHoursResponse
(消息)LookupHistoryHoursRequest
(消息)LookupHistoryHoursResponse
(消息)MoonEvents
(消息)MoonPhase
(枚举)Precipitation
(消息)PrecipitationProbability
(消息)PrecipitationType
(枚举)QuantitativePrecipitationForecast
(消息)QuantitativePrecipitationForecast.Unit
(枚举)SpeedUnit
(枚举)SunEvents
(消息)Temperature
(消息)TemperatureUnit
(枚举)UnitsSystem
(枚举)Visibility
(消息)Visibility.Unit
(枚举)WeatherCondition
(消息)WeatherCondition.Type
(枚举)Wind
(消息)WindDirection
(消息)WindSpeed
(消息)
天气
Weather API 的服务定义。
LookupCurrentConditions |
---|
返回给定地点的当前天气状况。
|
LookupForecastDays |
---|
返回指定地点(从当天开始)最多 10 天的每日预报。
|
LookupForecastHours |
---|
返回指定地点(从当前小时开始)最多 240 小时的每小时预报。
|
LookupHistoryHours |
---|
返回给定地点(从过去一小时开始)最多 24 小时的每小时历史天气数据。
|
AirPressure
表示大气气压条件。
字段 | |
---|---|
mean_ |
平均海平面气压(以毫巴为单位)。 |
CardinalDirection
表示基本方向(包括序数方向)。
枚举 | |
---|---|
CARDINAL_DIRECTION_UNSPECIFIED |
未指定基准方向。 |
NORTH |
正北方向。 |
NORTH_NORTHEAST |
东北偏北的次方位方向。 |
NORTHEAST |
东北方位。 |
EAST_NORTHEAST |
东北偏东次方位。 |
EAST |
东方。 |
EAST_SOUTHEAST |
东南偏东辅助方位。 |
SOUTHEAST |
东南方位。 |
SOUTH_SOUTHEAST |
南南东次方位。 |
SOUTH |
南方基本方向。 |
SOUTH_SOUTHWEST |
南西辅助方位。 |
SOUTHWEST |
西南方位。 |
WEST_SOUTHWEST |
西南偏西的次方位角。 |
WEST |
西方基本方向。 |
WEST_NORTHWEST |
西北偏西的次方位角。 |
NORTHWEST |
西北方位。 |
NORTH_NORTHWEST |
北西辅助方位。 |
ForecastDay
表示给定地点的每日预报记录。
字段 | |
---|---|
interval |
此预报日期的开始时间(包括此时间)和结束时间(不包括此时间)对应的世界协调时间 (UTC) 间隔。注意:一天的开始时间为当地时间早上 7 点,结束时间为次日早上 7 点。例如:如果本地时区为 UTC-7,则该时间间隔将从 |
display_ |
计算此每日预报时所用地点所在时区(民用时间)的当地日期。此字段可用于在客户端上显示。 |
daytime_ |
白天(当地时间上午 7 点到晚上 7 点)的天气预报。 |
nighttime_ |
当天夜间(当地时间晚上 7 点到次日早上 7 点)的天气预报。 |
max_ |
全天最高温度。 |
min_ |
全天最低(低)温度。 |
feels_ |
全天最高(高)体感温度。 |
feels_ |
全天最低(最低)体感温度。 |
max_ |
全天最高热指数温度。 |
sun_ |
与太阳相关的事件(例如日出、日落)。 |
moon_ |
与月亮相关的事件(例如月出、月落)。 |
ice_ |
一整天累计的冰量。 |
ForecastDayPart
表示一天中的某个时间段的预测记录。
字段 | |
---|---|
interval |
此时段的开始日期和时间(含)和结束日期和时间(不含)。采用世界协调时间 (UTC)。注意:一天中的某个部分是指当天上午 7 点到晚上 7 点(当地时间)。例如:如果当地时区为 UTC-7,则白天时段将从 |
weather_ |
预测的天气状况。 |
precipitation |
预测的降水量。 |
wind |
平均风向、最大风速和阵风。 |
relative_ |
预测的相对湿度百分比(值介于 0 到 100 之间)。 |
uv_ |
预测的紫外线 (UV) 指数的最大值。 |
thunderstorm_ |
平均雷暴概率。 |
cloud_ |
平均云量百分比。 |
ForecastHour
表示给定地点的每小时天气预报记录。
字段 | |
---|---|
interval |
此预测数据有效的一小时间隔(世界协调时间 [UTC])。时间戳会向下舍入到最接近的小时。 |
display_ |
此小时预报所针对的地点所在时区(民用时间)的当地日期和时间。此字段可用于在客户端上显示。注意:此日期将包含年、月、日、小时和相对于世界协调时间 (UTC) 的偏移量。 |
weather_ |
预测的天气状况。 |
temperature |
预测的温度。 |
feels_ |
衡量所请求地点温度感觉的测量值。 |
dew_ |
预测的温度。 |
heat_ |
预测的酷热指数温度。 |
wind_ |
预报的冷风寒度,即皮肤所接触的空气温度。 |
wet_ |
预测的湿度温度,即通过蒸发水达到的最低温度。 |
precipitation |
预测的降水概率和过去一小时累计降水量。 |
air_ |
预测的气压状况。 |
wind |
预测的风况。 |
visibility |
预测的可见度。 |
ice_ |
预测的冰层厚度。 |
is_ |
如果此小时数介于当地日出(包括)和日落(不包括)之间,则返回 true。否则,则为夜间(日落到次日日出之间)。注意:如果相应时间段与当地日出和日落时间相交,则此小时将被视为白天或夜晚(例如:如果相应时间段为凌晨 5 点到凌晨 6 点,而日出时间为凌晨 5:59,则 is_daytime 将为 true)。 |
relative_ |
预测的相对湿度百分比(值介于 0 到 100 之间)。 |
uv_ |
预测的紫外线 (UV) 指数。 |
thunderstorm_ |
预报的雷暴概率(值介于 0 到 100 之间)。 |
cloud_ |
天空被云层覆盖的预测百分比(值介于 0 到 100 之间)。 |
HistoryHour
表示给定位置的每小时历史记录。
字段 | |
---|---|
interval |
这些历史数据的有效时间范围(以世界协调时间 [UTC] 为单位)为一小时(时间戳会向下舍入到最接近的小时)。 |
display_ |
计算此小时记录时所采用的地理位置所在时区(民用时间)的当地日期和时间。此字段可用于在客户端上显示。注意:此日期将包含年、月、日、小时和相对于世界协调时间 (UTC) 的偏移量。 |
weather_ |
历史天气状况。 |
temperature |
历史温度。 |
feels_ |
衡量所请求地点温度感觉如何的指标。 |
dew_ |
历史温度。 |
heat_ |
历史酷热指数温度。 |
wind_ |
历史风寒指数,即皮肤暴露在外的空气温度。 |
wet_ |
历史湿度温度,即通过蒸发水达到的最低温度。 |
precipitation |
历史降水概率和过去一小时累积的降水量。 |
air_ |
历史气压状况。 |
wind |
历史风况。 |
visibility |
历史可见度。 |
ice_ |
历史冰层厚度。 |
is_ |
如果此小时数介于当地日出(包括)和日落(不包括)之间,则返回 true。否则,则为夜间(日落到次日日出之间)。注意:如果相应时间段与当地日出和日落时间相交,则此小时将被视为白天或夜晚(例如:如果相应时间段为凌晨 5 点到凌晨 6 点,而日出时间为凌晨 5:59,则 is_daytime 将为 true)。 |
relative_ |
历史相对湿度百分比(值介于 0 到 100 之间)。 |
uv_ |
历史紫外线 (UV) 指数。 |
thunderstorm_ |
历史雷暴概率(值介于 0 到 100 之间)。 |
cloud_ |
天空被云覆盖的历史百分比(值介于 0 到 100 之间)。 |
IceThickness
表示冰层厚度条件。
字段 | |
---|---|
unit |
表示用于衡量冰层厚度的单位的代码。 |
thickness |
冰层厚度值。 |
单位
表示用于衡量冰层厚度的单位。
枚举 | |
---|---|
UNIT_UNSPECIFIED |
未指定单位。 |
MILLIMETERS |
厚度以毫米为单位。 |
INCHES |
厚度以英寸为单位。 |
LookupCurrentConditionsRequest
对 LookupCurrentConditions RPC 的请求。
字段 | |
---|---|
location |
必需。要获取当前天气状况的位置。 |
units_ |
可选。用于返回的天气状况的单位制。如果未提供,则返回的天气状况将采用公制单位(默认值 = METRIC)。 |
language_ |
可选。允许客户端选择响应的语言。如果无法为该语言提供数据,该 API 会使用最接近的匹配项。允许的值取决于 IETF BCP-47 标准。默认值为“en”。 |
LookupCurrentConditionsResponse
LookupCurrentConditions RPC 的响应 - 表示所请求位置的当前天气状况。
字段 | |
---|---|
current_ |
与返回的数据关联的当前时间 (UTC)。 |
time_ |
请求地点的时区。 |
weather_ |
当前天气状况。 |
temperature |
当前温度。 |
feels_ |
衡量所请求地点当前温度体感的测量值。 |
dew_ |
当前温度。 |
heat_ |
当前的酷热指数温度。 |
wind_ |
当前的冷风寒度,即皮肤暴露在外的空气温度。 |
precipitation |
当前降水概率和过去一小时累积降水量。 |
air_ |
当前气压状况。 |
wind |
当前的风况。 |
visibility |
当前的公开范围。 |
current_ |
过去 24 小时内当前状况的变化。 |
is_ |
如果请求地点的当前时间介于当地日出(包括)和日落(不包括)时间之间,则为 true。否则,则为夜间(日落到次日日出之间)。 |
relative_ |
当前的相对湿度百分比(值介于 0 到 100 之间)。 |
uv_ |
当前的紫外线 (UV) 指数。 |
thunderstorm_ |
当前的雷暴概率(值介于 0 到 100 之间)。 |
cloud_ |
天空被云层覆盖的当前百分比(值介于 0 到 100 之间)。 |
CurrentConditionsHistory
表示过去 24 小时内当前状况的一组变化。
字段 | |
---|---|
temperature_ |
当前温度减去 24 小时前的温度。 |
max_ |
过去 24 小时内的最高温度。 |
min_ |
过去 24 小时内的最低温度。 |
qpf |
过去 24 小时累积的降水量(雨或雪),以等同于液态水的量表示。注意:QPF 是“定量降水预报”的缩写(如需了解详情,请参阅 QuantitativePrecipitationForecast 定义)。 |
LookupForecastDaysRequest
对 LookupForecastDays RPC 的请求。
字段 | |
---|---|
location |
必需。要获取其每日天气预报的地点。 |
units_ |
可选。用于返回的天气状况的单位制。如果未提供,则返回的天气状况将采用公制单位(默认值 = METRIC)。 |
page_ |
可选。每页返回的每日预报记录数上限 - 值介于 1 到 10(包括这两个数值)之间。该默认值为 5。 |
page_ |
可选。从上一个请求接收的页面令牌。用于检索后续页面。 |
days |
可选。限制从当前日期开始要提取的天数总量,值介于 1 到 10(包括这两个数值)之间。默认值为允许的最大值 10。 |
language_ |
可选。允许客户端选择响应的语言。如果无法为该语言提供数据,该 API 会使用最接近的匹配项。允许的值取决于 IETF BCP-47 标准。默认值为“en”。 |
LookupForecastDaysResponse
LookupForecastDays RPC 的响应。
字段 | |
---|---|
forecast_ |
每日预报记录,根据请求中指定的天数和页面大小。 |
time_ |
请求地点的时区。 |
next_ |
用于检索下一页的令牌。 |
LookupForecastHoursRequest
对 LookupForecastHours RPC 的请求。
字段 | |
---|---|
location |
必需。要获取其每小时天气预报的位置。 |
units_ |
可选。用于返回的天气状况的单位制。如果未提供,则返回的天气状况将采用公制单位(默认值 = METRIC)。 |
page_ |
可选。每页返回的小时预报记录数上限 - 值介于 1 到 24(包括这两个数值)之间。默认值为 24(允许的最大值)。 |
page_ |
可选。从上一个请求接收的页面令牌。用于检索后续页面。 |
hours |
可选。限制从当前小时开始要提取的总小时数 - 值介于 1 到 240(包括这两个数值)之间。默认值为 240(允许的最大值)。 |
language_ |
可选。允许客户端选择响应的语言。如果无法为该语言提供数据,该 API 会使用最接近的匹配项。允许的值取决于 IETF BCP-47 标准。默认值为“en”。 |
LookupForecastHoursResponse
LookupForecastHours RPC 的响应。
字段 | |
---|---|
forecast_ |
每小时天气预报记录,具体取决于请求中指定的时长和页面大小。 |
time_ |
请求地点的时区。 |
next_ |
用于检索下一页的令牌。 |
LookupHistoryHoursRequest
对 LookupHistoryHours RPC 的请求。
字段 | |
---|---|
location |
必需。要获取每小时历史数据的位置。 |
units_ |
可选。用于返回的天气状况的单位制。如果未提供,则返回的天气状况将采用公制单位(默认值 = METRIC)。 |
page_ |
可选。每页返回的小时历史记录的数量上限 - 值介于 1 到 24(包括这两个数值)之间。默认值为 24(允许的最大值)。 |
page_ |
可选。从上一个请求接收的页面令牌。用于检索后续页面。 |
hours |
可选。限制从上一个小时开始要提取的总小时数,范围为 1 到 24(包括这两个数值)。默认值为 24(允许的最大值)。 |
language_ |
可选。允许客户端选择响应的语言。如果无法为该语言提供数据,该 API 会使用最接近的匹配项。允许的值取决于 IETF BCP-47 标准。默认值为“en”。 |
LookupHistoryHoursResponse
LookupHistoryHours RPC 的响应。
字段 | |
---|---|
history_ |
按小时显示的历史记录,具体取决于请求中指定的时长和页面大小。 |
time_ |
请求地点的时区。 |
next_ |
用于检索下一页的令牌。 |
MoonEvents
表示与月亮相关的事件(例如月出、月落)。
字段 | |
---|---|
moonrise_ |
月亮的上弦出现在地平线之上的时间(请参阅 https://en.wikipedia.org/wiki/Moonrise_and_moonset))。 注意:在大多数情况下,每天只有一次月出时间。在其他情况下,列表可能为空(例如,月亮在次日午夜之后升起时)。不过,在特殊情况下(例如在极地地区),列表中可能包含多个值。在这些情况下,值会按升序排序。 |
moonset_ |
月亮上弦消失在地平线以下的时间(请参阅 https://en.wikipedia.org/wiki/Moonrise_and_moonset)。 注意:在大多数情况下,每天只有一次月落时间。在其他情况下,列表可能为空(例如,月亮在次日午夜之后落下时)。不过,在特殊情况下(例如在极地地区),列表中可能包含多个值。在这些情况下,值会按升序排列。 |
moon_ |
月相(也称为阴历月相)。 |
MoonPhase
标记月相(也称为阴历月相)。
枚举 | |
---|---|
MOON_PHASE_UNSPECIFIED |
未指定月相。 |
NEW_MOON |
月球未被太阳照亮。 |
WAXING_CRESCENT |
在北半球,月亮的右侧亮度为 0%-50% 🌒;在南半球,月亮的左侧亮度为 0%-50% 🌘。 |
FIRST_QUARTER |
在北半球,月亮的右侧被照亮了 50.1%;在南半球,月亮的左侧被照亮了 50.1% 🌓🌗。 |
WAXING_GIBBOUS |
在北半球,月亮的右侧会亮起 50%-100% 的光芒 🌔;在南半球,月亮的左侧会亮起 50%-100% 的光芒 🌖。 |
FULL_MOON |
月亮是满月的。 |
WANING_GIBBOUS |
在北半球,月亮的左侧亮度为 50%-100% 🌖;在南半球,月亮的右侧亮度为 50%-100% 🌔。 |
LAST_QUARTER |
在北半球,月亮的左侧被照亮了 50.1%;在南半球,月亮的右侧被照亮了 50.1% 🌗🌓。 |
WANING_CRESCENT |
在北半球,月亮的左侧亮度为 0%-50% 🌘;在南半球,月亮的右侧亮度为 0%-50% 🌒。 |
降水
表示指定地点的一组降水量值。
字段 | |
---|---|
probability |
降水概率(值介于 0 到 100 之间)。 |
qpf |
一段时间内累积的降水量(雨或雪),以等同于液态水的量来衡量。注意:QPF 是“定量降水预报”的缩写(如需了解详情,请参阅 QuantitativePrecipitationForecast 定义)。 |
PrecipitationProbability
表示给定地点的降水概率。
字段 | |
---|---|
type |
用于指示降水类型的代码。 |
percent |
一个介于 0 到 100 之间的百分比,表示降水几率。 |
PrecipitationType
表示给定地点的降水类型。
枚举 | |
---|---|
PRECIPITATION_TYPE_UNSPECIFIED |
未指定降水类型。 |
NONE |
无降水。 |
SNOW |
降雪。 |
RAIN |
降雨量。 |
LIGHT_RAIN |
小雨。 |
HEAVY_RAIN |
暴雨。 |
RAIN_AND_SNOW |
同时有雨和雪。 |
SLEET |
冻雨。 |
FREEZING_RAIN |
冻雨降水。 |
QuantitativePrecipitationForecast
表示指定区域在指定时间段内累积的预期融雪量(参考:https://en.wikipedia.org/wiki/Quantitative_precipitation_forecast)- 通常简写为 QPF。
字段 | |
---|---|
unit |
用于衡量累计降水量的单位的代码。 |
quantity |
一段时间内累积的降水量(以等同于液态水的量表示)。 |
单位
表示用于衡量累计降水量的单位。
枚举 | |
---|---|
UNIT_UNSPECIFIED |
未指定降水量单位。 |
MILLIMETERS |
降水量以毫米为单位。 |
INCHES |
降雨量以英寸为单位。 |
SpeedUnit
表示用于衡量速度的单位。
枚举 | |
---|---|
SPEED_UNIT_UNSPECIFIED |
速度单位未指定。 |
KILOMETERS_PER_HOUR |
速度以每小时公里为单位。 |
MILES_PER_HOUR |
速度以每小时英里为单位。 |
SunEvents
表示与太阳相关的事件(例如日出、日落)。
字段 | |
---|---|
sunrise_ |
日出时间。 注意:在某些特殊情况下(例如北极圈以北),一天可能没有日出时间。在这些情况下,此字段将处于未设置状态。 |
sunset_ |
日落时间。 注意:在某些特殊情况下(例如北极圈以北),一天内可能没有日落时间。在这些情况下,此字段将处于未设置状态。 |
温度
表示温度值。
字段 | |
---|---|
unit |
用于衡量温度值的单位的代码。 |
degrees |
温度值(以指定单位为度)。 |
TemperatureUnit
表示用于测量温度的单位。
枚举 | |
---|---|
TEMPERATURE_UNIT_UNSPECIFIED |
温度单位未指定。 |
CELSIUS |
温度以摄氏度为单位。 |
FAHRENHEIT |
温度以华氏度为单位。 |
UnitsSystem
表示用于衡量值的单位制。
枚举 | |
---|---|
UNITS_SYSTEM_UNSPECIFIED |
未指定单位制。 |
IMPERIAL |
英制单位系统(例如华氏度、英里等)。 |
METRIC |
公制单位系统(例如摄氏度、公里等)。 |
公开范围
表示能见度条件,即能辨别物体的距离。
字段 | |
---|---|
unit |
表示用于衡量距离的单位的代码。 |
distance |
可见距离(以指定单位表示)。 |
单位
表示用于衡量可见度距离的单位。
枚举 | |
---|---|
UNIT_UNSPECIFIED |
未指定公开范围单位。 |
KILOMETERS |
可见度以公里为单位。 |
MILES |
可见度以英里为单位。 |
WeatherCondition
表示给定地点在给定时间段内的天气状况。
免责声明:天气图标和天气状况代码可能会发生变化。Google 可能会根据需要推出新代码和图标,或更新现有代码和图标。建议您定期参阅本文档,了解最新信息。
字段 | |
---|---|
icon_ |
图标的基础 URI(不包括文件类型扩展名)。如需显示图标,请将主题(如有)和文件类型扩展名( |
description |
此天气状况的文字说明(本地化)。 |
type |
天气状况的类型。 |
类型
标记预报元素上下文中的天气状况类型。
枚举 | |
---|---|
TYPE_UNSPECIFIED |
天气状况未指定。 |
CLEAR |
无云。 |
MOSTLY_CLEAR |
有时有云。 |
PARTLY_CLOUDY |
局部多云(有云)。 |
MOSTLY_CLOUDY |
大部多云(云量多于阳光)。 |
CLOUDY |
多云(全是云,没有太阳)。 |
WINDY |
大风。 |
WIND_AND_RAIN |
大风伴有降水。 |
LIGHT_RAIN_SHOWERS |
间歇性小雨。 |
CHANCE_OF_SHOWERS |
有间歇性降雨的可能性。 |
SCATTERED_SHOWERS |
间歇性降雨。 |
RAIN_SHOWERS |
阵雨被视为比雨水持续时间更短的降雨,其特点是开始和停止时间突然,强度快速变化。 |
HEAVY_RAIN_SHOWERS |
强阵雨。 |
LIGHT_TO_MODERATE_RAIN |
雨(小到中雨)。 |
MODERATE_TO_HEAVY_RAIN |
雨(中到大雨)。 |
RAIN |
中雨。 |
LIGHT_RAIN |
小雨。 |
HEAVY_RAIN |
大雨。 |
RAIN_PERIODICALLY_HEAVY |
雨,偶有大雨。 |
LIGHT_SNOW_SHOWERS |
短时间内以不同强度降落的轻雪。 |
CHANCE_OF_SNOW_SHOWERS |
或有阵雪。 |
SCATTERED_SNOW_SHOWERS |
雪花在短时间内以不同强度飘落。 |
SNOW_SHOWERS |
阵雪。 |
HEAVY_SNOW_SHOWERS |
强阵雪。 |
LIGHT_TO_MODERATE_SNOW |
小到中雪。 |
MODERATE_TO_HEAVY_SNOW |
中到大雪。 |
SNOW |
中雪。 |
LIGHT_SNOW |
小雪。 |
HEAVY_SNOW |
大雪。 |
SNOWSTORM |
有雪,可能伴有雷电。 |
SNOW_PERIODICALLY_HEAVY |
雪,有时大雪。 |
HEAVY_SNOW_STORM |
大雪,可能伴有雷电。 |
BLOWING_SNOW |
有雪,风力强劲。 |
RAIN_AND_SNOW |
雨夹雪。 |
HAIL |
您好! |
HAIL_SHOWERS |
冰雹在短时间内以不同强度落下。 |
THUNDERSTORM |
雷暴。 |
THUNDERSHOWER |
伴有雷电的阵雨。 |
LIGHT_THUNDERSTORM_RAIN |
轻度雷暴夹雨。 |
SCATTERED_THUNDERSTORMS |
雷暴,短时间内有不同强度的降雨。 |
HEAVY_THUNDERSTORM |
强雷暴。 |
WIND
表示一组风速属性。
字段 | |
---|---|
direction |
风向,即风吹来的角度。 |
speed |
风速。 |
gust |
阵风(风速突然增加)。 |
WindDirection
表示风的起源方向。
字段 | |
---|---|
cardinal |
表示风吹来的方位角的代码。 |
degrees |
风向(以度为单位,值介于 0 到 360 之间)。 |
WindSpeed
表示风速。
字段 | |
---|---|
unit |
表示用于衡量风速的单位的代码。 |
value |
风速的值。 |