Geoportail V3 API

The Geoportail.lu V3 API is a web delivered service platform delivering both data and functionality, enabling geographical information to be shown on a map. The Geoportail.lu 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 Geoportail.lu 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 : support.geoportail@act.etat.lu

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

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

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

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

<script src="//apiv3.geoportail.lu/apiv3loader.js"  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: [75977, 75099]
});