Fleet Telematics Custom Locations Developer's Guide

Route Isoline Search

Search for geometries reachable within a limited time/distance detour along a route.

The number of geometries in the response should not exceed 1000. Exceeding one of the limits results in an error response. If an application needs more results returned then please contact technical customer support to work on a solution to reduce this.

Resource URI

GET /search/routeisoline.json

Resource Parameters

Parameters Required? Description
apiKey Yes

xs:string

A 43-byte Base64 URL-safe encoded string used for the authentication of the client application. As a logged in user, you can generate it at https://developer.here.com/projects. API Keys never expire but you can invalidate your API Keys at any time. You cannot have more than two API Keys for one app at the same time.

You must include an API Key with every request. For further details, see Acquiring Credentials.

app_id Yes A URL-safe encoded string obtained during the application registration. If you use the app ID/app code option as an authentication method, for further details see Acquiring Credentials.
app_code Yes A URL-safe encoded string obtained during the application registration. If you use the app ID/app code option as an authentication method, for further details see Acquiring Credentials.
waypoint0 ... waypointN Yes Comma separated waypoint latitude, longitude in WGS-84 degree. A route must consist of at least 2 waypoints (start and destination).
layer_ids Yes Comma separated list of layer IDs to be searched. Layer names are not case sensitive. Both custom layers and PDE map layers are supported. PDE layers divided by functional class, like ROAD_GEOM_FC1 ... FC5 can be selected by N, e.g. ROAD_GEOM_FCN. Layers must have a LINK_ID column. If a customer doesn't have a LINK_ID column, customers can create it using the Geocoder, Reverse Geocoder or RME. The maximum length of a layer name and the permitted characters can be lookup up in the service via /serviceconfiguration.json
attributes No List of comma separated column names to specify which attributes shall appear in the result. Column names are not case sensitive. Default = all.
geom No local, full or none. Specifies the geometry representation in the result. Default = local. Local geometry is used for map display purposes, returning geometry pieces that cover the given search radius, bounding box or corridor polygon. Full geometry is used for interactive editing, where the original geometry is required. None is used for applications like geofencing, which most of the time want to know only the ids of the geofence points/lines polygons they are in or near.
max_detour_distance Either max_detour_distance or max_detour_time Maximum travel distance in meter away from the route to reach the map object. This is one way, from the junction that leaves the route until to the map object. The distance to get back onto the route is not considered here.
max_detour_time Either max_detour_time or max_detour_distance Maximum travel time in seconds away from the route to reach the map object. This is one way, from the junction that leaves the route until to the map object. The distance to get back onto the route is not considered here.
departure No Format: now, yyyy-MM-dd'T'HH:mm:ss or yyyy-MM-dd'T'HH:mm:ssX. Default: Avoid all time dependent access restrictions. If no timezone is specified, then the local timezone at the route start link is used.
mode Yes Specifies whether shortest or fastest route shall be computed, for which vehicle type (car, truck,...) and whether traffic information shall be used. Example fastest;car;traffic:disabled See HLP Router for details.
trailerType, trailersCount, vehicleNumberAxles, trailerNumberAxles, hybrid, emissionType, height, trailerHeight, vehicleWeight, limitedWeight, disabledEquipped, minimalPollution, hov, passengersCount, tiresCount, commercial, shippedHazardousGoods, heightAbove1stAxle No Parameters to specify the vehicle. See HLP Router for details.
callback No Specifies the function used to wrap the JSON response.