MapAPI

Complexity

Total Complexity

62

Size/Duplication

Total Lines	709
Duplicated Lines	0 %

Coupling/Cohesion

Components	1
Dependencies	5

32 Methods

Rating	Name	Duplication	Size	Complexity
A	__construct()	0	3	1
A	setKey()	0	4	1
A	setShowInlineMapDivStyle()	0	4	1
A	setAdditionalCSSClasses()	0	4	1
A	setMapStyle()	0	4	1
A	setClusterer()	0	8	1
A	setDivId()	0	4	1
A	setSize()	0	5	1
A	setLang()	0	4	1
A	setZoom()	0	4	1
A	setInfoWindowZoom()	0	4	1
A	setEnableWindowZoom()	0	4	1
A	setEnableAutomaticCenterZoom()	0	4	1
A	setCenter()	0	4	1
B	setMapType()	0	20	5
A	setAllowFullScreen()	0	4	1
A	setLatLongCenter()	0	16	3
A	setDefaultHideMarker()	0	4	1
A	getGoogleMap()	0	3	1
A	getContent()	0	10	1
A	geocoding()	0	18	2
A	addMarkerByCoords()	0	11	1
A	addMarkerByAddress()	0	7	2
A	addArrayMarkerByCoords()	0	6	2
D	addMarkerAsObject()	0	35	10
A	connectPoints()	0	7	1
A	forTemplate()	0	4	1
A	addKML()	0	4	1
A	addLine()	0	12	1
A	jsonRemoveUnicodeSequences()	0	5	1
F	generate()	0	104	12
A	processTemplateHTML()	0	8	2

<?php

/*
*
* This script is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
* GNU General public License for more details.
*
* This copyright notice MUST APPEAR in all copies of the script!
*
*  @author            CERDAN Yohann <cerdanyohann@yahoo.fr>
*  @copyright      (c) 2009  CERDAN Yohann, All rights reserved
*  @ version         18:13 26/05/2009
*/

class MapAPI extends ViewableData
{

	 /** GoogleMap key **/
	protected $googleMapKey = '';

	/** GoogleMap ID for the HTML DIV  **/
	protected $googleMapId = 'googlemapapi';

	/* Additional CSS classes to use when rendering the map */
	protected $set_additional_css_classes = '';

	/** Width of the gmap **/
	protected $width = 800;

	/** Height of the gmap **/
	protected $height = 600;

	/* array of lines to be drawn on the map */
	protected $lines = array();

	/* kml file to be rendered */
	protected $kmlFiles = array();

	/** Default zoom of the gmap **/
	protected $zoom = 9;

	/** Enable the zoom of the Infowindow **/
	protected $enableWindowZoom = false;

	/** Default zoom of the Infowindow **/
	protected $infoWindowZoom = 13;

	/** Lang of the gmap **/
	protected $lang = 'en';

	/**Center of the gmap **/
	protected $center = 'Paris, France';

	/*
	 Additional CSS classes to render as a class attribute for the div of the
	 map.  Use this if you want more  fine grained control over your map using
	 CSS.  If blank it will be ignored
	 */
	protected $additional_css_classes = '';


	/* Decided whether or not to show the inline map css style on div creation */
	protected $show_inline_map_div_style = true;

	protected $latLongCenter = null;

	protected $jsonMapStyles = '[]';

	/**
	 * Type of the gmap, can be:
	 *  'road' (roadmap),
	 *  'satellite' (sattelite/aerial photographs)
	 *  'hybrid' (hybrid of road and satellite)
	 *  'terrain' (terrain)
	 *  The JavaScript for the mapping service will convert this into a suitable mapping type
	 */

	protected $mapType = 'road';


	/** Content of the HTML generated **/
	protected $content = '';

	protected $mapService = 'google';

	/** Hide the marker by default **/
	protected $defaultHideMarker = false;

	/** Extra content (marker, etc...) **/
	protected $contentMarker = '';

	// a list of markers, markers being associative arrays
	protected $markers = array();

