HERE Android SDK Developer's Guide

Shared Map Resources

The HERE SDK utilizes a shared disk cache on external device memory where it keeps map resources. This disk cache is shared between all applications and components that use the HERE SDK. The disk cache can be accessed by multiple applications concurrently, even while map data is being loaded. (For more information, see Offline Maps (MapLoader))

Usage of map resources must be properly handled on an application level. When an application is in active use, it must hold a reference to map resources for HERE SDK functionality to work. When an application is not being used (for example, it has been sent to the background), it should release its reference to map resources.

For MapFragment users, map resource usage is handled automatically, so explicit handling of map resource references is not required.

Reference handling can be performed manually. This is useful if an application wishes to support a use case that is outside the scope of classes that provide automatic reference handling. Some examples of this include performing route calculations in a background service or directly using a MapView component.

  • onPause() - Decrements the reference count of map resource usage.
  • onResume() - Increments the reference count of map resource usage.
  • getResourceReferenceCount() - Get the current reference count of map resource usage for your application

For more info on these methods and their usage, consult the API reference.