Skip to content

Commit 365ecee

Browse files
committed
making changes requested by learn editors
1 parent 1525feb commit 365ecee

11 files changed

Lines changed: 27 additions & 47 deletions

articles/planetary-computer/application-authentication.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,7 @@ author: prasadko
55
ms.author: prasadkomma
66
ms.service: planetary-computer-pro
77
ms.topic: how-to #Don't change
8-
ms.date: 04/23/2025
8+
ms.date: 01/09/2026
99

1010
#customer intent: As a developer or administrator, I want to set up application authentication and access to Microsoft Planetary Computer Pro so that my applications can securely interact with its resources.
1111
ms.custom:
@@ -73,7 +73,7 @@ In this access scenario, a user signed into a client application. The client app
7373
1. Select **Add a permission**
7474
1. Select the **APIs my organization uses** tab
7575
1. Type **Azure Orbital Planetary Computer** in the search field
76-
1. Select on the matching entry (app ID should be 6388acc4-795e-43a9-a320-33075c1eb83b). It shows up as **Azure Orbital Microsoft Planetary Computer Pro**.
76+
1. Select the matching entry (app ID should be 6388acc4-795e-43a9-a320-33075c1eb83b). It shows up as **Azure Orbital Microsoft Planetary Computer Pro**.
7777
1. Select on **Delegated permissions** box. Check the box next to **user_impersonation**.
7878
1. Select **Add permissions**
7979
1. Select the "Grant admin consent" link (assuming your intent is to grant admin consent in the tenant for this permission)

articles/planetary-computer/azure-batch.md

Lines changed: 8 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@ description: This quickstart shows you how to use Microsoft Planetary Computer P
44
author: meaghanlewis
55
ms.topic: quickstart
66
ms.service: planetary-computer-pro
7-
ms.date: 04/24/2025
7+
ms.date: 01/09/2026
88
ms.author: emiliod
99
#customer intent: I want to use Microsoft Planetary Computer Pro GeoCatalog in Azure Batch to process geospatial data.
1010
ms.custom:
@@ -37,7 +37,7 @@ Before you begin, ensure you meet the following requirements to complete this qu
3737
- [Azure CLI](/cli/azure/install-azure-cli)
3838
- `perl` package.
3939

40-
## Create a batch account
40+
## Create a Batch account
4141

4242
Create a resource group:
4343

@@ -98,7 +98,7 @@ az identity create \
9898
--resource-group spatiobatchdemo
9999
```
100100

101-
Create a pool of compute nodes using the Azure Portal:
101+
Create a pool of compute nodes using the Azure portal:
102102

103103
1. In the Azure portal, navigate to your Batch account and select **Pools**:
104104
[ ![Screenshot of the Azure portal showing the Pools section of a Batch account, with options to add and manage pools.](media/batch-pools-overview.png) ](media/batch-pools-overview.png#lightbox)
@@ -112,7 +112,7 @@ Create a pool of compute nodes using the Azure Portal:
112112
[ ![Screenshot of the Start Task configuration page for a Batch pool. The page includes fields to specify a command line script, elevation level, and other settings for initializing compute nodes.](media/start-task-configuration-page.png) ](media/start-task-configuration-page.png#lightbox)
113113
1. Select **OK** to create the pool.
114114

115-
## Assign Permissions to the Managed Identity
115+
## Assign permissions to the managed identity
116116

117117
You need to provide the managed identity access to the GeoCatalog. Go to your GeoCatalog, select on **Access control (IAM)** and select **Add role assignment**:
118118

@@ -126,7 +126,7 @@ Select the managed identity you created and then select **Review + assign**.
126126

127127
[ ![Screenshot of the Azure portal showing the Select identity page. The page includes a list of available managed identities, allowing users to choose the identity they want to assign to the Batch pool.](media/select-review-assign.png) ](media/select-review-assign.png#lightbox)
128128

129-
## Prepare the Batch Job
129+
## Prepare the Batch job
130130

131131
Create a container in the storage account:
132132

@@ -146,11 +146,11 @@ az storage blob upload \
146146
--account-name spatiobatchstorage
147147
```
148148

149-
## Run the Batch Jobs
149+
## Run the Batch jobs
150150

151151
There are two examples in this quickstart: a **Python script**, and a **Bash script**. You can use either of them to create a job.
152152

153-
### Python Script Job
153+
### Python script job
154154

155155
To execute the Python script job, execute the following commands:
156156

@@ -194,7 +194,7 @@ az batch task file download \
194194
--destination /dev/stdout
195195
```
196196

197-
### Bash Job
197+
### Bash job
198198

199199
To execute the Bash script job, run the following commands:
200200

articles/planetary-computer/build-applications-with-planetary-computer-pro.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,7 @@ author: prasadko
55
ms.author: prasadkomma
66
ms.service: planetary-computer-pro
77
ms.topic: concept-article #Don't change.
8-
ms.date: 04/29/2025
8+
ms.date: 01/09/2026
99

1010
#customer intent: As a user, I want to understand how to connect to and use my geospatial data in Microsoft Planetary Computer Pro so that I can choose the right tool for my needs.
1111
ms.custom:

articles/planetary-computer/build-web-application.md

Lines changed: 12 additions & 32 deletions
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,7 @@ author: prasadko
55
ms.author: prasadkomma
66
ms.service: azure
77
ms.topic: quickstart
8-
ms.date: 12/08/2024
8+
ms.date: 01/09/2026
99

1010
#customer intent: As a web developer, I want to build a browser application that can authenticate users and display geospatial data from Microsoft Planetary Computer Pro so that I can create custom visualization and analysis tools.
1111

@@ -27,39 +27,19 @@ The code patterns work with any modern JavaScript framework (React, Vue, Angular
2727

2828
You can download and test this code from the [Microsoft Planetary Computer Pro public GitHub repository](https://github.com/Azure/microsoft-planetary-computer-pro/tree/main/tools/javascript-sample).
2929

30-
## Table of contents
31-
32-
- [Architecture overview](#architecture-overview)
33-
- [Prerequisites](#prerequisites)
34-
- Setup
35-
- [Register your application in Microsoft Entra ID](#register-your-application-in-microsoft-entra-id)
36-
- [Configure your application](#configure-your-application)
37-
- [Install dependencies](#install-dependencies)
38-
- [Implement MSAL authentication](#implement-msal-authentication)
39-
- API examples
40-
- [STAC API: Query collections and items](#stac-api-query-collections-and-items)
41-
- [Tile URLs: Build URLs for map visualization](#tile-urls-build-urls-for-map-visualization)
42-
- [Map integration: Display tiles with MapLibre GL](#map-integration-display-tiles-with-maplibre-gl)
43-
- [Mosaic tiles: Display collection-wide imagery](#mosaic-tiles-display-collection-wide-imagery)
44-
- [SAS tokens: Download raw assets](#sas-tokens-download-raw-assets)
45-
- [Development considerations](#development-considerations)
46-
- [Troubleshooting](#troubleshooting)
47-
- [Next steps](#next-steps)
48-
49-
## Architecture overview
50-
51-
A typical GeoCatalog web application follows this architecture:
52-
53-
[ ![Diagram showing the architecture of a GeoCatalog web application with a browser client connecting to Microsoft Entra ID for authentication and to GeoCatalog APIs for data access.](media/web-application-architecture.png) ](media/web-application-architecture.png#lightbox)
54-
55-
5630
## Prerequisites
5731

5832
- An Azure account with an active subscription. [Create an account for free](https://azure.microsoft.com/free/?WT.mc_id=A261C142F).
5933
- A deployed [GeoCatalog resource](./deploy-geocatalog-resource.md) with at least one collection containing items.
6034
- Your user identity must have **GeoCatalog Reader** (or higher) access to the GeoCatalog resource. See [Manage access to a GeoCatalog resource](./manage-access.md).
6135
- [Node.js](https://nodejs.org/) version 18 or later.
6236

37+
## Architecture overview
38+
39+
A typical GeoCatalog web application follows this architecture:
40+
41+
[ ![Diagram showing the architecture of a GeoCatalog web application with a browser client connecting to Microsoft Entra ID for authentication and to GeoCatalog APIs for data access.](media/web-application-architecture.png) ](media/web-application-architecture.png#lightbox)
42+
6343

6444
## Register your application in Microsoft Entra ID
6545

@@ -127,7 +107,7 @@ npm install @azure/msal-browser maplibre-gl
127107
128108
## Implement MSAL authentication
129109

130-
[ ![Screenshot showing the authentication flow in a sample web application.](media/sample-authentication.gif) ](media/sample-authentication.gif#lightbox)
110+
[ ![Screenshot showing the authentication flow in a sample web application.](media/sample-authentication.png) ](media/sample-authentication.png#lightbox)
131111

132112

133113
Configure MSAL for browser authentication. The following example shows the key configuration and token acquisition pattern:
@@ -296,7 +276,7 @@ The GeoCatalog Tiler API serves raster data as map tiles. Construct tile URLs wi
296276

297277
[ ![Screenshot showing how to display tiles for a single item.](media/tile-single-image.gif) ](media/tile-single-image.gif#lightbox)
298278

299-
```
279+
```http
300280
{catalogUrl}/data/collections/{collectionId}/items/{itemId}/tiles/{z}/{x}/{y}@1x.png
301281
?api-version=2025-04-30-preview
302282
&tileMatrixSetId=WebMercatorQuad
@@ -585,6 +565,9 @@ Browser downloads work because navigation (clicking links) bypasses CORS. Howeve
585565

586566
If your application needs to read and process raw asset data in the browser, implement a server-side proxy:
587567

568+
> [!NOTE]
569+
> The following code is a simplified example to illustrate the proxy pattern. For production applications, your proxy endpoint should authenticate requests (for example, by forwarding the user's Bearer token or using session authentication) and validate that the user is authorized to access the requested resources.
570+
588571
```javascript
589572
// ❌ Browser: This fails due to CORS
590573
const response = await fetch(signedUrl);
@@ -598,9 +581,6 @@ const response = await fetch('/api/proxy-asset', {
598581
const data = await response.json(); // Works!
599582
```
600583

601-
> [!NOTE]
602-
> The following code is a simplified example to illustrate the proxy pattern. For production applications, your proxy endpoint should authenticate requests (for example, by forwarding the user's Bearer token or using session authentication) and validate that the user is authorized to access the requested resources.
603-
604584
Your backend can fetch the blob using the SAS token and return processed results.
605585

606586
---

articles/planetary-computer/configure-qgis.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,7 @@ author: prasadko
55
ms.author: prasadkomma
66
ms.service: planetary-computer-pro
77
ms.topic: how-to
8-
ms.date: 10/15/2025
8+
ms.date: 01/09/2026
99

1010
# customer intent: As a GeoCatalog user, I want to configure and authenticate QGIS to operate with Microsoft Planetary Computer Pro so that I can view imagery stored in my GeoCatalog within the QGIS tool.
1111
---

articles/planetary-computer/create-connection-arc-gis-pro.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,7 @@ author: aloverro
55
ms.author: adamloverro
66
ms.service: planetary-computer-pro
77
ms.topic: how-to
8-
ms.date: 05/08/2025
8+
ms.date: 01/09/2026
99

1010
ms.custom:
1111
- build-2025

articles/planetary-computer/get-started-planetary-computer.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,7 @@ author: prasadko
55
ms.author: prasadkomma
66
ms.service: planetary-computer-pro
77
ms.topic: get-started
8-
ms.date: 12/01/2025
8+
ms.date: 01/09/2026
99
#customer intent: As a new customer, I want to learn how to use Microsoft Planetary Computer Pro to solve my geospatial data management challenges.
1010
ms.custom:
1111
---
-44.8 KB
Loading
-621 KB
Binary file not shown.
14.2 KB
Loading

0 commit comments

Comments
 (0)