API waktu matahari terbenam dan matahari terbit

Kami menawarkan API gratis yang menyediakan waktu matahari terbenam dan matahari terbit untuk lintang dan bujur tertentu.

Harap dicatat bahwa atribusi diperlukan jika Anda menggunakan API kami. Lihat bagian "Batas penggunaan dan atribusi" di bawah ini untuk informasi lebih lanjut.

Ini adalah versi 1 dari API — didukung tanpa batas waktu.

Disarankan kalau Anda sudah memakainya. Untuk proyek baru, sebaiknya pakai versi 2 dari API ini.

Versi ini akan terus berjalan persis seperti sekarang. Fitur-fitur yang lebih baru — zona waktu lokal otomatis, stempel waktu ISO 8601, golden hour dan blue hour, posisi matahari dan rentang tanggal — hanya ada di versi 2 dari API ini.

Akurasi perhitungan

Versi API ini mempertahankan perhitungan aslinya supaya kode yang sudah ada tidak rusak. Di dalamnya ada masalah yang sudah diketahui pada waktu terbit dan terbenam: matahari terbit sedikit terlalu awal, terbenam sedikit terlalu lambat, sehingga siangnya tampak sedikit lebih panjang dari yang sebenarnya. Ini sudah diperbaiki di versi 2 dari API ini.

Seberapa meleset bergantung pada lokasi dan tanggal: sekitar satu menit di dekat khatulistiwa dan hingga sekitar delapan menit di lintang tinggi. Waktu senja juga sedikit meleset: beberapa detik di dekat khatulistiwa dan hingga sekitar satu menit di lintang tinggi.

Dokumentasi API

API kami adalah REST API yang sangat sederhana, Anda hanya perlu melakukan permintaan GET ke https://api.sunrise-sunset.org/json. Tidak perlu mendaftar atau mendapatkan Kunci API.

Parameter permintaan

Contoh permintaan

Berikut adalah tiga contoh permintaan untuk mendapatkan informasi matahari terbenam dan matahari terbit dari API kami untuk lokasi tertentu:


https://api.sunrise-sunset.org/json?lat=36.7201600&lng=-4.4203400

https://api.sunrise-sunset.org/json?lat=36.7201600&lng=-4.4203400&date=today

https://api.sunrise-sunset.org/json?lat=36.7201600&lng=-4.4203400&date=2026-10-15
https://api.sunrise-sunset.org/json?lat=36.7201600&lng=-4.4203400&formatted=0

Respons

Respons API mencakup waktu untuk peristiwa matahari di lokasi yang diberikan. Data diformat menggunakan JSON.

Perhatikan bahwa kecuali Anda menyediakan tzid, semua waktu dalam UTC dan penyesuaian waktu musim panas tidak termasuk dalam data yang dikembalikan.

Contoh respons:


    {
      "results":
      {
        "sunrise":"7:27:02 AM",
        "sunset":"5:05:55 PM",
        "solar_noon":"12:16:28 PM",
        "day_length":"9:38:53",
        "civil_twilight_begin":"6:58:14 AM",
        "civil_twilight_end":"5:34:43 PM",
        "nautical_twilight_begin":"6:25:47 AM",
        "nautical_twilight_end":"6:07:10 PM",
        "astronomical_twilight_begin":"5:54:14 AM",
        "astronomical_twilight_end":"6:38:43 PM"
      },
       "status":"OK",
       "tzid": "UTC"
    }

Respons tanpa format tanggal:


    {
      "results":
      {
        "sunrise":"2015-05-21T05:05:35+00:00",
        "sunset":"2015-05-21T19:22:59+00:00",
        "solar_noon":"2015-05-21T12:14:17+00:00",
        "day_length":51444,
        "civil_twilight_begin":"2015-05-21T04:36:17+00:00",
        "civil_twilight_end":"2015-05-21T19:52:17+00:00",
        "nautical_twilight_begin":"2015-05-21T04:00:13+00:00",
        "nautical_twilight_end":"2015-05-21T20:28:21+00:00",
        "astronomical_twilight_begin":"2015-05-21T03:20:49+00:00",
        "astronomical_twilight_end":"2015-05-21T21:07:45+00:00"
      },
       "status":"OK",
       "tzid": "UTC"
    }

Lihat glosarium definisi astronomi kami untuk memahami setiap elemen dari objek respons.

Kode status

Kolom "status" dalam objek respons API berisi status permintaan. Kolom "status" dapat berisi nilai berikut:

Bagaimana menggunakan API dari permintaan AJAX?

Gunakan parameter callback untuk menerima respons JSONP dan menghindari batasan lintas domain:

https://api.sunrise-sunset.org/json?lat=36.7201600&lng=-4.4203400&callback=mycallback

Batas penggunaan dan atribusi

API matahari terbit dan terbenam dapat digunakan gratis. API ini tidak boleh digunakan melebihi jumlah permintaan yang wajar atau secara berlebihan maupun menyalahgunakan. Atribusi wajib: lihat cara menyebutkan kami.

Pengumuman

Berlangganan buletin API kami untuk mendapatkan informasi terbaru tentang perubahan dan pengumuman layanan:

Dapatkan pemberitahuan setiap ada perubahan: di GitHub, buka repositori API kami dan pilih Watch → Custom → Releases, atau ikuti feed RSS kami.



💡 Punya ide keren? 🤦 Menemukan kesalahan?

Kami selalu berusaha meningkatkan situs ini!

Jika Anda memiliki ide tentang konten atau informasi untuk disertakan di halaman ini atau menemukan kesalahan, silakan beri tahu kami!

Catatan perubahan

Kontak

Silakan hubungi kami untuk semua pertanyaan API Anda.

If you enjoy using our API please consider supporting the project by buying us a coffee!