Use Case Name: get height at equally-spaced locations along a polyline path

Discussed in #4 in #4 (reply in thread)

As a User: _ Specialist_
I want (purpose): A service to compute height profile from a LV95 and WGS84 polyline from swissalti
Because (Trigger): I want to get for x,y pairs the corresponing z height from equally-spaced locations along the polyline are returned. o.

Pre-Conditions

• User provides polyline with coordinates pairs. and smaple density
• Format as defined in https://help.geo.admin.ch/?ids=24&lang=en
• Only swiss perimeter is supported initially
• Points as in #19 and lines are not treated the same way, both as the service parameters and the results.

Result
If coordinates are valid, the service returns x,y,z, with z the height in m above sea level.

How To Demo

• User forms a query with coordinates pairs : {lat1,long1,lat2,long2,latN,longnN,samples} tbd. or file upload (GPX, KML, GeoJSON)
• _Service returns the x,y,z height: {lat1,long1,alt1,,lat2,long2,alt2,latN,longnN,altN,} _
• Service returns formats:GPX, KML, GeoJSON

Assumptions
We assume that entered coordinates are correct. If false, no result is shown.
A polyline path is computed from the coordinates, and then elevation values at both endpoints and equally-spaced locations along the polyline are returned. The samples parameter specifies the number of elevations to return. The parameters points, samples are required.
The maximum number of elevations returned in a request is 10000

Miscellaneous
The geoadmin search REST-Service is used to provide the results.
_Worldwide Elevation data can be obtained from the Amazon Web Services Public Datasets https://aws.amazon.com/public-datasets/terrain/ and acceses as eg in https://valhalla.readthedocs.io/en/latest/api/elevation/api-reference/#elevation-service-api-reference
Currently existing services:

• geo.admin.ch https://api3.geo.admin.ch/height (http://api3.geo.admin.ch/services/sdiservices.html#height)
• Bing: GetElevation (https://docs.microsoft.com/en-us/bingmaps/rest-services/elevations/get-elevations)
• Google: elevation API (https://developers.google.com/maps/documentation/elevation/overview)
• Valhalla: Elevation API (https://valhalla.readthedocs.io/en/latest/api/elevation/api-reference/)

Use Case Name: Convert a coordinates pair to an address

As a User: Individual
I want (purpose): A website to convert a single LV95 and WGS84 coordinates pair into an address.
Because (Trigger): I want to get the address of a building.

Pre-Conditions

• User provides 2 coordinates pairs.
• Format as defined in https://help.geo.admin.ch/?ids=24&lang=en
• Only swiss addresses are supported

Result
If coordinates are valid, the website returns the address. The search radius is 250m. Search is performed within a circle with the specified radius and centered at the location point. Only the first entity that fall within this search circle is returned. The address format is: road name, house number, ZIP code, municipality.

How To Demo

• User enters a coordinates pair in appropriate fields : 46.92777, 7.45135
• Website application returns the address: Seftigenstrasse, 264, 3084, Wabern
• The website shows the location on the geo.admin.ch iFrame with the crosshair marker for the selected coordinates and activated layer ch.bfs.gebauede_wohnungs_register with highlighted selected ID

Assumptions
We assume that entered coordinates are correct. If false, no result is shown.

Miscellaneous
The geoadmin search REST-Service is used to provide the results.

Use Case Name: get profile lenght at equally-spaced locations along a polyline path

Discussed in #4 in #4 (reply in thread)

As a User: _ Dev_
I want (purpose): A service to compute profile length from a LV95 and WGS84 polyline from swissalti: Given a line as parameters, determine the inflection points on the DEM, densify the line and return
Because (Trigger): I want to get for x,y pairs the corresponing z height from equally-spaced locations along the polyline and the then the length in m are returned. o.

Pre-Conditions

• User provides polyline with coordinates pairs. and sample density
• Format as defined in https://help.geo.admin.ch/?ids=24&lang=en
• Only swiss perimeter is supported initially
• Distance:
• Web Mercator coordinates should not be relied upon to derive metrics such as distances, areas, and directions from geographic features (see e.g. https://gis-ops.com/measuring-distances-and-why-projections-matter-practical-examples/)
• you don’t have to perform your measurements in the same coordinate system used by the map. When a user submits a geometry to your application for measurement, you can re-project that geometry into a more appropriate coordinate system for measurement. The re-projected geometry is used internally for measurement only; you don’t display it on the map. Once the measurement is complete, you return the correct result to the user. as stated in https://www.esri.com/arcgis-blog/products/arcgis-enterprise/mapping/measuring-distances-and-areas-when-your-map-uses-the-mercator-projection/ ESRI even provides a code snippet
  Here’s a simplified example of how to take a user-submitted polygon, project it into a local coordinate system, and measure the resulting polygon. The code assumes the existence of a geometry service object and a graphic containing a single polygon. This example uses the ArcGIS API for JavaScript, but other ESRI Web mapping APIs allow similar use of the geometry service.

var sr = new esri.SpatialReference({wkid:32610}); geometryService.project([graphic], sr, function(projectedGraphic){   geometryService.areasAndLengths(projectedGraphic, function(result)

Unknown macro: {   var perimeter = result.lengths[0]; var area = result.areas[0]; }
); });

• Points as in #19 and lines are not treated the same way, both as the service parameters and the results.

Result
If coordinates are valid, the service returns x,y,z, with z the height in m above sea level and lenght of profile.

How To Demo

• User forms a query with coordinates pairs : {lat1,long1,lat2,long2,latN,longnN,samples} tbd. or file upload (GPX, KML, GeoJSON)
• _Service returns the x,y,z height: {lat1,long1,alt1,,lat2,long2,alt2,latN,longnN,altN,} _
• Service returns formats:GPX, KML, GeoJSON

Assumptions
We assume that entered coordinates are correct. If false, no result is shown.
A polyline path is computed from the coordinates, and then elevation values at both endpoints and equally-spaced locations along the polyline are returned. The samples parameter specifies the number of elevations to return. The parameters points, samples are required.

Miscellaneous
The geoadmin search REST-Service is used to provide the results.
Hiking time

• On a footpath, hiking time should be extracted from a database, not calculated. Hiking time outside the footpath is only indicative (many unknown possible obstacles)

_Worldwide Elevation data can be obtained from the Amazon Web Services Public Datasets https://aws.amazon.com/public-datasets/terrain/ and acceses as eg in https://valhalla.readthedocs.io/en/latest/api/elevation/api-reference/#elevation-service-api-reference
Currently existing services:

• geo.admin.ch https://api3.geo.admin.ch/height (http://api3.geo.admin.ch/services/sdiservices.html#height)
• Bing: GetElevation (https://docs.microsoft.com/en-us/bingmaps/rest-services/elevations/get-elevations)
• Google: elevation API (https://developers.google.com/maps/documentation/elevation/overview)
• Valhalla: Elevation API (https://valhalla.readthedocs.io/en/latest/api/elevation/api-reference/)
• IGN (https://geoservices.ign.fr/documentation/services/api-et-services-ogc/calcul-altimetrique-rest)

Use Case Name: <Title given to the specific use case.>

As a User: User Dev, Specialist, Individual, ALL.
I want (purpose): Purpose for using the product.
Because (Trigger): Reason that causes the user to use the product in the specific way.

Pre-Conditions

• State of things before the user begins using the product.

Result
State of things after the user had completed using the product. Deliverables

How To Demo

• Step by step for user to complete the task with the product.

Assumptions
Assumptions or stipulations made in support of the use case.

Miscellaneous
Additional comments and notes about the use case.

Use Case Name: get height profile for a set of coordinates pairs

Discussed in #4 in #4 (reply in thread)

As a User: _ Specialist_
I want (purpose): A service to extract for a LV95 and WGS84 line or set of points defined by coordinates the elevation from swissalti
Because (Trigger): I want to get for x,y pairs the corresponing z height o.

Pre-Conditions

• User provides list of 2 coordinates pairs.
• Format as defined in https://help.geo.admin.ch/?ids=24&lang=en
• Only swiss perimeter is supported initially
• Points as in #19 and lines are not treated the same way, both as the service parameters and the results.

Result
If coordinates are valid, the service returns x,y,z, with z the height in m above sea level.

How To Demo

• User forms a query with coordinates pairs : {lat1,long1,lat2,long2,latN,longnN} tbd. or file upload (GPX, KML, GeoJSON)
• _Service returns the x,y,z height: {lat1,long1,alt1,,lat2,long2,alt2,latN,longnN,altN,} _
• Service returns formats:GPX, KML, GeoJSON

Assumptions
We assume that entered coordinates are correct. If false, no result is shown.

Miscellaneous
The geoadmin search REST-Service is used to provide the results.
_Worldwide Elevation data can be obtained from the Amazon Web Services Public Datasets https://aws.amazon.com/public-datasets/terrain/ and acceses as eg in https://valhalla.readthedocs.io/en/latest/api/elevation/api-reference/#elevation-service-api-reference
Currently existing services:

• geo.admin.ch https://api3.geo.admin.ch/height (http://api3.geo.admin.ch/services/sdiservices.html#height)
• Bing: GetElevation (https://docs.microsoft.com/en-us/bingmaps/rest-services/elevations/get-elevations)
• Google: elevation API (https://developers.google.com/maps/documentation/elevation/overview)
• Valhalla: Elevation API (https://valhalla.readthedocs.io/en/latest/api/elevation/api-reference/)

Use Case Name: get height from a coordinates pair

Discussed in #4 in #4 (reply in thread)

As a User: Individual
I want (purpose): A website to extract for a single LV95 and WGS84 coordinates pair a elevation from swissalti
Because (Trigger): I want to get the height of a coordinate.

Pre-Conditions

• User provides 2 coordinates pairs.
• Format as defined in https://help.geo.admin.ch/?ids=24&lang=en
• Only swiss perimeter is supported initailly

Result
If coordinates are valid, the website returns the height in m above sea level.

How To Demo

• User enters a coordinates pair in appropriate fields : 46.92777, 7.45135
• Website application returns the height: 552.8 m
• The website shows the location on the geo.admin.ch iFrame with the crosshair marker for the selected coordinates

Assumptions
We assume that entered coordinates are correct. If false, no result is shown.

Miscellaneous
The geoadmin search REST-Service is used to provide the results.
_Worldwide Elevation data can be obtained from the Amazon Web Services Public Datasets https://aws.amazon.com/public-datasets/terrain/ and acceses as eg in https://valhalla.readthedocs.io/en/latest/api/elevation/api-reference/#elevation-service-api-reference
Currently existing services:

• geo.admin.ch https://api3.geo.admin.ch/height (http://api3.geo.admin.ch/services/sdiservices.html#height)
• Bing: GetElevation (https://docs.microsoft.com/en-us/bingmaps/rest-services/elevations/get-elevations)
• Google: elevation API (https://developers.google.com/maps/documentation/elevation/overview)
• Valhalla: Elevation API (https://valhalla.readthedocs.io/en/latest/api/elevation/api-reference/)