docs(dem): v2 (MAPCO-8937) by shimoncohen · Pull Request #163 · MapColonies/developer-portal

shimoncohen · 2026-02-17T14:16:54Z

No description provided.

github-actions · 2026-02-17T14:20:05Z

PR Preview Action v1.8.1
🚀 View preview at https://MapColonies.github.io/developer-portal/pr-preview/pr-163/
Built to branch `gh-pages` at 2026-06-04 16:01 UTC. Preview will be ready when the GitHub Pages deployment is complete.

vitaligi · 2026-02-17T14:54:11Z

+<WCS_SERVICE_URL>/wcs?request=GetCapabilities&token=<token>
+```
+
+<details>


remove mimad from GetCapabilites response

Why? I want to show a response with a few layers.

@shimoncohen it's better to include only publicly available resources in docs and since mimad is not one of them it should be removed.
furthermore, it may confuse clients between the deployed/served data to data depicted in docs which may have different values (outdated/errors/...)

vitaligi · 2026-02-24T07:50:24Z

+| mc:links | text | Available links for different services available for the current product |
+| mc:classification | enum  | product classification / confidentiality <br /> Classification values |
+| mc:producerName | text | manufacturer / organization that produced / supplied the product |
+| mc:noDataValue | enum |  **Valid Values**: <br/> -32768 |


noDataValue is a number (double)

Shouldn't it be int?

no, it's double

asafmas-rnd · 2026-06-07T12:40:35Z

 url:
 '<3D_CATALOG_SERVICE_URL>/csw'

 body (XML):


Consider remving the terrain guide "Get terrain provider URI (Step 2.1, optional)" from here and direct to DEM V1 terrain_provider guide

asafmas-rnd · 2026-06-07T12:51:55Z

+The following guide will help you understand ***Step-by-step*** how to work with the Map Colonies Height Extraction service, from the [Catalog](/docs/MapColonies/DEM/Services/catalog/dem-catalog) to the WCS protocol.
+
+:::warning
+This guide is **not** for viewing purposes.


for algo... (be positive)

asafmas-rnd · 2026-06-07T12:54:02Z

@@ -0,0 +1,965 @@
+---


Decide if and where to put the WFS section

asafmas-rnd · 2026-06-08T07:32:03Z

+import Tabs from '@theme/Tabs';
+import TabItem from '@theme/TabItem';
+
+## Step by step guide


Please emphasize that "coverage" refers to V2 catalog

asafmas-rnd · 2026-06-08T07:32:21Z

 Query **DEM CSW catalog** service to find item(s) according to desired filter [examples are here](/docs/ogc/protocols/ogc-csw/ogc-csw-examples)

-Filter should be based on [DEM profile](/docs/MapColonies/DEM/Services/catalog/catalog-profile-v1)
+Filter should be based on [DEM profile](/docs/MapColonies/DEM/Services/catalog/dem-catalog-profile-v1)


Please emphasize that "coverage" refers to the V1 catalog only

vitaligi

~~please also fix Catalogue typo in '../DEM/Services/catalog/dem-catalog'~~
ignore

vitaligi · 2026-06-10T11:00:30Z

+```bash
+curl --location --request POST '{DEM_CATALOG_SERVICE_URL}/csw?token=<token>' \
+--header 'Content-Type: application/xml' \
+--data-raw '<?xml version="1.0" encoding="UTF-8"?>


this md file contains mixed version requests align to a specific version and add a notice on the given version at the top

vitaligi · 2026-06-10T11:13:45Z

+| mc:links | text | Available links for different services available for the current product |
+| mc:classification | enum  | product classification / confidentiality <br /> Classification values |
+| mc:producerName | text | manufacturer / organization that produced / supplied the product |
+| mc:noDataValue | enum |  **Valid Values**: <br/> -32768 |


no, it's double

vitaligi · 2026-06-10T11:23:36Z

@@ -189,14 +189,14 @@ Now, after you got all product metadata that you need by querying our Catalog, l
 // **Optional** add to Cesium terrain provider in order to clamp 3d models to the ground or investigate terrain 


remove blank space at EOL

vitaligi · 2026-06-10T11:26:39Z

 :::warning
 New version [v2](/docs/MapColonies/Raster/services/catalog/raster-catalog-profile-v2) is coming!
-<p style={{color:"red"}}><b>The following parameters are depracted an will be removed in v2</b></p> 
+<p style={{color:"red"}}><b>The following parameters are deprecated and will be removed in v2</b></p> 


remove space at EOL

vitaligi · 2026-06-10T11:39:58Z

+| mc:type | enum | type of the catalog <br/> **Value**: RECORD_DEM |
+| mc:keywords | text | list of key words relevant for product |
+| mc:verticalType | enum | **Valid Values**: Orthometric, Ellipsoidal |
+| mc:verticalSrsId | text | reference System ID (EPSG), <br/> ex: 4326 / 3857 |


vertical srs ids examples are not vertical. use 5773 / 3855 / 4979.
plus, system can be lowercase

vitaligi · 2026-06-10T11:41:32Z

