Cara Pakai Field Calculator QGIS: 24 Ekspresi Teruji dan Jebakannya

Untuk menghitung sebuah kolom di QGIS, buka tabel atribut layer, klik ikon Field Calculator (Ctrl+I), pilih field baru atau yang sudah ada, ketik ekspresi lalu klik OK. Bagian itu cepat. Bagian sulitnya adalah ketika ekspresi berjalan tanpa error tetapi menulis NULL, derajat persegi, atau kelas yang salah.

Pada 7 November 2026 saya menjalankan 24 ekspresi field calculator pada layer OpenStreetMap nyata untuk Indiranagar dan kelurahan di sekitarnya di Bengaluru, India (8.709 bangunan, 854 jalan, 35 sekolah, 37 halte bus, 10 kelurahan), dan menjalankan versi keliru yang umum dari setiap ekspresi di sampingnya. Di bawah ini ada kumpulan resepnya dengan nilai output yang persis, jebakan diam yang diukur terhadap referensi elipsoidal, dan apa yang terjadi saat tiga yang paling sulit saya serahkan ke agen AI di dalam QGIS.

Apa itu Field Calculator QGIS?

Field Calculator QGIS adalah alat bawaan yang membuat atau memperbarui kolom tabel atribut dengan ekspresi QGIS. Alat ini bisa menghitung nilai geometri seperti luas, panjang dan koordinat, mengubah teks, mengelompokkan baris dengan CASE WHEN, dan mengambil jumlah atau jarak dari layer lain di proyek Anda.

Sebenarnya QGIS memberi empat tempat untuk menjalankan ekspresi yang sama, dan salah memilih adalah cara pertama kehilangan hasil kerja:

• Dialog Field Calculator (Ctrl+I): mengedit layer secara langsung. Anda bisa membuat kolom baru atau menimpa kolom yang ada, pada semua fitur atau hanya yang terseleksi. Perubahan tersimpan di buffer edit sampai Anda menyimpan editan.
• Virtual field (kotak centang di dalam dialog): menghitung ekspresi secara langsung setiap kali Anda membuka tabel atau menggambar peta. Saat saya menggandakan tapak bangunan fid 27 di layer uji, kolom luas biasanya tetap 197.355 sementara virtual field berubah menjadi 789.418. Masalahnya, virtual field tersimpan di file proyek .qgs, bukan di GeoPackage atau Shapefile. Buka file itu di proyek baru dan kolomnya hilang.
• Alat Processing "Field calculator" (native:fieldcalculator): menulis layer output yang benar-benar baru dan tidak menyentuh layer asli. Pakai ini di model atau saat Anda tidak ingin mengedit secara langsung. Hati-hati dengan @row_number, yang di sini mulai dari 0 dan di dialog mulai dari 1.
• Bilah kalkulasi cepat di bagian atas tabel atribut: memperbarui kolom yang ada tanpa membuka dialog lengkap, cocok untuk satu baris cepat saat Anda sudah dalam mode edit.

Cara menghitung field langkah demi langkah

Berikut dialognya pada layer jalan, siap menulis kelas jalan:

Saat Anda tidak tahu nama sebuah fungsi, pakai kotak pencarian di atas kolom tengah. Kotak itu menyaring pohon fungsi dan membuka dokumentasi di sebelah kanan, termasuk urutan parameter dan contohnya.

Kumpulan resep ekspresi yang sudah diuji

Setiap ekspresi di bawah dijalankan di QGIS 3.44.15 pada 7 November 2026 di layer OpenStreetMap Bengaluru kami (disimpan dalam EPSG:4326, elipsoid proyek WGS 84). Jika Anda butuh data uji untuk wilayah sendiri, panduan kami tentang cara mengunduh data OpenStreetMap di QGIS menjelaskan cara mengambil bangunan, jalan dan titik dengan rapi.

Contoh output bangunan di bawah berasal dari bangunan fid 27, 28, 30, 60 dan 62 (yang punya alamat dan jumlah lantai) serta fid 1, 2 dan 3 (yang tidak punya keduanya).

Luas, panjang, keliling dan koordinat

Jika Anda menulis $area ke field output Integer alih-alih Decimal number (real) (diuji dengan Field calculator Processing), QGIS membulatkan ke bilangan bulat terdekat (197.35 menjadi 197, 110.86 menjadi 111), bukan memotongnya.

Kelas bersyarat (CASE WHEN dan penanganan NULL)

Merapikan teks, format dan tanggal

Perhatikan juga panjang field output saat menulis teks ke GeoPackage atau Shapefile. Saat saya menjalankan concat("addr:housenumber", ' ', "addr:street") ke field teks dengan panjang 40 di Processing, seluruh proses berhenti tanpa output karena satu jalan (" 80 Feet Road(Sir C.V. Raman Hospital Road)") panjangnya 43 karakter.

Hitungan spasial, jumlah dan jarak terdekat antar layer

Ekspresi ini memungkinkan satu layer menanyai layer lain di proyek Anda tanpa menjalankan spatial join di QGIS secara terpisah.

Lima jebakan field calculator yang gagal tanpa error

Saya membaca 70 komentar minta tolong di bawah tutorial QGIS di YouTube: 48 adalah pertanyaan sungguhan tentang menulis ekspresi, dan 8 di antaranya tentang ekspresi yang tidak valid, menghasilkan NULL atau tidak menyeleksi apa pun. Kasus yang lebih buruk justru yang tidak pernah ditanyakan, karena ekspresinya berjalan dan menulis angka yang tampak masuk akal. Berikut lima jebakan yang kami ukur pada data Bengaluru kami.

1. $area vs area($geometry), dan apa pengaruh elipsoid proyek

$area dan area($geometry) tidak melakukan perhitungan yang sama, dan setidaknya satu tutorial 2026 menyebut $area menghasilkan derajat persegi di CRS geografis. Itu tidak terjadi, di kedua pengaturan proyek yang kami uji. Pada 7 November 2026 kami mengukur keduanya, ditambah transform(), pada 200 bangunan dan 200 jalan pertama di layer Bengaluru EPSG:4326 kami terhadap referensi elipsoidal WGS 84 (QgsDistanceArea).

• $area dan $length memakai elipsoid proyek (diatur di Project > Properties > General > Measurements). Saat elipsoidnya WGS 84, $area menghasilkan meter persegi yang akurat meskipun layer dan proyek Anda dalam derajat (EPSG:4326).
• Saat elipsoid proyek diatur ke None / Planimetric, $area pada layer EPSG:4326 kami tetap tidak menghasilkan derajat persegi. Di QGIS 3.44.15 hasilnya meter persegi yang +3,24% terlalu besar pada 200 bangunan tersebut.
• area($geometry) dan length($geometry) selalu planimetrik dalam CRS layer itu sendiri. Pada layer EPSG:4326, area($geometry) menghasilkan derajat persegi (sekitar 0.0000003 untuk sebuah rumah), yang dibulatkan menjadi 0.0 di kolom desimal standar.
• Transformasi ke Web Mercator (EPSG:3857) sebelum area() membesarkan setiap bangunan +5,95% bahkan di lintang Bengaluru (13° LU), dan membesarkan panjang jalan +3,03%. Transformasi ke zona UTM lokal (EPSG:32643) tetap dalam selisih +0,12% dari luas elipsoidal.

Jika Anda belum paham kenapa EPSG:4326, EPSG:3857 dan zona UTM berperilaku sangat berbeda, baca penjelasan kami tentang apa itu CRS di QGIS.

2. overlay_nearest membaca max_distance dalam satuan layer, bukan meter

Fungsi overlay_nearest cepat karena memakai indeks spasial, dan punya parameter max_distance yang praktis. Tetapi max_distance selalu diukur dalam satuan koordinat layer.

Saat bangunan dan halte bus kami dalam EPSG:4326 (derajat) dan Anda menulis array_length(overlay_nearest('bus_stops', $id, max_distance:=300, limit:=-1)), QGIS mencari halte bus dalam radius 300 derajat. Itu mencakup seluruh Bumi, sehingga setiap bangunan mendapat 37 (semua 37 halte bus di layer). Menebak max_distance:=0.003 untuk 300 meter juga tidak bekerja dengan rapi, karena satu derajat bujur dan satu derajat lintang tidak sama panjangnya dalam meter: pada bangunan fid 62, 0.003 menghasilkan 8 halte, padahal yang benar 7. Proyeksikan ulang kedua layer ke UTM terlebih dahulu, atau pakai pola aggregate(..., filter:=distance(transform(...))) dari baris terakhir tabel spasial di atas.

3. Baris NULL langsung jatuh ke cabang ELSE dari CASE WHEN

Di dataset Bengaluru kami, hanya 1.073 dari 8.709 bangunan (12,3%) yang punya tag building:levels. Sisanya, 7.636, bernilai NULL.

Jika Anda menulis CASE WHEN to_int("building:levels") <= 2 THEN 'low' WHEN to_int("building:levels") <= 4 THEN 'mid' ELSE 'high' END, kedua perbandingan <= bernilai tidak diketahui pada baris NULL, dan baris itu jatuh ke ELSE. Akhirnya 7.636 bangunan tanpa data tergolong menara tinggi tanpa satu peringatan pun. Selalu taruh WHEN "field" IS NULL THEN 'unknown' (atau hilangkan ELSE agar baris yang tidak cocok tetap NULL) sebagai cabang pertama saat data Anda punya celah.

