Package google.maps.weather.v1

索引

天气

Weather API 的服务定义。

LookupCurrentConditions

rpc LookupCurrentConditions(LookupCurrentConditionsRequest) returns (LookupCurrentConditionsResponse)

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

授权范围

需要以下 OAuth 范围:

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

rpc LookupForecastDays(LookupForecastDaysRequest) returns (LookupForecastDaysResponse)

返回指定地点(从当天开始)最多 10 天的每日预报。

授权范围

需要以下 OAuth 范围:

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

rpc LookupForecastHours(LookupForecastHoursRequest) returns (LookupForecastHoursResponse)

返回指定地点(从当前小时开始)最多 240 小时的每小时预报。

授权范围

需要以下 OAuth 范围:

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

rpc LookupHistoryHours(LookupHistoryHoursRequest) returns (LookupHistoryHoursResponse)

返回给定地点(从过去一小时开始)最多 24 小时的每小时历史天气数据。

授权范围

需要以下 OAuth 范围:

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

AirPressure

表示大气气压条件。

字段
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 北西辅助方位。

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

与月亮相关的事件(例如月出、月落)。

ice_thickness

IceThickness

一整天累计的冰量。

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

平均风向、最大风速和阵风。

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

预测的降水概率和过去一小时累计降水量。

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

历史降水概率和过去一小时累积的降水量。

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_UNSPECIFIED 未指定单位。
MILLIMETERS 厚度以毫米为单位。
INCHES 厚度以英寸为单位。

LookupCurrentConditionsRequest

对 LookupCurrentConditions RPC 的请求。

字段
location

LatLng

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

units_system

UnitsSystem

可选。用于返回的天气状况的单位制。如果未提供,则返回的天气状况将采用公制单位(默认值 = METRIC)。

language_code

string

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

LookupCurrentConditionsResponse

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

字段
current_time

Timestamp

与返回的数据关联的当前时间 (UTC)。

time_zone

TimeZone

请求地点的时区。

weather_condition

WeatherCondition

当前天气状况。

temperature

Temperature

当前温度。

feels_like_temperature

Temperature

衡量所请求地点当前温度体感的测量值。

dew_point

Temperature

当前温度。

heat_index

Temperature

当前的酷热指数温度。

wind_chill

Temperature

当前的冷风寒度,即皮肤暴露在外的空气温度。

precipitation

Precipitation

当前降水概率和过去一小时累积降水量。

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 小时内的最低温度。

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

用于检索下一页的令牌。

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

用于检索下一页的令牌。

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

用于检索下一页的令牌。

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

月相(也称为阴历月相)。

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 之间)。

qpf

QuantitativePrecipitationForecast

一段时间内累积的降水量(雨或雪),以等同于液态水的量来衡量。注意:QPF 是“定量降水预报”的缩写(如需了解详情,请参阅 QuantitativePrecipitationForecast 定义)。

PrecipitationProbability

表示给定地点的降水概率。

字段
type

PrecipitationType

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

percent

int32

一个介于 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

Unit

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

quantity

float

一段时间内累积的降水量(以等同于液态水的量表示)。

单位

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

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

SpeedUnit

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

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

SunEvents

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

字段
sunrise_time

Timestamp

日出时间。

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

sunset_time

Timestamp

日落时间。

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

温度

表示温度值。

字段
unit

TemperatureUnit

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

degrees

float

温度值(以指定单位为度)。

TemperatureUnit

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

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

UnitsSystem

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

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

公开范围

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

字段
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

天气状况的类型。

类型

标记预报元素上下文中的天气状况类型。

枚举
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

WindDirection

风向,即风吹来的角度。

speed

WindSpeed

风速。

gust

WindSpeed

阵风(风速突然增加)。

WindDirection

表示风的起源方向。

字段
cardinal

CardinalDirection

表示风吹来的方位角的代码。

degrees

int32

风向(以度为单位,值介于 0 到 360 之间)。

WindSpeed

表示风速。

字段
unit

SpeedUnit

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

value

float

风速的值。