You can visit your Maps API dashboard by going to your profile in the top bar, and then clicking the API Applicaties button on the left side.
Here you can see the different applications available under your account. Each application will have it’s own settings and security permissions, as described in the General API documentation. For Maps API this means that Viewers from different applications are isolated. To create a new Maps API integration you can use the Maps API aanmaken button. Each application should be given a name, these are only used for you to recognize your applications. Once created you can visit the details of your application to change it’s settings, it will look like this:
This screen lists the available viewers, allows you to add a new viewer, remove an existing application or modify the default SLD for the application.
The viewer part of the dashboard allows you to create a new viewer for the application. To create a new viewer use the Viewer aanmaken button. Existing viewers may be edited by using the Details button in their respective row.
When creating a new viewer, you may choose to enable or disable some features in the viewer by default (showing the print button, showing a reset view button, showing some measuring tools): These settings can be changed at any time.
Tabs at the top of the page allow you to set (background) layers (Kaartlagen). Buttons at the top of the page allow you to set a dossier outline, make a snapshot (image), or clone (Dupliceer) the viewer.
When a new viewer is created it has no dossier outline set. By default the sovereign Kadastral borders of the Netherlands are set as the dossier outline.
We highly recommend you always set a dossier outline for your viewer, to provide the best experience for your end users.
To set a dossier outline you can click the Dossiergrens Instellen button. This will take you to the Outline editor.
The outline editor (dossiergrens editor) will by default show a viewer of the Netherlands. A message is shown indicating that we first need to provide a dossier outline before we can proceed to the editor. You may use the search function on the top left corner to quickly go to a place. The two tools on the top allow you to either select a single or an area at once. Changes to the outline will only be stored after pressing the save (Opslaan) button.
Using this part of the dashboard you can configure your layers. Layers are applied to a specific viewer. Layers may either be base (basislaag) or non-base (overlay) layers. In any map viewer/editor there may always be only one base layer active. This base layer will never be transparent. There may be multiple overlay layers (non-base layers), and overlay layers will be transparent allowing users to view the underlying content.
By default a viewer will have the OpenStreetMap (OSM) and Aerial (Luchtfoto) base layers.
To create a new layer press the Nieuwe kaartlaag button. This will present you with the following screen:
On this screen you may pick one of the following types of layers:
- Empty (white background)
- OpenStreetMap (OSM)
- Aerial (Luchtfoto)
- DKK, Kadaster parcels (Kadastralegrenzen / Percelen)
- DKK (as WFS)
- BAG, Buildings
- BAG (as WFS)
- IMRO (Bestemmingsplannen)
- External WMS
- External WFS
You may also specify whether the layer should be base, and whether underlying information should be exposed when a user clicks on the layer in the viewer (Raadpleegbaar).
When clicking on create (Aanmaken) possibly more information is asked, depending on the layer type selected. As is the case with the vector layer in the following screenshot:
Note that external WMS (Web Map Service) or WFS (Web Feature Service) resources must be publicly available for Planviewer to use. When using IP-whitelisting, please contact Planviewer for more information.
Layers may be sorted. Note that sorting for base layers only changes the default layer shown. To sort layers, simply drag them around by holding your left mouse button over any row in the table. The order is updated once a layer is released.
The special vector layers enable users to provide their own data to the Maps API platform.
The following functionality is exposed via the dashboard:
- Specify custom fields.
- Supply custom Styled Layer Descriptor (SLD) files.
- Upload shapefiles to import the features.
- Download the features.
- Edit the features in a user interface, the Editor.
The fields corresponding to a vector layer can be defined. When features are uploaded using the shapefile upload method, these fields allow those features to be edited directly. When drawing new features using the editor, these fields can be specified. Values within features that are not specified as a field are read-only and can not be edited. The fields can be accessed in the layers screen with the fields (Velden) button:
The fields shown in the overview are sortable, and can be dragged similarly to layers to re-order them. Fields can also be edited and deleted. Deleting a field will never remove any actual data from the features, but will only make them read-only.
With the new field (Nieuw veld) button a field can be created. The title of a field is the human-readable name of the field that will be presented to the user in either the viewer or the editor. The actual name of a field is the one used by automated processes, such as when downloading the data, but also when matching a feature to expressions within the Styled Layer Descriptors (SLD’s).
A field can either be a text field or a choice (Keuze) field. The value within a feature may conform to the values specified in the choice field. A user is capable of specifying other values at any time. These anomalous values will not be added to the choice field, but will be presented in the editor regardless.
Features may be uploaded in bulk as shapefiles.
Specifically these shapefiles are zipped directories containing at least a
sld file may be provided to specify custom styling used in the editors and viewers.
For more information on the file format see the
Shapefile ESRI white paper.
Finally features can be added and edited using the editor. The editor can be found behind the following button for each Vector layer:
A feature can be edited simply by clicking on it. For any feature the set of values is displayed. For every field an editable input element is showed. Every other value is shown read-only.
On the editor you may use the Shapfile upload icon to select a shapefile and optional SLD (Styled Layer Descriptor) all combined in a single zip file to upload data to your map.
In order to upload a shapefile you must provide a zip, you must also indicate the type of layer for your shapefile. It must either consist of points, lines or polygons. If the wrong type is indicated the layer will end up being empty.