Map Tile

The /maptile GET request retrieves a map tile image for a given location and zoom level.

(Note: Requires a license for access to Trimble MAPS JavaScript.)

Request Parameters

ParameterDescriptionData TypeNote
XThe tile's horizontal coordinate.integer
YThe tile's vertical coordinate.integer
ZThe zoom level.integer
FormatOptional parameter to specify the image format.stringFormats are:
image/png
image/jpeg
DatasetFor users licensed for multiple regional datasets this allows you to target data from different regions or access the WorldWide data.Current (default), PCM_EU, PCM_OC, PCM_SA, PCM_AF, PCM_AS, PCM_ME, PCM_GT, PCM_WW and PCM_NA.
drawerGroupsA comma-separated list of groups of layers to draw on the map, or a bitwise OR of the numeric values.Possible Values:
1 - Cities
2 - Labels (includes road labels and shields)
4 - Roads (includes roads and railroads)
8 - Commercial (includes truck restrictions and hazmat)
16 - Borders (includes state and county boundaries)
128 - Areas (includes parks, military bases, airports, and urban areas)
Default is none.
StyleThe style of map imageDefault, Classic, Monochrome, RoadAtlas, Darkness, Modern, Contemporary, Night, Satellite, Lightness, Smooth and TerrainSee special notes below about Satellite style with ImgSrc.
ImgSrcOptional background image provider. Currently only supports Satellite style and will be ignored for all others.ALKCurated
Default(DigitalGlobeAPIImagery)
Sat1
Sat2(DigitalGlobeConsumer)
Sat3(DigitalGlobeTrueCurrency)
Sat4(DigitalGlobeColorConsumer)
Sat5(DigitalGlobeAPIVivid)
Sat6(DigitalGlobeAPIRecent)
Sat1 is a Premium Satellite option that provides curated Satellite images and tiles to users. If no curated data is available, Default(DigitalGlobeAPIImagery) option will be used.
ALKCurated is a new Satellite option available to Standard users. However, certain curated data is excluded and Default(DigitalGlobeAPIImagery) option will be used instead.
Values other than Default or ALKCurated will require a Premium addon for that style.

Response

Data ElementDescriptionValue/ExampleNote
RegionA string representing the region for which the list of states or countries to be retrieved. NA (North America) is default.NA(Default), AF(Africa), AS(Asia), EU(Europe), OC(Oceania), SA(South America), ME(Middle East)
StyleThe style of map tileDefault, Classic, Monochrome, RoadAtlas, Darkness, Modern, Contemporary, Night, Satellite, Lightness, Smooth and Terrain
ImgSrcOptional background image provider. Currently only supports Satellite style and will be ignored for all others.ALKCurated
Default(DigitalGlobeAPIImagery)
Sat1
Sat2(DigitalGlobeConsumer)
Sat3(DigitalGlobeTrueCurrency)
Sat4(DigitalGlobeColorConsumer)
Sat5(DigitalGlobeAPIVivid)
Sat6(DigitalGlobeAPIRecent)
Sat1 is a Premium Satellite option that provides curated Satellite images and tiles to users. If no curated data is available, Default(DigitalGlobeAPIImagery) option will be used.
ALKCurated is a new Satellite option available to Standard users. However, certain curated data is excluded and Default(DigitalGlobeAPIImagery) option will be used instead.
Values other than Default or ALKCurated will require a Premium addon for that style.