Bagikan melalui

Parameter yang dapat dikueri untuk filter pencarian kustom di Microsoft Planetary Computer Pro Data Explorer

Gambaran Umum

Di Microsoft Planetary Computer Pro, sumber daya GeoCatalog mengatur himpunan data ke dalam Koleksi STAC. Setiap Koleksi Katalog Aset SpatioTemporal (STAC) berisi sekumpulan Item STAC, dan banyak dari item ini memiliki metadata di dalamnya properties.

Queryables memungkinkan pelanggan menentukan bidang metadata mana dan properties yang harus muncul sebagai filter kustom. Filter kustom dapat dipilih di Data Explorer dan memungkinkan penentuan nilai untuk properties selama pencarian.

Prasyarat

Apa itu Queryable?

Yang dapat dicari adalah atribut dari metadata Item STAC yang ditingkatkan dalam antarmuka Planetary Computer Data Explorer agar lebih mudah untuk dicari. Queryables muncul di bawah 'Filter khusus,' yang dapat diakses dengan mengklik 'Tingkat Lanjut' di panel 'Jelajahi dataset'.

Misalnya, dari blok ini properties pada Item STAC:

"properties": {
  "gsd": 0.6,
  "datetime": "2022-09-23T16:00:00Z",
  "naip:year": "2022",
  ...
}

Gsd (jarak sampel tanah; resolusi spasial yang diukur dalam meter/piksel) dan naip:year (tahun gambar diperoleh) adalah properti yang dapat dicari dalam koleksi ini. Oleh karena itu mereka dapat ditambahkan sebagai filter kustom untuk kemudahan pencarian di Data Explorer. Properti datetime secara otomatis disertakan sebagai filter kustom di Data Explorer untuk semua koleksi.

Mengonfigurasi Queryables dari Halaman Koleksi

Pada halaman arahan koleksi, pilih tombol Konfigurasi untuk membuka panel Edit Konfigurasi Koleksi .

Di dalam panel ini, masuk ke tab Queryables.

Di sini, Anda dapat menambahkan daftar konfigurasi properti yang dapat dikueri. Setiap entri harus mencakup:

  • "name" : nama properti di field properties di item STAC.
  • "definition" : skema JSON yang menentukan jenis data properti dan, secara opsional, nilai yang diizinkan dan judul tampilan.

Konfigurasi contoh:

[
  {
    "name": "gsd",
    "definition": {
      "type": "number"
    }
  },
  {
    "name": "naip:year",
    "definition": {
      "enum": [
        "2010",
        "2011",
        "2012",
        "2013",
        "2014",
        "2015",
        "2016",
        "2017",
        "2018",
        "2019",
        "2020",
        "2021",
        "2022",
        "2023",
        "2024",
        "2025"
      ],
      "type": "string",
      "title": "Year"
    }
  }
]

Setiap bidang yang dapat "definition" dikueri menjelaskan fitur properti item STAC dan bagaimana properti ini ditampilkan di Data Explorer. Ini mendukung kunci berikut:

  • "type" (wajib):
    Jenis data yang diharapkan untuk properti. Harus salah satu dari:

    • "string"
    • "number"
    • "boolean"

  • "enum" (opsional):
    Daftar nilai yang diizinkan. Jika disediakan, opsi enumerasi muncul sebagai kotak centang di Data Explorer untuk pilihan yang lebih mudah.

  • "title" (opsional):
    Nama tampilan yang mudah digunakan untuk filter seperti yang ditunjukkan di Explorer. Jika judul tidak ditentukan, secara default, nama yang dapat dikueri digunakan sebagai judul.

Kueri yang dikonfigurasi pengguna muncul di Explorer di bawah antarmuka pencarian Tingkat Lanjut .

Pilih Tingkat Lanjut untuk mengungkapkan Filter kustom. Secara default, filter berikut ini tersedia:

  • Diperoleh (berdasarkan rentang datetime)
  • Item ID

Setiap kueri yang ditambahkan ke konfigurasi Queryables koleksi, seperti Gsd dan Tahun dalam contoh sebelumnya, muncul sebagai opsi filter lainnya.

Anda dapat mengalihkan filter mana yang terlihat menggunakan kontrol Pilih filter .

Konten terkait