mprins / dokuwiki-plugin-openlayersmap

StaticMap.php

Indentation +866 added lines, -866 removed lines

@@ -38,870 +38,870 @@
  */
 class StaticMap {
 
-    // the final output
-    private $tileSize = 256;
-    private $tileInfo = array(
-        // OSM sources
-        'openstreetmap' => array(
-            'txt'  => '(c) OpenStreetMap data/ODbl',
-            'logo' => 'osm_logo.png',
-            'url'  => 'https://tile.openstreetmap.org/{Z}/{X}/{Y}.png'
-        ),
-        // OCM sources
-        'cycle'         => array(
-            'txt'  => '(c) Thunderforest maps',
-            'logo' => 'tf_logo.png',
-            'url'  => 'https://tile.thunderforest.com/cycle/{Z}/{X}/{Y}.png'
-        ),
-        'transport'     => array(
-            'txt'  => '(c) Thunderforest maps',
-            'logo' => 'tf_logo.png',
-            'url'  => 'https://tile.thunderforest.com/transport/{Z}/{X}/{Y}.png'
-        ),
-        'landscape'     => array(
-            'txt'  => '(c) Thunderforest maps',
-            'logo' => 'tf_logo.png',
-            'url'  => 'https://tile.thunderforest.com/landscape/{Z}/{X}/{Y}.png'
-        ),
-        'outdoors'      => array(
-            'txt'  => '(c) Thunderforest maps',
-            'logo' => 'tf_logo.png',
-            'url'  => 'https://tile.thunderforest.com/outdoors/{Z}/{X}/{Y}.png'
-        ),
-        'toner-lite'    => array(
-            'txt'  => 'Stamen tiles',
-            'logo' => 'stamen.png',
-            'url'  => 'https://stamen-tiles.a.ssl.fastly.net/toner/{Z}/{X}/{Y}.png'
-        ),
-        'terrain'       => array(
-            'txt'  => 'Stamen tiles',
-            'logo' => 'stamen.png',
-            'url'  => 'https://stamen-tiles.a.ssl.fastly.net/terrain/{Z}/{X}/{Y}.jpg'
-        )
-        //,
-        // 'piste'=>array(
-        // 'txt'=>'OpenPisteMap tiles',
-        // 'logo'=>'piste_logo.png',
-        // 'url'=>''),
-        // 'sea'=>array(
-        // 'txt'=>'OpenSeaMap tiles',
-        // 'logo'=>'sea_logo.png',
-        // 'url'=>''),
-        // H&B sources
-        //          'hikeandbike' => array (
-        //                  'txt' => 'Hike & Bike Map',
-        //                  'logo' => 'hnb_logo.png',
-        //                  //'url' => 'http://toolserver.org/tiles/hikebike/{Z}/{X}/{Y}.png'
-        //                  //moved to: https://www.toolserver.org/tiles/hikebike/12/2105/1388.png
-        //                  'url' => 'http://c.tiles.wmflabs.org/hikebike/{Z}/{X}/{Y}.png'
-        //          )
-    );
-    private $tileDefaultSrc = 'openstreetmap';
-
-    // set up markers
-    private $markerPrototypes = array(
-        // found at http://www.mapito.net/map-marker-icons.html
-        // these are 17x19 px with a pointer at the bottom left
-        'lightblue' => array(
-            'regex'        => '/^lightblue([0-9]+)$/',
-            'extension'    => '.png',
-            'shadow'       => false,
-            'offsetImage'  => '0,-19',
-            'offsetShadow' => false
-        ),
-        // openlayers std markers are 21x25px with shadow
-        'ol-marker' => array(
-            'regex'        => '/^marker(|-blue|-gold|-green|-red)+$/',
-            'extension'    => '.png',
-            'shadow'       => 'marker_shadow.png',
-            'offsetImage'  => '-10,-25',
-            'offsetShadow' => '-1,-13'
-        ),
-        // these are 16x16 px
-        'ww_icon'   => array(
-            'regex'        => '/ww_\S+$/',
-            'extension'    => '.png',
-            'shadow'       => false,
-            'offsetImage'  => '-8,-8',
-            'offsetShadow' => false
-        ),
-        // assume these are 16x16 px
-        'rest'      => array(
-            'regex'        => '/^(?!lightblue([0-9]+)$)(?!(ww_\S+$))(?!marker(|-blue|-gold|-green|-red)+$)(.*)/',
-            'extension'    => '.png',
-            'shadow'       => 'marker_shadow.png',
-            'offsetImage'  => '-8,-8',
-            'offsetShadow' => '-1,-1'
-        )
-    );
-    private $centerX;
-    private $centerY;
-    private $offsetX;
-    private $offsetY;
-    private $image;
-    private $zoom;
-    private $lat;
-    private $lon;
-    private $width;
-    private $height;
-    private $markers;
-    private $maptype;
-    private $kmlFileName;
-    private $gpxFileName;
-    private $geojsonFileName;
-    private $autoZoomExtent;
-    private $apikey;
-    private $tileCacheBaseDir;
-    private $mapCacheBaseDir;
-    private $mediaBaseDir;
-    private $useTileCache;
-    private $mapCacheID = '';
-    private $mapCacheFile = '';
-    private $mapCacheExtension = 'png';
-
-    /**
-     * Constructor.
-     *
-     * @param float  $lat
-     *            Latitude (x) of center of map
-     * @param float  $lon
-     *            Longitude (y) of center of map
-     * @param int    $zoom
-     *            Zoomlevel
-     * @param int    $width
-     *            Width in pixels
-     * @param int    $height
-     *            Height in pixels
-     * @param string $maptype
-     *            Name of the map
-     * @param array  $markers
-     *            array of markers
-     * @param string $gpx
-     *            GPX filename
-     * @param string $kml
-     *            KML filename
-     * @param string $geojson
-     * @param string $mediaDir
-     *            Directory to store/cache maps
-     * @param string $tileCacheBaseDir
-     *            Directory to cache map tiles
-     * @param bool   $autoZoomExtent
-     *            Wheter or not to override zoom/lat/lon and zoom to the extent of gpx/kml and markers
-     * @param string $apikey
-     */
-    public function __construct(
-        float $lat,
-        float $lon,
-        int $zoom,
-        int $width,
-        int $height,
-        string $maptype,
-        array $markers,
-        string $gpx,
-        string $kml,
-        string $geojson,
-        string $mediaDir,
-        string $tileCacheBaseDir,
-        bool $autoZoomExtent = true,
-        string $apikey = ''
-    ) {
-        $this->zoom   = $zoom;
-        $this->lat    = $lat;
-        $this->lon    = $lon;
-        $this->width  = $width;
-        $this->height = $height;
-        // validate + set maptype
-        $this->maptype = $this->tileDefaultSrc;
-        if(array_key_exists($maptype, $this->tileInfo)) {
-            $this->maptype = $maptype;
-        }
-        $this->markers          = $markers;
-        $this->kmlFileName      = $kml;
-        $this->gpxFileName      = $gpx;
-        $this->geojsonFileName  = $geojson;
-        $this->mediaBaseDir     = $mediaDir;
-        $this->tileCacheBaseDir = $tileCacheBaseDir . '/olmaptiles';
-        $this->useTileCache     = $this->tileCacheBaseDir !== '';
-        $this->mapCacheBaseDir  = $mediaDir . '/olmapmaps';
-        $this->autoZoomExtent   = $autoZoomExtent;
-        $this->apikey           = $apikey;
-    }
-
-    /**
-     * get the map, this may return a reference to a cached copy.
-     *
-     * @return string url relative to media dir
-     */
-    public function getMap(): string {
-        try {
-            if($this->autoZoomExtent) {
-                $this->autoZoom();
-            }
-        } catch(Exception $e) {
-            dbglog($e);
-        }
-
-        // use map cache, so check cache for map
-        if(!$this->checkMapCache()) {
-            // map is not in cache, needs to be build
-            $this->makeMap();
-            $this->mkdirRecursive(dirname($this->mapCacheIDToFilename()), 0777);
-            imagepng($this->image, $this->mapCacheIDToFilename(), 9);
-        }
-        $doc = $this->mapCacheIDToFilename();
-        // make url relative to media dir
-        return str_replace($this->mediaBaseDir, '', $doc);
-    }
-
-    /**
-     * Calculate the lat/lon/zoom values to make sure that all of the markers and gpx/kml are on the map.
-     *
-     * @param float $paddingFactor
-     *            buffer constant to enlarge (>1.0) the zoom level
-     * @throws Exception if non-geometries are found in the collection
-     */
-    private function autoZoom(float $paddingFactor = 1.0): void {
-        $geoms    = array();
-        $geoms [] = new Point ($this->lon, $this->lat);
-        if(!empty ($this->markers)) {
-            foreach($this->markers as $marker) {
-                $geoms [] = new Point ($marker ['lon'], $marker ['lat']);
-            }
-        }
-        if(file_exists($this->kmlFileName)) {
-            $g = geoPHP::load(file_get_contents($this->kmlFileName), 'kml');
-            if($g !== false) {
-                $geoms [] = $g;
-            }
-        }
-        if(file_exists($this->gpxFileName)) {
-            $g = geoPHP::load(file_get_contents($this->gpxFileName), 'gpx');
-            if($g !== false) {
-                $geoms [] = $g;
-            }
-        }
-        if(file_exists($this->geojsonFileName)) {
-            $g = geoPHP::load(file_get_contents($this->geojsonFileName), 'geojson');
-            if($g !== false) {
-                $geoms [] = $g;
-            }
-        }
-
-        if(count($geoms) <= 1) {
-            dbglog($geoms, "StaticMap::autoZoom: Skip setting autozoom options");
-            return;
-        }
-
-        $geom     = new GeometryCollection ($geoms);
-        $centroid = $geom->centroid();
-        $bbox     = $geom->getBBox();
-
-        // determine vertical resolution, this depends on the distance from the equator
-        // $vy00 = log(tan(M_PI*(0.25 + $centroid->getY()/360)));
-        $vy0 = log(tan(M_PI * (0.25 + $bbox ['miny'] / 360)));
-        $vy1 = log(tan(M_PI * (0.25 + $bbox ['maxy'] / 360)));
-        dbglog("StaticMap::autoZoom: vertical resolution: $vy0, $vy1");
-        if ($vy1 - $vy0 === 0.0){
-            $resolutionVertical = 0;
-            dbglog("StaticMap::autoZoom: using $resolutionVertical");
-        } else {
-            $zoomFactorPowered  = ($this->height / 2) / (40.7436654315252 * ($vy1 - $vy0));
-            $resolutionVertical = 360 / ($zoomFactorPowered * $this->tileSize);
-        }
-        // determine horizontal resolution
-        $resolutionHorizontal = ($bbox ['maxx'] - $bbox ['minx']) / $this->width;
-        dbglog("StaticMap::autoZoom: using $resolutionHorizontal");
-        $resolution           = max($resolutionHorizontal, $resolutionVertical) * $paddingFactor;
-        $zoom                 = $this->zoom;
-        if ($resolution > 0){
-            $zoom             = log(360 / ($resolution * $this->tileSize), 2);
-        }
-
-        if(is_finite($zoom) && $zoom < 15 && $zoom > 2) {
-            $this->zoom = floor($zoom);
-        }
-        $this->lon = $centroid->getX();
-        $this->lat = $centroid->getY();
-        dbglog("StaticMap::autoZoom: Set autozoom options to: z: $this->zoom, lon: $this->lon, lat: $this->lat");
-    }
-
-    public function checkMapCache(): bool {
-        // side effect: set the mapCacheID
-        $this->mapCacheID = md5($this->serializeParams());
-        $filename         = $this->mapCacheIDToFilename();
-        return file_exists($filename);
-    }
-
-    public function serializeParams(): string {
-        return implode(
-            "&", array(
-                   $this->zoom,
-                   $this->lat,
-                   $this->lon,
-                   $this->width,
-                   $this->height,
-                   serialize($this->markers),
-                   $this->maptype,
-                   $this->kmlFileName,
-                   $this->gpxFileName,
-                   $this->geojsonFileName
-               )
-        );
-    }
-
-    public function mapCacheIDToFilename(): string {
-        if(!$this->mapCacheFile) {
-            $this->mapCacheFile = $this->mapCacheBaseDir . "/" . $this->maptype . "/" . $this->zoom . "/cache_"
-                . substr($this->mapCacheID, 0, 2) . "/" . substr($this->mapCacheID, 2, 2)
-                . "/" . substr($this->mapCacheID, 4);
-        }
-        return $this->mapCacheFile . "." . $this->mapCacheExtension;
-    }
-
-    /**
-     * make the map.
-     */
-    public function makeMap(): void {
-        $this->initCoords();
-        $this->createBaseMap();
-        if(!empty ($this->markers)) {
-            $this->placeMarkers();
-        }
-        if (file_exists($this->kmlFileName)) {
-            try {
-                $this->drawKML();
-            } catch (exception $e) {
-                dbglog('failed to load KML file', $e);
-            }
-        }
-        if (file_exists($this->gpxFileName)) {
-            try {
-                $this->drawGPX();
-            } catch (exception $e) {
-                dbglog('failed to load GPX file', $e);
-            }
-        }
-        if (file_exists($this->geojsonFileName)) {
-            try {
-                $this->drawGeojson();
-            } catch (exception $e) {
-                dbglog('failed to load GeoJSON file', $e);
-            }
-        }
-
-        $this->drawCopyright();
-    }
-
-    /**
-     */
-    public function initCoords(): void {
-        $this->centerX = $this->lonToTile($this->lon, $this->zoom);
-        $this->centerY = $this->latToTile($this->lat, $this->zoom);
-        $this->offsetX = floor((floor($this->centerX) - $this->centerX) * $this->tileSize);
-        $this->offsetY = floor((floor($this->centerY) - $this->centerY) * $this->tileSize);
-    }
-
-    /**
-     *
-     * @param float $long
-     * @param int   $zoom
-     * @return float|int
-     */
-    public function lonToTile(float $long, int $zoom) {
-        return (($long + 180) / 360) * pow(2, $zoom);
-    }
-
-    /**
-     *
-     * @param float $lat
-     * @param int   $zoom
-     * @return float|int
-     */
-    public function latToTile(float $lat, int $zoom) {
-        return (1 - log(tan($lat * pi() / 180) + 1 / cos($lat * M_PI / 180)) / M_PI) / 2 * pow(2, $zoom);
-    }
-
-    /**
-     * make basemap image.
-     */
-    public function createBaseMap(): void {
-        $this->image   = imagecreatetruecolor($this->width, $this->height);
-        $startX        = floor($this->centerX - ($this->width / $this->tileSize) / 2);
-        $startY        = floor($this->centerY - ($this->height / $this->tileSize) / 2);
-        $endX          = ceil($this->centerX + ($this->width / $this->tileSize) / 2);
-        $endY          = ceil($this->centerY + ($this->height / $this->tileSize) / 2);
-        $this->offsetX = -floor(($this->centerX - floor($this->centerX)) * $this->tileSize);
-        $this->offsetY = -floor(($this->centerY - floor($this->centerY)) * $this->tileSize);
-        $this->offsetX += floor($this->width / 2);
-        $this->offsetY += floor($this->height / 2);
-        $this->offsetX += floor($startX - floor($this->centerX)) * $this->tileSize;
-        $this->offsetY += floor($startY - floor($this->centerY)) * $this->tileSize;
-
-        for($x = $startX; $x <= $endX; $x++) {
-            for($y = $startY; $y <= $endY; $y++) {
-                $url = str_replace(
-                    array(
-                        '{Z}',
-                        '{X}',
-                        '{Y}'
-                    ), array(
-                        $this->zoom,
-                        $x,
-                        $y
-                    ), $this->tileInfo [$this->maptype] ['url']
-                );
-
-                $tileData = $this->fetchTile($url);
-                if($tileData) {
-                    $tileImage = imagecreatefromstring($tileData);
-                } else {
-                    $tileImage = imagecreate($this->tileSize, $this->tileSize);
-                    $color     = imagecolorallocate($tileImage, 255, 255, 255);
-                    @imagestring($tileImage, 1, 127, 127, 'err', $color);
-                }
-                $destX = ($x - $startX) * $this->tileSize + $this->offsetX;
-                $destY = ($y - $startY) * $this->tileSize + $this->offsetY;
-                dbglog($this->tileSize, "imagecopy tile into image: $destX, $destY");
-                imagecopy(
-                    $this->image, $tileImage, $destX, $destY, 0, 0, $this->tileSize,
-                    $this->tileSize
-                );
-            }
-        }
-    }
-
-    /**
-     * Fetch a tile and (if configured) store it in the cache.
-     * @param string $url
-     * @return bool|string
-     * @todo refactor this to use dokuwiki\HTTP\HTTPClient or dokuwiki\HTTP\DokuHTTPClient
-     *          for better proxy handling...
-     */
-    public function fetchTile(string $url) {
-        if($this->useTileCache && ($cached = $this->checkTileCache($url)))
-            return $cached;
-
-        $_UA = 'Mozilla/4.0 (compatible; DokuWikiSpatial HTTP Client; ' . PHP_OS . ')';
-        if(function_exists("curl_init")) {
-            // use cUrl
-            $ch = curl_init();
-            curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
-            curl_setopt($ch, CURLOPT_USERAGENT, $_UA);
-            curl_setopt($ch, CURLOPT_CONNECTTIMEOUT, 10);
-            curl_setopt($ch, CURLOPT_URL, $url . $this->apikey);
-            dbglog("StaticMap::fetchTile: getting: $url using curl_exec");
-            $tile = curl_exec($ch);
-            curl_close($ch);
-        } else {
-            // use file_get_contents
-            global $conf;
-            $opts = array(
-                'http' => array(
-                    'method'          => "GET",
-                    'header'          => "Accept-language: en\r\n" . "User-Agent: $_UA\r\n" . "accept: image/png\r\n",
-                    'request_fulluri' => true
-                )
-            );
-            if(isset($conf['proxy']['host'], $conf['proxy']['port'])
-                && $conf['proxy']['host'] !== ''
-                && $conf['proxy']['port'] !== '') {
-                $opts['http'] += ['proxy' => "tcp://" . $conf['proxy']['host'] . ":" . $conf['proxy']['port']];
-            }
-
-            $context = stream_context_create($opts);
-            dbglog("StaticMap::fetchTile: getting: $url . $this->apikey using file_get_contents and options $opts");
-            $tile = file_get_contents($url . $this->apikey, false, $context);
-        }
-        if($tile && $this->useTileCache) {
-            $this->writeTileToCache($url, $tile);
-        }
-        return $tile;
-    }
-
-    /**
-     *
-     * @param string $url
-     * @return string|false
-     */
-    public function checkTileCache(string $url) {
-        $filename = $this->tileUrlToFilename($url);
-        if(file_exists($filename)) {
-            return file_get_contents($filename);
-        }
-        return false;
-    }
-
-    /**
-     *
-     * @param string $url
-     * @return string
-     */
-    public function tileUrlToFilename(string $url): string {
-        return $this->tileCacheBaseDir . "/" . substr($url, strpos($url, '/') + 1);
-    }
-
-    /**
-     * Write a tile into the cache.
-     *
-     * @param string $url
-     * @param mixed  $data
-     */
-    public function writeTileToCache($url, $data): void {
-        $filename = $this->tileUrlToFilename($url);
-        $this->mkdirRecursive(dirname($filename), 0777);
-        file_put_contents($filename, $data);
-    }
-
-    /**
-     * Recursively create the directory.
-     *
-     * @param string $pathname
-     *            The directory path.
-     * @param int    $mode
-     *            File access mode. For more information on modes, read the details on the chmod manpage.
-     */
-    public function mkdirRecursive(string $pathname, int $mode): bool {
-        is_dir(dirname($pathname)) || $this->mkdirRecursive(dirname($pathname), $mode);
-        return is_dir($pathname) || mkdir($pathname, $mode) || is_dir($pathname);
-    }
-
-    /**
-     * Place markers on the map and number them in the same order as they are listed in the html.
-     */
-    public function placeMarkers(): void {
-        $count         = 0;
-        $color         = imagecolorallocate($this->image, 0, 0, 0);
-        $bgcolor       = imagecolorallocate($this->image, 200, 200, 200);
-        $markerBaseDir = __DIR__ . '/icons';
-        $markerImageOffsetX  = 0;
-        $markerImageOffsetY  = 0;
-        $markerShadowOffsetX = 0;
-        $markerShadowOffsetY = 0;
-        $markerShadowImg     = null;
-        // loop thru marker array
-        foreach($this->markers as $marker) {
-            // set some local variables
-            $markerLat  = $marker ['lat'];
-            $markerLon  = $marker ['lon'];
-            $markerType = $marker ['type'];
-            // clear variables from previous loops
-            $markerFilename = '';
-            $markerShadow   = '';
-            $matches        = false;
-            // check for marker type, get settings from markerPrototypes
-            if($markerType) {
-                foreach($this->markerPrototypes as $markerPrototype) {
-                    if(preg_match($markerPrototype ['regex'], $markerType, $matches)) {
-                        $markerFilename = $matches [0] . $markerPrototype ['extension'];
-                        if($markerPrototype ['offsetImage']) {
-                            list ($markerImageOffsetX, $markerImageOffsetY) = explode(
-                                ",",
-                                $markerPrototype ['offsetImage']
-                            );
-                        }
-                        $markerShadow = $markerPrototype ['shadow'];
-                        if($markerShadow) {
-                            list ($markerShadowOffsetX, $markerShadowOffsetY) = explode(
-                                ",",
-                                $markerPrototype ['offsetShadow']
-                            );
-                        }
-                    }
-                }
-            }
-            // create img resource
-            if(file_exists($markerBaseDir . '/' . $markerFilename)) {
-                $markerImg = imagecreatefrompng($markerBaseDir . '/' . $markerFilename);
-            } else {
-                $markerImg = imagecreatefrompng($markerBaseDir . '/marker.png');
-            }
-            // check for shadow + create shadow recource
-            if($markerShadow && file_exists($markerBaseDir . '/' . $markerShadow)) {
-                $markerShadowImg = imagecreatefrompng($markerBaseDir . '/' . $markerShadow);
-            }
-            // calc position
-            $destX = floor(
-                ($this->width / 2) -
-                $this->tileSize * ($this->centerX - $this->lonToTile($markerLon, $this->zoom))
-            );
-            $destY = floor(
-                ($this->height / 2) -
-                $this->tileSize * ($this->centerY - $this->latToTile($markerLat, $this->zoom))
-            );
-            // copy shadow on basemap
-            if($markerShadow && $markerShadowImg) {
-                imagecopy(
-                    $this->image,
-                    $markerShadowImg,
-                    $destX + (int) $markerShadowOffsetX,
-                    $destY + (int) $markerShadowOffsetY,
-                    0,
-                    0,
-                    imagesx($markerShadowImg),
-                    imagesy($markerShadowImg)
-                );
-            }
-            // copy marker on basemap above shadow
-            imagecopy(
-                $this->image,
-                $markerImg,
-                $destX + (int) $markerImageOffsetX,
-                $destY + (int) $markerImageOffsetY,
-                0,
-                0,
-                imagesx($markerImg),
-                imagesy($markerImg)
-            );
-            // add label
-            imagestring(
-                $this->image,
-                3,
-                $destX - imagesx($markerImg) + 1,
-                $destY + (int) $markerImageOffsetY + 1,
-                ++$count,
-                $bgcolor
-            );
-            imagestring(
-                $this->image,
-                3,
-                $destX - imagesx($markerImg),
-                $destY + (int) $markerImageOffsetY,
-                $count,
-                $color
-            );
-        }
-    }
-
-    /**
-     * Draw kml trace on the map.
-     * @throws exception when loading the KML fails
-     */
-    public function drawKML(): void {
-        // TODO get colour from kml node (not currently supported in geoPHP)
-        $col     = imagecolorallocatealpha($this->image, 255, 0, 0, .4 * 127);
-        $kmlgeom = geoPHP::load(file_get_contents($this->kmlFileName), 'kml');
-        $this->drawGeometry($kmlgeom, $col);
-    }
-
-    /**
-     * Draw geometry or geometry collection on the map.
-     *
-     * @param Geometry $geom
-     * @param int      $colour
-     *            drawing colour
-     */
-    private function drawGeometry(Geometry $geom, int $colour): void {
-        if(empty($geom)) {
-            return;
-        }
-
-        switch($geom->geometryType()) {
-            case 'GeometryCollection' :
-                // recursively draw part of the collection
-                for($i = 1; $i < $geom->numGeometries() + 1; $i++) {
-                    $_geom = $geom->geometryN($i);
-                    $this->drawGeometry($_geom, $colour);
-                }
-                break;
-            case 'MultiPolygon' :
-            case 'MultiLineString' :
-            case 'MultiPoint' :
-                // TODO implement / do nothing
-                break;
-            case 'Polygon' :
-                $this->drawPolygon($geom, $colour);
-                break;
-            case 'LineString' :
-                $this->drawLineString($geom, $colour);
-                break;
-            case 'Point' :
-                $this->drawPoint($geom, $colour);
-                break;
-            default :
-                // draw nothing
-                break;
-        }
-    }
-
-    /**
-     * Draw a polygon on the map.
-     *
-     * @param Polygon $polygon
-     * @param int     $colour
-     *            drawing colour
-     */
-    private function drawPolygon($polygon, int $colour) {
-        // TODO implementation of drawing holes,
-        // maybe draw the polygon to an in-memory image and use imagecopy, draw polygon in col., draw holes in bgcol?
-
-        // print_r('Polygon:<br />');
-        // print_r($polygon);
-        $extPoints = array();
-        // extring is a linestring actually..
-        $extRing = $polygon->exteriorRing();
-
-        for($i = 1; $i < $extRing->numGeometries(); $i++) {
-            $p1           = $extRing->geometryN($i);
-            $x            = floor(
-                ($this->width / 2) - $this->tileSize * ($this->centerX - $this->lonToTile($p1->x(), $this->zoom))
-            );
-            $y            = floor(
-                ($this->height / 2) - $this->tileSize * ($this->centerY - $this->latToTile($p1->y(), $this->zoom))
-            );
-            $extPoints [] = $x;
-            $extPoints [] = $y;
-        }
-        // print_r('points:('.($i-1).')<br />');
-        // print_r($extPoints);
-        // imagepolygon ($this->image, $extPoints, $i-1, $colour );
-        imagefilledpolygon($this->image, $extPoints, $i - 1, $colour);
-    }
-
-    /**
-     * Draw a line on the map.
-     *
-     * @param LineString $line
-     * @param int        $colour
-     *            drawing colour
-     */
-    private function drawLineString($line, $colour) {
-        imagesetthickness($this->image, 2);
-        for($p = 1; $p < $line->numGeometries(); $p++) {
-            // get first pair of points
-            $p1 = $line->geometryN($p);
-            $p2 = $line->geometryN($p + 1);
-            // translate to paper space
-            $x1 = floor(
-                ($this->width / 2) - $this->tileSize * ($this->centerX - $this->lonToTile($p1->x(), $this->zoom))
-            );
-            $y1 = floor(
-                ($this->height / 2) - $this->tileSize * ($this->centerY - $this->latToTile($p1->y(), $this->zoom))
-            );
-            $x2 = floor(
-                ($this->width / 2) - $this->tileSize * ($this->centerX - $this->lonToTile($p2->x(), $this->zoom))
-            );
-            $y2 = floor(
-                ($this->height / 2) - $this->tileSize * ($this->centerY - $this->latToTile($p2->y(), $this->zoom))
-            );
-            // draw to image
-            imageline($this->image, $x1, $y1, $x2, $y2, $colour);
-        }
-        imagesetthickness($this->image, 1);
-    }
-
-    /**
-     * Draw a point on the map.
-     *
-     * @param Point $point
-     * @param int   $colour
-     *            drawing colour
-     */
-    private function drawPoint($point, $colour) {
-        imagesetthickness($this->image, 2);
-        // translate to paper space
-        $cx = floor(
-            ($this->width / 2) - $this->tileSize * ($this->centerX - $this->lonToTile($point->x(), $this->zoom))
-        );
-        $cy = floor(
-            ($this->height / 2) - $this->tileSize * ($this->centerY - $this->latToTile($point->y(), $this->zoom))
-        );
-        $r  = 5;
-        // draw to image
-        // imageellipse($this->image, $cx, $cy,$r, $r, $colour);
-        imagefilledellipse($this->image, $cx, $cy, $r, $r, $colour);
-        // don't use imageellipse because the imagesetthickness function has
-        // no effect. So the better workaround is to use imagearc.
-        imagearc($this->image, $cx, $cy, $r, $r, 0, 359, $colour);
-        imagesetthickness($this->image, 1);
-    }
-
-    /**
-     * Draw gpx trace on the map.
-     * @throws exception when loading the GPX fails
-     */
-    public function drawGPX() {
-        $col     = imagecolorallocatealpha($this->image, 0, 0, 255, .4 * 127);
-        $gpxgeom = geoPHP::load(file_get_contents($this->gpxFileName), 'gpx');
-        $this->drawGeometry($gpxgeom, $col);
-    }
-
-    /**
-     * Draw geojson on the map.
-     * @throws exception when loading the JSON fails
-     */
-    public function drawGeojson() {
-        $col     = imagecolorallocatealpha($this->image, 255, 0, 255, .4 * 127);
-        $gpxgeom = geoPHP::load(file_get_contents($this->geojsonFileName), 'json');
-        $this->drawGeometry($gpxgeom, $col);
-    }
-
-    /**
-     * add copyright and origin notice and icons to the map.
-     */
-    public function drawCopyright() {
-        $logoBaseDir = dirname(__FILE__) . '/' . 'logo/';
-        $logoImg     = imagecreatefrompng($logoBaseDir . $this->tileInfo ['openstreetmap'] ['logo']);
-        $textcolor   = imagecolorallocate($this->image, 0, 0, 0);
-        $bgcolor     = imagecolorallocate($this->image, 200, 200, 200);
-
-        imagecopy(
-            $this->image,
-            $logoImg,
-            0,
-            imagesy($this->image) - imagesy($logoImg),
-            0,
-            0,
-            imagesx($logoImg),
-            imagesy($logoImg)
-        );
-        imagestring(
-            $this->image,
-            1,
-            imagesx($logoImg) + 2,
-            imagesy($this->image) - imagesy($logoImg) + 1,
-            $this->tileInfo ['openstreetmap'] ['txt'],
-            $bgcolor
-        );
-        imagestring(
-            $this->image,
-            1,
-            imagesx($logoImg) + 1,
-            imagesy($this->image) - imagesy($logoImg),
-            $this->tileInfo ['openstreetmap'] ['txt'],
-            $textcolor
-        );
-
-        // additional tile source info, ie. who created/hosted the tiles
-        $xIconOffset = 0;
-        if($this->maptype === 'openstreetmap') {
-            $mapAuthor = "(c) OpenStreetMap maps/CC BY-SA";
-        } else {
-            $mapAuthor   = $this->tileInfo [$this->maptype] ['txt'];
-            $iconImg     = imagecreatefrompng($logoBaseDir . $this->tileInfo [$this->maptype] ['logo']);
-            $xIconOffset = imagesx($iconImg);
-            imagecopy(
-                $this->image,
-                $iconImg, imagesx($logoImg) + 1,
-                imagesy($this->image) - imagesy($iconImg),
-                0,
-                0,
-                imagesx($iconImg), imagesy($iconImg)
-            );
-        }
-        imagestring(
-            $this->image,
-            1, imagesx($logoImg) + $xIconOffset + 4,
-            imagesy($this->image) - ceil(imagesy($logoImg) / 2) + 1,
-            $mapAuthor,
-            $bgcolor
-        );
-        imagestring(
-            $this->image,
-            1, imagesx($logoImg) + $xIconOffset + 3,
-            imagesy($this->image) - ceil(imagesy($logoImg) / 2),
-            $mapAuthor,
-            $textcolor
-        );
-
-    }
+	// the final output
+	private $tileSize = 256;
+	private $tileInfo = array(
+		// OSM sources
+		'openstreetmap' => array(
+			'txt'  => '(c) OpenStreetMap data/ODbl',
+			'logo' => 'osm_logo.png',
+			'url'  => 'https://tile.openstreetmap.org/{Z}/{X}/{Y}.png'
+		),
+		// OCM sources
+		'cycle'         => array(
+			'txt'  => '(c) Thunderforest maps',
+			'logo' => 'tf_logo.png',
+			'url'  => 'https://tile.thunderforest.com/cycle/{Z}/{X}/{Y}.png'
+		),
+		'transport'     => array(
+			'txt'  => '(c) Thunderforest maps',
+			'logo' => 'tf_logo.png',
+			'url'  => 'https://tile.thunderforest.com/transport/{Z}/{X}/{Y}.png'
+		),
+		'landscape'     => array(
+			'txt'  => '(c) Thunderforest maps',
+			'logo' => 'tf_logo.png',
+			'url'  => 'https://tile.thunderforest.com/landscape/{Z}/{X}/{Y}.png'
+		),
+		'outdoors'      => array(
+			'txt'  => '(c) Thunderforest maps',
+			'logo' => 'tf_logo.png',
+			'url'  => 'https://tile.thunderforest.com/outdoors/{Z}/{X}/{Y}.png'
+		),
+		'toner-lite'    => array(
+			'txt'  => 'Stamen tiles',
+			'logo' => 'stamen.png',
+			'url'  => 'https://stamen-tiles.a.ssl.fastly.net/toner/{Z}/{X}/{Y}.png'
+		),
+		'terrain'       => array(
+			'txt'  => 'Stamen tiles',
+			'logo' => 'stamen.png',
+			'url'  => 'https://stamen-tiles.a.ssl.fastly.net/terrain/{Z}/{X}/{Y}.jpg'
+		)
+		//,
+		// 'piste'=>array(
+		// 'txt'=>'OpenPisteMap tiles',
+		// 'logo'=>'piste_logo.png',
+		// 'url'=>''),
+		// 'sea'=>array(
+		// 'txt'=>'OpenSeaMap tiles',
+		// 'logo'=>'sea_logo.png',
+		// 'url'=>''),
+		// H&B sources
+		//          'hikeandbike' => array (
+		//                  'txt' => 'Hike & Bike Map',
+		//                  'logo' => 'hnb_logo.png',
+		//                  //'url' => 'http://toolserver.org/tiles/hikebike/{Z}/{X}/{Y}.png'
+		//                  //moved to: https://www.toolserver.org/tiles/hikebike/12/2105/1388.png
+		//                  'url' => 'http://c.tiles.wmflabs.org/hikebike/{Z}/{X}/{Y}.png'
+		//          )
+	);
+	private $tileDefaultSrc = 'openstreetmap';
+
+	// set up markers
+	private $markerPrototypes = array(
+		// found at http://www.mapito.net/map-marker-icons.html
+		// these are 17x19 px with a pointer at the bottom left
+		'lightblue' => array(
+			'regex'        => '/^lightblue([0-9]+)$/',
+			'extension'    => '.png',
+			'shadow'       => false,
+			'offsetImage'  => '0,-19',
+			'offsetShadow' => false
+		),
+		// openlayers std markers are 21x25px with shadow
+		'ol-marker' => array(
+			'regex'        => '/^marker(|-blue|-gold|-green|-red)+$/',
+			'extension'    => '.png',
+			'shadow'       => 'marker_shadow.png',
+			'offsetImage'  => '-10,-25',
+			'offsetShadow' => '-1,-13'
+		),
+		// these are 16x16 px
+		'ww_icon'   => array(
+			'regex'        => '/ww_\S+$/',
+			'extension'    => '.png',
+			'shadow'       => false,
+			'offsetImage'  => '-8,-8',
+			'offsetShadow' => false
+		),
+		// assume these are 16x16 px
+		'rest'      => array(
+			'regex'        => '/^(?!lightblue([0-9]+)$)(?!(ww_\S+$))(?!marker(|-blue|-gold|-green|-red)+$)(.*)/',
+			'extension'    => '.png',
+			'shadow'       => 'marker_shadow.png',
+			'offsetImage'  => '-8,-8',
+			'offsetShadow' => '-1,-1'
+		)
+	);
+	private $centerX;
+	private $centerY;
+	private $offsetX;
+	private $offsetY;
+	private $image;
+	private $zoom;
+	private $lat;
+	private $lon;
+	private $width;
+	private $height;
+	private $markers;
+	private $maptype;
+	private $kmlFileName;
+	private $gpxFileName;
+	private $geojsonFileName;
+	private $autoZoomExtent;
+	private $apikey;
+	private $tileCacheBaseDir;
+	private $mapCacheBaseDir;
+	private $mediaBaseDir;
+	private $useTileCache;
+	private $mapCacheID = '';
+	private $mapCacheFile = '';
+	private $mapCacheExtension = 'png';
+
+	/**
+	 * Constructor.
+	 *
+	 * @param float  $lat
+	 *            Latitude (x) of center of map
+	 * @param float  $lon
+	 *            Longitude (y) of center of map
+	 * @param int    $zoom
+	 *            Zoomlevel
+	 * @param int    $width
+	 *            Width in pixels
+	 * @param int    $height
+	 *            Height in pixels
+	 * @param string $maptype
+	 *            Name of the map
+	 * @param array  $markers
+	 *            array of markers
+	 * @param string $gpx
+	 *            GPX filename
+	 * @param string $kml
+	 *            KML filename
+	 * @param string $geojson
+	 * @param string $mediaDir
+	 *            Directory to store/cache maps
+	 * @param string $tileCacheBaseDir
+	 *            Directory to cache map tiles
+	 * @param bool   $autoZoomExtent
+	 *            Wheter or not to override zoom/lat/lon and zoom to the extent of gpx/kml and markers
+	 * @param string $apikey
+	 */
+	public function __construct(
+		float $lat,
+		float $lon,
+		int $zoom,
+		int $width,
+		int $height,
+		string $maptype,
+		array $markers,
+		string $gpx,
+		string $kml,
+		string $geojson,
+		string $mediaDir,
+		string $tileCacheBaseDir,
+		bool $autoZoomExtent = true,
+		string $apikey = ''
+	) {
+		$this->zoom   = $zoom;
+		$this->lat    = $lat;
+		$this->lon    = $lon;
+		$this->width  = $width;
+		$this->height = $height;
+		// validate + set maptype
+		$this->maptype = $this->tileDefaultSrc;
+		if(array_key_exists($maptype, $this->tileInfo)) {
+			$this->maptype = $maptype;
+		}
+		$this->markers          = $markers;
+		$this->kmlFileName      = $kml;
+		$this->gpxFileName      = $gpx;
+		$this->geojsonFileName  = $geojson;
+		$this->mediaBaseDir     = $mediaDir;
+		$this->tileCacheBaseDir = $tileCacheBaseDir . '/olmaptiles';
+		$this->useTileCache     = $this->tileCacheBaseDir !== '';
+		$this->mapCacheBaseDir  = $mediaDir . '/olmapmaps';
+		$this->autoZoomExtent   = $autoZoomExtent;
+		$this->apikey           = $apikey;
+	}
+
+	/**
+	 * get the map, this may return a reference to a cached copy.
+	 *
+	 * @return string url relative to media dir
+	 */
+	public function getMap(): string {
+		try {
+			if($this->autoZoomExtent) {
+				$this->autoZoom();
+			}
+		} catch(Exception $e) {
+			dbglog($e);
+		}
+
+		// use map cache, so check cache for map
+		if(!$this->checkMapCache()) {
+			// map is not in cache, needs to be build
+			$this->makeMap();
+			$this->mkdirRecursive(dirname($this->mapCacheIDToFilename()), 0777);
+			imagepng($this->image, $this->mapCacheIDToFilename(), 9);
+		}
+		$doc = $this->mapCacheIDToFilename();
+		// make url relative to media dir
+		return str_replace($this->mediaBaseDir, '', $doc);
+	}
+
+	/**
+	 * Calculate the lat/lon/zoom values to make sure that all of the markers and gpx/kml are on the map.
+	 *
+	 * @param float $paddingFactor
+	 *            buffer constant to enlarge (>1.0) the zoom level
+	 * @throws Exception if non-geometries are found in the collection
+	 */
+	private function autoZoom(float $paddingFactor = 1.0): void {
+		$geoms    = array();
+		$geoms [] = new Point ($this->lon, $this->lat);
+		if(!empty ($this->markers)) {
+			foreach($this->markers as $marker) {
+				$geoms [] = new Point ($marker ['lon'], $marker ['lat']);
+			}
+		}
+		if(file_exists($this->kmlFileName)) {
+			$g = geoPHP::load(file_get_contents($this->kmlFileName), 'kml');
+			if($g !== false) {
+				$geoms [] = $g;
+			}
+		}
+		if(file_exists($this->gpxFileName)) {
+			$g = geoPHP::load(file_get_contents($this->gpxFileName), 'gpx');
+			if($g !== false) {
+				$geoms [] = $g;
+			}
+		}
+		if(file_exists($this->geojsonFileName)) {
+			$g = geoPHP::load(file_get_contents($this->geojsonFileName), 'geojson');
+			if($g !== false) {
+				$geoms [] = $g;
+			}
+		}
+
+		if(count($geoms) <= 1) {
+			dbglog($geoms, "StaticMap::autoZoom: Skip setting autozoom options");
+			return;
+		}
+
+		$geom     = new GeometryCollection ($geoms);
+		$centroid = $geom->centroid();
+		$bbox     = $geom->getBBox();
+
+		// determine vertical resolution, this depends on the distance from the equator
+		// $vy00 = log(tan(M_PI*(0.25 + $centroid->getY()/360)));
+		$vy0 = log(tan(M_PI * (0.25 + $bbox ['miny'] / 360)));
+		$vy1 = log(tan(M_PI * (0.25 + $bbox ['maxy'] / 360)));
+		dbglog("StaticMap::autoZoom: vertical resolution: $vy0, $vy1");
+		if ($vy1 - $vy0 === 0.0){
+			$resolutionVertical = 0;
+			dbglog("StaticMap::autoZoom: using $resolutionVertical");
+		} else {
+			$zoomFactorPowered  = ($this->height / 2) / (40.7436654315252 * ($vy1 - $vy0));
+			$resolutionVertical = 360 / ($zoomFactorPowered * $this->tileSize);
+		}
+		// determine horizontal resolution
+		$resolutionHorizontal = ($bbox ['maxx'] - $bbox ['minx']) / $this->width;
+		dbglog("StaticMap::autoZoom: using $resolutionHorizontal");
+		$resolution           = max($resolutionHorizontal, $resolutionVertical) * $paddingFactor;
+		$zoom                 = $this->zoom;
+		if ($resolution > 0){
+			$zoom             = log(360 / ($resolution * $this->tileSize), 2);
+		}
+
+		if(is_finite($zoom) && $zoom < 15 && $zoom > 2) {
+			$this->zoom = floor($zoom);
+		}
+		$this->lon = $centroid->getX();
+		$this->lat = $centroid->getY();
+		dbglog("StaticMap::autoZoom: Set autozoom options to: z: $this->zoom, lon: $this->lon, lat: $this->lat");
+	}
+
+	public function checkMapCache(): bool {
+		// side effect: set the mapCacheID
+		$this->mapCacheID = md5($this->serializeParams());
+		$filename         = $this->mapCacheIDToFilename();
+		return file_exists($filename);
+	}
+
+	public function serializeParams(): string {
+		return implode(
+			"&", array(
+				   $this->zoom,
+				   $this->lat,
+				   $this->lon,
+				   $this->width,
+				   $this->height,
+				   serialize($this->markers),
+				   $this->maptype,
+				   $this->kmlFileName,
+				   $this->gpxFileName,
+				   $this->geojsonFileName
+			   )
+		);
+	}
+
+	public function mapCacheIDToFilename(): string {
+		if(!$this->mapCacheFile) {
+			$this->mapCacheFile = $this->mapCacheBaseDir . "/" . $this->maptype . "/" . $this->zoom . "/cache_"
+				. substr($this->mapCacheID, 0, 2) . "/" . substr($this->mapCacheID, 2, 2)
+				. "/" . substr($this->mapCacheID, 4);
+		}
+		return $this->mapCacheFile . "." . $this->mapCacheExtension;
+	}
+
+	/**
+	 * make the map.
+	 */
+	public function makeMap(): void {
+		$this->initCoords();
+		$this->createBaseMap();
+		if(!empty ($this->markers)) {
+			$this->placeMarkers();
+		}
+		if (file_exists($this->kmlFileName)) {
+			try {
+				$this->drawKML();
+			} catch (exception $e) {
+				dbglog('failed to load KML file', $e);
+			}
+		}
+		if (file_exists($this->gpxFileName)) {
+			try {
+				$this->drawGPX();
+			} catch (exception $e) {
+				dbglog('failed to load GPX file', $e);
+			}
+		}
+		if (file_exists($this->geojsonFileName)) {
+			try {
+				$this->drawGeojson();
+			} catch (exception $e) {
+				dbglog('failed to load GeoJSON file', $e);
+			}
+		}
+
+		$this->drawCopyright();
+	}
+
+	/**
+	 */
+	public function initCoords(): void {
+		$this->centerX = $this->lonToTile($this->lon, $this->zoom);
+		$this->centerY = $this->latToTile($this->lat, $this->zoom);
+		$this->offsetX = floor((floor($this->centerX) - $this->centerX) * $this->tileSize);
+		$this->offsetY = floor((floor($this->centerY) - $this->centerY) * $this->tileSize);
+	}
+
+	/**
+	 *
+	 * @param float $long
+	 * @param int   $zoom
+	 * @return float|int
+	 */
+	public function lonToTile(float $long, int $zoom) {
+		return (($long + 180) / 360) * pow(2, $zoom);
+	}
+
+	/**
+	 *
+	 * @param float $lat
+	 * @param int   $zoom
+	 * @return float|int
+	 */
+	public function latToTile(float $lat, int $zoom) {
+		return (1 - log(tan($lat * pi() / 180) + 1 / cos($lat * M_PI / 180)) / M_PI) / 2 * pow(2, $zoom);
+	}
+
+	/**
+	 * make basemap image.
+	 */
+	public function createBaseMap(): void {
+		$this->image   = imagecreatetruecolor($this->width, $this->height);
+		$startX        = floor($this->centerX - ($this->width / $this->tileSize) / 2);
+		$startY        = floor($this->centerY - ($this->height / $this->tileSize) / 2);
+		$endX          = ceil($this->centerX + ($this->width / $this->tileSize) / 2);
+		$endY          = ceil($this->centerY + ($this->height / $this->tileSize) / 2);
+		$this->offsetX = -floor(($this->centerX - floor($this->centerX)) * $this->tileSize);
+		$this->offsetY = -floor(($this->centerY - floor($this->centerY)) * $this->tileSize);
+		$this->offsetX += floor($this->width / 2);
+		$this->offsetY += floor($this->height / 2);
+		$this->offsetX += floor($startX - floor($this->centerX)) * $this->tileSize;
+		$this->offsetY += floor($startY - floor($this->centerY)) * $this->tileSize;
+
+		for($x = $startX; $x <= $endX; $x++) {
+			for($y = $startY; $y <= $endY; $y++) {
+				$url = str_replace(
+					array(
+						'{Z}',
+						'{X}',
+						'{Y}'
+					), array(
+						$this->zoom,
+						$x,
+						$y
+					), $this->tileInfo [$this->maptype] ['url']
+				);
+
+				$tileData = $this->fetchTile($url);
+				if($tileData) {
+					$tileImage = imagecreatefromstring($tileData);
+				} else {
+					$tileImage = imagecreate($this->tileSize, $this->tileSize);
+					$color     = imagecolorallocate($tileImage, 255, 255, 255);
+					@imagestring($tileImage, 1, 127, 127, 'err', $color);
+				}
+				$destX = ($x - $startX) * $this->tileSize + $this->offsetX;
+				$destY = ($y - $startY) * $this->tileSize + $this->offsetY;
+				dbglog($this->tileSize, "imagecopy tile into image: $destX, $destY");
+				imagecopy(
+					$this->image, $tileImage, $destX, $destY, 0, 0, $this->tileSize,
+					$this->tileSize
+				);
+			}
+		}
+	}
+
+	/**
+	 * Fetch a tile and (if configured) store it in the cache.
+	 * @param string $url
+	 * @return bool|string
+	 * @todo refactor this to use dokuwiki\HTTP\HTTPClient or dokuwiki\HTTP\DokuHTTPClient
+	 *          for better proxy handling...
+	 */
+	public function fetchTile(string $url) {
+		if($this->useTileCache && ($cached = $this->checkTileCache($url)))
+			return $cached;
+
+		$_UA = 'Mozilla/4.0 (compatible; DokuWikiSpatial HTTP Client; ' . PHP_OS . ')';
+		if(function_exists("curl_init")) {
+			// use cUrl
+			$ch = curl_init();
+			curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
+			curl_setopt($ch, CURLOPT_USERAGENT, $_UA);
+			curl_setopt($ch, CURLOPT_CONNECTTIMEOUT, 10);
+			curl_setopt($ch, CURLOPT_URL, $url . $this->apikey);
+			dbglog("StaticMap::fetchTile: getting: $url using curl_exec");
+			$tile = curl_exec($ch);
+			curl_close($ch);
+		} else {
+			// use file_get_contents
+			global $conf;
+			$opts = array(
+				'http' => array(
+					'method'          => "GET",
+					'header'          => "Accept-language: en\r\n" . "User-Agent: $_UA\r\n" . "accept: image/png\r\n",
+					'request_fulluri' => true
+				)
+			);
+			if(isset($conf['proxy']['host'], $conf['proxy']['port'])
+				&& $conf['proxy']['host'] !== ''
+				&& $conf['proxy']['port'] !== '') {
+				$opts['http'] += ['proxy' => "tcp://" . $conf['proxy']['host'] . ":" . $conf['proxy']['port']];
+			}
+
+			$context = stream_context_create($opts);
+			dbglog("StaticMap::fetchTile: getting: $url . $this->apikey using file_get_contents and options $opts");
+			$tile = file_get_contents($url . $this->apikey, false, $context);
+		}
+		if($tile && $this->useTileCache) {
+			$this->writeTileToCache($url, $tile);
+		}
+		return $tile;
+	}
+
+	/**
+	 *
+	 * @param string $url
+	 * @return string|false
+	 */
+	public function checkTileCache(string $url) {
+		$filename = $this->tileUrlToFilename($url);
+		if(file_exists($filename)) {
+			return file_get_contents($filename);
+		}
+		return false;
+	}
+
+	/**
+	 *
+	 * @param string $url
+	 * @return string
+	 */
+	public function tileUrlToFilename(string $url): string {
+		return $this->tileCacheBaseDir . "/" . substr($url, strpos($url, '/') + 1);
+	}
+
+	/**
+	 * Write a tile into the cache.
+	 *
+	 * @param string $url
+	 * @param mixed  $data
+	 */
+	public function writeTileToCache($url, $data): void {
+		$filename = $this->tileUrlToFilename($url);
+		$this->mkdirRecursive(dirname($filename), 0777);
+		file_put_contents($filename, $data);
+	}
+
+	/**
+	 * Recursively create the directory.
+	 *
+	 * @param string $pathname
+	 *            The directory path.
+	 * @param int    $mode
+	 *            File access mode. For more information on modes, read the details on the chmod manpage.
+	 */
+	public function mkdirRecursive(string $pathname, int $mode): bool {
+		is_dir(dirname($pathname)) || $this->mkdirRecursive(dirname($pathname), $mode);
+		return is_dir($pathname) || mkdir($pathname, $mode) || is_dir($pathname);
+	}
+
+	/**
+	 * Place markers on the map and number them in the same order as they are listed in the html.
+	 */
+	public function placeMarkers(): void {
+		$count         = 0;
+		$color         = imagecolorallocate($this->image, 0, 0, 0);
+		$bgcolor       = imagecolorallocate($this->image, 200, 200, 200);
+		$markerBaseDir = __DIR__ . '/icons';
+		$markerImageOffsetX  = 0;
+		$markerImageOffsetY  = 0;
+		$markerShadowOffsetX = 0;
+		$markerShadowOffsetY = 0;
+		$markerShadowImg     = null;
+		// loop thru marker array
+		foreach($this->markers as $marker) {
+			// set some local variables
+			$markerLat  = $marker ['lat'];
+			$markerLon  = $marker ['lon'];
+			$markerType = $marker ['type'];
+			// clear variables from previous loops
+			$markerFilename = '';
+			$markerShadow   = '';
+			$matches        = false;
+			// check for marker type, get settings from markerPrototypes
+			if($markerType) {
+				foreach($this->markerPrototypes as $markerPrototype) {
+					if(preg_match($markerPrototype ['regex'], $markerType, $matches)) {
+						$markerFilename = $matches [0] . $markerPrototype ['extension'];
+						if($markerPrototype ['offsetImage']) {
+							list ($markerImageOffsetX, $markerImageOffsetY) = explode(
+								",",
+								$markerPrototype ['offsetImage']
+							);
+						}
+						$markerShadow = $markerPrototype ['shadow'];
+						if($markerShadow) {
+							list ($markerShadowOffsetX, $markerShadowOffsetY) = explode(
+								",",
+								$markerPrototype ['offsetShadow']
+							);
+						}
+					}
+				}
+			}
+			// create img resource
+			if(file_exists($markerBaseDir . '/' . $markerFilename)) {
+				$markerImg = imagecreatefrompng($markerBaseDir . '/' . $markerFilename);
+			} else {
+				$markerImg = imagecreatefrompng($markerBaseDir . '/marker.png');
+			}
+			// check for shadow + create shadow recource
+			if($markerShadow && file_exists($markerBaseDir . '/' . $markerShadow)) {
+				$markerShadowImg = imagecreatefrompng($markerBaseDir . '/' . $markerShadow);
+			}
+			// calc position
+			$destX = floor(
+				($this->width / 2) -
+				$this->tileSize * ($this->centerX - $this->lonToTile($markerLon, $this->zoom))
+			);
+			$destY = floor(
+				($this->height / 2) -
+				$this->tileSize * ($this->centerY - $this->latToTile($markerLat, $this->zoom))
+			);
+			// copy shadow on basemap
+			if($markerShadow && $markerShadowImg) {
+				imagecopy(
+					$this->image,
+					$markerShadowImg,
+					$destX + (int) $markerShadowOffsetX,
+					$destY + (int) $markerShadowOffsetY,
+					0,
+					0,
+					imagesx($markerShadowImg),
+					imagesy($markerShadowImg)
+				);
+			}
+			// copy marker on basemap above shadow
+			imagecopy(
+				$this->image,
+				$markerImg,
+				$destX + (int) $markerImageOffsetX,
+				$destY + (int) $markerImageOffsetY,
+				0,
+				0,
+				imagesx($markerImg),
+				imagesy($markerImg)
+			);
+			// add label
+			imagestring(
+				$this->image,
+				3,
+				$destX - imagesx($markerImg) + 1,
+				$destY + (int) $markerImageOffsetY + 1,
+				++$count,
+				$bgcolor
+			);
+			imagestring(
+				$this->image,
+				3,
+				$destX - imagesx($markerImg),
+				$destY + (int) $markerImageOffsetY,
+				$count,
+				$color
+			);
+		}
+	}
+
+	/**
+	 * Draw kml trace on the map.
+	 * @throws exception when loading the KML fails
+	 */
+	public function drawKML(): void {
+		// TODO get colour from kml node (not currently supported in geoPHP)
+		$col     = imagecolorallocatealpha($this->image, 255, 0, 0, .4 * 127);
+		$kmlgeom = geoPHP::load(file_get_contents($this->kmlFileName), 'kml');
+		$this->drawGeometry($kmlgeom, $col);
+	}
+
+	/**
+	 * Draw geometry or geometry collection on the map.
+	 *
+	 * @param Geometry $geom
+	 * @param int      $colour
+	 *            drawing colour
+	 */
+	private function drawGeometry(Geometry $geom, int $colour): void {
+		if(empty($geom)) {
+			return;
+		}
+
+		switch($geom->geometryType()) {
+			case 'GeometryCollection' :
+				// recursively draw part of the collection
+				for($i = 1; $i < $geom->numGeometries() + 1; $i++) {
+					$_geom = $geom->geometryN($i);
+					$this->drawGeometry($_geom, $colour);
+				}
+				break;
+			case 'MultiPolygon' :
+			case 'MultiLineString' :
+			case 'MultiPoint' :
+				// TODO implement / do nothing
+				break;
+			case 'Polygon' :
+				$this->drawPolygon($geom, $colour);
+				break;
+			case 'LineString' :
+				$this->drawLineString($geom, $colour);
+				break;
+			case 'Point' :
+				$this->drawPoint($geom, $colour);
+				break;
+			default :
+				// draw nothing
+				break;
+		}
+	}
+
+	/**
+	 * Draw a polygon on the map.
+	 *
+	 * @param Polygon $polygon
+	 * @param int     $colour
+	 *            drawing colour
+	 */
+	private function drawPolygon($polygon, int $colour) {
+		// TODO implementation of drawing holes,
+		// maybe draw the polygon to an in-memory image and use imagecopy, draw polygon in col., draw holes in bgcol?
+
+		// print_r('Polygon:<br />');
+		// print_r($polygon);
+		$extPoints = array();
+		// extring is a linestring actually..
+		$extRing = $polygon->exteriorRing();
+
+		for($i = 1; $i < $extRing->numGeometries(); $i++) {
+			$p1           = $extRing->geometryN($i);
+			$x            = floor(
+				($this->width / 2) - $this->tileSize * ($this->centerX - $this->lonToTile($p1->x(), $this->zoom))
+			);
+			$y            = floor(
+				($this->height / 2) - $this->tileSize * ($this->centerY - $this->latToTile($p1->y(), $this->zoom))
+			);
+			$extPoints [] = $x;
+			$extPoints [] = $y;
+		}
+		// print_r('points:('.($i-1).')<br />');
+		// print_r($extPoints);
+		// imagepolygon ($this->image, $extPoints, $i-1, $colour );
+		imagefilledpolygon($this->image, $extPoints, $i - 1, $colour);
+	}
+
+	/**
+	 * Draw a line on the map.
+	 *
+	 * @param LineString $line
+	 * @param int        $colour
+	 *            drawing colour
+	 */
+	private function drawLineString($line, $colour) {
+		imagesetthickness($this->image, 2);
+		for($p = 1; $p < $line->numGeometries(); $p++) {
+			// get first pair of points
+			$p1 = $line->geometryN($p);
+			$p2 = $line->geometryN($p + 1);
+			// translate to paper space
+			$x1 = floor(
+				($this->width / 2) - $this->tileSize * ($this->centerX - $this->lonToTile($p1->x(), $this->zoom))
+			);
+			$y1 = floor(
+				($this->height / 2) - $this->tileSize * ($this->centerY - $this->latToTile($p1->y(), $this->zoom))
+			);
+			$x2 = floor(
+				($this->width / 2) - $this->tileSize * ($this->centerX - $this->lonToTile($p2->x(), $this->zoom))
+			);
+			$y2 = floor(
+				($this->height / 2) - $this->tileSize * ($this->centerY - $this->latToTile($p2->y(), $this->zoom))
+			);
+			// draw to image
+			imageline($this->image, $x1, $y1, $x2, $y2, $colour);
+		}
+		imagesetthickness($this->image, 1);
+	}
+
+	/**
+	 * Draw a point on the map.
+	 *
+	 * @param Point $point
+	 * @param int   $colour
+	 *            drawing colour
+	 */
+	private function drawPoint($point, $colour) {
+		imagesetthickness($this->image, 2);
+		// translate to paper space
+		$cx = floor(
+			($this->width / 2) - $this->tileSize * ($this->centerX - $this->lonToTile($point->x(), $this->zoom))
+		);
+		$cy = floor(
+			($this->height / 2) - $this->tileSize * ($this->centerY - $this->latToTile($point->y(), $this->zoom))
+		);
+		$r  = 5;
+		// draw to image
+		// imageellipse($this->image, $cx, $cy,$r, $r, $colour);
+		imagefilledellipse($this->image, $cx, $cy, $r, $r, $colour);
+		// don't use imageellipse because the imagesetthickness function has
+		// no effect. So the better workaround is to use imagearc.
+		imagearc($this->image, $cx, $cy, $r, $r, 0, 359, $colour);
+		imagesetthickness($this->image, 1);
+	}
+
+	/**
+	 * Draw gpx trace on the map.
+	 * @throws exception when loading the GPX fails
+	 */
+	public function drawGPX() {
+		$col     = imagecolorallocatealpha($this->image, 0, 0, 255, .4 * 127);
+		$gpxgeom = geoPHP::load(file_get_contents($this->gpxFileName), 'gpx');
+		$this->drawGeometry($gpxgeom, $col);
+	}
+
+	/**
+	 * Draw geojson on the map.
+	 * @throws exception when loading the JSON fails
+	 */
+	public function drawGeojson() {
+		$col     = imagecolorallocatealpha($this->image, 255, 0, 255, .4 * 127);
+		$gpxgeom = geoPHP::load(file_get_contents($this->geojsonFileName), 'json');
+		$this->drawGeometry($gpxgeom, $col);
+	}
+
+	/**
+	 * add copyright and origin notice and icons to the map.
+	 */
+	public function drawCopyright() {
+		$logoBaseDir = dirname(__FILE__) . '/' . 'logo/';
+		$logoImg     = imagecreatefrompng($logoBaseDir . $this->tileInfo ['openstreetmap'] ['logo']);
+		$textcolor   = imagecolorallocate($this->image, 0, 0, 0);
+		$bgcolor     = imagecolorallocate($this->image, 200, 200, 200);
+
+		imagecopy(
+			$this->image,
+			$logoImg,
+			0,
+			imagesy($this->image) - imagesy($logoImg),
+			0,
+			0,
+			imagesx($logoImg),
+			imagesy($logoImg)
+		);
+		imagestring(
+			$this->image,
+			1,
+			imagesx($logoImg) + 2,
+			imagesy($this->image) - imagesy($logoImg) + 1,
+			$this->tileInfo ['openstreetmap'] ['txt'],
+			$bgcolor
+		);
+		imagestring(
+			$this->image,
+			1,
+			imagesx($logoImg) + 1,
+			imagesy($this->image) - imagesy($logoImg),
+			$this->tileInfo ['openstreetmap'] ['txt'],
+			$textcolor
+		);
+
+		// additional tile source info, ie. who created/hosted the tiles
+		$xIconOffset = 0;
+		if($this->maptype === 'openstreetmap') {
+			$mapAuthor = "(c) OpenStreetMap maps/CC BY-SA";
+		} else {
+			$mapAuthor   = $this->tileInfo [$this->maptype] ['txt'];
+			$iconImg     = imagecreatefrompng($logoBaseDir . $this->tileInfo [$this->maptype] ['logo']);
+			$xIconOffset = imagesx($iconImg);
+			imagecopy(
+				$this->image,
+				$iconImg, imagesx($logoImg) + 1,
+				imagesy($this->image) - imagesy($iconImg),
+				0,
+				0,
+				imagesx($iconImg), imagesy($iconImg)
+			);
+		}
+		imagestring(
+			$this->image,
+			1, imagesx($logoImg) + $xIconOffset + 4,
+			imagesy($this->image) - ceil(imagesy($logoImg) / 2) + 1,
+			$mapAuthor,
+			$bgcolor
+		);
+		imagestring(
+			$this->image,
+			1, imagesx($logoImg) + $xIconOffset + 3,
+			imagesy($this->image) - ceil(imagesy($logoImg) / 2),
+			$mapAuthor,
+			$textcolor
+		);
+
+	}
 }

