此页面由 Cloud Translation API 翻译。

Package google.maps.weather.v1

索引

Weather（接口）
AirPressure（消息）
CardinalDirection（枚举）
Certainty（枚举）
DataSource（消息）
ForecastDay（消息）
ForecastDayPart（消息）
ForecastHour（消息）
HistoryHour（消息）
IceThickness（消息）
IceThickness.Unit（枚举）
LookupCurrentConditionsRequest（消息）
LookupCurrentConditionsResponse（消息）
LookupCurrentConditionsResponse.CurrentConditionsHistory（消息）
LookupForecastDaysRequest（消息）
LookupForecastDaysResponse（消息）
LookupForecastHoursRequest（消息）
LookupForecastHoursResponse（消息）
LookupHistoryHoursRequest（消息）
LookupHistoryHoursResponse（消息）
LookupPublicAlertsRequest（消息）
LookupPublicAlertsResponse（消息）
MoonEvents（消息）
MoonPhase（枚举）
Precipitation（消息）
PrecipitationProbability（消息）
PrecipitationType（枚举）
PublicAlerts（消息）
Publisher（枚举）
QuantitativePrecipitationForecast（消息）
QuantitativePrecipitationForecast.Unit（枚举）
SafetyRecommendation（消息）
Severity（枚举）
SpeedUnit（枚举）
SunEvents（消息）
Temperature（消息）
TemperatureUnit（枚举）
UnitsSystem（枚举）
Urgency（枚举）
Visibility（消息）
Visibility.Unit（枚举）
WeatherCondition（消息）
WeatherCondition.Type（枚举）
WeatherEventType（枚举）
Wind（消息）
WindDirection（消息）
WindSpeed（消息）

天气

天气 API 的服务定义。

LookupCurrentConditions

LookupCurrentConditions
`rpc LookupCurrentConditions(LookupCurrentConditionsRequest) returns (LookupCurrentConditionsResponse)` 返回指定地点的当前天气状况。授权范围需要以下 OAuth 范围： `https://www.googleapis.com/auth/cloud-platform`

rpc LookupCurrentConditions(LookupCurrentConditionsRequest) returns (LookupCurrentConditionsResponse)

返回指定地点的当前天气状况。

授权范围

需要以下 OAuth 范围：

https://www.googleapis.com/auth/cloud-platform

LookupForecastDays

LookupForecastDays
`rpc LookupForecastDays(LookupForecastDaysRequest) returns (LookupForecastDaysResponse)` 返回指定位置从当天开始最多 10 天的每日天气预报。授权范围需要以下 OAuth 范围： `https://www.googleapis.com/auth/cloud-platform`

rpc LookupForecastDays(LookupForecastDaysRequest) returns (LookupForecastDaysResponse)

返回指定位置从当天开始最多 10 天的每日天气预报。

授权范围

需要以下 OAuth 范围：

https://www.googleapis.com/auth/cloud-platform

LookupForecastHours

LookupForecastHours
`rpc LookupForecastHours(LookupForecastHoursRequest) returns (LookupForecastHoursResponse)` 返回指定位置从当前小时开始的最多 240 小时的每小时预报。授权范围需要以下 OAuth 范围： `https://www.googleapis.com/auth/cloud-platform`

rpc LookupForecastHours(LookupForecastHoursRequest) returns (LookupForecastHoursResponse)

返回指定位置从当前小时开始的最多 240 小时的每小时预报。

授权范围

需要以下 OAuth 范围：

https://www.googleapis.com/auth/cloud-platform

LookupHistoryHours

LookupHistoryHours
`rpc LookupHistoryHours(LookupHistoryHoursRequest) returns (LookupHistoryHoursResponse)` 返回指定位置最多 24 小时的每小时历史天气数据，从最后一小时开始。授权范围需要以下 OAuth 范围： `https://www.googleapis.com/auth/cloud-platform`

rpc LookupHistoryHours(LookupHistoryHoursRequest) returns (LookupHistoryHoursResponse)

返回指定位置最多 24 小时的每小时历史天气数据，从最后一小时开始。

授权范围

需要以下 OAuth 范围：

https://www.googleapis.com/auth/cloud-platform

LookupPublicAlerts

LookupPublicAlerts
`rpc LookupPublicAlerts(LookupPublicAlertsRequest) returns (LookupPublicAlertsResponse)` 返回指定地点的公开天气警报。授权范围需要以下 OAuth 范围： `https://www.googleapis.com/auth/cloud-platform`

rpc LookupPublicAlerts(LookupPublicAlertsRequest) returns (LookupPublicAlertsResponse)

返回指定地点的公开天气警报。

授权范围

需要以下 OAuth 范围：

https://www.googleapis.com/auth/cloud-platform

AirPressure

表示大气气压条件。

字段

字段
`mean_sea_level_millibars`	`float` 平均海平面气压（以毫巴为单位）。

mean_sea_level_millibars

float

