Offline maps, scenes, and data | ArcGIS Maps SDK for Kotlin

Offline mapsAn offline map is a map area and its data content downloaded from an offline-enabled web map for use in offline applications built with ArcGIS Maps SDKs for Native Apps.Learn more, scenesA scene is a collection of layers that are displayed in 3D. It is typically composed of a basemap layer, data layers, and 3D data.Learn more, and data allow users to continue being productive when network connectivity is poor or nonexistent. Users can explore maps, collect information, edit their asset data, find placesA place, also known as a point of interest (POI), is a location that represents a business, administrative entity, or geographic feature around the world. A place can also have attributes associated with it, such as a name, address, category, and ID.Learn more, and routesA route is a polyline that defines the best path between two or more points in a street network.Learn more to new locationsA location is a position or region (point, line, or polygon) on the earth's surface.Learn more, all while disconnected. Once a connection is reestablished, users can update their offline map by downloading changes relevant to their offline map or by synchronizing their edits with the online servicesA service, also known as an ArcGIS service, is software that supports an ArcGIS REST API and provides geospatial functionality or data. A service can be hosted by Esri or in ArcGIS Enterprise.Learn more. Users can also explore scenes, manage camera controllers, and find locations, all while disconnected.

This SDK supports maps that are always connected, occasionally connected, and fully disconnected.

Always connected: Users expect their apps to have constant access to online map and layer services. If the device loses network connectivity, the application will lose access to these services, resulting in loss of data and, perhaps, app failure.
Occasionally connected: Apps that are occasionally connected can download an offline mapAn offline map is a map area and its data content downloaded from an offline-enabled web map for use in offline applications built with ArcGIS Maps SDKs for Native Apps.Learn more from a web mapA web map is a map stored as a JSON object that defines properties such as the basemap layer, data layers, layer styles, and pop-up styles. Its JSON structure is defined by the web map specification.Learn more when a connection is available and continue to work offline when the device is disconnected. When connectivity is restored, any changes to operational data in the offline map can be synchronized with the online services in the source web map. Occasionally connected apps can adopt the following workflows:
- Ahead of timeThe ahead-of-time workflow, also known as the preplanned workflow, is a development pattern for building offline applications where offline map areas in a web map are used by the offline application.Learn more: The web map author defines the area of interest as an offline map areaAn offline map area, also known as a preplanned map area, is an area in a web map used to create an offline map.Learn more. The offline map area generates an offline mapAn offline map is a map area and its data content downloaded from an offline-enabled web map for use in offline applications built with ArcGIS Maps SDKs for Native Apps.Learn more with its data content, on a regular basis. Any number of mobile workers can download this offline map and take it into the field. Use this workflow if you have a large crew that need to operate with an identical offline map. This workflow is also referred to as the preplanned workflow.
- On demandThe on-demand workflow is a development pattern for building offline applications where the offline application defines an area of a web map to take offline.Learn more: Each mobile worker defines the area of interest and the content to include from the web map, generates the offline map, and downloads it to their device, as required. Use this workflow if your mobile worker needs to specify the area of the web map to be taken offline.
Note
To include data content in an offline map, the servicesA service, also known as an ArcGIS service, is software that supports an ArcGIS REST API and provides geospatial functionality or data. A service can be hosted by Esri or in ArcGIS Enterprise.Learn more referenced by layers in the web map must be enabled for offline use. See Take web maps offline in the ArcGIS OnlineArcGIS Online is a GIS mapping, analytics, data hosting, and content management software as a service (SaaS) product. It includes applications, tools, APIs, and location services for users and developers. It is subscription-based and requires an ArcGIS Online account.Learn more documentation for more information.
Layers in an offline map can be configured to reference a service (instead of including content for that layer in the offline map). This is useful for layers that are updated frequently with time-sensitive content, such as a traffic layer. Content for these layers is only available while a network connection is present.
Fully disconnected: A fully disconnected workflow is suitable for apps that do not require regular data updates, or for apps that will never have access to a network connection. Apps can operate in a fully disconnected environment by opening mobile map packagesA mobile map package (MMPK) is a standalone file that contains one or more map definitions, including the basemap layers, data layers, layer styles, and pop-up styles for use in offline applications built with ArcGIS Maps SDKs for Native Apps.Learn more or mobile scene packagesA mobile scene package (MSPK) is a standalone file that contains one or more scene definitions, including the basemap layers, elevation layers, data layers, layer styles, and pop-up styles for use in offline applications built with ArcGIS Maps SDKs for Native Apps.Learn more created with ArcGIS Pro. These read-only packages can be shared within an organization or distributed by traditional means and copied onto any number of devicesA device is nearly any kind of computer, including desktops, laptops, mobile phones, and tablets.Learn more. See Take a map offline with ArcGIS Pro or Take a scene offline with ArcGIS Pro for more details.

