Satellite Tiles


This endpoint will return Digital Globe satellite imagery.

Request

Format

get
URL request example
<http|https>://<baseURL>/map/<versionNumber>/tile/satellite/main​/<z>/<x>/<y>.<ext>?key=<apiKey>

Communication through both HTTP and HTTPS is supported.

Parameters

The table below describes all of the parameters that can be used in a request. Required parameters _ must_ be used or the call will fail. Optional parameters, which are highlighted with [square brackets], may be used. If there is a default value that will be assumed when an optional parameter is not used, it is shown in the table. The order of request parameters is not important.

ParameterDescriptionReq'd?Type / ValuesDefault valueMax value
baseURLBase URL for calling the API.Yesapi.tomtom.com
versionNumberService version number. The current value is 1a.Yes1a
apiKeyYour TomTom API Key.YesString
z

Zoom value. Valid values are between 0 and 20, with 0 being the most zoomed out.

YesInteger20
x

Horizontal - or "Easting" - value. Relative to the top left point.

YesInteger
yVertical - or "Northing" - value. Relative to the top left point.YesInteger
extValid response formats are JPG and PNG.YesString

Response

Format

The response will be an raster image (256x256) in the format specified in the request.