MapUpdaterMapUpdateVersionCommitPolicy enum
Defines if installed regions and subregions are updated one-by-one or if all regions are updated only once the updates for all installed regions have been downloaded entirely.
This influences the required size of the storage during an update. Regardless of the set policy, during an update, the previous region data is kept until the new region data is committed successfully to the persisted storage. This allows to revert to the previous version in case the update fails. With MapUpdaterMapUpdateVersionCommitPolicy.onComplete, more data has to be kept until the update process finishes, while MapUpdaterMapUpdateVersionCommitPolicy.onFirstRegion allows to make faster use of the downloaded region and requires less disk space as only the currently updated region is kept until the process completes. However, with an MapUpdaterMapUpdateVersionCommitPolicy.onFirstRegion policy the overall process can be less reliable and bears a higher risk of errors.
Values
- onFirstRegion → const MapUpdaterMapUpdateVersionCommitPolicy
-
Updates the cache and the persisted storage once the first region was fully downloaded. If only one region was requested, this setting is equivalent to MapUpdaterMapUpdateVersionCommitPolicy.onComplete. If more regions or subregions are requested, then the policy will apply. For example, if Germany is requested to be updated, then the cache and the persisted storage will be updated as soon as any contained subregion such as Berlin or Brandenburg has been fully downloaded. The previous data for a region will be removed once that specific region has been updated successfully. However, the MapVersionHandle will be updated once the first region has been installed. This inconsistency will be gone, once the update process completes. In case of errors, or an aborted update process, CatalogsUpdateInfoCallback indicates that still an update is available until the process was successfully repeated.
- onComplete → const MapUpdaterMapUpdateVersionCommitPolicy
-
Commits the new map version to the cache and the persisted storage once all previously installed regions have been updated. For example, if Germany needs an update, then all previous data is kept until Germany including all subregions has been downloaded. This update process is more reliable than MapUpdaterMapUpdateVersionCommitPolicy.onFirstRegion, but requires more free storage space until the process completes. Besides, users need to wait longer until they can use all updated regions.
Properties
- hashCode → int
-
The hash code for this object.
no setterinherited
- index → int
-
A numeric identifier for the enumerated value.
no setterinherited
- runtimeType → Type
-
A representation of the runtime type of the object.
no setterinherited
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.
inherited
Constants
-
values
→ const List<
MapUpdaterMapUpdateVersionCommitPolicy> - A constant List of the values in this enum, in order of their declaration.