Tile System API

advanced scripting

World Map Globe Edition · Scripting Support (C#)

Class: All members on this page belong to WorldMapGlobe (namespace WPM). Access via WorldMapGlobe.instance.

Tile System Properties

The tile system overlays map tiles from online providers (OpenStreetMap, Bing Maps, etc.) onto the globe surface.

bool showTiles { get; set; }

Enable or disable the tile system.

bool tileTransparentLayer { get; set; }

Blend tiles with the underlying globe texture.

Color tileBackgroundColor { get; set; }

Background color for tiles that haven't loaded yet.

float tileMaxAlpha { get; set; }

Maximum tile transparency (0-1).

float tileFadeDuration { get; set; }

Tile fade-in animation duration (0-2 seconds).

Download Settings

int tileDownloadTimeout { get; set; }

Download timeout in seconds.

int tileMaxConcurrentDownloads { get; set; }

Maximum parallel tile downloads.

int tileMaxTileLoadsPerFrame { get; set; }

Maximum tiles to process per frame.

bool tileUseSecureConnection { get; set; }

Use HTTPS for tile downloads.

Caching

bool tileEnableLocalCache { get; set; }

Cache downloaded tiles on disk.

long tileMaxLocalCacheSize { get; set; }

Maximum local cache size in megabytes.

Offline Tiles

bool tileEnableOfflineTiles { get; set; }

Enable loading tiles from a local source.

OFFLINE_TILES_SOURCE_TYPE tileOfflineTilesSourceType { get; set; }

Source type for offline tiles (Resources, StreamingAssets, etc.).

string tileOfflineTilesPath { get; set; }

Path to offline tile files.

bool tileOfflineTilesOnly { get; set; }

Use only offline tiles (no internet downloads).

Advanced

bool tilePreciseRotation { get; set; }

Switch to camera-based rotation at high zoom levels for better tile alignment.

int tilePreciseRotationZoomLevel { get; set; }

Zoom level threshold for precise rotation mode.

bool tilePreloadTiles { get; set; }

Preload all visible tiles on startup.

bool tilesUnloadInactiveTiles { get; set; }

Unload tiles that are no longer visible to save memory.

bool tilesShowDebugInfo { get; set; }

Display debug information on tiles.

bool tileDebugErrors { get; set; }

Log tile download errors to the console.

Tile Server Methods

TILE_SERVER tileServer { get; set; }

The active tile server (OpenStreetMap, Bing Maps, etc.). Setting the property switches provider and refreshes visible tiles.

void SetTileServer(TILE_SERVER server, bool quickUpdate = false)

Switches the tile server. Pass quickUpdate = true to defer the visible-tiles refresh to the next frame (useful when batching multiple settings).

void SetTileServerCustomUrl(string url, bool quickUpdate = false)

Switches to a custom tile server using the supplied URL template. Use placeholders {0} (zoom), {1} (x), {2} (y) - e.g. https://my.tiles/{0}/{1}/{2}.png.

string GetTileServerCopyrightNotice(TILE_SERVER server)

Returns the copyright notice for the tile provider so you can render it on screen as required by the provider's terms of use.

void PurgeTileCache()

Deletes every cached tile from disk. Use after switching providers if you want a clean re-download.

Tile Events

OnTileRequest, OnTileURLRequest, OnTileCreated, OnTileRecomputed, OnTileBecameVisible and OnTileBecameInvisible are documented on the dedicated Events page with their delegate signatures.

Was this page helpful?