Skip to content

Commit a57cf92

Browse files
committed
Updates based on MS Learn feedback
1 parent b757698 commit a57cf92

2 files changed

Lines changed: 19 additions & 19 deletions

File tree

articles/planetary-computer/configure-qgis.md

Lines changed: 19 additions & 19 deletions
Original file line numberDiff line numberDiff line change
@@ -48,36 +48,36 @@ Register QGIS as an application in Microsoft Entra ID and grant it delegated per
4848

4949
In the Azure portal, go to Microsoft Entra ID > App registrations > New registration:
5050

51-
[![App registrations page with New registration button highlighted.](./media/app-registration.png)](./media/app-registration.png#lightbox)
51+
[![Screenshot of the App registrations page with the New registration button highlighted.](./media/app-registration.png)](./media/app-registration.png#lightbox)
5252

5353
### Register the application
5454
1. Enter a descriptive name for the application.
5555
2. For supported account types, select the tenant option your organization uses (single tenant or multitenant only).
5656
3. Under Redirect URI, choose Public client/native (mobile & desktop) and set the URI to `http://localhost:7070`.
5757
4. Select Register.
58-
[![New app registration form with name, account type, and redirect URI fields populated.](./media/qgis-registration.png)](./media/qgis-registration.png#lightbox)
58+
[![Screenshot of the New app registration form with the name, account type, and redirect URI fields populated.](./media/qgis-registration.png)](./media/qgis-registration.png#lightbox)
5959

6060
### Configure API permissions
6161

6262
Configure delegated API permissions:
6363

6464
1. In the app registration, select **API permissions** > **Add a permission**.
6565

66-
[![API permissions blade listing current delegated permissions.](./media/qgis-api-permissions.png)](./media/qgis-api-permissions.png#lightbox)
66+
[![Screenshot of the API permissions blade listing current delegated permissions.](./media/qgis-api-permissions.png)](./media/qgis-api-permissions.png#lightbox)
6767

6868
2. Select **APIs my organization uses**, search for `Azure Orbital Spatio`, and pick the service to open the permission dialog.
6969

70-
[![Permission selection dialog with Azure Orbital Spatio API highlighted.](./media/add-azure-orbital-spatio.png)](./media/add-azure-orbital-spatio.png#lightbox)
70+
[![Screenshot of the permission selection dialog with the Azure Orbital Spatio API highlighted.](./media/add-azure-orbital-spatio.png)](./media/add-azure-orbital-spatio.png#lightbox)
7171

7272
3. In **Request API permissions**, select **Delegated permissions**, check **user_impersonation**, and then select **Add permissions** to grant the scope.
7373

74-
[![Request API permissions dialog with user_impersonation delegated scope selected.](./media/configure-api-permissions.png)](./media/configure-api-permissions.png#lightbox)
74+
[![Screenshot of the Request API permissions dialog with the user_impersonation delegated scope selected.](./media/configure-api-permissions.png)](./media/configure-api-permissions.png#lightbox)
7575

76-
### Reviewing the Application and Directory ID
76+
### Reviewing the Application and Directory IDs
7777

7878
Return to **Overview** and record the **Application (client) ID** and **Directory (tenant) ID**. You need to enter them in QGIS later to configure the STAC connection.
7979

80-
[![Overview page displaying Application (client) ID and Directory (tenant) ID values.](./media/qgis-client-id.png)](./media/qgis-client-id.png#lightbox)
80+
[![Screenshot of the Overview page displaying the Application (client) ID and Directory (tenant) ID values.](./media/qgis-client-id.png)](./media/qgis-client-id.png#lightbox)
8181

8282
## Configure QGIS for GeoCatalog access
8383

@@ -89,22 +89,22 @@ Create the STAC connection inside QGIS by following these steps:
8989

9090
1. In the **Browser** panel, expand **STAC** to view the connection menu.
9191
2. Right-click **STAC** and select **New STAC Connection** to open the configuration dialog.
92-
[![QGIS Browser panel context menu with New STAC Connection selected.](./media/qgis-add-stac-catalog.png)](./media/qgis-add-stac-catalog.png#lightbox)
92+
[![Screenshot of the QGIS Browser panel context menu with New STAC Connection selected.](./media/qgis-add-stac-catalog.png)](./media/qgis-add-stac-catalog.png#lightbox)
9393

9494
### Configure STAC connection authentication
9595

9696
1. In the "Name" field, name this connection.
9797
2. Enter the URL of your GeoCatalog and add the STAC API path by appending `/stac` to the URL.
9898
3. Select the **plus (+)** button to configure the authentication.
99-
[![STAC connection dialog showing URL field and authentication button.](./media/qgis-stac-connection-configuration.png)](./media/qgis-stac-connection-configuration.png#lightbox)
99+
[![Screenshot of the STAC connection dialog showing the URL field and authentication button.](./media/qgis-stac-connection-configuration.png)](./media/qgis-stac-connection-configuration.png#lightbox)
100100

101101
### STAC connection authentication configuration
102102

103103
1. From Authentication, select **Microsoft Planetary Computer**.
104-
[![Authentication profile list with Microsoft Planetary Computer selected.](./media/select-microsoft-planetary-computer.png)](./media/select-microsoft-planetary-computer.png#lightbox)
104+
[![Screenshot of the authentication profile list with Microsoft Planetary Computer selected.](./media/select-microsoft-planetary-computer.png)](./media/select-microsoft-planetary-computer.png#lightbox)
105105

106106
2. Select **Planetary Computer Pro** from the "Server type" drop-down.
107-
[![Authentication server type list with Planetary Computer Pro selected.](./media/select-microsoft-planetary-computer-pro.png)](./media/select-microsoft-planetary-computer-pro.png#lightbox)
107+
[![Screenshot of the authentication server type list with Planetary Computer Pro selected.](./media/select-microsoft-planetary-computer-pro.png)](./media/select-microsoft-planetary-computer-pro.png#lightbox)
108108

109109
3. Enter the following information into the text boxes:
110110

@@ -113,7 +113,7 @@ Create the STAC connection inside QGIS by following these steps:
113113
- [Application and Directory ID](#reviewing-the-application-and-directory-id)
114114

115115

116-
[![Completed STAC authentication settings with client and tenant IDs populated.](./media/authorization-configuration.png)](./media/authorization-configuration.png#lightbox)
116+
[![Screenshot of the completed STAC authentication settings with client and tenant IDs populated.](./media/authorization-configuration.png)](./media/authorization-configuration.png#lightbox)
117117

118118
Once these settings are complete, your GeoCatalog is configured for access through the QGIS STAC connection.
119119

@@ -123,33 +123,33 @@ To browse the collections, select your GeoCatalog in the data layer browser, and
123123

124124
Once you expand, QGIS will redirect you to a web browser to authenticate with Microsoft Entra. Complete the authentication process for your organization to continue.
125125

126-
[![QGIS Browser panel displaying Planetary Computer Pro collections tree.](./media/stac-catalog-in-qgis.png)](./media/stac-catalog-in-qgis.png#lightbox)
126+
[![Screenshot of the QGIS Browser panel displaying the Planetary Computer Pro collections tree.](./media/stac-catalog-in-qgis.png)](./media/stac-catalog-in-qgis.png#lightbox)
127127

128128

129129
> [!TIP]
130130
> If your GeoCatalog has zero STAC Collections, you see a `Host requires authentication` error. To resolve this error, create a [STAC Collection](./create-collection-web-interface.md).
131131
132132
Continue to expand the collections until you locate a STAC Item. To visualize this item, select the item and drag it to the map view. If the data is a Cloud Optimized GeoTIFF (COG) or Cloud Optimized Point Cloud (COPC), it automatically imports and projects onto the map.
133133

134-
[![Map view displaying a STAC item added to QGIS.](./media/add-data-to-map.png)](./media/add-data-to-map.png#lightbox)
134+
[![Screenshot of the map view displaying a STAC item added to QGIS.](./media/add-data-to-map.png)](./media/add-data-to-map.png#lightbox)
135135

136136

137137

138-
### STAC Search and Filtering
138+
### STAC search and filtering
139139

140140
If you want to search for data or run a STAC filter in your catalog, the STAC API is exposed through the Layer manager.
141141

142142
1. On the **Layer** menu, select **Add Layer** > **Add Layer from STAC Catalog**.
143-
[![Add Layer from STAC Catalog dialog opened in QGIS.](./media/add-stac-catalog-layer.png)](./media/add-stac-catalog-layer.png#lightbox)
143+
[![Screenshot of the Add Layer from STAC Catalog dialog opened in QGIS.](./media/add-stac-catalog-layer.png)](./media/add-stac-catalog-layer.png#lightbox)
144144

145145
1. Select your STAC connection to the GeoCatalog, and then select **Connect**.
146-
[![Data Source Manager showing configured STAC connection before querying.](./media/data-source-manager.png)](./media/data-source-manager.png#lightbox)
146+
[![Screenshot of the Data Source Manager showing the configured STAC connection before querying.](./media/data-source-manager.png)](./media/data-source-manager.png#lightbox)
147147

148148
1. Choose the index you want to filter on. You can filter on spatial, temporal, or collection extent.
149-
[![STAC query dialog with spatial extent filter applied.](./media/filter-spatial-extent.png)](./media/filter-spatial-extent.png#lightbox)
149+
[![Screenshot of the STAC query dialog with a spatial extent filter applied.](./media/filter-spatial-extent.png)](./media/filter-spatial-extent.png#lightbox)
150150

151151
1. Select the item to add it to the map extent or download the assets directly to your local machine. If you hover over the item, the spatial extent previews on the map canvas in red.
152-
[![COG asset selection ready to add as a layer in QGIS.](./media/add-cog-to-map.png)](./media/add-cog-to-map.png#lightbox)
152+
[![Screenshot of the COG asset selection ready to add as a layer in QGIS.](./media/add-cog-to-map.png)](./media/add-cog-to-map.png#lightbox)
153153

154154
## Related content
155155

25.1 KB
Loading

0 commit comments

Comments
 (0)