平均海平面气压（以毫巴为单位）。

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`	次级方位，指西北偏北。

确定性

表示警报消息的主题事件的确定性的代码。

枚举
`CERTAINTY_UNKNOWN`	确定性未知。
`OBSERVED`	确定已发生或正在发生。
`VERY_LIKELY`	很有可能。
`LIKELY`	可能性高（p > ~50%）。
`POSSIBLE`	可能，但不太可能（p <= ~50%）。
`UNLIKELY`	不太可能（p ~ 0%）。

DataSource

表示指向数据源的链接。

字段

字段
`publisher`	`Publisher` 提醒的发布者。
`name`	`string` 官方发布商名称。请注意，虽然此字段应进行本地化，但无法保证一定能实现本地化。
`authority_uri`	`string` 相应机构网站的网址。

publisher

Publisher

提醒的发布者。

name

string

官方发布商名称。请注意，虽然此字段应进行本地化，但无法保证一定能实现本地化。

authority_uri

string

相应机构网站的网址。

ForecastDay

表示给定位置的每日天气预报记录。

字段
`interval`	`Interval` 相应预测日期的开始时间（含）和结束时间（不含）所对应的世界协调时间 (UTC) 区间。注意：一天从早上 7 点开始，到第二天早上 7 点结束（当地时间）。例如：如果本地时区为 UTC-7，则间隔将从时间 `14:00:00.000Z` 开始，并在第二天同一小时结束。
`display_date`	`Date` 计算相应每日天气预报时所用的位置（民用时间）的本地日期。此字段可能用于在客户端上显示。
`daytime_forecast`	`ForecastDayPart` 白天（当地时间上午 7 点至晚上 7 点）的预测天气状况。
`nighttime_forecast`	`ForecastDayPart` 一天中夜间部分（当地时间下午 7 点至次日上午 7 点）的预测天气状况。
`max_temperature`	`Temperature` 全天的最高温度。
`min_temperature`	`Temperature` 全天的最低温度。
`feels_like_max_temperature`	`Temperature` 全天的最高（高）体感温度。
`feels_like_min_temperature`	`Temperature` 全天的最低（低）体感温度。
`max_heat_index`	`Temperature` 全天的最高暑热指数温度。
`sun_events`	`SunEvents` 与太阳相关的事件（例如日出、日落）。
`moon_events`	`MoonEvents` 与月亮相关的事件（例如月升、月落）。

ForecastDayPart

表示一天中某个时间段的预测记录。

字段
`interval`	`Interval` 相应时段开始（含）和结束（不含）的世界协调时间 (UTC) 日期和时间。注意：部分天数是指从早上 7 点到当天晚上 7 点（当地时间）的时间段。例如，如果本地时区为 UTC-7，则白天时间段将从时间 `14:00:00.000Z` 开始，到第二天 `02:00:00.000Z` 结束；夜间时间段将从第二天 `02:00:00.000Z` 开始，到当天 `14:00:00.000Z` 结束。
`weather_condition`	`WeatherCondition` 预测的天气状况。
`precipitation`	`Precipitation` 预测降水量。
`wind`	`Wind` 平均风向以及最大风速和阵风。
`ice_thickness`	`IceThickness` 一天中某个时段的累计结冰量。
`relative_humidity`	`int32` 预测的相对湿度百分比（值介于 0 到 100 之间）。
`uv_index`	`int32` 预测的最高紫外线 (UV) 指数。
`thunderstorm_probability`	`int32` 平均雷暴概率。
`cloud_cover`	`int32` 平均云覆盖率百分比。

ForecastHour

表示给定位置的小时天气预报记录。

字段
`interval`	`Interval` 相应天气预报数据的有效时间段（以世界协调时间 [UTC] 表示，时间戳会向下舍入到最接近的小时）。
`display_date_time`	`DateTime` 计算相应小时天气预报时所用的位置的时区中的当地日期和时间（民用时间）。此字段可能用于在客户端上显示。注意：此日期将包含年、月、日、小时和与世界协调时间 (UTC) 的偏移量。
`weather_condition`	`WeatherCondition` 预测的天气状况。
`temperature`	`Temperature` 预测温度。
`feels_like_temperature`	`Temperature` 所请求位置的体感温度。
`dew_point`	`Temperature` 预测的温度。
`heat_index`	`Temperature` 预测的酷热指数温度。
`wind_chill`	`Temperature` 预测的风寒指数，即暴露在皮肤上的空气温度。
`wet_bulb_temperature`	`Temperature` 预测的湿球温度，即通过蒸发水可达到的最低温度。
`precipitation`	`Precipitation` 预测的降水概率和过去 1 小时内累积的降水量。
`air_pressure`	`AirPressure` 预测的气压状况。
`wind`	`Wind` 预测的风况。
`visibility`	`Visibility` 预测的公开范围。
`ice_thickness`	`IceThickness` 预测的冰层厚度。
`is_daytime`	`bool` 如果相应小时介于当地日出时间（含）和日落时间（不含）之间，则返回 True。否则，为夜间（日落和下一次日出之间）。注意：如果相应时间段与当地日出和日落时间分别相交，则相应小时将被视为白天或夜晚（例如：如果时间段为上午 5 点到 6 点，而日出时间为上午 5:59，则 is_daytime 将为 true）。
`relative_humidity`	`int32` 预测的相对湿度百分比（值介于 0 到 100 之间）。
`uv_index`	`int32` 预测的紫外线 (UV) 指数。
`thunderstorm_probability`	`int32` 雷暴预报概率（值介于 0 到 100 之间）。
`cloud_cover`	`int32` 云层覆盖天空的预测百分比（值介于 0 到 100 之间）。

HistoryHour

表示给定位置的每小时历史记录。

字段
`interval`	`Interval` 相应历史数据的有效时间区间（以世界协调时间 [UTC] 表示，时间戳会向下舍入到最接近的小时）。
`display_date_time`	`DateTime` 相应位置（民用时间）的时区中计算相应每小时记录的本地日期和时间。此字段可能用于在客户端上显示。注意：此日期将包含年、月、日、小时和与世界协调时间 (UTC) 的偏移量。
`weather_condition`	`WeatherCondition` 历史天气状况。
`temperature`	`Temperature` 历史温度。
`feels_like_temperature`	`Temperature` 所请求位置的体感温度。
`dew_point`	`Temperature` 历史温度。
`heat_index`	`Temperature` 历史酷热指数温度。
`wind_chill`	`Temperature` 历史风寒指数，即暴露在皮肤上的气温。
`wet_bulb_temperature`	`Temperature` 历史湿球温度，即通过蒸发水可达到的最低温度。
`precipitation`	`Precipitation` 过去 1 小时内的历史降水概率和累计降水量。
`air_pressure`	`AirPressure` 历史气压条件。
`wind`	`Wind` 历史风况。
`visibility`	`Visibility` 历史可见度。
`ice_thickness`	`IceThickness` 历史冰厚度。
`is_daytime`	`bool` 如果相应小时介于当地日出时间（含）和日落时间（不含）之间，则返回 True。否则，为夜间（日落和下一次日出之间）。注意：如果相应时间段与当地日出和日落时间分别相交，则相应小时将被视为白天或夜晚（例如：如果时间段为上午 5 点到 6 点，而日出时间为上午 5:59，则 is_daytime 将为 true）。
`relative_humidity`	`int32` 历史相对湿度百分比（值介于 0 到 100 之间）。
`uv_index`	`int32` 历史紫外线 (UV) 指数。
`thunderstorm_probability`	`int32` 历史雷暴概率（值介于 0 到 100 之间）。
`cloud_cover`	`int32` 历史上云层覆盖天空的百分比（值介于 0 到 100 之间）。

IceThickness

表示冰层厚度情况。

字段

字段
`unit`	`Unit` 表示用于测量冰层厚度的单位的代码。
`thickness`	`float` 冰层厚度值。

unit

Unit

表示用于测量冰层厚度的单位的代码。

thickness

float

冰层厚度值。

单位

表示用于测量冰层厚度的单位。

枚举
`UNIT_UNSPECIFIED`	未指定单位。
`MILLIMETERS`	厚度以毫米为单位。
`INCHES`	厚度以英寸为单位。

LookupCurrentConditionsRequest

针对 LookupCurrentConditions RPC 的请求。

字段

字段
`location`	`LatLng` 必需。要获取当前天气状况的位置。
`units_system`	`UnitsSystem` 可选。用于返回天气状况的单位系统。如果未提供，返回的天气状况将采用公制单位（默认 = METRIC）。
`language_code`	`string` 可选。允许客户端选择回答的语言。如果无法提供相应语言的数据，API 会使用最接近的匹配项。允许的值取决于 IETF BCP-47 标准。默认值为“en”。

location

LatLng

必需。要获取当前天气状况的位置。

units_system

UnitsSystem

可选。用于返回天气状况的单位系统。如果未提供，返回的天气状况将采用公制单位（默认 = METRIC）。

language_code

string

可选。允许客户端选择回答的语言。如果无法提供相应语言的数据，API 会使用最接近的匹配项。允许的值取决于 IETF BCP-47 标准。默认值为“en”。

LookupCurrentConditionsResponse

针对 LookupCurrentConditions RPC 的响应 - 表示所请求位置的当前天气状况。

字段
`current_time`	`Timestamp` 与返回的数据相关联的当前时间（世界协调时间）。
`time_zone`	`TimeZone` 所请求位置的时区。
`weather_condition`	`WeatherCondition` 当前天气状况。
`temperature`	`Temperature` 当前温度。
`feels_like_temperature`	`Temperature` 所请求位置的当前体感温度。
`dew_point`	`Temperature` 当前温度。
`heat_index`	`Temperature` 当前的酷热指数温度。
`wind_chill`	`Temperature` 当前风寒效应，即暴露在皮肤上的空气温度。
`precipitation`	`Precipitation` 当前降水概率和过去 1 小时内累积的降水量。
`air_pressure`	`AirPressure` 当前气压条件。
`wind`	`Wind` 当前风况。
`visibility`	`Visibility` 当前公开范围。
`current_conditions_history`	`CurrentConditionsHistory` 过去 24 小时内当前状况的变化。
`is_daytime`	`bool` 如果所请求位置的当前时间介于当地日出时间（含）和日落时间（不含）之间，则为 True。否则，为夜间（日落和下一次日出之间）。
`relative_humidity`	`int32` 当前相对湿度百分比（值介于 0 到 100 之间）。
`uv_index`	`int32` 当前紫外线 (UV) 指数。
`thunderstorm_probability`	`int32` 当前雷暴概率（值介于 0 到 100 之间）。
`cloud_cover`	`int32` 当前云层覆盖天空的百分比（值介于 0 到 100 之间）。

CurrentConditionsHistory

表示过去 24 小时内当前条件的一组变化。

字段
`temperature_change`	`Temperature` 当前温度减去 24 小时前的温度。
`max_temperature`	`Temperature` 过去 24 小时内的最高温度。
`min_temperature`	`Temperature` 过去 24 小时内的最低温度。
`snow_qpf`	`QuantitativePrecipitationForecast` 过去 24 小时内累积的降雪量（以等效液态水衡量）。注意：QPF 是定量降水预报的缩写（请参阅 QuantitativePrecipitationForecast 定义了解详情）。
`qpf`	`QuantitativePrecipitationForecast` 过去 24 小时内累积的降雨量（以液态水当量衡量）。注意：QPF 是定量降水预报的缩写（请参阅 QuantitativePrecipitationForecast 定义了解详情）。

LookupForecastDaysRequest

对 LookupForecastDays RPC 的请求。

字段
`location`	`LatLng` 必需。要获取每日预报的位置。
`units_system`	`UnitsSystem` 可选。用于返回天气状况的单位系统。如果未提供，返回的天气状况将采用公制单位（默认 = METRIC）。
`page_size`	`int32` 可选。每页要返回的每日天气预报记录数上限 - 一个介于 1 到 10（含）之间的值。该默认值为 5。
`page_token`	`string` 可选。从上一个请求收到的页面令牌。用于检索后续页面。
`days`	`int32` 可选。限制要提取的总天数（从当前日期开始）- 值介于 1 到 10 之间（含边界值）。默认值为允许的最大值 10。
`language_code`	`string` 可选。允许客户端选择回答的语言。如果无法提供相应语言的数据，API 会使用最接近的匹配项。允许的值取决于 IETF BCP-47 标准。默认值为“en”。

LookupForecastDaysResponse

针对 LookupForecastDays RPC 的响应。

字段

字段
`forecast_days[]`	`ForecastDay` 根据请求中指定的天数和页面大小，每日的预测记录。
`time_zone`	`TimeZone` 所请求位置的时区。
`next_page_token`	`string` 用于检索下一页的令牌。

forecast_days[]

ForecastDay

根据请求中指定的天数和页面大小，每日的预测记录。

time_zone

TimeZone

所请求位置的时区。

next_page_token

string

用于检索下一页的令牌。

LookupForecastHoursRequest

对 LookupForecastHours RPC 的请求。

字段
`location`	`LatLng` 必需。要获取每小时天气预报的位置。
`units_system`	`UnitsSystem` 可选。用于返回天气状况的单位系统。如果未提供，返回的天气状况将采用公制单位（默认 = METRIC）。
`page_size`	`int32` 可选。每页返回的小时天气预报记录数上限 - 值介于 1 到 24（含）之间。默认值为允许的最大值 24。
`page_token`	`string` 可选。从上一个请求收到的页面令牌。用于检索后续页面。
`hours`	`int32` 可选。限制要提取的总小时数（从当前小时开始）- 值介于 1 到 240（含）之间。默认值为允许的最大值 240。
`language_code`	`string` 可选。允许客户端选择回答的语言。如果无法提供相应语言的数据，API 会使用最接近的匹配项。允许的值取决于 IETF BCP-47 标准。默认值为“en”。

LookupForecastHoursResponse

针对 LookupForecastHours RPC 的响应。

字段

字段
`forecast_hours[]`	`ForecastHour` 根据请求中指定的小时数和页面大小，每小时的预报记录。
`time_zone`	`TimeZone` 所请求位置的时区。
`next_page_token`	`string` 用于检索下一页的令牌。

forecast_hours[]

ForecastHour

根据请求中指定的小时数和页面大小，每小时的预报记录。

time_zone

TimeZone

所请求位置的时区。

next_page_token

string

用于检索下一页的令牌。

LookupHistoryHoursRequest

针对 LookupHistoryHours RPC 的请求。

字段
`location`	`LatLng` 必需。要获取每小时历史数据的位置。
`units_system`	`UnitsSystem` 可选。用于返回天气状况的单位系统。如果未提供，返回的天气状况将采用公制单位（默认 = METRIC）。
`page_size`	`int32` 可选。每页返回的小时历史记录数上限 - 一个介于 1 到 24（含）之间的值。默认值为允许的最大值 24。
`page_token`	`string` 可选。从上一个请求收到的页面令牌。用于检索后续页面。
`hours`	`int32` 可选。限制要提取的总小时数（从最后一小时开始）- 从 1 到 24（含）。默认值为允许的最大值 24。
`language_code`	`string` 可选。允许客户端选择回答的语言。如果无法提供相应语言的数据，API 会使用最接近的匹配项。允许的值取决于 IETF BCP-47 标准。默认值为“en”。

LookupHistoryHoursResponse

针对 LookupHistoryHours RPC 的响应。

字段

字段
`history_hours[]`	`HistoryHour` 根据请求中指定的小时数和页面大小，每小时的历史记录。
`time_zone`	`TimeZone` 所请求位置的时区。
`next_page_token`	`string` 用于检索下一页的令牌。

history_hours[]

HistoryHour

根据请求中指定的小时数和页面大小，每小时的历史记录。

time_zone

TimeZone

所请求位置的时区。

next_page_token

string

用于检索下一页的令牌。

LookupPublicAlertsRequest

对 LookupPublicAlerts RPC 的请求。

字段
`location`	`LatLng` 必需。要接收公共天气警报的位置。该服务将返回受影响区域与此位置相交的提醒。
`page_size`	`int32` 可选。每页返回的公共天气警报记录数上限。
`page_token`	`string` 可选。从之前的 `LookupPublicAlerts` 调用接收的页面令牌。利用其进行后续页面检索。进行分页时，提供给 `LookupPublicAlerts` 的所有其他参数必须与提供页面令牌的调用相一致。
`language_code`	`string` 可选。允许客户端选择回答的语言。如果无法提供相应语言的数据，API 会使用最接近的匹配项。允许的值取决于 IETF BCP-47 标准。默认值为“en”。

LookupPublicAlertsResponse

针对 LookupPublicAlerts RPC 的响应。

字段

字段
`weather_alerts[]`	`PublicAlerts` 根据请求中指定的提醒数量和页面大小，返回公开天气预警记录。
`region_code`	`string` 与请求中提供的位置对应的地区的 ISO_3166-1 alpha-2 代码。地区使用 ISO_3166-1_alpha-2 表示。
`next_page_token`	`string` 可作为 `page_token` 发送并用于检索下一页的令牌。如果省略此字段，则不存在后续页面。

weather_alerts[]

PublicAlerts

根据请求中指定的提醒数量和页面大小，返回公开天气预警记录。

region_code

string

与请求中提供的位置对应的地区的 ISO_3166-1 alpha-2 代码。地区使用 ISO_3166-1_alpha-2 表示。

next_page_token

string

可作为 page_token 发送并用于检索下一页的令牌。如果省略此字段，则不存在后续页面。

MoonEvents

表示与月亮相关的事件（例如月升、月落）。

字段

字段
`moonrise_times[]`	`Timestamp` 月球上肢出现在地平线上的时间（请参阅 https://en.wikipedia.org/wiki/Moonrise_and_moonset)）。注意：在大多数情况下，每天只有一个月升时间。在其他情况下，该列表可能为空（例如，当月亮在第二天午夜之后升起时）。不过，在特殊情况下（例如在极地地区），该列表可能包含多个值。在这些情况下，值按升序排序。
`moonset_times[]`	`Timestamp` 月球上缘消失在地平线以下的时间（请参阅 https://en.wikipedia.org/wiki/Moonrise_and_moonset)）。注意：在大多数情况下，每天只有一个月落时间。在其他情况下，该列表可能为空（例如，当月亮在次日午夜之后落下时）。不过，在特殊情况下（例如在极地地区），该列表可能包含多个值。在这些情况下，值按升序排序。
`moon_phase`	`MoonPhase` 月相。

moonrise_times[]

Timestamp

月球上肢出现在地平线上的时间（请参阅 https://en.wikipedia.org/wiki/Moonrise_and_moonset)）。

注意：在大多数情况下，每天只有一个月升时间。在其他情况下，该列表可能为空（例如，当月亮在第二天午夜之后升起时）。不过，在特殊情况下（例如在极地地区），该列表可能包含多个值。在这些情况下，值按升序排序。

moonset_times[]

Timestamp

月球上缘消失在地平线以下的时间（请参阅 https://en.wikipedia.org/wiki/Moonrise_and_moonset)）。

注意：在大多数情况下，每天只有一个月落时间。在其他情况下，该列表可能为空（例如，当月亮在次日午夜之后落下时）。不过，在特殊情况下（例如在极地地区），该列表可能包含多个值。在这些情况下，值按升序排序。

moon_phase

MoonPhase

月相。

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`	`PrecipitationProbability` 降水概率（值介于 0 到 100 之间）。
`snow_qpf`	`QuantitativePrecipitationForecast` 一段时间内累积的降雪量（以等效液态水衡量）。注意：QPF 是定量降水预报的缩写（请参阅 QuantitativePrecipitationForecast 定义了解详情）。
`qpf`	`QuantitativePrecipitationForecast` 在一段时间内累积的降雨量（以等效液态水衡量）。注意：QPF 是定量降水预报的缩写（请参阅 QuantitativePrecipitationForecast 定义了解详情）。

