Geoportail V3 API

This API is no longer up to date. Please use the new version available here:

The V3 API is a web delivered service platform delivering both data and functionality, enabling geographical information to be shown on a map. The V3 API enables the integration of geoportail functionalities in external web pages. Although the options for data processing are limited compared with “real” office GIS software, some targeted queries and analyses are possible.

Important Note: For access to the V3 API on your own servers, you will need to request access to the ACT, specifying the server address you wish to grant access too. For any assistance as well as for request access, please contact our support here :

To help the developers, some examples and use cases are available on our demo page

A catalog of public layers is available on the List of layers page.

A catalog of public mymaps is available on the List of public Mymaps page.

The V3 API is built on top of the OpenLayers 3 API. The V3 offers classes, methods, and properties to ease the build of geographical applications using luxembourg data.

Feel free to visit our Github repository to have a look on our source code.

All the needed resources are loaded by including the following js script.

<script src="//"  type="text/javascript"></script>

The script automaticaly includes the Geoportail v3 libraries as well as the OpenLayers V3.x libraries. Thus there is no need to include it again.

The core API object is a lux.Map that extends an OpenLayers ol.Map. This is the main entry point to create a basic map.

The main properties of a lux.Map are :

  • target : The id or the html element where the map is displayed
  • bgLayer : The Id of the background layer.
  • zoom : The starting zoom level.
  • position : The central point of the map.

Displaying a map is simple as shown by the following code :

var map = new lux.Map({
  target: 'map1',
  bgLayer: 'basemap_2015_global',
  zoom: 18,
  position: [76771, 72205]