Spacing +65 added lines, -65 removed lines

@@ -28,7 +28,7 @@ 
 
 // phpcs:disable PSR1.Files.SideEffects
 // TODO resolve side effect
-require_once __DIR__ . '/../geophp/vendor/autoload.php';
+require_once __DIR__.'/../geophp/vendor/autoload.php';
 
 /**
  *
@@ -212,7 +212,7 @@ 
         $this->height = $height;
         // validate + set maptype
         $this->maptype = $this->tileDefaultSrc;
-        if(array_key_exists($maptype, $this->tileInfo)) {
+        if (array_key_exists($maptype, $this->tileInfo)) {
             $this->maptype = $maptype;
         }
         $this->markers          = $markers;
@@ -220,9 +220,9 @@ 
         $this->gpxFileName      = $gpx;
         $this->geojsonFileName  = $geojson;
         $this->mediaBaseDir     = $mediaDir;
-        $this->tileCacheBaseDir = $tileCacheBaseDir . '/olmaptiles';
+        $this->tileCacheBaseDir = $tileCacheBaseDir.'/olmaptiles';
         $this->useTileCache     = $this->tileCacheBaseDir !== '';
-        $this->mapCacheBaseDir  = $mediaDir . '/olmapmaps';
+        $this->mapCacheBaseDir  = $mediaDir.'/olmapmaps';
         $this->autoZoomExtent   = $autoZoomExtent;
         $this->apikey           = $apikey;
     }
@@ -234,15 +234,15 @@ 
      */
     public function getMap(): string {
         try {
-            if($this->autoZoomExtent) {
+            if ($this->autoZoomExtent) {
                 $this->autoZoom();
             }
-        } catch(Exception $e) {
+        } catch (Exception $e) {
             dbglog($e);
         }
 
         // use map cache, so check cache for map
-        if(!$this->checkMapCache()) {
+        if (!$this->checkMapCache()) {
             // map is not in cache, needs to be build
             $this->makeMap();
             $this->mkdirRecursive(dirname($this->mapCacheIDToFilename()), 0777);
@@ -262,37 +262,37 @@ 
      */
     private function autoZoom(float $paddingFactor = 1.0): void {
         $geoms    = array();
-        $geoms [] = new Point ($this->lon, $this->lat);
-        if(!empty ($this->markers)) {
-            foreach($this->markers as $marker) {
-                $geoms [] = new Point ($marker ['lon'], $marker ['lat']);
+        $geoms [] = new Point($this->lon, $this->lat);
+        if (!empty ($this->markers)) {
+            foreach ($this->markers as $marker) {
+                $geoms [] = new Point($marker ['lon'], $marker ['lat']);
             }
         }
-        if(file_exists($this->kmlFileName)) {
+        if (file_exists($this->kmlFileName)) {
             $g = geoPHP::load(file_get_contents($this->kmlFileName), 'kml');
-            if($g !== false) {
+            if ($g !== false) {
                 $geoms [] = $g;
             }
         }
-        if(file_exists($this->gpxFileName)) {
+        if (file_exists($this->gpxFileName)) {
             $g = geoPHP::load(file_get_contents($this->gpxFileName), 'gpx');
-            if($g !== false) {
+            if ($g !== false) {
                 $geoms [] = $g;
             }
         }
-        if(file_exists($this->geojsonFileName)) {
+        if (file_exists($this->geojsonFileName)) {
             $g = geoPHP::load(file_get_contents($this->geojsonFileName), 'geojson');
-            if($g !== false) {
+            if ($g !== false) {
                 $geoms [] = $g;
             }
         }
 
-        if(count($geoms) <= 1) {
+        if (count($geoms) <= 1) {
             dbglog($geoms, "StaticMap::autoZoom: Skip setting autozoom options");
             return;
         }
 
-        $geom     = new GeometryCollection ($geoms);
+        $geom     = new GeometryCollection($geoms);
         $centroid = $geom->centroid();
         $bbox     = $geom->getBBox();
 
@@ -301,7 +301,7 @@ 
         $vy0 = log(tan(M_PI * (0.25 + $bbox ['miny'] / 360)));
         $vy1 = log(tan(M_PI * (0.25 + $bbox ['maxy'] / 360)));
         dbglog("StaticMap::autoZoom: vertical resolution: $vy0, $vy1");
-        if ($vy1 - $vy0 === 0.0){
+        if ($vy1 - $vy0 === 0.0) {
             $resolutionVertical = 0;
             dbglog("StaticMap::autoZoom: using $resolutionVertical");
         } else {
@@ -313,11 +313,11 @@ 
         dbglog("StaticMap::autoZoom: using $resolutionHorizontal");
         $resolution           = max($resolutionHorizontal, $resolutionVertical) * $paddingFactor;
         $zoom                 = $this->zoom;
-        if ($resolution > 0){
+        if ($resolution > 0) {
             $zoom             = log(360 / ($resolution * $this->tileSize), 2);
         }
 
-        if(is_finite($zoom) && $zoom < 15 && $zoom > 2) {
+        if (is_finite($zoom) && $zoom < 15 && $zoom > 2) {
             $this->zoom = floor($zoom);
         }
         $this->lon = $centroid->getX();
@@ -350,12 +350,12 @@ 
     }
 
     public function mapCacheIDToFilename(): string {
-        if(!$this->mapCacheFile) {
-            $this->mapCacheFile = $this->mapCacheBaseDir . "/" . $this->maptype . "/" . $this->zoom . "/cache_"
-                . substr($this->mapCacheID, 0, 2) . "/" . substr($this->mapCacheID, 2, 2)
-                . "/" . substr($this->mapCacheID, 4);
+        if (!$this->mapCacheFile) {
+            $this->mapCacheFile = $this->mapCacheBaseDir."/".$this->maptype."/".$this->zoom."/cache_"
+                . substr($this->mapCacheID, 0, 2)."/".substr($this->mapCacheID, 2, 2)
+                . "/".substr($this->mapCacheID, 4);
         }
-        return $this->mapCacheFile . "." . $this->mapCacheExtension;
+        return $this->mapCacheFile.".".$this->mapCacheExtension;
     }
 
     /**
@@ -364,7 +364,7 @@ 
     public function makeMap(): void {
         $this->initCoords();
         $this->createBaseMap();
-        if(!empty ($this->markers)) {
+        if (!empty ($this->markers)) {
             $this->placeMarkers();
         }
         if (file_exists($this->kmlFileName)) {
@@ -437,8 +437,8 @@ 
         $this->offsetX += floor($startX - floor($this->centerX)) * $this->tileSize;
         $this->offsetY += floor($startY - floor($this->centerY)) * $this->tileSize;
 
-        for($x = $startX; $x <= $endX; $x++) {
-            for($y = $startY; $y <= $endY; $y++) {
+        for ($x = $startX; $x <= $endX; $x++) {
+            for ($y = $startY; $y <= $endY; $y++) {
                 $url = str_replace(
                     array(
                         '{Z}',
@@ -452,7 +452,7 @@ 
                 );
 
                 $tileData = $this->fetchTile($url);
-                if($tileData) {
+                if ($tileData) {
                     $tileImage = imagecreatefromstring($tileData);
                 } else {
                     $tileImage = imagecreate($this->tileSize, $this->tileSize);
@@ -478,17 +478,17 @@ 
      *          for better proxy handling...
      */
     public function fetchTile(string $url) {
-        if($this->useTileCache && ($cached = $this->checkTileCache($url)))
+        if ($this->useTileCache && ($cached = $this->checkTileCache($url)))
             return $cached;
 
-        $_UA = 'Mozilla/4.0 (compatible; DokuWikiSpatial HTTP Client; ' . PHP_OS . ')';
-        if(function_exists("curl_init")) {
+        $_UA = 'Mozilla/4.0 (compatible; DokuWikiSpatial HTTP Client; '.PHP_OS.')';
+        if (function_exists("curl_init")) {
             // use cUrl
             $ch = curl_init();
             curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
             curl_setopt($ch, CURLOPT_USERAGENT, $_UA);
             curl_setopt($ch, CURLOPT_CONNECTTIMEOUT, 10);
-            curl_setopt($ch, CURLOPT_URL, $url . $this->apikey);
+            curl_setopt($ch, CURLOPT_URL, $url.$this->apikey);
             dbglog("StaticMap::fetchTile: getting: $url using curl_exec");
             $tile = curl_exec($ch);
             curl_close($ch);
@@ -498,21 +498,21 @@ 
             $opts = array(
                 'http' => array(
                     'method'          => "GET",
-                    'header'          => "Accept-language: en\r\n" . "User-Agent: $_UA\r\n" . "accept: image/png\r\n",
+                    'header'          => "Accept-language: en\r\n"."User-Agent: $_UA\r\n"."accept: image/png\r\n",
                     'request_fulluri' => true
                 )
             );
-            if(isset($conf['proxy']['host'], $conf['proxy']['port'])
+            if (isset($conf['proxy']['host'], $conf['proxy']['port'])
                 && $conf['proxy']['host'] !== ''
                 && $conf['proxy']['port'] !== '') {
-                $opts['http'] += ['proxy' => "tcp://" . $conf['proxy']['host'] . ":" . $conf['proxy']['port']];
+                $opts['http'] += ['proxy' => "tcp://".$conf['proxy']['host'].":".$conf['proxy']['port']];
             }
 
             $context = stream_context_create($opts);
             dbglog("StaticMap::fetchTile: getting: $url . $this->apikey using file_get_contents and options $opts");
-            $tile = file_get_contents($url . $this->apikey, false, $context);
+            $tile = file_get_contents($url.$this->apikey, false, $context);
         }
-        if($tile && $this->useTileCache) {
+        if ($tile && $this->useTileCache) {
             $this->writeTileToCache($url, $tile);
         }
         return $tile;
@@ -525,7 +525,7 @@ 
      */
     public function checkTileCache(string $url) {
         $filename = $this->tileUrlToFilename($url);
-        if(file_exists($filename)) {
+        if (file_exists($filename)) {
             return file_get_contents($filename);
         }
         return false;
@@ -537,7 +537,7 @@ 
      * @return string
      */
     public function tileUrlToFilename(string $url): string {
-        return $this->tileCacheBaseDir . "/" . substr($url, strpos($url, '/') + 1);
+        return $this->tileCacheBaseDir."/".substr($url, strpos($url, '/') + 1);
     }
 
     /**
@@ -572,14 +572,14 @@ 
         $count         = 0;
         $color         = imagecolorallocate($this->image, 0, 0, 0);
         $bgcolor       = imagecolorallocate($this->image, 200, 200, 200);
-        $markerBaseDir = __DIR__ . '/icons';
+        $markerBaseDir = __DIR__.'/icons';
         $markerImageOffsetX  = 0;
         $markerImageOffsetY  = 0;
         $markerShadowOffsetX = 0;
         $markerShadowOffsetY = 0;
         $markerShadowImg     = null;
         // loop thru marker array
-        foreach($this->markers as $marker) {
+        foreach ($this->markers as $marker) {
             // set some local variables
             $markerLat  = $marker ['lat'];
             $markerLon  = $marker ['lon'];
@@ -589,18 +589,18 @@ 
             $markerShadow   = '';
             $matches        = false;
             // check for marker type, get settings from markerPrototypes
-            if($markerType) {
-                foreach($this->markerPrototypes as $markerPrototype) {
-                    if(preg_match($markerPrototype ['regex'], $markerType, $matches)) {
-                        $markerFilename = $matches [0] . $markerPrototype ['extension'];
-                        if($markerPrototype ['offsetImage']) {
+            if ($markerType) {
+                foreach ($this->markerPrototypes as $markerPrototype) {
+                    if (preg_match($markerPrototype ['regex'], $markerType, $matches)) {
+                        $markerFilename = $matches [0].$markerPrototype ['extension'];
+                        if ($markerPrototype ['offsetImage']) {
                             list ($markerImageOffsetX, $markerImageOffsetY) = explode(
                                 ",",
                                 $markerPrototype ['offsetImage']
                             );
                         }
                         $markerShadow = $markerPrototype ['shadow'];
-                        if($markerShadow) {
+                        if ($markerShadow) {
                             list ($markerShadowOffsetX, $markerShadowOffsetY) = explode(
                                 ",",
                                 $markerPrototype ['offsetShadow']
@@ -610,14 +610,14 @@ 
                 }
             }
             // create img resource
-            if(file_exists($markerBaseDir . '/' . $markerFilename)) {
-                $markerImg = imagecreatefrompng($markerBaseDir . '/' . $markerFilename);
+            if (file_exists($markerBaseDir.'/'.$markerFilename)) {
+                $markerImg = imagecreatefrompng($markerBaseDir.'/'.$markerFilename);
             } else {
-                $markerImg = imagecreatefrompng($markerBaseDir . '/marker.png');
+                $markerImg = imagecreatefrompng($markerBaseDir.'/marker.png');
             }
             // check for shadow + create shadow recource
-            if($markerShadow && file_exists($markerBaseDir . '/' . $markerShadow)) {
-                $markerShadowImg = imagecreatefrompng($markerBaseDir . '/' . $markerShadow);
+            if ($markerShadow && file_exists($markerBaseDir.'/'.$markerShadow)) {
+                $markerShadowImg = imagecreatefrompng($markerBaseDir.'/'.$markerShadow);
             }
             // calc position
             $destX = floor(
@@ -629,7 +629,7 @@ 
                 $this->tileSize * ($this->centerY - $this->latToTile($markerLat, $this->zoom))
             );
             // copy shadow on basemap
-            if($markerShadow && $markerShadowImg) {
+            if ($markerShadow && $markerShadowImg) {
                 imagecopy(
                     $this->image,
                     $markerShadowImg,
@@ -691,14 +691,14 @@ 
      *            drawing colour
      */
     private function drawGeometry(Geometry $geom, int $colour): void {
-        if(empty($geom)) {
+        if (empty($geom)) {
             return;
         }
 
-        switch($geom->geometryType()) {
+        switch ($geom->geometryType()) {
             case 'GeometryCollection' :
                 // recursively draw part of the collection
-                for($i = 1; $i < $geom->numGeometries() + 1; $i++) {
+                for ($i = 1; $i < $geom->numGeometries() + 1; $i++) {
                     $_geom = $geom->geometryN($i);
                     $this->drawGeometry($_geom, $colour);
                 }
@@ -740,7 +740,7 @@ 
         // extring is a linestring actually..
         $extRing = $polygon->exteriorRing();
 
-        for($i = 1; $i < $extRing->numGeometries(); $i++) {
+        for ($i = 1; $i < $extRing->numGeometries(); $i++) {
             $p1           = $extRing->geometryN($i);
             $x            = floor(
                 ($this->width / 2) - $this->tileSize * ($this->centerX - $this->lonToTile($p1->x(), $this->zoom))
@@ -766,7 +766,7 @@ 
      */
     private function drawLineString($line, $colour) {
         imagesetthickness($this->image, 2);
-        for($p = 1; $p < $line->numGeometries(); $p++) {
+        for ($p = 1; $p < $line->numGeometries(); $p++) {
             // get first pair of points
             $p1 = $line->geometryN($p);
             $p2 = $line->geometryN($p + 1);
@@ -839,8 +839,8 @@ 
      * add copyright and origin notice and icons to the map.
      */
     public function drawCopyright() {
-        $logoBaseDir = dirname(__FILE__) . '/' . 'logo/';
-        $logoImg     = imagecreatefrompng($logoBaseDir . $this->tileInfo ['openstreetmap'] ['logo']);
+        $logoBaseDir = dirname(__FILE__).'/'.'logo/';
+        $logoImg     = imagecreatefrompng($logoBaseDir.$this->tileInfo ['openstreetmap'] ['logo']);
         $textcolor   = imagecolorallocate($this->image, 0, 0, 0);
         $bgcolor     = imagecolorallocate($this->image, 200, 200, 200);
 
@@ -873,11 +873,11 @@ 
 
         // additional tile source info, ie. who created/hosted the tiles
         $xIconOffset = 0;
-        if($this->maptype === 'openstreetmap') {
+        if ($this->maptype === 'openstreetmap') {
             $mapAuthor = "(c) OpenStreetMap maps/CC BY-SA";
         } else {
             $mapAuthor   = $this->tileInfo [$this->maptype] ['txt'];
-            $iconImg     = imagecreatefrompng($logoBaseDir . $this->tileInfo [$this->maptype] ['logo']);
+            $iconImg     = imagecreatefrompng($logoBaseDir.$this->tileInfo [$this->maptype] ['logo']);
             $xIconOffset = imagesx($iconImg);
             imagecopy(
                 $this->image,