@basemaps/config

@basemaps/config

Basemaps Configuration

To effectively serve tiles to users, all rendering processes must be kept in synch with the exact same configuration.

Basemaps stores its configuration into a single DynamoDB table and separates the configuration objects into

• Imagery - Configuration for a single imagery layer, including location of all the Cloud optimized geotiffs, bounding boxes
• Tile Sets - Configuration on how to merge imagery/vector layers together to serve out as a combined layer
• Style - Vector tile style configuration (Style.json)
• Provider - Configuration about the owner of the service

This configuration is generally stored as JSON files in a git repository (eg linz/basemaps-config ) to allow easy modification and then programmatically loaded into Basemaps DynamoDB table

For LINZ's implementation of this configuration see linz/basemaps-config

Imagery Example

ConfigImagery

{
  "v": 1,
  "id": "im_01E8121FN71M0PNZ6VB87DW05Z",
  "name": "new_zealand_sentinel_2018-19_10m",
  "projection": 3857,
  "uri": "s3://linz-basemaps/3857/new_zealand_sentinel_2018-19_10m/01E8121FN71M0PNZ6VB87DW05Z",
  "year": 2018,
  "files": [
    {
      "height": 4892,
      "name": "13-8032-5113",
      "width": 4892,
      "x": 19254793.17314903,
      "y": -4980025.266835816
    }
  ]
}

Tile Sets Example

ConfigTileSet

{
  "id": "ts_01H8JF29R6S2NT7QXNC7GK90D4",
  "type": "raster",
  "format": "webp",
  "name": "manawatu-whanganui-sn9158-1991-0.375m",
  "title": "Manawatū-Whanganui 0.375m SN9158 (1991)",
  "layers": [
    {
      "2193": "im_01H8JF29R6S2NT7QXNC7GK90D4",
      "maxZoom": 32,
      "minZoom": 0,
      "name": "manawatu-whanganui-sn9158-1991-0.375m",
      "title": "Manawatū-Whanganui 0.375m SN9158 (1991)"
    }
  ]
}

Tileset Aliases

Tilesets can have multiple aliases, allowing them to be linked by different names:

{
  "type": "raster",
  "id": "ts_auckland-2010-2012-0.5m",
  "title": "Auckland 0.5m Rural Aerial Photos (2010-2012)",
  "name": "auckland-2017-0.075m",
  "aliases": ["auckland-urban-2017-0.075m"]
}

Style Example

ConfigVectorStyle

{
  "id": "st_topographic",
  "name": "topographic",
  "style": {
    "id": "st_topographic",
    "glyphs": "/v1/fonts/{fontstack}/{range}.pbf",
    "layers": [
      {
        "id": "Background",
        "filter": ["all", ["==", "class", "dock"]],
        "layout": {
          "visibility": "visible"
        },
        "minzoom": 0,
        "paint": {
          "background-color": "rgba(184, 220, 242, 1)"
        },
        "type": "background"
      },
      {
        "id": "Landcover-Sand",
        "filter": ["all", ["==", "class", "sand"]],
        "layout": {
          "visibility": "visible"
        },
        "minzoom": 8,
        "paint": {
          "fill-color": "rgba(226, 226, 226, 0.75)"
        },
        "source": "LINZ Basemaps",
        "source-layer": "landcover",
        "type": "fill"
      }
    ]
  }
}

Provider Example

ConfigProvider

{
  "id": "pv_linz",
  "name": "linz",
  "serviceIdentification": {
    "accessConstraints": "Basemap @ CC BY 4.0 Land Information New Zealand",
    "description": "National map tile service provided by Land Information New Zealand",
    "fees": "There are no fees associated with access via the web interface or API.",
    "title": "LINZ Basemaps Service"
  },
  "serviceProvider": {
    "contact": {
      "address": {
        "city": "Wellington",
        "country": "New Zealand",
        "deliveryPoint": "Land Information New Zealand",
        "email": "[e-mail]",
        "postalCode": "6145"
      },
      "individualName": "LINZ Customer Support",
      "phone": "[phone]",
      "position": "Customer Support"
    },
    "name": "Land Information New Zealand",
    "site": "http://www.linz.govt.nz"
  }
}

Changelog

8.11.0 (2025-09-23)

Bug Fixes

• prod smoke test with correct glob (#3522) (a9ae2eb)