# HERE integration > HERE location services REST APIs: geocoding and search, routing, matrix and isoline routing, public transit, traffic, weather, map tiles and images, tour planning, positioning, fuel prices and EV charge points. - Authentication: apiKey ## Tools (127) - **Batch Geocoding and Search: (BETA) Create a new notification**: (BETA) Create a new notification. (BETA) Create a new notification. To configure a notification, the **type** as well as the the **config** property needs to be defined. Each type requires individual properties as listed below. ### `webHook` For the notification of the type `web… - **Batch Geocoding and Search: (BETA) Delete a notification**: (BETA) Delete a notification. (BETA) Delete a notification by its id. - **Batch Geocoding and Search: (BETA) Get all notifications**: (BETA) Get all notifications. (BETA) Get all notifications that the current client has access to. - **Batch Geocoding and Search: (BETA) Get a notification**: (BETA) Get a notification. (BETA) Get a notification by id. - **Batch Geocoding and Search: (BETA) Replace a notification**: (BETA) Replace a notification. (BETA) Replace a notification. To configure a notification, the **type** as well as the the **config** property needs to be defined. Each type requires individual properties as listed below. ### `webHook` For the notification of the type `webHook` … - **Batch Geocoding and Search: (BETA) Test a notification**: (BETA) Test a notification. (BETA) Test a notification with dummy parameters. This allows, to test the endpoint without letting a job run. - **Batch Geocoding and Search: Creates a new job**: Creates a new job. Creates a new job from the supplied input and query parameters. A `201 - CREATED` response returns the job's unique ID, which should be used in future operations on the job. - **Batch Geocoding and Search: Deletes a job**: Deletes a job. Deletes a job. - **Batch Geocoding and Search: Deletes multiple jobs**: Deletes multiple jobs. Deletes all jobs the user is authorized to access, filtered on criteria provided in the query. If **none** of the jobs matches the criteria, a `200 - OK` response is returned with an empty list of job IDs. - **Batch Geocoding and Search: Returns the details of a job**: Returns the details of a job. Fetches the details of the job with the specified ID. - **Batch Geocoding and Search: Returns the details of multiple jobs**: Returns the details of multiple jobs. Fetches the details of all jobs the user is authorized to access - filtered on criteria provided in the query. If **none** of the jobs matches criteria, an empty array is returned in the `200 - OK` response. - **Batch Geocoding and Search: Returns the errors of a job**: Returns the errors of a job. Fetches the errors of the job with the specified ID, given that it has completed with errors, as a downloadable stream of data. If the job does not yet have any errors available, this operation responds with a `404 - NOT FOUND` response. If the job d… - **Batch Geocoding and Search: Returns the results of a job**: Returns the results of a job. Fetches the results of the job with the specified ID, given that it has completed successfully, as a downloadable stream of data. If the job does not (yet) have any results available, this operation responds with a `404 - NOT FOUND` response. - **Batch Geocoding and Search: Starts a job**: Starts a job. Schedules a job for immediate execution and responds with a `200 - OK` if successful. If the job is already running this operation does nothing and will respond with the same `200 - OK` response. If the job was previously halted, this operation will continue execut… - **Batch Geocoding and Search: Stops a job**: Stops a job. This operation will schedule a job to be halted and responds with a `200 - OK` if successful. If the job is **not** currently running, then this operation does nothing but will still return a `200 - OK` response. Once the job has been stopped, you can continue from … - **EV Charge Points: Fetch a single location**: Fetch a single location. Allows fetching a single location given its ID. The set of returned location properties can be controlled via the `fields` parameter. - **EV Charge Points: Fetch metadata by countries**: Fetch metadata by countries.. Fetch metadata by countries, such as a list of e-Mobility Service Providers (eMSPs). If you don't specify any countries, the response includes all available countries. If you don't specify any fields, the response includes only the list of available… - **EV Charge Points: Fetch multiple locations**: Fetch multiple locations. Returns data for the specified location identifiers in the `items` property of the response. If no data is found for a location identifier, it appears in the `missing` property. - **Fuel Prices: Fuel brands**: Fuel brands. Returns all available fuel station brands. Fuel station brand can be used as brands query parameter in Fuel stations search - **Fuel Prices: Fuel stations along the route search**: Fuel stations along the route search. Retrieves fuel stations along the route - **Fuel Prices: Fuel stations search**: Fuel stations search. Retrieves fuel stations within geospatial area - **Fuel Prices: Fuel types**: Fuel types. Returns all available fuel types. Fuel type id can be used as fuelType query parameter in Fuel stations search - **Fuel Prices: Number of fuel stations**: Number of fuel stations. Return number of fuel stations within given geospatial area - **Fuel Prices: One fuel station data**: One fuel station data. Retrieves single fuel station information for given station id - **Fuel Prices: Return multiple fuel stations**: Return multiple fuel stations. Retrieves multiple fuel stations by station ids - **Geocoding and Search: Autocomplete**: Autocomplete. This endpoint completes entered keystrokes to a valid street address or administrative area to speed-up entering address queries. - **Geocoding and Search: Autosuggest**: Autosuggest. This endpoint suggests address or place candidates based on an incomplete or misspelled query, from which the user selects the best query to submit. _NOTE: The response may contain **experimental** elements not documented here. Any undocumented element is **subject … - **Geocoding and Search: Autosuggest (POST)**: Autosuggest. **BETA, RESTRICTED** This endpoint suggests address or place candidates based on an incomplete or misspelled query, from which the user selects the best query to submit. _NOTE: The response may contain **experimental** elements not documented here. Any undocumented … - **Geocoding and Search: Browse**: Browse. This endpoint provides search results for places based on different filters, such as categories or name, ranked by distance from a given search center. The only mandatory elements exposed in the response are ID and position. The other elements shown in the response sampl… - **Geocoding and Search: Browse (POST)**: Browse. **BETA, RESTRICTED** This endpoint provides search results for places based on different filters, such as categories or name, ranked by distance from a given search center. The only mandatory elements exposed in the response are ID and position. The other elements shown … - **Geocoding and Search: Discover**: Discover. This endpoint processes a free-form text query for an address or place, and returns results in order of relevance. - **Geocoding and Search: Discover (POST)**: Discover. **BETA, RESTRICTED** This endpoint processes a free-form text query for an address or place, and returns results in order of relevance. - **Geocoding and Search: Geocode**: Geocode. This endpoint allows you to find the geo-coordinates of a known address, place, locality or administrative area, even if the query is incomplete or partly incorrect. It also returns a complete postal address string and address details. It supports structured, unstructur… - **Geocoding and Search: Lookup By ID**: Lookup By ID. This endpoint looks up a known place using the HERE ID included in the request. - **Geocoding and Search: Multi-Reverse Geocode**: Multi-Reverse Geocode. This endpoint returns addresses/places for a list of geo-coordinates specified in the request. - **Geocoding and Search: Reverse Geocode**: Reverse Geocode. This endpoint returns the nearest address to geo coordinates specified in the request. - **Geocoding and Search: Signals**: Signals. **RESTRICTED** This endpoint receives user interaction data from previous search results to improve future result quality. - **Geofencing: Delete Geometry Layers**: Delete some of my Geometry Layers. To delete complete maps, leave the layerNames field in parameter 'id' empty. - **Geofencing: Get Custom Geofence Attributes**: Simple and fast access to your custom geofence attributes. Simple and fast access to your custom geofence attributes - **Geofencing: Import Geometries**: Import Geometries in a WKT or Shape File. Import polygons, polylines or points in WKT (Wellknown Text) or Shapefile format geometries using an HTTP POST request. A layer can contain only one geometry type - polygons, polylines or points, but not a mix of different types. After t… - **Geofencing: Modify Geometries**: Modify Geometries in Existing Layers. Modify geometries using an HTTP POST request. After receiving the response, there is a delay of several seconds to compile, store and make the modified geometries available in the service. Note: The level (tile grid size) of the layer can on… - **Geofencing: Search Geometries (GET)**: Simple and fast search for geometries on HERE Map Content layers, extensible with custom geometry layers. Simple and fast search for geometries on HERE Map Content layers, extensible with custom geometry layers Note: We recommend using POST requests for large payloads, as GET re… - **Geofencing: Search Geometries (POST)**: Simple and fast search for geometries on HERE Map Content layers, extensible with custom geometry layers. Simple and fast search for geometries on HERE Map Content layers, extensible with custom geometry layers - **GNSS Data: Predicted GNSS navigation models**: Predicted GNSS navigation models. Request predicted GNSS navigation models for GPS, GLONASS, Galileo, or BeiDou satellite systems. This service provides predicted navigation models for a certain amount of upcoming days in a series of LPP messages, each of which covers a specific… - **GNSS Data: Real-time assistance data**: Real-time assistance data. Request real-time A-GNSS data for GPS, GLONASS, Galileo, BeiDou, or QZSS satellite systems. This service provides following GNSS Assistance Data Elements, see [3GPP TS 37.355 specification](https://portal.3gpp.org/desktopmodules/Specifications/Specific… - **Intermodal Routing: Routes**: Routes. Lists intermodal routes. All or a combination of the following services may be utilized by the intermodal algorithm to generate intermodal routes: * Vehicle routing. * Intermodal routing with real-time and timetable departures. * Pedestrian routing with pedestrian connec… - **Isoline Routing: Calculate isolines via POST**: Calculate isolines via POST. Retrieves a list of polylines that captures the approximate reachable area from the specified center point constrained by the provided parameters. At the moment, only select parameters are permitted in the POST payload. In particular, those parameter… - **Isoline Routing: Get Isolines for specified ranges around a center point**: Get Isolines for specified ranges around a center point. Retrieves a list of polylines that captures the approximate reachable area from the specified center point constrained by the provided parameters. - **Map Attributes: Find Tile IDs By Index Value**: Tile IDs containing a given value. Retrieve the IDs of tiles that contain a given (set of) attribute value(s). Does not work for custom layers. - **Map Attributes: Get Attributes Along A Path (GET)**: Map Attributes along a route path.. The path endpoint can be used to enrich a given continuous route path with HERE Map content attributes. Note: We recommend using POST requests for large payloads, as GET requests may be constrained by request-line length limits imposed by load… - **Map Attributes: Get Attributes Along A Path (POST)**: Map Attributes along a route path (POST).. The path endpoint can be used to enrich a given continuous route path with HERE Map content attributes. For POST requests, send the large path parameters (segmentRefs, segments, links or flexiblePolyline) in an application/x-www-form-ur… - **Map Attributes: Get Attributes For Segments (GET)**: Map Attributes for individual segments.. The segments endpoint can be used to enrich multiple unconnected segments with HERE Map content attributes. Note: We recommend using POST requests for large payloads, as GET requests may be constrained by request-line length limits impose… - **Map Attributes: Get Attributes For Segments (POST)**: Map Attributes for individual segments (POST).. The segments endpoint can be used to enrich multiple unconnected segments with HERE Map content attributes. For POST requests, send the segmentRefs parameter in an application/x-www-form-urlencoded request body instead of the query… - **Map Attributes: Get Layer Documentation (HTML)**: Show the layer documentation for a specific layer (public/private) in HTML format. Public layer documentation list the attributes and corresponding official attribute description, for private layers attribute description might be empty.. - **Map Attributes: Get Layer Documentation (JSON)**: Show the layer documentation for a specific layer (public/private) in JSON format. Public layer documentation list the attributes and corresponding official attribute description, for private layers attribute description might be empty.. - **Map Attributes: Get Map Attributes (GET)**: Simple and fast access to the rich HERE Map Content. Simple and fast access to the rich HERE Map Content - **Map Attributes: Get Map Attributes (POST)**: Simple and fast access to the rich HERE Map Content. Simple and fast access to the rich HERE Map Content - **Map Attributes: Get Service Configuration**: Service parameter boundary values. Numeric constants and limits for the service calls. Will never become more strict, but can become more relaxed in future releases. - **Map Attributes: Inline Documentation Landing Page**: Landing page for inline documentation. Landing page for inline documentation in HTML format - **Map Attributes: List Layer Attributes (HTML)**: List the layer attributes across all layers. List the layer attributes across all layers in basic HTML format - **Map Attributes: List Layer Attributes (JSON)**: List the layer attributes across all layers. List the map layer attributes across all layers - **Map Attributes: List Layer Indexes (HTML)**: List available layer indexes. List the available indexes of custom and public layers. - **Map Attributes: List Layer Indexes (JSON)**: List available layer indexes. List the available indexes of custom and public layers. - **Map Attributes: List Layers (HTML)**: List the available map layers (public/private/both) in HTML format. To see only the layers of a given map region, like Postal Code Boundaries or WEU, then specify it as map 'region'. - **Map Attributes: List Layers (JSON)**: List the available map layers (public/private/both) in JSON format. To see only the layers of a given map region, like Postal Code Boundaries or WEU, then specify it as map 'region'. - **Map Attributes: List Maps (HTML)**: List all maps (public/private/both) available to the app in HTML format.. - **Map Attributes: List Maps (JSON)**: List available map (public/private/both) regions/releases available to the app.. - **Map Attributes: Search POIs Reachable From Route**: Retrieve the POIs that are reachable within a certain time or distance from the main route. Retrieve the POIs that are reachable within a certain time or distance from the main route - **Map Image: Retrieve a map image in the requested format**: Retrieve a map image in the requested format. Retrieve a section of the map by specifying its dimensions (width and height). Additionally, you can optionally choose from various parameters to modify the output. - **Map Image: Retrieve a map image with body-supplied geometry**: Retrieve a map image with body-supplied geometry. Retrieve a map image, supplying geometry (overlay or GeoJSON) in the request body instead of query parameters. All other parameters behave identically to the GET operation. - **Map Image: Retrieve an icon in the requested format**: Retrieve an icon in the requested format. Retrieve customizable icons based on style, country, state, and road class - **Map Image: Returns a list of accepted values for specific API parameters**: Returns a list of accepted values for specific API parameters. Provides details on acceptable values for API parameters, such as PPI (Pixels Per Inch), styles, and other relevant parameters. - **Map Image: Returns copyright information**: Returns copyright information. Retrieves both the copyright information and the coordinates of the bounding box to which the text applies. If your products and/or services use map data that is made accessible using this service, you shall provide end-users of your products and/o… - **Map Image: Returns features per style**: Returns features per style. Returns the list of available features per style. You can use these values to request an image with particular features specified as query parameters. Use only the features that are available for a particular style. For more information, see [Customiz… - **Map Image: Returns geopolitical views**: Returns geopolitical views. Provides a catalog of available geopolitical views. These values enable the request of an image featuring a specific country view. For more information on geopolitical views, see [Explore geopolitical views](https://docs.here.com/map-rendering/docs/po… - **Map Image: Returns the available map languages**: Returns the available map languages. Returns the list of available map languages per resource. You can use these values to request an image with labels in a particular language. The values follow ISO 639-1 two-letter language code and, optionally, ISO 15924 four-letter script co… - **Matrix Routing: Get profile definition by its ID**: Get profile definition by its ID.. - **Matrix Routing: List supported predefined profiles**: List supported predefined profiles.. It is guaranteed that with each minor API change profiles are only added to this list, but are never removed or modified. - **Matrix Routing: Result of successfully completed calculation**: Result of successfully completed calculation.. - **Matrix Routing: Status of submitted matrix calculation**: Status of submitted matrix calculation. Returns the status of a submitted asynchronous matrix calculation. Redirects to the matrix result if the calculation is successfully completed. **NOTE:** Please make sure to directly use the `statusUrl` returned by the /v8/matrix call to c… - **Matrix Routing: Submit matrix for calculation**: Submit matrix for calculation. Calculates a routing matrix based on provided `origins` and `destinations`. Response will be provided synchronously (see `200` response) or asynchronously (see `202` response) depending on the `async` query parameter. Travel times will be included … - **Network Positioning: Location query**: Location query. Request WGS-84 compliant geographical coordinates for a location based on 2G/3G/4G cell and/or WLAN measurements. - **Public Transit: Departures**: Departures. Lists public transit departures. Discovers subsequent departures using structured or topological queries. The service accepts two types of queries as shown in the table below: \| Query \| Parameter \| Description \| \|-------\|-----------\|-------------\| \| Departur… - **Public Transit: Routes**: Routes. Lists public transit routes. The service supports several use cases as follows: * define routes based on arrival or departure times. * filter specific transit modes, such as rail and metro only. * plan routes hours or days in advance. * set a maximum distance for the wal… - **Public Transit: Stations**: Stations. Lists public transit stations. Discovers stations using structured or topological queries. The service accepts three types of queries as shown in the table below: \| Query \| Parameter \| Description \| \|-------\|-----------\|-------------\| \| Stations by IDs \| `ids… - **Raster Tile: Retrieve the rendered map tile in requested format**: Retrieve the rendered map tile in requested format. Retrieve the rendered map tile in requested format. It is possible to select among different parameters to modify the output, like a different style, languages, label size, and so on. - **Raster Tile: Returns geopolitical views**: Returns geopolitical views. Returns the list of available geopolitical views. These values can then be used to request a tile with a particular country view. For more information on geopolitical views, see [Geopolitical views](https://docs.here.com/map-rendering/docs/geopolitica… - **Raster Tile: Returns information about accepted values of some API parameters**: Returns information about accepted values of some API parameters. Returns information about accepted values of some API parameters, like accepted ppi, styles, and so on. Also returns the map version. This version is valid only for 24h. - **Raster Tile: Returns map languages**: Returns map languages. Returns the list of available map languages per resource. These values can then be used to request a tile with a particular language for the labels. The values follow ISO 639-1 two-letter language code and, optionally, ISO 15924 four-letter script code. - **Raster Tile: Returns styles features**: Returns styles features. Returns the list of available features per style. Then these values can be used to request a tile with particular features specified as query parameters. Must be consistent with 'style' parameter. - **Raster Tile: Returns the copyright**: Returns the copyright. Returns the copyright. If your products and/or services use map data that is made accessible using this service, you shall provide end-users of your products and/or services with notice, in a reasonably conspicuous manner. - **Route Matching: Match GPS Trace (GET)**: Match GPS traces to get the most probably driven path. Use &routeMatch=1 for default route matching behavior. Compatible with version 2 route matching.. Note: We recommend using POST requests for large payloads, as GET requests may be constrained by request-line length limits im… - **Route Matching: Match GPS Trace (POST)**: Match GPS traces to get the most probable driven path. Must use `&routeMatch=1` for default route matching behavior. Compatible with version 2 route matching.. - **Routing: Calculate a route from a sequence of trace points**: Calculate a route from a sequence of trace points. Creates a route from a sequence of trace points. Post body size limit is 10MiB. For best results, use 1Hz GPS data or any points that have a spacing of a few meters between them. For traces with less frequent points, the Route I… - **Routing: Calculate routes via GET**: Calculate routes via GET. Calculates a route using a generic vehicle/pedestrian mode, e.g. car, truck, pedestrian, etc... - **Routing: Calculate routes via POST**: Calculate routes via POST. Calculates a route using a generic vehicle/pedestrian mode, e.g. car, truck, pedestrian, etc... At the moment, only selected parameters are permitted in the POST body, particularly those that may be restricted in the query string due to request size li… - **Routing: Get Route By Handle via GET**: Get route by handle via GET. Decodes and returns a route from a previously calculated route handle. **Disclaimer: A route handle is not suitable for persistent route storage! It can be invalidated at any time.** A route handle encodes a previously calculated route. A route can b… - **Routing: Get Route By Handle via POST**: Get route by handle via POST. Decodes and returns a route from a previously calculated route handle. **Disclaimer: A route handle is not suitable for persistent route storage! It can be invalidated at any time.** A route handle encodes a previously calculated route. A route can … - **Tour Planning: (ALPHA) Submit a Vehicle Routing Problem to solve it synchronously**: **ALPHA** Submit a Vehicle Routing Problem to solve it synchronously. **ALPHA** Solve a vehicle routing problem synchronously by optimizing vehicle routes and schedules for jobs (deliveries or pickups) from a depot, including constraints like vehicle capacity, job demand, time w… - **Tour Planning: (ALPHA) Upload a Routing Matrix**: **ALPHA** Upload a Routing Matrix. **ALPHA** Upload a [routing matrix](https://docs.here.com/tour-planning/docs/custom-matrix) for use in subsequent asynchronous requests. To gain access to this endpoint, contact your regional HERE representative. - **Tour Planning: Cancel a problem by problem or status Id**: Cancel a problem by problem or status Id. Cancel a previously submitted vehicle routing problem. This action stops the solver from processing the problem and prevents any further updates or solutions from being generated. - **Tour Planning: Get solution by problem or status Id**: Get solution by problem or status Id. Retrieve a solution for a previously submitted vehicle routing problem. - **Tour Planning: Get status update by Id**: Get status update by Id. Provides an interface to retrieve the status ID of an asynchronous request. - **Tour Planning: Submit a Vehicle Routing Problem to solve it asynchronously**: Submit a Vehicle Routing Problem to solve it asynchronously.. Solve a [vehicle routing problem](https://docs.here.com/tour-planning/docs/problem) asynchronously by optimizing vehicle routes and schedules for jobs (deliveries or pickups) from a depot, including constraints like v… - **Tour Planning: Submit a Vehicle Routing Problem to solve it synchronously**: Submit a Vehicle Routing Problem to solve it synchronously. Solve a [vehicle routing problem](https://docs.here.com/tour-planning/docs/problem) synchronously by optimizing vehicle routes and schedules for jobs (deliveries or pickups) from a depot, including constraints like vehi… - **Traffic Raster Tile: Map version information**: Map version information. Returns the map version. This version is valid only for 24h at maximum. - **Traffic Raster Tile: Retrieves the rendered map tile in requested format**: Retrieves the rendered map tile in requested format.. Map tile in requested format. - **Traffic: Real-Time Flow Information**: Real-Time Flow Information. Get real-time traffic flow data for a geospatial area. - **Traffic: Real-Time Flow Information (POST)**: Real-Time Flow Information. Get real-time traffic flow data for a geospatial area with geospatial filter. - **Traffic: Real-Time Incident Information**: Real-Time Incident Information. Get traffic incidents for a geospatial area. - **Traffic: Real-Time Incident Information for the given id**: Real-Time Incident Information for the given id. Get traffic incident for a given id. The id can be prefixed with a namespace. If no namespace is specified, the default namespace is "here:traffic:incident". - **Traffic: Real-Time Incident Information for the given id (POST)**: Real-Time Incident Information for the given id. Get traffic incident for a given id. The id can be prefixed with a namespace. If no namespace is specified, the default namespace is "here:traffic:incident". - **Traffic: Real-Time Incident Information (POST)**: Real-Time Incident Information. Get traffic incidents for a geospatial area. - **Traffic Vector Tile: Retrieves the protocol buffer encoded binary tile**: Retrieves the protocol buffer encoded binary tile.. Retrieves the protocol buffer encoded binary tile with the traffic data. - **Vector Tile: Retrieves the protocol buffer encoded binary tile**: Retrieves the protocol buffer encoded binary tile.. Retrieves the protocol buffer encoded binary tile. - **Vector Tile: Returns a list of available protocol buffer formats**: Returns a list of available protocol buffer formats.. Returns a list of available protocol buffer formats. - **Vector Tile: Returns OMV-2 layers documentation**: Returns OMV-2 layers documentation.. Returns OMV-2 layers documentation. - **Vector Tile: Returns the copyright**: Returns the copyright. Returns the copyright - **Vector Tile: Returns the map languages**: Returns the map languages.. Returns the list of available map languages per map variant. - **Vector Tile: Returns the map version. This version is valid only for 24h**: Returns the map version. This version is valid only for 24h. Returns the map version. This version is valid only for 24h - **Vector Tile: Returns the political views**: Returns the political views.. Returns the list of available political views. - **Vector Tile: Returns the specified protocol buffer file format**: Returns the specified protocol buffer file format.. Returns the specified protocol buffer file format. - **Waypoints Sequence: Find Optimal Waypoint Sequence (GET)**: Waypoints sequence a p i find sequence g e t. Compute best Sequence for Waypoints (Travelling Salesman Problem). Note: We recommend using POST requests for large payloads, as GET requests may be constrained by request-line length limits imposed by load balancers. - **Waypoints Sequence: Find Optimal Waypoint Sequence (POST)**: Waypoints sequence a p i find sequence p o s t. Compute best Sequence for Waypoints (Travelling Salesman Problem). For POST requests, send the request parameters in an application/x-www-form-urlencoded request body instead of the query string. - **Weather: Weather alerts**: Weather alerts. Weather alerts along the route or around a single location. - **Weather: Weather radar image**: Weather radar image. Retrieves a Doppler radar image - **Weather: Weather report**: Weather report. Retrieves weather reports, weather forecasts, severe weather alerts. Connect HERE in General Input: https://www.generalinput.com/apps/here