Property ReferenceBasemapDirectory
ReferenceBasemapDirectory
Gets or sets the path to a directory on the device where the local basemap file is located.
Declaration
public string ReferenceBasemapDirectory { get; set; }Property Value
| Type | Description |
|---|---|
| System.String | The path to a directory on the device where the local basemap file is located. |
Remarks
Set this property to use a basemap which is already on the device (rather than downloading it). The directory should only be set when ReferenceBasemapFilename is defined.
This property supports any directory specified as either:
- An absolute path.
- A path relative to the parent directory of the generated mobile map package (see downloadPath for DownloadPreplannedOfflineMap(DownloadPreplannedOfflineMapParameters, String).
If the directory does not exist, or does not contain the specified basemap, the DownloadPreplannedOfflineMapJob will fail.
Note that, the mobile map package will store either a relative or absolute path to the reference basemap file so that it can be opened in the future.
A relative path typically begins with "." to denote the parent directory of the resulting mobile map package or ".." to move up one directory. The parent directory of the mobile map package will be set when calling GenerateOfflineMap(GenerateOfflineMapParameters, String).
For example, to download a mobile map package to "[my root path]/my_offline_maps/my_mobile_map_package", which uses a reference basemap in "[my root path]/other_maps/my_basemap.tpk", you would set the relative path as follows:
- DownloadDirectoryPath to "[my root path]/my_offline_maps/my_mobile_map_package"
- ReferenceBasemapDirectory to "../other_maps"
- ReferenceBasemapFilename to "my_basemap.tpk"
Note that, this property is ignored if
IncludeBasemap is false.
Applies to
Platforms and versions
| Target | Versions |
|---|---|
| .NET Standard 2.0 | 100.5 - 200.5 |
| .NET | 100.13 - 200.5 |
| .NET Windows | 100.13 - 200.5 |
| .NET Android | 200.0 - 200.5 |
| .NET iOS | 200.0 - 200.5 |
| .NET Framework | 100.5 - 200.5 |
| Xamarin.Android | 100.5 - 100.15 |
| Xamarin.iOS | 100.5 - 100.15 |
| UWP | 100.5 - 200.5 |