Wolfram Language & System 11.0 (2016)|Legacy Documentation

This is documentation for an earlier version of the Wolfram Language.View current documentation (Version 11.2)

GeoServer

GeoServer
is an option for GeoGraphics and GeoStyling that specifies the URL address of a geo server and connection parameters to download map tiles and geo elevation data.

DetailsDetails

  • A geo server specification is given as a list {template,opt1val1,opt2val2,}, where template is either a URL string or a TemplateObject as returned by StringTemplate.
  • GeoServer{Automatic,opt1->val1,opt2->val2,} uses a template for the Wolfram geo server.
  • GeoServerAutomatic uses a template for the Wolfram geo server and default values for all connection parameters.
  • The URL template for tile download uses the XYZ protocol and must be given as a string "http:///`1`/`2`/`3`.png" or as StringTemplate["http:///`1`/`2`/`3`.png"], for example, where the slots `1`, `2`, and `3` correspond to integer zoom and x, y integer coordinates of the requested tile, respectively.
  • Options can be grouped in areas of the form area->{opt1->val1,opt2->val2,}. Possible areas are "Tileset", "Connection", and "Storage".
  • The "Tileset" area describes properties of the tiles being downloaded and includes:
  • "Projection""Mercator"projection used by the tiles
    "TileDataType""PNG"image file type of the tiles
    "TilesetOrientation"-1y direction of increase of tile numbers
    "TileSize"256image size of each tile
    "ZoomRange"{1,18}available range of zooms
    "ZoomShift"0zoom 1 has 512 2shift pixels in the axis
  • The "Connection" area describes how to connect to the geo server and includes all options of URLFetch plus these additional parameters:
  • "ConnectionMethod"URLFetchAsynchronousfunction used to download tiles
    "ConnectionRetryCount"1number of times to retry when a download fails
    "GlobalTimeout"30timeout in seconds for the download of all tiles
    "MaxConcurrentConnections"20maximum number of simultaneous asynchronous downloads
    "MaxServedTileCount"1024maximum number of tiles served for a map
  • The "ConnectionMethod" parameter can be URLFetch, URLFetchAsynchronous, or URLSaveAsynchronous.
  • The "Storage" area describes how to locally cache the tiles downloaded and includes:
  • "CacheDuration"86400maximum time in seconds for tile caching in a session

ExamplesExamplesopen allclose all

Basic Examples  (2)Basic Examples  (2)

Use the Wolfram geo server to download map tiles:

In[1]:=
Click for copyable input
Out[1]=

Use an alternative tile server:

In[2]:=
Click for copyable input
Out[2]=

Use different geo servers in different parts of a map:

In[1]:=
Click for copyable input
Out[1]=
Introduced in 2015
(10.1)