Map Tile API Developer's Guide

Raster Coverage Distributed (rcdistonytile)

Description

Returns original coverage for panoramatiles not post-processed to be blended into a single coverage blob.

Format

Requests against this resource must follow the pattern summarized by the following formula:

https://{1-4}.pano.maps.cit.api.here.com
/maptile/2.1/rcdistonlytile/{map id}/{scheme}/{zoom}/{column}/{row}/{size}/{format}
?app_id={YOUR_APP_ID}
&app_code={YOUR_APP_CODE}
&{param}={value}

For information on how to construct the request, see Constructing a Request

Common URI Parameters

The following table lists the URI parameters that are common for all requests.

Table 1. Common URI Parameters
Parameter	Type	Description
col	Integer (required)	`col` – can be any number between 0 and `number of columns - 1`, both inclusive. The number of tiles per column is a function of the zoom: `number of columns = 2^zoom`
format	String (required)	Returned image format. The following image formats are supported: `png` – PNG format, 24 bit, RGB `png8` – PNG format, 8 bit, indexed color `jpg` – JPG format at 90% quality Please note that JPG is recommended for `satellite` and `hybrid` schemes only.
map id	String (required)	Specifies the map version. It can be: `version id` the map version of the requested map tile resource; request the latest version by using `newest` as `map id`. `hash` A unique key, unambiguously representing a specific map version. See Requesting the Right Map Version for more information on map versions.
row	Integer (required)	`row` – can be any number between 0 and number of rows - 1, both inclusive. The number of tiles per row is a function of the `zoom`: `number of rows = 2^zoom` .
scheme	String (required)	Specifies the view scheme. A complete list of the supported schemes may be obtained by using the Info. The following schemes are available: `normal.day` – for a normal map view in daylight mode `normal.day.grey` – for a color-reduced map view in daylight mode (especially used for background maps) `normal.day.transit` – for a color-reduced map view with a public transport scheme in daylight mode `normal.night.transit` – for a color-reduced map view with a public transport scheme in night mode `normal.traffic.day` – for a color-reduced map view designed for displaying traffic in daylight mode `normal.traffic.night` – for a color-reduced map view designed for displaying traffic in night mode `normal.day.custom` – for a normal map view in daylight mode `normal.night` – for a normal map view in night mode `normal.night.grey` – for a color-reduced map view in night mode (especially used for background maps) `pedestrian.day` – pedestrian map view in daylight mode `pedestrian.day.mobile` – pedestrian map view in daylight mode for mobile usage `pedestrian.night` – pedestrian map view in night mode `pedestrian.night.mobile` – pedestrian map view in night mode for mobile usage `carnav.day.grey` – for a normal map view in daylight mode for car navigation `normal.day.mobile` – mobile version of the scheme `normal.day.grey.mobile` – mobile version of the scheme `normal.day.transit.mobile` – mobile version of the scheme `normal.night.transit.mobile` – mobile version of the scheme `normal.night.mobile` – mobile version of the scheme `normal.night.grey.mobile` – mobile version of the scheme `reduced.day` – for a reduced map view in daylight mode with few colors `reduced.night` – for a reduced map view in night mode with few colors `terrain.day` – for a terrain map view in daylight mode `satellite.day` – for a satellite map view in daylight mode `hybrid.day` – for a satellite map view with streets in daylight mode `hybrid.day.transit` – for a satellite map view with public transport scheme in daylight mode `hybrid.grey.day` – for a satellite map view with streets in daylight mode with few colors `hybrid.traffic.day` – for a satellite map view with streets designed for traffic `terrain.day.mobile` – mobile version of the scheme `hybrid.day.mobile` – mobile version of the scheme Note: Please be aware that invalid combinations of schemes and Tiles are rejected. For all `satellite`, `hybrid` and `terrain` schemes, the Aerial Tiles base URL must be used instead of the normal one. For the `hybrid.traffic.day` scheme, the Traffic Tiles base URL must be used instead of the normal one. The other traffic related schemes (`normal.traffic.day`, `normal.traffic.night`) are supported by Traffic Tiles and Map Tiles. Originally they are supposed to be used only with Traffic Tiles, but in order to properly support the traffic overlay case where you would request a transparent traffic tile from Traffic Tiles and a base tile from Map Tiles, the Map Tiles also support these schemes.
size	Integer (required)	Returned image size. The following sizes ([width, height]) are supported: `256` = [256, 256] `512` = [512, 512] The following sizes ([width, height]) are deprecated, although usage is still accepted: `128` = [128, 128] Note: Raster coverage tiles (`rctile`, `rconlytile` and `rcdistonlytile`) only support 256 sizes.
zoom	Integer (required)	Zoom level of the map image. Minimum and maximum zoom levels are specified in the Info.

Mandatory Query Parameters

The following table lists the mandatory parameters that need to be specified with every request. Not specifying these parameters will make the system reject the request.

Table 2. Mandatory Query Parameters
Parameter	Type	Description
app_id	String	A URL-safe encoded string obtained during the application registration. See Acquiring Credentials for information on getting credentials.
app_code	String	A URL-safe encoded string obtained during the application registration. See Acquiring Credentials for information on getting credentials. Note: Usage of `token` is accepted although is deprecated

Optional Query Parameters

Table 3. Optional Query parameters
Parameter	Type	Description
range	String	Only relevant if `output=base64` is also specified as a parameter `range` must be one of `2x2`, `3x3` or `4x4`, which indicates the size of the array of tiles returned. The tile specified by `col` and `row` is the top left of the array, and must divide by the array size.