Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
This quickstart explains how to create a collection in Microsoft Planetary Computer Pro through the web interface.
Prerequisites
To complete this quickstart, you need:
- An Azure account with an active subscription. Use the link Create an account for free.
- An active GeoCatalog instance. Use the link to Create a GeoCatalog.
Navigating the Microsoft Planetary Computer Pro web interface
The Microsoft Planetary Computer Pro web interface is a web-based platform that you use to manage your geospatial data. Access the web interface by using the URI provided in your GeoCatalog resource in Azure portal:
When you enter the web interface, you land on the Planetary Computer Pro page. The page shows your recent collections (if any) and a button to create a new one.
The Collections page provides you with a full list of your collections, including their names, descriptions, date created, and a collection thumbnail. You can also search for collections by name or description keywords, and create a new collection from this page.
The Settings page allows you to create and manage ingestion sources, which is a critical first step in data ingestion. You can learn more about ingestion in Ingestion overview.
The Explorer page is where you can visualize your data on a map. Here, you can search for collections, filter by STAC metadata, and visualize assets. Learn how to use the Explorer in Quickstart: Use the Microsoft Planetary Computer Pro Explorer.
Create a collection
- From the Planetary Computer Pro landing page or the Collections page, select the Create Collection button to open the Create Collection panel. In the panel, enter the details of your collection in JSON format adhering to the STAC specification.
- In the Create Collection panel's JSON editor, the options are:
- Write your own collection JSON
- Use a template collection JSON OR
- Upload a collection JSON from your local machine
The following table describes the standard STAC collection fields. Fields marked as Required must be included in your collection. You can also add custom fields as needed.
| Field | Required | Description |
|---|---|---|
type |
Required | The type of the STAC object, which should be set to Collection. |
stac_version |
Required | The version of the STAC specification that your collection adheres to. |
stac_extensions |
A list of STAC extensions that your collection uses. | |
id |
Required | A unique identifier for your collection. |
title |
A one-line title for your collection. | |
description |
Required | A description of your collection. |
keywords |
A list of keywords that describe your collection. | |
license |
Required | The license for your STAC collection. |
providers |
A list of providers capturing or processing the data for your collection. | |
extent |
Required | The spatial and temporal extent of your collection. |
summaries |
Strongly recommended | A map of property summaries, either a set or range of values. |
links |
Required | A list of links for your collection. |
assets |
A dictionary of asset objects for your collection, each with unique keys. | |
item_assets |
Required for Visualization | A dictionary of assets that can be found in member items. |
Note
The item_assets keys in the STAC collection should match the asset keys present in your STAC items. Mismatches can cause incorrect asset display.
- Once the JSON is complete, select the Create button to create your collection. This selection takes you to the Overview tab of your collection, where you can view and edit your collection's metadata, manage your data ingestions, and configure your collection for visualization in the Explorer.
Next steps
Now that you have a collection, you can ingest data into it.