Method: lookupWeather

Menelusuri kondisi cuaca di suatu lokasi.

Permintaan HTTP

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

URL ini menggunakan sintaksis gRPC Transcoding.

Isi permintaan

Isi permintaan memuat data dengan struktur berikut:

Representasi JSON 
{
  "unitsSystem": enum (UnitsSystem),
  "location": {
    object (Location)
  },
  "capabilities": [
    enum (Capability)
  ],
  "date": {
    object (Date)
  },
  "hour": integer,
  "languageCode": string,
  "weatherOptions": {
    object (WeatherOptions)
  },
  "airQualityOptions": {
    object (AirQualityOptions)
  }
}
Kolom
unitsSystem

enum (UnitsSystem)

Opsional. Sistem unit yang akan digunakan untuk kondisi cuaca yang ditampilkan. Jika tidak diberikan, kondisi cuaca yang ditampilkan akan menggunakan sistem metrik (default = METRIC).
location

object (Location)

Wajib. Lokasi untuk mendapatkan kondisi cuaca.
capabilities[]

enum (Capability)

Opsional. Kemampuan lingkungan yang akan disertakan dalam respons.
date

object (Date)

Opsional. Menentukan tanggal informasi lingkungan yang diminta, relatif terhadap zona waktu lokal lokasi yang ditentukan di kolom location. Rentang tanggal yang didukung bergantung pada kemampuan yang diminta: - WEATHER: hingga 24 jam terakhir (jika hour juga ditetapkan) dan hingga 10 hari (240 jam) ke depan (hari ini hingga +9 hari untuk perkiraan harian). - AIR_QUALITY: hingga 30 hari (720 jam) ke belakang dan hingga 4 hari (96 jam) ke depan. POLLEN: hari ini hingga +4 hari (hingga 5 hari termasuk hari ini; tanggal historis tidak didukung).
hour

integer

Opsional. Menentukan jam informasi lingkungan yang diminta, dalam format 24 jam (0-23), relatif terhadap zona waktu lokal lokasi yang ditentukan di kolom location. Memerlukan penetapan date. Rentang per jam yang didukung bergantung pada kemampuan yang diminta: - WEATHER: hingga 24 jam yang lalu dan hingga 240 jam (10 hari) ke depan. - AIR_QUALITY: hingga 30 hari (720 jam) ke belakang dan hingga 4 hari (96 jam) ke depan. POLLEN: hanya menampilkan perkiraan harian; hour diabaikan untuk serbuk sari.
languageCode

string

Opsional. Kode bahasa BCP-47 untuk teks yang dilokalkan dalam respons (misalnya, "en", "ja", "fr-CA"). Jika tidak ditentukan, setelan defaultnya adalah "en".
weatherOptions

object (WeatherOptions)

Opsional. Opsi khusus untuk permintaan cuaca. weatherOptions.units_system didukung bersama dengan unitsSystem tingkat atas (tag 4) untuk mempertahankan kompatibilitas mundur bagi pemanggil yang ada; menampilkan INVALID_ARGUMENT jika keduanya menentukan sistem unit yang bertentangan. Diabaikan jika WEATHER tidak diminta di capabilities.
airQualityOptions

object (AirQualityOptions)

Opsional. Opsi khusus untuk permintaan kualitas udara. Diabaikan jika AIR_QUALITY tidak diminta di capabilities.

Isi respons

Jika berhasil, isi respons memuat instance LookupWeatherResponse.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut:

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