Page tree

Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

These examples use a demo API key. Replace this API key with your own when using the Tile API.

Example URL request for Australian content:Australia

Code Block
themeEclipse
https://api.nearmap.com/tiles/v3/Vert/21/1855981/1265938.jpg?apikey=Yzc2MjEzMWUtY2Q4YS00NTM2LTgyMDgtMDljZjI2YTdhMTMz

Example The following example shows a URL request for US contentthat specifies the dates for which to retrieve the imagery using the until optional parameter:

Code Block
themeEclipse
https://api.nearmap.com/tiles/v3/Vert/1921/1197991855981/2158451265938.jpg?apikey=ZGE4MTdmNWYtZTdiNS00ZDRkLTg3MzItYjYwMzAyMzM5MjI0

The following example shows a URL request that specifies the dates for which to retrieve the imagery using the until optional parameter:

...

Yzc2MjEzMWUtY2Q4YS00NTM2LTgyMDgtMDljZjI2YTdhMTMz&until=2018-08-01


US

Code Block
themeEclipse
https://api.nearmap.com/tiles/v3/Vert/2119/1855981119799/1265938215845.jpg?apikey=Yzc2MjEzMWUtY2Q4YS00NTM2LTgyMDgtMDljZjI2YTdhMTMz&until=2018-08-01ZGE4MTdmNWYtZTdiNS00ZDRkLTg3MzItYjYwMzAyMzM5MjI0


Responses

The possible HTTP response status codes to the URL request are:

...

RequiredNameAPI / queryTypeDescription

surveyidAPIstring

The survey ID in the format of UUID. Only tiles of the specified survey will be returned. You can use the ID from the survey object returned by the Coverage API.

contentTypeAPIstring

The content type for the requested tiles. The available values are:

  • Vert - for vertical imagery
  • North - for North panorama imagery
  • South - for South panorama imagery
  • East - for East panorama imagery
  • West - for West panorama imagery

Note: the tileResourceType values are case sensitive.

zAPIintegerThe zoom level. The highest resolution is typically 21. Uses the Google Maps Tile Coordinates.

xAPIintegerThe X tile coordinate (column). Uses the Google Maps Tile Coordinates.

yAPIintegerThe Y tile coordinate (row). Uses the Google Maps Tile Coordinates.

formatAPIstring

The format of the tile output. The available values are:

    • jpg - always JPEG
    • png - always PNG
    • img - JPEG by default, PNG when the tile is partial

Note that imagery is stored on Nearmap's servers as JPEG, so switching to PNG does not result in improvement in quality, however it will increase the size of the response.

apikeyquerystringYour API key. See API Key Authentication for more information.

Examples

Example URL request for Australian content:Australia

Code Block
themeEclipse
https://api.nearmap.com/tiles/v3/surveys/100-4c51ffe8-ab52-11e8-9b7a-b3f8ca0bcb81/Vert/16/57999/39561.jpg?apikey=Yzc2MjEzMWUtY2Q4YS00NTM2LTgyMDgtMDljZjI2YTdhMTMz


Example URL request for US content:US

Code Block
themeEclipse
https://api.nearmap.com/tiles/v3/surveys/88f1c072-0bdd-11ea-b266-130e886a3ec4/Vert/19/119799/215845.jpg?apikey=ZGE4MTdmNWYtZTdiNS00ZDRkLTg3MzItYjYwMzAyMzM5MjI0

...