Maps v1 · Styles

Download schema

Before calling these endpoints, use a Geoscape Hub application with access to this API product. Authenticate with your Consumer Key in the Authorization header. Maps tile clients can use the key query parameter instead. See Authentication, Error Handling, Rate Limiting, and Attribution for shared integration guidance.

Get map style

GET

https://api.psma.com.au

/v1/maps/stylesheets/{style}.json

Authorization (header)

Authentication: Use your Consumer Key in the Authorization header, or the Maps key query parameter for tile clients.

Retrieve the geoscape-light map style. It contains source URLs and layer styling. Authenticate requests for the style and every referenced tile and font resource. See Quickstart for client authentication and Map Layers for custom styles.

Code
curl --fail-with-body --get \
  "https://api.psma.com.au/v1/maps/stylesheets/geoscape-light.json" \
  -H "Authorization: $GEOSCAPE_API_KEY" \
  -H "Accept: application/json"

Get map style › path Parameters

style

string · enum · required

The name of the stylesheet to be returned

Enum values:

geoscape-light

Default: geoscape-light

Get map style › Responses

Map style JSON, including sources, layers, and font URLs.

version

integer

sources

object

object[]

glyphs

string

GET/v1/maps/stylesheets/{style}.json

curl --fail-with-body --get \
  "https://api.psma.com.au/v1/maps/stylesheets/geoscape-light.json" \
  -H "Authorization: $GEOSCAPE_API_KEY" \
  -H "Accept: application/json"

Example Responses

{
  "version": 8,
  "name": "geoscape-light",
  "sources": {
    "local_government_areas": {
      "type": "vector",
      "tiles": [
        "https://api.psma.com.au/v1/maps/geoscape_v1/local_government_areas/{z}/{x}/{y}.pbf"
      ],
      "minzoom": 0,
      "maxzoom": 12
    },
    "buildings": {
      "type": "vector",
      "tiles": [
        "https://api.psma.com.au/v1/maps/geoscape_v1/buildings/{z}/{x}/{y}.pbf"
      ],
      "minzoom": 0,
      "maxzoom": 15
    },
    "gnaf": {
      "type": "vector",
      "tiles": [
        "https://api.psma.com.au/v1/maps/geoscape_v1/gnaf/{z}/{x}/{y}.pbf"
      ],
      "minzoom": 14,
      "maxzoom": 16
    }
  },
  "glyphs": "https://api.psma.com.au/v1/maps/stylesheets/fonts/{fontstack}/{range}.pbf",
  "layers": [
    {
      "id": "local_government_areas",
      "type": "line",
      "source": "local_government_areas",
      "paint": {
        "line-color": "rgba(26, 26, 26, 1)",
        "line-dasharray": [
          2,
          2,
          6,
          2
        ],
        "line-width": [
          "interpolate",
          [
            "linear"
          ],
          [
            "zoom"
          ],
          3,
          0.1,
          12,
          1.5
        ]
      },
      "source-layer": "local_government_areas",
      "maxzoom": 22,
      "minzoom": 0,
      "layout": {
        "line-join": "miter"
      }
    },
    {
      "id": "buildings",
      "type": "fill",
      "source": "buildings",
      "source-layer": "buildings",
      "paint": {
        "fill-color": "rgba(233, 232, 231, 1)",
        "fill-outline-color": "rgba(185, 181, 177, 1)",
        "fill-opacity": [
          "interpolate",
          [
            "linear"
          ],
          [
            "zoom"
          ],
          15,
          0,
          16,
          1
        ]
      }
    },
    {
      "id": "gnaf",
      "type": "circle",
      "source": "gnaf",
      "source-layer": "gnaf",
      "paint": {
        "circle-color": "rgba(255, 0, 0, 1)",
        "circle-stroke-color": "rgba(0, 0, 0, 1)",
        "circle-radius": 2
      }
    }
  ]
}

json

application/json

Maps v1 · Metadata Maps v1 · Tiles

Geoscape API