	/** Use clusterer to display a lot of markers on the gmap **/
	protected $useClusterer = false;
	protected $gridSize = 50;
	protected $maxZoom = 17;
	protected $clustererLibraryPath = "/mappable/javascript/google/markerclusterer.js";

	/** Enable automatic center/zoom **/
	protected $enableAutomaticCenterZoom = false;

	/** maximum longitude of all markers **/
	protected $maxLng = -1000000;

	/** minimum longitude of all markers **/
	protected $minLng = 1000000;

	/** max latitude of all markers **/
	protected $maxLat = -1000000;

	/** min latitude of all markers **/
	protected $minLat = 1000000;

	/** map center latitude (horizontal), calculated automatically as markers
	are added to the map **/
	protected $centerLat = null;

	/** map center longitude (vertical),  calculated automatically as markers
	are added to the map **/
	protected $centerLng = null;

	/** factor by which to fudge the boundaries so that when we zoom encompass,
	the markers aren't too close to the edge **/
	protected $coordCoef = 0.01;

	/* set this to true to render button to maximize / minimize a map */
	protected $allowFullScreen = null;

	/**
	 * Class constructor
	 *
	 * @param string  $googleMapKey the googleMapKey
	 */

	public function __construct($googleMapKey = '') {
		$this->googleMapKey = $googleMapKey;
	}

	/**
	 * Set the key of the gmap
	 *
	 * @param string  $googleMapKey the googleMapKey
	 *
	 * @return MapAPI
	 */

	public function setKey($googleMapKey) {
		$this->googleMapKey = $googleMapKey;
		return $this;
	}

	public function setShowInlineMapDivStyle($new_show_inline_map_div_style) {
		$this->show_inline_map_div_style = $new_show_inline_map_div_style;
		return $this;
	}

	public function setAdditionalCSSClasses($new_additional_css_classes) {
		$this->additional_css_classes = $new_additional_css_classes;
		return $this;
	}


	public function setMapStyle($newStyles) {
		$this->jsonMapStyles = $newStyles;
		return $this;
	}

	/**
	 * Set the useClusterer parameter (optimization to display a lot of marker)
	 *
	 * @param boolean $useClusterer     use cluster or not
	 * @param int     $gridSize         grid size
	 * @param int     $maxZoom 			max zoom to cluster at
	 *
	 * * @return MapAPI This same object, in order to enable chaining of methods
	 */

	public function setClusterer($useClusterer, $gridSize = 50, $maxZoom = 17,
		$clustererLibraryPath = '/mappable/javascript/google/markerclusterer.js') {
		$this->useClusterer = $useClusterer;
		$this->gridSize = $gridSize;
		$this->maxZoom = $maxZoom;
		$this->clustererLibraryPath = $clustererLibraryPath;
		return $this;
	}

	/**
	 * Set the ID of the default gmap DIV
	 *
	 * @param string  $googleMapId the google div ID
	 *
	 * @return MapAPI This same object, in order to enable chaining of methods
	 */

	public function setDivId($googleMapId) {
		$this->googleMapId = $googleMapId;
		return $this;
	}

	/**
	 * Set the size of the gmap.  If these values are not provided
	 * then CSS is used instead
	 *
	 * @param int     $width  GoogleMap  width
	 * @param int     $height GoogleMap  height
	 *
	 * @return MapAPI This same object, in order to enable chaining of methods
	 */

	public function setSize($width, $height) {
		$this->width = $width;
		$this->height = $height;
		return $this;
	}

	/**
	 * Set the lang of the gmap
	 *
	 * @param string  $lang GoogleMap  lang : fr,en,..
	 *
	 * @return MapAPI This same object, in order to enable chaining of methods
	 */

	public function setLang($lang) {
		$this->lang = $lang;
		return $this;
	}

	/**
	 * Set the zoom of the gmap
	 *
	 * @param int $zoom GoogleMap zoom.
	 *
	 * @return MapAPI This same object, in order to enable chaining of methods
	 */

