Webservices.nl
Manual 28-11-2024
Getting Started
Implementation
Implementation
Accounting
Services
Service methods

Map

This service provides a graphical map given a dutch postcode.

Summary
Map
This service provides a graphical map given a dutch postcode.
Service methods
mapViewPostcodeV2
Returns a map in JPG or PNG format showing the location of the given postcode.
mapViewLatLon
Returns a map in PNG or JPG format centered on the latlon coordinate.
mapViewRD
Returns a map in PNG or JPG format centered on the xy RD coordinate.
mapViewInternationalLatLon
Returns a map centered on the lat/lon coordinate.
Deprecated service methods
mapViewPostcode
This method is deprecated, use mapViewPostcodeV2 instead
Type definitions
RDCoordinates
A geographical location in the RD (Dutch: Rijksdriehoek) system.
LatLonCoordinates
A geographical location in the latitude/longitude system.
Definitions
Zoom
The zoom input parameter in meters per pixel (m/p) is internally converted to a standardized zoomlevel (see conversion table).

Service methods

mapViewPostcodeV2

Returns a map in JPG or PNG format showing the location of the given postcode.

Parameters

postcodeThe postcode
formatImageformat, PNG (default) or JPG
widthWidth in pixels [1 - 2048]
heightHeight in pixels [1 - 2048]
zoomScale in meters per pixel.  See: Zoom

Returns

imageA JPEG or PNG image, base64 encoded.

mapViewLatLon

Returns a map in PNG or JPG format centered on the latlon coordinate.  The extra_latlon parameter can be used to specify additional locations, the map is not centered or zoomed to automatically enclose these locations.

Parameters

center_latThe latitude component of the coordinate.
center_lonThe longitude component of the coordinate.
extra_latlonAdditional Coordinates, an Patterns::{Type}Array of type LatLonCoordinates
formatImageformat, PNG (default) or JPG
widthWidth in pixels, domain [1 - 2048]
heightHeight in pixels, domain [1 - 2048]
zoomScale in meters per pixel.  See: Zoom

Returns

imageA JPEG or PNG image, base64 encoded.

mapViewRD

Returns a map in PNG or JPG format centered on the xy RD coordinate.  The extra_xy parameter can be used to specify additional locations, the map is not centered or zoomed to automatically enclose these locations.

Parameters

center_xThe RD X component of the coordinate.
center_yThe RD Y component of the coordinate.
extra_xyAdditional RDCoordinates, an Patterns::{Type}Array of type RDCoordinates
formatImageformat, PNG (default) or JPG
widthWidth in pixels, domain [1 - 2048]
heightHeight in pixels, domain [1 - 2048]
zoomScale in meters per pixel.  See: Zoom

Returns

imageA JPEG or PNG image, base64 encoded.

mapViewInternationalLatLon

Returns a map centered on the lat/lon coordinate.

Parameters

latitudeThe latitude component of the coordinate.
longitudeThe longitude component of the coordinate.
formatImage format.  Supported formats: ‘JPG’, ‘PNG’
widthWidth in pixels, domain [1-2048]
heightHeight in pixels, domain [1-2048]
zoomScale in meters per pixel.  See: Zoom

Returns

imageA base64 encoded image.

Deprecated service methods

mapViewPostcode

Notice

This method is deprecated, use mapViewPostcodeV2 instead

Returns a map in PNG format showing the location of the given postcode(s).  Postcodes in the different set will be shown in different colours.  At most 174 postcodes in total may be supplied.  The scale determines the scale of the map and should be between 0 and 6.

Parameters

postcodes1An array of postcodes to form the first set.
postcodes2An array of postcodes to form the second set.
postcodes3An array of postcodes to form the third set.
postcodes4An array of postcodes to form the fourth set.
scaleScale 0 to 6 correspond to the following levels of detail:
0determine automatically
1street
2neighborhood
3city
4region
5province
6country.

Returns

imageA PNG image, base64 encoded.

Type definitions

RDCoordinates

A geographical location in the RD (Dutch: Rijksdriehoek) system.

xThe X coordinate
yThe Y coordinate

LatLonCoordinates

A geographical location in the latitude/longitude system.

latitudeThe latitude in degrees (floating point)
longitudeThe degrees in degrees (floating point)

Definitions

Zoom

The zoom input parameter in meters per pixel (m/p) is internally converted to a standardized zoomlevel (see conversion table).  When a given m/p ratio is between two zoomlevels, the zoomlevel closest to the given m/p ratio is chosen.  This means that different m/p ranges will convert to the same zoomlevel, resulting in an equal map image.  We recommend you choose a zoomlevel and then use the corresponding m/p ratio as input parameter.

Conversion table

156412m/p is upperbound for zoomlevel 0
78206m/p is upperbound for zoomlevel 1
39103m/p is upperbound for zoomlevel 2
19551m/p is upperbound for zoomlevel 3
9776m/p is upperbound for zoomlevel 4
4888m/p is upperbound for zoomlevel 5
2444m/p is upperbound for zoomlevel 6
1222m/p is upperbound for zoomlevel 7
610.984m/p is upperbound for zoomlevel 8
305.492m/p is upperbound for zoomlevel 9
152.746m/p is upperbound for zoomlevel 10
76.373m/p is upperbound for zoomlevel 11
38.187m/p is upperbound for zoomlevel 12
19.093m/p is upperbound for zoomlevel 13
9.547m/p is upperbound for zoomlevel 14
4.773m/p is upperbound for zoomlevel 15
2.387m/p is upperbound for zoomlevel 16
1.193m/p is upperbound for zoomlevel 17
0.596m/p is upperbound for zoomlevel 18
0.298m/p is upperbound for zoomlevel 19
Generated by Natural Docs
Returns a map in JPG or PNG format showing the location of the given postcode.
The zoom input parameter in meters per pixel (m/p) is internally converted to a standardized zoomlevel (see conversion table).
An array of type {Type} entries.
A geographical location in the latitude/longitude system.
A geographical location in the RD (Dutch: Rijksdriehoek) system.