Stac Items - Get Features
Ambil fitur koleksi fitur dengan id collectionId
.
Setiap fitur dalam himpunan data termasuk dalam koleksi. Himpunan data dapat terdiri dari beberapa kumpulan fitur. Kumpulan fitur seringkali merupakan kumpulan fitur dengan jenis yang sama, berdasarkan skema umum.")
GET https://contoso-catalog.gwhqfdeddydpareu.uksouth.geocatalog.spatio.azure.com/stac/collections/{collectionId}/items?api-version=2025-04-30-preview
GET https://contoso-catalog.gwhqfdeddydpareu.uksouth.geocatalog.spatio.azure.com/stac/collections/{collectionId}/items?api-version=2025-04-30-preview&limit={limit}&bbox={bbox}&datetime={datetime}
Parameter URI
Nama | Dalam | Diperlukan | Jenis | Deskripsi |
---|---|---|---|---|
collection
|
path | True |
string maxLength: 500pattern: .* |
ID koleksi katalog |
api-version
|
query | True |
string minLength: 1 |
Versi API yang digunakan untuk operasi ini. |
bbox
|
query |
string[] |
Hanya fitur yang memiliki geometri yang bersinggungan dengan kotak pembatas yang dipilih. Kotak pembatas disediakan sebagai empat atau enam angka, tergantung pada apakah sistem referensi koordinat mencakup sumbu vertikal (tinggi atau kedalaman):
Sistem referensi koordinat dari nilai-nilai adalah WGS 84 bujur/lintang (http://www.opengis.net/def/crs/OGC/1.3/CRS84). Untuk WGS 84 bujur/lintang, nilainya dalam banyak kasus adalah urutan bujur minimum, garis lintang minimum, bujur maksimum dan lintang maksimum. Namun, dalam kasus di mana kotak mencakup antimeridian, nilai pertama (tepi kotak paling barat) lebih besar dari nilai ketiga (tepi kotak paling timur). Jika sumbu vertikal disertakan, angka ketiga dan keenam adalah bagian bawah dan atas kotak pembatas 3 dimensi. Jika fitur memiliki beberapa properti geometri spasial, itu adalah keputusan server apakah hanya satu properti geometri spasial yang digunakan untuk menentukan luas atau semua geometri yang relevan. |
|
datetime
|
query |
string |
Baik tanggal-waktu atau interval, terbuka atau tertutup. Ekspresi tanggal dan waktu mematuhi RFC 3339. Interval terbuka dinyatakan menggunakan titik ganda. Contoh:
Hanya fitur yang memiliki properti temporal yang memotong nilai yang Jika fitur memiliki beberapa properti temporal, itu adalah keputusan server apakah hanya satu properti temporal yang digunakan untuk menentukan cakupan atau semua properti temporal yang relevan. |
|
limit
|
query |
integer (int64) |
Parameter batas opsional merekomendasikan jumlah item yang harus ada dalam dokumen respons. Jika nilai parameter batas lebih besar dari batas maksimum yang diiklankan, server harus mengembalikan jumlah item maksimum yang mungkin, bukan merespons dengan kesalahan. Hanya item yang dihitung yang berada di tingkat pertama koleksi dalam dokumen respons. Objek berlapis yang terkandung dalam item yang diminta secara eksplisit tidak boleh dihitung. Minimum = 1. Maksimum = 10000. Default = 10. |
Respons
Nama | Jenis | Deskripsi |
---|---|---|
200 OK |
Permintaan telah berhasil. |
|
Other Status Codes |
Respons kesalahan tak terduga. Header x-ms-error-code: string |
Keamanan
OAuth2Auth
Jenis:
oauth2
Alur:
implicit
URL Otorisasi:
https://login.microsoftonline.com/common/oauth2/authorize
Cakupan
Nama | Deskripsi |
---|---|
https://geocatalog.spatio.azure.com/.default |
Contoh
StacItems_GetFeatures
Permintaan sampel
GET https://contoso-catalog.gwhqfdeddydpareu.uksouth.geocatalog.spatio.azure.com/stac/collections/example-collection/items?api-version=2025-04-30-preview
Respon sampel
{
"type": "FeatureCollection",
"features": [
{
"id": "S2A_MSIL2A_20231017T013651_R117_T53SPA_20231017T053413",
"bbox": [
136.11023969131566,
36.03410504840171,
137.35846754627107,
37.041254047568394
],
"type": "Feature",
"links": [
{
"rel": "collection",
"type": "application/json",
"href": "https://sample.cmbtazhseqhgeudd.uksouth.geocatalog.spatio.azure.com/stac/collections/example-collection"
},
{
"rel": "parent",
"type": "application/json",
"href": "https://sample.cmbtazhseqhgeudd.uksouth.geocatalog.spatio.azure.com/stac/collections/example-collection"
},
{
"rel": "root",
"type": "application/json",
"href": "https://sample.cmbtazhseqhgeudd.uksouth.geocatalog.spatio.azure.com/stac/"
},
{
"rel": "self",
"type": "application/geo+json",
"href": "https://sample.cmbtazhseqhgeudd.uksouth.geocatalog.spatio.azure.com/stac/collections/example-collection/items/S2A_MSIL2A_20231017T013651_R117_T53SPA_20231017T053413"
}
],
"assets": {
"predict": {
"href": "https://sample.blob.core.windows.net/example-collection-16f38ddf/c8a/S2A_MSIL2A_20231017T013651_R117_T53SPA_20231017T053413/predict.tif",
"type": "image/tiff; application=geotiff; profile=cloud-optimized",
"description": "Argmax-parsed inference values."
},
"softmax": {
"href": "https://sample.blob.core.windows.net/example-collection-16f38ddf/c8a/S2A_MSIL2A_20231017T013651_R117_T53SPA_20231017T053413/softmax.tif",
"type": "image/tiff; application=geotiff; profile=cloud-optimized",
"description": "Maximum raw inference values converted to uint8."
}
},
"_msft:ts": "2024-09-26T17:46:10.688245Z",
"geometry": {
"type": "Polygon",
"coordinates": [
[
[
136.11023969131566,
36.05158282566385
],
[
137.32861422946507,
36.03410504840171
],
[
137.35846754627107,
37.02313780213882
],
[
136.12448554733595,
37.041254047568394
],
[
136.11023969131566,
36.05158282566385
]
]
]
},
"_msft:etag": "e99a9415-f26f-48ad-9553-3a5dd7260cde",
"collection": "example-collection",
"properties": {
"datetime": "2023-10-17T01:36:51.024000Z",
"proj:bbox": [
600000,
3990240,
709800,
4100040
],
"proj:epsg": 32653,
"proj:shape": [
10980,
10980
],
"s2:mgrs_tile": "53SPA",
"proj:geometry": {
"type": "Polygon",
"coordinates": [
[
[
600000,
3990240
],
[
709800,
3990240
],
[
709800,
4100040
],
[
600000,
4100040
],
[
600000,
3990240
]
]
]
},
"eo:cloud_cover": 19.538534,
"proj:transform": [
10,
0,
600000,
0,
-10,
4100040,
0,
0,
1
],
"s2:nodata_pixel_percentage": 0.000129
},
"stac_extensions": [
"https://stac-extensions.github.io/projection/v1.1.0/schema.json"
],
"stac_version": "1.0.0"
},
{
"id": "S2A_MSIL2A_20220927T155031_R054_T18SWJ_20220928T114234",
"bbox": [
-75.00023345437725,
38.75403604777881,
-73.71871965133354,
39.75026792656398
],
"type": "Feature",
"links": [
{
"rel": "collection",
"type": "application/json",
"href": "https://sample.cmbtazhseqhgeudd.uksouth.geocatalog.spatio.azure.com/stac/collections/example-collection"
},
{
"rel": "parent",
"type": "application/json",
"href": "https://sample.cmbtazhseqhgeudd.uksouth.geocatalog.spatio.azure.com/stac/collections/example-collection"
},
{
"rel": "root",
"type": "application/json",
"href": "https://sample.cmbtazhseqhgeudd.uksouth.geocatalog.spatio.azure.com/stac/"
},
{
"rel": "self",
"type": "application/geo+json",
"href": "https://sample.cmbtazhseqhgeudd.uksouth.geocatalog.spatio.azure.com/stac/collections/example-collection/items/S2A_MSIL2A_20220927T155031_R054_T18SWJ_20220928T114234"
}
],
"assets": {
"predict": {
"href": "https://sample.blob.core.windows.net/example-collection-16f38ddf/a0d/S2A_MSIL2A_20220927T155031_R054_T18SWJ_20220928T114234/predict.tif",
"type": "image/tiff; application=geotiff; profile=cloud-optimized",
"description": "Argmax-parsed inference values."
},
"softmax": {
"href": "https://sample.blob.core.windows.net/example-collection-16f38ddf/a0d/S2A_MSIL2A_20220927T155031_R054_T18SWJ_20220928T114234/softmax.tif",
"type": "image/tiff; application=geotiff; profile=cloud-optimized",
"description": "Maximum raw inference values converted to uint8."
}
},
"_msft:ts": "2024-09-26T17:46:10.600092Z",
"geometry": {
"type": "Polygon",
"coordinates": [
[
[
-75.00023019602958,
38.7608644567278
],
[
-73.73659678081167,
38.75403604777881
],
[
-73.71871965133354,
39.74319619168244
],
[
-75.00023345437725,
39.75026792656398
],
[
-75.00023019602958,
38.7608644567278
]
]
]
},
"_msft:etag": "785107b1-f6a0-4b6f-af44-774373438280",
"collection": "example-collection",
"properties": {
"datetime": "2022-09-27T15:50:31.024000Z",
"proj:bbox": [
499980,
4290240,
609780,
4400040
],
"proj:epsg": 32618,
"proj:shape": [
10980,
10980
],
"s2:mgrs_tile": "18SWJ",
"proj:geometry": {
"type": "Polygon",
"coordinates": [
[
[
499980,
4290240
],
[
609780,
4290240
],
[
609780,
4400040
],
[
499980,
4400040
],
[
499980,
4290240
]
]
]
},
"proj:projjson": {
"id": {
"code": 32618,
"authority": "EPSG"
},
"name": "WGS 84 / UTM zone 18N",
"type": "ProjectedCRS",
"$schema": "https://proj.org/schemas/v0.4/projjson.schema.json",
"base_crs": {
"id": {
"code": 4326,
"authority": "EPSG"
},
"name": "WGS 84",
"datum": {
"name": "World Geodetic System 1984",
"type": "GeodeticReferenceFrame",
"ellipsoid": {
"name": "WGS 84",
"semi_major_axis": 6378137,
"inverse_flattening": 298.257223563
}
},
"coordinate_system": {
"axis": [
{
"name": "Geodetic latitude",
"unit": "degree",
"direction": "north",
"abbreviation": "Lat"
},
{
"name": "Geodetic longitude",
"unit": "degree",
"direction": "east",
"abbreviation": "Lon"
}
],
"subtype": "ellipsoidal"
}
},
"conversion": {
"name": "UTM zone 18N",
"method": {
"id": {
"code": 9807,
"authority": "EPSG"
},
"name": "Transverse Mercator"
},
"parameters": [
{
"id": {
"code": 8801,
"authority": "EPSG"
},
"name": "Latitude of natural origin",
"unit": "degree",
"value": 0
},
{
"id": {
"code": 8802,
"authority": "EPSG"
},
"name": "Longitude of natural origin",
"unit": "degree",
"value": -75
},
{
"id": {
"code": 8805,
"authority": "EPSG"
},
"name": "Scale factor at natural origin",
"unit": "unity",
"value": 0.9996
},
{
"id": {
"code": 8806,
"authority": "EPSG"
},
"name": "False easting",
"unit": "metre",
"value": 500000
},
{
"id": {
"code": 8807,
"authority": "EPSG"
},
"name": "False northing",
"unit": "metre",
"value": 0
}
]
},
"coordinate_system": {
"axis": [
{
"name": "Easting",
"unit": "metre",
"direction": "east",
"abbreviation": ""
},
{
"name": "Northing",
"unit": "metre",
"direction": "north",
"abbreviation": ""
}
],
"subtype": "Cartesian"
}
},
"eo:cloud_cover": 0.015263,
"proj:transform": [
10,
0,
499980,
0,
-10,
4400040,
0,
0,
1
],
"s2:nodata_pixel_percentage": 43.417341
},
"stac_extensions": [
"https://stac-extensions.github.io/projection/v1.1.0/schema.json"
],
"stac_version": "1.0.0"
}
],
"links": [
{
"rel": "collection",
"type": "application/json",
"href": "https://sample.cmbtazhseqhgeudd.uksouth.geocatalog.spatio.azure.com/stac/collections/example-collection"
},
{
"rel": "parent",
"type": "application/json",
"href": "https://sample.cmbtazhseqhgeudd.uksouth.geocatalog.spatio.azure.com/stac/collections/example-collection"
},
{
"rel": "root",
"type": "application/json",
"href": "https://sample.cmbtazhseqhgeudd.uksouth.geocatalog.spatio.azure.com/stac/"
},
{
"rel": "self",
"type": "application/geo+json",
"href": "https://sample.cmbtazhseqhgeudd.uksouth.geocatalog.spatio.azure.com/stac/collections/example-collection/items"
},
{
"rel": "next",
"type": "application/geo+json",
"method": "GET",
"href": "https://sample.cmbtazhseqhgeudd.uksouth.geocatalog.spatio.azure.com/stac/collections/example-collection/items?api-version=2025-04-30-preview&limit=2&token=next:example-collection:S2A_MSIL2A_20220927T155031_R054_T18SWJ_20220928T114234"
}
]
}
Definisi
Nama | Deskripsi |
---|---|
Asset |
https://github.com/radiantearth/stac-spec/blob/v1.0.0/item-spec/item-spec.md#asset-object Mewakili aset STAC, yang merupakan file atau sumber daya yang terkait dengan item STAC. |
Azure. |
Objek kesalahan. |
Azure. |
Respons yang berisi detail kesalahan. |
Azure. |
Objek yang berisi informasi yang lebih spesifik tentang kesalahan. Sesuai panduan Microsoft One API - https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errors. |
Context |
Informasi konteks untuk respons penelusuran termasuk detail penomoran halaman. |
Feature |
Pengidentifikasi jenis untuk objek Fitur GeoJSON |
Item |
https://github.com/radiantearth/stac-spec/blob/v1.0.0/item-spec/itemcollection-spec.md Mewakili kumpulan Item STAC sebagai GeoJSON FeatureCollection. |
Item |
Mewakili jenis koleksi fitur GeoJSON untuk koleksi item STAC. |
Item |
Properti Item STAC yang berisi metadata tentang aset. https://github.com/radiantearth/stac-spec/blob/v1.0.0/item-spec/item-spec.md#properties-object |
Link |
Model tautan. Ref: http://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/schemas/link.yaml Mewakili tautan. |
Link |
Jenis MIME untuk tautan. |
Provider |
Mewakili informasi tentang penyedia data untuk koleksi dan item STAC. |
Stac |
Mewakili Item STAC, yang merupakan Fitur GeoJSON dengan metadata tambahan. |
Asset
https://github.com/radiantearth/stac-spec/blob/v1.0.0/item-spec/item-spec.md#asset-object
Mewakili aset STAC, yang merupakan file atau sumber daya yang terkait dengan item STAC.
Nama | Jenis | Deskripsi |
---|---|---|
constellation |
string |
Konstelasi satelit yang memperoleh data. |
created |
string (date-time) |
Stempel waktu pembuatan data. |
description |
string |
Deskripsi rinci tentang aset. |
gsd |
number (float) |
Jarak sampel tanah dalam meter. |
href |
string minLength: 1 |
URL ke file aset. |
instruments |
string[] |
Instrumen yang memperoleh data. |
mission |
string |
Misi yang terkait dengan data. |
platform |
string |
Platform yang memperoleh data. |
providers |
Provider[] |
Organisasi atau individu yang menyediakan data. |
roles |
string[] |
Peran aset dalam item. |
title |
string |
Judul yang dapat dibaca manusia untuk aset. |
type |
string |
Jenis media aset. |
updated |
string (date-time) |
Stempel waktu pembaruan terakhir dari data. |
Azure.Core.Foundations.Error
Objek kesalahan.
Nama | Jenis | Deskripsi |
---|---|---|
code |
string |
Salah satu sekumpulan kode kesalahan yang ditentukan server. |
details |
Array detail tentang kesalahan tertentu yang menyebabkan kesalahan yang dilaporkan ini. |
|
innererror |
Objek yang berisi informasi yang lebih spesifik daripada objek saat ini tentang kesalahan. |
|
message |
string |
Representasi kesalahan yang dapat dibaca manusia. |
target |
string |
Target kesalahan. |
Azure.Core.Foundations.ErrorResponse
Respons yang berisi detail kesalahan.
Nama | Jenis | Deskripsi |
---|---|---|
error |
Objek kesalahan. |
Azure.Core.Foundations.InnerError
Objek yang berisi informasi yang lebih spesifik tentang kesalahan. Sesuai panduan Microsoft One API - https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errors.
Nama | Jenis | Deskripsi |
---|---|---|
code |
string |
Salah satu sekumpulan kode kesalahan yang ditentukan server. |
innererror |
Kesalahan dalam. |
ContextExtension
Informasi konteks untuk respons penelusuran termasuk detail penomoran halaman.
Nama | Jenis | Deskripsi |
---|---|---|
limit |
integer (int32) |
Jumlah maksimum item yang diminta. |
matched |
integer (int32) |
Jumlah total item yang cocok dengan kueri. |
returned |
integer (int32) |
Jumlah item yang dikembalikan dalam respons. |
FeatureType
Pengidentifikasi jenis untuk objek Fitur GeoJSON
Nilai | Deskripsi |
---|---|
Feature |
Pengidentifikasi jenis fitur GeoJSON standar |
ItemCollection
https://github.com/radiantearth/stac-spec/blob/v1.0.0/item-spec/itemcollection-spec.md
Mewakili kumpulan Item STAC sebagai GeoJSON FeatureCollection.
Nama | Jenis | Nilai default | Deskripsi |
---|---|---|---|
bbox |
number[] (double) |
Kotak pembatas semua item dalam format [barat, selatan, timur, utara]. |
|
context |
Informasi konteks untuk respons pencarian. |
||
features |
Stac |
Array Item STAC dalam koleksi. |
|
links |
Link[] |
Tautan ke sumber daya dan titik akhir terkait. |
|
msft:_created |
string |
MSFT Dibuat |
|
msft:_updated |
string |
MSFT Diperbarui |
|
msft:short_description |
string maxLength: 300 |
Deskripsi Singkat MSFT |
|
stac_extensions |
string[] |
URL ke ekstensi STAC yang diterapkan oleh resource STAC ini. |
|
stac_version |
string minLength: 1 |
1.0.0 |
Versi Stac |
type |
Jenis GeoJSON FeatureCollection. |
ItemCollectionType
Mewakili jenis koleksi fitur GeoJSON untuk koleksi item STAC.
Nilai | Deskripsi |
---|---|
FeatureCollection |
Jenis GeoJSON FeatureCollection standar. |
ItemProperties
Properti Item STAC yang berisi metadata tentang aset.
https://github.com/radiantearth/stac-spec/blob/v1.0.0/item-spec/item-spec.md#properties-object
Nama | Jenis | Deskripsi |
---|---|---|
constellation |
string |
Konstelasi satelit yang memperoleh data. |
created |
string (date-time) |
Stempel waktu pembuatan data. |
datetime |
string |
Tanggalwaktu aset diwakili dalam format RFC 3339. |
description |
string |
Deskripsi rinci tentang item tersebut. |
end_datetime |
string (date-time) |
Waktu akhir periode pengamatan item. |
gsd |
number (float) |
Jarak sampel tanah dalam meter. |
instruments |
string[] |
Instrumen yang memperoleh data. |
mission |
string |
Misi yang terkait dengan data. |
platform |
string |
Platform yang memperoleh data. |
providers |
Provider[] |
Organisasi atau individu yang menyediakan data. |
start_datetime |
string (date-time) |
Waktu mulai periode pengamatan item. |
title |
string |
Judul yang dapat dibaca manusia untuk item tersebut. |
updated |
string (date-time) |
Stempel waktu pembaruan terakhir dari data. |
Link
Model tautan.
Ref: http://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/schemas/link.yaml
Mewakili tautan.
Nama | Jenis | Nilai default | Deskripsi |
---|---|---|---|
body |
object |
Untuk permintaan POST, sumber daya dapat menentukan isi HTTP sebagai objek JSON. |
|
headers |
object |
Pasangan nilai kunci-objek yang dipetakan ke header. Contoh: { "Terima": "aplikasi/json" }. |
|
href |
string |
URL tautannya. |
|
hreflang |
string |
Bahasa sumber daya tertaut. |
|
length |
integer (int32) |
Panjang sumber daya yang ditautkan. |
|
merge |
boolean |
False |
Menunjukkan apakah klien diharapkan untuk menggabungkan nilai isi ke dalam isi permintaan saat ini sebelum mengikuti tautan. Ini hanya berlaku ketika server merespons permintaan POST. Nilai awal: false. |
method |
enum:
|
GET |
Menentukan metode HTTP yang diharapkan sumber daya. Default: GET. |
rel |
string |
Jenis hubungan tautan. |
|
title |
string |
Judul tautan. |
|
type | application/json |
Jenis MIME dari sumber daya tertaut. |
LinkType
Jenis MIME untuk tautan.
Nilai | Deskripsi |
---|---|
application/geo+json |
Mewakili aplikasi/geo+json. |
application/json |
Mewakili aplikasi/json. |
application/x-binary |
Mewakili aplikasi/x-biner. |
application/x-protobuf |
Mewakili aplikasi/x-protobuf. |
application/xml |
Mewakili aplikasi/xml. |
image/jp2 |
Mewakili gambar/jp2. |
image/jpeg |
Mewakili gambar/jpeg. |
image/jpg |
Mewakili gambar/jpg. |
image/png |
Mewakili gambar/png. |
image/tiff; application=geotiff |
Mewakili gambar/tiff dengan application=geotiff. |
image/webp |
Mewakili gambar/webp. |
text/html |
Mewakili teks/html. |
text/plain |
Mewakili teks/polos. |
Provider
Mewakili informasi tentang penyedia data untuk koleksi dan item STAC.
Nama | Jenis | Deskripsi |
---|---|---|
description |
string |
Deskripsi penyedia. |
name |
string minLength: 1 |
Nama penyedia, organisasi, atau individu. |
roles |
string[] |
Peran yang dimainkan oleh penyedia (misalnya, produser, prosesor, host). |
url |
string |
URL ke situs web penyedia. |
StacItem
Mewakili Item STAC, yang merupakan Fitur GeoJSON dengan metadata tambahan.
Nama | Jenis | Nilai default | Deskripsi |
---|---|---|---|
_msft:etag |
string |
MSFT ETag |
|
_msft:ts |
string |
Stempel Waktu MSFT |
|
assets |
<string, Asset> |
Aset |
|
bbox |
number[] (double) |
Koordinat kotak pembatas untuk fitur |
|
collection |
string |
ID koleksi STAC milik item ini. |
|
geometry |
Geo |
Objek geometri yang menentukan bentuk fitur |
|
id |
string |
ID unik untuk fitur |
|
links |
Link[] |
Tautan ke sumber daya dan titik akhir terkait. |
|
msft:_created |
string |
MSFT Dibuat |
|
msft:_updated |
string |
MSFT Diperbarui |
|
msft:short_description |
string maxLength: 300 |
Deskripsi Singkat MSFT |
|
properties |
Atribut yang terkait dengan fitur |
||
stac_extensions |
string[] |
URL ke ekstensi STAC yang diterapkan oleh resource STAC ini. |
|
stac_version |
string minLength: 1 |
1.0.0 |
Versi Stac |
type |
Pengidentifikasi jenis GeoJSON untuk Fitur |