Skip to content
REST API exposing coordinate transformations with PROJ
Python Dockerfile
Branch: master
Clone or download
kbevers Get ready for v1.1
Added v1.1 routes to API and adapted test suite to check those endpoints
as well. The test suite has been reworked to use pytest fixtures.
Fixtures from pytest doesn't work very well with the unittest framework
so test classes have been removed and the methods in them refactored to
stand-alone functions.
Latest commit ada0584 Jan 19, 2020


WEBPROJ is a REST API that exposes coordinate transformations for coordinate reference systems in Denmark and Greenland. The production version of WEBPROJ is running as part of Kortforsyningen. To use the API you need an access token, which users of Kortforsyningen can generate when they are logged in to their personal accounts. The documentation the REST API can be found at


The API is a simple REST API that delivers data in JSON format. In the current version two main entry points are provided: /crs/ and /trans/.


For ease of installation it is recommended to setup an environment using conda

$ conda env create -f environment.yaml

Replace environment.yaml with environment-dev.yaml if you want to setup a development environment.

Activate the new environment with

$ conda activate webproj

For production use, the API should be installed as a component in a WSGI compatible http server. How to configure this depends on the used http server.


WEBPROJ uses the pytest environment for tests. Run the test-suite with

$ pytest

in the root of the repository.


For a simple demonstration of the WEBPROJ REST API a webserver can be started locally by running

(webproj) C:\dev\webproj>python webproj\

This will spawn a Flask server that serves the API locally on

The API exposes a small set of features that are accessed via URL entry points. For version 1.0 of the API we have:


Returns a list of available coordinate references systems that can be transformed between.

$ curl
DK: [
GL: [


Returns information about a specific coordinate reference system.

    country: "DK",
    title: "ETRS89 / UTM Zone 32 Nord",
    title_short: "ETRS89/UTM32N",
    v1: "Easting",
    v1_short: "x",
    v2: "Northing",
    v2_short: "y",
    v3: "kote",
    v3_short: "h",
    v4: null,
    v4_short: null


Transform coordinate <coord> from <src_crs> to <dst_src. Coordinate input can be either 2D, 3D or 4D. The returned output will always be 4D, but depending on the input the number of used output coordinate components varies.

# 2D
    "v1:": 687071.4391094431,
    "v2": 6210141.326748009,
    "v3": 0.0,
    "v4": 0.0

# 3D
    "v1:": 687071.4391094431,
    "v2": 6210141.326748009,
    "v3": 30.0,
    "v4": 0.0

# 4D
    "v1:": 687071.4391094431,
    "v2": 6210141.326748009,
    "v3": 30.0,
    "v4": 2010.5

Web application


You can’t perform that action at this time.