Background Map Definitions
The GeoView Server API supports multiple background maps, categorized per map vendors. This REST API method list all available map vendors and associated maps , both tile-based and WMS-based. Accessing this method requires Read permissions.
Request API method URI definition:
HTTP GET http://api.geoview.be/geoservice/v1/catalogs/maps
Request HTTP URI parameters:
Parameter |
Description |
token |
Access token (returned by this API method). |
client |
Client type identifier (based on predefined constraints).This value is optional. If omitted, assumes 0. |
Example HTTP request URI for Web client:
HTTP GET http://api.geoview.be/geoservice/v1/catalogs/maps?&token=3dc718f2-ab20-4f41-86e1-72abcc1810c1
Possible resulting HTTP status codes:
Value |
Description |
200 |
API request succeeded and result(s) were returned. |
204 |
API request succeeded but query didn't produce any results. |
401 |
Supplied API request access token not valid. |
Response JSON structure (please note that API method may return array of vendors and associated map definitions):
Field |
Description |
vendor |
Name of map vendor (i.e. "AGIV") |
maps |
Map definition(s) associated with the vendor. Please see map definition structure below. |
Response JSON map definition structure:
Field |
Description |
name |
Name of the map (i.e. "Grootschalig Referentie Bestand") |
wms |
True if map layer is WMS-based, False otherwise. |
uri |
Map service URI, if applicable.Please mind possible escape characters ("\") and remove them. |
layers |
List of comma-separated WMS layer names. Applicable if map is WMS-based. |
styles |
List of comma-separated WMS style names. Applicable if map is WMS-based. |
format |
Image format returned by WMS server. Applicable if map is WMS-based. |
transparent |
True is map is transparent, False otherwise. |
version |
Version of WMS server service (i.e. "1.3.0"). Applicable if map is WMS-based. |
srs |
Spatial reference system identifier (returned by this API method), being an |
attribution |
Map copyright attribution. |
minzoom |
Represents minimum zoom scale supported by map (0 if not set). |
maxzoom |
Represents maximum zoom scale supported by map (default if not set). |
Example JSON response:
[
{
"vendor":"AGIV",
"maps":
[
{
"name":"Grootschalig Referentie Bestand (GRB)",
"wms":true,
"uri":"http:\/\/grb.agiv.be\/geodiensten\/raadpleegdiensten\/GRB\/wms",
"layers":"GRB_BASISKAART",
"styles":"",
"format":"image\/jpeg",
"transparent":false,
"version":"1.3.0",
"srs":31370,
"attribution":"Bron: AGIV",
"minzoom":0,
"maxzoom":21
},
{
...
}
]
},
{
...
}
]
