xref: /plugin/openlayersmap/StaticMap.php (revision c8eb13626ece0cdbb2369662b8c76ea8fa800c3a)
1628e43ccSMark Prins<?php
2628e43ccSMark Prins/*
3c878d083SMark Prins * Copyright (c) 2012-2018 Mark C. Prins <mprins@users.sf.net>
4628e43ccSMark Prins *
5f4b9bdacSMark Prins * In part based on staticMapLite 0.03 available at http://staticmaplite.svn.sourceforge.net/viewvc/staticmaplite/
6628e43ccSMark Prins *
7628e43ccSMark Prins * Copyright (c) 2009 Gerhard Koch <gerhard.koch AT ymail.com>
8628e43ccSMark Prins *
9628e43ccSMark Prins * Licensed under the Apache License, Version 2.0 (the "License");
10628e43ccSMark Prins * you may not use this file except in compliance with the License.
11628e43ccSMark Prins * You may obtain a copy of the License at
12628e43ccSMark Prins *
13628e43ccSMark Prins *     http://www.apache.org/licenses/LICENSE-2.0
14628e43ccSMark Prins *
15628e43ccSMark Prins * Unless required by applicable law or agreed to in writing, software
16628e43ccSMark Prins * distributed under the License is distributed on an "AS IS" BASIS,
17628e43ccSMark Prins * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
18628e43ccSMark Prins * See the License for the specific language governing permissions and
19628e43ccSMark Prins * limitations under the License.
20628e43ccSMark Prins */
21f4b9bdacSMark Prinsinclude_once (realpath ( dirname ( __FILE__ ) ) . '/../geophp/geoPHP/geoPHP.inc');
22628e43ccSMark Prins/**
23ab8cbd2bSMark Prins *
24628e43ccSMark Prins * @author Mark C. Prins <mprins@users.sf.net>
25628e43ccSMark Prins * @author Gerhard Koch <gerhard.koch AT ymail.com>
26628e43ccSMark Prins *
27628e43ccSMark Prins */
28628e43ccSMark Prinsclass StaticMap {
29ab8cbd2bSMark Prins	// this should probably not be changed
30628e43ccSMark Prins	protected $tileSize = 256;
31628e43ccSMark Prins
32628e43ccSMark Prins	// the final output
33628e43ccSMark Prins	var $doc = '';
34628e43ccSMark Prins
35628e43ccSMark Prins	protected $tileInfo = array (
36628e43ccSMark Prins			// OSM sources
37628e43ccSMark Prins			'openstreetmap' => array (
38628e43ccSMark Prins					'txt' => '(c) OpenStreetMap CC-BY-SA',
39628e43ccSMark Prins					'logo' => 'osm_logo.png',
40ab8cbd2bSMark Prins					'url' => 'http://tile.openstreetmap.org/{Z}/{X}/{Y}.png'
41ab8cbd2bSMark Prins			),
42628e43ccSMark Prins			// OCM sources
43628e43ccSMark Prins			'cycle' => array (
44628e43ccSMark Prins					'txt' => 'OpenCycleMap tiles',
45628e43ccSMark Prins					'logo' => 'cycle_logo.png',
46c878d083SMark Prins					'url' => 'https://tile.thunderforest.com/cycle/{Z}/{X}/{Y}.png?apikey='
47ab8cbd2bSMark Prins			),
48628e43ccSMark Prins			'transport' => array (
49628e43ccSMark Prins					'txt' => 'OpenCycleMap tiles',
50628e43ccSMark Prins					'logo' => 'cycle_logo.png',
51c878d083SMark Prins					'url' => 'https://tile.thunderforest.com/transport/{Z}/{X}/{Y}.png?apikey='
52ab8cbd2bSMark Prins			),
53628e43ccSMark Prins			'landscape' => array (
54628e43ccSMark Prins					'txt' => 'OpenCycleMap tiles',
55628e43ccSMark Prins					'logo' => 'cycle_logo.png',
56c878d083SMark Prins					'url' => 'https://tile.thunderforest.com/landscape/{Z}/{X}/{Y}.png?apikey='
575c603532SMark Prins			),
585c603532SMark Prins			'outdoors' => array (
595c603532SMark Prins					'txt' => 'OpenCycleMap tiles',
605c603532SMark Prins					'logo' => 'cycle_logo.png',
61c878d083SMark Prins					'url' => 'https://tile.thunderforest.com/outdoors/{Z}/{X}/{Y}.png?apikey='
62ab8cbd2bSMark Prins			),
63e72390dbSMark Prins			'toner-lite' => array (
645c603532SMark Prins					'txt' => 'Stamen tiles',
65e72390dbSMark Prins					'logo' => 'stamen.png',
66e72390dbSMark Prins					'url' => 'http://tile.stamen.com/toner-lite/{Z}/{X}/{Y}.png'
67e72390dbSMark Prins			),
68e72390dbSMark Prins			'terrain' => array (
695c603532SMark Prins					'txt' => 'Stamen tiles',
70e72390dbSMark Prins					'logo' => 'stamen.png',
71e72390dbSMark Prins					'url' => 'http://tile.stamen.com/terrain/{Z}/{X}/{Y}.png'
72ab8cbd2bSMark Prins			),
73628e43ccSMark Prins			// 'piste'=>array(
74628e43ccSMark Prins			// 'txt'=>'OpenPisteMap tiles',
75628e43ccSMark Prins			// 'logo'=>'piste_logo.png',
76628e43ccSMark Prins			// 'url'=>''),
77628e43ccSMark Prins			// 'sea'=>array(
78628e43ccSMark Prins			// 'txt'=>'OpenSeaMap tiles',
79628e43ccSMark Prins			// 'logo'=>'sea_logo.png',
80628e43ccSMark Prins			// 'url'=>''),
81e72390dbSMark Prins			// H&B sources
82e72390dbSMark Prins			'hikeandbike' => array (
83e72390dbSMark Prins					'txt' => 'Hike & Bike Map',
84e72390dbSMark Prins					'logo' => 'hnb_logo.png',
85504fe8a3SMark Prins					//'url' => 'http://toolserver.org/tiles/hikebike/{Z}/{X}/{Y}.png'
86504fe8a3SMark Prins					//moved to: https://www.toolserver.org/tiles/hikebike/12/2105/1388.png
87504fe8a3SMark Prins					'url' => 'http://c.tiles.wmflabs.org/hikebike/{Z}/{X}/{Y}.png'
88ab8cbd2bSMark Prins			)
89628e43ccSMark Prins	);
90628e43ccSMark Prins	protected $tileDefaultSrc = 'openstreetmap';
91628e43ccSMark Prins
92628e43ccSMark Prins	// set up markers
93628e43ccSMark Prins	protected $markerPrototypes = array (
94628e43ccSMark Prins			// found at http://www.mapito.net/map-marker-icons.html
95628e43ccSMark Prins			// these are 17x19 px with a pointer at the bottom left
96ab8cbd2bSMark Prins			'lightblue' => array (
97ab8cbd2bSMark Prins					'regex' => '/^lightblue([0-9]+)$/',
98628e43ccSMark Prins					'extension' => '.png',
99628e43ccSMark Prins					'shadow' => false,
100628e43ccSMark Prins					'offsetImage' => '0,-19',
101628e43ccSMark Prins					'offsetShadow' => false
102628e43ccSMark Prins			),
103628e43ccSMark Prins			// openlayers std markers are 21x25px with shadow
104ab8cbd2bSMark Prins			'ol-marker' => array (
105ab8cbd2bSMark Prins					'regex' => '/^marker(|-blue|-gold|-green|-red)+$/',
106628e43ccSMark Prins					'extension' => '.png',
107628e43ccSMark Prins					'shadow' => 'marker_shadow.png',
108628e43ccSMark Prins					'offsetImage' => '-10,-25',
109628e43ccSMark Prins					'offsetShadow' => '-1,-13'
110628e43ccSMark Prins			),
111628e43ccSMark Prins			// these are 16x16 px
112ab8cbd2bSMark Prins			'ww_icon' => array (
113ab8cbd2bSMark Prins					'regex' => '/ww_\S+$/',
114628e43ccSMark Prins					'extension' => '.png',
115628e43ccSMark Prins					'shadow' => false,
116628e43ccSMark Prins					'offsetImage' => '-8,-8',
117628e43ccSMark Prins					'offsetShadow' => false
118628e43ccSMark Prins			),
119628e43ccSMark Prins			// assume these are 16x16 px
120ab8cbd2bSMark Prins			'rest' => array (
121ab8cbd2bSMark Prins					'regex' => '/^(?!lightblue([0-9]+)$)(?!(ww_\S+$))(?!marker(|-blue|-gold|-green|-red)+$)(.*)/',
122628e43ccSMark Prins					'extension' => '.png',
123628e43ccSMark Prins					'shadow' => 'marker_shadow.png',
124628e43ccSMark Prins					'offsetImage' => '-8,-8',
125628e43ccSMark Prins					'offsetShadow' => '-1,-1'
126628e43ccSMark Prins			)
127628e43ccSMark Prins	);
128628e43ccSMark Prins	protected $centerX, $centerY, $offsetX, $offsetY, $image;
1295c603532SMark Prins	protected $zoom, $lat, $lon, $width, $height, $markers, $maptype, $kmlFileName, $gpxFileName, $geojsonFileName, $autoZoomExtent, $apikey;
130628e43ccSMark Prins	protected $tileCacheBaseDir, $mapCacheBaseDir, $mediaBaseDir;
131628e43ccSMark Prins	protected $useTileCache = true;
132628e43ccSMark Prins	protected $mapCacheID = '';
133628e43ccSMark Prins	protected $mapCacheFile = '';
134628e43ccSMark Prins	protected $mapCacheExtension = 'png';
135628e43ccSMark Prins
136628e43ccSMark Prins	/**
137f4b9bdacSMark Prins	 * Constructor.
138ab8cbd2bSMark Prins	 *
139ab8cbd2bSMark Prins	 * @param float $lat
140ab8cbd2bSMark Prins	 *        	Latitude (x) of center of map
141ab8cbd2bSMark Prins	 * @param float $lon
142ab8cbd2bSMark Prins	 *        	Longitude (y) of center of map
143ab8cbd2bSMark Prins	 * @param int $zoom
144ab8cbd2bSMark Prins	 *        	Zoomlevel
145ab8cbd2bSMark Prins	 * @param int $width
146ab8cbd2bSMark Prins	 *        	Width in pixels
147ab8cbd2bSMark Prins	 * @param int $height
148ab8cbd2bSMark Prins	 *        	Height in pixels
149ab8cbd2bSMark Prins	 * @param string $maptype
150ab8cbd2bSMark Prins	 *        	Name of the map
151ab8cbd2bSMark Prins	 * @param mixed $markers
152ab8cbd2bSMark Prins	 *        	array of markers
153ab8cbd2bSMark Prins	 * @param string $gpx
154ab8cbd2bSMark Prins	 *        	GPX filename
155ab8cbd2bSMark Prins	 * @param string $kml
156ab8cbd2bSMark Prins	 *        	KML filename
157ab8cbd2bSMark Prins	 * @param string $mediaDir
158ab8cbd2bSMark Prins	 *        	Directory to store/cache maps
159ab8cbd2bSMark Prins	 * @param string $tileCacheBaseDir
160ab8cbd2bSMark Prins	 *        	Directory to cache map tiles
161ab8cbd2bSMark Prins	 * @param boolean $autoZoomExtent
162ab8cbd2bSMark Prins	 *        	Wheter or not to override zoom/lat/lon and zoom to the extent of gpx/kml and markers
1635c603532SMark Prins	 * @param apikey
1645c603532SMark Prins	 *          Some service require a key to access
165628e43ccSMark Prins	 */
1665c603532SMark Prins	public function __construct($lat, $lon, $zoom, $width, $height, $maptype, $markers, $gpx, $kml, $geojson, $mediaDir, $tileCacheBaseDir, $autoZoomExtent = TRUE, $apikey = '') {
167628e43ccSMark Prins		$this->zoom = $zoom;
168628e43ccSMark Prins		$this->lat = $lat;
169628e43ccSMark Prins		$this->lon = $lon;
170628e43ccSMark Prins		$this->width = $width;
171628e43ccSMark Prins		$this->height = $height;
172628e43ccSMark Prins		// validate + set maptype
173628e43ccSMark Prins		$this->maptype = $this->tileDefaultSrc;
174628e43ccSMark Prins		if (array_key_exists ( $maptype, $this->tileInfo )) {
175628e43ccSMark Prins			$this->maptype = $maptype;
176628e43ccSMark Prins		}
1772d11d700SMark Prins		$this->markers = $markers;
1782d11d700SMark Prins		$this->kmlFileName = $kml;
1792d11d700SMark Prins		$this->gpxFileName = $gpx;
1806914b920SMark Prins		$this->geojsonFileName = $geojson;
1812d11d700SMark Prins		$this->mediaBaseDir = $mediaDir;
182628e43ccSMark Prins		$this->tileCacheBaseDir = $tileCacheBaseDir . '/olmaptiles';
183628e43ccSMark Prins		$this->useTileCache = $this->tileCacheBaseDir !== '';
184628e43ccSMark Prins		$this->mapCacheBaseDir = $mediaDir . '/olmapmaps';
1852d11d700SMark Prins		$this->autoZoomExtent = $autoZoomExtent;
1865c603532SMark Prins		$this->apikey = $apikey;
187628e43ccSMark Prins	}
188628e43ccSMark Prins
189628e43ccSMark Prins	/**
190628e43ccSMark Prins	 *
191628e43ccSMark Prins	 * @param number $long
192628e43ccSMark Prins	 * @param number $zoom
193f4b9bdacSMark Prins	 * @return number
194628e43ccSMark Prins	 */
195628e43ccSMark Prins	public function lonToTile($long, $zoom) {
196628e43ccSMark Prins		return (($long + 180) / 360) * pow ( 2, $zoom );
197628e43ccSMark Prins	}
198628e43ccSMark Prins	/**
199628e43ccSMark Prins	 *
200628e43ccSMark Prins	 * @param number $lat
201628e43ccSMark Prins	 * @param number $zoom
202628e43ccSMark Prins	 * @return number
203628e43ccSMark Prins	 */
204628e43ccSMark Prins	public function latToTile($lat, $zoom) {
2052d11d700SMark Prins		return (1 - log ( tan ( $lat * pi () / 180 ) + 1 / cos ( $lat * M_PI / 180 ) ) / M_PI) / 2 * pow ( 2, $zoom );
206628e43ccSMark Prins	}
207f4b9bdacSMark Prins
208628e43ccSMark Prins	/**
209628e43ccSMark Prins	 */
210628e43ccSMark Prins	public function initCoords() {
211628e43ccSMark Prins		$this->centerX = $this->lonToTile ( $this->lon, $this->zoom );
212628e43ccSMark Prins		$this->centerY = $this->latToTile ( $this->lat, $this->zoom );
213628e43ccSMark Prins		$this->offsetX = floor ( (floor ( $this->centerX ) - $this->centerX) * $this->tileSize );
214628e43ccSMark Prins		$this->offsetY = floor ( (floor ( $this->centerY ) - $this->centerY) * $this->tileSize );
215628e43ccSMark Prins	}
216628e43ccSMark Prins
217628e43ccSMark Prins	/**
218628e43ccSMark Prins	 * make basemap image.
219628e43ccSMark Prins	 */
220628e43ccSMark Prins	public function createBaseMap() {
221628e43ccSMark Prins		$this->image = imagecreatetruecolor ( $this->width, $this->height );
222628e43ccSMark Prins		$startX = floor ( $this->centerX - ($this->width / $this->tileSize) / 2 );
223628e43ccSMark Prins		$startY = floor ( $this->centerY - ($this->height / $this->tileSize) / 2 );
224628e43ccSMark Prins		$endX = ceil ( $this->centerX + ($this->width / $this->tileSize) / 2 );
225628e43ccSMark Prins		$endY = ceil ( $this->centerY + ($this->height / $this->tileSize) / 2 );
226628e43ccSMark Prins		$this->offsetX = - floor ( ($this->centerX - floor ( $this->centerX )) * $this->tileSize );
227628e43ccSMark Prins		$this->offsetY = - floor ( ($this->centerY - floor ( $this->centerY )) * $this->tileSize );
228628e43ccSMark Prins		$this->offsetX += floor ( $this->width / 2 );
229628e43ccSMark Prins		$this->offsetY += floor ( $this->height / 2 );
230628e43ccSMark Prins		$this->offsetX += floor ( $startX - floor ( $this->centerX ) ) * $this->tileSize;
231628e43ccSMark Prins		$this->offsetY += floor ( $startY - floor ( $this->centerY ) ) * $this->tileSize;
232628e43ccSMark Prins
233628e43ccSMark Prins		for($x = $startX; $x <= $endX; $x ++) {
234628e43ccSMark Prins			for($y = $startY; $y <= $endY; $y ++) {
235ab8cbd2bSMark Prins				$url = str_replace ( array (
236ab8cbd2bSMark Prins						'{Z}',
237ab8cbd2bSMark Prins						'{X}',
238ab8cbd2bSMark Prins						'{Y}'
239ab8cbd2bSMark Prins				), array (
240ab8cbd2bSMark Prins						$this->zoom,
241ab8cbd2bSMark Prins						$x,
242ab8cbd2bSMark Prins						$y
243ab8cbd2bSMark Prins				), $this->tileInfo [$this->maptype] ['url'] );
244*c8eb1362SMark Prins				$url .= $this->apikey;
245*c8eb1362SMark Prins
246628e43ccSMark Prins				$tileData = $this->fetchTile ( $url );
247628e43ccSMark Prins				if ($tileData) {
248628e43ccSMark Prins					$tileImage = imagecreatefromstring ( $tileData );
249628e43ccSMark Prins				} else {
250628e43ccSMark Prins					$tileImage = imagecreate ( $this->tileSize, $this->tileSize );
251628e43ccSMark Prins					$color = imagecolorallocate ( $tileImage, 255, 255, 255 );
252628e43ccSMark Prins					@imagestring ( $tileImage, 1, 127, 127, 'err', $color );
253628e43ccSMark Prins				}
254628e43ccSMark Prins				$destX = ($x - $startX) * $this->tileSize + $this->offsetX;
255628e43ccSMark Prins				$destY = ($y - $startY) * $this->tileSize + $this->offsetY;
256*c8eb1362SMark Prins				dbglog($this->tileSize,"imagecopy tile into image: $destX, $destY");
257628e43ccSMark Prins				imagecopy ( $this->image, $tileImage, $destX, $destY, 0, 0, $this->tileSize, $this->tileSize );
258628e43ccSMark Prins			}
259628e43ccSMark Prins		}
260628e43ccSMark Prins	}
261628e43ccSMark Prins
262628e43ccSMark Prins	/**
263628e43ccSMark Prins	 * Place markers on the map and number them in the same order as they are listed in the html.
264628e43ccSMark Prins	 */
265628e43ccSMark Prins	public function placeMarkers() {
266628e43ccSMark Prins		$count = 0;
267628e43ccSMark Prins		$color = imagecolorallocate ( $this->image, 0, 0, 0 );
268628e43ccSMark Prins		$bgcolor = imagecolorallocate ( $this->image, 200, 200, 200 );
269628e43ccSMark Prins		$markerBaseDir = dirname ( __FILE__ ) . '/icons';
270628e43ccSMark Prins		// loop thru marker array
271628e43ccSMark Prins		foreach ( $this->markers as $marker ) {
272628e43ccSMark Prins			// set some local variables
273628e43ccSMark Prins			$markerLat = $marker ['lat'];
274628e43ccSMark Prins			$markerLon = $marker ['lon'];
275628e43ccSMark Prins			$markerType = $marker ['type'];
276628e43ccSMark Prins			// clear variables from previous loops
277628e43ccSMark Prins			$markerFilename = '';
278628e43ccSMark Prins			$markerShadow = '';
279628e43ccSMark Prins			$matches = false;
280628e43ccSMark Prins			// check for marker type, get settings from markerPrototypes
281628e43ccSMark Prins			if ($markerType) {
282628e43ccSMark Prins				foreach ( $this->markerPrototypes as $markerPrototype ) {
283628e43ccSMark Prins					if (preg_match ( $markerPrototype ['regex'], $markerType, $matches )) {
284628e43ccSMark Prins						$markerFilename = $matches [0] . $markerPrototype ['extension'];
285628e43ccSMark Prins						if ($markerPrototype ['offsetImage']) {
28682c0f6baSMark Prins							list ( $markerImageOffsetX, $markerImageOffsetY ) = explode ( ",", $markerPrototype ['offsetImage'] );
287628e43ccSMark Prins						}
288628e43ccSMark Prins						$markerShadow = $markerPrototype ['shadow'];
289628e43ccSMark Prins						if ($markerShadow) {
29082c0f6baSMark Prins							list ( $markerShadowOffsetX, $markerShadowOffsetY ) = explode ( ",", $markerPrototype ['offsetShadow'] );
291628e43ccSMark Prins						}
292628e43ccSMark Prins					}
293628e43ccSMark Prins				}
294628e43ccSMark Prins			}
295628e43ccSMark Prins			// create img resource
296628e43ccSMark Prins			if (file_exists ( $markerBaseDir . '/' . $markerFilename )) {
297628e43ccSMark Prins				$markerImg = imagecreatefrompng ( $markerBaseDir . '/' . $markerFilename );
298628e43ccSMark Prins			} else {
299628e43ccSMark Prins				$markerImg = imagecreatefrompng ( $markerBaseDir . '/marker.png' );
300628e43ccSMark Prins			}
301628e43ccSMark Prins			// check for shadow + create shadow recource
302628e43ccSMark Prins			if ($markerShadow && file_exists ( $markerBaseDir . '/' . $markerShadow )) {
303628e43ccSMark Prins				$markerShadowImg = imagecreatefrompng ( $markerBaseDir . '/' . $markerShadow );
304628e43ccSMark Prins			}
305628e43ccSMark Prins			// calc position
306628e43ccSMark Prins			$destX = floor ( ($this->width / 2) - $this->tileSize * ($this->centerX - $this->lonToTile ( $markerLon, $this->zoom )) );
307628e43ccSMark Prins			$destY = floor ( ($this->height / 2) - $this->tileSize * ($this->centerY - $this->latToTile ( $markerLat, $this->zoom )) );
308628e43ccSMark Prins			// copy shadow on basemap
309628e43ccSMark Prins			if ($markerShadow && $markerShadowImg) {
310ab8cbd2bSMark Prins				imagecopy ( $this->image, $markerShadowImg, $destX + intval ( $markerShadowOffsetX ), $destY + intval ( $markerShadowOffsetY ), 0, 0, imagesx ( $markerShadowImg ), imagesy ( $markerShadowImg ) );
311628e43ccSMark Prins			}
312628e43ccSMark Prins			// copy marker on basemap above shadow
313ab8cbd2bSMark Prins			imagecopy ( $this->image, $markerImg, $destX + intval ( $markerImageOffsetX ), $destY + intval ( $markerImageOffsetY ), 0, 0, imagesx ( $markerImg ), imagesy ( $markerImg ) );
314628e43ccSMark Prins			// add label
315628e43ccSMark Prins			imagestring ( $this->image, 3, $destX - imagesx ( $markerImg ) + 1, $destY + intval ( $markerImageOffsetY ) + 1, ++ $count, $bgcolor );
316628e43ccSMark Prins			imagestring ( $this->image, 3, $destX - imagesx ( $markerImg ), $destY + intval ( $markerImageOffsetY ), $count, $color );
317ab8cbd2bSMark Prins		}
318ab8cbd2bSMark Prins		;
319628e43ccSMark Prins	}
32057e65445SMark Prins
321628e43ccSMark Prins	/**
322628e43ccSMark Prins	 *
323628e43ccSMark Prins	 * @param string $url
324628e43ccSMark Prins	 * @return string
325628e43ccSMark Prins	 */
326628e43ccSMark Prins	public function tileUrlToFilename($url) {
327ab8cbd2bSMark Prins		return $this->tileCacheBaseDir . "/" . str_replace ( array (
328ab8cbd2bSMark Prins				'http://'
329ab8cbd2bSMark Prins		), '', $url );
330628e43ccSMark Prins	}
33157e65445SMark Prins
332628e43ccSMark Prins	/**
333628e43ccSMark Prins	 *
334628e43ccSMark Prins	 * @param string $url
335628e43ccSMark Prins	 */
336628e43ccSMark Prins	public function checkTileCache($url) {
337628e43ccSMark Prins		$filename = $this->tileUrlToFilename ( $url );
338628e43ccSMark Prins		if (file_exists ( $filename )) {
339628e43ccSMark Prins			return file_get_contents ( $filename );
340628e43ccSMark Prins		}
341628e43ccSMark Prins	}
342628e43ccSMark Prins	public function checkMapCache() {
343628e43ccSMark Prins		$this->mapCacheID = md5 ( $this->serializeParams () );
344628e43ccSMark Prins		$filename = $this->mapCacheIDToFilename ();
345ab8cbd2bSMark Prins		if (file_exists ( $filename ))
346ab8cbd2bSMark Prins			return true;
347628e43ccSMark Prins	}
348628e43ccSMark Prins	public function serializeParams() {
349ab8cbd2bSMark Prins		return join ( "&", array (
350ab8cbd2bSMark Prins				$this->zoom,
351ab8cbd2bSMark Prins				$this->lat,
352ab8cbd2bSMark Prins				$this->lon,
353ab8cbd2bSMark Prins				$this->width,
354ab8cbd2bSMark Prins				$this->height,
355ab8cbd2bSMark Prins				serialize ( $this->markers ),
356ab8cbd2bSMark Prins				$this->maptype,
357ab8cbd2bSMark Prins				$this->kmlFileName,
358ab8cbd2bSMark Prins				$this->gpxFileName,
359ab8cbd2bSMark Prins				$this->geojsonFileName
360ab8cbd2bSMark Prins		) );
361628e43ccSMark Prins	}
362628e43ccSMark Prins	public function mapCacheIDToFilename() {
363628e43ccSMark Prins		if (! $this->mapCacheFile) {
364628e43ccSMark Prins			$this->mapCacheFile = $this->mapCacheBaseDir . "/" . $this->maptype . "/" . $this->zoom . "/cache_" . substr ( $this->mapCacheID, 0, 2 ) . "/" . substr ( $this->mapCacheID, 2, 2 ) . "/" . substr ( $this->mapCacheID, 4 );
365628e43ccSMark Prins		}
366628e43ccSMark Prins		return $this->mapCacheFile . "." . $this->mapCacheExtension;
367628e43ccSMark Prins	}
36857e65445SMark Prins
3692d11d700SMark Prins	/**
3702d11d700SMark Prins	 * Recursively create the directory.
371ab8cbd2bSMark Prins	 *
372ab8cbd2bSMark Prins	 * @param string $pathname
373ab8cbd2bSMark Prins	 *        	The directory path.
374ab8cbd2bSMark Prins	 * @param int $mode
375ab8cbd2bSMark Prins	 *        	File access mode. For more information on modes, read the details on the chmod manpage.
3762d11d700SMark Prins	 */
377628e43ccSMark Prins	public function mkdir_recursive($pathname, $mode) {
378628e43ccSMark Prins		is_dir ( dirname ( $pathname ) ) || $this->mkdir_recursive ( dirname ( $pathname ), $mode );
379628e43ccSMark Prins		return is_dir ( $pathname ) || @mkdir ( $pathname, $mode );
380628e43ccSMark Prins	}
381628e43ccSMark Prins
3822d11d700SMark Prins	/**
3832d11d700SMark Prins	 * Write a tile into the cache.
384ab8cbd2bSMark Prins	 *
3852d11d700SMark Prins	 * @param string $url
3862d11d700SMark Prins	 * @param mixed $data
3872d11d700SMark Prins	 */
388628e43ccSMark Prins	public function writeTileToCache($url, $data) {
389628e43ccSMark Prins		$filename = $this->tileUrlToFilename ( $url );
390628e43ccSMark Prins		$this->mkdir_recursive ( dirname ( $filename ), 0777 );
391628e43ccSMark Prins		file_put_contents ( $filename, $data );
392628e43ccSMark Prins	}
39357e65445SMark Prins
3942d11d700SMark Prins	/**
3952d11d700SMark Prins	 * Fetch a tile and (if configured) store it in the cache.
396ab8cbd2bSMark Prins	 *
3972d11d700SMark Prins	 * @param string $url
3982d11d700SMark Prins	 */
399628e43ccSMark Prins	public function fetchTile($url) {
400ab8cbd2bSMark Prins		if ($this->useTileCache && ($cached = $this->checkTileCache ( $url )))
401ab8cbd2bSMark Prins			return $cached;
402e4f115f4SMark Prins
403e4f115f4SMark Prins		$_UA = 'Mozilla/4.0 (compatible; DokuWikiSpatial HTTP Client; ' . PHP_OS . ')';
404e4f115f4SMark Prins		if (function_exists ( "curl_init" )) {
405e4f115f4SMark Prins			// use cUrl
406628e43ccSMark Prins			$ch = curl_init ();
407628e43ccSMark Prins			curl_setopt ( $ch, CURLOPT_RETURNTRANSFER, 1 );
408e4f115f4SMark Prins			curl_setopt ( $ch, CURLOPT_USERAGENT, $_UA );
409628e43ccSMark Prins			curl_setopt ( $ch, CURLOPT_CONNECTTIMEOUT, 10 );
410628e43ccSMark Prins			curl_setopt ( $ch, CURLOPT_URL, $url );
411628e43ccSMark Prins			$tile = curl_exec ( $ch );
412628e43ccSMark Prins			curl_close ( $ch );
413e4f115f4SMark Prins		} else {
414e4f115f4SMark Prins			// use file_get_contents
415e4f115f4SMark Prins			global $conf;
416e4f115f4SMark Prins			$opts = array (
417e4f115f4SMark Prins					'http' => array (
418e4f115f4SMark Prins							'method' => "GET",
419ab8cbd2bSMark Prins							'header' => "Accept-language: en\r\n" . "User-Agent: $_UA\r\n" . "accept: image/png\r\n",
420e4f115f4SMark Prins							'proxy' => "tcp://" . $conf ['proxy'] ['host'] . ":" . $conf ['proxy'] ['port'],
421ab8cbd2bSMark Prins							'request_fulluri' => true
422e4f115f4SMark Prins					)
423e4f115f4SMark Prins			);
424e4f115f4SMark Prins			$context = stream_context_create ( $opts );
425e4f115f4SMark Prins			$tile = file_get_contents ( $url, false, $context );
426e4f115f4SMark Prins		}
427628e43ccSMark Prins		if ($tile && $this->useTileCache) {
428628e43ccSMark Prins			$this->writeTileToCache ( $url, $tile );
429628e43ccSMark Prins		}
430628e43ccSMark Prins		return $tile;
431628e43ccSMark Prins	}
432628e43ccSMark Prins
433628e43ccSMark Prins	/**
434628e43ccSMark Prins	 * Draw gpx trace on the map.
435628e43ccSMark Prins	 */
436628e43ccSMark Prins	public function drawGPX() {
437c977deacSMark Prins		$col = imagecolorallocatealpha ( $this->image, 0, 0, 255, .4 * 127 );
4386c6bb022SMark Prins		$gpxgeom = geoPHP::load ( file_get_contents ( $this->gpxFileName ), 'gpx' );
439c977deacSMark Prins		$this->drawGeometry ( $gpxgeom, $col );
440628e43ccSMark Prins	}
441628e43ccSMark Prins
4426914b920SMark Prins	/**
4436914b920SMark Prins	 * Draw geojson on the map.
4446914b920SMark Prins	 */
4456914b920SMark Prins	public function drawGeojson() {
4466914b920SMark Prins		$col = imagecolorallocatealpha ( $this->image, 255, 0, 255, .4 * 127 );
4476914b920SMark Prins		$gpxgeom = geoPHP::load ( file_get_contents ( $this->geojsonFileName ), 'json' );
4486914b920SMark Prins		$this->drawGeometry ( $gpxgeom, $col );
4496914b920SMark Prins	}
45057e65445SMark Prins
451628e43ccSMark Prins	/**
452628e43ccSMark Prins	 * Draw kml trace on the map.
453628e43ccSMark Prins	 */
454628e43ccSMark Prins	public function drawKML() {
4552d11d700SMark Prins		// TODO get colour from kml node (not currently supported in geoPHP)
456c977deacSMark Prins		$col = imagecolorallocatealpha ( $this->image, 255, 0, 0, .4 * 127 );
457c977deacSMark Prins		$kmlgeom = geoPHP::load ( file_get_contents ( $this->kmlFileName ), 'kml' );
458c977deacSMark Prins		$this->drawGeometry ( $kmlgeom, $col );
459c977deacSMark Prins	}
46057e65445SMark Prins
461c977deacSMark Prins	/**
462c977deacSMark Prins	 * Draw geometry or geometry collection on the map.
463ab8cbd2bSMark Prins	 *
464c977deacSMark Prins	 * @param Geometry $geom
465ab8cbd2bSMark Prins	 * @param int $colour
466ab8cbd2bSMark Prins	 *        	drawing colour
467c977deacSMark Prins	 */
468c977deacSMark Prins	private function drawGeometry($geom, $colour) {
4696c6bb022SMark Prins		switch ($geom->geometryType ()) {
470c977deacSMark Prins			case 'GeometryCollection' :
471c977deacSMark Prins				// recursively draw part of the collection
472c977deacSMark Prins				for($i = 1; $i < $geom->numGeometries () + 1; $i ++) {
473c977deacSMark Prins					$_geom = $geom->geometryN ( $i );
474c977deacSMark Prins					$this->drawGeometry ( $_geom, $colour );
475c977deacSMark Prins				}
4766c6bb022SMark Prins				break;
477c977deacSMark Prins			case 'MultiPolygon' :
478c977deacSMark Prins				// TODO implement / do nothing
479c977deacSMark Prins				break;
480c977deacSMark Prins			case 'MultiLineString' :
481c977deacSMark Prins				// TODO implement / do nothing
482c977deacSMark Prins				break;
483c977deacSMark Prins			case 'MultiPoint' :
484c977deacSMark Prins				// TODO implement / do nothing
4856c6bb022SMark Prins				break;
4866c6bb022SMark Prins			case 'Polygon' :
487c977deacSMark Prins				$this->drawPolygon ( $geom, $colour );
488c977deacSMark Prins				break;
489c977deacSMark Prins			case 'LineString' :
490c977deacSMark Prins				$this->drawLineString ( $geom, $colour );
491c977deacSMark Prins				break;
492c977deacSMark Prins			case 'Point' :
493c977deacSMark Prins				$this->drawPoint ( $geom, $colour );
4946c6bb022SMark Prins				break;
4956c6bb022SMark Prins			default :
4962d11d700SMark Prins				// draw nothing
4976c6bb022SMark Prins				break;
4986c6bb022SMark Prins		}
4996c6bb022SMark Prins	}
500c977deacSMark Prins
501e61425c7SMark Prins	/**
502e61425c7SMark Prins	 * Draw a line on the map.
503ab8cbd2bSMark Prins	 *
504e61425c7SMark Prins	 * @param LineString $line
505ab8cbd2bSMark Prins	 * @param int $colour
506ab8cbd2bSMark Prins	 *        	drawing colour
507e61425c7SMark Prins	 */
508da6f229fSMark Prins	private function drawLineString($line, $colour) {
509cc74a83cSMark Prins		imagesetthickness ( $this->image, 2 );
510da6f229fSMark Prins		for($p = 1; $p < $line->numGeometries (); $p ++) {
511da6f229fSMark Prins			// get first pair of points
512da6f229fSMark Prins			$p1 = $line->geometryN ( $p );
513da6f229fSMark Prins			$p2 = $line->geometryN ( $p + 1 );
514da6f229fSMark Prins			// translate to paper space
515da6f229fSMark Prins			$x1 = floor ( ($this->width / 2) - $this->tileSize * ($this->centerX - $this->lonToTile ( $p1->x (), $this->zoom )) );
516da6f229fSMark Prins			$y1 = floor ( ($this->height / 2) - $this->tileSize * ($this->centerY - $this->latToTile ( $p1->y (), $this->zoom )) );
517da6f229fSMark Prins			$x2 = floor ( ($this->width / 2) - $this->tileSize * ($this->centerX - $this->lonToTile ( $p2->x (), $this->zoom )) );
518da6f229fSMark Prins			$y2 = floor ( ($this->height / 2) - $this->tileSize * ($this->centerY - $this->latToTile ( $p2->y (), $this->zoom )) );
519da6f229fSMark Prins			// draw to image
520da6f229fSMark Prins			imageline ( $this->image, $x1, $y1, $x2, $y2, $colour );
521da6f229fSMark Prins		}
522e61425c7SMark Prins		imagesetthickness ( $this->image, 1 );
523da6f229fSMark Prins	}
524c977deacSMark Prins
525e61425c7SMark Prins	/**
526e61425c7SMark Prins	 * Draw a point on the map.
527ab8cbd2bSMark Prins	 *
528e61425c7SMark Prins	 * @param Point $point
529ab8cbd2bSMark Prins	 * @param int $colour
530ab8cbd2bSMark Prins	 *        	drawing colour
531e61425c7SMark Prins	 */
532da6f229fSMark Prins	private function drawPoint($point, $colour) {
533c977deacSMark Prins		imagesetthickness ( $this->image, 2 );
534da6f229fSMark Prins		// translate to paper space
535da6f229fSMark Prins		$cx = floor ( ($this->width / 2) - $this->tileSize * ($this->centerX - $this->lonToTile ( $point->x (), $this->zoom )) );
536da6f229fSMark Prins		$cy = floor ( ($this->height / 2) - $this->tileSize * ($this->centerY - $this->latToTile ( $point->y (), $this->zoom )) );
537cc74a83cSMark Prins		$r = 5;
538da6f229fSMark Prins		// draw to image
539cc74a83cSMark Prins		// imageellipse($this->image, $cx, $cy,$r, $r, $colour);
540cc74a83cSMark Prins		imagefilledellipse ( $this->image, $cx, $cy, $r, $r, $colour );
541cc74a83cSMark Prins		// don't use imageellipse because the imagesetthickness function has
542c977deacSMark Prins		// no effect. So the better workaround is to use imagearc.
543cc74a83cSMark Prins		imagearc ( $this->image, $cx, $cy, $r, $r, 0, 359, $colour );
544e61425c7SMark Prins		imagesetthickness ( $this->image, 1 );
545da6f229fSMark Prins	}
546c977deacSMark Prins
547e61425c7SMark Prins	/**
548e61425c7SMark Prins	 * Draw a polygon on the map.
549ab8cbd2bSMark Prins	 *
550e61425c7SMark Prins	 * @param Polygon $polygon
551ab8cbd2bSMark Prins	 * @param int $colour
552ab8cbd2bSMark Prins	 *        	drawing colour
553e61425c7SMark Prins	 */
554e61425c7SMark Prins	private function drawPolygon($polygon, $colour) {
555c977deacSMark Prins		// TODO implementation of drawing holes,
556c977deacSMark Prins		// maybe draw the polygon to an in-memory image and use imagecopy, draw polygon in col., draw holes in bgcol?
557c977deacSMark Prins
558c977deacSMark Prins		// print_r('Polygon:<br />');
559c977deacSMark Prins		// print_r($polygon);
560c977deacSMark Prins		$extPoints = array ();
561c977deacSMark Prins		// extring is a linestring actually..
562c977deacSMark Prins		$extRing = $polygon->exteriorRing ();
563c977deacSMark Prins
564c977deacSMark Prins		for($i = 1; $i < $extRing->numGeometries (); $i ++) {
565c977deacSMark Prins			$p1 = $extRing->geometryN ( $i );
566c977deacSMark Prins			$x = floor ( ($this->width / 2) - $this->tileSize * ($this->centerX - $this->lonToTile ( $p1->x (), $this->zoom )) );
567c977deacSMark Prins			$y = floor ( ($this->height / 2) - $this->tileSize * ($this->centerY - $this->latToTile ( $p1->y (), $this->zoom )) );
568c977deacSMark Prins			$extPoints [] = $x;
569c977deacSMark Prins			$extPoints [] = $y;
570e61425c7SMark Prins		}
571c977deacSMark Prins		// print_r('points:('.($i-1).')<br />');
572c977deacSMark Prins		// print_r($extPoints);
573c977deacSMark Prins		// imagepolygon ($this->image, $extPoints, $i-1, $colour );
574c977deacSMark Prins		imagefilledpolygon ( $this->image, $extPoints, $i - 1, $colour );
575c977deacSMark Prins	}
576c977deacSMark Prins
577628e43ccSMark Prins	/**
578628e43ccSMark Prins	 * add copyright and origin notice and icons to the map.
579628e43ccSMark Prins	 */
580628e43ccSMark Prins	public function drawCopyright() {
581628e43ccSMark Prins		$logoBaseDir = dirname ( __FILE__ ) . '/' . 'logo/';
582628e43ccSMark Prins		$logoImg = imagecreatefrompng ( $logoBaseDir . $this->tileInfo ['openstreetmap'] ['logo'] );
583628e43ccSMark Prins		$textcolor = imagecolorallocate ( $this->image, 0, 0, 0 );
584628e43ccSMark Prins		$bgcolor = imagecolorallocate ( $this->image, 200, 200, 200 );
585628e43ccSMark Prins
5862d11d700SMark Prins		imagecopy ( $this->image, $logoImg, 0, imagesy ( $this->image ) - imagesy ( $logoImg ), 0, 0, imagesx ( $logoImg ), imagesy ( $logoImg ) );
587628e43ccSMark Prins		imagestring ( $this->image, 1, imagesx ( $logoImg ) + 2, imagesy ( $this->image ) - imagesy ( $logoImg ) + 1, $this->tileInfo ['openstreetmap'] ['txt'], $bgcolor );
588628e43ccSMark Prins		imagestring ( $this->image, 1, imagesx ( $logoImg ) + 1, imagesy ( $this->image ) - imagesy ( $logoImg ), $this->tileInfo ['openstreetmap'] ['txt'], $textcolor );
589628e43ccSMark Prins
590628e43ccSMark Prins		// additional tile source info, ie. who created/hosted the tiles
591628e43ccSMark Prins		if ($this->maptype != 'openstreetmap') {
592628e43ccSMark Prins			$iconImg = imagecreatefrompng ( $logoBaseDir . $this->tileInfo [$this->maptype] ['logo'] );
5932d11d700SMark Prins			imagecopy ( $this->image, $iconImg, imagesx ( $logoImg ) + 1, imagesy ( $this->image ) - imagesy ( $iconImg ), 0, 0, imagesx ( $iconImg ), imagesy ( $iconImg ) );
594628e43ccSMark Prins			imagestring ( $this->image, 1, imagesx ( $logoImg ) + imagesx ( $iconImg ) + 4, imagesy ( $this->image ) - ceil ( imagesy ( $logoImg ) / 2 ) + 1, $this->tileInfo [$this->maptype] ['txt'], $bgcolor );
595628e43ccSMark Prins			imagestring ( $this->image, 1, imagesx ( $logoImg ) + imagesx ( $iconImg ) + 3, imagesy ( $this->image ) - ceil ( imagesy ( $logoImg ) / 2 ), $this->tileInfo [$this->maptype] ['txt'], $textcolor );
596628e43ccSMark Prins		}
597628e43ccSMark Prins	}
598cc74a83cSMark Prins
599628e43ccSMark Prins	/**
600628e43ccSMark Prins	 * make the map.
601628e43ccSMark Prins	 */
602628e43ccSMark Prins	public function makeMap() {
603628e43ccSMark Prins		$this->initCoords ();
604628e43ccSMark Prins		$this->createBaseMap ();
605ab8cbd2bSMark Prins		if (! empty ( $this->markers ))
606ab8cbd2bSMark Prins			$this->placeMarkers ();
607ab8cbd2bSMark Prins		if (file_exists ( $this->kmlFileName ))
608ab8cbd2bSMark Prins			$this->drawKML ();
609ab8cbd2bSMark Prins		if (file_exists ( $this->gpxFileName ))
610ab8cbd2bSMark Prins			$this->drawGPX ();
611ab8cbd2bSMark Prins		if (file_exists ( $this->geojsonFileName ))
612ab8cbd2bSMark Prins			$this->drawGeojson ();
6136914b920SMark Prins
614628e43ccSMark Prins		$this->drawCopyright ();
615628e43ccSMark Prins	}
616cc74a83cSMark Prins
617628e43ccSMark Prins	/**
618e4f115f4SMark Prins	 * Calculate the lat/lon/zoom values to make sure that all of the markers and gpx/kml are on the map.
619a2fdf7cdSMark Prins	 * can throw an error like
620a2fdf7cdSMark Prins	 * "Fatal error: Uncaught Exception: Cannot create a collection with non-geometries in
621a2fdf7cdSMark Prins	 * D:\www\wild-water.nl\www\dokuwiki\lib\plugins\geophp\geoPHP\lib\geometry\Collection.class.php:29"
622ab8cbd2bSMark Prins	 *
623ab8cbd2bSMark Prins	 * @param float $paddingFactor
624ab8cbd2bSMark Prins	 *        	buffer constant to enlarge (>1.0) the zoom level
6252d11d700SMark Prins	 */
6262d11d700SMark Prins	private function autoZoom($paddingFactor = 1.0) {
6272d11d700SMark Prins		$geoms = array ();
628e4f115f4SMark Prins		$geoms [] = new Point ( $this->lon, $this->lat );
629e4f115f4SMark Prins		if (! empty ( $this->markers )) {
6302d11d700SMark Prins			foreach ( $this->markers as $marker ) {
6312d11d700SMark Prins				$geoms [] = new Point ( $marker ['lon'], $marker ['lat'] );
6322d11d700SMark Prins			}
6332d11d700SMark Prins		}
634a2fdf7cdSMark Prins		$g = FALSE;
6352d11d700SMark Prins		if (file_exists ( $this->kmlFileName )) {
636a2fdf7cdSMark Prins			$g = geoPHP::load ( file_get_contents ( $this->kmlFileName ), 'kml' );
637a2fdf7cdSMark Prins			if($g !== FALSE) {
638a2fdf7cdSMark Prins				$geoms [] = $g;
639a2fdf7cdSMark Prins			}
6402d11d700SMark Prins		}
6412d11d700SMark Prins		if (file_exists ( $this->gpxFileName )) {
642a2fdf7cdSMark Prins			$g = geoPHP::load ( file_get_contents ( $this->gpxFileName ), 'gpx' );
643a2fdf7cdSMark Prins			if($g !== FALSE) {
644a2fdf7cdSMark Prins				$geoms [] = $g;
645a2fdf7cdSMark Prins			}
6462d11d700SMark Prins		}
6476914b920SMark Prins		if (file_exists ( $this->geojsonFileName )) {
648a2fdf7cdSMark Prins			$g = geoPHP::load ( file_get_contents ( $this->geojsonFileName ), 'geojson' );
649a2fdf7cdSMark Prins			if($g !== FALSE) {
650a2fdf7cdSMark Prins				$geoms [] = $g;
651a2fdf7cdSMark Prins			}
6526914b920SMark Prins		}
6536914b920SMark Prins
654a2fdf7cdSMark Prins		if (count ( $geoms ) <= 1) {
655a2fdf7cdSMark Prins			dbglog($geoms,"StaticMap::autoZoom: Skip setting autozoom options");
656ab8cbd2bSMark Prins			return;
657a2fdf7cdSMark Prins		}
65853bfe4a3SMark Prins
6592d11d700SMark Prins		$geom = new GeometryCollection ( $geoms );
6602d11d700SMark Prins		$centroid = $geom->centroid ();
6612d11d700SMark Prins		$bbox = $geom->getBBox ();
6622d11d700SMark Prins
6632d11d700SMark Prins		// determine vertical resolution, this depends on the distance from the equator
6642d11d700SMark Prins		// $vy00 = log(tan(M_PI*(0.25 + $centroid->getY()/360)));
6652d11d700SMark Prins		$vy0 = log ( tan ( M_PI * (0.25 + $bbox ['miny'] / 360) ) );
6662d11d700SMark Prins		$vy1 = log ( tan ( M_PI * (0.25 + $bbox ['maxy'] / 360) ) );
667*c8eb1362SMark Prins		dbglog("StaticMap::autoZoom: vertical resolution: $vy0, $vy1");
66853bfe4a3SMark Prins		$zoomFactorPowered = ($this->height / 2) / (40.7436654315252 * ($vy1 - $vy0));
6692d11d700SMark Prins		$resolutionVertical = 360 / ($zoomFactorPowered * $this->tileSize);
6702d11d700SMark Prins		// determine horizontal resolution
6712d11d700SMark Prins		$resolutionHorizontal = ($bbox ['maxx'] - $bbox ['minx']) / $this->width;
6722d11d700SMark Prins		$resolution = max ( $resolutionHorizontal, $resolutionVertical ) * $paddingFactor;
6732d11d700SMark Prins		$zoom = log ( 360 / ($resolution * $this->tileSize), 2 );
6742d11d700SMark Prins
675*c8eb1362SMark Prins		if (is_finite($zoom) && $zoom < 15 && $zoom > 2) {
6762d11d700SMark Prins			$this->zoom = floor ( $zoom );
677*c8eb1362SMark Prins		}
6782d11d700SMark Prins		$this->lon = $centroid->getX ();
6792d11d700SMark Prins		$this->lat = $centroid->getY ();
680a2fdf7cdSMark Prins		dbglog("StaticMap::autoZoom: Set autozoom options to: z: $this->zoom, lon: $this->lon, lat: $this->lat");
6812d11d700SMark Prins	}
6822d11d700SMark Prins
6832d11d700SMark Prins	/**
684628e43ccSMark Prins	 * get the map, this may return a reference to a cached copy.
685ab8cbd2bSMark Prins	 *
686628e43ccSMark Prins	 * @return string url relative to media dir
687628e43ccSMark Prins	 */
688628e43ccSMark Prins	public function getMap() {
689a2fdf7cdSMark Prins		try {
690a2fdf7cdSMark Prins			if ($this->autoZoomExtent) {
691ab8cbd2bSMark Prins				$this->autoZoom ();
692a2fdf7cdSMark Prins			}
693a2fdf7cdSMark Prins		} catch (Exception $e) {
694a2fdf7cdSMark Prins			dbglog($e);
695a2fdf7cdSMark Prins		}
6962d11d700SMark Prins
697628e43ccSMark Prins			// use map cache, so check cache for map
698628e43ccSMark Prins		if (! $this->checkMapCache ()) {
699628e43ccSMark Prins			// map is not in cache, needs to be build
700628e43ccSMark Prins			$this->makeMap ();
701628e43ccSMark Prins			$this->mkdir_recursive ( dirname ( $this->mapCacheIDToFilename () ), 0777 );
702628e43ccSMark Prins			imagepng ( $this->image, $this->mapCacheIDToFilename (), 9 );
703628e43ccSMark Prins		}
704628e43ccSMark Prins		$this->doc = $this->mapCacheIDToFilename ();
705628e43ccSMark Prins		// make url relative to media dir
706628e43ccSMark Prins		return str_replace ( $this->mediaBaseDir, '', $this->doc );
707628e43ccSMark Prins	}
708628e43ccSMark Prins}
709