TGIS_LayerWebTiles class

DK for Java | tatukgis.jdk.TGIS_LayerWebTiles | Classes | Constructors | Fields | Methods | Properties | Events

Encapsulation of tiled image layer (usually web tiles).

Available also on: Delphi | .NET | ActiveX | Python.

// Java
public class TGIS_LayerWebTiles extends TGIS_LayerPixel {
};

// Oxygene
type
  TGIS_LayerWebTiles = public class( TGIS_LayerPixel )
  end;

→ TGIS_BaseObjectDisposable → TGIS_LayerAbstract → TGIS_Layer → TGIS_LayerPixel

This layer can be opened by opening the file name_of_layer.ttkwp or embedding all parameters to Path property as CRLF or 'n' delimited string. The structure of this file must be:

[TatukGIS Layer]
Storage=WEBTILES
Name=layer name
Caption=layer caption
Url1=server url
...

Parameters:

Url1=http://my-server/{level}/{col}/{row}.{ext}

URL Variables:

To define proxy settings use GisSetProxySettings method.

By embedding <#password#> string into the url PasswordEvent will be activated and value will be filled with provided user credentials.
For example:

Url1=http://myserver.domain.com/tiles/1.0.0/osm/{level}/{col}/{row}.{ext}?token=<#my_user_token#>

For basic authentication add User and Pass parameters to configuration.

Available metadata keys :

For example:

[TatukGIS Layer]
Storage=WEBTILES
Type=TMS
name=tatukgis_osm
Caption=TatukGIS OpenStreetMaps Tiles (Test)
Url1=http://test1.tileservers.tatukgis.com/osm/
Url2=http://test2.tileservers.tatukgis.com/osm/
Url3=http://test3.tileservers.tatukgis.com/osm/
Url4=http://test4.tileservers.tatukgis.com/osm/
Format=png
Copyright=(c) OpenStreetMap contributors, CC-BY-SA.

For example (as custom format):

[TatukGIS Layer]
Storage=WEBTILES
name=tatukgis_osm
Caption=TatukGIS OpenStreetMaps Tiles (Test)
Url1=http://test1.tileservers.tatukgis.com/osm/{level}/{col}/{row}.{ext}
Url2=http://test2.tileservers.tatukgis.com/osm/{level}/{col}/{row}.{ext}
Url3=http://test3.tileservers.tatukgis.com/osm/{level}/{col}/{row}.{ext}
Url4=http://test4.tileservers.tatukgis.com/osm/{level}/{col}/{row}.{ext}
Format=png
Copyright=(c) OpenStreetMap contributors, CC-BY-SA.

Example of accessing non-tiled server:

[TatukGIS Layer]
Storage=WEBTILES
Type=CUSTOM
Name=arcgis_rest
Caption=ArcGIS SampleServer REST
Url1=http://sampleserver1.arcgisonline.com/ArcGIS/rest/services/Specialty/ESRI_StateCityHighway_USA/MapServer/export?bbox={XMIN}%2C{YMIN}%2C{XMAX}%2C{YMAX}&bboxSR={epsg}&layers=&layerdefs=&size={WIDTH}%2C{HEIGHT}&imageSR={epsg}&format={ext}&transparent=true&dpi=&time=&layerTimeOptions=&f=image
Format=png
Epsg=4326
XMin=-127.8
YMin=15.4
XMax=-63.5
YMax=60.5
TileWidth=0
TileHeight=0
Copyright=http://www.esri.com/legal/licensing/termsofuse.html

Example of accessing MBTILES Sqlite file with raster:

[TatukGIS Layer]
Storage=WEBTILES
Type=MBTILES
name=satellite
Caption=satellite
Url1=satellite.mbtiles
Space=WORLDMERCATOR
Format=PNG

Example of accessing MBTILES Sqlite file with vector:

[TatukGIS Layer]
Storage=WEBTILES
Type=MBTILES
name=Zoomstack
Caption=Zoomstack
Url1=OS_Open_Zoomstack.mbtiles
Space=WORLDMERCATOR
Format=PBF
Style=url or path to json style

Example of accessing Vector tile services :

• Esri (based on Esri Vector Basemaps)

[TatukGIS Layer]
Storage=WEBTILES
Type=CUSTOM
Name=World_Basemap_v2
Caption=World Basemap
Url1=https://basemaps.arcgis.com/arcgis/rest/services/World_Basemap_v2/VectorTileServer/tile/{level}/{row}/{col}.{ext}
Format=pbf
Style=url or path to json style
TileWidth=512
TileHeight=512
Copyright=Esri

• MapBox (requires public access token from https://account.mapbox.com)

[TatukGIS Layer]
Storage=WEBTILES
Type=CUSTOM
Name=World_Basemap_v2
Caption=World Basemap
Url1=http://a.tiles.mapbox.com/v4/mapbox.mapbox-streets-v8/{level}/{col}/{row}.{ext}?access_token=INSERT_ACCESS_TOKEN_HERE
Style=INSERT_url_or_path_to_json_style
StylePassword=?access_token=INSERT_ACCESS_TOKEN_HERE
Format=mvt
TileWidth=512
TileHeight=512
Copyright=Mapbox.com