天気を調べる

lookup_weather ツールを使用すると、LLM は場所の環境条件（天気、大気質、花粉）を取得できます。1 つのリクエストで、プレイス ID、住所、緯度 / 経度座標の 1 つ、2 つ、または 3 つすべての環境機能をクエリできます。

天気、または現在と予測の大気質のみをクエリするリクエストは、Maps Grounding Essentials SKU で課金されます。Pro では、毎日の花粉予測と過去 30 日間の大気質データが追加されます。

lookup_weather は、MCP サーバーを介して呼び出すことも、lookupWeather REST メソッドとして呼び出すこともできます。このページでは、環境機能、リクエストオプション、Pro オプション、レスポンス構造、課金ルールについて説明します。完全なスキーマについては、lookup_weather MCP リファレンスと lookupWeather REST リファレンスをご覧ください。

機能と期間

capabilities 配列を使用して、返す環境ドメイン（WEATHER、AIR_QUALITY、POLLEN）を選択します。weather_options、air_quality_options、language_code のいずれかを設定する場合は、capabilities が必要です。capabilities、weather_options、air_quality_options、language_code を省略すると、lookup_weather は以前の天気モードで実行され、フラットな最上位の天気フィールドを返します。

すべての date 値と hour 値は、リクエストされたロケーションのローカルタイムゾーンで評価されます。次の表に、各機能でサポートされている期間と SKU を示します。

能力	現在の状況（`date` と `hour` は省略）	過去の状況	予測条件	SKU
`WEATHER`	現在の天気	過去 24 時間まで（`date` と `hour` の両方が必要。`hour` なしの過去の `date` はサポートされていません）	`hour` が設定されている場合は最大 240 時間（10 日間）の時間単位の天気予報、`date` のみが設定されている場合は最大 10 日間の日単位の天気予報	Essentials
`AIR_QUALITY`	現在の 1 時間ごとの大気質	`date` と `hour` が設定されている場合は、過去 720 時間（30 日間）の 1 時間。`date` のみが設定されている場合は、今日から 29 日前まで（最大 24 時間のエントリ）。	`date` と `hour` が設定されている場合は、最大 96 時間（4 日）先までの 1 時間。`date` のみが設定されている場合は、今日から 3 日後まで（最大 24 時間のエントリ）	現在の天気、今日の 1 日の天気、天気予報の基本情報。Pro: 今日より前の `date`、またはレスポンスで返された過去の `hour`
`POLLEN`	当日の花粉飛散予報	サポートされていません（`INVALID_ARGUMENT` エラーが返されます）	今日から 4 日後までの日別の花粉飛散予報（今日を含む 5 日間。花粉の場合、`hour` は無視されます）	レスポンスで返される Pro

AIR_QUALITY の場合、過去 720 時間から 96 時間の予測ウィンドウは現在の時間に固定されます。1 日全体のリクエスト（hour なしの date）は、現地時間の 00:00 から 23:00 までを対象とし、その期間内に収まる必要があります。実際には、今日から 29 日前から今日から 3 日後までです。

リクエストに複数の機能が含まれている場合、各機能の期間は個別に評価されます。リクエストされた date と hour が、リクエストされた少なくとも 1 つの機能の範囲内にある場合、レスポンスはサポートされている機能コンテナを返し、期間がサポートされていない機能は省略します。たとえば、過去 30 日以内の日付で AIR_QUALITY と POLLEN をリクエストすると、airQuality が返され、pollen は省略されます。date または hour が、リクエストされたすべての機能のサポート範囲外の場合、リクエストは INVALID_ARGUMENT エラーを返します。

リクエストオプション

LLM は、ユーザーのリクエストとツールの説明に基づいて、ツールを呼び出すときにこれらのオプションを設定します。独自の指示を使用して、モデルが使用するオプションに影響を与えることができます。Pro の使用を制御するをご覧ください。

次の表に、lookup_weather のリクエストオプションを示します。

