MCP Tools Reference: mapstools.googleapis.com

ツール: lookup_weather

天気、大気質(AQI と汚染物質)、花粉(木、草、雑草、植物種のアレルゲン レベル)など、ある場所の包括的な環境情報を取得します。天気と大気質については、現在の状況、1 時間ごとの予測 / 履歴、日別の予測を取得できます。花粉については、日別の予測のみを取得できます(今日から 4 日後まで。1 時間ごとのデータや過去のデータはありません)。利用可能な環境ドメインと機能(capabilities: WEATHER、AIR_QUALITY、POLLEN - 重要): * 明示的な選択が必須: すべての呼び出しで、capabilities に WEATHER、AIR_QUALITY、POLLEN のいずれかを必ず含める必要があります。capabilities を省略することはできません。* 広範 / 曖昧な屋外に関するクエリ(完全な屋外環境スイート): ユーザーが特定のドメインに限定せずに、屋外、旅行、状況に関する一般的な質問をした場合(例: 「今、ランニングをするのに屋外の状況はどうですか?」)、3 つの機能すべてを明示的に含め(capabilities: ["WEATHER", "AIR_QUALITY", "POLLEN"])、完全な屋外環境スイート(天気 + 大気質 + 花粉)を返します。過去の date / hour の場合は、履歴がない POLLEN を除外します。* 対象ドメインの選択(特定のクエリ): ユーザーが 1 つまたは 2 つのドメインのみを具体的にリクエストした場合(例: 「シアトルの現在の AQI はリアルタイムでどうなっていますか?」)、リクエストされた機能(WEATHER、AIR_QUALITY、POLLEN)のみを含めます。リクエストされたドメインのみが実行され、返されます。ドメインごとに利用可能な特定のデータ: * 天気(weather): 気温(現在、体感、最高 / 最低、熱指数)、風(風速、突風、風向)、天体イベント(日の出 / 日の入り、月相)、降水量(種類、確率、量 / QPF)、大気条件(UV 指数、湿度、雲量、雷雨確率、気圧)。* 大気質(air_quality): 世界および地域の大気質指数(AQI 値、カテゴリ、主要な汚染物質)、7 つの感受性グループにわたる健康に関する推奨事項、汚染物質濃度(include_pollutant_concentration: true)。各指数には独自の主要な汚染物質があります。指数ごとに報告してください(例: 米国の AQI に世界の AQI の汚染物質を指定しないでください)。* 花粉(pollen): 樹木、草、雑草のカテゴリ別、植物種別の 1 日のユニバーサル花粉指数(UPI、0 ~ 5)(index.value とその index.category、例: 1 = 「非常に低い」)、シーズン中のステータス、交差反応、健康に関する推奨事項。* 花粉フィールドがない: in_season がない場合は、季節外れであることを意味します。index なしで返された植物種は、ユーザーがその植物について尋ねた場合を除き、省略します。その場合は、その植物の花粉データは今日報告されていないことを伝えます(レベルを推測しないでください)。場所のルール(重要): 対象地域は、次の oneof サブフィールドのいずれか 1 つのみを使用して location で指定する必要があります。1. 地理座標(lat_lng): * 正確な緯度 / 経度座標がわかっている場合に使用します。* 例: {"location": {"lat_lng": {"latitude": 34.0522, "longitude": -118.2437}}} 2. プレイス ID(place_id): * 明確な Google マップのプレイス ID(search_places または resolve_names から取得したものなど)。* 例: {"location": {"place_id": "ChIJLU7jZClu5kcR4PcOOO6p3I0"}} 3. 住所文字列(address): * 市区町村 / 地域、近隣地域、ランドマーク、スポット、番地、郵便番号。市区町村 / 国も指定することをおすすめします。* 例: {"location": {"address": "Paris, France"}} 時間と使用モード(date と hour - 重要): * 現地タイムゾーンの参照: すべての date({year, month, day})と hour(0-23)の入力は、リクエストされた location の現地常用タイムゾーン(例: "Paris tomorrow at 13:00" のクエリでは Europe/Paris の現地の日付と時間 13 を使用)で表す必要があります。UTC や呼び出し元のタイムゾーンは使用しないでください。* 1. 現在の状況(date と hour を省略): * location とターゲット capabilities(WEATHER、AIR_QUALITY、POLLEN)を指定します。date または hour は指定しないでください。* リクエストされたドメインのリアルタイムの現在の状況(CC)(現在の天気、現在の時間の大気質、今日の花粉予報)を返します。* 大気質の場合、現在の状況は 1 時間単位です。今日全体の大気質や屋外に関する一般的な質問に回答する場合は、これだけを使用しないでください(以下の日次クエリを使用してください)。* 2. 1 時間ごとの天気予報 / 履歴(date と hour を指定 0-23): * location、date({year, month, day})、hour(0-23)、ターゲット capabilities を指定します。分単位で記載されている場合は、最も近い時間に切り捨てます。* 重要な制約(hour が設定されている場合、date は必須): date を指定せずに hour を指定する(date を省略し、hour を設定する)ことは許可されていません。エラーが発生します。ユーザーが今日の特定の時間(例: "at 13:00 today")について尋ねている場合でも、date(今日の location)と hour の両方を入力する必要があります。* YYYY-MM-DD-HH でリクエストされた天気や大気質を 1 時間ごとに検索し、YYYY-MM-DD でリクエストされた花粉を 1 日ごとに検索します。* 天気に関する「いつ」の質問: いつ / 何時 / 最適な時間を尋ねる天気に関する質問(例: "what time will it stop raining?")の場合、該当する時間帯について 1 時間ごとの WEATHER 呼び出し(date + hour)を使用します。1 日の天気予報には 1 時間ごとの値はありません。屋外での活動全般に関する「いつ / 最適な時間」の質問(例: "when is the best time to go walking today?")については、1 日のクエリで説明されている大気質(および花粉)の 1 日全体の呼び出しに加えて、1 時間ごとの WEATHER 呼び出しを行います。* 3. 1 日のクエリ(date を指定し、hour を省略): * location、date(リクエストされた location の現地時間での {year, month, day})を hour なしで指定し、1 日のクエリのターゲット capabilities(例: "weather and pollen in London tomorrow")を指定します。 * 今日の大気質と屋外に関する一般的な質問: 大気質に関する質問と、今日に関する屋外に関する一般的な質問(大気質を含む)(例: "how will the air quality change today"、"is today a good day for a picnic?")の場合、date を今日の location の日付(時間は省略)に設定して、その日の 1 時間ごとの大気質シリーズを取得します。現在の状況の呼び出しだけでは、現在の時間の大気質しか返されないため、十分ではありません。ユーザーが「現在」についても尋ねている場合は、追加できます。* 大気質の時間枠: 1 日の時間枠("air quality between noon and 6 PM" など)に関する大気質の質問については、個々の時間をサンプリングするのではなく、その日付の 1 回の Daily 呼び出しを優先し、大気質シリーズから時間枠の時間を読み取ります。1 時間ごとに電話をかける場合は、時間枠のすべての時間帯をカバーします。* リクエストされた天気や花粉の日次予測と、その日の 1 時間ごとの大気質シリーズを、現地時間の 1 日全体(現地時間の 00:00 ~ 23:00)にわたって返します。過去の日付の場合は 24 時間の履歴、将来の日付の場合は 24 時間の予測、今日の場合はそれ以前の時間(履歴)、現在の時間、残りの時間(予測)を返します。ドメイン別のサポート対象期間: * 天気: 24 時間前から 240 時間(10 日)先までの 1 時間単位(過去の時間には date と hour の両方が必要)。今日を含む 10 日先(今日から 9 日後まで)までの 1 日単位。1 日単位の履歴はなし。* Air Quality: 720 時間(30 日)前から 96 時間(4 日)後までの 1 時間単位。1 日全体の呼び出しは、この期間内に収まる必要があります(実際には、今日から 29 日前から 3 日後まで)。* 花粉: 1 日単位のみ、今日から 4 日後まで(今日を含めて 5 日間)。過去の日付は含まれず、hour は無視されます。* (注: 複数の機能がリクエストされ、date/hour がそのいずれかの範囲外にある場合でも、呼び出しは成功し、サポートされている機能のみが返されます。)* 範囲外のリクエスト: リクエストされた日付または時間が上記のドメインのサポート範囲外である可能性がある場合(過去の日付の花粉など)でも、リクエストされた日付 / 時間に対して lookup_weather を呼び出します。エラーにはサポート範囲が示されます。代わりに別の日付、時間、ドメインを呼び出さないでください。ドメイン オプションとアトリビューション: * 言語(language_code): 省略可能な BCP-47 言語コード(例: "fr")。デフォルトは "en" です。* 天気情報の単位(weather_options.units_system または units_system): デフォルトは METRIC です。お客様が米国標準を暗示している場合、またはインペリアル単位を明示的にリクエストしている場合は、IMPERIAL(華氏 / mph)に設定します。weather_options.units_system(推奨)と最上位の units_system の両方でサポートされています。両方を指定する場合は、競合しないようにする必要があります。* 大気質オプション(air_quality_options): 特定の汚染物質濃度(PM2.5、PM10、O3、NO2、SO2、CO)が必要な場合は include_pollutant_concentration: true を設定します。必要に応じて、index_region_code(2 文字の ISO 国コード、例: "US")を設定して、特定の地域の AQI スケールをリクエストします。デフォルトでは、レスポンスにはユニバーサル AQI とその場所の地域 AQI が含まれます。* 帰属表示: グラウンディングされた出力は、返された各ドメイン コンテナ(weather.attribution、air_quality.attribution、pollen.attribution)内の attribution フィールドを使用して、ソースに帰属させる必要があります。* 返される時刻: Air Quality の date_time 値は、すでにその場所の現地時間(utc_offset を含む)になっているため、そのまま表示します。天気 date_time(現在と 1 時間ごと)と日の出 / 日の入りの時刻は UTC です。time_zone を使用して、その場所の現地時間に変換します。すべての時刻を現地時間としてラベル付けします。