+| mc:description | text | the product description |
+| mc:footprint | geojson | geographical delineation of the product / model trace |
+| mc:BoundingBox | bbox | two points that represent the record extent |
+| mc:srsId | text | reference System ID (EPSG), <br/> ex: 4326 / 3857 |


system can be lowercase

vitaligi · 2026-06-10T12:03:45Z

+The following guide will help you understand ***Step-by-step*** how to work with the Map Colonies Height Extraction service, from the [Catalog](/docs/MapColonies/DEM/Services/catalog/dem-catalog) to the WCS protocol.
+
+:::warning
+This guide is **not** for viewing purposes.


what is the purpose of this warning?

vitaligi · 2026-06-10T12:10:54Z

+- `numberOfRecordsReturned` indicating the amount of records returned for this request (may be less than `maxRecords` given in the request)
+- `nextRecord` the value that should be passed for `startPosition` in the following request
+
+In case we are fetching the full profile without any filters our next request should look like this:


this is almost identical to the request above. consider removing

shimoncohen added 4 commits February 15, 2026 13:47

docs(dem): v2 WIP

9f0baeb

docs(dem): v2 WIP

979d501

docs(dem): v2 WIP

a3d5b0d

docs(dem): v2

463b187

shimoncohen requested review from asafMasa and vitaligi February 17, 2026 14:16

shimoncohen self-assigned this Feb 17, 2026

shimoncohen added the documentation Improvements or additions to documentation label Feb 17, 2026

shimoncohen changed the title ~~docs(dem): v2~~ docs(dem): v2 (MAPCO-8937) Feb 17, 2026

docs(dem): fix broken links

88f7eac

vitaligi requested changes Feb 17, 2026

View reviewed changes

asafmas-rnd requested changes Feb 18, 2026

View reviewed changes

Comment thread docs/MapColonies/DEM/Guides/height_extraction.md

Comment thread docs/MapColonies/DEM/Guides/height_extraction.md

Comment thread docs/MapColonies/DEM/Guides/height_extraction.md Outdated

Comment thread docs/MapColonies/DEM/Guides/height_extraction.md

shimoncohen added 3 commits February 19, 2026 14:54

docs(dem): ogc-wcs add examples per-version

eba1ae0

docs(dem): note default interpolation method

a71cce3

docs(dem): remove subset from un-recommended parameter list

fd67712

vitaligi requested changes Feb 22, 2026

View reviewed changes

docs(dem): add download guide

3fa291b

shimoncohen requested review from asafmas-rnd and vitaligi February 23, 2026 09:16

asafmas-rnd requested changes Feb 23, 2026

View reviewed changes

Comment thread docs/MapColonies/DEM/Services/catalog/profile_v2_0.md

Comment thread docs/MapColonies/DEM/Guides/height_extraction.md

Comment thread docs/MapColonies/DEM/Services/download/README.md

shimoncohen requested a review from asafmas-rnd February 23, 2026 14:21

docs(dem): change download example to be for specific layer

e1cb1c1

asafmas-rnd previously approved these changes Feb 24, 2026

View reviewed changes

vitaligi requested changes Feb 24, 2026

View reviewed changes

Comment thread docs/ogc/protocols/ogc-wcs.md Outdated

Comment thread docs/MapColonies/DEM/Guides/height_extraction.md Outdated

Comment thread docs/ogc/protocols/ogc-wcs.md Outdated

Comment thread docs/ogc/protocols/ogc-wcs.md Outdated

vitaligi requested changes Feb 24, 2026

View reviewed changes

Comment thread docs/ogc/protocols/ogc-wcs.md Outdated

Comment thread docs/ogc/protocols/ogc-wcs.md Outdated

docs(dem): fix PR comments

c26d4e1

shimoncohen dismissed asafmas-rnd’s stale review via c26d4e1 June 4, 2026 15:15

shimoncohen requested a review from vitaligi June 4, 2026 15:15

shimoncohen requested a review from asafmas-rnd June 4, 2026 15:16

shimoncohen added 2 commits June 4, 2026 18:40

docs(dem): add new catalog fields

a32650b

docs(dem): add new catalog fields to other documents

e53a8be

asafmas-rnd requested changes Jun 8, 2026

View reviewed changes

vitaligi reviewed Jun 10, 2026

View reviewed changes

		@@ -189,14 +189,14 @@ Now, after you got all product metadata that you need by querying our Catalog, l
		// Optional add to Cesium terrain provider in order to clamp 3d models to the ground or investigate terrain

Uh oh!

Conversation

shimoncohen commented Feb 17, 2026

Uh oh!

github-actions Bot commented Feb 17, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Built to branch gh-pages at 2026-06-04 16:01 UTC. Preview will be ready when the GitHub Pages deployment is complete.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

vitaligi left a comment • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Reviewers

github-actions Bot commented Feb 17, 2026 •

edited

Loading

Built to branch `gh-pages` at 2026-06-04 16:01 UTC.
Preview will be ready when the GitHub Pages deployment is complete.

vitaligi left a comment •

edited

Loading