Embed

The Planviewer Maps API enables the creation of maps and the subsequent embedding of said maps into your own website. There are two entry points: an Editor, which enables selecting the Dossiergrens and uploading shapefiles, and a read-only Viewer.

Interaction between the Editor or Viewer and your website is not possible. Please consult the Server Calls documentation for possible interactions between Planviewer Maps API and your website.

Viewer

A read-only view of the map identified with (identifier). At the creation of the map, either via a Server Call or via the Admin Panel, these features can be enabled:

Print
Enables the printing of the map to PDF.
Reset
Resets the viewport to the original view.
Measure
By clicking on the map both the length of a series of lines and the surface of a polygon are computed.

The features are disclosed to the user via a series of buttons in the top-left corner of the Viewer.

Warning

The Viewer is publicly accessible if URL is known and OAuth is not enabled.

_images/viewer.jpg

Create an iframe with the following request:

GET https://www.planviewer.nl/maps_api/v1/embed/viewer/(string: identifier)
Status Codes:
  • 404 Not Foundidentifier does not refer to a viewer.
  • 403 Forbidden – OAuth is set, but the browser has not (yet) been correctly authenticated.
  • 200 OK – OAuth is not set, or the browser has been correctly authenticated.

Example HTML:

<iframe src="https://www.planviewer.nl/maps_api/v1/embed/viewer/01716be55c88a0524f59a03c6ec1f4ab0034358e69f801ee70ebc7ba397cf4f9"></iframe>

Editor

_images/editor.jpg

Note

The Editor only is accessible for visitors if OAuth is enabled. Otherwise use the Maps API dashboard on your profile pages to access the Editor.

GET https://www.planviewer.nl/maps_api/v1/embed/editor/(string: identifier)
Status Codes:
  • 404 Not Foundidentifier does not refer to a viewer.
  • 403 Forbidden – OAuth has not been set, or the browser has not (yet) been correctly authenticated.
  • 200 OK – The browser has been correctly authenticated.
<iframe src="https://www.planviewer.nl/maps_api/v1/embed/editor/01716be55c88a0524f59a03c6ec1f4ab0034358e69f801ee70ebc7ba397cf4f9"></iframe>