Skip to content

docs(dem): v2 (MAPCO-8937) #163

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.

Sign up for GitHub

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

Open
shimoncohen wants to merge 29 commits into
base: master
Choose a base branch
from
Open

docs(dem): v2 (MAPCO-8937) #163

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
29 commits
Select commit Hold shift + click to select a range
9f0baeb
docs(dem): v2 WIP
shimoncohen Feb 15, 2026
979d501
docs(dem): v2 WIP
shimoncohen Feb 15, 2026
a3d5b0d
docs(dem): v2 WIP
shimoncohen Feb 16, 2026
463b187
docs(dem): v2
shimoncohen Feb 17, 2026
88f7eac
docs(dem): fix broken links
shimoncohen Feb 17, 2026
eba1ae0
docs(dem): ogc-wcs add examples per-version
shimoncohen Feb 19, 2026
a71cce3
docs(dem): note default interpolation method
shimoncohen Feb 19, 2026
fd67712
docs(dem): remove subset from un-recommended parameter list
shimoncohen Feb 19, 2026
3fa291b
docs(dem): add download guide
shimoncohen Feb 22, 2026
e1cb1c1
docs(dem): change download example to be for specific layer
shimoncohen Feb 23, 2026
c26d4e1
docs(dem): fix PR comments
shimoncohen Jun 4, 2026
a32650b
docs(dem): add new catalog fields
shimoncohen Jun 4, 2026
e53a8be
docs(dem): add new catalog fields to other documents
shimoncohen Jun 4, 2026
953256d
docs(dem): fix terrain provider doc
shimoncohen Jul 6, 2026
2432a25
docs(3d): reference DEM terrain provider guide
shimoncohen Jul 6, 2026
65ea3ae
docs(dem): fix noDataValue in catalog v2 to be double
shimoncohen Jul 6, 2026
e237b4f
docs(dem): update height extraction warning
shimoncohen Jul 6, 2026
e87c17f
docs(dem): update terrain provider guide
shimoncohen Jul 6, 2026
4be5b13
docs(dem): move warning placing in height extraction
shimoncohen Jul 6, 2026
7c074b4
chore: remove space at EOL
shimoncohen Jul 6, 2026
d9ac59b
docs(dem): fix verticalSrsId row in catalog v2
shimoncohen Jul 6, 2026
c1b8bba
chore: replace product name
shimoncohen Jul 6, 2026
78ccb64
Merge branch 'master' into new-dem
shimoncohen Jul 7, 2026
d014d91
docs(dem): change warning in height exrtaction
shimoncohen Jul 7, 2026
0106d3d
fix: broken merge
shimoncohen Jul 7, 2026
8c26748
docs(dem): fix some information in v2 catalog profile
shimoncohen Jul 12, 2026
6427a4d
docs(dem): mark field diffs in v1/v2 catalog profile tables
shimoncohen Jul 20, 2026
29d4148
docs(dem): use GML3 polygon filter and add productSubType to v2 profile
shimoncohen Sep 24, 2026
85dfb56
docs(dem): fix findings from live review against dem-dev
shimoncohen Sep 28, 2026
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
96 changes: 2 additions & 94 deletions docs/MapColonies/3D/Guides/3D_getting_started.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -42,7 +42,7 @@ flowchart LR

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

@asafmas-rnd asafmas-rnd Jul 13, 2026

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Image This button sends to 3D getting started

@asafmas-rnd asafmas-rnd Jul 13, 2026

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Image This button also sends to 3D getting started

@asafmas-rnd asafmas-rnd Jul 13, 2026

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Image Why is it under the 3D section?

@asafmas-rnd asafmas-rnd Jul 13, 2026

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Image Why is the Raster title not "Getting started", and the 3D is?

@shimoncohen shimoncohen Jul 20, 2026

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Respond to each in a new comment, this isn't ok. And leave irrelevant things out of this PR.

@shimoncohen shimoncohen Jul 20, 2026

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Terrain provider is part of 3d and will stay that way.


Filter should be based on [3D profile](/docs/MapColonies/3D/services/catalog/catalog-profile-v2)
Filter should be based on [3D profile](/docs/MapColonies/3D/services/catalog/catalog-profile-v2).

:::warning
Pay attention to set the following parameter 'outputSchema="http://schema.mapcolonies.com/3d"' in order to get full catalog data
Expand Down Expand Up @@ -197,99 +197,7 @@ In the Response, look for
:::

## Get terrain provider URI (Step 2.1, optional)
This section explains how to query "Best" terrain for complementing the `3D models` and giving a true 3D visualization. If you wish to get a specifc terrain please use [DEM Getting Started Guide](/docs/MapColonies/DEM/Guides/DEM_getting_started.md)

