Skip to content

docs: added wfs query getting start guide step by step#160

Open
CL-SHLOMIKONCHA wants to merge 4 commits intomasterfrom
raster-getting-started-wfs
Open

docs: added wfs query getting start guide step by step#160
CL-SHLOMIKONCHA wants to merge 4 commits intomasterfrom
raster-getting-started-wfs

Conversation

@CL-SHLOMIKONCHA
Copy link
Contributor

No description provided.

@github-actions
Copy link

github-actions bot commented Jul 13, 2025

PR Preview Action v1.6.2

🚀 View preview at
https://MapColonies.github.io/developer-portal/pr-preview/pr-160/

Built to branch gh-pages at 2025-07-14 06:31 UTC.
Preview will be ready when the GitHub Pages deployment is complete.

POST Request

url:
```'<RASTER-CATALOG-SERVICE_URL>/csw'```
Copy link
Contributor

Choose a reason for hiding this comment

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

Suggested change
```'<RASTER-CATALOG-SERVICE_URL>/csw'```
```<RASTER-CATALOG-SERVICE_URL>/csw```

POST Request

url:
```'<RASTER-CATALOG-SERVICE_URL>/csw'```
Copy link
Contributor

Choose a reason for hiding this comment

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

Suggested change
```'<RASTER-CATALOG-SERVICE_URL>/csw'```
```<RASTER-CATALOG-SERVICE_URL>/csw```

Comment on lines +20 to +26
**Note:** In order to get the layer id (mc:id) you have the following options:
1. Open map-colonies catalog application and locate the required layer
<figure>
<img src={require("/img/raster/Id_catalog.png").default} style={{"display":"block","marginLeft":"auto","marginRight":"auto"}}/>
</figure>
2. Query all records via CSW GetRecords operation and search it in the result response
- [Query Examples](/docs/ogc/protocols/ogc-csw/ogc-csw-examples)
Copy link
Contributor

Choose a reason for hiding this comment

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

Move this into the Specific Layer tab in Query Catalog Service (Step 1).

There are a few ways to acquire the productId, for example:

<Tabs>
<TabItem value="SpecificLayer" label="Specific Layer">
Copy link
Contributor

Choose a reason for hiding this comment

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

Maybe use the same text used in the existing Getting started raster guide?

```

</TabItem>
<TabItem value="fetchAll" label="Fetch All Layers (Pagination)">
Copy link
Contributor

Choose a reason for hiding this comment

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

Maybe use the same text used in the existing Getting started raster guide?

Comment on lines +101 to +107
POST Request

url:
```'<RASTER-CATALOG-SERVICE_URL>/csw'```

body (XML):
```xml
Copy link
Contributor

Choose a reason for hiding this comment

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

Suggested change
POST Request
url:
```'<RASTER-CATALOG-SERVICE_URL>/csw'```
body (XML):
```xml
body (XML):
```xml title="POST: '<RASTER-CATALOG-SERVICE_URL>/csw'"

Comment on lines +67 to +73
POST Request

url:
```'<RASTER-CATALOG-SERVICE_URL>/csw'```

body (XML):
```xml
Copy link
Contributor

Choose a reason for hiding this comment

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

Suggested change
POST Request
url:
```'<RASTER-CATALOG-SERVICE_URL>/csw'```
body (XML):
```xml
body (XML):
```xml title="POST: '<RASTER-CATALOG-SERVICE_URL>/csw'"

</mc:links>
```

You need to save the `[desired_layer_identifier]` value for later use.
Copy link
Contributor

Choose a reason for hiding this comment

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

What is the [desired_layer_identifier]? It's not clear.
Please explain what to save explicitly.

Comment on lines +246 to +258
As you can see, above xml response represents links to wfs operations query names (GetFeature/DescribeFeature)
Now all you have to do is query the desired WFS operation link by those references that we mantioned.

