Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

[Backport 2023.02.xx] #9482 - Update User Guide - Add COG catalog option (#9492) #9494

Merged
merged 1 commit into from
Sep 26, 2023
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
30 changes: 18 additions & 12 deletions docs/user-guide/catalog.md
Original file line number Diff line number Diff line change
Expand Up @@ -274,15 +274,15 @@ When the user saves this custom catalog service and clicks on search, he will se
<img src="../img/catalog/custom_tms_browse.jpg" class="ms-docimage" style="max-width:400px;"/>
<p class="ms-doc-caption">Browse custom TMS service. It contains only one result</p>

## Sample custom
##### Sample custom

```text
url: https://{s}.tile.opentopomap.org/{z}/{x}/{y}.png
```

## Sample custom with advanced options
##### Sample custom with advanced options

```text
```text
url: https://nls-{s}.tileserver.com/nls/{z}/{x}/{y}.jpg
```

Expand All @@ -299,7 +299,7 @@ url: https://nls-{s}.tileserver.com/nls/{z}/{x}/{y}.jpg
}
```

### TMS 1.0.0
#### TMS 1.0.0

Selecting the "TMS 1.0.0" provider the user can insert the URL of the Tile Map Service (see [TMS Specification](https://wiki.osgeo.org/wiki/Tile_Map_Service_Specification)). For instance, in GeoServer, it is the URL of the "TMS" link in the home page.

Expand All @@ -314,15 +314,15 @@ When saved this, the user will be allowed to browse and add to the map the TMS l
<img src="../img/catalog/tms100_browse.jpg" class="ms-docimage" style="max-width:400px;"/>
<p class="ms-doc-caption">Browse TMS 1.0.0 layers</p>

#### sample TMS 1.0.0 services
##### Sample TMS 1.0.0 services

```text
https://public.sig.rennesmetropole.fr/geowebcache/service/tms/1.0.0
https://osm.geobretagne.fr/gwc01/service/tms/1.0.0
https://gs-stable.geosolutionsgroup.com/geoserver/gwc/service/tms/1.0.0
```

#### TMS Known Services
##### TMS Known Services

The other known services are listed as providers below "custom" and "TMS 1.0.0". They are a static list configured inside the application. Selecting one of the provider listed and saving the new catalog service allows to browse al the variants known for that service. For more information about the list of available providers, see the developer documentation about [Tile Providers](../../developer-guide/maps-configuration/#tileprovider)

Expand All @@ -334,10 +334,11 @@ The other known services are listed as providers below "custom" and "TMS 1.0.0".

### 3D Tiles Catalog

3D Tiles is an [OGC specification](https://www.ogc.org/standards/3DTiles) designed for streaming and rendering massive 3D geospatial content such as Photogrammetry, 3D Buildings, BIM/CAD, and Point Clouds across desktop, web and mobile applications.
MapStore allows to publish 3D Tiles contents in its 3D mode on top of the [CesiumJS capabilities](https://github.com/CesiumGS/3d-tiles). Through the Catalog tool, a specific source type to load 3D Tiles in the Cesium Map can be configured as follows by specifying the URL of a reachable *tileset.json*.
**3D Tiles** is an [OGC specification](https://www.ogc.org/standards/3DTiles) designed for streaming and rendering massive 3D geospatial content such as Photogrammetry, 3D Buildings, BIM/CAD, and Point Clouds across desktop, web and mobile applications.

MapStore allows to publish 3D Tiles contents in its 3D mode on top of the [CesiumJS capabilities](https://github.com/CesiumGS/3d-tiles). Through the *Catalog* tool, a specific source type to load 3D Tiles in the Cesium Map can be configured as follows by specifying the URL of a reachable `tileset.json`.

In **general settings of** 3D Tiles service, the user can specify the title to assign to this service and the URL of the service.
In **General Settings** of 3D Tiles service, the user can specify the title to assign to this service and the URL of the service.

<img src="../img/catalog/3dtiles_service.jpg" class="ms-docimage" style="max-width:600px;"/>

Expand All @@ -347,7 +348,12 @@ In **general settings of** 3D Tiles service, the user can specify the title to a
(some [FAQs](https://cloud.google.com/blog/products/maps-platform/commonly-asked-questions-about-our-recently-launched-photorealistic-3d-tiles) are also available online for this purpose) before providing Google Photorealistic 3D Tile in your MapStore maps in order to enable only allowed tools (e.g. *Measurement* and *Identify* tools should be probably disabled).
For this purpose it is possible to appropriately set the [configuration of MapStore plugins](../../developer-guide/maps-configuration/#map-options) to exclude tools that could conflict with Google policies. Alternatively, it is possible to use a dedicated [application context](application-context.md#configure-plugins) to show Photorealistic 3D Tiles by including only the permitted tools within it.

### Cloud Optimized GeoTIFF
### COG Catalog

A **Cloud Optimized GeoTIFF** ([COG](https://www.cogeo.org)) is a regular GeoTIFF file, aimed at being hosted on a HTTP file server, with an internal organization that enables more efficient workflows on the cloud environment. It does this by leveraging the ability of clients issuing ​HTTP GET range requests to ask for just the parts of a file they need.

MapStore allows to add COG layers (also as a background) through its *Catalog* tool where a specific source type can be configured as follows by specifying the URL of a reachable COG `.tif` resource.

In **General Settings** of a COG source type, it is possible to specify the service `Title` and its `URL`.

A Cloud Optimized GeoTIFF (COG) is a regular GeoTIFF file, aimed at being hosted on a HTTP file server, with an internal organization that enables more efficient workflows on the cloud. It does this by leveraging the ability of clients issuing ​HTTP GET range requests to ask for just the parts of a file they need.
MapStore allows to add COG as layers and backgrounds. Through the Catalog tool, a multiple url sources of COG are obtained and converted to layers as each url corresponds to a layer
<img src="../img/catalog/cog_service.jpg" class="ms-docimage" style="max-width:600px;"/>
Binary file added docs/user-guide/img/catalog/cog_service.jpg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.