オプション	説明
`location`	必須。クエリする場所。`address`（人が読める形式の住所、都市、ランドマーク名）、`place_id`、または `lat_lng`（`latitude` と `longitude`）として指定します。
`capabilities`	省略可。`WEATHER`、`AIR_QUALITY`、`POLLEN` の 1 つ以上の値。重複する値は重複除去されます。`weather_options`、`air_quality_options`、`language_code` を設定する場合は必須です。`capabilities` とこれらのオプションがすべて省略されている場合は、以前のフラットフィールドの天気レスポンスを返します。
`date`	省略可。リクエストされた場所の現地の日付（`year`、`month`、`day`）。現在の条件では `date` と `hour` を省略します。
`hour`	省略可。リクエストされた場所の現地時間（`0`～`23`）。`date` を設定する必要があります。`date` を指定せずに `hour` を設定すると、`INVALID_ARGUMENT` エラーが返されます。
`language_code`	省略可。レスポンス内のローカライズされたテキストの BCP-47 言語コード（`en`、`ja`、`fr-CA` など）。デフォルトは `en` です。
`weather_options.units_system`	省略可。天気の値の単位系: `METRIC`（デフォルト。摂氏、キロメートル/時、ミリメートル）または `IMPERIAL`（華氏、マイル/時、インチ）。`WEATHER` がリクエストされていない場合は無視されます。
`air_quality_options.include_pollutant_concentration`	省略可。`true` の場合、`airQuality.hourlyResults[].pollutants[]` には測定された汚染物質濃度、排出源、健康への影響が含まれます。デフォルトは `false` です。`AIR_QUALITY` がリクエストされていない場合は無視されます。
`air_quality_options.index_region_code`	省略可。2 文字の ISO 3166-1 alpha-2 国または地域コード（`US`、`FR`、`CN` など）。ユニバーサル大気質指数（UAQI）とともに、地域の大気質指数（AQI）スケールを選択するために使用されます。デフォルトでは、リクエストされたロケーションのリージョンに設定されます。`AIR_QUALITY` がリクエストされていない場合は無視されます。

Pro オプション

2 つのオプションで Maps Grounding Pro SKU を選択します。いずれかのオプションがレスポンスで返されると、リクエストは Pro SKU で課金されます。マルチ機能の課金ルールについては、課金と割り当てをご覧ください。次の表に、Pro オプションを示します。

Pro オプション	用途
`POLLEN`（`capabilities`）	ユーザーが、花粉レベル、季節性アレルギー、樹木、草、雑草の花粉、特定のアレルギー誘発植物種について尋ねている。
`capabilities` の `AIR_QUALITY`。`date` が今日より前、または過去の `hour`	お客様から、その場所のタイムゾーンにおける過去 30 日間の大気質、煙、汚染の履歴について問い合わせがあった。

他のすべての lookup_weather リクエストは、Essentials SKU で課金されます。これには次のものが含まれます。

すべての WEATHER リクエスト（現在、24 時間の履歴、10 日間の 1 時間ごとまたは 1 日ごとの予測）。
現在、今日 1 日（date が hour なしで今日に設定されている）、予測の AIR_QUALITY リクエスト（include_pollutant_concentration を true に設定するリクエスト、または index_region_code を指定するリクエストを含む）。

例

次の MCP リクエストは、東京の現在の天気、大気質（汚染物質の濃度を含む）、今日の花粉予報をリクエストします。capabilities に POLLEN が含まれているため、リクエストは Pro SKU で課金されます。

