Cloud API Server API Style Engine

Maps API

List maps

Added in v4.3.0
GET http://localhost:3650/api/v1/admin/maps

Lists maps from maps directory. It can be paginated with offset and limit parameters, otherwise first 50 items are returned.

Request

Query Parameters

Parameters Type Description
offset
 integer
The starting position of returned list of items.
Example: 10
Default: 0
Added in v4.3.0
limit
 integer
Maximum number of items which will be returned.
Example: 50
Default: 50
Added in v4.3.0

Responses

Code Content Description
200 application/json MapList Object
400 application/json Errors Object

Detail of the map

Added in v4.3.0
GET http://localhost:3650/api/v1/admin/maps/{id}

Gets information about the given map.

Request

Path Parameters

Parameters Type Description
id
 string
Identifier of the map.
Example: streets
Added in v4.3.0

Responses

Code Content Description
200 application/json MapItemDetail Object
400 application/json Errors Object
404 application/json Errors Object

Change metadata of the map

Added in v4.3.0
POST http://localhost:3650/api/v1/admin/maps/{id}

Changes metadata (format, quality, published) of the given map.

Request

Path Parameters

Parameters Type Description
id
 string
Identifier of the map.
Example: streets
Added in v4.3.0

Body

Content-Type Data
application/json
MapChange Object

Responses

Code Content Description
200 application/json MapItemDetail Object
400 application/json Errors Object
404 application/json Errors Object

Delete the map

Added in v4.3.0
DELETE http://localhost:3650/api/v1/admin/maps/{id}

Deletes the given map. Before deleting, it is automatically unpublished and cannot be served anymore.

Request

Path Parameters

Parameters Type Description
id
 string
Identifier of the map.
Example: streets
Added in v4.3.0

Responses

Code Content Description
200 application/json MapRemove Object
400 application/json Errors Object
404 application/json Errors Object

Publish the map

Added in v4.3.0
POST http://localhost:3650/api/v1/admin/maps/{id}/publish

Publishes the given map. Does nothing, if the map is already published.

Request

Path Parameters

Parameters Type Description
id
 string
Identifier of the map.
Example: streets
Added in v4.3.0

Responses

Code Content Description
200 application/json MapItemDetail Object
400 application/json Errors Object
404 application/json Errors Object

Unpublish the map

Added in v4.3.0
POST http://localhost:3650/api/v1/admin/maps/{id}/unpublish

Unpublishes the given map. Does nothing, if the map is already unpublished.

Request

Path Parameters

Parameters Type Description
id
 string
Identifier of the map.
Example: streets
Added in v4.3.0

Responses

Code Content Description
200 application/json MapItemDetail Object
400 application/json Errors Object
404 application/json Errors Object

MapList Object

Property Type Description
items
 array [ MapItem Object]

MapItem Object

Map item

Property Type Description
id
 string
Identifier of the map
Example: streets
name
 string
Name of the map
Example: streets
title
 string
Title of the map
Example: Streets
published
 boolean
Says whether the map is published
Example: true
format
 string
Selected format of the map rasterization
Example: jpeg
Allowed values: jpeg png webp

example


    {
  "id": "streets",
  "name": "streets",
  "title": "Streets",
  "published": true,
  "format": "jpeg"
}

Errors Object

Property Type Description
errors
 Error

Error Object

Error message

Property Type Description
message
 string
Example: Error message

example


    {"message": "Error message"}

MapItemDetail Object

Map detail

Property Type Description
id
 string
Identifier of the map
Example: streets
name
 string
Name of the map
Example: streets
title
 string
Title of the map
Example: Streets
published
 boolean
Says whether the map is published
Example: true
format
 string
Selected format of the map rasterization
Example: jpeg
Allowed values: jpeg png webp
quality
 integer
Format quality of the map rasterization
Example: 92
urls
 MapItemDetailUrls Object

example


    {
  "id": "streets",
  "name": "streets",
  "title": "Streets",
  "published": true,
  "format": "jpeg",
  "quality": 92,
  "urls": {
    "embeddable": "http://localhost:3650/api/maps/streets",
    "stylejson": "http://localhost:3650/api/maps/streets/style.json",
    "tilejson": "http://localhost:3650/api/maps/streets/tiles.json",
    "tilejson256": "http://localhost:3650/api/maps/streets/256/tiles.json",
    "wms": "http://localhost:3650/api/maps/streets/wms?service=WMS&request=GetCapabilities",
    "wmts": "http://localhost:3650/api/maps/streets/WMTSCapabilities.xml",
    "xyz": "http://localhost:3650/api/maps/streets/{z}/{x}/{y}.jpg",
    "xyz256": "http://localhost:3650/api/maps/streets/256/{z}/{x}/{y}.jpg"
  }
}

