Platform Data Extension API Developer's Guide

Tiles

Returns a set of data tiles with map data content in JSON (/tiles.json) or plain text (/tiles.txt) format. Applications should look up the maximum supported number of tiles per request through the resource serviceconfiguration.json / serviceconfiguration.txt.

Resource URI

/tiles

Resource Parameters

Parameter Type Description
app_id String

Typically, but not guaranteed to be, 20 bytes Base64 URL-safe encoded string used for the authentication of the client application. See Acquiring Credentials.

app_code String

Typically, but not guaranteed to be, 20 bytes Base64 URL-safe encoded string used for the authentication of the client application. See Acquiring Credentials.

callback String

Specifies the name of a user-defined function used to wrap the JSON response.

layer or layers String Thematic Layer(s). Either specify the layer that applies for all requested tiles, or specify the layers per requested tile, as a comma separated list. Either the parameter layer or the parameter layers is required.
level or levels String Specifies the size of the requested tiles: N x N degree in WGS84, where N = 180 / 2level. Either specify the level that applies for all requested tiles, or specify the levels per requested tile, as a comma separated list. Either the parameter level or the parameter levels is required.
tilexy String Comma separated sequence of tilex,tiley pairs for the requested tiles. The tilex and tiley values are described in the "tile" resource.
meta String Request that the response tile(s) get(s) framed with meta information (layer, level, tilex, tiley, region, release). Currently the parameter value must be 1. In the future, other format variants of meta data might be supported through other meta values. The tile(s) can consist of multiple regions and/or releases. Therefore the response fields are a comma separated list of regions/releases.
region String Optional (default=whole world). Map coverage region, e.g. APAC, AUS, WEU, IND, MEA, NA, SAM, TWN. The region may also contain hints to distinguish specific content. E.g. there can be an WEU and PCBEU, where the 2nd map contains only Postal Code Boundary layers. This parameter is optional. If not specified, Platform Data Extension API will find the region(s) automatically, that cover the tile. The parameter can also contain a comma separated list of regions. If it contains more than one region, Platform Data Extension API will use these regions out of the list that cover the tile. Specifying a region is strongly discouraged, because regions might change and hence applications that specify a region might stop working when the region gets discontinued, renamed, splitted or changed otherwise.
release String Map release quarter, e.g. 2015Q4, 161J0, 16153 or LATEST (= default) for the latest available map release quarter. Specifying a map release is strongly discouraged, because there is no guarantee how long old map releases are available, hence applications that specify a release might stop working when the release gets retired.
cols String Specifies the tile columns to be retained or removed from result. The client can specify a single column filter or exactly as many comma filters as the number of requested tiles. Columns names must be semi-colon separated, syntax is the same as for single tile request. As an example, if two tiles are requested, cols=LAT;LON,-LAT;-LON will retain only LAT and LON in first tile result rows, while removing LAT and LON from second tile result rows. Column filters must be retain only (only column name) or remove only (minus sign before column name) on tile basis but can be different on different tiles. Non existing column names are simply ignored.

You cannot use this account to purchase a commercial plan on Developer Portal, as it is already associated to plans with different payment methods.

To purchase a commercial plan on Developer Portal, please register for or sign in with a different HERE Account.

Something took longer than expected.

The project should be available soon under your projects page.

Sorry, our services are not available in this region.

Something seems to have gone wrong. Please try again later.

We've detected that your account is set to Australian Dollars (AUD).
Unfortunately, we do not offer checkouts in AUD anymore.
You can continue using your current plan as normal, but to subscribe to one of our new plans,
please register for a new HERE account or contact us for billing questions on selfservesupport@here.com.