Nearmap provides access to its vertical imagery via a subset of the Tile Map Service (TMS) protocol. TMS splits a map into a pyramid of 256x256-pixel map tiles at multiple zoom levels. An application typically downloads a collection of adjacent tiles to cover a given region.
Only the Web Mercator projection is supported by Nearmap’s TMS (EPSG:3857; also known as EPSG:3785 and EPSG:900913). Nearmap’s Web Map Service (WMS) is recommended for other projections.
Access to Nearmap imagery is only available to authenticated subscribers. Tiles may be requested from Nearmap servers with an API Key. Please refer to the API Key Authentication guide for details on how to obtain and use an API Key.
TMS URL Request Format
PhotoMaps imagery (called tiles in this documentation) may be requested by URLs in the following formats:
The following parameters may be specified:
|RC||Region code - Examples: au or us. Note: the region code for New Zealand is also au.||yes|
|NUMBER||Domain rotation number. Valid numbers are 0-3.||yes|
|x||X tile coordinate (column)*||yes|
|y||Y tile coordinate (row)*||yes|
|z||Zoom level (highest resolution is typically 21) *||yes|
|nml||Must be set to v||yes|
|nmd||Date, in the format YYYYMMDD - for example, 20151031.|
See Getting a list of surveys by date for a location for instructions on retrieving options for setting this parameter.
|exclude||Must be set to background. Used to exclude tertiary satellite imagery when Nearmap imagery is not available.||no|
|version||Must be set to 2||yes|
|httpauth||Whether the tile server should prompt for HTTP Basic authentication. Set this to false (as we no longer support HTTP Basic authentication).||yes|
|apikey||Your API Key. See API Key Authentication.||yes|
* tile coordinates use the Google XYZ scheme.
A typical URL would be:
Getting a List of Surveys by Date for a Location
|RC||Region code. Either us or au. Note: the region code for New Zealand is also au.||us|
|NUMBER||Domain rotation number. Valid numbers are 0-3.||0|
|ll||Latitude and longitude of the location on which to centre the image in the format LAT,LONG||37.334849,-122.008946|
|z||Image zoom (web mercator zoom). Has to be 18.||18|
|nmq||Must be set to INFO||INFO|
|nmf||Must be set to json||json|
|httpauth||Whether the server should prompt for HTTP Basic authentication. Set this to false (as we no longer support HTTP Basic authentication).||false|
|apikey||Your API Key. See API Key Authentication.||A325BF1343...|
Survey Date Lists in JSON Response
The JSON response contains a set of lists of dates for which vertical imagery is available at the given location. The dates are presented in an array with the label "Vert".
Example for a US Location
The values are timestamps formatted using ASP.NET AJAX date format. The numeric value inside the parenthesis is number of milliseconds since epoch - January 1 1970 UTC.