MapItemDetailUrls Object

Accessible URLs for the map

Property Type Description
embeddable
 string
URL for the embeddable viewer
Example: http://localhost:3650/api/maps/streets
stylejson
 string
URL for styleJSON
Example: http://localhost:3650/api/maps/streets/style.json
tilejson
 string
URL for tileJSON 516px
Example: http://localhost:3650/api/maps/streets/tiles.json
tilejson256
 string
URL for tileJSON 256px
Example: http://localhost:3650/api/maps/streets/256/tiles.json
wms
 string
URL for WMS, available only with valid license, for non-webp formats
Example: http://localhost:3650/api/maps/streets/wms?service=WMS&request=GetCapabilities
wmts
 string
URL for WMTS
Example: http://localhost:3650/api/maps/streets/WMTSCapabilities.xml
xyz
 string
URL for XYZ 512px
Example: http://localhost:3650/api/maps/streets/{z}/{x}/{y}.jpg
xyz256
 string
URL for XYZ 256px
Example: http://localhost:3650/api/maps/streets/256/{z}/{x}/{y}.jpg

example


    {
  "embeddable": "http://localhost:3650/api/maps/streets",
  "stylejson": "http://localhost:3650/api/maps/streets/style.json",
  "tilejson": "http://localhost:3650/api/maps/streets/tiles.json",
  "tilejson256": "http://localhost:3650/api/maps/streets/256/tiles.json",
  "wms": "http://localhost:3650/api/maps/streets/wms?service=WMS&request=GetCapabilities",
  "wmts": "http://localhost:3650/api/maps/streets/WMTSCapabilities.xml",
  "xyz": "http://localhost:3650/api/maps/streets/{z}/{x}/{y}.jpg",
  "xyz256": "http://localhost:3650/api/maps/streets/256/{z}/{x}/{y}.jpg"
}

MapChange Object

Property Type Description
format
 string
New format
Example: jpeg
Allowed values: jpeg png webp
quality
 integer
New quality in percent
Example: 92
published
 boolean
New state of the map serving
Example: true

example


    {
  "format": "jpeg",
  "quality": 92,
  "published": true
}

MapRemove Object

Property Type Description
removed
 array [string]
The names of removed maps

example


    {"removed": ["streets"]}

MapItemDetailUrls Object

Accessible URLs for the map

Property Type Description
embeddable
 string
URL for the embeddable viewer
Example: http://localhost:3650/api/maps/streets
stylejson
 string
URL for styleJSON
Example: http://localhost:3650/api/maps/streets/style.json
tilejson
 string
URL for tileJSON 516px
Example: http://localhost:3650/api/maps/streets/tiles.json
tilejson256
 string
URL for tileJSON 256px
Example: http://localhost:3650/api/maps/streets/256/tiles.json
wms
 string
URL for WMS, available only with valid license, for non-webp formats
Example: http://localhost:3650/api/maps/streets/wms?service=WMS&request=GetCapabilities
wmts
 string
URL for WMTS
Example: http://localhost:3650/api/maps/streets/WMTSCapabilities.xml
xyz
 string
URL for XYZ 512px
Example: http://localhost:3650/api/maps/streets/{z}/{x}/{y}.jpg
xyz256
 string
URL for XYZ 256px
Example: http://localhost:3650/api/maps/streets/256/{z}/{x}/{y}.jpg

example


    {
  "embeddable": "http://localhost:3650/api/maps/streets",
  "stylejson": "http://localhost:3650/api/maps/streets/style.json",
  "tilejson": "http://localhost:3650/api/maps/streets/tiles.json",
  "tilejson256": "http://localhost:3650/api/maps/streets/256/tiles.json",
  "wms": "http://localhost:3650/api/maps/streets/wms?service=WMS&request=GetCapabilities",
  "wmts": "http://localhost:3650/api/maps/streets/WMTSCapabilities.xml",
  "xyz": "http://localhost:3650/api/maps/streets/{z}/{x}/{y}.jpg",
  "xyz256": "http://localhost:3650/api/maps/streets/256/{z}/{x}/{y}.jpg"
}