OxyPlot.Core.Cartography 2.1.0.2

.NET 6.0
dotnet add package OxyPlot.Core.Cartography --version 2.1.0.2
NuGet\Install-Package OxyPlot.Core.Cartography -Version 2.1.0.2
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.
<PackageReference Include="OxyPlot.Core.Cartography" Version="2.1.0.2" />
For projects that support PackageReference, copy this XML node into the project file to reference the package.
paket add OxyPlot.Core.Cartography --version 2.1.0.2
#r "nuget: OxyPlot.Core.Cartography, 2.1.0.2"
#r directive can be used in F# Interactive, C# scripting and .NET Interactive. Copy this into the interactive tool or source code of the script to reference the package.
// Install OxyPlot.Core.Cartography as a Cake Addin
#addin nuget:?package=OxyPlot.Core.Cartography&version=2.1.0.2

// Install OxyPlot.Core.Cartography as a Cake Tool
#tool nuget:?package=OxyPlot.Core.Cartography&version=2.1.0.2

OxyPlot.Cartography

example-openstreetmap

Usage

See the SimpleDemo for more details. The below example is implemented using Avalonia, but it will be very similar for other platforms.

var model = new PlotModel
{
	IsLegendVisible = true,
	PlotType = PlotType.Cartesian
};

model.Legends.Add(new Legend
{
	LegendPlacement = LegendPlacement.Inside,
	LegendPosition = LegendPosition.RightTop,
	LegendBackground = OxyColor.FromAColor(200, OxyColors.White),
	LegendBorder = OxyColors.Black,
});

model.Axes.Add(new LongitudeAxis
{
	Position = AxisPosition.Bottom,
	Minimum = -0.24,
	Maximum = 0.04,
	Title = "Longitude",
});

model.Axes.Add(new LatitudeWebMercatorAxis
{
	Position = AxisPosition.Left,
	Minimum = 51.42,
	Maximum = 51.62,
	Title = "Latitude"
});

var tileMapImageProvider = new HttpTileMapImageProvider(SynchronizationContext.Current)
{
	Url = "https://server.arcgisonline.com/arcgis/rest/services/World_Imagery/MapServer/tile/{Z}/{Y}/{X}",
	MaxNumberOfDownloads = 2,
	UserAgent = "OxyPlot.Cartography",
	ImageConverter = new Func<byte[], byte[]>(input =>
	{
		// Only convert if file format is Jpeg
		if (input.Length >= 2 && input[0] == 0xFF && input[1] == 0xD8)
		{
			using (var msInput = new MemoryStream(input))
			using (var msOutput = new MemoryStream())
			{
				var bitmap = Bitmap.DecodeToWidth(msInput, 256);
				bitmap.Save(msOutput);
				return msOutput.ToArray();
			}
		}
		return input;
	})
};

var loadingImg = new Uri("avares://SimpleDemo/Assets/live-view.png");
var asset = AvaloniaLocator.Current.GetService<IAssetLoader>();
using (var streamImg = asset.Open(loadingImg))
{
	// Add the tile map annotation
	model.Annotations.Add(new MapTileAnnotation(streamImg, tileMapImageProvider)
	{
		CopyrightNotice = "OpenStreetMap",
		MinZoomLevel = 0,
		MaxZoomLevel = 19, // max OpenStreetMap value
		IsTileGridVisible = true,
		TileGridThickness = 3
	});
}

Map Tiles

MapTileAnnotation

example-arcgisonline-sat

Usage
model.Annotations.Add(new MapTileAnnotation(streamImg, tileMapImageProvider)
{
	CopyrightNotice = "OpenStreetMap",
	MinZoomLevel = 0,
	MaxZoomLevel = 19, // max OpenStreetMap value
	IsTileGridVisible = true,
	TileGridThickness = 3
});
Setting a tile loading image

loading_images

Usage (Avalonia)
var loadingImg = new Uri("avares://SimpleDemo/Assets/live-view.png");
var asset = AvaloniaLocator.Current.GetService<IAssetLoader>();
using (var streamImg = asset.Open(loadingImg))
{
	// Add the tile map annotation
	model.Annotations.Add(new MapTileAnnotation(streamImg, tileMapImageProvider)
	{
		CopyrightNotice = "OpenStreetMap",
		MinZoomLevel = 0,
		MaxZoomLevel = 19, // max OpenStreetMap value
		IsTileGridVisible = true,
		TileGridThickness = 3
	});
}

