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.
Microsoft Planetary Computer Pro is an Azure cloud service for storing, cataloging, and securely distributing geospatial data across an enterprise. This Get Started guide assists you with the basics of deploying the service and creating your first SpatioTemporal Asset Catalog (STAC) Collection to store and distribute your geospatial data.
Prerequisites
- An Azure account and subscription Create an account for free.
Table of Contents
Deploy a GeoCatalog Resource in your Azure Subscription
A Microsoft Planetary Computer Pro deployment is called a GeoCatalog and is available to deploy through the Azure portal.
To deploy a GeoCatalog, navigate to the Azure portal and search for "GeoCatalog"
Full details of the deployment process are available in the Deploy GeoCatalog Quickstart.
Once the service is deployed, access to the GeoCatalog resource can be controlled through the Access control (IAM) tab in the left sidebar:
More details on the GeoCatalog Administrator and GeoCatalog Reader roles are available in Manage Access documentation.
Create a STAC Collection to organize your data
All data managed in Microsoft Planetary Computer Pro is organized into groupings conforming to the STAC Collection standard.
To create a new STAC Collection, open the GeoCatalog web interface by clicking on the GeoCatalog URI link on the Resource overview page in the Azure Portal. After opening the web interface, select the Create collection button:
More details setting up your STAC collection can be found in the Create Collection from the Web Interface and Create Collection from the API quickstarts.
Ingest Data into a STAC Collection
Ingestion is the process of copying your data from an external data store to your GeoCatalog resource and cataloging it. Data that isn't in a cloud-optimized format is converted into cloud-optimized format during ingestion.
The recommended and most secure method for ingesting data is to have the data stored in Azure Blob Storage and for you to provide read access to Blob Storage container using Managed Identity.
Warning
All data ingested into Planetary Computer Pro requires STAC Items.
Tip
To accelerate the creation of STAC Items, we have a detailed tutorial and also have an open source tool called STAC Forge.
Get your data ready for Ingestion
- Set up Managed Identity Access to your Azure Blob Storage
- Create STAC Items for your data
- Ingest Your Data a single item at a time or through bulk ingestion
Configure Your STAC Collection for Visualization
Ingested data can be visualized both in the built-in Data Explorer or through your own applications.
Note
A STAC Collection must be configured to support visualization before it is visible in the Data Explorer.
Planetary Computer Pro's Tiler service requires configuration to properly display your ingested data. All of these configuration options are available under the Configuration tab in the STAC Collection view:
Get your STAC Collection ready for Visualization
Connect and Build Applications with your Data
Once data has been ingested, it's available for use in applications inside and outside of Microsoft Planetary Computer Pro.
Data that is configured for visualization can be searched and viewed through the Data Explorer tab.
Data can also be accessed directly using the GeoCatalog APIs. For details on establishing permissions for your applications, review the Application Authentication documentation.
Planetary Computer Pro supports connecting collections to ESRI's ArcGIS Pro Service to enable GIS-type work flows.
Get help
- Review the rest of the documentation for relevant articles
- Check out Microsoft Q&A to ask a question or find answers from others
- File a Support Ticket
Next steps
To get started with an end-to-end workflow, try this interactive tutorial: