Notitie
Voor toegang tot deze pagina is autorisatie vereist. U kunt proberen u aan te melden of mappen te wijzigen.
Voor toegang tot deze pagina is autorisatie vereist. U kunt proberen om mappen te wijzigen.
Dit artikel bevat een overzicht van de STAC-specificatie (SpatioTemporal Asset Catalog) en hoe Microsoft Planetary Computer Pro deze gebruikt.
STAC-specificatie
De STAC-specificatie is een open, communitygestuurde standaard waarmee u eenvoudig georuimtelijke gegevens kunt vinden, combineren en gebruiken. STAC biedt een algemene structuur voor het beschrijven en catalogiseren van 'spatiotemporale assets'. Met deze structuur kunt u gegevens indexeren en ordenen in zowel ruimte als tijd.
Met STAC kunnen organisaties hun georuimtelijke assets toegankelijk maken voor een breed scala aan gebruikers. U kunt STAC-catalogi gebruiken om veel soorten georuimtelijke assetgegevens te organiseren, waaronder:
- Satelliet-, lucht- en dronebeelden
- LIDAR- en SAR-gegevens
- Volledige Bewegingsvideo
- Hyperspectrale gegevens
- Andere afgeleide gegevensindelingen
Daarnaast kunt u STAC gebruiken met bestaande en opkomende cloudeigen gegevensindelingen, zoals Cloud Optimized GeoTIFFs (COG's) en GeoParquet.
Sinds de release in 2018 hebben veel organisaties STAC snel aangenomen om hun ruimtelijke gegevens te organiseren. Deze organisaties omvatten satellietoperators, overheidsinstanties, maatschappelijke groepen en commerciële bedrijven.
De STAC-specificatie bestaat uit vier aanvullende standaarden voor het beschrijven van georuimtelijke assets, het organiseren van deze assets in groepen en het doorzoeken van deze assets via algemene API's. Deze STAC-standaarden zijn met name:
Planetary Computer Pro maakt gebruik van de STAC-specificatie voor alle aspecten van gegevensbeheer.
STAC-catalogi
Inleiding tot GeoCatalogs
Met de Planetary Computer Pro-service kunt u een GeoCatalog-resource maken in uw Azure-abonnement voor het opnemen, beheren, zoeken en distribueren van georuimtelijke gegevenssets. Een GeoCatalog is een Azure-resource die, vanuit het perspectief van de STAC-API, logisch gelijk is aan een STAC-catalogus. Een STAC-catalogus is het object op het hoogste niveau in de STAC-hiërarchie waarmee STAC-verzamelingen en STAC-items logisch worden gegroepeerd. U kunt de JSON van de STAC-catalogus voor een specifieke GeoCatalog bekijken met behulp van de JSON-viewer en er naartoe gaan via https://<your geocatalog uri>/json-api?path=/. Zie STAC Catalog Spec voor meer informatie over de STAC-catalogusspecificatie.
Een GeoCatalog wordt gedefinieerd met behulp van de volgende informatie:
| Veld | Beschrijving |
|---|---|
| Abonnement | Azure-abonnement waarin u het GeoCatalog-exemplaar implementeert |
| Resourcegroep | Azure-resourcegroep waar u het GeoCatalog-exemplaar implementeert |
| Naam | Naam van het GeoCatalog-exemplaar |
| Regio | Azure-regio waar u het GeoCatalog-exemplaar implementeert |
Op dit moment kan Planetary Computer Pro GeoCatalogs implementeren in de volgende Azure-regio's:
- Oostelijke VS
- Noord-Centraal VS
- West-Europa
- Centraal Canada
- UK South
- Amerikaanse overheid Virginia
U kunt een GeoCatalog implementeren met behulp van Azure Portal of de Azure REST API. Zie Een GeoCatalog-resource maken voor meer informatie over het implementeren van een GeoCatalog in uw Azure-abonnement.
STAC-verzamelingen
Inleiding tot verzamelingen
Met een GeoCatalog kunt u verzamelingen maken voor het opslaan en organiseren van georuimtelijke gegevenssets in Azure. Gebruik een STAC-verzameling om een groep STAC-items te beschrijven die eigenschappen en metagegevens delen, zoals een gemeenschappelijk geografisch gebied of sensor. Zie de specificatie van de STAC-verzameling voor meer informatie over het concept van de STAC-verzameling.
Verzamelingsdefinitie
Planetary Computer Pro voldoet aan de STAC-verzamelingsspecificatie, waarmee een set algemene velden wordt gedefinieerd om de gegevensset en opgenomen items te beschrijven.
Binnen een verzameling kunt u het type en de structuur opgeven van gegevens die in die verzameling zijn opgeslagen. U kunt ook renderconfiguratie-instellingen toevoegen om gegevens in de verzameling te visualiseren met behulp van Planetary Computer Pro's Explorer.
U definieert verzamelingen in GeoCatalog in JSON-indeling. De definitie bevat de volgende velden:
| Veld | Beschrijving |
|---|---|
| ID-kaart | Vereist: id voor de verzameling die uniek is in de provider. |
| Typologie | Vereist - STAC-elementtype; moet 'verzameling' zijn. |
| Titel | Korte beschrijvende titel van één regel voor de verzameling. |
| Beschrijving | Vereist: Gedetailleerde beschrijving met meerdere regels ter volledige uitleg van de collectie. |
| Licenties | Vereist: de licenties van de verzameling. |
| Mate | Vereist: beschrijft de ruimtelijke (lengtegraad/breedtegraad) en tijdelijke (datumbereik) gebieden van de verzameling. |
| Aanbieders | Organisaties die de inhoud van de verzameling vastleggen of verwerken. |
| Samenvattingen | Lijst met sleutel-waardeparen die een overzicht bieden van de eigenschappen van de opgenomen items. |
| Verzamelingsassets | Gegevensbestanden die rechtstreeks aan de verzameling zijn gekoppeld, zoals een miniatuurafbeelding. |
| Itemactiva's | Details over de gegevensbestanden die zijn opgenomen in de items van de verzameling. Zie Itemonderdelen voor meer informatie. |
| Verwijzingen | Vereist: lijst met koppelingsobjecten naar resources en gerelateerde URL's. |
| Zoekwoorden | Lijst met trefwoorden die de verzameling beschrijven. |
| STAC-versie | Vereist: STAC-versie die door de verzameling wordt gebruikt. |
Itembezittingen
In item_assets het veld op verzamelingsniveau ziet u welke assets (gegevensbestanden) beschikbaar zijn in een onderliggend item. De vermelde activa in dit veld impliceren niet dat alle assets beschikbaar zijn voor alle items. Het veld toont de samenvoeging van de beschikbare activa, niet het snijpunt. U schakelt dit veld in een GeoCatalog in via de item_assets uitbreiding van de STAC-specificatie. U hebt de item-assetsextensie nodig als u Items wilt visualiseren in de GeoCatalog Explorer.
Het item_assets veld is een object met ten minste twee van de volgende velden:
| Veld | Typologie | Beschrijving |
|---|---|---|
| titel | touw | De weergegeven titel voor clients en gebruikers. |
| beschrijving | touw | Een beschrijving van het activum dat meer details biedt, zoals hoe deze is verwerkt of gemaakt. |
| soort | touw | Mediatype van de asset. |
| Rollen | lijst met tekenreeksen | De semantische rollen van de asset, vergelijkbaar met het gebruik van rel in koppelingen. |
Voorbeelden van JSON-verzameling
In het volgende voorbeeld ziet u een minimale JSON-verzameling. Zie de specificatie van de STAC-verzameling voor meer velden.
{
"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"
}
Zie dit voorbeeld voor een iets complexere JSON met een beschrijving van een open gegevensset van het National Agriculture Imagery Program (NAIP).
Verzamelingsconfiguratie
Als u verzamelingen in GeoCatalog Explorer wilt visualiseren, moet u verschillende configuraties definiëren, waaronder:
STAC-items
Inleiding tot STAC-items
Een GeoCatalog slaat georuimtelijke gegevenssets op en ordent deze in verzamelingen. Een STAC-item is het kernobject in de verzameling GeoCatalog. Het bevat metagegevens voor een scène en koppelingen naar assets uit die scène, zoals een satellietafbeelding. Met de metagegevens van een item kan GeoCatalog ruimtelijke bronnen doorzoeken en opvragen. Zie STAC-itemspecificatie voor meer informatie over STAC-items.
Itemdefinitie
De Planetary Computer Pro voldoet aan de STAC-itemspecificatie, waarmee een set algemene velden wordt gedefinieerd voor het beschrijven van een item, zoals het tijdsbereik en de activa die betrekking hebben op het item. U definieert items in JSON-indeling en kunt ze flexibel uitbreiden om meer metagegevens op te nemen.
Voor een geldig STAC-item zijn de volgende velden vereist:
| Veld | Beschrijving |
|---|---|
| ID-kaart | Vereist - identificatie voor het item dat uniek is binnen de bovenliggende verzameling. |
| Typologie | Vereist - GeoJSON-objecttype; moet 'Functie' zijn |
| Meetkunde | Vereist: definieert de volledige footprint van het asset dat door dit item wordt vertegenwoordigd als een GeoJSON-geometrieobject. |
| Begrenzingsvak | Vereist - coördinaten van het omgrenzingskader van het bestanddeel dat door dit item wordt vertegenwoordigd |
| Eigenschappen | Vereist : andere metagegevens voor het item |
| Activa | Vereist: gegevensassets die zijn gekoppeld aan het item, elk met een unieke sleutel |
| Verzameling | Vereist - ID van de bovenliggende verzameling van het item |
| Verwijzingen | Vereist: lijst met koppelingsobjecten naar resources en gerelateerde URL's |
| STAC-versie | Vereist : STAC-versie die wordt gebruikt door het item |
Algemene metagegevens voor items buiten deze vereiste velden omvatten datum en tijd, licenties, providers, instrument en meer.
JSON-voorbeeld van item
In het volgende voorbeeld ziet u een JSON-basisitem.
{
"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"
]
}
}
}
STAC-extensies
Op dit moment voegt een GeoCatalog automatisch de volgende extensies toe aan alle opgenomen verzamelingen:
U kunt ook STAC-extensies gebruiken op stac-itemniveau.
Opmerking
STAC-items, inclusief extensies, worden gevalideerd met behulp van de PySTAC-bibliotheek. Als er STAC-validatiefouten optreden, probeer dan de extensie te verwijderen.
Zie de pagina STAC-extensies op GitHub voor een volledige lijst met STAC-extensies, inclusief de volwassenheid van elke extensie.
STAC-API
De API's van Planetary Computer Pro voldoen aan de STAC API-specificatie, zodat u snel en eenvoudig gegevenssets op petabyte-schaal kunt doorzoeken om specifieke gegevensassets te vinden die aan uw behoeften voldoen. Zodra u deze assets hebt geïdentificeerd, kunt u de assets bekijken of downloaden met behulp van de API's van GeoCatalog.