probability

PrecipitationProbability

降水概率（值介于 0 到 100 之间）。

snow_qpf

QuantitativePrecipitationForecast

一段时间内累积的降雪量（以等效液态水衡量）。注意：QPF 是定量降水预报的缩写（请参阅 QuantitativePrecipitationForecast 定义了解详情）。

qpf

QuantitativePrecipitationForecast

在一段时间内累积的降雨量（以等效液态水衡量）。注意：QPF 是定量降水预报的缩写（请参阅 QuantitativePrecipitationForecast 定义了解详情）。

PrecipitationProbability

表示指定位置的降水概率。

字段

字段
`type`	`PrecipitationType` 用于指示降水类型的代码。
`percent`	`int32` 一个介于 0 到 100 之间的百分比，表示降水概率。

type

PrecipitationType

用于指示降水类型的代码。

percent

int32

一个介于 0 到 100 之间的百分比，表示降水概率。

PrecipitationType

表示给定位置的降水类型。

枚举
`PRECIPITATION_TYPE_UNSPECIFIED`	未指定降水类型。
`NONE`	无降水。
`SNOW`	降雪。
`RAIN`	降雨。
`LIGHT_RAIN`	小雨降水。
`HEAVY_RAIN`	大雨降水。
`RAIN_AND_SNOW`	降雨和降雪。
`SLEET`	冻雨降水。
`FREEZING_RAIN`	冻雨降水。

