How Do I Properly Load the HARP Engine Module in a Nuxt 3 HERE Maps API Project?

The error you're encountering indicates that the HARP engine module wasn’t loaded even though you've already imported the main HERE Maps library via your Nuxt plugin. In the latest releases of the HERE Maps API, the HARP engine is provided as an optional module and isn’t automatically included in the default bundle.

To fix this, you need to explicitly import (or load) the HARP engine module in your Nuxt project. Here are a couple of approaches you can try:

---

1. Use a Separate Import for HARP

If HERE provides a separate module (or file) for the HARP engine, you can import it in your plugin before using it. For example:

JAVASCRIPTCopied
import HereMap from 'path-to-here-maps-library';
import 'path-to-here-maps-harp-module'; // Ensure this file/module is imported before initialization

export default defineNuxtPlugin(() => {
  return {
    provide: {
      H: HereMap,
    },
  }
});

Check the documentation for the exact module name/path for HARP. This ensures that when you call platform.createDefaultLayers({ engineType, ... }), the HARP engine is available.

---

2. Dynamically Load the HARP Module

If the HARP module is available through a separate URL, you may need to load it dynamically (for example, as an additional script). In your Nuxt plugin, you can do something like this:

JAVASCRIPTCopied
export default defineNuxtPlugin(async () => {
  // If HARP is served via a separate URL
  await new Promise((resolve, reject) => {
    const script = document.createElement('script');
    script.src = 'https://js.api.here.com/v3/3.1/mapsjs-harp.js';
    script.onload = resolve;
    script.onerror = reject;
    document.head.appendChild(script);
  });

  // After HARP is loaded, you can provide HereMap
  return {
    provide: {
      H: window.H, // or however you are accessing HereMap
    },
  }
});

Again, refer to the API docs for the correct HARP module URL.

---

Key Points to Remember

• Optional Module: The HARP engine is not bundled with the main HERE Maps API script; you must load it explicitly.
• Version Compatibility: Double-check that the HARP module you are trying to load is compatible with version 1.61.2.
• Documentation: Always refer to the official HERE Maps API documentation for the exact instructions on how to load additional modules like HARP in your project.

Once you include the HARP module either statically or dynamically, the error should go away, and engineType for HARP should be recognized.