To query the "Best" terrain, use the following:
```xml title="GetRecords Request For Terrain"
POST Request

url:
'<3D_CATALOG_SERVICE_URL>/csw'

body (XML):
<?xml version="1.0" encoding="UTF-8"?>
<csw:GetRecords outputFormat="application/xml" outputSchema="http://schema.mapcolonies.com/3d" resultType="results" service="CSW" version="2.0.2" startPosition="1" maxRecords="200" xmlns:mc="http://schema.mapcolonies.com/3d" xmlns:csw="http://www.opengis.net/cat/csw/2.0.2" xmlns:ogc="http://www.opengis.net/ogc">
<csw:Query typeNames="csw:Record">
<csw:ElementSetName>full</csw:ElementSetName>
<csw:Constraint version="1.1.0">
<Filter xmlns="http://www.opengis.net/ogc">
<PropertyIsEqualTo>

<!-- ****** PROFILE FIELD NAME START ********************** -->
<PropertyName>mc:productType</PropertyName>
<!-- ****** PROFILE FIELD NAME END ********************** -->

<!-- ****** PROFILE FIELD VALUE START ********************** -->
<Literal>QuantizedMeshDTMBest</Literal>
<!-- ****** PROFILE FIELD VALUE END ********************** -->

</PropertyIsEqualTo>
</Filter>
</csw:Constraint>
</csw:Query>
</csw:GetRecords>
```

You will get GetRecords XML Response with product **metadata**.

<details>
<summary>Response example</summary>

```xml title="Search Results Example"
<?xml version="1.0" encoding="UTF-8"?>
<csw:GetRecordsResponse xmlns:csw="http://www.opengis.net/cat/csw/2.0.2" xmlns:dc="http://purl.org/dc/elements/1.1/" xmlns:dct="http://purl.org/dc/terms/" xmlns:gmd="http://www.isotc211.org/2005/gmd" xmlns:gml="http://www.opengis.net/gml" xmlns:mc="http://schema.mapcolonies.com/3d" xmlns:ows="http://www.opengis.net/ows" xmlns:xs="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" version="2.0.2" xsi:schemaLocation="http://www.opengis.net/cat/csw/2.0.2 http://schemas.opengis.net/csw/2.0.2/CSW-discovery.xsd">
<csw:SearchStatus timestamp="2022-03-27T06:45:54Z" />
<csw:SearchResults numberOfRecordsMatched="1" numberOfRecordsReturned="1" nextRecord="0" recordSchema="http://schema.mapcolonies.com/3d" elementSet="full">
<mc:MC3DRecord>
<mc:accuracyLE90>4.0</mc:accuracyLE90>
<mc:classification>5</mc:classification>
<mc:creationDateUTC>2022-10-24</mc:creationDateUTC>
<mc:footprint>{"type":"Polygon","coordinates":[[[34.98,32.8],[35.1,32.8],[35.1,32.7],[34.98,32.7],[34.98,32.8]]]}</mc:footprint>
<mc:geographicArea>North</mc:geographicArea>
<mc:maxHorizontalAccuracyCE90>999.0</mc:maxHorizontalAccuracyCE90>
<mc:id>33333333-3333-3333-3333-333333333333</mc:id>
<mc:insertDate>2022-10-24</mc:insertDate>
<mc:links scheme="TERRAIN_QMESH" name="" description="">https://tiles.mapcolonies.net/api/dem/v1/terrains/srtm100</mc:links>
<mc:producerName>producer</mc:producerName>
<mc:productBBox>35.2670012825,32.5856881598,35.3105702702,32.6300363309</mc:productBBox>
<mc:productId>33333333-3333-3333-3333-333333333333</mc:productId>
<mc:productName>srtm100</mc:productName>
<mc:productSource></mc:productSource>
<mc:productStatus>PUBLISHED</mc:productStatus>
<mc:productType>QuantizedMeshDTMBest</mc:productType>
<mc:productSubType>Test subtype</mc:productSubType>
<mc:productVersion>1</mc:productVersion>
<mc:productionSystem></mc:productionSystem>
<mc:productionSystemVersion>1</mc:productionSystemVersion>
<mc:region>region</mc:region>
<mc:sensors>UNDEFINED</mc:sensors>
<mc:imagingTimeEndUTC>2022-10-24</mc:imagingTimeEndUTC>
<mc:imagingTimeBeginUTC>2022-10-24</mc:imagingTimeBeginUTC>
<mc:SRS>4326</mc:SRS>
<mc:SRSName>WGS84GEO</mc:SRSName>
<mc:type>RECORD_3D</mc:type>
<mc:updateDateUTC>2022-10-25T16:48:17Z</mc:updateDateUTC>
<ows:BoundingBox crs="urn:x-ogc:def:crs:EPSG:6.11:4326" dimensions="2">
<ows:LowerCorner>32.7 34.98</ows:LowerCorner>
<ows:UpperCorner>32.8 35.1</ows:UpperCorner>
</ows:BoundingBox>
</mc:MC3DRecord>
</csw:SearchResults>
</csw:GetRecordsResponse>
```
</details>


```xml title="Extract link for terrain provider"
<mc:links scheme="TERRAIN_QMESH" name="srtm100">
http://tiles.com/terrains/srtm100/layer.json
</mc:links>
```


:::info
**You need to save `<mc:links>` <u>element</u> value as TERRAIN_URL, which is a terrain provider consumption URL.**
:::
Read more in the [DEM Terrain Provider Guide](/docs/MapColonies/DEM/Guides/terrain-provider).

## Step 3
### Construct Client side Layer
Expand Down
202 changes: 0 additions & 202 deletions docs/MapColonies/DEM/Guides/DEM_getting_started.md
View file
Open in desktop

This file was deleted.

Loading
Loading