using System; using System.Threading; using System.Threading.Tasks; #if WPF using System.Windows.Media; #elif UWP using Windows.UI.Xaml.Media; #elif WINUI using Microsoft.UI.Xaml.Media; #endif namespace MapControl { /// /// Provides the download Uri or ImageSource of map tiles. /// #if UWP || WINUI [Windows.Foundation.Metadata.CreateFromString(MethodName = "Parse")] #else [System.ComponentModel.TypeConverter(typeof(TileSourceConverter))] #endif public class TileSource { private string uriTemplate; /// /// Gets or sets the template string for tile request Uris. /// public string UriTemplate { get => uriTemplate; set { uriTemplate = value; if (uriTemplate != null && uriTemplate.Contains("{s}") && Subdomains == null) { Subdomains = new string[] { "a", "b", "c" }; // default OpenStreetMap subdomains } } } /// /// Gets or sets an array of request subdomain names that are replaced for the {s} format specifier. /// public string[] Subdomains { get; set; } /// /// Gets the image Uri for the specified tile indices and zoom level. /// public virtual Uri GetUri(int zoomLevel, int column, int row) { Uri uri = null; if (UriTemplate != null) { var uriString = UriTemplate .Replace("{z}", zoomLevel.ToString()) .Replace("{x}", column.ToString()) .Replace("{y}", row.ToString()); if (Subdomains != null && Subdomains.Length > 0) { uriString = uriString.Replace("{s}", Subdomains[(column + row) % Subdomains.Length]); } uri = new Uri(uriString, UriKind.RelativeOrAbsolute); } return uri; } /// /// Loads a tile ImageSource asynchronously from GetUri(zoomLevel, column, row). /// This method is called by TileImageLoader when caching is disabled. /// public virtual Task LoadImageAsync(int zoomLevel, int column, int row) { var uri = GetUri(zoomLevel, column, row); return uri != null ? ImageLoader.LoadImageAsync(uri) : Task.FromResult((ImageSource)null); } /// /// Loads a tile ImageSource asynchronously from an encoded frame buffer in a byte array. /// This method is called by TileImageLoader when caching is enabled. /// public virtual Task LoadImageAsync(byte[] buffer) { return ImageLoader.LoadImageAsync(buffer); } public override string ToString() { return UriTemplate; } /// /// Creates a TileSource instance from an Uri template string. /// public static TileSource Parse(string uriTemplate) { return new TileSource { UriTemplate = uriTemplate }; } } public class TmsTileSource : TileSource { public override Uri GetUri(int zoomLevel, int column, int row) { return base.GetUri(zoomLevel, column, (1 << zoomLevel) - 1 - row); } } }