REST API for Unified Assurance Vision

Update a Map Tile

put

/vision/api/mapTiles/{id}

Updates the specified map tile entirely. The map tile definition in the request body replaces the map tile's existing definition.
Note: You cannot change the value of defaultMap from true to false. Instead, set a different map to default, and the value for the old map will be changed automatically.
Unified Assurance roles with the following Vision package permissions have access to this endpoint:

Admin
Api

Request

Path Parameters

id(required): integer(int64)
The ID of the map tile to update.
Example:
```
1
```

Supported Media Types

application/json

Root Schema : schema

Type: object

The map details.

Show Source

attribution: string

The map copyright notice.

Example: OpenStreetMap contributors, Points &copy 2012 LINZ
defaultMap: boolean

Whether it is the default map (true) or not (false).

Example: false
id: integer (int64)

The map ID.

Example: 12
legendPosition: string

Where to show the legend for the map. Applicable to Open Weather Maps only.

Example: bottomleft
mapType: string
The type of map. Valid values are:
- basemap
- owm
- other
- image
- wms
Example: basemap
maxZoom: integer (int32)

The maximum zoom level for the map. Must be an integer between 0 and 20.

Example: 18
name: string

The map name.

Example: OSM Standard
onByDefault: boolean

Whether to display the map when Vision first loads (true) or not (false).

Example: true
opacity: number (double)

The opacity level for the map. Must be a decimal between 0 and 1. Does not apply to base maps.

Example: 1
showLegend: boolean

Whether to show a legend for the map (true) or not (false). Applicable to Open Weather Maps only.

Example: false
url: string

The map URL.

Example: http://{s}.tile.osm.org/{z}/{x}/{y}.png

{
    "properties":{
        "attribution":{
            "description":"The map copyright notice.",
            "example":"OpenStreetMap contributors, Points &copy 2012 LINZ",
            "type":"string"
        },
        "defaultMap":{
            "description":"Whether it is the default map (<b>true</b>) or not (<b>false</b>).",
            "example":false,
            "type":"boolean"
        },
        "id":{
            "description":"The map ID.",
            "example":12,
            "format":"int64",
            "type":"integer"
        },
        "legendPosition":{
            "description":"Where to show the legend for the map. Applicable to Open Weather Maps only.",
            "example":"bottomleft",
            "type":"string"
        },
        "mapType":{
            "description":"The type of map. Valid values are: <ul><li>basemap</li><li>owm</li><li>other</li><li>image</li><li>wms</li></ul>",
            "example":"basemap",
            "type":"string"
        },
        "maxZoom":{
            "description":"The maximum zoom level for the map. Must be an integer between 0 and 20.",
            "example":18,
            "format":"int32",
            "type":"integer"
        },
        "name":{
            "description":"The map name.",
            "example":"OSM Standard",
            "type":"string"
        },
        "onByDefault":{
            "description":"Whether to display the map when Vision first loads (<b>true</b>) or not (<b>false</b>).",
            "example":true,
            "type":"boolean"
        },
        "opacity":{
            "description":"The opacity level for the map. Must be a decimal between 0 and 1. Does not apply to base maps.",
            "example":1,
            "format":"double",
            "type":"number"
        },
        "showLegend":{
            "description":"Whether to show a legend for the map (<b>true</b>) or not (<b>false</b>). Applicable to Open Weather Maps only.",
            "example":false,
            "type":"boolean"
        },
        "url":{
            "description":"The map URL.",
            "example":"http://{s}.tile.osm.org/{z}/{x}/{y}.png",
            "type":"string"
        }
    },
    "description":"The map details.",
    "type":"object"
}

Response

Supported Media Types

application/json

200 Response

Root Schema : ResourceWrapper23

Type: object

The response resource wrapper.

Show Source

columns: array columns

Information about the columns used to display the requested or updated content.
content: content
links: array links

Links related to the requested or updated content.

{
    "properties":{
        "columns":{
            "description":"Information about the columns used to display the requested or updated content.",
            "items":{
                "$ref":"#/components/schemas/ColumnData"
            },
            "type":"array"
        },
        "content":{
            "allOf":[
                {
                    "$ref":"#/components/schemas/MapTile"
                },
                {
                    "allOf":[
                        {
                            "$ref":"#/components/schemas/MapTile"
                        },
                        {
                            "description":"The requested or updated content."
                        }
                    ]
                }
            ]
        },
        "links":{
            "description":"Links related to the requested or updated content.",
            "items":{
                "$ref":"#/components/schemas/Link"
            },
            "type":"array"
        }
    },
    "description":"The response resource wrapper.",
    "type":"object"
}

