Electronic navigational charts (ENCs) are georeferenced vector datasets for the visualization and analysis of hydrographic and maritime information. ArcGIS Runtime supports ENCs that conform to the International Hydrographic Organization (IHO) S-57 standard.
Use ENCs in your ArcGIS Runtime apps to:
- Visualize S-57 data in compliance with S-52 standards and specifications for chart content display.
- Use S-57 data as an additional data source for situational awareness and decision making.
- Combine S-57 datasets with other sources of information for geospatial analysis.
- Access ENCs encrypted conforming to the S-63 IHO Data Protection Scheme.
Get started
ENC functionality in runtime is accessed via the Esri.
NuGet package. The NuGet package will ensure that all binaries and resources required by runtime for ENC functionality are deployed to your application’s output folder.
Understand electronic navigational charts (ENCs)
An ENC cell represents a navigational chart of a rectangular geographic area at a particular scale. Cells are bounded by meridians and parallels, though the actual area of coverage contained in the cell may be any shape. All the data in a single cell corresponds to a single navigational use, such as: overview, general, or coastal (a navigational use corresponds to a scale range suitable for a particular use).
Cells are stored in a single base dataset file and zero or more update dataset files. Each dataset file has a unique name. A base dataset file plus its update files (if any) when loaded together comprise the updated geographic data of one cell.
ENC data is distributed in exchange sets, which can contain many cells. On the file system, each exchange set resides in its own folder named ENC
. Each ENC
folder contains a collection of dataset files (*.000
), update files (*.001-*.999
), a catalog file containing metadata about the exchange set (CATALO
), and other optional files with data referenced by the exchange set, such as text and image files.
See S-57 Appendix B for additional details about S-57 ENC exchange sets and their content.
Display an electronic navigational chart
Access an exchange set on the file system using an
EncExchangeSet
object. An exchange set can be loaded using the path to the exchange set's CATALO
file, and optionally the paths to CATALO
files in other exchange sets (in other folders) that contain additional update dataset files. If an exchange set that only contains update dataset files is one of those specified, then the exchange set with the corresponding base dataset files must be loaded simultaneously. See the Work with updates section for more information.
EncDataset
objects represent datasets. Each
EncDataset
contains the base data for a cell and any updates that were also loaded when the exchange set was loaded, and provides access to metadata about the cell. Retrieve a collection of
EncDataset
objects contained in an
EncExchangeSet
using the Datasets
property.
ENC cells (individual charts) are represented by
EncCell
objects. You can construct these objects in two ways:
- From a dataset represented by an
EncDataset
object. This approach will include the base dataset file and all corresponding update dataset files. This is the preferred approach. - From a base dataset file. This approach will only include the base dataset file, and not any corresponding update dataset files. This is not a typical use case.
Display an ENC cell by constructing an
EncLayer
object from an
EncCell
object.
EncLayer
is derived from
Layer
, so you add an
EncLayer
to a map like you do other layers.
You can add all the charts in the exchange set by iterating through the exchange set's datasets, creating an
EncCell
for each, creating an
EncLayer
for each
EncCell
, and adding each
EncLayer
to the map.
EncExchangeSet encExchangeSet = new EncExchangeSet(encPath);
await encExchangeSet.LoadAsync();
List<Envelope> dataSetExtents = new List<Envelope>();
foreach (EncDataset encDataset in encExchangeSet.Datasets)
{
EncLayer encLayer = new EncLayer(new EncCell(encDataset));
await encLayer.LoadAsync();
dataSetExtents.Add(encLayer.FullExtent);
MyMapView.Map.OperationalLayers.Add(encLayer);
}
// Set the map viewpoint with the full extent of the ENC Exchange Set.
Envelope fullExtent = GeometryEngine.CombineExtents(dataSetExtents);
await MyMapView.SetViewpointAsync(new Viewpoint(fullExtent));
Work with updates
ENC charts are often distributed as base cells (.000 files) with one or more update cells (.001, .002, etc. files). An exchange set can consist exclusively of update cells; in order to load an update exchange set, the path to the base exchange set must be provided along with the path to the update exchange set.
EncExchangeSet exchangeSet = new EncExchangeSet(new string[] { @"path\to\update", @"path\to\original" });
When loading an ENC cell, it is important to use the dataset-based constructor. If updates for a cell are part of an exchange set, they will only be found by the runtime when the dataset-based constructor is used. Loading the cell from a path will not load any associated updates.
Set ENC environment settings
ENC layers are displayed in accordance with the IHO S-52 standard. You can define the display properties of your ENC layers by using the static
EncEnvironmentSettings
class. These settings apply to all ENC layers in all maps. Settings fall under three categories: mariner settings, text group visibility settings, and viewing group settings. Text group settings control the display of labels for features, mariner settings control the symbolization and presentation of ENC features, and viewing group settings allow for quickly applying settings to logical groups of feature types.
// Enables display of seabed information for all ENC layers
EncEnvironmentSettings.Default.DisplaySettings.TextGroupVisibilitySettings.NatureOfSeabed = true;
ArcGIS Runtime’s ENC implementation works with ENC content via compiled SENC files. SENC is an acronym for System Electronic Navigational Chart. After an ENC cell has been loaded, all future loads of that cell will reference the underlying SENC file directly. You can use the environment settings to find or set the location where SENC files are stored.
Identify and select ENC features
ENC layers support identify through the common geoview feature identification mechanism, which takes a screen point and tolerance in pixels. Identify will return a collection of result objects, one per matching layer. For ENC layers, the results will have a Geo
property, which provides a collection of
EncFeature
objects.
Once a feature has been identified, you can call Select
on the layer that contains the feature to select it.
// Perform the identify operation
IReadOnlyList<IdentifyLayerResult> results = await MyMapView.IdentifyLayersAsync(e.Position, 5, false);
// Return if there are no results
if (results.Count < 1) { return; }
// Take action on each identified ENC feature
foreach (IdentifyLayerResult result in results)
{
foreach (EncFeature feature in result.GeoElements)
{
// Get the layer associated with this set of results
EncLayer containingLayer = (EncLayer)result.LayerContent;
// Select the feature
containingLayer.SelectFeature(feature);
}
}
Access encrypted ENCs
ArcGIS Runtime SDK for .NET supports use of encrypted ENC datasets (IHO S-63) in applications developed for WPF.
To request access to this functionality, send an email to: ArcGISRuntimeS63@esri.com.
Performance considerations
ArcGIS Runtime works with ENC content via internal SENC files. When an ENC cell is loaded, an SENC representation is generated. Subsequent loads only read the generated SENC files. When developing ArcGIS Runtime apps for working with ENC content, understand that:
-
The SENC data path must be set before attempting to read ENC content.
- On .NET platforms, this is set to a temporary directory by default. The default directory may not be suitable for production use in the context of implementing an Electronic Chart Display and Information System (ECDIS).
-
SENC files are device and version specific. These files should not be exposed to users, backed up, or shared between devices. The SENC format is internal to ArcGIS Runtime and may change between versions of ArcGIS Runtime. Therefore, SENC files created by an app built with one version of ArcGIS Runtime are not guaranteed to work with apps built with another version of ArcGIS Runtime, even on the same device.
- On iOS, consider setting the SENC path to a subdirectory of the documents directory that is excluded from iCloud and iTunes backup. See Apple Technical QA QA1719 for more information about excluding iOS directories from backup.
- See the Android Developers topic for more information about excluding directories from backup on Android.
-
SENC files take time to generate, this will delay the loading of new ENC cells. It may take a long time to load large ENC exchange sets consisting of many cells (potentially hours). Never block the UI when loading these files.
-
Because the initial load of an ENC cell (before the SENC files have been generated) can take some time to complete, consider pre-loading them to ensure availability before depending on them for navigation.
-
Do not attempt to read or manipulate SENC files. Changes to generated SENC files will invalidate them, requiring ArcGIS Runtime to re-generate them the next time the corresponding cells are loaded.