Enum TileProvider

Namespace

LansMap.Core.Tiles.Sources

The built-in tile provider presets. Pick one and supply an API key where the provider requires it, or use Custom for any other XYZ service.

public enum TileProvider

Fields

CartoDark = 7

CARTO Dark Matter, a dark low-contrast basemap. No key. Serves 512 px @2x and has a label-free variant. Max zoom 20.

CartoLight = 6

CARTO Positron, a light low-contrast basemap. No key. Serves 512 px @2x and has a label-free variant. Max zoom 20.

CartoVoyager = 8

CARTO Voyager, a colorful general basemap. No key. Serves 512 px @2x and has a label-free variant. Max zoom 20.

Custom = 30

Any other XYZ service, from a url template you supply.

Put the API key in the template as {key}, never inline: the disk cache is namespaced on the raw template, so an inline key becomes part of the cache identity and rotating it orphans every cached tile. Attribution is mandatory and must be supplied too.

CyclOsm = 19

CyclOSM, a cycling-oriented OSM style. No key. Community server. Max zoom 20.

EsriDarkGray = 14

Esri Dark Gray Canvas, a minimal label-free dark base. Key optional. Max zoom 19.

EsriHillshade = 15

Esri shaded relief. Key optional. Max zoom 19. Intended over another base rather than alone.

EsriLightGray = 13

Esri Light Gray Canvas, a minimal label-free light base. Key optional. Max zoom 19. Pair with upright place labels for a clean hybrid look.

EsriNatGeo = 11

Esri National Geographic style. Key optional. Max zoom 19.

EsriOceanBasemap = 12

Esri Ocean Basemap, bathymetry. Key optional. Max zoom 18.

EsriWorldImagery = 4

Esri World Imagery, satellite. Key optional. Max zoom 19.

EsriWorldStreetMap = 9

Esri World Street Map. Key optional. Max zoom 19.

EsriWorldTopoMap = 10

Esri World Topo Map. Key optional. Max zoom 19.

Geoapify = 21

Geoapify. Key required. Serves 512 px @2x. Max zoom 20.

HereMaps = 24

HERE Maps. Key required. Serves 512 px @2x. Max zoom 20.

Jawg = 22

Jawg Maps. Key required. Serves 512 px @2x. Max zoom 22.

LocationIq = 25

LocationIQ. Key required. Max zoom 18.

MapTiler = 1

MapTiler. Key required. Serves 512 px @2x. Max zoom 22.

Mapbox = 20

Mapbox. Key required. Native 512 px tiles. Max zoom 22.

None = 31

No provider configured. This is the shipped default: the map renders nothing, contacts no server, and logs an error naming the field to set.

Check TileSourcePresets.IsConfigured before building a pipeline; TileSourcePresets.Create throws for this value rather than inventing a url. Appended so existing scenes keep their stored provider.

OpenRailwayMap = 27

OpenRailwayMap. No key. TRANSPARENT OVERLAY. Max zoom 19.

OpenSeaMapSeamarks = 26

OpenSeaMap nautical marks. No key. TRANSPARENT OVERLAY - use it as the overlay layer over a base map, not on its own. Max zoom 18.

OpenStreetMap = 0

OpenStreetMap's public tile servers, and the default. No key. Included for testing and evaluation; for production or sustained use choose a provider appropriate for your application and comply with its terms. The OSMF tile usage policy prohibits heavy use and bulk downloading and draws no development/production line. Max native zoom 19.

OpenTopoMap = 5

OpenTopoMap, topographic. No key. Community server - max zoom 17, the shallowest of the base maps here.

OsmHot = 18

Humanitarian OSM style, run by the OSM France community. No key. Community-funded server. Its terms carry an abuse-and-blocking clause but no request-volume limit and no number, so it runs at the one default concurrency like every uncited preset. Max zoom 20.

Registered = 32

A provider supplied by your own code rather than by a preset here. Register it once with TileProviderRegistry.Register and name its id in the map's Registered Provider Id field.

There is no preset behind this member, so TileSourcePresets.Create refuses it and the single-argument TileSourcePresets.IsConfigured reports false: only the id, resolved against the registry, can say whether this map is configured. Appended after None for the same reason None was appended after Custom - scenes store the index.

StadiaMaps = 2

Stadia Maps, including the Stamen styles (toner, terrain, watercolor). Key required. Serves 512 px @2x. Max zoom 20.

Thunderforest = 3

Thunderforest, outdoor and cycling styles. Key required. Max zoom 22.

TomTom = 23

TomTom. Key required. Max zoom 22.

UsgsImagery = 17

USGS aerial imagery. No key. UNITED STATES COVERAGE ONLY - blank elsewhere. Max zoom 16.

UsgsTopo = 16

USGS topographic. No key. UNITED STATES COVERAGE ONLY - blank elsewhere. Max zoom 16.

WaymarkedCycling = 29

Waymarked Trails cycling routes. No key. TRANSPARENT OVERLAY. Max zoom 18.

WaymarkedHiking = 28

Waymarked Trails hiking routes. No key. TRANSPARENT OVERLAY. Max zoom 18.

Remarks

LansMap runs no tile service of its own. The default is OpenStreetMap so a fresh scene renders for evaluation, which means the asset contacts OSM as soon as it runs unless a provider is chosen. "No key required" below means the endpoint answers without one, not that the provider's terms permit production use - that is the developer's responsibility, and the inspector shows a per-provider usage note. Attribution is mandatory for every provider here.

Append only. Scenes serialize the enum index, so inserting a member would silently repoint every stored provider by one.