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

GET http(s)://api.marineplan.com/api/maps/<version>/<language>/<unit>/<style>/<variant>/map.<ext>?<parameters>

Parameters

parameter description values default value
version API version 1
style map style
  • basic: MarinePlan Maps
  • gogo: impression of Google Maps
  • tommy: impression of TomTom Maps
  • street: impression of OpenStreetMap
  • hero: impression of Vaarkaart Nederland Map
  • ocean: impression of Navionics Maps
  • formal: impression of Kadaster Maps
  • topo: impression of OpenTopo Maps
  • aqui: impression of Here Maps
  • nature: simplified thema resembling satellite imagery colours
  • transparent: overlay with labels, POIs and details to be overlaid on satellite imagery
  • details: overlay with POIs and details to be overlaid on a typical street-map such as TomTom or OSM
variant map style variant (only for basic style)
  • day: day style
  • night: night style
ext file format
  • png: raster image
  • svg: vector image
[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: English
  • nl: Dutch
  • fy: Frisian
  • de: German
  • fr: French
unit bridge and lock dimensions unit
  • m: meters (e.g. H3.45)
  • dm: decimeters (e.g. H35)
  • cm: centimeters (e.g. H345)
  • ft: feet and inches (e.g. H11’1″)
API-key API secret key, to be requested from MarinePlan UUID

Output

Example output for http(s)://api.marineplan.com/api/maps/1/nl/dm/basic/day/map.png?lat=53.030288&lon=5.663314
Example output for http(s)://api.marineplan.com/api/maps/1/nl/dm/basic/day/map.svg?lat=53.030288&lon=5.663314

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

GET http(s)://api.marineplan.com/tiles/<version>/<language>/<unit>/<style>/<variant>/<zoom>/<x>/<y>.png?<parameters>

Parameters

parameter description values default value
version map version 2
language map label language
  • en: English
  • nl: Dutch
  • fy: Frisian
  • de: German
  • fr: French
style map style
  • basic: MarinePlan Maps
  • gogo: impression of Google Maps
  • tommy: impression of TomTom Maps
  • street: impression of OpenStreetMap
  • hero: impression of Vaarkaart Nederland Map
  • ocean: impression of Navionics Maps
  • formal: impression of Kadaster Maps
  • topo: impression of OpenTopo Maps
  • aqui: impression of Here Maps
variant map style variant
  • day
  • night (only for basic)
 x X tile number (numbers from Greenwich = 0) 0..2zoom-1
 y Y tile number (numbers from the equator = 0) 0..2zoom-1
 zoom zoom level 6..20
unit bridge and lock dimensions units
  • m: meters (e.g. H3.45)
  • dm: decimeters (e.g. H35)
  • cm: centimeters (e.g. H345)
  • ft: feet and inches (e.g. H11’1″)
API-key API secret key, to be requested from MarinePlan UUID

Output

Example output for /tiles/2/nl/dm/basic/day/15/16835/10766.png

Bitnami