Nested Schema : columns

Type: array

Information about the columns used to display the requested or updated content.

Show Source

Array of: object ColumnData

The details of columns to use to show data in a table.

{
    "description":"Information about the columns used to display the requested or updated content.",
    "items":{
        "$ref":"#/components/schemas/ColumnData"
    },
    "type":"array"
}

Nested Schema : content

Match All

Show Source

object schema

The map details.
allOf content-allOf[1]

{
    "allOf":[
        {
            "$ref":"#/components/schemas/MapTile"
        },
        {
            "allOf":[
                {
                    "$ref":"#/components/schemas/MapTile"
                },
                {
                    "description":"The requested or updated content."
                }
            ]
        }
    ]
}

Nested Schema : links

Type: array

Links related to the requested or updated content.

Show Source

Array of: object Link

The link details.

{
    "description":"Links related to the requested or updated content.",
    "items":{
        "$ref":"#/components/schemas/Link"
    },
    "type":"array"
}

Nested Schema : ColumnData

Type: object

The details of columns to use to show data in a table.

Show Source

cssClass: string

The CSS class for the column.

Example: slick-header-column
defaultSortAsc: boolean

Whether to sort the column in ascending order by default (true) or not (false).

Example: true
editor: string

The editor to use for the column.

Example: TaskEnabledEditor
entity: string

The name of the Vision resource that the column represents. This generally corresponds to one of the sections in the side menu of the Settings UI.

Example: Task
field: string

The field to use for data in the column cells.

Example: enabled
focusable: boolean

Whether the column is focusable (true) or not (false).

Example: true
formatter: string

The formatter to apply to the column. For example, CamelCaseFormatter formats strings to use camel case, transforming a value like true to True.

Example: CamelCaseFormatter
headerCssClass: string

The CSS class for the column header.

Example: slick-header-column
id: integer (int64)

The column ID.

Example: 130
maxWidth: integer (int32)

The maximum width for the column.

Example: 80
minWidth: integer (int32)

The minimum width for the column.

Example: 30
name: string

The column name, that appears in the header row.

Example: Enabled
options: string

Options for values in the column.

Example: true,false
rerenderOnResize: boolean

Whether the column should be rerendered when resized (true) or not (false).

Example: false
resizable: boolean

Whether the column can be resized (true) or not (false).

Example: true
selectable: boolean

Whether the column can be selected (true) or not (false).

Example: true
sortable: boolean

Whether the column can be used to sort the table (true) or not (false).

Example: true
tooltip: string

The tooltip to display for the column.

Example: Whether the task is enabled or disabled.
width: integer (int32)

The default width, in pixels, of the column.

Example: 50

{
    "properties":{
        "cssClass":{
            "description":"The CSS class for the column.",
            "example":"slick-header-column",
            "type":"string"
        },
        "defaultSortAsc":{
            "description":"Whether to sort the column in ascending order by default (<b>true</b>) or not (<b>false</b>).",
            "example":true,
            "type":"boolean"
        },
        "editor":{
            "description":"The editor to use for the column.",
            "example":"TaskEnabledEditor",
            "type":"string"
        },
        "entity":{
            "description":"The name of the Vision resource that the column represents. This generally corresponds to one of the sections in the side menu of the <b>Settings</b> UI.",
            "example":"Task",
            "type":"string"
        },
        "field":{
            "description":"The field to use for data in the column cells.",
            "example":"enabled",
            "type":"string"
        },
        "focusable":{
            "description":"Whether the column is focusable (<b>true</b>) or not (<b>false</b>).",
            "example":true,
            "type":"boolean"
        },
        "formatter":{
            "description":"The formatter to apply to the column. For example, CamelCaseFormatter formats strings to use camel case, transforming a value like <b>true</b> to <b>True</b>.",
            "example":"CamelCaseFormatter",
            "type":"string"
        },
        "headerCssClass":{
            "description":"The CSS class for the column header.",
            "example":"slick-header-column",
            "type":"string"
        },
        "id":{
            "description":"The column ID.",
            "example":130,
            "format":"int64",
            "type":"integer"
        },
        "maxWidth":{
            "description":"The maximum width for the column.",
            "example":80,
            "format":"int32",
            "type":"integer"
        },
        "minWidth":{
            "description":"The minimum width for the column.",
            "example":30,
            "format":"int32",
            "type":"integer"
        },
        "name":{
            "description":"The column name, that appears in the header row.",
            "example":"Enabled",
            "type":"string"
        },
        "options":{
            "description":"Options for values in the column.",
            "example":"true,false",
            "type":"string"
        },
        "rerenderOnResize":{
            "description":"Whether the column should be rerendered when resized (<b>true</b>) or not (<b>false</b>).",
            "example":false,
            "type":"boolean"
        },
        "resizable":{
            "description":"Whether the column can be resized (<b>true</b>) or not (<b>false</b>).",
            "example":true,
            "type":"boolean"
        },
        "selectable":{
            "description":"Whether the column can be selected (<b>true</b>) or not (<b>false</b>).",
            "example":true,
            "type":"boolean"
        },
        "sortable":{
            "description":"Whether the column can be used to sort the table (<b>true</b>) or not (<b>false</b>).",
            "example":true,
            "type":"boolean"
        },
        "tooltip":{
            "description":"The tooltip to display for the column.",
            "example":"Whether the task is enabled or disabled.",
            "type":"string"
        },
        "width":{
            "description":"The default width, in pixels, of the column.",
            "example":50,
            "format":"int32",
            "type":"integer"
        }
    },
    "description":"The details of columns to use to show data in a table.",
    "type":"object"
}

Nested Schema : content-allOf[1]

Match All

The requested or updated content.

Show Source

object schema

The map details.
The requested or updated content.

{
    "allOf":[
        {
            "$ref":"#/components/schemas/MapTile"
        },
        {
            "description":"The requested or updated content."
        }
    ]
}

Nested Schema : schema

Type: object

The map details.

Show Source

attribution: string

The map copyright notice.

Example: OpenStreetMap contributors, Points &copy 2012 LINZ
defaultMap: boolean

Whether it is the default map (true) or not (false).

Example: false
id: integer (int64)

The map ID.

Example: 12
legendPosition: string

Where to show the legend for the map. Applicable to Open Weather Maps only.

Example: bottomleft
mapType: string
The type of map. Valid values are:
- basemap
- owm
- other
- image
- wms
Example: basemap
maxZoom: integer (int32)

The maximum zoom level for the map. Must be an integer between 0 and 20.

Example: 18
name: string

The map name.

Example: OSM Standard
onByDefault: boolean

Whether to display the map when Vision first loads (true) or not (false).

Example: true
opacity: number (double)

The opacity level for the map. Must be a decimal between 0 and 1. Does not apply to base maps.

Example: 1
showLegend: boolean

Whether to show a legend for the map (true) or not (false). Applicable to Open Weather Maps only.

Example: false
url: string

The map URL.

Example: http://{s}.tile.osm.org/{z}/{x}/{y}.png

{
    "properties":{
        "attribution":{
            "description":"The map copyright notice.",
            "example":"OpenStreetMap contributors, Points &copy 2012 LINZ",
            "type":"string"
        },
        "defaultMap":{
            "description":"Whether it is the default map (<b>true</b>) or not (<b>false</b>).",
            "example":false,
            "type":"boolean"
        },
        "id":{
            "description":"The map ID.",
            "example":12,
            "format":"int64",
            "type":"integer"
        },
        "legendPosition":{
            "description":"Where to show the legend for the map. Applicable to Open Weather Maps only.",
            "example":"bottomleft",
            "type":"string"
        },
        "mapType":{
            "description":"The type of map. Valid values are: <ul><li>basemap</li><li>owm</li><li>other</li><li>image</li><li>wms</li></ul>",
            "example":"basemap",
            "type":"string"
        },
        "maxZoom":{
            "description":"The maximum zoom level for the map. Must be an integer between 0 and 20.",
            "example":18,
            "format":"int32",
            "type":"integer"
        },
        "name":{
            "description":"The map name.",
            "example":"OSM Standard",
            "type":"string"
        },
        "onByDefault":{
            "description":"Whether to display the map when Vision first loads (<b>true</b>) or not (<b>false</b>).",
            "example":true,
            "type":"boolean"
        },
        "opacity":{
            "description":"The opacity level for the map. Must be a decimal between 0 and 1. Does not apply to base maps.",
            "example":1,
            "format":"double",
            "type":"number"
        },
        "showLegend":{
            "description":"Whether to show a legend for the map (<b>true</b>) or not (<b>false</b>). Applicable to Open Weather Maps only.",
            "example":false,
            "type":"boolean"
        },
        "url":{
            "description":"The map URL.",
            "example":"http://{s}.tile.osm.org/{z}/{x}/{y}.png",
            "type":"string"
        }
    },
    "description":"The map details.",
    "type":"object"
}

