Tile
Returns a data tile with map data content in JSON (/tile.json) or plain text (/tile.txt) format.
Resource URI
/tile
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 | String | Thematic Layer |
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, Fleet Telematics Advanced Data Sets 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, Fleet Telematics Advanced Data Sets 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. To choose a (nearest to) specific snapshot of the live traffic speed record layer, a UNIX timestamp (number of seconds since 1970) or a date in 2017-12-01T17:30:00+01:00 format can be passed. |
level | Number | Specifies the size of the requested tile: N x N degree in WGS84, where N = 180 / (2level) |
tilex | Number | Specifies the tile number in West-East direction. This depends on the level. The tile covering the longitude LON [WGS84 degree] has tileX = floor((LON + 180.0) / tileSize), where tileSize = 180 / 2level. The tile with a given tileX value covers the longitude range [ tileX * tileSize - 180.0 ... (tileX + 1) * tileSize - 180.0 ]. |
tiley | Number | Specifies the tile number in South-North direction. This depends on the level. The tile covering the latitude LAT [WGS84 degree] has tileY = floor((LAT + 90.0) / tileSize), where tileSize = 180 / (2level). The tile with a given tileY value covers the latitude range [ tileY * tileSize - 90.0 ... (tileY + 1) * tileSize - 90.0 [. |
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. |
link2stabletopologyid | Number | Optional. Pass 1 to get the OLP stable topology ID + link's offsets in addition to each link ID. |
cols | String | Specifies the tile columns to be retained or removed from result. To have only certain columns in the resulting tile, value can be specified as semi-colon-separated column names. As an example, the parameter value cols=LAT;LON will make the resulting tile include only LAT and LON columns. Columns can be removed from results using the syntax cols=-LAT;-LON. This will make the resulting tile exclude LAT and LON columns. If cols parameter is specified, all columns must be retaining (only column name) or removed (minus sign before column name). Non existing column names are simply ignored in both cases. |