Buku Resep DSPL

Dokumen ini berisi buku resep tentang konsep DSPL dan kanonik yang berguna "resep". Keduanya memberikan arahan langkah demi langkah untuk berbagai tugas yang melampaui fitur bahasa dasar yang dijelaskan dalam Tutorial dan Panduan Developer. Konten di bawah ini mengasumsikan Anda telah memiliki pengetahuan tentang dokumen-dokumen sebelumnya, jadi pastikan untuk membaca {i>spreadsheet<i} sebelum mulai "memasak".

Setiap resep dimulai dengan tujuan yang diikuti dengan daftar langkah-langkah tertentu untuk mengikuti. Banyak juga yang menyertakan cuplikan atau link DSPL ke contoh eksternal. Jika Anda memiliki masukan tentang resep atau ingin menyarankan orang lain, silakan posting pesan di Forum DSPL.

Resep Dasar

Menentukan nama tampilan

Sasaran

Mengaitkan "nama tampilan" dengan setiap instance (dimensi) konsep. Nama ini akan muncul di UI Penjelajah Data Publik, bukan ID instance konsep, yang umumnya lebih pendek dan lebih sulit bagi pengguna untuk dipahami.

Langkah

  1. Buat konsep Anda memperluas entity:entity.
  2. Menambahkan kolom name ke definisi konsep yang terkait tabel sementara.
  3. Isi properti yang terakhir dengan nama setiap instance.

Catatan

  • Tidak perlu secara eksplisit menentukan properti name di metadata konsep; definisi ini secara otomatis disertakan ketika Anda memperluas entity:entity.
  • Anda juga dapat menambahkan description dan info_url untuk memberikan deskripsi dan URL tingkat instance.

Membuat hierarki konsep

Sasaran

Membuat hierarki konsep (dimensi). Kolom ini akan muncul di UI Penjelajah Data Publik sebagai hierarki, yang memungkinkan pengguna memahami pengelompokan dan menavigasi di antaranya.

Langkah

  1. Menentukan "induk" konsep (mis., region).
  2. Tentukan "turunan" konsep (mis., subregion).
  3. Tambahkan sebuah properti di turunan yang merujuk ke induk dan menyertakan Atribut isParent: 
    <property concept="..." isParent="true"/>
    yang titiknya akan diganti dengan ID induk.
  4. Dalam tabel definisi untuk turunan, tambahkan kolom yang mereferensikan orang tua.
  5. Untuk setiap {i>instance<i} turunan, isi yang terakhir dengan sebuah {i>instance<i} yang valid konsep induk.

Catatan

  • Lihat hubungan country / state di set data tutorial untuk contohnya.
  • Setiap ID induk yang dirujuk dari turunan harus berada di ID induk tabel definisi tinggi tersebut. Jika tidak, pengimpor akan menampilkan error.
  • Induk dan turunan bisa merupakan konsep yang sama (yaitu, referensi mandiri hierarki tertentu). Lihat konsep business di Set Data Penjualan Retail AS sebagai contoh.

Mengategorikan instance konsep

Sasaran

Buat kategori untuk instance konsep yang akan muncul sebagai opsi di pemilih warna Public Data Explorer.

Langkah

  1. Tentukan "kategori" konsep (mis., income_level).
  2. Tentukan "turunan" konsep (mis., country).
  3. Tambahkan sebuah properti di turunan yang merujuk konsep kategori dan berisi Elemen name: 
    <property concept="..."/>
  <info>
    <name><value>"..."</value></name>
  </info>
</property>
    dengan kumpulan titik pertama diganti dengan ID konsep kategori dan kumpulan kedua diganti dengan nama tampilan yang diinginkan untuk properti Anda (mis., "Tingkat Pendapatan").
  4. Dalam tabel definisi untuk turunan, tambahkan kolom yang mereferensikan konsep kategori.
  5. Untuk setiap {i>instance<i} turunan, isi yang terakhir dengan sebuah {i>instance<i} yang valid konsep kategori.

Catatan

  • Konsep dapat memiliki beberapa properti yang berfungsi sebagai kategori; dalam ini, pengguna akan melihat semuanya sebagai opsi di pemilih warna.
  • Salah satu kategori juga dapat menjadi induk untuk tujuan mengatur instance secara hierarkis di UI. Lihat sebelumnya resep untuk detailnya.

Menentukan tata urutan untuk instance konsep

Sasaran

Tentukan tata urutan untuk instance konsep. Urutan ini digunakan saat mencantumkan instance di navigasi kiri Penjelajah Data Publik halaman visualisasi.

Langkah

  1. Buat konsep Anda memperluas entity:entity atau salah satu anak-anak (mis., geo:location).
  2. Tambahkan atribut entity_order ke metadata konsep Anda.
  3. Setel nilai sebelumnya ke salah satu dari ALPHA atau TABLE; yang pertama akan menyebabkan instance terdaftar di urutan nama tampilan, sedangkan yang kedua akan mempertahankan dalam urutan yang sama seperti yang muncul dalam tabel definisi konsep.

Catatan

  • ALPHA adalah setelan default saat ini, jadi jika Anda ingin menggunakannya pemesanan, langkah-langkah di atas bersifat opsional.
  • Lihat entity:entity dokumentasi sebagai contoh.

Resep Waktu

Data triwulanan

Sasaran

Memvisualisasikan data yang ditentukan pada interval tiga bulanan.

