Method: forecast.days.lookup

Menampilkan perkiraan harian hingga 10 hari di lokasi tertentu, mulai dari hari ini.

Permintaan HTTP

GET https://weather.googleapis.com/v1/forecast/days:lookup

URL ini menggunakan sintaksis gRPC Transcoding.

Parameter kueri

Parameter
location

object (LatLng)

Wajib. Lokasi untuk mendapatkan prakiraan cuaca harian.
unitsSystem

enum (UnitsSystem)

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

integer

Opsional. Jumlah maksimum rekaman perkiraan cuaca harian yang akan ditampilkan per halaman - nilai dari 1 hingga 10 (inklusif). Nilai defaultnya adalah 5.
pageToken

string

Opsional. Token halaman yang diterima dari permintaan sebelumnya. Digunakan untuk mengambil halaman berikutnya.
days

integer

Opsional. Membatasi jumlah total hari yang akan diambil mulai dari hari ini - nilai dari 1 hingga 10 (inklusif). Nilai defaultnya adalah nilai maksimum yang diizinkan, yaitu 10.
languageCode

string

Opsional. Memungkinkan klien memilih bahasa untuk respons. Jika data tidak dapat disediakan untuk bahasa tersebut, API akan menggunakan kecocokan terdekat. Nilai yang diizinkan mengandalkan standar IETF BCP-47. Nilai defaultnya adalah "en".

Isi permintaan

Isi permintaan harus kosong.

Isi respons

Respons untuk RPC days.lookup.

Jika berhasil, isi respons memuat data dengan struktur berikut:

Representasi JSON 
{
  "forecastDays": [
    {
      object (ForecastDay)
    }
  ],
  "timeZone": {
    object (TimeZone)
  },
  "nextPageToken": string
}
Kolom
forecastDays[]

object (ForecastDay)

Rekaman perkiraan harian, sesuai dengan jumlah hari dan ukuran halaman yang ditentukan dalam permintaan.
timeZone

object (TimeZone)

Zona waktu di lokasi yang diminta.
nextPageToken

string

Token untuk mengambil halaman berikutnya.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut:

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

ForecastDay

Merepresentasikan data perkiraan cuaca harian di lokasi tertentu.

Representasi JSON 
{
  "interval": {
    object (Interval)
  },
  "displayDate": {
    object (Date)
  },
  "daytimeForecast": {
    object (ForecastDayPart)
  },
  "nighttimeForecast": {
    object (ForecastDayPart)
  },
  "maxTemperature": {
    object (Temperature)
  },
  "minTemperature": {
    object (Temperature)
  },
  "feelsLikeMaxTemperature": {
    object (Temperature)
  },
  "feelsLikeMinTemperature": {
    object (Temperature)
  },
  "maxHeatIndex": {
    object (Temperature)
  },
  "sunEvents": {
    object (SunEvents)
  },
  "moonEvents": {
    object (MoonEvents)
  }
}
Kolom
interval

object (Interval)

Interval waktu UTC saat hari yang diperkirakan ini dimulai (inklusif) dan berakhir (eksklusif). Catatan: hari dimulai pukul 07.00 dan berakhir pukul 07.00 hari berikutnya, waktu setempat. Misalnya: Jika zona waktu lokal adalah UTC-7, maka interval akan dimulai pada waktu 14:00:00.000Z dan berakhir pada jam yang sama pada hari berikutnya.
displayDate

object (Date)

Tanggal setempat dalam zona waktu lokasi (waktu sipil) yang digunakan untuk menghitung perkiraan harian ini. Kolom ini dapat digunakan untuk tujuan tampilan di klien.
daytimeForecast

object (ForecastDayPart)

Prakiraan kondisi cuaca untuk siang hari (pukul 07.00 hingga 19.00 waktu setempat).
nighttimeForecast

object (ForecastDayPart)

Kondisi cuaca yang diperkirakan untuk bagian malam hari (pukul 19.00 hingga 07.00 hari berikutnya, waktu setempat).
maxTemperature

object (Temperature)

Suhu maksimum (tinggi) sepanjang hari.
minTemperature

object (Temperature)

Suhu minimum (rendah) sepanjang hari.
feelsLikeMaxTemperature

object (Temperature)

Suhu yang dirasakan maksimum (tinggi) sepanjang hari.
feelsLikeMinTemperature

