SDKOptions class - core.engine library - Dart API
SDKOptions
SDKOptions class
SDKOptions provide an alternative way to set or update the HERE SDK credentials and other parameters at runtime to initialize the SDKNativeEngine.
Constructors
- SDKOptions.withAuthenticationMode(AuthenticationMode authenticationMode)
-
Constructs a SDKOptions from authentication mode.
factory
Properties
- actionOnCacheLock ↔ SDKOptionsActionOnCacheLock
-
Specifies action to perform when cache folder is locked by another process. Default value is SDKOptionsActionOnCacheLock.waitLockingAppFinish.
getter/setter pair
- authenticationMode ↔ AuthenticationMode
-
Encapsulates Authentication method and parameters.
getter/setter pair
- autoUpdateOfOnlineCache ↔ bool
-
Parameter to enable automatic cache updates.
getter/setter pair
- billingTag ↔ String?
-
Internal to HERE SDK. DO NOT USE THIS YET.
getter/setter pair
- cachePath ↔ String
-
Path to be used for caching purposes. It should be a path to the desired location where the application has read/write permissions.
The path can be on internal or external storage.
By default, this returns an empty string. Setting a new string, will overwrite the internally used default paths:
getter/setter pair
- cacheSizeInBytes ↔ int
-
Desired upper bound of application size in bytes. When cached data exceeds cache_size, least recently used data will be removed.
Default value 256MB
getter/setter pair
-
catalogConfigurations
↔ List<
CatalogConfiguration> -
This field specifies how the SDKNativeEngine should access, use and store
data for different catalogs. You can access default catalogs on the HERE platform and
also custom catalogs such as for self-hosted or BYOD (bring your own data) use cases.
For further information about catalogs and related concepts see
CatalogConfiguration
getter/setter pair
-
customEngineOptions
↔ Map<
EngineBaseURL, EngineOptions> -
Set custom options for SDK Engines. This includes:
getter/setter pair
- customOptions ↔ Metadata?
-
Custom options.
getter/setter pair
- dataPath ↔ String
-
Path used for storing application internal data, such as the offline search index and other essential data required for proper functionality.
getter/setter pair
- hashCode → int
-
The hash code for this object.
no setter
- layerConfiguration ↔ LayerConfiguration
-
Defines a list of data features that can be enabled / disabled. Once set to SDKOptions when
a new HERE SDK is constructed, it will affect the map cache and offline maps.
When disabling certain features, less data will be prefetched when the map is rendered. Map
data that was already cached will not be removed until the least recently used strategy (LRU)
applies. That means you cannot remove any content from the map cache by updating the
LayerConfiguration. However, for new map data, it will be applied.
For offline maps, this LayerConfiguration can reduce the download size of all regions.
Note that the LayerConfiguration is applied globally to all regions that will be downloaded
in the future. It will not affect already downloaded regions. Updating a region will also
not update the LayerConfiguration. Only the LayerConfiguration will be used that was set
globally when a region was downloaded for the first time. If you want to update the
LayerConfiguration for an already downloaded region, please delete the region and download it again.
getter/setter pair
- lowMemoryMode ↔ bool
-
If an application runs in a memory-constrained environment, enable this option to reduce the HERE SDK's memory footprint.
When set to
trueconfigures internal memory caches to consume less memory. Reduction in cache sizes also reduces performance of the HERE SDK. In order to release memory occupied by internal caches see SDKNativeEngine.purgeMemoryCaches.getter/setter pair - networkSettings ↔ NetworkSettings
-
Network settings to use at the start. Some of those settings can be changed later.
getter/setter pair
- offlineMode ↔ bool
-
Sets offline mode for the HERE SDK. Defaults to
false. When enabled, this prevents the HERE SDK from initiating any online connection from starting. The mode can be disabled or enabled again at any time via SDKNativeEngine.isOfflineMode.getter/setter pair - persistentMapStoragePath ↔ String
-
Path to store persistent map data. This should be the a path to the desired location for which the application has read/write permissions.
The path can be on internal or external storage.
By default, this returns an empty string. Setting a new string, will overwrite the internally used default paths:
getter/setter pair
- politicalView ↔ String
-
Geopolitical view of a country, defined as a three letter country code by ISO 3166-1 alpha-3. Each disputed territory has
an international and an alternative geopolitical view.
When set, the map view will show all country boundaries according to the geopolitical view of the country that has been set.
getter/setter pair
- runtimeType → Type
-
A representation of the runtime type of the object.
no setterinherited
- scope ↔ String
-
Optional project ID to set the project scope of the login session. Not used if empty.
see also Manage Projects
and IAM Concepts
getter/setter pair
Methods
-
noSuchMethod(
Invocation invocation) → dynamic -
Invoked when a nonexistent method or property is accessed.
inherited
-
toString(
) → String -
A string representation of this object.
inherited
Operators
-
operator ==(
Object other) → bool - The equality operator.