How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

HERE Isoline API

The Isoline API from HERE — 1 operation(s) for isoline.

HERE Isoline API is one of 139 APIs that HERE publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Isoline. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, and an API reference.

This API exposes 2 operations across 1 path, and defines 64 schemas. It is described by OpenAPI 3.2.0, at version 8.47.1.

Requests are made against a single base URL, https://isoline.router.hereapi.com/v8.

2 operations 1 paths 64 schemas 1 GET1 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.2.0
API Version
8.47.1
Base URL
https://account.api.here.com
Authentication
API Key, HTTP Bearer
Terms of Service
Resource Areas
1

Authentication & Security 2

HERE Isoline API declares 2 security schemes for authenticating requests. An API key is passed in the query as apiKey (ApiKey). It accepts HTTP bearer tokens (JWT) (Bearer). By default, every request must be authenticated.

  • ApiKey — A key generated specifically to authenticate API requests. For more information on how to get an API key, see [Identity and Access Management Developer Guide](…
  • Bearer — A token obtained from a separate endpoint using client credentials and an OAuth 1.0a HMAC-SHA256 signed request. For more information on how to get a bearer to…

Paths & Operations 2

Across 1 path, the API surfaces 2 operations — 1 GET, 1 POST. Each is listed below with its method, path, parameters, and response codes.

Isoline 2
GET
/isolines
Get Isolines for specified ranges around a center point
IsolineRoutingAPIV8CalculateIsolines 22 params → 200400401403500
POST
/isolines
Calculate isolines via POST
IsolineRoutingAPIV8CalculateIsolinesPost 22 params body → 200400401403500

Schemas 64

The contract defines 64 schemas that model the data the API accepts and returns. The most detailed are Truck (29 properties), Vehicle (29 properties), Avoid (7 properties), ServerInternal (6 properties). Each schema is shown below with its type and property counts.

PolygonArea
object
A polygon defined as a list of coordinates. The polygon is automatically closed, so repeating the first vertex is not required. Self-intersecting polygons are…
2 properties 2 required
TunnelCategory
string
Specifies the tunnel category used to restrict the transport of specific goods.
AreasPost
array
List of user-defined areas that routes should avoid/exclude going through. Notes: Maximum count of avoided and excluded polygons and corridors is 20. Maximum t…
BaseEVEmpiricalModel
object
Specifies parameters required for calculation of energy consumption for electric vehicles using Empirical model.
5 properties 1 required
MaxSpeedOnSegment
string
A comma separated list of segments with restrictions on maximum baseSpeed. Each entry has the following structure: {segmentId}({direction})?;speed={maxBaseSpee…
BoundingBoxArea
object
A bounding box defined by two longitudes and two latitudes.
5 properties 5 required
TruckTypeWithDefault
string
Specifies the type of the truck Straight: A truck on a single frame with a permanently attached cargo area. Tractor: A towing vehicle that can pull one or more…
Distance
integer
Distance in meters.
EV
object
EV parameters to be used for calculating consumption and for calculating isolines for EV. There are two consumption models (empirical, physical). Set the consu…
Areas
string
A pipe separated list of user-defined areas that routes should avoid/exclude going through. Notes: Maximum count of avoided and excluded polygons and corridors…
SimpleErrorResponseSchema
object
2 properties
Fuel
object
Fuel parameters to be used for calculating consumption and consumption-based isolines for fuel-based vehicles using empirical consumption model. Attributes: ty…
5 properties 2 required
Area
Area specified by boundingBoxes or polygons (as encoded polyline or as list of geopts ) or corridor area. Notes: Maximum count of avoided and excluded polygons…
Connection
object
Connection represents the geometry of special links that were reached but not included in the components. These links are connections like ferries.
3 properties 3 required
EncodedPolygonAreaWithExceptions
object
A polygon defined as a [Flexible Polyline](https://github.com/heremaps/flexible-polyline) encoded string. Can be expanded to include excepted areas that are ex…
3 properties 2 required
BaseEVPhysicalModel
object
Specifies parameters required for calculation of energy consumption for electric vehicles using physical model.
4 properties 2 required
ResponseRange
object
Range specified in terms of distance, travel time or energy consumption.
3 properties 2 required
Taxi
object
Taxi-specific parameters
1 property
CalculateIsolinesPostParameters
object
Parameters of the POST body for isoline calculation
3 properties
Isoline
object
An isoline for the specified range parameter.
3 properties 2 required
BoundingBoxAreaWithExceptions
object
A bounding box defined by two longitudes and two latitudes. Can be expanded to include excepted areas that are excluded from the current bounding box area.
6 properties 5 required
RouterMode
string
Mode of transport to be used for route calculation.
Shape
object
A struct used to control the shape of the returned isolines.
2 properties
ConsumptionModel
string
Extensible enum: empirical physical ... Specifies which of the EV consumption models is being used. See the ev parameter for details on the models. empirical p…
CorridorAreaWithExceptions
object
A polyline with a specified radius in meters that defines an area. Can be expanded to include excepted areas that are excluded from the current corridor area.
4 properties 3 required
Time
string
RFC 3339, section 5.6 as defined by either date-time or date-only 'T' partial-time (ie no time-offset).
ServerInternal
object
Errors internal to server.
6 properties 6 required
Range
object
Ranges specified in terms of distance, travel time or energy consumption.
2 properties 2 required
MaxSpeedOnSegmentPost
array
Segments with restrictions on maximum baseSpeed. For the general description of the functionality please refer to the maxSpeedOnSegment parameter of the query…
LinearRing
string
A special case of a Polyline where the first and last elements in the coordinates array are equivalent. Encoded as a string in [Flexible Polyline](https://gith…
Waypoint
string
A location defining an origin, destination or via point for a route or an isoline. Format: Place[WaypointOptions] Place: {lat},{lng}[PlaceOptions] PlaceOptions…
Location
object
Location on the Earth
3 properties 2 required
EncodedPolygonArea
object
A polygon defined as a [Flexible Polyline](https://github.com/heremaps/flexible-polyline) encoded string. The polygon is automatically closed, so repeating the…
2 properties 2 required
Isoline403ErrorResponseSchema
EncodedCorridorAreaWithExceptions
object
A polygon defined as a [Flexible Polyline](https://github.com/heremaps/flexible-polyline) encoded string and with a specified radius that defines an area. Can…
4 properties 3 required
BasePlace
object
6 properties 2 required
AvoidPost
object
Avoid routes that violate certain features of road network or that go through user-specified geographical bounding boxes. For the general description of the fu…
2 properties
NoticeSeverity
string
Describes the impact a notice has on the resource to which the notice is attached. critical - The notice must not be ignored, even if the type of notice is not…
IsolineResponse
object
4 properties 1 required
Vehicle
object
Vehicle-specific parameters
29 properties
EncodedCorridorArea
object
A polygon defined as a [Flexible Polyline](https://github.com/heremaps/flexible-polyline) encoded string and with a specified radius that defines an area.
3 properties 3 required
Departure
object
Describe a departure or arrival location and time.
2 properties 1 required
NotAllowed
object
Not Allowed, actions not permitted by server.
6 properties 6 required
IsolineResponseNotice
object
A notice contains important notifications.
4 properties 1 required
Allow
object
Explicitly allow features that require users to opt in.
2 properties
AreaPost
Defines an explicit area to avoid/exclude when calculating the routes. Area specified by boundingBoxes or polygons (as encoded polyline or as list of geopoints…
Traffic
object
Traffic specific parameters.
2 properties
PolygonAreaWithExceptions
object
A polygon defined as a list of coordinates. Self-intersecting polygons are not supported. Can be expanded to include excepted areas that are excluded from the…
3 properties 2 required
CorridorArea
object
A polyline with a specified radius in meters that defines an area.
3 properties 3 required
ConsumptionSpeedTable
string
Function curve specifying consumption rate at a given speed. The format of the string is a comma-separated list of numbers, as follows: , , , ,..., , where spe…
FuelType
string
Extensible enum: diesel petrol lpg cng lng ethanol propane hydrogen ... Vehicle fuel type. It is mandatory for calculation of consumption and CO2 emission.
Avoid
object
7 properties
Polyline
string
Line string in [Flexible Polyline](https://github.com/heremaps/flexible-polyline) format. Coordinates are in the WGS84 coordinate system, including Elevation (…
RoutingMode
string
Specifies which optimization is applied during the calculation. fast: Route calculation from start to destination optimized by travel time. In many cases, the…
Polygon
object
A polygon is described by a boundary outer ring and a possible set of inner rings or holes.
2 properties
Truck
object
Vehicle-specific parameters
29 properties
Exclude
object
Options to exclude strictly during the route calculation.
3 properties
MultiPolygon
array
A set of multiple polygons.
BaseNoticeDetail
object
3 properties 1 required
ExcludePost
object
User-specified properties that need to be strictly excluded during route calculation. For the general description of the functionality please refer to the excl…
1 property
IsolineErrorResponse
object
Response in case of error
6 properties 6 required
Coordinate
object
2 properties 2 required
WeightPerAxleGroup
string
Specifies the weights of different axle groups, such as single and tandem axles. This allows specification of axle weights in a more fine-grained way than weig…
VehicleType
string
Specifies the type of the vehicle StraightTruck: A truck on a single frame with a permanently attached cargo area. Note: default value when truck routing mode…

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

here-isoline-api-openapi.yml Raw ↑

Other APIs HERE publishes across the network.

HERE Geocoding and Search API
HERE Autosuggest API
HERE Tour Planning API
HERE Public Transit API
HERE Destination Weather API
HERE Map Tile API
HERE Map Image API
HERE Tracking API
HERE Positioning API
HERE Parking API
HERE Platform Data API
HERE HD Live Map
Where this information came from

This is an independent, third-party profile of HERE Isoline API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.