```xml
<ows:Operation name="DescribeFeatureType">
```
Reference: [DescribeFeatureType](/docs/MapColonies/Raster/services/LayerParts/layer-parts#describefeaturetype)


```xml
<ows:Operation name="GetFeature">
```
Reference: [GetFeature](/docs/MapColonies/Raster/services/LayerParts/layer-parts#getfeature) No newline at end of file
Copy link
Contributor

Choose a reason for hiding this comment

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

Suggested change
As you can see, above xml response represents links to wfs operations query names (GetFeature/DescribeFeature)
Now all you have to do is query the desired WFS operation link by those references that we mantioned.
```xml
<ows:Operation name="DescribeFeatureType">
```
Reference: [DescribeFeatureType](/docs/MapColonies/Raster/services/LayerParts/layer-parts#describefeaturetype)
```xml
<ows:Operation name="GetFeature">
```
Reference: [GetFeature](/docs/MapColonies/Raster/services/LayerParts/layer-parts#getfeature)
As you can see, the above `xml` response represents links to different wfs operations ([`GetFeature`](/docs/MapColonies/Raster/services/LayerParts/layer-parts#getfeature) / [`DescribeFeatureType`](/docs/MapColonies/Raster/services/LayerParts/layer-parts#describefeaturetype)).
Now all you have to do is query the desired `WFS operation link` by the references we mentioned.

Copy link
Contributor

Choose a reason for hiding this comment

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

If you wish to reference the exact lines in the xml example before we can add showLineNumbers and mention them here.

Comment on lines +220 to +242
```xml title="Example links for a layer"
<ows:Operation name="DescribeFeatureType">
<ows:DCP>
<ows:HTTP>
<ows:Get xlink:href="https://<YOUR_WFS_URL>/wfs"/>
<ows:Post xlink:href="https://<YOUR_WFS_URL>/wfs"/>
</ows:HTTP>
</ows:DCP>
<ows:Parameter name="outputFormat">
<ows:AllowedValues>
<ows:Value>application/gml+xml; version=3.2</ows:Value>
</ows:AllowedValues>
</ows:Parameter>
</ows:Operation>
<ows:Operation name="GetFeature">
<ows:DCP>
<ows:HTTP>
<ows:Get xlink:href="https://<YOUR_WFS_URL>/wfs"/>
<ows:Post xlink:href="https://<YOUR_WFS_URL>/wfs"/>
</ows:HTTP>
</ows:DCP>
</ows:Operation>
```
Copy link
Contributor

Choose a reason for hiding this comment

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

Suggested change
```xml title="Example links for a layer"
<ows:Operation name="DescribeFeatureType">
<ows:DCP>
<ows:HTTP>
<ows:Get xlink:href="https://<YOUR_WFS_URL>/wfs"/>
<ows:Post xlink:href="https://<YOUR_WFS_URL>/wfs"/>
</ows:HTTP>
</ows:DCP>
<ows:Parameter name="outputFormat">
<ows:AllowedValues>
<ows:Value>application/gml+xml; version=3.2</ows:Value>
</ows:AllowedValues>
</ows:Parameter>
</ows:Operation>
<ows:Operation name="GetFeature">
<ows:DCP>
<ows:HTTP>
<ows:Get xlink:href="https://<YOUR_WFS_URL>/wfs"/>
<ows:Post xlink:href="https://<YOUR_WFS_URL>/wfs"/>
</ows:HTTP>
</ows:DCP>
</ows:Operation>
```
```xml title="Example links for a layer"
<ows:Operation name="DescribeFeatureType">
<ows:DCP>
<ows:HTTP>
<ows:Get xlink:href="https://<WFS_SERVICE__URL>/wfs"/>
<ows:Post xlink:href="https://<WFS_SERVICE__URL>/wfs"/>
</ows:HTTP>
</ows:DCP>
<ows:Parameter name="outputFormat">
<ows:AllowedValues>
<ows:Value>application/gml+xml; version=3.2</ows:Value>
</ows:AllowedValues>
</ows:Parameter>
</ows:Operation>
<ows:Operation name="GetFeature">
<ows:DCP>
<ows:HTTP>
<ows:Get xlink:href="https://<WFS_SERVICE__URL>/wfs"/>
<ows:Post xlink:href="https://<WFS_SERVICE__URL>/wfs"/>
</ows:HTTP>
</ows:DCP>
</ows:Operation>

@shimoncohen shimoncohen added the documentation Improvements or additions to documentation label Jul 15, 2025
@syncush
Copy link
Contributor

syncush commented Jul 18, 2025

@shimoncohen status of this PR ?

@shimoncohen
Copy link
Contributor

@syncush Waiting for @CL-SHLOMIKONCHA to address the requested changes.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants