Override Theme - Precisely Data Integrity Suite

Data Integrity Suite APIs
Product
Data_Integrity
Spatial_Analytics
Data_Enrichment
geo_addressing_1
Services
Spatial Analytics
Data Enrichment
Geo Addressing
ft:title
Data Integrity Suite APIs
ft:locale
en-US
PublicationType
pt_developer
copyrightfirst
2023
copyrightlast
2026

The override theme applies a single style to all features in a layer. Different styles can be applied to points, lines and polygons in an override theme.

The structure of the JSON is shown below where two layers are specified in the WMS getMap URL.
Note: The layer name is required.
{
  "styleDetails": [
    {
      "layer": {
        "name": "address_fabric",
        "type": "NamedLayer"
      },
      "themeList": {
        "theme": [
          {
            "type": "OverrideTheme",
            "style": {}
          }
        ]
      }
    },
    {
      "layer": {
        "name": "buildings",
        "type": "NamedLayer"
      },
      "themeList": {
        "theme": [
          {
            "type": "OverrideTheme",
            "style": {}
          }
        ]
      }
    }
  ]
}
The structure of the JSON where one layer is specified in the WMS getMap URL is shown below.
Note: The layer name is not required in these cases.
{
  "styleDetails": [
    {
      "themeList": {
        "theme": [
          {
            "type": "OverrideTheme",
            "style": {}
          }
        ]
      }
    }
  ]
}

The relevant JSON properties are described below

Element Description
layer -> name

This is the name of the WMS layer retuned in the get capabilities response. The same layer must also be specified in the LAYERS parameter.

Note: This is required in cases where only 2 or more layers are specified in the URL request.
Layer -> type

This is always a string value "NamedLayer".

Note: This is required in cases where only 2 or more layers are specified in the URL request.
theme -> type The type of theme. For style override this is always "OverrideTheme"
theme -> style

The JSON style definition which contains a MapBasicCompositeStyle.

Example Requests

Point Layer

Request (GET) 

curl –location '
            https://api.cloud.precisely.com/v1/spatial/wms?SERVICE=WMS&VERSION=1.3.0&REQUEST=GetMap&BBOX=37.78662956646336823%2C-122.2745967175037549%2C37.81410536165775227%2C-122.2403683391127061&CRS=EPSG%3A4326&WIDTH=1062&HEIGHT=853&LAYERS=address_fabric&STYLES=&FORMAT=image%2Fpng&DPI=96&MAP_RESOLUTION=96&FORMAT_OPTIONS=dpi%3A96&TRANSPARENT=TRUE&SLD_BODY=%7B%22styleDetails%22%3A%20%5B%7B%22themeList%22%3A%20%7B%22theme%22%3A%20%5B%7B%22type%22%3A%20%22OverrideTheme%22%2C%22style%22%3A%20%7B%22type%22%3A%20%22MapBasicCompositeStyle%22%2C%22PointStyle%22%3A%20%7B%22type%22%3A%20%22MapBasicPointStyle%22%2C%22MapBasicSymbol%22%3A%20%7B%22type%22%3A%20%22MapBasicFontSymbol%22%2C%22shape%22%3A%2036%2C%22size%22%3A%2012%2C%22color%22%3A%20%22255%22%2C%22fontName%22%3A%20%22MapInfo%20Symbols%22%2C%22rotation%22%3A%200%2C%22bold%22%3A%20false%2C%22dropShadow%22%3A%20false%2C%22border%22%3A%20%22NONE%22%7D%7D%7D%7D%5D%7D%7D%5D%7D\

JSON Body

{
  "styleDetails": {
    "themeList": [
      {
        "theme": [
          {
            "type": "OverrideTheme",
            "style": {
              "type": "MapBasicCompositeStyle",
              "PointStyle": {
                "type": "MapBasicPointStyle",
                "MapBasicSymbol": {
                  "type": "MapBasicFontSymbol",
                  "shape": 36,
                  "size": 12,
                  "color": "255",
                  "fontName": "MapInfo Symbols",
                  "rotation": 0,
                  "bold": false,
                  "dropShadow": false,
                  "border": "NONE"
                }
              }
            }
          }
        ]
      }
    ]
  }
}

Response

Map with dense blue star point symbols forming land areas.

Line Layer

