====== GIS Layer Configuration ======

===== ArcGIS =====
  * Create a Layer group named "ArcGIS" under "Global Imagery", set Children to "inclusive"
  * Add the following layers to the "ArcGIS" group each without a layer file, set type to "Imagery", set Layer Class to "Map", set Driver to "ArcGIS" and set URL to one of the
    * Satellite: [[https://services.arcgisonline.com/ArcGIS/rest/services/World_Imagery/MapServer]] 
        * Layer Class: "Map"
    * Transport: [[https://services.arcgisonline.com/ArcGIS/rest/services/Reference/World_Transportation/MapServer]] 
        * Layer Class "Traffic"
    * Places: [[https://services.arcgisonline.com/ArcGIS/rest/services/Reference/World_Boundaries_and_Places_Alternate/MapServer]] 
        * Layer Class "Places/POI"
    * Traffic: [[https://utility.arcgis.com/usrsvcs/servers/68aa64f21c5a4b0488b2c29b3c6042bc/rest/services/World/Traffic/MapServer]] 
        * Layer Class "Traffic"
  * Keep all other properties as default


===== OpenStreetMap =====
A list of available tile servers for [[https://www.openstreetmap.org|OpenStreeMap]] can be found [[https://wiki.openstreetmap.org/wiki/Tile_servers|here]]. More tile servers and URLs can also be found [[https://www.xyht.com/spatial-itgis/using-openstreetmap-basemaps-qgis-3-0/]].

It's also possible to set up and run an on premise [[terra4d:osmserver|OSM tile server]].

  * Add a new layer to the configuration under the group "Global Imagery"
  * Set type to "Imagery"
  * Select driver "XYZ"
  * set URL to ''https://[abc].tile.openstreetmap.org/${z}/${x}/${y}.png''
  * Set "CacheId" to "osm_map"
  * Keep profile to "spherical-mercator"
  * Set "Gamma correction" to "0.3"

URL with alternative styles:
  * ÖPNVKarte: ''https://tile.memomaps.de/tilegen/{z}/{x}/{y}.png''
  * Carto Light: ''https://cartodb-basemaps-[abc].global.ssl.fastly.net/light_all/{z}/{x}/{y}.png''
  * Carto Dark: ''https://cartodb-basemaps-[abc].global.ssl.fastly.net/dark_all/{z}/{x}/{y}.png''

The list of tile map server on [[https://wiki.openstreetmap.org/wiki/Tile_servers]] has also some "useful" overlay map layers (e.g. transport or sea markers). If parameter ''{s]'' can usually be replace with a ''[abc]'' (this is used for server rotation and load balancing).

  * Create a XYZ image layer and set the URL to one listed in the table (e.g. ''http://tile.memomaps.de/tilegen/${z}/${x}/${y}.png'')
  * Keep profile to "spherical-mercator"
  * If the layer appears too bright, then decrease the gamma correction value.

A list of available tile server can be found [[https://wiki.openstreetmap.org/wiki/Raster_tile_providers]]. Some of the listed servers require a paid subscription and some might no longer be operational.

===== OpenCycleMap =====
  * Add a new layer to the configuration under the group "Global Imagery"
  * Set type to "Imagery"
  * Select driver "XYZ"
  * set URL to ''http://tile.thunderforest.com/cycle/${z}/${x}/${y}.png''
  * Keep profile to "spherical-mercator"
  * Set "CacheId" to "osm_cycle"
  * Set "Gamma correction" to "0.3"

===== OpenSeaMap =====
  * Add a new layer to the configuration under the group "Global Imagery"
  * Set type to "Imagery"
  * Select driver "XYZ"
  * set URL to ''https://tiles.openseamap.org/seamark/${z}/${x}/${y}.png''
  * Keep profile to "spherical-mercator"
  * Set "CacheId" to "openseamap"
  * Set "Gamma correction" to "0.3"

===== Bing =====
  * Add a new layer to the configuration under the group "Global Imagery"
  * Set type to "Imagery"
  * Select driver "Bing"
  * Enter an API key; without an API key the requests for the GIS data is denied by the server.
  * Set Imagery set to one of the following:
    * Aerial: Aerial imagery.
    * AerialWithLabels: Aerial imagery with a road overlay.
    * AerialWithLabelsOnDemand: Aerial imagery with on-demand road overlay.
    * CanvasDark: A dark version of the road maps.
    * CanvasLight: A lighter version of the road maps which also has some of the details such as hill shading disabled.
    * CanvasGray: A grayscale version of the road maps.
    * Road: Roads without additional imagery.
    * Streetside: Street-level Imagery.
  * Use "AerialWithLabels" to get satellite imagery with labels for places, roads, etc.

===== WMS =====
  * See [[terra4d:geoserver#show_geoserver_layers_in_terra|GeoServer]]

===== MapTiler =====
  * Add a new layer to the configuration under the group "Global Imagery"
  * Set type to "Imagery"
  * Select driver "XYZ"
  * set URL to ''http://your-server:3650/api/tiles/your_map_id/${z}/${x}/${y}''; with "maptiler-satellite-lowres" as an example for your_map_id
  * Set image format to "image/jpeg" for JPEG tiles or "image/png" for PNG tiles
  * Keep profile to "spherical-mercator" (this must match the profile as seen in MapTiler; if you see "mercator" in MapTiler, please use "spherical-mercator" in Terra4D)
  * NOTE: The WebP image format is not supported by Terra4D

If you want you use the Web Map Service with MapTiler see [[terra4d:geoserver#show_geoserver_layers_in_terra|GeoServer]]