Skip to content

HERE Tracking API

by here.com

HTTP BasicHTTPSGeocoding
Open documentation ↗

Overview

HERE Tracking is a cloud product designed to address location tracking problems for a wide range of Location IoT industry verticals. HERE Tracking also includes end-user mobile and web applications that can be used to demonstrate the product.

HERE Tracking is a geocoding API from here.com. Requests are authenticated with HTTP Basic auth. It is served over HTTPS. Its OpenAPI description documents 216 endpoints.

At a glance

Authentication
HTTP Basic
HTTPS
Yes
CORS
Unknown
Category
Geocoding
Base URL
https://tracking.api.here.com/
Version
2.1.191
Endpoints
216
Spec updated
2023-03-06

Make a first request

Replace the placeholders; the documentation says exactly where credentials go.

cURL
curl -X GET "https://tracking.api.here.com/aliases/v2" \
  -H "Accept: application/json" \
  -H "Authorization: Basic BASE64_USER_PASSWORD"
JavaScript
const response = await fetch("https://tracking.api.here.com/aliases/v2", {
  method: "GET",
  headers: {
    "Accept": "application/json",
    "Authorization": "Basic BASE64_USER_PASSWORD",
  },
});
const data = await response.json();
console.log(data);
Python
import requests

response = requests.request(
    "GET",
    "https://tracking.api.here.com/aliases/v2",
    headers={
    "Accept": "application/json",
    "Authorization": "Basic BASE64_USER_PASSWORD",
    },
    timeout=30,
)
print(response.json())

Endpoints

