You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: articles/planetary-computer/tile-settings.md
+12-30Lines changed: 12 additions & 30 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -4,47 +4,29 @@ description: This article provides an overview of the tile settings for Microsof
4
4
author: 777arc
5
5
ms.author: marclichtman
6
6
ms.service: planetary-computer-pro
7
-
ms.topic: how-to
7
+
ms.topic: concept-article
8
8
ms.date: 04/09/2025
9
9
ms.custom:
10
10
- build-2025
11
-
# customer intent: As a GeoCatalog user, I want to set the tile configuration for my SpatioTemporal Access Catalog (STAC) collection so that I can visualize my data in the Explorer UI.
12
11
---
13
12
14
13
# Tile settings in Microsoft Planetary Computer Pro
15
14
16
-
For each SpatioTemporal Access Catalog (STAC) collection in Microsoft Planetary Computer Pro, you can configure the tile settings, which determine the default location and minimum zoom level when visualizing mosaics in the Data Explorer.
15
+
For each collection in Microsoft Planetary Computer Pro, you can configure the tile settings, which determine the default location and minimum zoom level when visualizing mosaics in the Data Explorer.
17
16
18
17
In this article, see where to find and modify tile settings for Microsoft Planetary Computer Pro.
19
18
20
19
## Prerequisites
21
20
22
-
Before you can configure tile settings, ensure the following prerequisite steps are complete:
23
-
24
-
1.**STAC Collection Exists:** You created a [STAC collection in Planetary Computer Pro](./create-stac-collection.md).
25
-
2.**Data Ingested:** You [added STAC items](./add-stac-item-to-collection.md) containing the geospatial data assets you want to visualize into the collection.
21
+
- You have a [STAC collection with Microsoft Planetary Computer Pro GeoCatalog](./create-collection-web-interface.md)
26
22
27
23
## Find tile settings
28
24
29
25
The tile settings are found by going to the Collection page and selecting the Configuration button.
30
26
31
-
[](media/tile-configuration-screenshot.png#lightbox)
32
-
33
-
The settings are in the form of a JSON object with the following properties:
|`minZoom`| Integer (int32); maximum: 24 | Minimum zoom level at which the Explorer UI renders items from the collection. For more information, see [Zoom Levels](/azure/azure-maps/zoom-levels-and-tile-grid). |
38
-
|`maxItemsPerTile`| Integer (int32) | Maximum number of items that can be rendered per tile. |
39
-
|`defaultLocation`| DefaultLocation Object | Specifies the default map center coordinates and zoom level when the collection opens in the Explorer.|
40
-
41
-
The `defaultLocation` object has the following properties:
|`zoom`| Integer (int32) | The default zoom level when the collection opens in the Explorer. |
46
-
|`coordinates`| Array of float [2]| The default map center as `[latitude, longitude]` in decimal degrees. |
27
+
[](media/tile-settings-1.png#lightbox)
47
28
29
+
The settings are in the form of a JSON object.
48
30
49
31
### Example tile settings
50
32
@@ -62,12 +44,14 @@ The `defaultLocation` object has the following properties:
62
44
}
63
45
```
64
46
65
-
### Tuning Performance
47
+
### Zoom level
66
48
67
-
It's recommended to pair a higher minimum zoom level with high resolution imagery. This setting will help avoid experiencing higher latency when using the Explorer when at low zoom levels. Low resolution imagery can have lower min zoom levels without issue.
49
+
High resolution imagery should have a high min zoom level to avoid experiencing latency when using the explorer. Low resolution imagery can have lower min zoom levels without issue.
68
50
69
51
> [!NOTE]
70
-
> The effective minimum zoom level for a given map view is the greater of the minimum zoom level for the [render configuration](./render-configuration.md) and the tile settings. For example, if the tile setting `minZoom` level is set to `6` but the render configuration `minZoom` level is set to `12`, the explorer does not start rendering tiles until zoom level 12.
52
+
> Planetary Computer tile settings zoom must be configured as integers, even though the Explorer interface supports zooming to non-integer levels.
53
+
54
+
### Default location
71
55
72
56
The `defaultLocation` field lets you specify the zoom level and center coordinates used when your collection first opens in the Data Explorer. For example:
73
57
@@ -83,15 +67,13 @@ The `defaultLocation` field lets you specify the zoom level and center coordinat
83
67
}
84
68
```
85
69
86
-
If `defaultlocation` is not set, the map will go to an existing asset inside the collection.
70
+
> [!NOTE]
71
+
> In the list of items, there's a menu item called "Set view as default location". This isn't currently enabled.
87
72
88
73
[](media/tile-settings-save-view-as.png#lightbox)
89
74
90
-
If you wish to set the `defaultlocation` through the Explorer, it is available as an option in the menu in the left panel.
0 commit comments