Method: lookupWeather

特定の場所の気象条件を検索します。

HTTP リクエスト

POST https://mapstools.googleapis.com/v1:lookupWeather

この URL は gRPC Transcoding 構文を使用します。

リクエストの本文

リクエストの本文には、次の構造のデータが含まれます。

JSON 表現 
{
  "unitsSystem": enum (UnitsSystem),
  "location": {
    object (Location)
  },
  "capabilities": [
    enum (Capability)
  ],
  "date": {
    object (Date)
  },
  "hour": integer,
  "languageCode": string,
  "weatherOptions": {
    object (WeatherOptions)
  },
  "airQualityOptions": {
    object (AirQualityOptions)
  }
}
フィールド
unitsSystem

enum (UnitsSystem)

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

object (Location)

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

enum (Capability)

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

object (Date)

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

integer

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

string

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

object (WeatherOptions)

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

object (AirQualityOptions)

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

レスポンスの本文

成功した場合、レスポンスの本文には LookupWeatherResponse のインスタンスが含まれます。

認可スコープ

次の OAuth スコープが必要です。

  • https://www.googleapis.com/auth/maps-platform.mapstools