Tiles Entrypoint
The tiles feature allows you to request place recommendations for areas of the map that are displayed to the user by requesting place tiles covering individual map tiles, in the same way that visual map data can be be requested a tile at a time. As the user moves the map, you request place tiles covering newly displayed areas. Place tiles requests are more cacheable than requests to the explore endpoint, resulting in better response times and the user experience in applications that allow map panning, and enabling us to serve them through a CDN, which can improve load times for all users. A place tile looks like a normal explore result only that the area is defined by a map tile.
The Tiles Entrypoint retrieves a list of base URLs which encode the criteria specified in the request, and which can be used to construct URLs for individual place tiles. A list of base URLs is provided so that you can overcome typical web browser restrictions that limit the number of parallel requests to a single domain, e.g. by random or round-robin selection of a base URL when requesting individual tiles.
To request an actual tile, the tile address (zoom, column and row) has to be appended to the base URL. Zoom, column and row parameters follow the tile addressing schema of the HERE Map Tile API.
The Tiles Entrypoint is a Places (Search) API Deprecated entrypoint.
This is a premium feature. Contact your HERE representative or contact us through developer.here.com to request the appropriate license if this feature is not already covered by your agreement.
Entrypoint URI
/tiles
Entrypoint Parameters
Parameter | Type | Description |
---|---|---|
cat | Comma-separated list; optional | A comma-separated list of category ids defining an OR-filter that all places reachable through the resource must match. For a list of supported categories, see the Categories documentation. Resources without an explicit category set will use the following default set of categories:
|
cs | Comma-separated list; optional | A comma-separated ordered list of category systems defining which type of category systems should be returned in the response. Valid category systems are 'places', 'cuisines', and 'pds'. For example cs=places,cuisines |
GET Method
The GET method provides access to a list of base URLs for the given criteria.
Representation Modifiers
The following options are available in this context:
Parameter | Type | Description |
---|---|---|
size | Number (non-negative integer); optional | The maximum number of result items in each collection. |
tf | String; optional; default: html. | Text format. Determines how rich text properties such as location.address.text should be rendered. Note: plain text can still be multiline. In this case newline symbol ("\n" ) is used to separate lines. Supported values are:
|
show_refs | Comma-separated list; optional | A list of one or more external system names or reference types. This parameter exposes place related external references in response. For a full description see Representation Modifiers documentation. |
For additional information and examples, see Changing Responses with Representation Modifiers.
Response Media Type
Responses to requests to this endpoint will have the urn:nlp-types:tile-links
media type. See the urn:nlp-types:tile-links
media type documentation for details about the structure and content of the response.
Request Example
https://places.sit.ls.hereapi.com/places/v1/tiles?app_id={YOUR_APP_ID}
&app_code={YOUR_APP_CODE}
&pretty
Response Example
{
"tiles": [
"http://.../places/v1/tiles/c2l6ZT0yMCZsYW5ndWFnZXM9ZW4tVVMlMkNlbiUyQ2RlJTJDcnUlMkN1ayZzZXFfbnVtYmVyPTEmY3JlYXRlZD0xMzk5NjMxNDgzMDUx/",
"http://../places/v1/tiles/c2l6ZT0yMCZsYW5ndWFnZXM9ZW4tVVMlMkNlbiUyQ2RlJTJDcnUlMkN1ayZzZXFfbnVtYmVyPTImY3JlYXRlZD0xMzk5NjMxNDgzMDUx/",
....,
"http://.../places/v1/tiles/c2l6ZT0yMCZsYW5ndWFnZXM9ZW4tVVMlMkNlbiUyQ2RlJTJDcnUlMkN1ayZzZXFfbnVtYmVyPTMmY3JlYXRlZD0xMzk5NjMxNDgzMDUx/"
]
}