次のコードサンプルは、curl を使用して lookup_weather MCP ツールを呼び出す方法を示しています。

Curl リクエスト
curl --location 'https://mapstools.googleapis.com/mcp' \
--header 'content-type: application/json' \
--header 'accept: application/json, text/event-stream' \
--data '{
  "method": "tools/call",
  "params": {
    "name": "lookup_weather",
    "arguments": {
      // Provide these details according to the MCP tool specification.
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

入力スキーマ

LookupWeather メソッドのリクエスト。リクエストされた場所の気象条件を表します。

LookupWeatherRequest

JSON 表現
{
  "unitsSystem": enum (UnitsSystem),
  "location": {
    object (Location)
  },
  "capabilities": [
    enum (Capability)
  ],

  // Union field _date can be only one of the following:
  "date": {
    object (Date)
  }
  // End of list of possible types for union field _date.

  // Union field _hour can be only one of the following:
  "hour": integer
  // End of list of possible types for union field _hour.

  // Union field _language_code can be only one of the following:
  "languageCode": string
  // End of list of possible types for union field _language_code.

  // Union field _weather_options can be only one of the following:
  "weatherOptions": {
    object (WeatherOptions)
  }
  // End of list of possible types for union field _weather_options.

  // Union field _air_quality_options can be only one of the following:
  "airQualityOptions": {
    object (AirQualityOptions)
  }
  // End of list of possible types for union field _air_quality_options.
}
フィールド
unitsSystem

enum (UnitsSystem)

省略可。返される気象条件に使用する単位系。指定しない場合、返される気象条件はメートル法になります(デフォルト = METRIC)。

location

object (Location)

必須。気象状況を取得する場所。

capabilities[]

enum (Capability)

省略可。レスポンスに含める環境機能。

共用体フィールド _date。

_date は次のいずれかになります。

date

object (Date)

省略可。リクエストされた環境情報の、location フィールドで指定された場所のローカル タイムゾーンを基準とした日付を指定します。サポートされる期間は、リクエストされた機能によって異なります。- WEATHER: 過去 24 時間(hour も設定されている場合)から将来 10 日間(240 時間)(日次予測の場合は今日から +9 日間)。- AIR_QUALITY: 過去 30 日間(720 時間)まで、将来 4 日間(96 時間)まで。- POLLEN: 今日から +4 日(今日を含めて最大 5 日。過去の日付はサポートされていません)。

共用体フィールド _hour。

_hour は次のいずれかになります。

hour

integer

省略可。リクエストされた環境情報の時間を、location フィールドで指定された場所のローカル タイムゾーンを基準として 24 時間形式(0 ~ 23)で指定します。date を指定する必要があります。サポートされる時間範囲は、リクエストされた機能によって異なります。- WEATHER: 過去 24 時間、将来 240 時間(10 日間)。- AIR_QUALITY: 過去 30 日間(720 時間)まで、将来 4 日間(96 時間)まで。- POLLEN: 日次予測のみを返します。hour は花粉データでは無視されます。

共用体フィールド _language_code。

_language_code は次のいずれかになります。

languageCode

string

省略可。レスポンス内のローカライズされたテキストの BCP-47 言語コード(「en」、「ja」、「fr-CA」など)。指定しない場合のデフォルトは「en」です。

共用体フィールド _weather_options。

_weather_options は次のいずれかになります。

weatherOptions

object (WeatherOptions)

省略可。天気リクエストに固有のオプション。weather_options.units_system は、既存の呼び出し元との下位互換性を維持するために、最上位の units_system(タグ 4)と連携してサポートされています。両方で競合する単位系が指定されている場合は、INVALID_ARGUMENT を返します。capabilities で WEATHER がリクエストされていない場合は無視されます。

共用体フィールド _air_quality_options。

_air_quality_options は次のいずれかになります。

airQualityOptions

object (AirQualityOptions)

省略可。大気質リクエストに固有のオプション。capabilities で AIR_QUALITY がリクエストされていない場合は無視されます。

日付

JSON 表現
{
  "year": integer,
  "month": integer,
  "day": integer
}
フィールド
year

integer

その日付の年。1~9999、または年のない日付を指定する場合は 0 にする必要があります。

month

integer

1 年の中の月。1~12、または月と日のない年を指定する場合は 0 にする必要があります。

day

integer

1 月の中の日付。1~31 で、その年と月で有効な値にする必要があります。または、日が重要でない場合は年のみか年と月を指定するには 0 にする必要があります。

ロケーション

JSON 表現
{

  // Union field location_type can be only one of the following:
  "latLng": {
    object (LatLng)
  },
  "placeId": string,
  "address": string
  // End of list of possible types for union field location_type.
}
フィールド
共用体フィールド location_type。場所を表すさまざまな方法。location_type は次のいずれかになります。
latLng

object (LatLng)

地理座標を使用して指定されたポイント。

placeId

string

ビジネスに関連付けられたプレイス ID。

address

string

人が読める形式の住所(番地、市区町村、郵便番号など)。

LatLng

JSON 表現
{
  "latitude": number,
  "longitude": number
}
フィールド
latitude

number

緯度(度単位)。範囲 [-90.0, +90.0] 内になければなりません。

longitude

number

経度(度単位)。範囲 [-180.0, +180.0] 内になければなりません。

WeatherOptions

JSON 表現
{
  "unitsSystem": enum (UnitsSystem)
}
フィールド
unitsSystem

enum (UnitsSystem)

省略可。返される気象条件に使用する単位系。指定しない場合、返される気象条件はメートル法になります(デフォルト = METRIC)。

AirQualityOptions

JSON 表現
{

  // Union field _include_pollutant_concentration can be only one of the
  // following:
  "includePollutantConcentration": boolean
  // End of list of possible types for union field
  // _include_pollutant_concentration.

  // Union field _index_region_code can be only one of the following:
  "indexRegionCode": string
  // End of list of possible types for union field _index_region_code.
}
フィールド

共用体フィールド _include_pollutant_concentration。

_include_pollutant_concentration は次のいずれかになります。

includePollutantConcentration

boolean

省略可。true の場合、大気質のレスポンスに汚染物質の詳細な濃度と追加情報(発生源と影響)が含まれます。

共用体フィールド _index_region_code。

_index_region_code は次のいずれかになります。

indexRegionCode

string

省略可。2 文字の ISO 3166-1 alpha-2 国 / 地域コード(「US」、「FR」、「CN」など)。ユニバーサル大気質指数(UAQI)とともに、優先する地域の大気質指数(AQI)スケールを選択するために使用されます。指定しない場合、デフォルトでリクエストされたロケーションのリージョンが使用されます。

UnitsSystem

値の測定に使用される単位系を表します。

列挙型
UNITS_SYSTEM_UNSPECIFIED 単位系が指定されていません。
IMPERIAL ヤードポンド法(華氏、マイルなど)。
METRIC メートル法(摂氏、キロメートルなど)。

能力

LookupWeatherRequest でリクエストできる環境機能。

列挙型
CAPABILITY_UNSPECIFIED 未指定の機能。
WEATHER 気象条件(気温、降水量、風、紫外線など)。
AIR_QUALITY 大気質情報(AQI、汚染物質、健康に関する推奨事項)。
POLLEN 花粉情報(樹木、草、雑草、植物種のアレルゲン レベル)。

出力スキーマ

LookupWeather RPC のレスポンス。リクエストされた場所の気象条件を表します。

このレスポンスは、時間単位と日単位の両方の情報を表しているため、時間単位、日単位、共有の 3 つのセクションに分かれています。Only-Hourly フィールドと Only-Daily フィールドは省略可能としてマークされています。時間単位と日単位の情報で共有されるフィールドのうち、常に存在するフィールドは省略可能としてマークされません。常に利用できるとは限らないフィールドは省略可能としてマークされます。

LookupWeatherResponse

JSON 表現
{
  "weatherCondition": {
    object (WeatherCondition)
  },
  "precipitation": {
    object (Precipitation)
  },
  "wind": {
    object (Wind)
  },
  "returnedLocation": {
    object (Location)
  },
  "attribution": {
    object (Attribution)
  },

  // Union field _temperature can be only one of the following:
  "temperature": {
    object (Temperature)
  }
  // End of list of possible types for union field _temperature.

  // Union field _feels_like_temperature can be only one of the following:
  "feelsLikeTemperature": {
    object (Temperature)
  }
  // End of list of possible types for union field _feels_like_temperature.

  // Union field _heat_index can be only one of the following:
  "heatIndex": {
    object (Temperature)
  }
  // End of list of possible types for union field _heat_index.

  // Union field _air_pressure can be only one of the following:
  "airPressure": {
    object (AirPressure)
  }
  // End of list of possible types for union field _air_pressure.

  // Union field _max_temperature can be only one of the following:
  "maxTemperature": {
    object (Temperature)
  }
  // End of list of possible types for union field _max_temperature.

  // Union field _min_temperature can be only one of the following:
  "minTemperature": {
    object (Temperature)
  }
  // End of list of possible types for union field _min_temperature.

  // Union field _feels_like_max_temperature can be only one of the following:
  "feelsLikeMaxTemperature": {
    object (Temperature)
  }
  // End of list of possible types for union field _feels_like_max_temperature.

  // Union field _feels_like_min_temperature can be only one of the following:
  "feelsLikeMinTemperature": {
    object (Temperature)
  }
  // End of list of possible types for union field _feels_like_min_temperature.

  // Union field _max_heat_index can be only one of the following:
  "maxHeatIndex": {
    object (Temperature)
  }
  // End of list of possible types for union field _max_heat_index.

  // Union field _sun_events can be only one of the following:
  "sunEvents": {
    object (SunEvents)
  }
  // End of list of possible types for union field _sun_events.

  // Union field _moon_events can be only one of the following:
  "moonEvents": {
    object (MoonEvents)
  }
  // End of list of possible types for union field _moon_events.

  // Union field _relative_humidity can be only one of the following:
  "relativeHumidity": integer
  // End of list of possible types for union field _relative_humidity.

  // Union field _uv_index can be only one of the following:
  "uvIndex": integer
  // End of list of possible types for union field _uv_index.

  // Union field _thunderstorm_probability can be only one of the following:
  "thunderstormProbability": integer
  // End of list of possible types for union field _thunderstorm_probability.

  // Union field _cloud_cover can be only one of the following:
  "cloudCover": integer
  // End of list of possible types for union field _cloud_cover.

  // Union field _weather can be only one of the following:
  "weather": {
    object (WeatherResultData)
  }
  // End of list of possible types for union field _weather.

  // Union field _air_quality can be only one of the following:
  "airQuality": {
    object (AirQualityResultData)
  }
  // End of list of possible types for union field _air_quality.

  // Union field _pollen can be only one of the following:
  "pollen": {
    object (PollenResultData)
  }
  // End of list of possible types for union field _pollen.

  // Union field _time_zone can be only one of the following:
  "timeZone": string
  // End of list of possible types for union field _time_zone.
}
フィールド
weatherCondition

object (WeatherCondition)

気象条件

precipitation

object (Precipitation)

降水確率と積算降水量

wind

object (Wind)

風の状況

returnedLocation

object (Location)

必須。天気情報が返される場所。この場所はリクエストの場所と同じですが、リクエストされた場所が、おおよその位置情報(「Mountain View, CA」など)を検索するフリーテキストの住所である場合は、異なる場合があります。

attribution

object (Attribution)

天気とともに表示する必要がある帰属表示。

共用体フィールド _temperature。

_temperature は次のいずれかになります。

temperature

object (Temperature)

1 時間ごとの気温

共用体フィールド _feels_like_temperature。

_feels_like_temperature は次のいずれかになります。

feelsLikeTemperature

object (Temperature)

1 時間ごとの体感温度。

共用体フィールド _heat_index。

_heat_index は次のいずれかになります。

heatIndex

object (Temperature)

1 時間ごとの暑さ指数。

共用体フィールド _air_pressure。

_air_pressure は次のいずれかになります。

airPressure

object (AirPressure)

1 時間ごとの気圧の状態。

共用体フィールド _max_temperature。

_max_temperature は次のいずれかになります。

maxTemperature

object (Temperature)

1 日の最高気温。

共用体フィールド _min_temperature。

_min_temperature は次のいずれかになります。

minTemperature

object (Temperature)

1 日の最低気温。

共用体フィールド _feels_like_max_temperature。

_feels_like_max_temperature は次のいずれかになります。

feelsLikeMaxTemperature

object (Temperature)

1 日の最高体感温度。

共用体フィールド _feels_like_min_temperature。

_feels_like_min_temperature は次のいずれかになります。

feelsLikeMinTemperature

object (Temperature)

1 日の最低体感温度。

共用体フィールド _max_heat_index。

_max_heat_index は次のいずれかになります。

maxHeatIndex

object (Temperature)

1 日の最高熱指数温度。

共用体フィールド _sun_events。

_sun_events は次のいずれかになります。

sunEvents

object (SunEvents)

太陽に関連するイベント(日の出、日の入りなど)。

共用体フィールド _moon_events。

_moon_events は次のいずれかになります。

moonEvents

object (MoonEvents)

月に関連するイベント(月の出、月の入りなど)。

共用体フィールド _relative_humidity。

_relative_humidity は次のいずれかになります。

relativeHumidity

integer

相対湿度の割合(0 ~ 100 の値)。

共用体フィールド _uv_index。

_uv_index は次のいずれかになります。

uvIndex

integer

最大紫外線(UV)指数。

共用体フィールド _thunderstorm_probability。

_thunderstorm_probability は次のいずれかになります。

thunderstormProbability

integer

雷雨の確率(0 ~ 100 の値)。

共用体フィールド _cloud_cover。

_cloud_cover は次のいずれかになります。

cloudCover

integer

雲に覆われた空の割合(0 ~ 100 の値)。

共用体フィールド _weather。

_weather は次のいずれかになります。

weather

object (WeatherResultData)

リクエストされた場所の気象条件。

共用体フィールド _air_quality。

_air_quality は次のいずれかになります。

airQuality

object (AirQualityResultData)

リクエストされた場所の大気質情報。

共用体フィールド _pollen。

_pollen は次のいずれかになります。

pollen

object (PollenResultData)

リクエストされた場所の花粉情報。

共用体フィールド _time_zone。

_time_zone は次のいずれかになります。

timeZone

string

場所の解決済み IANA タイムゾーン文字列(例: 「America/New_York」、「Asia/Tokyo」)。

温度

JSON 表現
{
  "unit": enum (Unit),

  // Union field _degrees can be only one of the following:
  "degrees": number
  // End of list of possible types for union field _degrees.
}
フィールド
unit

enum (Unit)

省略可。温度値の測定に使用される単位のコード。

共用体フィールド _degrees。

_degrees は次のいずれかになります。

degrees

number

指定された単位の温度値(度)。

AirPressure

JSON 表現
{

  // Union field _mean_sea_level_millibars can be only one of the following:
  "meanSeaLevelMillibars": number
  // End of list of possible types for union field _mean_sea_level_millibars.
}
フィールド

共用体フィールド _mean_sea_level_millibars。

_mean_sea_level_millibars は次のいずれかになります。

meanSeaLevelMillibars

number

平均海面気圧(ミリバール)。

SunEvents

JSON 表現
{
  "sunriseTime": string,
  "sunsetTime": string
}
フィールド
sunriseTime

string (Timestamp format)

日の出の時刻。

注: 特殊なケース(北極圏の北など)では、1 日に日の出時刻がない場合があります。このような場合、このフィールドは設定されません。

RFC 3339 を使用します。生成された出力は常に Z 正規化され、小数点以下は 0、3、6、または 9 桁になります。「Z」以外のオフセットも使用できます。例: "2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z"、"2014-10-02T15:01:23+05:30"。

sunsetTime

string (Timestamp format)

日の入りの時刻。

注: 特殊なケース(北極圏など)では、1 日に日没時間がない場合があります。このような場合、このフィールドは設定されません。

RFC 3339 を使用します。生成された出力は常に Z 正規化され、小数点以下は 0、3、6、または 9 桁になります。「Z」以外のオフセットも使用できます。例: "2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z"、"2014-10-02T15:01:23+05:30"。

タイムスタンプ

JSON 表現
{
  "seconds": string,
  "nanos": integer
}
フィールド
seconds

string (int64 format)

UNIX エポック 1970-01-01T00:00:00Z からの UTC 時刻の秒数を表します。-62135596800~253402300799 の範囲(両端を含む)にする必要があります(これは 0001-01-01T00:00:00Z~9999-12-31T23:59:59Z に対応します)。

nanos

integer

ナノ秒分解能による、秒の負ではない小数以下部分。このフィールドは、秒の代替ではなく、期間のナノ秒部分です。小数以下を含む負の秒の値は、時間を前方にカウントする負ではない nanos 値を持つ必要があります。0~999,999,999 にする必要があります(両端を含む)。

MoonEvents

JSON 表現
{
  "moonPhase": enum (Phase),
  "moonriseTimes": [
    string
  ],
  "moonsetTimes": [
    string
  ]
}
フィールド
moonPhase

enum (Phase)

省略可。月相(月の満ち欠け)。

moonriseTimes[]

string (Timestamp format)

月の上端が地平線の上に現れる時刻(https://en.wikipedia.org/wiki/Moonrise_and_moonset) を参照)。

注: ほとんどの場合、月の出は 1 日に 1 回です。それ以外の場合、リストは空になることがあります(例: 翌日の深夜以降に月が昇る場合)。ただし、特殊なケース(極地など)では、リストに複数の値が含まれることがあります。この場合、値は昇順で並べ替えられます。

RFC 3339 を使用します。生成された出力は常に Z 正規化され、小数点以下は 0、3、6、または 9 桁になります。「Z」以外のオフセットも使用できます。例: "2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z"、"2014-10-02T15:01:23+05:30"。

moonsetTimes[]

string (Timestamp format)

月の上端が地平線の下に沈む時刻(https://en.wikipedia.org/wiki/Moonrise_and_moonset) を参照)。

注: ほとんどの場合、月の入りの時刻は 1 日に 1 回です。それ以外の場合、リストは空になることがあります(例: 月が翌日の深夜以降に沈む場合)。ただし、特殊なケース(極地など)では、リストに複数の値が含まれることがあります。この場合、値は昇順で並べ替えられます。

RFC 3339 を使用します。生成された出力は常に Z 正規化され、小数点以下は 0、3、6、または 9 桁になります。「Z」以外のオフセットも使用できます。例: "2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z"、"2014-10-02T15:01:23+05:30"。

WeatherCondition

JSON 表現
{
  "iconBaseUri": string,
  "description": {
    object (LocalizedText)
  },
  "type": enum (Type)
}
フィールド
iconBaseUri

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

object (LocalizedText)

この気象条件のテキストによる説明(ローカライズ済み)。

type

enum (Type)

気象条件のタイプ。

LocalizedText

JSON 表現
{
  "text": string,
  "languageCode": string
}
フィールド
text

string

以下の google.type.LocalizedText.language_code に対応する言語のローカライズされた文字列。

languageCode

string

テキストの BCP-47 言語コード(「en-US」や「sr-Latn」など)。

詳しくは、http://www.unicode.org/reports/tr35/#Unicode_locale_identifier をご覧ください。

降水量

JSON 表現
{
  "probability": {
    object (PrecipitationProbability)
  },
  "snowQpf": {
    object (QuantitativePrecipitationForecast)
  },
  "qpf": {
    object (QuantitativePrecipitationForecast)
  }
}
フィールド
probability

object (PrecipitationProbability)

降水確率(0 ~ 100 の値)。

snowQpf

object (QuantitativePrecipitationForecast)

一定期間に積もった雪の量(液体水相当量)。注: QPF は Quantitative Precipitation Forecast(定量的降水量予測)の略です(詳細については、QuantitativePrecipitationForecast の定義をご覧ください)。

qpf

object (QuantitativePrecipitationForecast)

一定期間に蓄積された降水量(液体換算)。注: QPF は Quantitative Precipitation Forecast(定量的降水量予測)の略です(詳細については、QuantitativePrecipitationForecast の定義をご覧ください)。

PrecipitationProbability

JSON 表現
{
  "type": enum (Type),

  // Union field _percent can be only one of the following:
  "percent": integer
  // End of list of possible types for union field _percent.
}
フィールド
type

enum (Type)

省略可。降水の種類を示すコード。

共用体フィールド _percent。

_percent は次のいずれかになります。

percent

integer

降水確率を示す 0 ~ 100 の割合。

QuantitativePrecipitationForecast

JSON 表現
{
  "unit": enum (Unit),

  // Union field _quantity can be only one of the following:
  "quantity": number
  // End of list of possible types for union field _quantity.
}
フィールド
unit

enum (Unit)

積算降水量の測定に使用される単位のコード。

共用体フィールド _quantity。

_quantity は次のいずれかになります。

quantity

number

一定期間に蓄積された降水量(液体換算)。

Wind

JSON 表現
{
  "direction": {
    object (WindDirection)
  },
  "speed": {
    object (WindSpeed)
  },
  "gust": {
    object (WindSpeed)
  }
}
フィールド
direction

object (WindDirection)

風の方向、風が吹いてくる角度。

speed

object (WindSpeed)

風速。

gust

object (WindSpeed)

突風(風速の急激な増加)。

WindDirection

JSON 表現
{
  "cardinal": enum (Cardinal),

  // Union field _degrees can be only one of the following:
  "degrees": integer
  // End of list of possible types for union field _degrees.
}
フィールド
cardinal

enum (Cardinal)

省略可。風が吹いている方角を表すコード。

共用体フィールド _degrees。

_degrees は次のいずれかになります。

degrees

integer

風向き(度単位、0 ~ 360 の値)。

WindSpeed

JSON 表現
{
  "unit": enum (Unit),

  // Union field _value can be only one of the following:
  "value": number
  // End of list of possible types for union field _value.
}
フィールド
unit

enum (Unit)

省略可。風速の測定に使用される単位を表すコード。

共用体フィールド _value。

_value は次のいずれかになります。

value

number

風速の値。

ロケーション

JSON 表現
{

  // Union field location_type can be only one of the following:
  "latLng": {
    object (LatLng)
  },
  "placeId": string,
  "address": string
  // End of list of possible types for union field location_type.
}
フィールド
共用体フィールド location_type。場所を表すさまざまな方法。location_type は次のいずれかになります。
latLng

object (LatLng)

地理座標を使用して指定されたポイント。

placeId

string

ビジネスに関連付けられたプレイス ID。

address

string

人が読める形式の住所(番地、市区町村、郵便番号など)。

LatLng

JSON 表現
{
  "latitude": number,
  "longitude": number
}
フィールド
latitude

number

緯度(度単位)。範囲 [-90.0, +90.0] 内になければなりません。

longitude

number

経度(度単位)。範囲 [-180.0, +180.0] 内になければなりません。

アトリビューション

JSON 表現
{
  "title": string,
  "url": string
}
フィールド
title

string

アトリビューションに表示するタイトル。

url

string

帰属表示のリンク先 URL。

WeatherResultData

JSON 表現
{
  "weatherCondition": {
    object (WeatherCondition)
  },
  "precipitation": {
    object (Precipitation)
  },
  "wind": {
    object (Wind)
  },
  "attribution": {
    object (Attribution)
  },

  // Union field _date_time can be only one of the following:
  "dateTime": string
  // End of list of possible types for union field _date_time.

  // Union field _temperature can be only one of the following:
  "temperature": {
    object (Temperature)
  }
  // End of list of possible types for union field _temperature.

  // Union field _feels_like_temperature can be only one of the following:
  "feelsLikeTemperature": {
    object (Temperature)
  }
  // End of list of possible types for union field _feels_like_temperature.

  // Union field _heat_index can be only one of the following:
  "heatIndex": {
    object (Temperature)
  }
  // End of list of possible types for union field _heat_index.

  // Union field _air_pressure can be only one of the following:
  "airPressure": {
    object (AirPressure)
  }
  // End of list of possible types for union field _air_pressure.

  // Union field _date can be only one of the following:
  "date": {
    object (Date)
  }
  // End of list of possible types for union field _date.

  // Union field _max_temperature can be only one of the following:
  "maxTemperature": {
    object (Temperature)
  }
  // End of list of possible types for union field _max_temperature.

  // Union field _min_temperature can be only one of the following:
  "minTemperature": {
    object (Temperature)
  }
  // End of list of possible types for union field _min_temperature.

  // Union field _feels_like_max_temperature can be only one of the following:
  "feelsLikeMaxTemperature": {
    object (Temperature)
  }
  // End of list of possible types for union field _feels_like_max_temperature.

  // Union field _feels_like_min_temperature can be only one of the following:
  "feelsLikeMinTemperature": {
    object (Temperature)
  }
  // End of list of possible types for union field _feels_like_min_temperature.

  // Union field _max_heat_index can be only one of the following:
  "maxHeatIndex": {
    object (Temperature)
  }
  // End of list of possible types for union field _max_heat_index.

  // Union field _sun_events can be only one of the following:
  "sunEvents": {
    object (SunEvents)
  }
  // End of list of possible types for union field _sun_events.

  // Union field _moon_events can be only one of the following:
  "moonEvents": {
    object (MoonEvents)
  }
  // End of list of possible types for union field _moon_events.

  // Union field _relative_humidity can be only one of the following:
  "relativeHumidity": integer
  // End of list of possible types for union field _relative_humidity.

  // Union field _uv_index can be only one of the following:
  "uvIndex": integer
  // End of list of possible types for union field _uv_index.

  // Union field _thunderstorm_probability can be only one of the following:
  "thunderstormProbability": integer
  // End of list of possible types for union field _thunderstorm_probability.

  // Union field _cloud_cover can be only one of the following:
  "cloudCover": integer
  // End of list of possible types for union field _cloud_cover.
}
フィールド
weatherCondition

object (WeatherCondition)

気象条件。

precipitation

object (Precipitation)

降水確率と積算降水量。

wind

object (Wind)

風の状況。

attribution

object (Attribution)

天気とともに表示する必要がある帰属表示。

共用体フィールド _date_time。

_date_time は次のいずれかになります。

dateTime

string (Timestamp format)

この 1 時間ごとまたは現在の天気エントリのタイムスタンプ。

RFC 3339 を使用します。生成された出力は常に Z 正規化され、小数点以下は 0、3、6、または 9 桁になります。「Z」以外のオフセットも使用できます。例: "2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z"、"2014-10-02T15:01:23+05:30"。

共用体フィールド _temperature。

_temperature は次のいずれかになります。

temperature

object (Temperature)

1 時間ごとの気温。

共用体フィールド _feels_like_temperature。

_feels_like_temperature は次のいずれかになります。

feelsLikeTemperature

object (Temperature)

1 時間ごとの体感温度。

共用体フィールド _heat_index。

_heat_index は次のいずれかになります。

heatIndex

object (Temperature)

1 時間ごとの暑さ指数。

共用体フィールド _air_pressure。

_air_pressure は次のいずれかになります。

airPressure

object (AirPressure)

1 時間ごとの気圧の状態。

共用体フィールド _date。

_date は次のいずれかになります。

date

object (Date)

日次天気予報の暦日。

共用体フィールド _max_temperature。

_max_temperature は次のいずれかになります。

maxTemperature

object (Temperature)

1 日の最高気温。

共用体フィールド _min_temperature。

_min_temperature は次のいずれかになります。

minTemperature

object (Temperature)

1 日の最低気温。

共用体フィールド _feels_like_max_temperature。

_feels_like_max_temperature は次のいずれかになります。

feelsLikeMaxTemperature

object (Temperature)

1 日の最高体感温度。

共用体フィールド _feels_like_min_temperature。

_feels_like_min_temperature は次のいずれかになります。

feelsLikeMinTemperature

object (Temperature)

1 日の最低体感温度。

共用体フィールド _max_heat_index。

_max_heat_index は次のいずれかになります。

maxHeatIndex

object (Temperature)

1 日の最高熱指数温度。

共用体フィールド _sun_events。

_sun_events は次のいずれかになります。

sunEvents

object (SunEvents)

太陽に関連するイベント(日の出、日の入りなど)。

共用体フィールド _moon_events。

_moon_events は次のいずれかになります。

moonEvents

object (MoonEvents)

月に関連するイベント(月の出、月の入りなど)。

共用体フィールド _relative_humidity。

_relative_humidity は次のいずれかになります。

relativeHumidity

integer

相対湿度の割合(0 ~ 100 の値)。

共用体フィールド _uv_index。

_uv_index は次のいずれかになります。

uvIndex

integer

最大紫外線(UV)指数。

共用体フィールド _thunderstorm_probability。

_thunderstorm_probability は次のいずれかになります。

thunderstormProbability

integer

雷雨の確率(0 ~ 100 の値)。

共用体フィールド _cloud_cover。

_cloud_cover は次のいずれかになります。

cloudCover

integer

雲に覆われた空の割合(0 ~ 100 の値)。

日付

JSON 表現
{
  "year": integer,
  "month": integer,
  "day": integer
}
フィールド
year

integer

その日付の年。1~9999、または年のない日付を指定する場合は 0 にする必要があります。

month

integer

1 年の中の月。1~12、または月と日のない年を指定する場合は 0 にする必要があります。

day

integer

1 月の中の日付。1~31 で、その年と月で有効な値にする必要があります。または、日が重要でない場合は年のみか年と月を指定するには 0 にする必要があります。

AirQualityResultData

JSON 表現
{
  "hourlyResults": [
    {
      object (AirQualityHourlyResult)
    }
  ],
  "attribution": {
    object (Attribution)
  }
}
フィールド
hourlyResults[]

object (AirQualityHourlyResult)

リクエストされた時間の大気質データ(1 時間ごと)。現在の状況または 1 時間のクエリの場合は 1 つのエントリ、過去または将来の日付のみのクエリの場合は最大 24 個のエントリ、日付が今日の場合は現在 + 残りの時間のエントリが含まれます。

attribution

object (Attribution)

大気質データとともに表示する必要がある帰属表示。

AirQualityHourlyResult

JSON 表現
{
  "indexes": [
    {
      object (AirQualityIndex)
    }
  ],
  "pollutants": [
    {
      object (Pollutant)
    }
  ],
  "healthRecommendations": {
    object (HealthRecommendations)
  },
  "dateTime": {
    object (DateTime)
  }
}
フィールド
indexes[]

object (AirQualityIndex)

大気質指数(汎用 AQI、ローカル AQI など)。

pollutants[]

object (Pollutant)

汚染物質の詳細情報。air_quality_options.include_pollutant_concentration が true の場合に入力されます。

healthRecommendations

object (HealthRecommendations)

さまざまな人口グループ向けの健康に関する推奨事項。

dateTime

object (DateTime)

この 1 時間ごとの大気質エントリの場所のタイムゾーンにおける現地の日時(year、month、day、hours、minutes、seconds、utc_offset で構成されます)。

AirQualityIndex

JSON 表現
{
  "displayName": string,
  "valueDisplay": string,
  "category": string,
  "dominantPollutant": string,

  // Union field _value can be only one of the following:
  "value": integer
  // End of list of possible types for union field _value.
}
フィールド
displayName

string

指数の表示名(例: 「Universal AQI」、「US EPA AQI」)。

valueDisplay

string

AQI 値の書式設定された文字列表現。

category

string

大気質カテゴリのテキスト(例: 「良好な大気質」、「中程度の大気質」)。

dominantPollutant

string

主要な汚染物質のコード(「pm25」、「o3」など)。

共用体フィールド _value。

_value は次のいずれかになります。

value

integer

AQI の数値。

汚染物質

JSON 表現
{
  "displayName": string,
  "fullName": string,
  "concentration": {
    object (Concentration)
  },
  "additionalInfo": {
    object (AdditionalInfo)
  }
}
フィールド
displayName

string

汚染物質の短い表示名(例: 「PM2.5」、「O3」)。

fullName

string

汚染物質の完全な化学名または一般名(例: 「微粒子状物質(2.5 μm 未満)」、「オゾン」)。

concentration

object (Concentration)

汚染物質の測定濃度。

additionalInfo

object (AdditionalInfo)

汚染物質の発生源と健康への影響に関する追加情報。

濃度

JSON 表現
{
  "unit": enum (Unit),

  // Union field _value can be only one of the following:
  "value": number
  // End of list of possible types for union field _value.
}
フィールド
unit

enum (Unit)

濃度の測定単位。

共用体フィールド _value。

_value は次のいずれかになります。

value

number

数値の濃度値。

AdditionalInfo

JSON 表現
{
  "sources": string,
  "effects": string
}
フィールド
sources

string

汚染物質の主な排出源。

effects

string

汚染物質にさらされた場合に考えられる健康への影響。

HealthRecommendations

JSON 表現
{
  "generalPopulation": string,
  "elderly": string,
  "lungDiseasePopulation": string,
  "heartDiseasePopulation": string,
  "athletes": string,
  "pregnantWomen": string,
  "children": string
}
フィールド
generalPopulation

string

全対象ユーザー向けのガイダンス。

elderly

string

高齢者向けのガイダンス。

lungDiseasePopulation

string

肺疾患または呼吸器疾患のある方向けのガイダンス。

heartDiseasePopulation

string

心血管疾患または心臓病を患っている方へのガイダンス。

athletes

string

アスリートやアウトドア アクティビティを楽しむ方向けのガイダンス。

pregnantWomen

string

妊婦向けのガイダンス。

children

string

お子様向けのガイダンス。

DateTime

JSON 表現
{
  "year": integer,
  "month": integer,
  "day": integer,
  "hours": integer,
  "minutes": integer,
  "seconds": integer,
  "nanos": integer,

  // Union field time_offset can be only one of the following:
  "utcOffset": string,
  "timeZone": {
    object (TimeZone)
  }
  // End of list of possible types for union field time_offset.
}
フィールド
year

integer

省略可。日付の年。1~9999、または日時に年を指定しない場合は 0 にする必要があります。

month

integer

省略可。月。1~12、または日時に月を指定しない場合は 0 にする必要があります。

day

integer

省略可。日。1~31(年と月に対して有効な値)、または日時に日を指定しない場合は 0 にする必要があります。

hours

integer

省略可。時間(24 時間形式)。0~23 で指定します。デフォルトは 0(午前 0 時)です。API ではビジネスの終了時間などのシナリオにおいて、値 "24:00:00" を許可することもできます。

minutes

integer

省略可。分。0~59 で指定します。デフォルトは 0 です。

seconds

integer

省略可。秒。通常は 0~59 で指定します。デフォルトは 0 です。API がうるう秒を許可する場合、値 60 が許可されます。

nanos

integer

省略可。秒の小数部分(ナノ秒単位)。0~999,999,999 で指定します。デフォルトは 0 です。

共用体フィールド time_offset。省略可。DateTime の UTC オフセットまたはタイムゾーンを指定します。タイムゾーン データは将来変更される可能性があるため、慎重に選択してください(たとえば、国が夏時間の開始日と終了日を変更し、影響を受ける範囲の将来の DateTime がすでに保存されている場合など)。省略した場合、DateTime は現地時間とみなされます。time_offset は次のいずれかになります。
utcOffset

string (Duration format)

UTC オフセット。-18 時間から +18 時間の範囲で、秒数を整数で指定します。たとえば UTC オフセットが -4 時間の場合は、{ seconds: -14400 } と表します。

s で終わる小数点以下 9 桁までの秒単位の期間。例: "3.5s"。

timeZone

object (TimeZone)

タイムゾーン。

所要時間

JSON 表現
{
  "seconds": string,
  "nanos": integer
}
フィールド
seconds

string (int64 format)

期間の秒数(符号付き)。-315,576,000,000 ~+315,576,000,000 の範囲(境界を含む)になります。注: これらの境界は、60 秒/分 * 60 分/時間 * 24 時間/日 * 365.25 日/年 * 10,000 年から計算されます。

nanos

integer

期間のナノ秒分解能による、秒の符号付き小数以下部分。1 秒未満の期間は、0 の seconds フィールドと、正または負の nanos フィールドで表されます。1 秒以上の期間の場合、nanos フィールドのゼロ以外の値は、seconds フィールドと同じ符号にする必要があります。-999,999,999~+999,999,999 の範囲内(境界含む)である必要があります。

TimeZone

JSON 表現
{
  "id": string,
  "version": string
}
フィールド
id

string

IANA タイムゾーン データベースのタイムゾーン。たとえば、「America/New_York」。

version

string

省略可。IANA タイムゾーン データベースのバージョン番号。たとえば、「2019a」。

PollenResultData

JSON 表現
{
  "dailyForecast": {
    object (DailyPollenForecast)
  },
  "attribution": {
    object (Attribution)
  }
}
フィールド
dailyForecast

object (DailyPollenForecast)

リクエストされた日付の花粉飛散予報。

attribution

object (Attribution)

花粉データとともに表示する必要がある帰属表示。

DailyPollenForecast

JSON 表現
{
  "date": {
    object (Date)
  },
  "categories": [
    {
      object (PollenCategoryInfo)
    }
  ],
  "plantSpecies": [
    {
      object (PlantSpeciesInfo)
    }
  ]
}
フィールド
date

object (Date)

予報の市民暦の日付。

categories[]

object (PollenCategoryInfo)

花粉の大まかなカテゴリの内訳(樹木、草、雑草)。

plantSpecies[]

object (PlantSpeciesInfo)

植物種の詳細な内訳。

PollenCategoryInfo

JSON 表現
{
  "displayName": string,
  "inSeason": boolean,
  "index": {
    object (PollenIndex)
  },
  "healthRecommendations": [
    string
  ]
}
フィールド
displayName

string

カテゴリの表示名(例: 「木」、「草」、「雑草」)。

inSeason

boolean

この花粉カテゴリがその地域で活発に開花しているかどうか。

index

object (PollenIndex)

このカテゴリのユニバーサル花粉指数(UPI)の測定値。

healthRecommendations[]

string

花粉に敏感なグループ向けの実用的な健康アドバイス。

PollenIndex

JSON 表現
{
  "category": string,
  "description": string,

  // Union field _value can be only one of the following:
  "value": integer
  // End of list of possible types for union field _value.
}
フィールド
category

string

ローカライズされたカテゴリ分類(「なし」、「非常に低い」、「低い」、「中程度」、「高い」、「非常に高い」など)。

description

string

花粉リスクレベルの説明。

共用体フィールド _value。

_value は次のいずれかになります。

value

integer

UPI の数値(0 ~ 5 のスケール)。

PlantSpeciesInfo

JSON 表現
{
  "code": string,
  "displayName": string,
  "family": string,
  "inSeason": boolean,
  "index": {
    object (PollenIndex)
  },
  "season": string,
  "crossReactions": string
}
フィールド
code

string

機械で読み取り可能な種コード(例: 「BIRCH」、「JAPANESE_CEDAR」、「RAGWEED」)。

displayName

string

植物種のローカライズされた表示名(例: 「Birch」)。

family

string

植物の科名(例: 「カバノキ科」)。

inSeason

boolean

この植物種が現在、旬の時期かどうか。

index

object (PollenIndex)

この種のユニバーサル花粉指数(UPI)の測定値。

season

string

一般的な開花時期の説明(例: 「冬の終わり、春」)。

crossReactions

string

既知の交差反応性アレルゲン(例: 「ハンノキ、ハシバミ、ブナ、オークの花粉」)。

単位

温度の測定に使用される単位を表します。

列挙型
UNIT_UNSPECIFIED 温度の単位が指定されていません。
CELSIUS 温度は摂氏で測定されます。
FAHRENHEIT 温度は華氏で測定されます。

フェーズ

月相(月の満ち欠け)を示します。

列挙型
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% 照らされている。

タイプ

天気予報要素のコンテキストで気象条件タイプをマークします。

注: 値が 42 ~ 139 の条件は、現在、日本と韓国の地域でのみ返されます。

列挙型
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 激しい雷雨。
CLEAR_AFTER_FOG_IN_THE_MORNING 朝のうち霧のち晴れ。
CLEAR_BUT_LATER_TURNING_CLOUDY 晴れのち曇り。
CLEAR_BUT_LATER_TURNING_TO_RAIN_AND_SNOW_MAIN_CONSTITUENT_RAIN 晴れのち雨や雪(主に雨)
CLEAR_BUT_LATER_TURNING_TO_SNOW_AND_RAIN_MAIN_CONSTITUENT_SNOW 晴れのち雪や雨(主に雪)。
CLEAR_BUT_THUNDERSTORMS_LATER 晴れのち雷雨。
CLEAR_IN_THE_MORNING_BUT_CLOUDY_IN_THE_EVENING 朝のうち晴れ、夕方から曇り。
CLEAR_IN_THE_MORNING_WITH_BRIEF_RAIN_IN_THE_EVENING 午前中晴のち夜一時雨。
CLEAR_MORNING_WITH_BRIEF_RAIN 朝のうち晴れ、一時的に雨。
CLEAR_WITH_BRIEF_RAIN 晴れ、一時的に雨。
CLEAR_WITH_BRIEF_RAIN_AND_SNOW_RAIN_AS_MAIN_CONSTITUENT 晴れ一時雨や雪(主に雨)。
CLEAR_WITH_BRIEF_RAIN_LATER 晴れのち一時雨。
CLEAR_WITH_BRIEF_SNOW 晴れ、一時的に雪。
CLEAR_WITH_BRIEF_SNOW_AND_RAIN_SNOW_AS_MAIN_CONSTITUENT 晴れ一時雪や雨(主に雪)。
CLEAR_WITH_BRIEF_SNOW_LATER 晴れのち一時雪。
CLEAR_WITH_PERIODIC_CLOUDS_LATER 晴れのちときどき曇り。
CLEAR_WITH_PERIODIC_RAIN 晴れときどき雨。
CLEAR_WITH_PERIODIC_RAIN_ACCOMPANIED_BY_THUNDER 晴れときどき雷を伴う雨。
CLEAR_WITH_PERIODIC_RAIN_AND_SNOW_RAIN_AS_MAIN_CONSTITUENT 晴れときどき雨や雪(主に雨)。
CLEAR_WITH_PERIODIC_RAIN_LATER 晴れのちときどき雨。
CLEAR_WITH_PERIODIC_SNOW 晴れときどき雪。
CLEAR_WITH_PERIODIC_SNOW_AND_RAIN_SNOW_AS_MAIN_CONSTITUENT 晴れときどき雪や雨(主に雪)。
CLEAR_WITH_PERIODIC_SNOW_LATER 晴れのちときどき雪。
CLEAR_WITH_RAIN_AFTER_MIDNIGHT 晴れ、夜半過ぎから雨。
CLEAR_WITH_RAIN_IN_THE_NIGHT 晴れ、夜から雨。
CLEAR_WITH_RAIN_LATER 晴れのち雨。
CLEAR_WITH_SNOW_ALONG_THE_MOUNTAINS 晴れ、山沿いで雪。
CLEAR_WITH_SNOW_LATER 晴れのち雪。
CLEAR_WITH_THUNDERSTORMS_ALONG_THE_MOUNTAINS 晴れ、山沿いで雷雨。
CLEAR_WITH_THUNDERSTORMS_IN_THE_AFTERNOON 晴れ、午後は雷雨。
CLOUDY_BUT_CLEAR_LATER 曇りのち晴れ。
CLOUDY_BUT_LATER_TURNING_TO_RAIN_AND_SNOW_MAIN_CONSTITUENT_RAIN 曇りのち雨や雪(主に雨)。
CLOUDY_BUT_LATER_TURNING_TO_SNOW_AND_RAIN_MAIN_CONSTITUENT_SNOW 曇りのち雪や雨(主に雪)。
CLOUDY_BUT_PERIODICALLY_CLEAR_LATER 曇りのちときどき晴れ。
CLOUDY_BUT_THUNDERSTORMS_LATER 曇りのち雷雨。
CLOUDY_MORNING_WITH_BRIEF_RAIN 朝のうち曇り一時雨。
CLOUDY_PERIODICALLY_CLEAR 曇りときどき晴れ。
CLOUDY_SNOWING_IN_THE_EVENING 曇り、夕方から雪。
CLOUDY_SNOWING_IN_THE_NIGHT 曇り、夜は雪。
CLOUDY_WITH_BRIEF_RAIN 曇り、一時的に雨。
CLOUDY_WITH_BRIEF_RAIN_AND_SNOW_RAIN_AS_MAIN_CONSTITUENT 曇り一時雨や雪(主に雨)。
CLOUDY_WITH_BRIEF_RAIN_LATER 曇りのち一時雨。
CLOUDY_WITH_BRIEF_SNOW 曇り一時雪。
CLOUDY_WITH_BRIEF_SNOW_AND_RAIN_SNOW_AS_MAIN_CONSTITUENT 曇り一時雪や雨(主に雪)。
CLOUDY_WITH_BRIEF_SNOW_LATER 曇りのち一時雪。
CLOUDY_WITH_BRIEF_THUNDERSTORM 曇り一時雷雨。
CLOUDY_WITH_FOG_ON_THE_OCEAN_AND_AT_THE_SEASHORE 曇り、沿岸から海上にかけて霧。
CLOUDY_WITH_PERIODIC_RAIN 曇りときどき雨。
CLOUDY_WITH_PERIODIC_RAIN_ACCOMPANIED_BY_THUNDER 曇りときどき雷雨。
CLOUDY_WITH_PERIODIC_RAIN_AND_SNOW_RAIN_AS_MAIN_CONSTITUENT 曇りときどき雨や雪(主に雨)
CLOUDY_WITH_PERIODIC_RAIN_LATER 曇りのちときどき雨。
CLOUDY_WITH_PERIODIC_SNOW 曇りときどき雪。
CLOUDY_WITH_PERIODIC_SNOW_ACCOMPANIED_BY_THUNDER 曇りときどき雷を伴う雪。
CLOUDY_WITH_PERIODIC_SNOW_AND_RAIN_SNOW_AS_MAIN_CONSTITUENT 曇りときどき雪や雨(主に雪)。
CLOUDY_WITH_PERIODIC_SNOW_LATER 曇りのちときどき雪。
CLOUDY_WITH_RAIN_AFTER_MIDNIGHT 曇り、夜半過ぎから雨。
CLOUDY_WITH_RAIN_FROM_ABOUT_NOON 曇り、正午頃から雨。
CLOUDY_WITH_RAIN_FROM_EVENING 曇り、夕方から雨。
CLOUDY_WITH_RAIN_LATER 曇りのち雨。
CLOUDY_WITH_SNOW_FROM_AROUND_NOON 曇り、正午頃から雪。
CLOUDY_WITH_SNOW_LATER 曇りのち雪。
FOG 霧。
RAINSNOW_MIX_LATER_BECOMING_CLEAR_RAIN_AS_MAIN みぞれ(主に雨)のち晴れ。
RAINSNOW_MIX_RAIN_AS_MAIN みぞれ(主に雨)。
RAINY_BUT_PERIODICALLY_CLEAR 雨ときどき晴れ。
RAIN_ACCOMPANIED_BY_LIGHTNING 雷を伴う雨。
RAIN_ACCOMPANIED_BY_WINDSTORM 暴風を伴う雨。
RAIN_CLEAR_AT_NIGHT 雨、夜から晴れ。
RAIN_CLEAR_FROM_AROUND_EVENING 雨、夕方から晴れ。
RAIN_CLEAR_FROM_AROUND_NOON 雨、昼頃から晴れ。
RAIN_LATER_BECOMING_CLEAR 雨のち晴れ。
RAIN_LATER_BECOMING_CLOUDY 雨のち曇り。
RAIN_LATER_BECOMING_SNOW 雨のち雪。
RAIN_LATER_WITH_PERIODIC_SNOW 雨のちときどき雪。
RAIN_SNOW_AT_NIGHT 雨、夜から雪。
RAIN_SNOW_IN_THE_EVENING 雨、夕方から雪。
RAIN_TEMPORARILY_BECOMING_SLEET 雨、一時みぞれ。
RAIN_THAT_PERIODICALLY_STOPS 雨ときどき曇り。
RAIN_WITH_BRIEF_SNOW 雨一時雪。
RAIN_WITH_PERIODIC_SNOW 雨ときどき雪。
SNOWRAIN_MIX_LATER_BECOMING_CLEAR_SNOW_AS_MAIN みぞれ(主に雪)のち晴れ。
SNOWRAIN_MIX_LATER_BECOMING_CLOUDY_SNOW_AS_MAIN みぞれ(主に雪)のち曇り。
SNOWRAIN_MIX_SNOW_AS_MAIN みぞれ(主に雪)。
SNOW_ACCOMPANIED_BY_LIGHTNING 雷を伴う雪。
SNOW_BECOMING_SLEET 雪のちみぞれ。
SNOW_LATER_CLEAR 雪のち晴れ。
SNOW_LATER_CLOUDY 雪のち曇り。
SNOW_LATER_RAIN 雪のち雨。
SNOW_PERIODICALLY_CLEAR 雪ときどき晴れ。
SNOW_THAT_PERIODICALLY_STOPS 雪ときどき曇り。
SNOW_TURNING_TO_RAIN_AROUND_NOON 雪、昼頃から雨。
SNOW_TURNING_TO_RAIN_IN_THE_EVENING 雪、夕方から雨。
SNOW_TURNING_TO_RAIN_IN_THE_NIGHT 雪、夜から雨。
SNOW_WITH_BRIEF_RAIN 雪、一時的に雨。
SNOW_WITH_BRIEF_SLEET 雪一時みぞれ。
SNOW_WITH_PERIODIC_RAIN 雪ときどき雨。
VERY_HOT 非常に高温です。
SLEET みぞれ。
HEAVY_RAIN_TO_RAINSTORM 大雨または嵐。

タイプ

特定の場所における降水の種類を表します。

列挙型
TYPE_UNSPECIFIED 降水タイプが指定されていません。
NONE 降水なし。
SNOW 降雪。
RAIN 降雨。
LIGHT_RAIN 弱い雨。
HEAVY_RAIN 大雨。
RAIN_AND_SNOW 雨と雪の両方の降水量。
SLEET みぞれ。
FREEZING_RAIN 着氷性の雨。
PRECIPITATION_TYPE_HAIL ひょうの降水。

単位

積算降水量の測定に使用される単位を表します。

列挙型
UNIT_UNSPECIFIED 降水量の単位が指定されていません。
MILLIMETERS 降水量はミリメートル単位で測定されます。
INCHES 降水量はインチ単位で測定されます。

カーマインレッド

基本方位(序数方位を含む)を表します。

列挙型
CARDINAL_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 北北西の二次四方位。

単位

速度の測定に使用される単位を表します。

列挙型
UNIT_UNSPECIFIED 速度単位が指定されていません。
KILOMETERS_PER_HOUR 速度は時速(km/h)で測定されます。
MILES_PER_HOUR 速度はマイル / 時で測定されます。

単位

汚染物質の濃度を測定するために使用される単位。

列挙型
UNIT_UNSPECIFIED 濃度単位が指定されていません。
PARTS_PER_BILLION 10 億分の 1(ppb)。
MICROGRAMS_PER_CUBIC_METER マイクログラム/立方メートル(µg/m³)。

ツールのアノテーション

ツールのアノテーションは、特定のツールの基本的なリスクを説明するために MCP クライアントに送信されます。ほとんどのクライアントは、これらのヒントを信頼できないものとして扱いますが、確認プロンプトをユーザーに送信するタイミングを決定するために使用できます。

タイトル文字列とともに、次のブール値ヒントが定義されています。

  • readOnlyHint: true の場合、ツールは環境を変更しません。デフォルトは false です。
  • destructiveHint: true の場合、ツールは破壊的なアクションを実行できます。false の場合、ツールは追加アクションのみを実行できます。デフォルト値は true です。
  • idempotentHint: true の場合、同じ引数でツールを繰り返し呼び出しても、環境に副次的影響は発生しません。デフォルトは false です。
  • openWorldHint: true の場合、ツールは外部エンティティの「オープンワールド」とやり取りできます。false の場合、ツールは内部エンティティとのみやり取りできます。たとえば、ウェブ検索ツールはオープン ワールドですが、メモリツールはオープン ワールドではありません。

破壊的ヒント: ❌ | べき等ヒント: ❌ | 読み取り専用ヒント: ✅ | オープン ワールド ヒント: ❌