Catatan
Akses ke halaman ini memerlukan otorisasi. Anda dapat mencoba masuk atau mengubah direktori.
Akses ke halaman ini memerlukan otorisasi. Anda dapat mencoba mengubah direktori.
Artikel ini memberikan gambaran umum spesifikasi Katalog Aset SpatioTemporal (STAC) dan cara penggunaannya oleh Microsoft Planetary Computer Pro.
Spesifikasi STAC
Spesifikasi STAC adalah standar terbuka berbasis komunitas yang memudahkan untuk menemukan, menggabungkan, dan menggunakan data geospasial. STAC menyediakan struktur umum untuk menjelaskan dan membuat katalog "aset spatiotemporal." Ini berarti Anda dapat menggunakannya untuk mengindeks dan mengatur data di seluruh ruang dan waktu.
Akibatnya, STAC memungkinkan organisasi untuk membuat aset geospasial mereka dapat diakses oleh berbagai pengguna. Katalog STAC dapat digunakan untuk mengatur banyak jenis data aset geospasial, termasuk:
- Citra satelit, udara, dan drone
- Data LIDAR dan SAR
- Video Gerakan Penuh
- Data hiperspektral
- Format data turunan lainnya
Selain itu, STAC dapat digunakan dengan format data cloud-native yang ada dan muncul seperti Cloud Optimized GeoTIFFs (COGs) dan GeoParquet.
Sejak dirilis pada tahun 2018, banyak organisasi dengan cepat mengadopsi STAC untuk mengatur data spasial mereka. Organisasi-organisasi ini termasuk operator satelit, lembaga pemerintah, kelompok masyarakat sipil, dan perusahaan komersial.
Spesifikasi STAC terdiri dari empat standar pelengkap untuk menjelaskan aset geospasial, mengatur aset tersebut menjadi grup, dan membuat aset tersebut dapat dicari melalui API umum. Secara khusus, standar STAC ini meliputi:
Planetary Computer Pro menggunakan spesifikasi STAC di semua aspek manajemen data.
Katalog STAC
Pengantar GeoCatalogs
Layanan Planetary Computer Pro memungkinkan Anda membuat sumber daya GeoCatalog di langganan Azure Anda, untuk menyerap, mengelola, mencari, dan mendistribusikan himpunan data geospasial. GeoCatalog adalah sumber daya Azure yang, dari perspektif API STAC, secara logis setara dengan Katalog STAC. Katalog STAC adalah objek tingkat atas dalam hierarki STAC yang secara logis mengelompokkan koleksi STAC dan Item STAC. Anda dapat melihat JSON Katalog STAC untuk GeoCatalog tertentu menggunakan penampil web JSON dengan masuk ke https://<your geocatalog uri>/json-api?path=/. Lihat Spesifikasi Katalog STAC untuk mempelajari selengkapnya tentang spesifikasi Katalog STAC.
GeoCatalog didefinisikan menggunakan informasi berikut:
| Bidang | Deskripsi |
|---|---|
| Langganan | Langganan Azure di mana instance GeoCatalog diterapkan |
| Grup Sumber Daya | Grup sumber daya Azure tempat instans GeoCatalog disebarkan |
| Nama | Nama sebuah instans GeoCatalog |
| Wilayah | Wilayah Azure tempat instance GeoCatalog diterapkan. |
Saat ini, Planetary Computer Pro dapat menyebarkan GeoCatalogs di wilayah Azure berikut:
- Amerika Serikat Bagian Timur
- Amerika Serikat Tengah Utara
- Eropa Barat
- Kanada Tengah
GeoCatalog dapat disediakan menggunakan portal Microsoft Azure atau Azure Rest API. Untuk mempelajari cara menyebarkan GeoCatalog ke langganan Azure Anda, baca membuat sumber daya GeoCatalog.
Koleksi STAC
Pengantar koleksi
GeoCatalog memungkinkan Anda membuat koleksi untuk menyimpan dan mengatur himpunan data geospasial di Azure. Koleksi STAC digunakan untuk menjelaskan sekelompok Item STAC yang berbagi properti dan metadata, seperti area geografis atau sensor umum. Lihat Spesifikasi koleksi STAC untuk mempelajari lebih lanjut tentang konsep koleksi STAC.
Definisi koleksi
Planetary Computer Pro mematuhi spesifikasi koleksi STAC yang mendefinisikan sekumpulan bidang umum untuk menjelaskan himpunan data dan Item yang disertakan.
Dalam koleksi, Anda dapat menentukan jenis dan struktur data yang disimpan dalam koleksi tersebut. Anda juga dapat menambahkan pengaturan konfigurasi render untuk memvisualisasikan data dalam koleksi menggunakan Penjelajah Planetary Computer Pro.
Koleksi dalam GeoCatalog didefinisikan dalam format JSON dan menyertakan bidang berikut:
| Bidang | Deskripsi |
|---|---|
| Nomor Identitas | Wajib - Identifikasi untuk koleksi yang unik di antara semua penyedia. |
| Tipe | Wajib - Jenis elemen STAC; harus "koleksi." |
| Judul | Judul deskriptif pendek satu baris untuk suatu koleksi. |
| Deskripsi | Wajib - Deskripsi multibaris terperinci untuk sepenuhnya menjelaskan koleksi. |
| Lisensi | Lisensi koleksi tersebut harus ada. |
| Sejauh | Wajib - Menjelaskan tingkat spasial (bujur/lintang) dan temporal (rentang tanggal) koleksi. |
| Penyedia | Salah satu organisasi yang mengambil atau memproses konten koleksi. |
| Ringkasan | Daftar pasangan kunci-nilai yang memberikan gambaran umum tentang properti Item yang disertakan. |
| Aset Koleksi | File data yang terkait langsung dengan koleksi, misalnya, gambar mini. |
| Aset untuk Item | Informasi detail tentang berkas data yang dimasukkan dalam item koleksi. Untuk informasi selengkapnya, lihat Aset Barang. |
| Link | Diperlukan - Daftar objek tautan ke sumber daya dan URL terkait. |
| Kata Kunci | Daftar kata kunci yang menjelaskan koleksi. |
| Versi STAC | Wajib - Versi STAC yang digunakan oleh koleksi data. |
Item aset
Bidang item_assets , di tingkat koleksi, menyediakan cara untuk menentukan aset (file data) apa yang tersedia di Item anak mana pun. Aset yang tercantum di bidang ini tidak menyiratkan bahwa semua aset tersedia untuk semua Item (harus menjadi penyatuan aset yang tersedia, bukan persimpangan aset yang tersedia). Bidang ini diaktifkan dalam GeoCatalog melalui ekstensi item_assets spesifikasi STAC. Ekstensi aset item diperlukan jika Anda ingin memvisualisasikan Item di Penjelajah GeoCatalog.
Bidang item_assets itu sendiri adalah objek, dengan setidaknya dua bidang berikut:
| Bidang | Tipe | Deskripsi |
|---|---|---|
| judul | benang | Judul yang ditampilkan untuk klien dan pengguna. |
| deskripsi | benang | Deskripsi Aset yang memberikan detail selengkapnya, seperti bagaimana aset tersebut diproses atau dibuat. |
| tipe | benang | Jenis media aset. |
| Peran | daftar string | Peran semantik aset, mirip dengan penggunaan rel dalam tautan. |
Contoh JSON koleksi
Contoh berikut menunjukkan koleksi minimal JSON. Untuk bidang lainnya, lihat spesifikasi koleksi STAC.
{
"id": "example-collection",
"type": "Collection",
"title": "Example collection",
"description": "An example collection",
"license": "CC-BY-4.0",
"extent": {
"spatial": {
"bbox": [
[
-180,
-90,
180,
90
]
]
},
"temporal": {
"interval": [
[
"2018-01-01T00:00:00Z",
"2018-12-31T23:59:59Z"
]
]
}
},
"links": [],
"stac_version": "1.0.0"
}
Untuk contoh JSON yang sedikit lebih kompleks, lihat contoh ini yang menjelaskan himpunan data terbuka dari Program Citra Pertanian Nasional (NAIP).
Konfigurasi kumpulan
Untuk memvisualisasikan koleksi di Penjelajah GeoCatalog, ada beberapa konfigurasi yang harus ditentukan, termasuk:
Item STAC
Pengantar elemen STAC
GeoCatalog memungkinkan Anda menyimpan dan mengatur himpunan data geospasial ke dalam koleksi. Item STAC adalah objek inti dalam koleksi GeoCatalog, yang berisi metadata untuk adegan dan tautan ke aset dari adegan tersebut (seperti gambar satelit). Metadata Item memungkinkan GeoCatalog untuk mencari dan mengkueri aset spasial. Lihat Spesifikasi Item STAC untuk mempelajari selengkapnya tentang Item STAC.
Definisi item
Planetary Computer Pro mematuhi Spesifikasi Item STAC yang menentukan sekumpulan bidang umum untuk menjelaskan Item, seperti rentang waktu dan aset yang terkait dengan Item. Item didefinisikan dalam format JSON dan dapat diperluas secara fleksibel untuk menyertakan lebih banyak metadata.
Item STAC yang valid memerlukan bidang berikut:
| Bidang | Deskripsi |
|---|---|
| Nomor Identitas | Wajib - identifikasi unik untuk Item di seluruh koleksi induk Item |
| Tipe | Wajib - Jenis Objek GeoJSON; harus "Fitur" |
| Geometri | Wajib - menentukan jejak lengkap aset yang diwakili oleh Item ini sebagai Objek Geometri GeoJSON |
| Kotak Pembatas | Diperlukan - koordinat kotak pembatas aset yang diwakili oleh item ini |
| Karakteristik | Diperlukan - Metadata lain untuk Item |
| Aset | Wajib - aset data yang terkait dengan Item, masing-masing dengan kunci unik |
| Koleksi | Wajib - ID koleksi induk Item |
| Link | Wajib - Daftar objek tautan ke sumber daya dan URL terkait |
| Versi STAC | Diperlukan - Versi STAC yang digunakan oleh Item |
Metadata umum untuk Item di luar bidang yang diperlukan ini mencakup tanggal dan waktu, lisensi, penyedia, instrumen, dan lainnya.
Contoh Item JSON
Contoh berikut menunjukkan item dasar JSON.
{
"stac_version": "1.0.0",
"stac_extensions": [],
"type": "Feature",
"id": "20201211_223832_CS2",
"bbox": [
172.91173669923782,
1.3438851951615003,
172.95469614953714,
1.3690476620161975
],
"geometry": {
"type": "Polygon",
"coordinates": [
[
[
172.91173669923782,
1.3438851951615003
],
[
172.95469614953714,
1.3438851951615003
],
[
172.95469614953714,
1.3690476620161975
],
[
172.91173669923782,
1.3690476620161975
],
[
172.91173669923782,
1.3438851951615003
]
]
]
},
"properties": {
"datetime": "2020-12-11T22:38:32.125000Z"
},
"collection": "simple-collection",
"links": [
{
"rel": "collection",
"href": "./collection.json",
"type": "application/json",
"title": "Simple example collection"
},
{
"rel": "root",
"href": "./collection.json",
"type": "application/json",
"title": "Simple example collection"
},
{
"rel": "parent",
"href": "./collection.json",
"type": "application/json",
"title": "Simple example collection"
}
],
"assets": {
"visual": {
"href": "[URL]",
"type": "image/tiff; application=geotiff; profile=cloud-optimized",
"title": "3-Band Visual",
"roles": [
"visual"
]
},
"thumbnail": {
"href": "[URL]",
"title": "Thumbnail",
"type": "image/jpeg",
"roles": [
"thumbnail"
]
}
}
}
Ekstensi STAC
Saat ini, GeoCatalog secara otomatis menambahkan ekstensi berikut ke semua koleksi yang diserap:
Ekstensi STAC juga dapat digunakan di tingkat Item STAC. Pengguna bebas untuk menambahkan ekstensi STAC lain yang mereka inginkan, tetapi GeoCatalog saat ini tidak memvalidasi ekstensi.
Untuk daftar lengkap ekstensi STAC, termasuk kematangan masing-masing ekstensi, lihat halaman ekstensi STAC di GitHub.
STAC API
API Planetary Computer Pro sesuai dengan spesifikasi API STAC, memungkinkan Anda mencari himpunan data skala petabyte dengan cepat dan mudah untuk menemukan aset data tertentu yang memenuhi kebutuhan Anda. Setelah aset ini diidentifikasi, Anda dapat melihat atau mengunduh aset menggunakan API GeoCatalog.