MethodPathWhat it does
GET/aliases/v2Gets all aliases
GET/aliases/v2/healthGets service health
GET/aliases/v2/trackingIdGets the tracking ID associated with an alias
GET/aliases/v2/versionGets service version
GET/aliases/v2/{trackingId}Gets all aliases of a device
DELETE/aliases/v2/{trackingId}Deletes all aliases of a device
PUT/aliases/v2/{trackingId}/batchCreates multiple aliases for a device
GET/aliases/v2/{trackingId}/{type}Gets all aliases of a specified type for a device
DELETE/aliases/v2/{trackingId}/{type}Deletes all aliases of a specified type for a device
PUT/aliases/v2/{trackingId}/{type}/{externalId}Creates an alias
DELETE/aliases/v2/{trackingId}/{type}/{externalId}Deletes an alias
PUT/associations/v3/devices/batchUpdateUpdates rules associations for devices
POST/associations/v3/devices/{trackingId}/batchCreateAssociates rules with a device
POST/associations/v3/devices/{trackingId}/batchDeleteDisassociates rules from a device
GET/associations/v3/geofences/{geofenceId}Gets all devices associated with a geofence
GET/associations/v3/healthGets service health
GET/associations/v3/rules/{ruleId}Gets all devices associated with a rule
GET/associations/v3/sensors/{sensorRuleId}Gets all devices associated with a sensor rule
GET/associations/v3/versionGets service version
GET/associations/v3/{trackingId}/geofencesGets geofences associated with a device
PUT/associations/v3/{trackingId}/geofences/{geofenceId}Associates a device to a geofence
DELETE/associations/v3/{trackingId}/geofences/{geofenceId}Disassociates a device and a geofence
GET/associations/v3/{trackingId}/rulesGets rules associated with a device
PUT/associations/v3/{trackingId}/rules/{ruleId}Associates a device to a rule
DELETE/associations/v3/{trackingId}/rules/{ruleId}Disassociates a device and a rule
GET/associations/v3/{trackingId}/sensorsGets sensor rules associated with a device
PUT/associations/v3/{trackingId}/sensors/{sensorRuleId}Associates a device with a sensor rule
DELETE/associations/v3/{trackingId}/sensors/{sensorRuleId}Disassociates a device and a sensor rule
GET/bulkjobs/v4/deviceUploadsGets the bulk upload job IDs for a project
POST/bulkjobs/v4/deviceUploadsStarts bulk upload
PATCH/bulkjobs/v4/deviceUploads/{jobId}Updates bulk upload job status
GET/bulkjobs/v4/deviceUploads/{jobId}/resultsGets bulk upload results
GET/bulkjobs/v4/deviceUploads/{jobId}/statusGets bulk upload status
GET/bulkjobs/v4/healthGets service health
GET/bulkjobs/v4/versionGets service version
POST/c2c/v4/callbackReceives external device update reports
GET/c2c/v4/connectorsGets a list of connectors
POST/c2c/v4/connectorsCreates a connector
GET/c2c/v4/connectors/ext-devices/{externalDeviceId}Gets connector identifiers for an external device
GET/c2c/v4/connectors/{connectorId}Gets a connector info
PUT/c2c/v4/connectors/{connectorId}Updates a connector info
DELETE/c2c/v4/connectors/{connectorId}Deletes a connector
GET/c2c/v4/connectors/{connectorId}/ext-devicesGets all external devices under a connector
POST/c2c/v4/connectors/{connectorId}/ext-devicesAdds external devices to a connector
DELETE/c2c/v4/connectors/{connectorId}/ext-devices-batchRemoves a batch of external devices from a connector
DELETE/c2c/v4/connectors/{connectorId}/ext-devices/{externalDeviceId}Removes an external device from a connector
GET/c2c/v4/driversGets a list of drivers
POST/c2c/v4/drivers/{driverId}/verifyValidate and verify external cloud credentials for driver
GET/c2c/v4/healthGets service health
GET/c2c/v4/versionGets service version
GET/device-associations/v2/healthdeprecatedGets service health
GET/device-associations/v2/versiondeprecatedGets service version
GET/device-associations/v2/{trackingId}/geofencesdeprecatedGets geofences associated with a device
GET/events/v3Gets event history
GET/events/v3/healthGets service health
GET/events/v3/statusesGets the event statuses
GET/events/v3/statuses/deviceCountsGets the number of devices and shipments in each event state
GET/events/v3/versionGets service version
GET/events/v3/{trackingId}Gets event history for a device or a shipment
GET/geofence-associations/v2/healthdeprecatedGets service health
GET/geofence-associations/v2/versiondeprecatedGets service version
GET/geofence-associations/v2/{geofenceId}/devicesdeprecatedGets all devices associated with a geofence
PUT/geofence-associations/v2/{geofenceId}/{trackingId}deprecatedAssociates a device with a geofence
DELETE/geofence-associations/v2/{geofenceId}/{trackingId}deprecatedDisassociates a device and a geofence
GET/geofences/v2Gets all geofences
POST/geofences/v2Creates a geofence
DELETE/geofences/v2Deletes all geofences
GET/geofences/v2/healthGets service health
POST/geofences/v2/trainingTestChecks if a POI geofence training is possible with the given parameters
GET/geofences/v2/versionGets service version
GET/geofences/v2/{geofenceId}Gets a single geofence
PUT/geofences/v2/{geofenceId}Updates a single geofence
DELETE/geofences/v2/{geofenceId}Deletes a geofence
POST/geofences/v2/{geofenceId}/poiTrainingTrains a POI geofence
GET/labels/v4/healthGets service health
GET/labels/v4/versionGets service version
GET/labels/v4/{resourceType}Gets all labels of a resource type
GET/labels/v4/{resourceType}/keysGets all label keys of a resource type
GET/labels/v4/{resourceType}/keys/{key}/valuesGets all values of a label
GET/labels/v4/{resourceType}/{resourceId}Gets all labels of a resource
DELETE/labels/v4/{resourceType}/{resourceId}Deletes all labels of a resource
PUT/labels/v4/{resourceType}/{resourceId}/batchCreates a set of labels for a resource
DELETE/labels/v4/{resourceType}/{resourceId}/{key}Deletes all labels of a resource by a label key
PUT/labels/v4/{resourceType}/{resourceId}/{key}/{value}Creates a label for a resource
DELETE/labels/v4/{resourceType}/{resourceId}/{key}/{value}Deletes a label of a resource
POST/largedata/v4Creates a new data upload
GET/largedata/v4/devices/{trackingId}/metadataGets metadata listing for all large data for a device
GET/largedata/v4/healthGets service health
GET/largedata/v4/versionGets service version
POST/largedata/v4/{dataId}Completes data upload
DELETE/largedata/v4/{dataId}Deletes large data
GET/largedata/v4/{dataId}/dataGets large data object
GET/largedata/v4/{dataId}/metadataGets metadata for a large data object
GET/largedata/v4/{dataId}/partsGets parts information listing for a large data object
PUT/largedata/v4/{dataId}/parts/{partNumber}Uploads a part of a large data
GET/locations/v4Gets all locations
POST/locations/v4Creates a location
DELETE/locations/v4Deletes all locations
GET/locations/v4/healthGets service health
GET/locations/v4/versionGets service version

Showing the first 100 of 216 endpoints; the full list is in the documentation.

Questions

Does the HERE Tracking API need an API key?

Yes. The HERE Tracking API uses HTTP Basic authentication; the documentation explains how to get credentials.

Does the HERE Tracking API support HTTPS?

Yes, the HERE Tracking API is served over HTTPS.

How many endpoints does the HERE Tracking API have?

Its OpenAPI description lists 216 endpoints in version 2.1.191. The first 100 are shown on this page.

What are alternatives to the HERE Tracking API?

Other Geocoding APIs include Bing Maps, ip-api, OpenStreetMap, GeographQL, IP Address Details.

Compare alternatives →

Listed from APIs.guru (CC0).