Customising the URLs

This page will give you an overview of how to customise our APIs. Below are some ways customisation can be done along with examples how to put them together:

Latest Imagery URLs for WMTS

Australia Latest

Our Australia latest layer is a very clever, virtual compilation dataset based on time currency. It is built to maximise performance whilst drawing on data nationally from different sites across many different zoom levels – or scales. It is available with both our WMS and WMTS, the example provided below are for the WMTS:

https://api.metromap.com.au/ogc/key/{API-KEY}/SERVICE=WMTS&REQUEST=GetTile&LAYER=Australia_latest&FORMAT={format}&TileMatrixSet={tilematrixset}&TileMatrix={Z}&TileRow={row}&TileCol={col}

Example:

https://api.metromap.com.au/ogc/key/abcb1234-56e8-0910-f112-gg13h140ijk1=/SERVICE=WMTS&REQUEST=GetTile&LAYER=Australia_latest&FORMAT=image/png&TileMatrixSet=webmercator&TileMatrix={Z}&TileRow={Y}&TileCol={X}

https://api.metromap.com.au/metromapkey/wmts?key={api-key}&REQUEST=GetTile&SERVICE=WMTS&LAYER=Australia_latest&FORMAT=image/jpgpng&TileMatrixSet=GoogleMapsCompatibleExt:epsg:3857&TileMatrix={z}&TileRow={y}&TileCol={x}

Australian Capital Cities Latest

A more focused layer we have is the Australian Capital Cities Latest layer. Below is an example URL that replaces the general Australia Latest layer with the Australia Capital Cities Latest.

https://api.metromap.com.au/ogc/key/{API-KEY}/SERVICE=WMTS&REQUEST=GetTile&LAYER=Australian_capital_cities_latest&FORMAT={format}&TileMatrixSet={tilematrixset}&TileMatrix={Z}&TileRow={row}&TileCol={col}

Example:

https://api.metromap.com.au/ogc/key/abcb1234-56e8-0910-f112-gg13h140ijk1=/SERVICE=WMTS&REQUEST=GetTile&LAYER=Australian_capital_cities_latest&FORMAT=image/png&TileMatrixSet=webmercator&TileMatrix={Z}&TileRow={Y}&TileCol={X}

https://api.metromap.com.au/metromapkey/wmts?key=abcb1234-56e8-0910-f112-gg13h140ijk1=&REQUEST=GetTile&SERVICE=WMTS&LAYER=Australian_capital_cities_latest&FORMAT=image/jpgpng&TileMatrixSet=GoogleMapsCompatibleExt:epsg:3857&TileMatrix={z}&TileRow={y}&TileCol={x}

GetMap URL WMS

You can manually specify a bounding box, file format, and projection with the following URL

https://api.metromap.com.au/ogc/key/{API-KEY}/service?LAYERS={LAYER}&FORMAT=image/{image format}&SRS=EPSG:{EPSG CODE}&TRANSPARENT=TRUE&SERVICE=WMS&VERSION={version}&REQUEST=GetMap&STYLES=&BBOX={Bounding Box}&WIDTH={Width}&HEIGHT={Height}

Examples:

• Spherical Web Mercator (EPSG 3857)

https://api.metromap.com.au/ogc/key/API-KEY/service?SERVICE=WMS&VERSION=1.3.0&REQUEST=GetMap&BBOX=15985673.39343661442,-4512128.675878273323,15990980.91066532023,-4508049.848888013512&CRS=EPSG:3857&WIDTH=2000&HEIGHT=1537&LAYERS=Australia_latest&STYLES=&FORMAT=image/png&&TRANSPARENT=TRUE

• WGS84 (EPSG 4326)

https://api.metromap.com.au/ogc/key/API-KEY/service?SERVICE=WMS&VERSION=1.3.0&REQUEST=GetMap&BBOX=15985673.39343661442,-4512128.675878273323,15990980.91066532023,-4508049.848888013512&CRS=EPSG:4326&WIDTH=2000&HEIGHT=1537&LAYERS=Australia_latest&STYLES=&FORMAT=image/png&&TRANSPARENT=TRUE

Specify a row, column, and zoom

https://api.metromap.com.au/ogc/key/{API-KEY}/service?SERVICE=WMTS&REQUEST=GetTile&VERSION=1.0.0&LAYER={LAYER}&STYLE=default&FORMAT=image/png&TILEMATRIXSET=webmercator&TILEMATRIX={z}&TILEROW={Y}&TILECOL={X}

An example custom URL that load a tile in Sydney:

https://api.metromap.com.au/ogc/key/abcb7243-79d2-4411-a512-ee80c523adf6/service?SERVICE=WMTS&REQUEST=GetTile&VERSION=1.0.0&LAYER=Sydney_2018_2_GM_JPEG&STYLE=default&FORMAT=image/png&TILEMATRIXSET=webmercator&TILEMATRIX=14&TILEROW=9836&TILECOL=15068

Filtering by State for WMS/WMTS

This feature allows users to specify a particular Australian state or territory and retrieve a list of layers associated with it.

When using the LATEST abbreviation, the capabilities result will only include ["Australia_latest", "Australian_capital_cities_latest"]

Examples:

IMPORTANT NOTE: Replace {YOUR_API_KEY} with your API key and {STATE} with an Accepted State Abbreviation as shown in the table above.

• WMS

https://api.metromap.com.au/ogc/key/{YOUR_API_KEY}/state:{STATE}/service?REQUEST=GetCapabilities

• WMTS with GDA94 service

https://api.metromap.com.au/ogc/key/{YOUR_API_KEY}/state:{STATE}/service?REQUEST=GetCapabilities&SERVICE=WMTS

• WMTS with GDA2020 service

https://api.metromap.com.au/ogc/gda2020/key/{YOUR_API_KEY}/state:{STATE}/service?REQUEST=GetCapabilities&SERVICE=WMTS