object (Temperature)

Suhu yang dirasakan minimum (rendah) sepanjang hari.
maxHeatIndex

object (Temperature)

Suhu indeks panas maksimum sepanjang hari.
sunEvents

object (SunEvents)

Peristiwa yang terkait dengan matahari (misalnya, matahari terbit, matahari terbenam).
moonEvents

object (MoonEvents)

Peristiwa yang terkait dengan bulan (misalnya, terbitnya bulan, terbenamnya bulan).

Tanggal

Menunjukkan seluruh atau sebagian tanggal kalender, seperti ulang tahun. Waktu dan zona waktu ditentukan di tempat lain atau dianggap tidak signifikan. Tanggal ini terkait dengan Kalender Gregorian. Hal ini dapat mewakili salah satu dari berikut ini:

  • Tanggal lengkap, dengan nilai tahun, bulan, dan hari bukan nol.
  • Bulan dan hari, dengan tahun nol (misalnya, hari jadi).
  • Tahun saja, dengan bulan nol dan hari nol.
  • Tahun dan bulan, dengan hari nol (misalnya, tanggal habis masa berlaku kartu kredit).

Jenis terkait:

Representasi JSON 
{
  "year": integer,
  "month": integer,
  "day": integer
}
Kolom
year

integer

Tahun dalam tanggal. Harus dari 1 hingga 9999, atau 0 untuk menentukan tanggal tanpa tahun.
month

integer

Bulan dalam setahun. Harus dari 1 hingga 12, atau 0 untuk menentukan tahun tanpa bulan dan hari.
day

integer

Hari dalam sebulan. Harus dari 1 hingga 31 dan berlaku untuk tahun dan bulan, atau 0 untuk menentukan tahun saja atau tahun dan bulan jika hari dianggap tidak signifikan.

ForecastDayPart

Merepresentasikan data perkiraan untuk sebagian hari.

Representasi JSON 
{
  "interval": {
    object (Interval)
  },
  "weatherCondition": {
    object (WeatherCondition)
  },
  "precipitation": {
    object (Precipitation)
  },
  "wind": {
    object (Wind)
  },
  "iceThickness": {
    object (IceThickness)
  },
  "relativeHumidity": integer,
  "uvIndex": integer,
  "thunderstormProbability": integer,
  "cloudCover": integer
}
Kolom
interval

object (Interval)

Tanggal dan waktu UTC saat bagian hari ini dimulai (inklusif) dan berakhir (eksklusif). Catatan: sebagian hari dimulai pukul 07.00 dan berakhir pukul 19.00 pada hari yang sama, waktu setempat. Misalnya: Jika zona waktu setempat adalah UTC-7, maka interval siang hari akan dimulai pada waktu 14:00:00.000Z dan berakhir pada 02:00:00.000Z pada hari berikutnya, dan interval malam hari akan dimulai pada 02:00:00.000Z pada hari berikutnya dan berakhir pada 14:00:00.000Z pada hari yang sama.
weatherCondition

object (WeatherCondition)

Kondisi cuaca yang diperkirakan.
precipitation

object (Precipitation)

Prakiraan presipitasi.
wind

object (Wind)

Arah angin rata-rata serta kecepatan dan embusan maksimum.
iceThickness

object (IceThickness)

Jumlah es yang terakumulasi untuk sebagian hari.
relativeHumidity

integer

Perkiraan persentase kelembapan relatif (nilai dari 0 hingga 100).
uvIndex

integer

Indeks ultraviolet (UV) prakiraan maksimum.
thunderstormProbability

integer

Rata-rata probabilitas badai petir.
cloudCover

integer

Persentase tutupan awan rata-rata.

SunEvents

Mewakili peristiwa yang terkait dengan matahari (misalnya, matahari terbit, matahari terbenam).

Representasi JSON 
{
  "sunriseTime": string,
  "sunsetTime": string
}
Kolom
sunriseTime

string (Timestamp format)

Waktu saat matahari terbit.

CATATAN: Dalam beberapa kasus unik (misalnya, di utara lingkaran Arktik), mungkin tidak ada waktu matahari terbit untuk suatu hari. Dalam kasus ini, kolom ini tidak akan ditetapkan.