{
  "method": "tools/call",
  "params": {
    "name": "lookup_weather",
    "arguments": {
      "location": {"address": "Tokyo, Japan"},
      "capabilities": ["WEATHER", "AIR_QUALITY", "POLLEN"],
      "weather_options": {
        "units_system": "METRIC"
      },
      "air_quality_options": {
        "include_pollutant_concentration": true
      },
      "language_code": "en"
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}

次の例では、同じリクエストを lookupWeather REST メソッドに送信します。

curl -X POST \
-H "Content-Type: application/json" \
-H "X-Goog-Api-Key: API_KEY" \
-d '{
  "location": {"address": "Tokyo, Japan"},
  "capabilities": ["WEATHER", "AIR_QUALITY", "POLLEN"],
  "weatherOptions": {"unitsSystem": "METRIC"},
  "airQualityOptions": {"includePollutantConcentration": true},
  "languageCode": "en"
}' \
"https://mapstools.googleapis.com/v1:lookupWeather"

API_KEY を API キーに置き換えます。

レスポンス

リクエストで capabilities が指定されている場合、レスポンスには、リクエストされた各機能のドメイン固有のコンテナと位置情報メタデータが入力されます。

returnedLocation: 環境データの解決されたロケーション（入力 location タイプに一致する address、placeId、latLng）。
timeZone: 解決されたロケーションの IANA タイムゾーン識別子（"America/Los_Angeles"、"Asia/Tokyo" など）。
weather: WEATHER がリクエストされたときに入力されます。
- dateTime（現在のクエリと 1 時間ごとのクエリの場合）を UTC タイムスタンプとして指定するか、date（1 日の予測クエリの場合）を指定します。現地時間を表示するには、timeZone フィールドを使用して dateTime を変換します。
- 気温（temperature、feelsLikeTemperature、heatIndex、または日別の maxTemperature、minTemperature、feelsLikeMaxTemperature、feelsLikeMinTemperature、maxHeatIndex）。
- weatherCondition、precipitation、wind、airPressure、relativeHumidity、uvIndex、thunderstormProbability、cloudCover、毎日の sunEvents、moonEvents。日の出、日の入り、月の出、月の入りの時刻は UTC タイムスタンプです。
- attribution: 気象データとともに表示する必要がある帰属。
airQuality: AIR_QUALITY がリクエストされたときに入力されます。
- hourlyResults[]: 現在のクエリまたは 1 時間のクエリのエントリが 1 つ含まれます。date のみが設定されている場合は、ローカルの 1 日全体（00:00～23:00）をカバーする最大 24 個のエントリが含まれます。date が今日で、hour が省略されている場合、エントリには、今日の過去の時間、現在の時間、残りの予測時間が組み合わされます。各エントリには次のものが含まれます。
  - dateTime: ロケーションのタイムゾーンにおけるローカルの市民の日付と時刻（year、month、day、hours、minutes、seconds、utcOffset）。
  - indexes[]: ユニバーサル AQI と、利用可能な場合はローカル AQI（displayName、value、valueDisplay、category、dominantPollutant）。
  - pollutants[]: include_pollutant_concentration が true の場合に入力されます（ppb または µg/m³ の displayName、fullName、concentration、および排出量 sources と健全性 effects の additionalInfo）。
  - healthRecommendations: generalPopulation、elderly、lungDiseasePopulation、heartDiseasePopulation、athletes、pregnantWomen、children のガイダンス。
- attribution: 大気質データとともに表示する必要がある帰属表示。
pollen: POLLEN がリクエストされたときに入力されます。
- dailyForecast: リクエストされた date の花粉予測。
  - date: 予測の一般暦の日付。
  - categories[]: 広範なアレルゲンカテゴリ（Tree、Grass、Weed）。それぞれに displayName、inSeason、ユニバーサル花粉指数 index（0～5 スケール、category、description）、healthRecommendations[] があります。
  - plantSpecies[]: 特定のアレルギー性植物種（シラカバ、ブタクサ、スギなど）。それぞれに code、displayName、植物学上の family、inSeason、ユニバーサル花粉指数 index、一般的な開花時期 season、crossReactions があります。
- attribution: 花粉データとともに表示する必要がある帰属表示。

機能全体で部分的に利用可能

リクエストに複数の機能が含まれている場合、各機能は個別に評価され、取得されます。リクエストされたロケーションで 1 つの機能が利用できない場合、サポートされている期間外である場合、または少なくとも 1 つの他の機能が成功している間に一時的に失敗した場合、レスポンスは利用可能な機能コンテナを返し、利用できないコンテナまたは失敗したコンテナを省略します。リクエストされたすべての機能が失敗した場合にのみ、リクエストはエラーで失敗します。

フィールドの詳細については、lookup_weather リファレンスをご覧ください。

課金と割り当て

各 lookup_weather リクエストは 1 つの課金対象イベントです。capabilities が同じ呼び出しで 2 つまたは 3 つの環境ドメインをリクエストする場合も同様です。

リクエストは、成功してレスポンスで返された機能のうち、最も高い SKU ティアで課金されます。
- レスポンスに pollen または過去の airQuality（今日より前の date または場所のタイムゾーンの過去の hour）が含まれている場合、リクエストは Maps Grounding Pro SKU で課金されます。1 回の呼び出しで POLLEN と過去の AIR_QUALITY の両方をリクエストした場合も、Pro の課金対象イベント 1 回としてカウントされます。
- それ以外の場合、リクエストは Maps Grounding Essentials SKU で課金されます。
マルチ機能リクエストで Pro 機能が省略され（その場所で利用できない、サポートされている期間外である、一時的に失敗したなどの理由で）、レスポンスで Essentials 機能のみが返された場合、リクエストは Essentials SKU で課金されます。

lookup_weather の割り当ては、プロジェクトごとに 1 分あたり 300 クエリで、両方の SKU で共有されます。料金については、メインの料金表とインドの料金表をご覧ください。