Virtual boring

This service is used to get an image representing the earth quality at a specific location.

https://data.geo.dk/api/v3/virtualboring
Version 2 are currently support, but will be removed in a later version.

VirtualBoring

This service are used to request an image representing the earth quality at a specific positon specified by either coordinate or a cellid.

The supported image format can been seen here.

GET https://data.geo.dk/api/v3/virtualboring

Parameters

Name Description
geoAreaId The id of the geoarea. See Geo Area for more info. Only required in version 3 of the api
modelId The id of the model to search in. Required
width The width of the image in pixel. If not supplied then it depends on the chosen graph type. If type is 'bar' or 'pie' then the width is 400 pixels
height The height of the image in pixel. If not supplied then it depends on the chosen graph type. If type is 'bar' then the height is 600 pixels. If pie then the image gets the height of the generated pie chart
x The x-coordinate. If specified, then y must also be declared. If x or y are specifed then cellid must be set. Defaults to -1
y The y-coordinate. If specified, then x must also be declared. If x or y are specifed then cellid must be set. Defaults to -1
format The format to return the image in. For posible value see here. Defaults to PNG
quality Defaults to 100
epsg The coordinate system the coordinates are supplied in. Defaults to 25832 for EPSG:25832 - UTM 32 Euref 89
maxDepth The max level (over/under sealevel) to be included in the result. Can be positive and negative number. Only work with type = bar chart. Default is -130
showCopyright Controls whether to show Geo copyright in the image. Values true/false. Default true
hydroModelId Specify one or more hydromodels to be shown in the images. Only supported when type = 'Bar'. This parameter support multiplevalues. Default is not set.
Note: The previous parameters type and cellid are no longer needed and type = pie, will throw an error

Output

The service outputs an images in the request format or the HTTP error code 404 - No data found.

Errors

  • 400 Bad Request
  • 401 Unauthorized
  • 500 Internal Server Error

Supported image format

Returns the image in one of the following image format.

  • PNG
  • JPEG

Examples

Send a request for a coordinate using an url:

https://data.geo.dk/api/v3/virtualboring?geoAreaId=1&modelId=601&x=721100&y=6172600&width=440&height=570

The above link will return a bar graph showing the different segment at the cordinate