BAB 3: Nama di Atas Peta: Label yang Terbaca

#Studi kasus: "Petak yang mana itu?"

Peta sudah berwarna rapi. Namun Kepala Seksi menunjuk satu kotak hijau tua dan bertanya, "Ini petak berapa, volumenya berapa?" Analis Muda harus membuka tabel setiap kali. Solusinya adalah label: nama dan angka yang tertulis langsung di atas objek.

#Konsep: label dalam tiga kalimat

Label adalah teks yang diambil dari kolom atribut dan ditempel di peta. Bayangkan papan nama petak di lapangan: satu tulisan singkat yang memberi tahu identitas tempat itu. Label yang baik pendek, kontras dengan latarnya, dan tidak saling bertumpuk.

Istilah baru bab ini:

• Label: teks dari atribut yang tampil di peta.
• Ekspresi label: rumus kecil yang menyusun isi label dari beberapa kolom.
• Halo (buffer teks): garis tepi di sekeliling huruf agar terbaca di atas warna apa pun.
• Penempatan (placement): aturan letak label terhadap objeknya.

#Aturan label yang baik

• Pendek. ID petak dan satu angka cukup. Nama panjang membuat peta penuh.
• Kontras. Huruf gelap di atas warna muda. Bila latar bervariasi, beri halo putih.
• Satu ukuran huruf untuk satu jenis objek. Ukuran 8 sampai 10 poin cukup untuk A4.
• Jangan menimpa objek penting. Bila label menutupi titik panas, geser atau kecilkan.

#Ekspresi label

Label tidak harus satu kolom. Ekspresi bisa menggabungkan beberapa kolom dan menangani sel kosong. Contoh pada petak:

"ID_Petak" || '\n' ||
coalesce(to_string(round("Volume_m3ha")) || ' m3/ha', 'belum diukur')

Cara membacanya: ambil ID_Petak, pindah baris (\n), lalu tulis volume yang dibulatkan dan satuannya. Fungsi coalesce memakai teks cadangan belum diukur bila volume kosong. Hasil uji di QGIS 4.0.2 (Skrip 4.3):

pengaturan = QgsPalLayerSettings()
pengaturan.fieldName = ekspresi
pengaturan.isExpression = True
garis = QgsTextBufferSettings()
garis.setEnabled(True)
garis.setSize(0.8)
garis.setColor(QColor("white"))
teks.setBuffer(garis)
pengaturan.setFormat(teks)
petak.setLabeling(QgsVectorLayerSimpleLabeling(pengaturan))
petak.setLabelsEnabled(True)

#Cek paham

1. Mengapa label diberi halo putih?
2. Apa fungsi coalesce pada ekspresi label?
3. Mengapa sebagian label tidak tampil walau sudah dinyalakan?

Jawaban:

1. Agar huruf tetap terbaca di atas warna apa pun, terutama warna tua.
2. Memakai teks cadangan bila kolom kosong, sehingga label tidak hilang atau berbunyi "NULL".
3. QGIS menyembunyikan label yang tidak muat atau bertabrakan supaya peta tidak penuh.

#Kesalahan umum

• Label terlalu panjang. Peta penuh teks. Pakai ID atau singkatan, simpan nama lengkap di tabel.
• Satuan lupa ditulis. Angka 46 membingungkan. Tulis 46 m3/ha.
• Tanda kutip tertukar. Dalam ekspresi, nama kolom memakai tanda kutip ganda dan teks memakai tanda kutip tunggal. Tertukar berarti galat atau label salah.
• Ukuran huruf berubah saat dicetak. Ukuran huruf label dihitung dalam poin pada skala layout. Periksa label pada tampilan layout (Bab 4), bukan hanya di kanvas.

#Ringkasan dan latihan

Ringkasan: label mengambil teks dari atribut. Buat pendek, kontras, dan beri halo. Ekspresi menggabungkan kolom dan menangani sel kosong.

Latihan: ubah ekspresi sehingga petak berusia di atas 15 tahun (selisih tahun ini dan Tahun_Tanam) menampilkan tambahan teks "tua". Petunjuk: pakai if(...) dan year(now()).

#Tabel perbandingan: label