Package com.here.sdk.maploader

Enum Class MapLoaderError

java.lang.Object
java.lang.Enum<MapLoaderError>
com.here.sdk.maploader.MapLoaderError
All Implemented Interfaces:
Serializable, Comparable<MapLoaderError>, Constable
public enum MapLoaderError extends Enum<MapLoaderError>

Specifies possible errors that may result from map downloading/prefetching.

  • Enum Constant Details

    • RESOURCE_NOT_FOUND

      public static final MapLoaderError RESOURCE_NOT_FOUND

      The requested resource is not found.

    • NOT_READY

      public static final MapLoaderError NOT_READY

      There's a problem with an ongoing download or update: If an operation is in a paused state, you can resume or cancel it. If no operation is in a paused state: Either wait for active downloads to finish, or cancel existing sdk.maploader.MapDownloader requests and call sdk.maploader.MapDownloader.get_initial_persistent_map_status. If there is a problem, call sdk.maploader.MapDownloader.repair_persistent_map to repair before continuing with other sdk.maploader.MapDownloader operations. This error may occur when an on-going or paused operation prevents the requested task.

    • INVALID_ARGUMENT

      public static final MapLoaderError INVALID_ARGUMENT

      The request passed invalid arguments.

    • OPERATION_CANCELLED

      public static final MapLoaderError OPERATION_CANCELLED

      The request was cancelled (usually by the user).

    • ALREADY_INSTALLED

      public static final MapLoaderError ALREADY_INSTALLED

      All tiles of requested regions were already installed, no need for any download.

    • TIME_OUT

      public static final MapLoaderError TIME_OUT

      The request exceeded the timeout limit.

    • SERVICE_UNAVAILABLE

      public static final MapLoaderError SERVICE_UNAVAILABLE

      The requested service is unavailable.

    • ACCESS_DENIED

      public static final MapLoaderError ACCESS_DENIED

      The access is denied due to invalid credentials.

    • REQUEST_LIMIT_REACHED

      public static final MapLoaderError REQUEST_LIMIT_REACHED

      Request limit reached for set a credentials for a particular period of time.

    • NETWORK_CONNECTION_ERROR

      public static final MapLoaderError NETWORK_CONNECTION_ERROR

      A network connection error has happened.

    • FORBIDDEN

      public static final MapLoaderError FORBIDDEN

      The operation is forbidden, make sure your credentials grant the necessary permissions.

    • MAP_DATA_ERROR

      public static final MapLoaderError MAP_DATA_ERROR

      Downloaded map data is invalid or a sdk.maploader.RegionId passed to the method sdk.maploader.MapDownloader.delete_regions is incorrect.

    • UNEXPECTED_SERVER_RESPONSE

      public static final MapLoaderError UNEXPECTED_SERVER_RESPONSE

      Received unexpected response from the backend. It means the response is malformed or server returned an internal error. Try repeating the request.

    • MAP_MANAGER_ERROR

      public static final MapLoaderError MAP_MANAGER_ERROR

      Error occurred inside the map manager and might be related to network issues. Try repeating the request.

    • INCOMPLETE_DATA

      public static final MapLoaderError INCOMPLETE_DATA

      The data to process is incomplete, failed decoding the tile.

    • SERVICE_ACCESS_FAILED

      public static final MapLoaderError SERVICE_ACCESS_FAILED

      The conditions to access the service are not satisfied. Check if correct sdk.maploader.RegionId was passed to sdk.maploader.MapDownloader.download_regions or download for passed sdk.maploader.RegionId already started. Further control for started download must be performed through sdk.maploader.MapDownloaderTask.

    • INTERNAL_ERROR

      public static final MapLoaderError INTERNAL_ERROR

      Internal error occurred.

    • OFFLINE

      public static final MapLoaderError OFFLINE

      Online operation is not permitted because offline mode is enabled.

    • CACHE_IO_ERROR

      public static final MapLoaderError CACHE_IO_ERROR

      A cache IO error occurred.

    • PROTECTED_CACHE_CORRUPTED

      public static final MapLoaderError PROTECTED_CACHE_CORRUPTED

      Protected cache is corrupted. It can be a result of downloading the map in the background and the OS killing the application at that time. Use method sdk.maploader.MapDownloader.get_initial_persistent_map_status to get the status of the map and method repair_persistent_map in the MapDownloader to try to fix the cache if it is broken.

    • MIGRATION_REQUIRED

      public static final MapLoaderError MIGRATION_REQUIRED

      Operation on the protected cache cannot be done due to required migration. Call sdk.maploader.MapDownloader.repair_persistent_map to perform migration.

    • OPERATION_AFTER_DISPOSE

      public static final MapLoaderError OPERATION_AFTER_DISPOSE

      Method is invoked on object connected to the disposed SDKNativeEngine.

    • CATALOG_CONFIGURATION_ERROR

      public static final MapLoaderError CATALOG_CONFIGURATION_ERROR

      Misconfiguration of catalogs. This error may occur when sdk.core.engine.CatalogConfiguration is misconfigured and cannot be used for any operation with MapDownloader or MapUpdater. Verify SDKOptions.catalogConfigurations.

    • PENDING_UPDATE

      public static final MapLoaderError PENDING_UPDATE

      Map regions update was interrupted. Indicates that the cache state is wrong after an update that was finished not in correct way (e.g sudden app shutdown). Prefetching or removing of map regions are blocked until the update has been completed successfully.

    • UPDATE_BLOCKED_AS_ANOTHER_PENDING

      public static final MapLoaderError UPDATE_BLOCKED_AS_ANOTHER_PENDING

      Catalog update cannot proceed as another catalog update is in PENDING_UPDATE state. Update the catalog in PENDING_UPDATE state first, before trying to update another catalog.

    • BROKEN_UPDATE

      public static final MapLoaderError BROKEN_UPDATE

      Unrecoverable error during construction of pending update parameters. Operations such as catalog updates or region downloads will fail. The healing procedure is to clean persistent map with sdk.maploader.MapDownloader.clear_persistent_map_storage.

    • PARALLEL_REQUEST

      public static final MapLoaderError PARALLEL_REQUEST

      Parallel request is already running and conflicting with the current one (e.g updating map and deleting map regions)

    • PROXY_AUTHENTICATION_FAILED

      public static final MapLoaderError PROXY_AUTHENTICATION_FAILED

      Proxy is not authenticated. Check your proxy credentials.

    • PROXY_SERVER_UNREACHABLE

      public static final MapLoaderError PROXY_SERVER_UNREACHABLE

      Proxy server unreachable.

    • NOT_ENOUGH_SPACE

      public static final MapLoaderError NOT_ENOUGH_SPACE

      There's no sufficient space on the disk to finish operation. For offline maps operation (download or update), it means that there's not enough space on the device. For prefetch operations, it means that there's not enough space in the mutable cache to store the prefetched data.

    • ONLINE_NAVIGATE_ONLY

      public static final MapLoaderError ONLINE_NAVIGATE_ONLY

      This version of HERE SDK does not support the ability to download maps. Contact the sales team to get access to the full version.

  • Method Details

    • values

      public static MapLoaderError[] values()
      Returns an array containing the constants of this enum class, in the order they are declared.
      Returns:
      an array containing the constants of this enum class, in the order they are declared

    • valueOf

      public static MapLoaderError valueOf(String name)
      Returns the enum constant of this class with the specified name. The string must match exactly an identifier used to declare an enum constant in this class. (Extraneous whitespace characters are not permitted.)
      Parameters:
      name - the name of the enum constant to be returned.
      Returns:
      the enum constant with the specified name
      Throws:
      IllegalArgumentException - if this enum class has no constant with the specified name
      NullPointerException - if the argument is null