Integration guide

Set up HERE Maps in RouteIQ

Create a HERE project, app, and API key, then choose which RouteIQ mapping operations HERE should handle.

Updated September 3, 2026
HERE bills you separately. Review HERE's current pricing and expected request volume before using the key in production.

Before you start

You will need a HERE account, permission to manage a project and app, an appropriate HERE plan or billing setup, and administrator access to your RouteIQ site.

Separate environments

Use a dedicated HERE app and API key for each RouteIQ environment. This makes access, usage reporting, and rotation easier to control.

1. Create a HERE project and app

  1. Sign in to the HERE platform.
  2. Open Projects Manager and create or choose a project for RouteIQ.
  3. Open Access Manager > Apps and register a new app.
  4. Name it clearly, such as RouteIQ production, and associate it with the project.

See HERE's documentation for projects and apps.

2. Link the location services you need

Under the project's resources or services area, give the app access to the services matching the operations you will assign:

RouteIQ operationHERE servicePurpose
autocompleteGeocoding and Search API v7Address suggestions while a user types.
geocodeGeocoding and Search API v7Addresses to coordinates.
reverse_geocodeGeocoding and Search API v7Coordinates to readable addresses.
routingRouting API v8Routes between ordered stops.
matrixMatrix Routing API v8Travel-time and distance matrices.
sequenceWaypoints Sequence API v8Optimized stop ordering.

HERE provides official quick starts for Routing v8, Matrix Routing v8, and autocomplete.

3. Create the API key

  1. Open the RouteIQ app in Access Manager > Apps.
  2. Open Credentials > API Keys.
  3. Select Create API key.
  4. Copy the key and store it securely.
Do not use a website-domain restriction

RouteIQ sends HERE requests from its servers and does not provide stable outbound IP addresses. A restriction tied to your website, referrer, or a fixed RouteIQ IP will block legitimate requests. Limit access through the dedicated project, app, and linked services instead.

HERE's API key guide covers current credential controls.

4. Connect HERE Maps to RouteIQ

  1. Sign in to RouteIQ and open Settings > Integrations.
  2. Find HERE Maps and turn it on.
  3. After it shows Connected, select Configure.
  4. Paste the key into HERE Maps API Key.
  5. Select at least one operation for HERE to handle.
  6. Leave Is Active selected and save.

5. Choose the right operations

HERE supports all six mapping features. Select all of them to use HERE for everything, or mix providers to get the best price, accuracy, and coverage for each feature.

Each map feature can use only one active provider. Remove a feature from its current provider before moving it to HERE. Select every feature you want HERE to handle. Anything you leave unselected continues to use the included provider.

Travel-time calculations and stop ordering can create much more billable usage than individual address lookups, so compare current pricing and expected volume before assigning them.

6. Verify the setup

  1. Confirm the HERE Maps card displays the operations you selected.
  2. Test address entry for autocomplete and geocoding operations.
  3. Use at least two valid locations to test routing and matrix calculations.
  4. Use three or more stops to test sequencing.
  5. Check HERE usage after the test requests have had time to appear.

Troubleshooting

HERE returns 401

Recopy the key and verify it remains enabled on the intended app.

HERE returns 403

Confirm the required service is linked to the project, the app has access, and no trusted-domain restriction is blocking server requests. HERE documents a common project-related 403.

RouteIQ rejects the operation assignment

Another active provider may already own the operation. Remove it there before assigning it to HERE.

A large matrix fails

Reduce the number of locations and retry. Matrix products impose request-size and plan limits.

Rotate or remove the API key

  1. Create a second API key on the same HERE app.
  2. Replace the key in RouteIQ and save.
  3. Test every assigned operation.
  4. Delete or disable the old key only after verification.

Disconnecting HERE in RouteIQ does not revoke the key at HERE.