// XAML Map Control - https://github.com/ClemensFischer/XAML-Map-Control
// Copyright © 2024 Clemens Fischer
// Licensed under the Microsoft Public License (Ms-PL)
using System;
using System.Threading.Tasks;
#if WINUI
using Microsoft.UI.Xaml.Media;
#elif UWP
using Windows.UI.Xaml.Media;
#else
using System.Windows.Media;
#endif
namespace MapControl
{
///
/// Provides the download Uri or ImageSource of map tiles.
///
#if !UWP
[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 (Subdomains == null && uriTemplate != null && uriTemplate.Contains("{s}"))
{
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 column, int row, int zoomLevel)
{
Uri uri = null;
if (UriTemplate != null && column >= 0 && row >= 0 && zoomLevel >= 0)
{
var uriString = UriTemplate
.Replace("{x}", column.ToString())
.Replace("{y}", row.ToString())
.Replace("{z}", zoomLevel.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(column, row, zoomLevel).
/// This method is called by a TileImageLoader that does not perform caching.
///
public virtual Task LoadImageAsync(int column, int row, int zoomLevel)
{
var uri = GetUri(column, row, zoomLevel);
return uri != null ? ImageLoader.LoadImageAsync(uri) : Task.FromResult((ImageSource)null);
}
}
public class TmsTileSource : TileSource
{
public override Uri GetUri(int column, int row, int zoomLevel)
{
return base.GetUri(column, (1 << zoomLevel) - 1 - row, zoomLevel);
}
}
}