4. "Only update selected features" membuat sisa kolom tetap NULL

Setiap kali ada satu fitur saja yang terseleksi di kanvas peta, Field Calculator otomatis mencentang Only update N selected feature(s).

Saat saya menyeleksi 39 jalan primary di Bengaluru dan menjalankan CASE WHEN "highway" IN ('primary', 'secondary') THEN 'arterial' ELSE 'local' END ke field baru road_rank, QGIS menulis 'arterial' ke 39 baris itu dan membiarkan 815 jalan lainnya (termasuk semua 28 jalan secondary yang jelas disebut dalam ekspresi saya) tetap NULL.

5. Tanda kutip ganda vs kutip tunggal (kenapa "building" = "yes" menghasilkan NULL)

Di ekspresi QGIS, kutip ganda " " berarti nama field dan kutip tunggal ' ' berarti nilai teks.

Jika Anda mengetik "building" = "yes", QGIS mencari kolom bernama building dan membandingkannya dengan kolom lain bernama yes. Karena tidak ada kolom bernama yes, ekspresi bernilai NULL (dan parser QgsExpression di baliknya melaporkan Field 'yes' not found). Begitu juga, jika nama kolom mengandung titik dua, seperti building:levels milik OpenStreetMap, menghilangkan kutip ganda akan gagal dengan syntax error, unexpected Unknown_CHARACTER. Klik dua kali nama field di daftar Fields and Values selalu menyisipkan tanda kutip yang benar.

Lewati sintaksnya: menjalankan kalkulasi yang sama dengan agen AI

Menulis $area dengan tangan itu cepat. Menulis aggregate() bersarang dengan dua panggilan transform(), referensi geometri @parent dan filter jarak adalah titik di mana orang akhirnya bertanya di Stack Exchange.

Kami membuat AI Agent, panel chat yang menempel di dalam QGIS, jadi bagian ini membahas alat kami sendiri. Karena berjalan di dalam proyek QGIS yang sedang Anda buka, alat ini memeriksa nama layer, tipe field, CRS dan nilai unik sebelum menjalankan Field Calculator atau alat Processing untuk Anda.

Pada 7 November 2026 saya memberi AI Agent (v1.9.4, effort Medium, izin Balanced) tiga kalkulasi multi-langkah dari rencana uji kami, satu kalimat per chat, pada lima layer Bengaluru yang persis sama dalam EPSG:4326.

Pada Tugas A, agen tidak terjebak di perangkap 300 derajat overlay_nearest. Log alatnya menunjukkan agen memeriksa kedua layer, mengecek CRS, menjalankan kalkulasi dalam satuan metrik dari tapak bangunan (bukan centroid, yang akan mengubah jawaban pada 667 bangunan), dan memverifikasi nilai min dan maks sebelum menjawab.

Pada Tugas B, agen lebih dulu memeriksa nilai unik building:levels, melihat bahwa 7.636 dari 8.709 bangunan tidak punya jumlah lantai, membiarkan baris itu NULL di height_class alih-alih jatuh ke high, lalu menerapkan style kategori 4 kelas di peta.

Melihat peta hasil render membuat jelas kenapa pengecekan NULL penting pada data OpenStreetMap: bangunan abu-abu adalah 87,7% yang tidak punya tag building:levels.

Pada Tugas C, angka building_ha dari agen sedikit berbeda dari baris hektare per kelurahan di kumpulan resep kami: New Thippasandra keluar 20.151 ha, bukan 20.292 ha (-0,69%), Jeevan Bhimanagar -0.14% dan Indiranagar -0.06%. Saat saya cek penyebabnya, agen ternyata memakai metode geometri yang lebih ketat daripada filter intersects() saya: agen memotong poligon bangunan di batas kelurahan sebelum menjumlahkan luasnya, sehingga bangunan yang melintasi batas tidak terhitung dua kali di dua kelurahan, dan agen mencatat hal itu dalam balasannya. Agen memang membiarkan layer kelurahan dalam mode edit dengan editan yang belum disimpan, dan menyebutkan di jawabannya bahwa editan belum disimpan.

Berikut tabel atribut hasilnya pada layer kelurahan setelah editan itu disimpan:

Tiga tugas adalah sampel kecil (n = 3), dan prompt yang saya berikan jelas serta menyebut nama field dan batas kelas, jadi anggap ini demonstrasi, bukan benchmark. Untuk rumus sederhana seperti $area atau concat(), dialog Field Calculator lebih cepat daripada mengetik pesan chat. Agen berguna saat Anda butuh agregat antar layer, transformasi CRS atau rangkaian Processing multi-langkah, atau saat Anda sebenarnya harus menulis skrip PyQGIS. Anda juga bisa membandingkan asisten lain di hub QGIS AI kami.

Cara kami mengukurnya. Semua pengujian dilakukan pada 7 November 2026 di QGIS 3.44.15-Solothurn di macOS dengan data OpenStreetMap untuk Indiranagar, Bengaluru (bounding box 12.968, 77.634, 12.986, 77.656, ODbL) dalam CRS proyek EPSG:4326. Setiap ekspresi di kumpulan resep diverifikasi terhadap kalkulasi Python atau QgsDistanceArea independen pada ID fitur yang sama. Error luas dan panjang diukur pada 200 bangunan dan 200 jalan pertama menurut fid terhadap QgsDistanceArea dengan elipsoid WGS 84 (EPSG:7030). AI Agent 1.9.4 dijalankan dengan effort Medium dan izin Balanced dalam chat baru untuk setiap tugas. Jumlah pertanyaan YouTube kami berasal dari 70 komentar minta tolong di 59 video yang disaring dari korpus 25.276 komentar.

Pertanyaan yang sering diajukan

Kenapa kalkulasi $area saya salah atau menghasilkan 0 di QGIS?

Pertama, periksa apakah Anda mengetik area($geometry) alih-alih $area. Pada layer yang disimpan dalam derajat (EPSG:4326), area($geometry) menghasilkan derajat persegi (sekitar 0.0000003 untuk sebuah rumah), yang dibulatkan menjadi 0.0 di field desimal. Pakai $area dengan elipsoid proyek diatur ke WGS 84 di Project > Properties > General > Measurements, atau proyeksikan ulang geometri di dalam ekspresi dengan area(transform($geometry, 'EPSG:4326', 'EPSG:32643')) memakai zona UTM lokal Anda. Hindari EPSG:3857 (Web Mercator), yang membesarkan luas bangunan +5,95% bahkan di 13° LU dalam pengujian kami.

Bagaimana cara menulis pernyataan IF atau CASE di Field Calculator QGIS?

Untuk dua hasil, pakai if(condition, value_if_true, value_if_false), misalnya if($area < 100, 'small', 'large'). Untuk tiga kelas atau lebih, pakai CASE WHEN ... THEN ... ELSE ... END:

CASE WHEN to_int("building:levels") IS NULL THEN 'unknown' WHEN to_int("building:levels") <= 2 THEN 'low' WHEN to_int("building:levels") <= 4 THEN 'mid' ELSE 'high' END

Taruh pengecekan IS NULL di awal. Jika tidak, setiap baris dengan nilai kosong jatuh ke ELSE.

Kenapa Field Calculator menghasilkan NULL untuk semua atau sebagian besar baris saya?

Empat penyebab umum:

1. Ada fitur yang terseleksi di peta, sehingga Only update N selected feature(s) tercentang dan setiap baris yang tidak terseleksi tetap NULL.
2. Anda menggabungkan teks dengan || (seperti "addr:housenumber" || ' ' || "addr:street"), di mana satu input NULL membuat seluruh hasil menjadi NULL. Pakai concat() sebagai gantinya.
3. Anda memberi kutip ganda pada nilai teks ("building" = "yes"), yang membuat QGIS mencari kolom bernama yes. Pakai kutip tunggal untuk nilai ("building" = 'yes').
4. Anda memakai $x atau $y pada layer poligon atau garis. $x hanya bekerja pada titik; pakai x(centroid($geometry)) untuk poligon.

Bagaimana cara menghitung luas dalam hektare di Field Calculator QGIS?

Atur Output field type ke Decimal number (real), atur Precision ke 2 atau 3, lalu masukkan $area / 10000 (dengan asumsi satuan luas proyek Anda meter persegi dan elipsoid proyek sudah diatur di Project > Properties > General). Untuk membulatkan nilai yang disimpan itu sendiri ke 3 angka desimal, pakai round($area / 10000, 3).

Bagaimana cara memperbarui hanya fitur yang terseleksi di Field Calculator?

Seleksi fitur di kanvas peta atau di tabel atribut terlebih dahulu, lalu buka Field Calculator (Ctrl+I). Kotak centang Only update N selected feature(s) di kiri atas akan tercentang otomatis. Pilih Update existing field, pilih kolomnya dari dropdown, masukkan ekspresi dan klik OK.

Coba AI Agent gratis