Axis

LatitudeWebMercatorAxis

Map tiles are rendered as true squares, axis is not linear. You can use it in combination with LongitudeAxis, which is basically a LinearAxis.

Spherical Pseudo-Mercator projection<br> Most of OSM, including the main tiling system, uses a Pseudo-Mercator projection where the Earth is modelized as if it was a perfect a sphere. Combined with the zoom level, the system is known as a Web Mercator on Wikipedia.<br> This produces a fast approximation to the truer, but heavier elliptical projection, where the Earth would be projected on a more accurate ellipsoid (flattened on poles). As a consequence, direct mesurements of distances in this projection will be approximative, except on the Equator, and the aspect ratios on the rendered map for true squares measured on the surface on Earth will slightly change with latitude and angles not so precisely preserved by this spherical projection. https://wiki.openstreetmap.org/wiki/Mercator example-openstreetmap-latitude-mercator-axis

Usage
model.Axes.Add(new LatitudeWebMercatorAxis
{
	Position = AxisPosition.Left,
	Minimum = 51.42,
	Maximum = 51.62,
	Title = "Latitude"
});
Label formating
Default

e.g. 48.86°N, 02.35°E

Degrees Minutes Seconds (DMS) Coordinates System

e.g. 38°53′23″N, 77°00′32″W

model.Axes.Add(new LongitudeAxis
{
	Position = AxisPosition.Bottom,
	Minimum = -0.24,
	Maximum = 0.04,
	Title = "Longitude",
	LabelFormatter = (decDegrees) => CartographyHelper.DecimalDegreesToDegreesMinutesSeconds(decDegrees, false, 3)
});

model.Axes.Add(new LatitudeWebMercatorAxis
{
	Position = AxisPosition.Left,
	Minimum = 51.42,
	Maximum = 51.62,
	Title = "Latitude",
	LabelFormatter = (decDegrees) => CartographyHelper.DecimalDegreesToDegreesMinutesSeconds(decDegrees, true, 3)
});
Decimal Degrees (DD) Coordinates System

e.g. 38.8897°, -77.0089° or 38.8897,-77.0089

LinearAxis

When using the basic Oxyplot LinearAxis, the map tiles are not rendered as true squares. example-openstreetmap-linear-axis

Data

LocalTileMapImageProvider

Usage
var tileMapImageProvider = new LocalTileMapImageProvider(pathToFolder);

HttpTileMapImageProvider

Usage
var tileMapImageProvider = new HttpTileMapImageProvider(SynchronizationContext.Current)
{
	Url = "https://server.arcgisonline.com/arcgis/rest/services/World_Imagery/MapServer/tile/{Z}/{Y}/{X}",
	MaxNumberOfDownloads = 2,
	UserAgent = "OxyPlot.Cartography"
};

Unsuported image format by OxyPlot (mainly Jpeg)

Usage (Avalonia)
var tileMapImageProvider = new HttpTileMapImageProvider(SynchronizationContext.Current)
{
	Url = "https://server.arcgisonline.com/arcgis/rest/services/World_Imagery/MapServer/tile/{Z}/{Y}/{X}",
	MaxNumberOfDownloads = 2,
	UserAgent = "OxyPlot.Cartography",
	ImageConverter = new Func<byte[], byte[]>(input =>
	{
		// Only convert if file format is Jpeg
		if (input.Length >= 2 && input[0] == 0xFF && input[1] == 0xD8)
		{
			using (var msInput = new MemoryStream(input))
			using (var msOutput = new MemoryStream())
			{
				var bitmap = Bitmap.DecodeToWidth(msInput, 256);
				bitmap.Save(msOutput);
				return msOutput.ToArray();
			}
		}
		return input;
	})
};

Tile Images APIs

References

Product Versions
.NET net6.0 net6.0-android net6.0-ios net6.0-maccatalyst net6.0-macos net6.0-tvos net6.0-windows net7.0 net7.0-android net7.0-ios net7.0-maccatalyst net7.0-macos net7.0-tvos net7.0-windows
Compatible target framework(s)
Additional computed target framework(s)
Learn more about Target Frameworks and .NET Standard.

NuGet packages

This package is not used by any NuGet packages.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last updated
2.1.0.2 141 8/14/2022
2.1.0.1 147 8/13/2022