Background Map Definitions

GeoCrew

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).


Example HTTP request URI:


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 EPSG code value.

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

           },

           {

              ...

           }

        ]

  },

  {

     ...

  }

]