Langkah

  1. Konversi semua kuartal dalam data slice Anda menjadi bulan (mis., bulan pertama kuartal).
  2. Perlakukan dimensi ini sebagai time:month di slice Anda XML.

Data mingguan

Sasaran

Visualisasikan data yang ditentukan pada interval mingguan.

Langkah

  1. Mengonversi semua minggu dalam data irisan Anda ke hari (mis., minggu pertama hari).
  2. Perlakukan dimensi ini sebagai time:day dalam XML slice Anda.

Resep Geo

Menggunakan country atau state konsep kanonis

Sasaran

Gunakan konsep country atau state kanonis, mengimpor semua nilai lintang/bujur, dll., sehingga tidak perlu yang ditentukan dalam set data.

Langkah

  1. Pastikan semua referensi negara dan/atau negara bagian AS di CSV data slice adalah ID yang valid dari negara kanonis dan negara bagian definisi tinggi.
  2. Tambahkan geo:country dan/atau geo_us:state sebagai dimensi dalam irisan yang sesuai.
  3. Pastikan nama kolom untuk kolom ini sama dengan nama konsep sebelumnya (tidak termasuk nama set data yang diimpor, mis., country) atau, jika tidak, sertakan mapDimension dalam definisi slice Anda. Contoh: 
    <slice id="...">
  ...
  <dimension concept="geo:country"/>
  ...
  <mapDimension concept="geo:country" toColumn="my_country"/>
</slice>

Hanya menggunakan subset negara kanonis atau negara bagian

Sasaran

Gunakan subset dari konsep geografis kanonis sehingga hanya subset ini (dan bukan seluruh daftar, mis. semua negara di dunia) muncul di ranah Publik UI Data Explorer.

Langkah

  1. Menentukan konsep lokal yang memperluas konsep superset. Contoh: 
    <concept id="my_country_subset" extends="geo:country">
...
</concept>
  2. Dalam CSV definisi konsep yang terkait, hanya sertakan ID konsep superset yang ingin Anda gunakan. Contoh: 
    my_country_subset
FR  
MX
US

Catatan

  • Setiap instance konsep subset Anda harus berupa instance yang valid dari konsep superset; Anda tidak dapat "memperluas" konsep dengan instance Compute Engine.

Menentukan konsep geografis Anda sendiri

Sasaran

Buat konsep geografis Anda sendiri yang dapat dijelajahi dan dipetakan, cukup seperti URL kanonis yang ditentukan Google.

Langkah

  1. Buat konsep yang memperluas geo:location.
  2. Dalam tabel definisi konsep terkait, sertakan kolom name, latitude, dan longitude.
  3. Mengisi properti yang terakhir untuk setiap instance konsep Anda; tindakan nilai garis lintang dan garis bujur mengapung dengan konvensi bahwa N dan E positif, dan W dan S negatif.

Catatan

  • Tidak perlu menyertakan name secara eksplisit, latitude, dan longitude di properti definisi konsep karena hal ini secara otomatis disertakan saat memperluas geo:location.
  • Lihat definisi state dalam set data tutorial untuk contoh.

Resep Metrik dan Unit

Menggunakan persen

Sasaran

Tentukan konsep (metrik) yang merupakan persentase dari sesuatu yang lain.

Langkah

  1. Buat konsep Anda memperluas quantity:ratio.
  2. Tetapkan atribut is_percentage ke true. 
    <attribute id="is_percentage">
  <value>true</value>
</attribute>
  3. Atau, tetapkan atribut percentage_of berdasarkan konsep ini adalah persentase. Contoh: 
    <attribute id="percentage_of">
  <value>labor force</value>
</attribute>

Menggunakan currency unit

Sasaran

Tentukan konsep (metrik) yang memiliki satuan mata uang (mis., dolar AS).

Langkah

  1. Buat metrik Anda memperluas quantity:quantity atau salah satu anak-anak, mis. quantity:amount.
  2. Tambahkan atribut unit yang mereferensikan unit:currency dan tetapkan nilainya ke ID dari definisi mata uang terkait tabel. Contoh: 
    <concept id="...">
  <attribute concept="unit:currency">
    <value>EUR</value>
  </attribute>
</concept>

Membuat unit kustom

Sasaran

Buat unit kustom untuk satu atau beberapa metrik.

Langkah

  1. Buat konsep yang memperluas unit:unit.
  2. Tambahkan kolom unit_text dan symbol ke bagian tabel definisi yang terkait. Selain itu, jika Anda ingin menyesuaikan posisi simbol, Anda juga dapat menambahkan symbol_position .
  3. Isi nilai untuk properti yang terakhir untuk setiap instance unit iklan. Contoh CSV untuk "area" unit: 
    my_unit,unit_text,symbol,symbol_position
SQKM,square kilometers,km²,END
SQML,square miles,miles²,END
  4. Untuk menggunakan unit yang baru Anda buat dalam konsep (metrik), pastikan yang terakhir memperluas quantity:quantity atau salah satu turunannya. Lalu: tambahkan atribut yang merujuk konsep unit Anda. Contoh: 
    <concept id="..." extends="quantity:amount">
  ...
  <attribute concept="my_unit">
    <value>SQKM</value>
  </attribute>
  ...
</concept>

Catatan

  • Jika konsep unit hanya memiliki satu instance, Anda dapat menghilangkan ID dari tabel definisinya serta tag value di metrik yang menggunakannya.
  • Lihat definisi mata uang kanonis konsep untuk contoh lengkap.