	public function setZoom($zoom) {
		$this->zoom = $zoom;
		return $this;
	}

	/**
	 * Set the zoom of the infowindow
	 *
	 * @param int 	$infoWindowZoom GoogleMap information window zoom.
	 *
	 * @return MapAPI This same object, in order to enable chaining of methods
	 */

	public function setInfoWindowZoom($infoWindowZoom) {
		$this->infoWindowZoom = $infoWindowZoom;
		return $this;
	}

	/**
	 * Enable the zoom on the marker when you click on it
	 *
	 * @param int $enableWindowZoom info window enabled zoom.
	 *
	 * @return MapAPI This same object, in order to enable chaining of methods
	 */

	public function setEnableWindowZoom($enableWindowZoom) {
		$this->enableWindowZoom = $enableWindowZoom;

The property $enableWindowZoom was declared of type boolean, but $enableWindowZoom is of type integer. Maybe add a type cast?

		return $this;
	}

	/**
	 * Enable theautomatic center/zoom at the gmap load
	 *
	 * @param int $enableAutomaticCenterZoom enable automatic centre zoom
	 *
	 * @return MapAPI This same object, in order to enable chaining of methods
	 */

	public function setEnableAutomaticCenterZoom($enableAutomaticCenterZoom) {
		$this->enableAutomaticCenterZoom = $enableAutomaticCenterZoom;

The property $enableAutomaticCenterZoom was declared of type boolean, but $enableAutomaticCenterZoom is of type integer. Maybe add a type cast?

		return $this;
	}

	/**
	 * Set the center of the gmap (an address)
	 *
	 * @param string  $center GoogleMap  center (an address)
	 *
	 * @return MapAPI This same object, in order to enable chaining of methods
	 */

	public function setCenter($center) {
		$this->center = $center;
		return $this;
	}

	/**
	 * Set the type of the gmap.  Also takes into account legacy settings
	 *
	 * FIXME - allow other valid settings in config for map type
	 *
	 * @param string  $mapType  Can be one of road,satellite,hybrid or terrain. Defaults to road
	 *
	 * @return MapAPI This same object, in order to enable chaining of methods
	 */

	public function setMapType($mapType) {
		$this->mapType = $mapType;

		// deal with legacy values for backwards compatbility
		switch ($mapType) {
			case 'google.maps.MapTypeId.SATELLITE':
				$this->mapType = "satellite";
				break;
			case 'google.maps.MapTypeId.G_HYBRID_MAP':
				$this->mapType = "hybrid";
				break;
			case 'google.maps.MapTypeId.G_PHYSICAL_MAP':
				$this->mapType = "terrain";
				break;
			case 'google.maps.MapTypeId.ROADMAP':
				$this->mapType = "road";
				break;
		}
		return $this;
	}

	/*
	Set whether or not to allow the full screen tools
	@return MapAPI This same object, in order to enable chaining of methods
	*/
	public function setAllowFullScreen($allowed) {
		$this->allowFullScreen = $allowed;
		return $this;
	}

	/**
	* Set the center of the gmap
	*
	* @return MapAPI This same object, in order to enable chaining of methods
	**/
	public function setLatLongCenter($center) {
		// error check, we want an associative array with lat,lng keys numeric

		if (!is_array($center)) {
			throw new InvalidArgumentException('Center must be an associative array containing lat,lng');
		}

		$keys = array_keys($center);
		sort($keys);
		if (implode(',', $keys) != 'lat,lng') {
			throw new InvalidArgumentException('Keys provided must be lat, lng');
		}

		$this->latLongCenter = $center;
		return $this;
	}

	/**
	 * Set the defaultHideMarker
	 *
	 * @param boolean $defaultHideMarker hide all the markers on the map by default
	 *
	 * @return MapAPI
	 */

	public function setDefaultHideMarker($defaultHideMarker) {
		$this->defaultHideMarker = $defaultHideMarker;
		return $this;
	}