Request (GET) 

curl --location '
            https://api.cloud.precisely.com/v1/spatial/wms?VERSION=1.3.0&SERVICE=WMS&REQUEST=GetMap&CRS=crs%3A84&BBOX=-67.066107%2C35.651697%2C-66.825227%2C35.795991&WIDTH=900&HEIGHT=900&Layers=hwr_usa_hurricanelines_layer&STYLES=&FORMAT=image%2Fpng&SLD_BODY=%7B%22styleDetails%22%3A%20%5B%7B%22themeList%22%3A%20%7B%22theme%22%3A%20%5B%7B%22type%22%3A%20%22OverrideTheme%22%2C%22style%22%3A%20%7B%22type%22%3A%20%22MapBasicCompositeStyle%22%2C%22LineStyle%22%3A%20%7B%22type%22%3A%20%22MapBasicLineStyle%22%2C%22MapBasicPen%22%3A%20%7B%22width%22%3A%202%2C%22pattern%22%3A%2093%2C%22color%22%3A%20%222277103%22%2C%22unit%22%3A%20%22PIXEL%22%7D%7D%7D%7D%5D%7D%7D%5D%7D'
            \

JSON Body 

{
  "styleDetails": [
    {
      "themeList": {
        "theme": [
          {
            "type": "OverrideTheme",
            "style": {
              "type": "MapBasicCompositeStyle",
              "LineStyle": {
                "type": "MapBasicLineStyle",
                "MapBasicPen": {
                  "width": 2,
                  "pattern": 93,
                  "color": "2277103",
                  "unit": "PIXEL"
                }
              }
            }
          }
        ]
      }
    }
  ]
}

Response

Intersecting blue-and-white striped lines.

Polygon Layer

Request (GET)

For this example, crs:84 is used in the request URL, which has the co-ordinate order as lon-lat in the bbox.

curl --location
            'https://api.cloud.precisely.com/v1/spatial/wms?VERSION=1.3.0&SERVICE=WMS&REQUEST=GetMap&CRS
            curl --location
            'https://api-dev.cloud.precisely.services/v1/spatial/wms?SERVICE=WMS&VERSION=1.3.0&REQUEST=GetMap&BBOX=37.78662956646336823%2C-122.2745967175037549%2C37.81410536165775227%2C-122.2403683391127061&CRS=EPSG%3A4326&WIDTH=1062&HEIGHT=853&LAYERS=parcels&STYLES=&FORMAT=image%2Fpng&DPI=96&MAP_RESOLUTION=96&FORMAT_OPTIONS=dpi%3A96&TRANSPARENT=TRUE&SLD_BODY=%7B%22styleDetails%22%3A%20%5B%7B%22themeList%22%3A%20%7B%22theme%22%3A%20%5B%7B%22type%22%3A%20%22OverrideTheme%22%2C%22style%22%3A%20%7B%22type%22%3A%20%22MapBasicCompositeStyle%22%2C%22AreaStyle%22%3A%20%7B%22type%22%3A%20%22MapBasicAreaStyle%22%2C%22MapBasicPen%22%3A%20%7B%22width%22%3A%2010%2C%22pattern%22%3A%2010%2C%22color%22%3A%20%229109504%22%2C%22unit%22%3A%20%22PIXEL%22%7D%2C%22MapBasicBrush%22%3A%20%7B%22pattern%22%3A%20%222%22%2C%22foregroundColor%22%3A%20%2212639424%22%2C%22backgroundColor%22%3A%209109504%7D%7D%7D%7D%5D%7D%7D%5D%7D
            '\

JSON Body 

{
  "styleDetails": [
    {
      "themeList": {
        "theme": [
          {
            "type": "OverrideTheme",
            "style": {
              "type": "MapBasicCompositeStyle",
              "AreaStyle": {
                "type": "MapBasicAreaStyle",
                "MapBasicPen": {
                  "width": 10,
                  "pattern": 10,
                  "color": "9109504",
                  "unit": "PIXEL"
                },
                "MapBasicBrush": {
                  "pattern": "2",
                  "foregroundColor": "12639424",
                  "backgroundColor": 9109504
                }
              }
            }
          }
        ]
      }
    }
  ]
}

Response

Stylized vector map with thick black streets around a large bay and curving roadways.