PublicAlerts

表示公共天气警报。

字段
`alert_id`	`string` 相应提醒的唯一标识符。
`alert_title`	`LocalizedText` 提醒的本地化标题。
`event_type`	`WeatherEventType` 天气事件的类型。
`area_name`	`string` 发布提醒的区域的名称。
`instruction[]`	`string` 发布商推荐的说明。请注意，虽然此字段应进行本地化，但无法保证一定能实现本地化。
`safety_recommendations[]`	`SafetyRecommendation` 向用户提供的安全建议指令，这些指令可由发布商或其他权威机构提供。
`timezone_offset`	`string` 相应提醒所在位置相对于世界协调时间 (UTC) 的时区偏移量。该值的格式为以“s”结尾的字符串，例如 “-14400s”表示比 UTC 晚 4 小时。
`start_time`	`Timestamp` 活动的开始时间。
`expiration_time`	`Timestamp` 活动的到期时间。
`data_source`	`DataSource` 发布相应提醒的出版商的详细信息。
`polygon`	`string` 发布提醒的区域的 GeoJSON 表示法。 GeoJSON 数据必须采用 RFC 7946 格式，并且表示多边形（对于单个连续区域）或多重多边形（对于多个不同的区域）。示例： { "type": "Polygon", "coordinates": [ [ [-1, -1], [-1, 0], [0, 0], [-1, -1] ] ] } MultiPolygon GeoJson 字符串的示例如下所示： { "type": "MultiPolygon", "coordinates": [ [ [0, 0], [-1, 0], [-1, 1], [0, 0] ], [ [0, 0], [-2, 0], [-2, 2], [0, 0] ] ]
`description`	`string` 由官方机构发布的最新提醒说明文本。请注意，虽然此字段应进行本地化，但无法保证一定能实现本地化。
`severity`	`Severity` 提醒的严重程度。
`certainty`	`Certainty` 提醒的确定性。
`urgency`	`Urgency` 提醒的紧急程度。

发布商

提醒的发布者。

枚举
`PUBLISHER_UNSPECIFIED`	发布商未指定。
`AUSTRALIA_ACT_ESA`	澳大利亚澳大利亚首都领地
`AUSTRALIA_NSW_RFS`	新南威尔士
`AUSTRALIA_QLD_QFES`	昆士兰州
`AUSTRALIA_SA_CFS`	南澳大利亚
`METEO_ALARM_AT`	Meteoalarm / EUMETNET Austria
`METEO_ALARM_BS`	波斯尼亚
`BRAZIL_CENAD`	巴西灾难机构（巴西）
`BRAZIL_INMET`	巴西气象机构
`UK_ENV_AGENCY`	英国
`METEO_ALARM_BG`	Meteoalarm / EUMETNET Bulgaria
`METEO_ALARM_CR`	克罗地亚
`METEO_ALARM_CY`	塞浦路斯
`METEO_ALARM_CS`	捷克
`METEO_ALARM_DK`	丹麦
`EC_INAMHI`	厄瓜多尔
`METEO_ALARM_FI`	Meteoalarm / EUMETNET Finland
`METEO_ALARM_FR`	法国
`DE_DWD`	德国
`METEO_ALARM_GB`	Meteoalarm / EUMETNET 英国
`METEO_ALARM_GR`	希腊
`METEO_ALARM_HU`	匈牙利
`METEO_ALARM_IS`	冰岛
`METEO_ALARM_IE`	爱尔兰
`METEO_ALARM_IT`	意大利
`JM_JMS`	牙买加
`JMA`	日本
`METEO_ALARM_NL`	Meteoalarm / EUMETNET 荷兰
`METEO_ALARM_LV`	拉脱维亚
`METEO_ALARM_LT`	立陶宛
`METEO_ALARM_LU`	卢森堡
`MEXICO_CIRES`	墨西哥墨西哥 CIRES
`NZ_GEONET`	新西兰新西兰 GeoNet
`NZ_NMS`	MetService
`METEO_ALARM_MK`	Meteoalarm / EUMETNET 北马其顿
`METEO_ALARM_NO`	挪威
`PHILIPPINES_PAGASA`	菲律宾
`METEO_ALARM_PL`	Meteoalarm / EUMETNET 波兰
`METEO_ALARM_PT`	葡萄牙
`METEO_ALARM_RO`	罗马尼亚
`METEO_ALARM_RS`	塞尔维亚
`SG_MSS`	新加坡
`METEO_ALARM_SK`	Meteoalarm / EUMETNET 斯洛伐克
`METEO_ALARM_SI`	斯洛文尼亚
`SB_MET`	所罗门群岛
`METEO_ALARM_ES`	Meteoalarm / EUMETNET 西班牙
`METEO_ALARM_SE`	瑞典
`METEO_ALARM_CH`	瑞士
`TAIWAN_NCDR`	台湾
`NOAA`	美国国家海洋和大气管理局 (NOAA)
`WCATWC`	国家海啸预警中心

QuantitativePrecipitationForecast

表示在指定时间段内指定区域内累积的预期融化降水量（参考：https://en.wikipedia.org/wiki/Quantitative_precipitation_forecast）- 通常简称为 QPF。

字段

字段
`unit`	`Unit` 用于衡量累积降水量的单位的代码。
`quantity`	`float` 在一段时间内累积的降水量，以液态水当量来衡量。

unit

Unit

用于衡量累积降水量的单位的代码。

quantity

float

在一段时间内累积的降水量，以液态水当量来衡量。

单位

表示用于衡量累积降水量的单位。

枚举
`UNIT_UNSPECIFIED`	未指定降水单位。
`MILLIMETERS`	降水量以毫米为单位。
`INCHES`	降水量以英寸为单位。

SafetyRecommendation

表示安全建议。

字段

字段
`directive`	`string` 面向用户的指令。请注意，虽然此字段应进行本地化，但无法保证一定能实现本地化。
`subtext`	`string` 指令的可选子文本，可能包含用户的其他背景信息。请注意，虽然此字段应进行本地化，但无法保证一定能实现本地化。

directive

string

面向用户的指令。请注意，虽然此字段应进行本地化，但无法保证一定能实现本地化。

subtext

string

指令的可选子文本，可能包含用户的其他背景信息。请注意，虽然此字段应进行本地化，但无法保证一定能实现本地化。

严重程度

表示警报消息的主题事件严重程度的代码。

枚举
`SEVERITY_UNKNOWN`	严重程度未知。
`EXTREME`	生命或财产面临非同寻常的威胁。
`SEVERE`	生命或财产受到严重威胁。
`MODERATE`	可能会危及生命或财产。
`MINOR`	生命或财产受到轻微威胁。

SpeedUnit

表示用于测量速度的单位。

枚举
`SPEED_UNIT_UNSPECIFIED`	未指定速度单位。
`KILOMETERS_PER_HOUR`	速度以每小时多少公里为单位。
`MILES_PER_HOUR`	速度以每小时英里数为单位。

SunEvents

表示与太阳相关的事件（例如日出、日落）。

字段

字段
`sunrise_time`	`Timestamp` 日出时间。注意：在某些特殊情况下（例如北极圈以北），某一天可能没有日出时间。在这些情况下，此字段将处于未设置状态。
`sunset_time`	`Timestamp` 日落时间。注意：在某些特殊情况下（例如北极圈以北），一天可能没有日落时间。在这些情况下，此字段将处于未设置状态。

sunrise_time

Timestamp

日出时间。

注意：在某些特殊情况下（例如北极圈以北），某一天可能没有日出时间。在这些情况下，此字段将处于未设置状态。

sunset_time

Timestamp

日落时间。

注意：在某些特殊情况下（例如北极圈以北），一天可能没有日落时间。在这些情况下，此字段将处于未设置状态。

温度

表示温度值。

字段

字段
`unit`	`TemperatureUnit` 用于衡量温度值的单位的代码。
`degrees`	`float` 指定单位的温度值（以度为单位）。

unit

TemperatureUnit

用于衡量温度值的单位的代码。

degrees

float

指定单位的温度值（以度为单位）。

TemperatureUnit

表示用于测量温度的单位。

枚举
`TEMPERATURE_UNIT_UNSPECIFIED`	未指定温度单位。
`CELSIUS`	温度以摄氏度为单位。
`FAHRENHEIT`	温度以华氏度为单位。

UnitsSystem

表示用于衡量值的单位制。

枚举
`UNITS_SYSTEM_UNSPECIFIED`	未指定单位制。
`IMPERIAL`	英制单位系统（例如华氏度、英里等）。
`METRIC`	公制单位系统（例如摄氏度、公里等）。

紧急情况

表示警报消息的主题事件的紧急程度的代码。

枚举
`URGENCY_UNKNOWN`	紧急程度未知。
`IMMEDIATE`	应立即采取响应措施。
`EXPECTED`	应尽快（在下一小时内）采取响应措施。
`FUTURE`	应在不久的将来采取响应措施。
`PAST`	不再需要采取响应措施。

公开范围

表示能见度条件，即能够辨别物体的距离。

字段

字段
`unit`	`Unit` 表示用于测量距离的单位的代码。
`distance`	`float` 指定单位的能见度距离。

unit

Unit

表示用于测量距离的单位的代码。

distance

float

指定单位的能见度距离。

单位

表示用于衡量能见度距离的单位。

枚举
`UNIT_UNSPECIFIED`	未指定可见性单位。
`KILOMETERS`	能见度以公里为单位。
`MILES`	能见度以英里为单位。

WeatherCondition

表示指定时间段内指定地点的天气状况。

免责声明：天气图标和天气状况代码可能会发生变化。Google 可能会根据需要推出新代码和图标，或更新现有代码和图标。建议您定期参阅此文档，了解最新信息。

字段

字段
`icon_base_uri`	`string` 图标的基础 URI，不包括文件类型扩展名。如需显示图标，请根据需要将主题和文件类型扩展名（`.png` 或 `.svg`）附加到此 URI。默认情况下，图标采用浅色主题，但可以附加 `_dark` 以用于深色模式。例如：“https://maps.gstatic.com/weather/v1/dust.svg”或“https://maps.gstatic.com/weather/v1/dust_dark.svg”，其中 `icon_base_uri` 为“https://maps.gstatic.com/weather/v1/dust”。
`description`	`LocalizedText` 相应天气状况的文字说明（已本地化）。
`type`	`Type` 天气状况的类型。

icon_base_uri

string

图标的基础 URI，不包括文件类型扩展名。如需显示图标，请根据需要将主题和文件类型扩展名（.png 或 .svg）附加到此 URI。默认情况下，图标采用浅色主题，但可以附加 _dark 以用于深色模式。例如：“https://maps.gstatic.com/weather/v1/dust.svg”或“https://maps.gstatic.com/weather/v1/dust_dark.svg”，其中 icon_base_uri 为“https://maps.gstatic.com/weather/v1/dust”。

description

LocalizedText

相应天气状况的文字说明（已本地化）。

type

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.
`HAIL_SHOWERS`	在短时间内以不同强度降落的冰雹。
`THUNDERSTORM`	雷暴。
`THUNDERSHOWER`	伴有雷电的阵雨。
`LIGHT_THUNDERSTORM_RAIN`	轻度雷暴夹雨。
`SCATTERED_THUNDERSTORMS`	短时间内降雨强度不一的雷暴。
`HEAVY_THUNDERSTORM`	强雷暴。

WeatherEventType

天气事件的类型。

枚举
`WEATHER_EVENT_TYPE_UNSPECIFIED`	未指定天气事件类型。
`ACID_RAIN`	酸雨事件。
`AFTERSHOCK`	余震事件。
`AVALANCHE`	雪崩事件。
`BLIZZARD`	暴风雪事件。
`BLOWING_SNOW`	高吹雪事件。
`BUSHFIRE`	森林大火事件。
`COASTAL_FLOOD`	沿海洪水事件。
`COASTAL_HAZARD`	沿海灾害事件。
`COLD`	冷事件。
`CYCLONE`	旋风事件。
`DROUGHT`	干旱事件。
`DUST_STORM`	沙尘暴事件。
`EARTHQUAKE`	地震事件。
`EXTRATROPICAL_CYCLONE`	温带气旋事件。
`FIRE`	触发事件。
`FIRE_WEATHER`	火险天气事件。
`FLASH_FLOOD`	山洪暴发事件。
`FLOOD`	洪水事件。
`FOG`	雾事件。
`FREEZING`	死机事件。
`FREEZING_AIR_TEMPERATURE`	空气温度降至冰点事件。
`FREEZING_DRIZZLE`	冻毛毛雨事件。
`FREEZING_RAIN_EVENT`	冻雨事件。
`FROST`	霜冻事件。
`GALE`	大风事件。
`GLAZE`	釉面活动。
`HAIL`	冰雹事件。
`HAZARDOUS_SEAS`	灾害性海浪事件。
`HEAT`	热浪事件。
`HUMIDITY`	湿度事件。
`HURRICANE`	飓风事件。
`ICE_STORM`	冰暴事件。
`INDUSTRIAL_FIRE`	工业火灾事件。
`LAKE_EFFECT_SNOW`	湖泊效应降雪事件。
`LANDSLIDE`	滑坡事件。
`MONSOON`	季风事件。
`MUDDY_FLOOD`	泥石流事件。
`OUTFLOW`	流出事件。
`RADIATION`	辐射事件。
`RAIN_EVENT`	降雨事件。
`RIVER_FLOODING`	河流洪灾事件。
`SEVERE_THUNDERSTORM_WARNING`	严重雷暴警报事件。
`SNOWSQUALL`	暴风雪事件。
`SNOW_EVENT`	降雪事件。
`STORM`	风暴事件。
`STORM_SURGE`	风暴潮事件。
`THUNDER`	雷声事件。
`THUNDERSTORM`	雷暴事件。
`TORNADO`	龙卷风事件。
`TORNADO_WARNING`	龙卷风警报事件。
`TROPICAL_CYCLONE`	热带气旋事件。
`TROPICAL_CYCLONE_WARNINGS_AND_WATCHES`	热带气旋警告和警戒事件。
`TROPICAL_DISTURBANCE`	热带扰动事件。
`TROPICAL_STORM`	热带风暴事件。
`TSUNAMI`	海啸事件。
`TYPHOON`	台风事件。
`VOLCANIC_ASH`	火山灰事件。
`VOLCANIC_ERUPTION`	火山喷发事件。
`WILDFIRE`	野火事件。
`WIND`	风事件。
`WIND_CHILL`	风寒效应事件。
`WIND_WAVE`	风浪事件。
`WINTER_STORM`	冬季风暴事件。

Wind

表示一组风属性。

字段

字段
`direction`	`WindDirection` 风向，风从哪个角度吹来。
`speed`	`WindSpeed` 风速。
`gust`	`WindSpeed` 阵风（风速突然增大）。

direction

WindDirection

风向，风从哪个角度吹来。

speed

WindSpeed

风速。

gust

WindSpeed

阵风（风速突然增大）。

WindDirection

表示风的来向。

字段

字段
`cardinal`	`CardinalDirection` 表示风向的基数方向的代码。
`degrees`	`int32` 风向（以度为单位，值介于 0 到 360 之间）。

cardinal

CardinalDirection

表示风向的基数方向的代码。

degrees

int32

风向（以度为单位，值介于 0 到 360 之间）。

WindSpeed

表示风速。

字段

unit

SpeedUnit

表示用于测量风速的单位的代码。

value

float

风速值。

Package google.maps.weather.v1 使用集合让一切井井有条 根据您的偏好保存内容并对其进行分类。

索引

天气

AirPressure

CardinalDirection

确定性

DataSource

ForecastDay

ForecastDayPart

ForecastHour

HistoryHour

IceThickness

单位

LookupCurrentConditionsRequest

LookupCurrentConditionsResponse

CurrentConditionsHistory

LookupForecastDaysRequest

LookupForecastDaysResponse

LookupForecastHoursRequest

LookupForecastHoursResponse

LookupHistoryHoursRequest

LookupHistoryHoursResponse

LookupPublicAlertsRequest

LookupPublicAlertsResponse

MoonEvents

MoonPhase

降水概率

PrecipitationProbability

PrecipitationType

PublicAlerts

发布商

QuantitativePrecipitationForecast

单位

SafetyRecommendation

严重程度

SpeedUnit

SunEvents

温度

TemperatureUnit

UnitsSystem

紧急情况

公开范围

单位

WeatherCondition

类型

WeatherEventType

Wind

WindDirection

WindSpeed

Package google.maps.weather.v1