Online Maps

Online maps consist of the following services:

  • Static Maps
  • Map Tiles

All services use the Web Mercator projection and produce PNG raster images. All coordinates are in WGS84.

Static Maps

Static maps are map images of arbitrary size, location and zoom level. All are programmable.

API

<base-url>/api/maps/<version>/<style>/<substyle>/map.png?<parameters>

Parameters

parameter description values default value
version API version 1
style map style basic, gogo, tommy, street, hero, ocean, formal, topo, aqui
substyle map style variant day, night
[point] map center as WGS84 latitude,longitude latitude= -90..90 longitude=-180..180 52.202242, 4.538984
[zoom] zoom level 7..20 13
[width] width in pixels 1..20000 512
[height] height in pixels 1..20000 512
[language] map label language en, nl, fy, de nl
API-key API secret key, to be requested from MarinePlan UUID

Output

Example output for /api/maps/1/basic/day/map.png?lat=53.030288&lon=5.663314&force=1&language=nl

Map Tiles

Map tiles are 256×256 PNG images as standardized by several industries. MarinePlan recommends the use of the Leaflet JS library to create an interative map as depicted in the Interactive Map Demo.

API

The endpoint is <base-url>/tiles/<version>/<style>/<substyle>/<zoom>/<x>/<y>.png?<parameters>

Parameters

parameter description values default value
version map version 1
style map style basic, gogo, tommy, street, hero, ocean, formal, topo, aqui
substyle map style variant  day, night
 x X tile number (numbers from Greenwich = 0)
 y Y tile number (numbers from the equator = 0)
 zoom zoom level 7..20
[language] map label language en, nl, fy, de nl
API-key API secret key, to be requested from MarinePlan UUID

Output

Example output for /tiles/1/basic/day/15/16835/10766.png

Bitnami