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 menggunakan sintaksis gRPC Transcoding.

Parameter kueri

Parameter
location

object (LatLng)

Wajib. Lokasi untuk mendapatkan prakiraan 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 data perkiraan 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. Ini 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 diberikan untuk bahasa tersebut, API akan menggunakan kecocokan terdekat. Nilai yang diizinkan bergantung pada 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)

Data 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 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)
  },
  "iceThickness": {
    object (IceThickness)
  }
}
Kolom
interval

object (Interval)

Interval waktu UTC saat hari yang diprediksi 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, interval akan dimulai pada waktu 14:00:00.000Z dan berakhir pada jam yang sama pada hari berikutnya.
displayDate

object (Date)

Tanggal lokal 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 bagian siang hari (pukul 07.00 hingga 19.00 waktu setempat).
nighttimeForecast

object (ForecastDayPart)

Prakiraan kondisi cuaca 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 terasa maksimum (tinggi) sepanjang hari.
feelsLikeMinTemperature

object (Temperature)

Suhu terasa 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, bulan terbit, bulan terbenam).
iceThickness

object (IceThickness)

Jumlah akumulasi es selama sehari.

Tanggal

Menampilkan 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. Ini dapat mewakili salah satu dari hal berikut:

  • 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 bulan. 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)
  },
  "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: bagian dari hari dimulai pukul 07.00 dan berakhir pukul 19.00 pada hari yang sama, waktu setempat. Misalnya: Jika zona waktu lokal adalah UTC-7, interval siang hari akan dimulai pada waktu 14:00:00.000Z dan berakhir pada 02:00:00.000Z hari berikutnya, sedangkan interval malam hari akan dimulai pada 02:00:00.000Z hari berikutnya dan berakhir pada 14:00:00.000Z hari yang sama.
weatherCondition

object (WeatherCondition)

Kondisi cuaca yang diprediksi.
precipitation

object (Precipitation)

Prakiraan presipitasi.
wind

object (Wind)

Arah angin rata-rata serta kecepatan dan hembusan angin maksimum.
relativeHumidity

integer

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

integer

Prakiraan indeks ultraviolet (UV) maksimum.
thunderstormProbability

integer

Probabilitas badai petir rata-rata.
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 matahari terbit.

CATATAN: Dalam beberapa kasus unik (misalnya, di utara lingkaran kutub), mungkin tidak ada waktu matahari terbit selama sehari. Dalam kasus ini, kolom ini tidak akan ditetapkan.

Menggunakan RFC 3339, dengan output yang dihasilkan akan selalu dinormalisasi Z dan menggunakan digit pecahan 0, 3, 6, atau 9. 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 matahari terbenam.

CATATAN: Dalam beberapa kasus unik (misalnya, di utara lingkaran kutub), mungkin tidak ada waktu matahari terbenam selama sehari. Dalam kasus ini, kolom ini tidak akan ditetapkan.

Menggunakan RFC 3339, dengan output yang dihasilkan akan selalu dinormalisasi Z dan menggunakan digit pecahan 0, 3, 6, atau 9. 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, bulan terbit, bulan terbenam).

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

string (Timestamp format)

Waktu saat limbus 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, dengan output yang dihasilkan akan selalu dinormalisasi Z dan menggunakan digit pecahan 0, 3, 6, atau 9. 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 limbus atas bulan menghilang di bawah cakrawala (lihat https://en.wikipedia.org/wiki/Moonrise_and_moonset).

CATATAN: Pada umumnya, akan ada satu waktu pengukuran 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, dengan output yang dihasilkan akan selalu dinormalisasi Z dan menggunakan digit pecahan 0, 3, 6, atau 9. 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 bulan).

Enum
MOON_PHASE_UNSPECIFIED Fase bulan tidak ditentukan.
NEW_MOON Bulan tidak diterangi oleh matahari.
WAXING_CRESCENT Bulan diterangi oleh 0%-50% di sisi kanannya di belahan bumi utara 🌒 dan di sisi kirinya di belahan bumi selatan 🌘.
FIRST_QUARTER Bulan diterangi oleh 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 oleh 0%-50% di sisi kirinya di belahan bumi utara 🌘 dan di sisi kanannya di belahan bumi selatan 🌒.