Menggunakan RFC 3339 yang outputnya akan selalu dinormalisasi Z dan menggunakan 0, 3, 6, atau 9 digit pecahan. Offset selain "Z" juga diterima. Contoh: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z", atau "2014-10-02T15:01:23+05:30".
sunsetTime

string (Timestamp format)

Waktu saat matahari terbenam.

CATATAN: Dalam beberapa kasus unik (misalnya, di utara lingkaran Arktik), mungkin tidak ada waktu matahari terbenam untuk suatu hari. Dalam kasus ini, kolom ini tidak akan ditetapkan.

Menggunakan RFC 3339 yang outputnya akan selalu dinormalisasi Z dan menggunakan 0, 3, 6, atau 9 digit pecahan. Offset selain "Z" juga diterima. Contoh: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z", atau "2014-10-02T15:01:23+05:30".

MoonEvents

Mewakili peristiwa yang terkait dengan bulan (misalnya, terbitnya bulan, terbenamnya bulan).

Representasi JSON 
{
  "moonriseTimes": [
    string
  ],
  "moonsetTimes": [
    string
  ],
  "moonPhase": enum (MoonPhase)
}
Kolom
moonriseTimes[]

string (Timestamp format)

Waktu saat anggota tubuh atas bulan muncul di atas cakrawala (lihat https://en.wikipedia.org/wiki/Moonrise_and_moonset).

CATATAN: Untuk sebagian besar kasus, akan ada satu waktu terbit bulan per hari. Dalam kasus lain, daftar mungkin kosong (misalnya saat bulan terbit setelah tengah malam hari berikutnya). Namun, dalam kasus unik (misalnya di wilayah kutub), daftar dapat berisi lebih dari satu nilai. Dalam kasus ini, nilai diurutkan dalam urutan menaik.

Menggunakan RFC 3339 yang outputnya akan selalu dinormalisasi Z dan menggunakan 0, 3, 6, atau 9 digit pecahan. Offset selain "Z" juga diterima. Contoh: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z", atau "2014-10-02T15:01:23+05:30".
moonsetTimes[]

string (Timestamp format)

Waktu saat anggota tubuh atas bulan menghilang di bawah cakrawala (lihat https://en.wikipedia.org/wiki/Moonrise_and_moonset).

CATATAN: Untuk sebagian besar kasus, akan ada satu waktu terbenam bulan per hari. Dalam kasus lain, daftar mungkin kosong (misalnya saat bulan terbenam setelah tengah malam hari berikutnya). Namun, dalam kasus unik (misalnya di wilayah kutub), daftar dapat berisi lebih dari satu nilai. Dalam kasus ini, nilai diurutkan dalam urutan menaik.

Menggunakan RFC 3339 yang outputnya akan selalu dinormalisasi Z dan menggunakan 0, 3, 6, atau 9 digit pecahan. Offset selain "Z" juga diterima. Contoh: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z", atau "2014-10-02T15:01:23+05:30".
moonPhase

enum (MoonPhase)

Fase bulan (alias fase lunar).

MoonPhase

Menandai fase bulan (alias fase lunar).

Enum
MOON_PHASE_UNSPECIFIED Fase bulan tidak ditentukan.
NEW_MOON Bulan tidak diterangi oleh matahari.
WAXING_CRESCENT Bulan diterangi 0%-50% di sisi kanannya di belahan bumi utara 🌒 dan di sisi kirinya di belahan bumi selatan 🌘.
FIRST_QUARTER Bulan diterangi 50,1% di sisi kanannya di belahan bumi utara 🌓 dan di sisi kirinya di belahan bumi selatan 🌗.
WAXING_GIBBOUS Bulan diterangi 50%-100% di sisi kanannya di belahan bumi utara 🌔 dan di sisi kirinya di belahan bumi selatan 🌖.
FULL_MOON Bulan sepenuhnya diterangi.
WANING_GIBBOUS Bulan diterangi 50%-100% di sisi kirinya di belahan bumi utara 🌖 dan di sisi kanannya di belahan bumi selatan 🌔.
LAST_QUARTER Bulan diterangi 50,1% di sisi kirinya di belahan bumi utara 🌗 dan di sisi kanannya di belahan bumi selatan 🌓.
WANING_CRESCENT Bulan diterangi 0%-50% di sisi kirinya di belahan bumi utara 🌘 dan di sisi kanannya di belahan bumi selatan 🌒.