Nested Schema : Link

Type: object

The link details.

Show Source

expects: object expects

Additional Properties Allowed: additionalProperties

Any input expected by the link.
href: string

The link reference.

Example: https://example.com/layers
method: string

The HTTP method used by the linked object.

Example: GET
rel: string

The relationship between the linked object and the current object.

Example: self

{
    "properties":{
        "expects":{
            "additionalProperties":{
                "type":"object"
            },
            "description":"Any input expected by the link.",
            "example":"text",
            "type":"object"
        },
        "href":{
            "description":"The link reference.",
            "example":"https://example.com/layers",
            "type":"string"
        },
        "method":{
            "description":"The HTTP method used by the linked object.",
            "example":"GET",
            "type":"string"
        },
        "rel":{
            "description":"The relationship between the linked object and the current object.",
            "example":"self",
            "type":"string"
        }
    },
    "description":"The link details.",
    "type":"object"
}

Nested Schema : expects

Type: object

Additional Properties Allowed

Show Source

object additionalProperties

{
    "additionalProperties":{
        "type":"object"
    },
    "description":"Any input expected by the link.",
    "example":"text",
    "type":"object"
}

Any input expected by the link.

Example:

text

Nested Schema : additionalProperties

Type: object

401 Response

Unauthorized Access

Root Schema : schema

Type: object

The error response details.

Show Source

message: string

The error message.

Example: An internal server error occurred.
reason: string

The reason phrase for the response.

Example: INTERNAL SERVER ERROR
status: integer (int32)

The response status code.

Example: 500

{
    "properties":{
        "message":{
            "description":"The error message.",
            "example":"An internal server error occurred.",
            "type":"string"
        },
        "reason":{
            "description":"The reason phrase for the response.",
            "example":"INTERNAL SERVER ERROR",
            "type":"string"
        },
        "status":{
            "description":"The response status code.",
            "example":500,
            "format":"int32",
            "type":"integer"
        }
    },
    "description":"The error response details.",
    "type":"object"
}

404 Response

Resource not Found

Root Schema : schema

Type: object

The error response details.

Show Source

message: string

The error message.

Example: An internal server error occurred.
reason: string

The reason phrase for the response.

Example: INTERNAL SERVER ERROR
status: integer (int32)

The response status code.

Example: 500

{
    "properties":{
        "message":{
            "description":"The error message.",
            "example":"An internal server error occurred.",
            "type":"string"
        },
        "reason":{
            "description":"The reason phrase for the response.",
            "example":"INTERNAL SERVER ERROR",
            "type":"string"
        },
        "status":{
            "description":"The response status code.",
            "example":500,
            "format":"int32",
            "type":"integer"
        }
    },
    "description":"The error response details.",
    "type":"object"
}

422 Response

Unprocessable Entity. Usually due to not providing a required field.

Root Schema : schema

Type: object

The error response details.

Show Source

message: string

The error message.

Example: An internal server error occurred.
reason: string

The reason phrase for the response.

Example: INTERNAL SERVER ERROR
status: integer (int32)

The response status code.

Example: 500

{
    "properties":{
        "message":{
            "description":"The error message.",
            "example":"An internal server error occurred.",
            "type":"string"
        },
        "reason":{
            "description":"The reason phrase for the response.",
            "example":"INTERNAL SERVER ERROR",
            "type":"string"
        },
        "status":{
            "description":"The response status code.",
            "example":500,
            "format":"int32",
            "type":"integer"
        }
    },
    "description":"The error response details.",
    "type":"object"
}

500 Response

An internal server error occurred while accessing the database or performing a database operation.

Root Schema : schema

Type: object

The error response details.

Show Source

message: string

The error message.

Example: An internal server error occurred.
reason: string

The reason phrase for the response.

Example: INTERNAL SERVER ERROR
status: integer (int32)

The response status code.

Example: 500

{
    "properties":{
        "message":{
            "description":"The error message.",
            "example":"An internal server error occurred.",
            "type":"string"
        },
        "reason":{
            "description":"The reason phrase for the response.",
            "example":"INTERNAL SERVER ERROR",
            "type":"string"
        },
        "status":{
            "description":"The response status code.",
            "example":500,
            "format":"int32",
            "type":"integer"
        }
    },
    "description":"The error response details.",
    "type":"object"
}