Workflow capabilities summary

Capability	Ahead-of-time (map)	On-demand (map)	Mobile Map Package	Mobile Scene Package
Display, interact, identify, and analyze layersA layer is a reference to a collection of geographic data that is used to access and display data. The data for layers are typically provided by the basemap layer service and data services.Learn more.	Yes	Yes	Yes	Yes
Edit featureA feature is a single record, also known as a row, that represents a real-world entity. It typically contains a geometry (point, multipoint, polyline, or polygon) and attributes but it can also contain just attributes.Learn more data in the mobile geodatabaseA mobile geodatabase (.geodatabase) is a spatial data storage format in a single file on disk that can store, query, and manage spatial and nonspatial data. In applications built with the ArcGIS Maps SDKs for Native Apps, mobile geodatabases can be used in offline workflows when taking maps and features offline from services or in desktop-based scenarios as standalone mobile geodatabases from ArcGIS Pro.Learn more.	Yes	Yes	No	No
Synchronize edits with the online feature serviceA feature service is a data service that provides access to spatial and non-spatial data in feature layers, feature layer views, and tables.Learn more.	Yes	Yes	No	No
Share offline mapsAn offline map is a map area and its data content downloaded from an offline-enabled web map for use in offline applications built with ArcGIS Maps SDKs for Native Apps.Learn more or scenesA scene is a collection of layers that are displayed in 3D. It is typically composed of a basemap layer, data layers, and 3D data.Learn more with other users.	Yes	No	No	No
Receive update packages from feature services.	Yes	No	No	No
GeocodingGeocoding is the process of converting text for an address or place to a complete address with a location.Learn more.	No	No	Yes	Yes
RoutingA route is a polyline that defines the best path between two or more points in a street network.Learn more.	No	No	Yes	No
Support rasterA raster is a matrix of cells (or pixels) organized into rows and columns (or a grid) where each cell contains a value representing information, such as temperature. Rasters include digital aerial photographs, imagery from satellites, digital pictures, and scanned maps.Learn more layers.	No	No	Yes	Yes
Support online layersA layer is a reference to a collection of geographic data that is used to access and display data. The data for layers are typically provided by the basemap layer service and data services.Learn more and tablesA table is a non-spatial dataset in a feature service. All records in a table share the same set of fields.Learn more.	No	Yes	Yes	Yes
Simple editing with utility networksA utility network is a feature service that represents a utility system, such as water, gas, or electricity. A utility network provides the capabilities to visualize, edit, and analyze utility assets and data.Learn more.*	Yes	Yes	No	No
View utility network associations.*	Yes	Yes	No	No

* Taking utility networksA utility network is a feature service that represents a utility system, such as water, gas, or electricity. A utility network provides the capabilities to visualize, edit, and analyze utility assets and data.Learn more offline requires ArcGIS EnterpriseArcGIS Enterprise is a GIS mapping, analytics, data hosting, and content management product that can be hosted on-premise or in a cloud infrastructure. It includes software, applications, tools, APIs, and services for users and developers.Learn more version 10.9 or later.

