How to Check Whether Your HERE Platform Account Is Using Deprecated APIs or Services

Symptoms
------------

You may experience one or more of the following:

You received a notification that a HERE API or service is deprecated or scheduled for retirement.
Your application is still using legacy services such as Map Tile API v2, Routing API v7, Traffic API v6, or Places (Search) API.
You need to identify which projects, applications, or credentials are generating usage against deprecated services.
You want to prepare for API migration and avoid service interruptions after retirement dates.
Usage reports show legacy service identifiers, but you are unsure which replacement service to migrate to.
You need to verify compliance with the latest HERE Platform service architecture.

Answer
----------

You can identify deprecated HERE services used by your account by generating a Usage report in HERE Platform and reviewing the Usage Item ID and Resource ID fields. If any usage records match deprecated services, migrations to the recommended replacement APIs should be planned to avoid future application disruptions.

Applicable Product
----------------------

HERE Platform
HERE Location Services
Legacy and current HERE APIs and SDK integrations using platform credentials

Root Cause
--------------

HERE periodically retires older API generations and introduces newer service versions with enhanced capabilities, improved performance, updated architecture, and long-term support. Applications that continue to send requests to legacy endpoints will continue to generate usage records for deprecated services until migrated to the latest supported APIs.

How to Identify Deprecated Service Usage
--------------------------------------------

1. Sign in to HERE Platform.
2. Open the Launcher menu.
3. Navigate to Usage.
4. Select the period you want to review.
5. Generate and download a CSV usage report.
6. Review the Usage Item ID and Resource ID columns.
7. Compare the results with the deprecated services listed below.

Any matching entries indicate that one or more applications are still consuming legacy APIs.

Deprecated Services and Recommended Replacements
----------------------------------------------------

| Deprecated Service | Recommended Replacement |
| --- | --- |
| Map Tile API v2 | Raster Tile API v3, Traffic Raster Tile API |
| Map Image API v1 | Map Image API v3 |
| Traffic API v6 | Traffic API v7, Traffic Vector Tile API, Traffic Raster Tile API |
| Routing API v7 | Routing API v8, Matrix Routing API v8, Isoline Routing API v8 |
| Positioning API v1 | Positioning API v2 |
| Places (Search) API | Geocoding & Search API v7 |
| Geocoder Autocomplete API v6 | Geocoding & Search API v7 |
| Geocoder API v6 | Geocoding & Search API v7 |
| Fleet Telematics API Extensions | Routing API v8, Route Matching API v8, Waypoints Sequence API v8, Map Attributes API v8 |

Impact
----------

If deprecated services remain in use:

Applications may require emergency migration work when retirement deadlines are reached.
Service availability may be impacted after retirement.
New features and improvements available in current APIs may not be accessible.
Technical troubleshooting may become more difficult due to legacy architecture dependencies.

Expected vs. Unexpected Behavior
------------------------------------

Expected Behavior

Usage reports display all service consumption associated with the selected period.
Legacy service identifiers appear in the report when applications are still using deprecated APIs.
Modern API versions generate usage records corresponding to their current service names.

Unexpected Behavior

No usage data appears despite active application traffic.
Usage reports cannot be generated.
Deprecated service consumption is suspected but does not appear in the report.
Report fields are incomplete or contain unexpected values. In these cases, contact HERE Support for investigation.

Recommended Actions
-----------------------

Review usage reports regularly.
Inventory all applications using HERE services.
Prioritize migration of deprecated APIs to supported versions.
Validate application functionality after migration.
Monitor usage reports after deployment to confirm that deprecated service consumption has stopped.
Contact HERE Support if assistance is required with service mapping or migration planning.

Keywords / Tags
-------------------

HERE Platform, deprecated API, retired service, Usage report, Usage Item ID, Resource ID