[ Whereis® API Home ] [ JSON API Home ] [ Services ] [ Utilities ]
Use service description to check the API's current parameterisation of map tiles, particularly in relation to layers and zoom levels. Returns metadata in relation to our map offering, via HTTP GET.
URL
HTTP Get to <ENDPOINT>service/description
Response
Parameter | Description |
| tileVersion | The version of the tiles |
| tileHeight | The height of a map tile |
| tileWidth | The width of a map tile |
| projection | The EPSG code for the map projection supported by the EMS API |
availableLayers | Currently "STREET", "HYBRID" and "PHOTO" layers are available. To use the "tileUrl", replace <type> with one of the tileOptions values, <x> and <y> with a position of the tile in our tile grid, and <z> with the tile z-index from the zoom levels array. |
zoomLevels | Lists the zoom levels, their corresponding resolutions (degrees per pixel), and an approximate scales in metres oper pixel |
Sample response
{
"tileVersion": "1.0.6",
"tileHeight": "256 px",
"tileWidth": "256 px",
"projection": "EPSG:4326",
"availableLayers": [
{
"name": "hybrid",
"lastModified": "2012-04-30 16:45:27",
"tileUrl": "http://tiles-ems-dev.ext.sensis.com.au/remapper/tile/hybrid?x=<x>&y=<y>&z=<z>",
"externalTileUrl": "http://tiles-ems-dev.ext.sensis.com.au/remapper/tile/hybrid?x=<x>&y=<y>&z=<z>"
},
{
"name": "street",
"lastModified": "2012-04-30 16:45:27",
"tileUrl": "http://tiles-ems-dev.ext.sensis.com.au/remapper/tile/street?x=<x>&y=<y>&z=<z>",
"externalTileUrl": "http://tiles-ems-dev.ext.sensis.com.au/remapper/tile/street?x=<x>&y=<y>&z=<z>"
},
{
"name": "photo",
"lastModified": "2012-04-30 16:45:27",
"tileUrl": "http://tiles-ems-dev.ext.sensis.com.au/remapper/tile/photo?x=<x>&y=<y>&z=<z>",
"externalTileUrl": "http://tiles-ems-dev.ext.sensis.com.au/remapper/tile/photo?x=<x>&y=<y>&z=<z>"
}
],
"zoomLevels": [
{
"zoom": 0,
"resolution": 39135.7584765625,
"scale": "32080.534175601562 m/pixel"
},
{
"zoom": 1,
"resolution": 19567.87923828125,
"scale": "16697.233754796875 m/pixel"
},
{
"zoom": 2,
"resolution": 9783.939619140625,
"scale": "8430.73328634375 m/pixel"
},
{
"zoom": 3,
"resolution": 4891.9698095703125,
"scale": "4225.579671308594 m/pixel"
},
{
"zoom": 4,
"resolution": 2445.9849047851562,
"scale": "2114.0643437421877 m/pixel"
},
{
"zoom": 5,
"resolution": 1222.9924523925781,
"scale": "1057.1914148828125 m/pixel"
},
{
"zoom": 6,
"resolution": 611.4962261962891,
"scale": "528.6156105820312 m/pixel"
},
{
"zoom": 7,
"resolution": 305.74811309814453,
"scale": "264.31029311328126 m/pixel"
},
{
"zoom": 8,
"resolution": 152.87405654907226,
"scale": "132.15545753125 m/pixel"
},
{
"zoom": 9,
"resolution": 76.43702827453613,
"scale": "66.07776763671875 m/pixel"
},
{
"zoom": 10,
"resolution": 38.218514137268066,
"scale": "33.0388886796875 m/pixel"
},
{
"zoom": 11,
"resolution": 19.109257068634033,
"scale": "16.5194449453125 m/pixel"
},
{
"zoom": 12,
"resolution": 9.554628534317017,
"scale": "8.25972255859375 m/pixel"
},
{
"zoom": 13,
"resolution": 4.777314267158508,
"scale": "4.129861296875 m/pixel"
},
{
"zoom": 14,
"resolution": 2.388657133579254,
"scale": "2.06493061328125 m/pixel"
},
{
"zoom": 15,
"resolution": 1.194328566789627,
"scale": "1.03246533984375 m/pixel"
},
{
"zoom": 16,
"resolution": 0.5971642833948135,
"scale": "0.51623276953125 m/pixel"
}
]
}
NOTES