	/**
	 * Get the google map content
	 *
	 * @return string the google map html code
	 */

	public function getGoogleMap() {
		return $this->content;
	}


	/**
	 * Get URL content using cURL.
	 *
	 * @param string  $url the url
	 *
	 * @return string the html code
	 *
	 * @todo add proxy settings
	 */

	public function getContent($url) {
		$curl = curl_init();
		curl_setopt($curl, CURLOPT_TIMEOUT, 10);
		curl_setopt($curl, CURLOPT_CONNECTTIMEOUT, 5);
		curl_setopt($curl, CURLOPT_RETURNTRANSFER, TRUE);
		curl_setopt($curl, CURLOPT_URL, $url);
		$data = curl_exec($curl);
		curl_close($curl);
		return $data;
	}

	/**
	 * Geocoding an address (address -> lat,lng)
	 *
	 * @param string  $address an address
	 *
	 * @return string array with precision, lat & lng
	 */

	public function geocoding($address) {
		$geocoder = new MappableGoogleGeocoder();
		$locations = $geocoder->getLocations($address);
		$result = null;

$result is not used, you could remove the assignment.

		if (!empty($locations)) {
			$place = $locations[0];
			$location = $place['geometry']['location'];
			$result = array(
				'lat' => $location['lat'],
				'lon' => $location['lng'],
				'geocoded' => true
			);

		} else {
			$result = array(); // no results
		}
		return $result;
	}

	/**
	 * Add marker by his coord
	 *
	 * @param string  $lat      lat
	 * @param string  $lng      lngs
	 * @param string  $html     html code display in the info window
	 * @param string  $category marker category
	 * @param string  $icon     an icon url
	 *
	 * @return MapAPI
	 */

	public function addMarkerByCoords($lat, $lng, $html = '', $category = '', $icon = '') {
		$m = array(
			'latitude' => $lat,
			'longitude' => $lng,
			'html' => $html,
			'category' => $category,
			'icon' => $icon
		);
		array_push($this->markers, $m);
		return $this;
	}


	/**
	 * Add marker by his address
	 *
	 * @param string  $address  an ddress
	 * @param string  $content  html code display in the info window
	 * @param string  $category marker category
	 * @param string  $icon     an icon url
	 *
	 * @return MapAPI
	 */

	public function addMarkerByAddress($address, $content = '', $category = '', $icon = '') {
		$point = $this->geocoding($address);
		if ($point !== null) {
			$this->addMarkerByCoords($point['lat'], $point['lon'], $content, $category, $icon);
		}
		return $this;
	}

	/**
	 * Add marker by an array of coord
	 *
	 * @param array  $coordtab an array of lat,lng,content
	 * @param string  $category marker category
	 * @param string  $icon     an icon url
	 *
	 * @return MapAPI
	 */

	public function addArrayMarkerByCoords($coordtab, $category = '', $icon = '') {
		foreach ($coordtab as $coord) {
			$this->addMarkerByCoords($coord[0], $coord[1], $coord[2], $category, $icon);
		}
		return $this;
	}


	/**
	 * Adds a {@link ViewableData} object that implements {@link Mappable}
	 * to the map.
	 * @param   $infowindowtemplateparams Optional array of extra parameters to pass to the map info window
	 *
	 * @param ViewableData $obj
	 */
	public function addMarkerAsObject(ViewableData $obj, $infowindowtemplateparams = null) {
		$extensionsImplementMappable = false;
		$extensions = Object::get_extensions(get_class($obj));
		if (is_array($extensions)) {

			foreach ($extensions as $extension) {
				$class = new ReflectionClass($extension);
				if ($class->implementsInterface('Mappable')) {
					$extensionsImplementMappable = true;
				}

			}
		}

		if ($extensionsImplementMappable ||
			($obj instanceof Mappable) ||
			(Object::has_extension($obj->ClassName, 'MapExtension'))
		) {
			$cat = $obj->hasMethod('getMappableMapCategory') ? $obj->getMappableMapCategory() : "default";
			if ($infowindowtemplateparams !== null) {
				foreach ($infowindowtemplateparams as $key => $value) {
					$obj->{$key} = $value;
				}
			}
			$this->addMarkerByCoords(
				$obj->getMappableLatitude(),
				$obj->getMappableLongitude(),
				$obj->getMappableMapContent(),
				$cat,
				$obj->getMappableMapPin()
			);
		}

		return $this;
	}


	/**
	 * Draws a line between two {@link ViewableData} objects
	 *
	 * @param ViewableData $one   The first point
	 * @param ViewableData $two   The second point
	 * @param string  $color The hexidecimal color of the line
	 */
	public function connectPoints(ViewableData $one, ViewableData $two, $color = "#FF3300") {
		$this->addLine(
			array($one->getMappableLatitude(), $one->getMappableLongitude()),
			array($two->getMappableLatitude(), $two->getMappableLongitude()),
			$color
		);
	}


	public function forTemplate() {
		$this->generate();
		return $this->getGoogleMap();
	}

	/**
	 * Add a KML file which will be rendered on this map.  Normally used for likes
	 * of GPS traces from activities
	 *
	 * @param string  $url      url of the kml file compatible with gmap and gearth
	 *
	 * @return MapAPI
	 */

	public function addKML($url) {
		array_push($this->kmlFiles, $url);
		return $this;
	}


	/*
	Add a line to the map

	*/
	public function addLine($from = array(), $to = array(), $color = "#FF3300") {
		$line = array(
			'lat1' => $from[0],
			'lon1' => $from[1],
			'lat2' => $to[0],
			'lon2' => $to[1],
			'color' => $color
		);

		array_push($this->lines, $line);
		return $this;
	}


	/*
	For php 5.3
	*/
	public static function jsonRemoveUnicodeSequences($struct) {
		 return preg_replace("/\\\\u([a-f0-9]{4})/e",
		 					"iconv('UCS-4LE','UTF-8',pack('V', hexdec('U$1')))",
		 					json_encode($struct));
	}


	/**
	 * Generate the gmap
	 *
	 * @return void
	 */

	public function generate() {
		// from http://stackoverflow.com/questions/3586401/cant-decode-json-string-in-php
		$jsonMarkers = null;

$jsonMarkers is not used, you could remove the assignment.

		$linesJson = null;

$linesJson is not used, you could remove the assignment.

		$kmlJson = null;

$kmlJson is not used, you could remove the assignment.

		// prior to PHP version 5.4, one needs to use regex
		if (PHP_VERSION_ID < 50400) {
			$jsonMarkers = stripslashes(MapAPI::jsonRemoveUnicodeSequences($this->markers));
			$linesJson = stripslashes(MapAPI::jsonRemoveUnicodeSequences($this->lines));
			$kmlJson = stripslashes(MapAPI::jsonRemoveUnicodeSequences($this->kmlFiles));
		} else {
			$jsonMarkers = stripslashes(json_encode($this->markers, JSON_UNESCAPED_UNICODE));
			$linesJson = stripslashes(json_encode($this->lines, JSON_UNESCAPED_UNICODE));
			$kmlJson = stripslashes(json_encode($this->kmlFiles, JSON_UNESCAPED_UNICODE));
		}

		 // Center of the GMap - text centre takes precedence
		$geocodeCentre = ($this->latLongCenter) ?
							$this->latLongCenter : $this->geocoding($this->center);

		// coordinates for centre depending on which method used
		if (isset($geocodeCentre['geocoded'] )) {
			$latlngCentre = array(
				'lat' => $geocodeCentre['lat'],
				'lng' => $geocodeCentre['lon']
			);
		} else if (is_array($this->latLongCenter)) {
			$latlngCentre = $this->latLongCenter;
		}

		$this->LatLngCentreJSON = stripslashes(json_encode($latlngCentre));

The property LatLngCentreJSON does not exist on object<MapAPI>. Since you implemented __set, maybe consider adding a @property annotation.

The variable $latlngCentre does not seem to be defined for all execution paths leading up to this point.

		$lenLng = $this->maxLng - $this->minLng;
		$lenLat = $this->maxLat - $this->minLat;
		$this->minLng -= $lenLng * $this->coordCoef;
		$this->maxLng += $lenLng * $this->coordCoef;
		$this->minLat -= $lenLat * $this->coordCoef;
		$this->maxLat += $lenLat * $this->coordCoef;

		// add the css class mappable as a handle onto the map styling
		$this->additional_css_classes .= ' mappable';

		if (!$this->enableAutomaticCenterZoom) {
			$this->enableAutomaticCenterZoom = 'false';

The property $enableAutomaticCenterZoom was declared of type boolean, but 'false' is of type string. Maybe add a type cast?

		}

		if (!$this->useClusterer) {
			$this->useClusterer = 'false';

The property $useClusterer was declared of type boolean, but 'false' is of type string. Maybe add a type cast?

		}

		if (!$this->defaultHideMarker) {
			$this->defaultHideMarker = 'false';

The property $defaultHideMarker was declared of type boolean, but 'false' is of type string. Maybe add a type cast?

		}

		if (!$this->MapTypeId) {

The property MapTypeId does not seem to exist. Did you mean mapType?

			$this->MapTypeId = 'false';

The property MapTypeId does not seem to exist. Did you mean mapType?

		}

		// initialise full screen as the config value if not already set
		if ($this->allowFullScreen === null) {
			$this->allowFullScreen = Config::inst()->get('Mappable', 'allow_full_screen');
		}

		if (!$this->allowFullScreen) {
			$this->allowFullScreen = 'false';
		}

		if (!$this->enableWindowZoom) {
			$this->enableWindowZoom = 'false';

The property $enableWindowZoom was declared of type boolean, but 'false' is of type string. Maybe add a type cast?

		}

		$vars = new ArrayData(array(
				'JsonMapStyles' => $this->jsonMapStyles,
				'AdditionalCssClasses' => $this->additional_css_classes,
				'Width' => $this->width,
				'Height' => $this->height,
				'ShowInlineMapDivStyle' => $this->show_inline_map_div_style,
				'InfoWindowZoom' => $this->infoWindowZoom,
				'EnableWindowZoom' => $this->enableWindowZoom,
				'MapMarkers' => $jsonMarkers,
				'DefaultHideMarker' => $this->defaultHideMarker,
				'LatLngCentre' => $this->LatLngCentreJSON,

The property LatLngCentreJSON does not exist on object<MapAPI>. Since you implemented __get, maybe consider adding a @property annotation.

				'EnableAutomaticCenterZoom' => $this->enableAutomaticCenterZoom,
				'Zoom' => $this->zoom,
				'MaxZoom' => $this->maxZoom,
				'GridSize' => $this->gridSize,
				'MapType' => $this->mapType,
				'GoogleMapID' => $this->googleMapId,
				'Lang'=>$this->lang,
				'UseClusterer'=>$this->useClusterer,
				'ClustererLibraryPath' => $this->clustererLibraryPath,
				'ClustererMaxZoom' => $this->maxZoom,
				'ClustererGridSize' => $this->gridSize,
				'Lines' => $linesJson,
				'KmlFiles' => $kmlJson,
				'AllowFullScreen' => $this->allowFullScreen,
				'UseCompressedAssets' => Config::inst()->get('Mappable', 'use_compressed_assets')
			)
		);

		// HTML component of the map
		$this->content = $this->processTemplateHTML('Map', $vars);
	}

	/**
	 * @param string $templateName
	 * @param ArrayData $templateVariables
	 */
	public function processTemplateHTML($templateName, $templateVariables = null) {
		if (!$templateVariables) {
			$templateVariables = new ArrayList();
		}
		$mappingService = Config::inst()->get('Mappable', 'mapping_service');
		$result = $templateVariables->renderWith($templateName.$mappingService.'HTML');
		return $result;
	}
}