Skip to main content

Destinasi Wisata

Mengambil daftar destinasi wisata. Endpoint ini mendukung filtering yang fleksibel.

GET /api/v1/pariwisata/destinasi

Query Parameters​

ParameterTipeWajibDeskripsi
fieldsstringTidakMemilih kolom tertentu yang ingin ditampilkan (dipisahkan koma)
filterobjectTidakFilter data berdasarkan kondisi kolom tertentu
metastringTidakMenampilkan metadata seperti jumlah total (filter_count)
searchstringTidakPencarian teks global di seluruh kolom yang indicable
limitintTidakBatas jumlah data yang diambil (Default: 100)
sortstringTidakUrutkan data (contoh: -date_created untuk descending)

Cara Menggunakan Filter​

Menggunakan format: filter[nama_kolom][operator]=nilai.

Contoh: Untuk mengambil destinasi dengan kategori PKT000001: filter[ktipe_id][_eq]=PKT000001

Operator Umum:

  • _eq: Equal (Sama dengan)
  • _neq: Not Equal (Tidak sama dengan)
  • _contains: Contains (Pencarian teks/Like)
  • _in: In List (Salah satu dari, dipisahkan koma)

Menampilkan Jumlah Data (meta)​

Untuk mengetahui berapa banyak data yang tersedia (misalnya untuk kebutuhan pagination atau sekadar info jumlah destinasi dalam kategori tertentu), gunakan parameter meta=filter_count.

Contoh Kasus: "Saya ingin melihat data destinasi kategori PKT000001 dan ingin tahu ada berapa totalnya."

Query: filter[ktipe_id][_eq]=PKT000001&meta=filter_count

Tips: Anda juga bisa menggunakan parameter search untuk pencarian cepat tanpa menentukan kolom spesifik. Contoh: search=pantai.

Response​

{
  "data": [
      {
          "pr_id": 101,
          "pr_slug": "pantai-sanur",
          "pr_nama": "Pantai Sanur",
          "ktipe_id": "PKT000001",
          "pr_alamat": "Jl. Hang Tuah, Sanur Kaja",
          // lat long lokasi lama
          "pr_latitude": "-8.670458",
          "pr_longitude": "115.260453",
          ...
          // lat long lokasi baru (untuk kebutuhan input data baru yg masih kosong)
          "z_lokasi": { 
            "type": "Point",
            "coordinates": [
              115.24045585201276,
              -8.663350897017054
            ]
          }, 
          "z_perusahaan_gambar": [
            {
              ...
              // path baru gunakan https://dev.denpasarkota.go.id/media/ sebagai baseurlnya
              "prr_resource": "6bffc66d-eb1f-4360-b9e1-5eeeb660fa86",
              // path lama gunakan https://pengaduan.denpasarkota.go.id/ sebagai baseurl nya
              "prr_resource_legacy": "files/wisata_akomodasi/1672276657_download (10).jpg"
              ...
            }
          ]
      }
  ]
}

Demo​

Cobalah request data destinasi dengan filter langsung di sini dengan contoh kondisi data kategori PKT000005, ambil data yg berelasi di tabel lain (gambar destinasi), limit 2 data dan ambil data yang kolom pr_latitude nya tidak bernilai kosong (0) plus info jumlah data yg difilter:

GEThttps://dev.denpasarkota.go.id/api/v1/pariwisata/destinasi?filter[ktipe_id][_eq]=PKT000005&fields=*,z_perusahaan_gambar.prr_resource,z_perusahaan_gambar.prr_resource_legacy&limit=2&[pr_latutude][_neq]=0&meta=filter_count