Note

An alternative to downloading an offline mapAn offline map is a map area and its data content downloaded from an offline-enabled web map for use in offline applications built with ArcGIS Maps SDKs for Native Apps.Learn more or reading a mobile packageA mobile package is a stand-alone Mobile Map Package (MMPK) or Mobile Scene Package (MSPK) file for use in offline applications built with ArcGIS Maps SDKs for Native Apps.Learn more is to programmatically construct the map using individual layersA layer is a reference to a collection of geographic data that is used to access and display data. The data for layers are typically provided by the basemap layer service and data services.Learn more which can either reference offline dataOffline data is data that is generated and downloaded from a feature service, vector tile service, or image tile service for use in offline applications built with ArcGIS Maps SDKs for Native Apps.Learn more downloaded from individual servicesA service, also known as an ArcGIS service, is software that supports an ArcGIS REST API and provides geospatial functionality or data. A service can be hosted by Esri or in ArcGIS Enterprise.Learn more, or data filesA data file is a stand-alone file containing geographic data that can be sideloaded on to a device. It is typically used in offline applications that never connect to a network.Learn more stored on the device. Working directly with layers gives you full flexibility to compose your own map or scene to use offline.

Enable services for offline use

To access layer content while offline with the ahead-of-timeThe ahead-of-time workflow, also known as the preplanned workflow, is a development pattern for building offline applications where offline map areas in a web map are used by the offline application.Learn more or on-demandThe on-demand workflow is a development pattern for building offline applications where the offline application defines an area of a web map to take offline.Learn more workflows, you should offline-enable feature servicesA feature service is a data service that provides access to spatial and non-spatial data in feature layers, feature layer views, and tables.Learn more, vector tile servicesA vector tile service is a data service that provides access to vector tile data and a style definition.Learn more, and map tile servicesA map tile service, formerly known as image tile service, is a data service that provides access to static, pre-rendered mao tiles. The tiles are typical in PNG format. Map tiles are typically retrieved by specifying a specific level, row, and column value.Learn more that are referenced by layers in the web mapA web map is a map stored as a JSON object that defines properties such as the basemap layer, data layers, layer styles, and pop-up styles. Its JSON structure is defined by the web map specification.Learn more. The author of the web map can do this when publishing the web map, or later using any of the service management tools. See Take web maps offline in the ArcGIS OnlineArcGIS Online is a GIS mapping, analytics, data hosting, and content management software as a service (SaaS) product. It includes applications, tools, APIs, and location services for users and developers. It is subscription-based and requires an ArcGIS Online account.Learn more documentation for more information.

Feature services

You must sync-enable a feature serviceA feature service is a data service that provides access to spatial and non-spatial data in feature layers, feature layer views, and tables.Learn more if you want feature dataFeature data is a general term for one or more features, which are records that represent real-world geographic entities, stored as a feature collection, feature layer, or hosted feature layer.Learn more to be downloaded with the offline mapAn offline map is a map area and its data content downloaded from an offline-enabled web map for use in offline applications built with ArcGIS Maps SDKs for Native Apps.Learn more, any edits to be synchronized, or update packages to be received (ahead of time only). Follow the instructions here:

In the ArcGIS Enterprise help, see Prepare data for offline use in the ArcGIS Server documentation.
In the ArcGIS Online help, see Manage settings for editing.

Vector tile services and map tile services

If you want tile service data to be downloaded with the offline mapAn offline map is a map area and its data content downloaded from an offline-enabled web map for use in offline applications built with ArcGIS Maps SDKs for Native Apps.Learn more, you must ensure that the tiled serviceA service, also known as an ArcGIS service, is software that supports an ArcGIS REST API and provides geospatial functionality or data. A service can be hosted by Esri or in ArcGIS Enterprise.Learn more has the exportTiles capability enabled. For more information, see the ArcGIS REST API documentation for Vector tile service - Export Tiles and Map service - Export Tiles. To enable this capability, follow these instructions: