-
Notifications
You must be signed in to change notification settings - Fork 0
/
RESTdocumentation.html
426 lines (410 loc) · 29.6 KB
/
RESTdocumentation.html
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
<!--suppress HtmlUnknownTarget -->
<!--suppress HtmlPresentationalElement -->
<p>This is the REST service for janpieterk/gemeentekaart-core.</p>
<h2>Summary</h2>
<p>This service can be used to create a choropleth map of either the municipalities of The Netherlands (default: borders as of
2007, 443 municipalities), the
municipalities of Flanders (308 municipalities), the municipalities of The Netherlands and Flanders combined, the 40
COROP areas of The Netherlands (see <a
href="http://nl.wikipedia.org/w/index.php?title=COROP&oldid=31809700">COROP</a> (Dutch) or <a
href="http://en.wikipedia.org/w/index.php?title=COROP&oldid=482861432">COROP</a> (English)), the twelve
provinces
of The Netherlands, or the 28 dialect areas of Daan/Blok (1969) mapped on municipality borders. Areas can be
assigned colors, typically to denote the relative frequency of some phenomenon.
Some predefined combinations are also possible, at the moment: municipalities with COROP areas, municipalities
with provinces, municipalities with dialect areas.
</p>
<p>Maps can be requested via GET or POST requests. If the only parameters are key-value pairs, they can go either in the
request string (GET request) or in a JSON document in the request body (POST request). If there are structured
parameters a POST request with a JSON request body is advisable. Request string parameters can be
combined with a JSON request body in a POST request. If the same parameters are in the request string and in the
JSON
document, the parameters from the request string have precedence over the ones in the request body.</p>
<h3>New in version 1.1</h3>
<p>
Since version 1.1 the historical municipality and province borders fron the data set <cite><a href="https://doi.org/10.17026/dans-xb9-t677">NLGis shapefiles</a></cite>
by Dr. O.W.A. Boonstra are incorporated in the project. Borders from 1812-1997 area available and can be requested by adding a <code>year</code> parameter to the request. Note that no year parameter results in the 2007 maps from version 1.0. Maps from the NLGis data set use <i>Amsterdam codes</i> for municipalities (see Van der Meer & Boonstra 2011) while the version 1.0 maps use CBS codes.
</p>
<h2>Examples</h2>
<h3>GET requests (clickable)</h3>
<p>
Map of the municipalities, default size and format: <a href="##KAART_URL##?type=municipalities">##KAART_URL##?type=municipalities</a>
<br/>Map of the COROP areas, default size and format: <a
href="##KAART_URL##?type=corop">##KAART_URL##?type=corop</a><br/>
Map of the provinces, default size and format: <a href="##KAART_URL##?type=provinces">##KAART_URL##?type=provinces</a>
<br/>
Map of the dialect areas, default size and format: <a href="##KAART_URL##?type=dialectareas">##KAART_URL##?type=dialectareas</a>
<br/>
Map of the municipalities combined with the COROP areas: <a
href="##KAART_URL##?type=municipalities&additionaldata=corop">##KAART_URL##?type=municipalities&additionaldata=corop</a>
<br/>
Combined map of Dutch and Flemish municipalities: <a href="##KAART_URL##?type=municipalities_nl_flanders">##KAART_URL##?type=municipalities_nl_flanders</a><br/>
Map of the municipalities in 1875: <a href="##KAART_URL##?type=municipalities&year=1875">##KAART_URL##?type=municipalities&year=1875</a><br>
List of years for which maps of provinces can be requested: <a href="##KAART_URL##?type=provinces&possibleyears=1">##KAART_URL##?type=provinces&possibleyears=1</a><br>
List of municipality codes and names for 1936: <a href="##KAART_URL##?possiblemunicipalities=1&year=1936">##KAART_URL##?possiblemunicipalities=1&year=1936</a>
</p>
<h3>JSON POST requests</h3>
<p>Content-type should be <b><code>application/json</code></b>.</p>
<p>Map of the Netherlands municipalities borders, with some municipalities highlighted.
Municipality codes can be obtained by adding <code>possiblemunicipalities=1</code> or <code>possibleareas=1</code>
to
the URL.<br/>
Obtained by POSTing the following JSON document to ##KAART_URL##?type=gemeentes&format=png&width=500:</p>
<pre style="padding: 1em;"><code>
<span style="color: rgb(20, 20, 20);">{</span><span style="color: rgb(20, 20, 20);">
</span><span style="color: rgb(56, 79, 244);">"g_0432"</span><span style="color: rgb(20, 20, 20);"> </span><span style="color: rgb(20, 20, 20);">:</span><span style="color: rgb(20, 20, 20);"> </span><span style="color: rgb(189, 22, 107);">"#FFE680"</span><span style="color: rgb(20, 20, 20);">,</span><span style="color: rgb(20, 20, 20);">
</span><span style="color: rgb(56, 79, 244);">"g_0420"</span><span style="color: rgb(20, 20, 20);"> </span><span style="color: rgb(20, 20, 20);">:</span><span style="color: rgb(20, 20, 20);"> </span><span style="color: rgb(189, 22, 107);">"#FFDD55"</span><span style="color: rgb(20, 20, 20);">,</span><span style="color: rgb(20, 20, 20);">
</span><span style="color: rgb(56, 79, 244);">"g_0448"</span><span style="color: rgb(20, 20, 20);"> </span><span style="color: rgb(20, 20, 20);">:</span><span style="color: rgb(20, 20, 20);"> </span><span style="color: rgb(189, 22, 107);">"#FFD42A"</span><span style="color: rgb(20, 20, 20);">,</span><span style="color: rgb(20, 20, 20);">
</span><span style="color: rgb(56, 79, 244);">"g_0476"</span><span style="color: rgb(20, 20, 20);"> </span><span style="color: rgb(20, 20, 20);">:</span><span style="color: rgb(20, 20, 20);"> </span><span style="color: rgb(189, 22, 107);">"#FFCC00"</span><span style="color: rgb(20, 20, 20);">,</span><span style="color: rgb(20, 20, 20);">
</span><span style="color: rgb(56, 79, 244);">"g_0373"</span><span style="color: rgb(20, 20, 20);"> </span><span style="color: rgb(20, 20, 20);">:</span><span style="color: rgb(20, 20, 20);"> </span><span style="color: rgb(189, 22, 107);">"#D4AA00"</span><span style="color: rgb(20, 20, 20);">,</span><span style="color: rgb(20, 20, 20);">
</span><span style="color: rgb(56, 79, 244);">"g_0400"</span><span style="color: rgb(20, 20, 20);"> </span><span style="color: rgb(20, 20, 20);">:</span><span style="color: rgb(20, 20, 20);"> </span><span style="color: rgb(189, 22, 107);">"#AA8800"</span><span style="color: rgb(20, 20, 20);">,</span><span style="color: rgb(20, 20, 20);">
</span><span style="color: rgb(56, 79, 244);">"g_0366"</span><span style="color: rgb(20, 20, 20);"> </span><span style="color: rgb(20, 20, 20);">:</span><span style="color: rgb(20, 20, 20);"> </span><span style="color: rgb(189, 22, 107);">"#806600"</span><span style="color: rgb(20, 20, 20);">,</span><span style="color: rgb(20, 20, 20);">
</span><span style="color: rgb(56, 79, 244);">"g_0463"</span><span style="color: rgb(20, 20, 20);"> </span><span style="color: rgb(20, 20, 20);">:</span><span style="color: rgb(20, 20, 20);"> </span><span style="color: rgb(189, 22, 107);">"#FFCC00"</span><span style="color: rgb(20, 20, 20);">,</span><span style="color: rgb(20, 20, 20);">
</span><span style="color: rgb(56, 79, 244);">"g_0462"</span><span style="color: rgb(20, 20, 20);"> </span><span style="color: rgb(20, 20, 20);">:</span><span style="color: rgb(20, 20, 20);"> </span><span style="color: rgb(189, 22, 107);">"#FFEEAA"</span><span style="color: rgb(20, 20, 20);">
</span><span style="color: rgb(20, 20, 20);">}</span></code></pre>
<p><img src="img/json_example_3.png" alt=""/></p>
<p>The "four big cities" of the "Randstad" in 1821. Obtained by POSTing the following JSON document to ##KAART_URL##:</p>
<pre style="padding: 1em;"><code>
<span style="color: rgb(20, 20, 20);">{</span><span style="color: rgb(20, 20, 20);">
</span><span style="color: rgb(56, 79, 244);">"data"</span><span style="color: rgb(20, 20, 20);">:</span><span style="color: rgb(20, 20, 20);"> </span><span style="color: rgb(20, 20, 20);">{</span><span style="color: rgb(20, 20, 20);">
</span><span style="color: rgb(56, 79, 244);">"a_11150"</span><span style="color: rgb(20, 20, 20);">:</span><span style="color: rgb(20, 20, 20);"> </span><span style="color: rgb(189, 22, 107);">"#990000"</span><span style="color: rgb(20, 20, 20);">,</span><span style="color: rgb(20, 20, 20);">
</span><span style="color: rgb(56, 79, 244);">"a_10345"</span><span style="color: rgb(20, 20, 20);">:</span><span style="color: rgb(20, 20, 20);"> </span><span style="color: rgb(189, 22, 107);">"#990000"</span><span style="color: rgb(20, 20, 20);">,</span><span style="color: rgb(20, 20, 20);">
</span><span style="color: rgb(56, 79, 244);">"a_11434"</span><span style="color: rgb(20, 20, 20);">:</span><span style="color: rgb(20, 20, 20);"> </span><span style="color: rgb(189, 22, 107);">"#990000"</span><span style="color: rgb(20, 20, 20);">,</span><span style="color: rgb(20, 20, 20);">
</span><span style="color: rgb(56, 79, 244);">"a_10722"</span><span style="color: rgb(20, 20, 20);">:</span><span style="color: rgb(20, 20, 20);"> </span><span style="color: rgb(189, 22, 107);">"#990000"</span><span style="color: rgb(20, 20, 20);">
</span><span style="color: rgb(20, 20, 20);">}</span><span style="color: rgb(20, 20, 20);">,</span><span style="color: rgb(20, 20, 20);">
</span><span style="color: rgb(56, 79, 244);">"year"</span><span style="color: rgb(20, 20, 20);">:</span><span style="color: rgb(20, 20, 20);"> </span><span style="color: rgb(187, 95, 11);">1821</span><span style="color: rgb(20, 20, 20);">,</span><span style="color: rgb(20, 20, 20);">
</span><span style="color: rgb(56, 79, 244);">"type"</span><span style="color: rgb(20, 20, 20);">:</span><span style="color: rgb(20, 20, 20);"> </span><span style="color: rgb(189, 22, 107);">"gemeentes"</span><span style="color: rgb(20, 20, 20);">,</span><span style="color: rgb(20, 20, 20);">
</span><span style="color: rgb(56, 79, 244);">"format"</span><span style="color: rgb(20, 20, 20);">:</span><span style="color: rgb(20, 20, 20);"> </span><span style="color: rgb(189, 22, 107);">"svg"</span><span style="color: rgb(20, 20, 20);">,</span><span style="color: rgb(20, 20, 20);">
</span><span style="color: rgb(56, 79, 244);">"interactive"</span><span style="color: rgb(20, 20, 20);">:</span><span style="color: rgb(20, 20, 20);"> </span><span style="color: rgb(56, 79, 244);">true</span><span style="color: rgb(20, 20, 20);">
</span><span style="color: rgb(20, 20, 20);">}</span></code></pre>
<p><img src="img/svg_example.svg" alt=""/></p>
<h3>Uploading files with POST requests</h3>
<p>Content type should be <code>multipart/form-data</code>.</p>
<p>An alternative way to get data into the Kaart service is to upload a commma-separated file with area codes and
colors. For example, the municipalities map above can alse be obtained by uploading a file with the following
content
to the URL ##KAART_URL##?type=gemeentes&format=png&width=500:</p>
<pre>
"g_0432","#FFE680"
"g_0420","#FFDD55"
"g_0448","#FFD42A"
"g_0476","#FFCC00"
"g_0373","#D4AA00"
"g_0400","#AA8800"
"g_0366","#806600"
"g_0463","#FFCC00"
"g_0462","#FFEEAA"
</pre>
<p>
The name of the file or the field name in the form are not important. If multiple files are uploaded, only the first
one is parsed. The possible area codes for the choropleth
map types can be obtained by adding the parameter possibleareas=1 to the URL, e.g. <a
href="##KAART_URL##?type=dialectareas&possibleareas=1">##KAART_URL##?type=dialectareas&possibleareas=1</a>
for the dialect areas, etc.
</p>
<h2>Full list of possible parameters</h2>
<p><i>Note</i> Many of the parameters below are meant for all choropleth map types. The current list of supported
choropleth types is: </p>
<ul>
<li><code>municipalities</code> (synonymous with <code>gemeentes</code>)</li>
<li><code>corop</code></li>
<li><code>provinces</code> (synonymous with <code>provincies</code>)</li>
<li><code>municipalities_flanders</code></li>
<li><code>municipalities_nl_flanders</code></li>
<li><code>dialectareas</code></li>
</ul>
<table border="1">
<tr>
<th width="100">name</th>
<th>type</th>
<th>notes</th>
</tr>
<tr>
<td><code>additionaldata</code></td>
<td>string</td>
<td>Used to add an additional layer of data to a map. Currently only the combinations <code>type=municipalities&additionaldata=corop</code>,
<code>type=municipalities&additionaldata=provinces</code> or <code>type=dutchlanguagearea&additionaldata=dialectareas</code>
are possible. More to follow.
</td>
</tr>
<tr>
<td><code>base64</code></td>
<td>boolean</td>
<td>If this parameter is set to <code>1</code>, <code>on</code>, <code>true</code> or <code>yes</code>, a
base64-encoded string representation of the map is returned.
</td>
<tr>
<td><code>data</code></td>
<td>array, object or string</td>
<td>a list of area codes with either highlight colors or an object containing
outline, fill and strokewidth. Should generally be used in a POSTed JSON document, however simple lists can
be
appended to the GET string. Examples (see also above)
List of highlighted municipalities:
<pre><code><span style="color: #000000;"> {</span><span style="color: #000000;">
</span><span style="color: #0000CC;">"g_0432"</span><span
style="color: #000000;"> </span><span style="color: #000000;">:</span><span
style="color: #000000;"> </span><span style="color: #FF3399;">"#FFE680"</span><span
style="color: #000000;">,</span><span style="color: #000000;">
</span><span style="color: #0000CC;">"g_0420"</span><span
style="color: #000000;"> </span><span style="color: #000000;">:</span><span
style="color: #000000;"> </span><span style="color: #FF3399;">"#FFDD55"</span><span
style="color: #000000;">,</span><span style="color: #000000;">
</span><span style="color: #0000CC;">"g_0448"</span><span
style="color: #000000;"> </span><span style="color: #000000;">:</span><span
style="color: #000000;"> </span><span style="color: #FF3399;">"#FFD42A"</span><span
style="color: #000000;">,</span><span style="color: #000000;">
</span><span style="color: #0000CC;">"g_0476"</span><span
style="color: #000000;"> </span><span style="color: #000000;">:</span><span
style="color: #000000;"> </span><span style="color: #FF3399;">"#FFCC00"</span><span
style="color: #000000;">,</span><span style="color: #000000;">
</span><span style="color: #0000CC;">"g_0373"</span><span
style="color: #000000;"> </span><span style="color: #000000;">:</span><span
style="color: #000000;"> </span><span style="color: #FF3399;">"#D4AA00"</span><span
style="color: #000000;">,</span><span style="color: #000000;">
</span><span style="color: #0000CC;">"g_0400"</span><span
style="color: #000000;"> </span><span style="color: #000000;">:</span><span
style="color: #000000;"> </span><span style="color: #FF3399;">"#AA8800"</span><span
style="color: #000000;">,</span><span style="color: #000000;">
</span><span style="color: #0000CC;">"g_0366"</span><span
style="color: #000000;"> </span><span style="color: #000000;">:</span><span
style="color: #000000;"> </span><span style="color: #FF3399;">"#806600"</span><span
style="color: #000000;">,</span><span style="color: #000000;">
</span><span style="color: #0000CC;">"g_0463"</span><span
style="color: #000000;"> </span><span style="color: #000000;">:</span><span
style="color: #000000;"> </span><span style="color: #FF3399;">"#FFCC00"</span><span
style="color: #000000;">,</span><span style="color: #000000;">
</span><span style="color: #0000CC;">"g_0462"</span><span
style="color: #000000;"> </span><span style="color: #000000;">:</span><span
style="color: #000000;"> </span><span style="color: #FF3399;">"#FFEEAA"</span><span
style="color: #000000;">
</span><span style="color: #000000;"> }</span></code></pre>
Draw the province of Groningen without a fill and with a red outline which is twice as wide as the default
linewidth for the map:
<pre><code>
<span style="color: #000000;">{</span><span style="color: #000000;">
</span><span style="color: #0000CC;">"p_20"</span><span style="color: #000000;"> </span><span
style="color: #000000;">:</span><span style="color: #000000;"> </span><span
style="color: #000000;">{</span><span style="color: #0000CC;">"fill"</span><span
style="color: #000000;"> </span><span style="color: #000000;">:</span><span
style="color: #000000;"> </span><span style="color: #FF3399;">"none"</span><span
style="color: #000000;">,</span><span style="color: #000000;"> </span><span
style="color: #0000CC;">"outline"</span><span style="color: #000000;"> </span><span
style="color: #000000;">:</span><span style="color: #000000;"> </span><span
style="color: #FF3399;">"red"</span><span style="color: #000000;">,</span><span
style="color: #000000;"> </span><span style="color: #0000CC;">"strokewidth"</span><span
style="color: #000000;">:</span><span style="color: #000000;"> </span><span
style="color: #336699;">2</span><span style="color: #000000;">}</span><span style="color: #000000;">
</span><span style="color: #000000;">}</span><span style="color: #000000;">
</span></code></pre>
Colors can be the name of a color (one of the 140 HTML colors), a hexadecimal representation of the form
<code>#RRGGBB</code>,
or or a hexadecimal representation of the form <code>AABBGGRR</code>. The 'AA' (opacity) part only has an
effect
with KML maps.
</td>
</tr>
<tr>
<td><code>format</code></td>
<td>string</td>
<td><code>svg</code>, <code>png</code>, <code>gif</code>, <code>jpeg</code>, <code>kml</code> or
<code>json</code>.
<code>json</code> returns a <a href="http://geojson.org/geojson-spec.html">geoJSON</a> object.
</td>
</tr>
<tr>
<td><code>height</code></td>
<td>integer</td>
<td>height in pixels of the map. It is generally not a good idea to set the height explicitly, it is better to
set
the width and let the map calculate its own height.
</td>
</tr>
<tr>
<td><code>imagemap</code></td>
<td>boolean</td>
<td>If this parameter is set to <code>1</code>, <code>on</code>, <code>true</code> or <code>yes</code>, a list
of
HTML <area> elements instead of a map image is returned. Can be used to create clickable bitmap maps.
Note:
for maps of type municipalities, imagemap results in a complete imagemap for all municipalities only if:
<ol>
<li>there are no <code>links</code> or <code>tooltips</code> set;</li>
<li>there are <code>links</code> or <code>tooltips</code> set and <code>interactive</code> is set to
true;
</li>
<li><code>link</code> (singular) is set and <code>linkhighlightedonly</code> is not set.</li>
</ol>
In other cases you get a partial imagemap with only the areas set in <code>links</code> or
<code>tooltips</code>.
</td>
</tr>
<tr>
<td><code>interactive</code></td>
<td>boolean</td>
<td>If this parameter is set to <code>1</code>, <code>on</code>, <code>true</code> or <code>yes</code>, for SVG
maps, onmouseover and onmouseout events to show placenames, and for bitmaps maps, area elements with title
and alt
attributes with placenames are added to all placemarks or areas.
</td>
</tr>
<tr>
<td><code>link</code></td>
<td>string</td>
<td>Template for a link to be added to area codes. %s placeholders will be replaced by either
the
area code. For maps of a bitmap format, the links will be added to the imagemap
of the
picture, for maps of format SVG or KML they will be embedded in the XML. Example: <a
href="##KAART_URL##?type=municipalities&format=svg&link=http%3A%2F%2Fwww.example.com%2F%3Fcode%3D%25s">##KAART_URL##?type=municipalities&format=svg&link=http%3A%2F%2Fwww.example.com%2F%3Fcode%3D%25s</a>
(link = urlencoded form of http://www.example.com/?code=%s)
Applies to all municipalities of a map of type <code>municipalities</code> unless the parameter <code>linkhighlightedonly</code> is set to
true.
</td>
</tr>
<tr>
<td><code>linkhighlightedonly</code></td>
<td>boolean</td>
<td>If this parameter is set to <code>1</code>, <code>on</code>,
<code>true</code> or <code>yes</code>, a link set with the <code>link</code> parameter is only added to
higlighted
municipalities which are set with the <code>data</code> parameter.
</td>
</tr>
<tr>
<td><code>links</code></td>
<td>object</td>
<td>List of links to be added to areas. Can
only be used in a POSTed JSON document. Example:
<pre><code><span style="color: #000000;"> </span><span style="color: #000000;">{</span><span
style="color: #000000;">
</span><span style="color: #0000CC;">"g_0462"</span><span
style="color: #000000;"> </span><span style="color: #000000;">:</span><span
style="color: #000000;"> </span><span style="color: #FF3399;">"http://www.example.com/something/"</span><span
style="color: #000000;">,</span><span style="color: #000000;">
</span><span style="color: #0000CC;">"g_0366"</span><span
style="color: #000000;"> </span><span style="color: #000000;">:</span><span
style="color: #000000;"> </span><span
style="color: #FF3399;">"http://www.example.com/something/else/"</span><span
style="color: #000000;">
</span><span style="color: #000000;">}</span></code></pre>
</td>
</tr>
<tr>
<td><code>pathsfile</code></td>
<td>string</td>
<td>If it is necessary to use a non-standard file with paths in a
choropleth map, a filename can be given with this parameter.
Note that this file must exist on the server, be in the correct format and visible to (i.e. in the <code>include_path</code>
of)
the server backend code of the GemeenteKaart module.
</td>
</tr>
<tr>
<td><code>possibleareas</code></td>
<td>boolean</td>
<td>If this parameter is set to <code>1</code>, <code>on</code>,
<code>true</code> or <code>yes</code>, a list (in JSON format) of possible areas (area codes plus names) is
returned. See <a href="##KAART_URL##?possibleareas=1&type=municipalities">##KAART_URL##?possibleareas=1&type=municipalities</a>
or <a href="##KAART_URL##?possibleareas=1&type=corop">##KAART_URL##?possibleareas=1&type=corop</a>. Note
that the
<code>type</code> parameter should be present also.
</td>
</tr>
<tr>
<td><code>possibleformats</code></td>
<td>boolean</td>
<td>If this parameter is set to <code>1</code>, <code>on</code>,
<code>true</code> or <code>yes</code>, a list (in JSON format) of possible map formats is returned. See <a href="##KAART_URL##?possibleformats=1">##KAART_URL##?possibleformats=1</a>.
</td>
</tr>
<tr>
<td><code>possiblemunicipalities</code></td>
<td>boolean</td>
<td>If this parameter is set to <code>1</code>,
<code>on</code>, <code>true</code> or <code>yes</code>, a list (in JSON format) of possible municipalities
(municipality codes plus names) is returned. This is a synonym for
<code>?possibleareas=1&type=municipalities</code>. Note that the <code>type</code> parameter can be left
out.
</td>
</tr>
<tr>
<td><code>possibletypes</code></td>
<td>boolean</td>
<td>If this parameter is set to <code>1</code>, <code>on</code>,
<code>true</code> or <code>yes</code>, a list (in JSON format) of possible map types is returned. See <a href="##KAART_URL##?possibletypes=1">##KAART_URL##?possibletypes=1</a>.
</td>
</tr>
<tr>
<td><code>possibleyears</code></td>
<td>boolean</td>
<td>If this parameter is set to <code>1</code>, <code>on</code>,
<code>true</code> or <code>yes</code>, a list (in JSON format) of possible years for the requested map type is returned. See <a href="##KAART_URL##?type=gemeentes&possibleyears=1">##KAART_URL##?type=gemeentes&possibleyears=1</a>.
</td>
</tr>
<tr>
<td><code>target</code></td>
<td>string</td>
<td>optional target for the link given in the <code>link</code> parameter (see above). Value of the "target"
attribute of the href element.
</td>
</tr>
<tr>
<td><code>tooltips</code></td>
<td>object</td>
<td>List of tooltips (informative texts) to be added to areas. Can only be
used in a POSTed JSON document. Example:
<pre><code><span style="color: #000000;"> </span><span style="color: #000000;">{</span><span
style="color: #000000;">
</span><span style="color: #0000CC;">"g_0462"</span><span
style="color: #000000;"> </span><span style="color: #000000;">:</span><span
style="color: #000000;"> </span><span style="color: #FF3399;">"informative text 1"</span><span
style="color: #000000;">,</span><span style="color: #000000;">
</span><span style="color: #0000CC;">"g_0366"</span><span
style="color: #000000;"> </span><span style="color: #000000;">:</span><span
style="color: #000000;"> </span><span style="color: #FF3399;">"informative text 2"</span><span
style="color: #000000;">
</span><span style="color: #000000;">}</span></code></pre>
</td>
</tr>
<tr>
<td><code>title</code></td>
<td>string</td>
<td>Optional title of the map, will be displayed above the map if given.</td>
</tr>
<tr>
<td><code>type</code></td>
<td>string</td>
<td>one of the choropleth types.</td>
</tr>
<tr>
<td><code>width</code></td>
<td>integer</td>
<td>width in pixels of the map. Overrides the default.</td>
</tr>
<tr>
<td><code>year</code></td>
<td>integer</td>
<td>desired year for the requested map type.</td>
</tr>
</table>
<h3>Literature</h3>
<p>
J. Daan and D.P. Blok (1969). <cite>Van randstad tot landrand. Toelichting bij de kaart: dialecten en naamkunde. Bijdragen en mededelingen der Dialectencommissie van de Koninklijke Nederlandse Akademie van Wetenschappen te Amsterdam 37</cite>, Amsterdam, N.V. Noord-Hollandsche uitgevers maatschappij.
</p>
<p>
Meer, Ad van der & Onno Boonstra (2011). <a href="https://dans.knaw.nl/nl/over/organisatie-beleid/publicaties/DANSrepertoriumnederlandsegemeenten2011.pdf">Repertorium van Nederlandse gemeenten vanaf 1812, waaraan toegevoegd: de Amsterdamse code</a>. 2de editie. [Den Haag: DANS.] (DANS Data Guides, 2).
</p>
<h3>Acknowledgements</h3>
<p>
<small>Source of the 2007 choropleth data of the Netherlands: <a href="http://www.cbs.nl/">CBS</a> and the <i>afdeling
Geo-informatie van het Kadaster</i>.<br/>
Source of the choropleth data of Flanders: <a href="http://www.openstreetmap.org">OpenStreetMap</a>. This data
is © OpenStreetMap contributors and licensed under the <a href="http://www.openstreetmap.org/copyright">Open
Data Commons Open Database License</a>.<br/>
Source of the historical municipality borders of the Netherlands:
Dr. O.W.A. Boonstra; (2007): NLGis shapefiles. DANS. <a href="https://doi.org/10.17026/dans-xb9-t677">https://doi.org/10.17026/dans-xb9-t677</a>.<br>
The REST service uses the <a href="https://github.com/pieterb/REST">REST service PHP library</a> by Pieter van
Beek.
</small>
</p>