Maps\Elements\Location

Complexity

Total Complexity

26

Size/Duplication

Total Lines	140
Duplicated Lines	0 %

Coupling/Cohesion

Components	1
Dependencies	3

Test Coverage

Coverage

79.66%

Importance

Changes

0

17 Methods

Rating	Name	Duplication	Size	Complexity
A	__construct()	0	5	1
A	getCoordinates()	0	3	1
C	getJSONObject()	0	29	9
A	hasIcon()	0	3	1
A	getIcon()	0	3	1
A	setIcon()	0	3	1
A	getAddress()	0	7	2
A	hasGroup()	0	3	1
A	getGroup()	0	3	1
A	setGroup()	0	3	1
A	hasInlineLabel()	0	3	1
A	getInlineLabel()	0	3	1
A	setInlineLabel()	0	3	1
A	hasVisitedIcon()	0	3	1
A	getVisitedIcon()	0	3	1
A	setVisitedIcon()	0	3	1
A	newFromLatLon()	0	3	1

<?php

namespace Maps\Elements;

use DataValues\Geo\Values\LatLongValue;

/**
 * Class describing a single location (geographical point).
 *
 * TODO: rethink the design of this class after deciding on what actual role it has
 *
 * @since 3.0
 *
 * @licence GNU GPL v2+
 * @author Jeroen De Dauw < jeroendedauw@gmail.com >
 * @author Daniel Werner
 */
class Location extends BaseElement {

	/**
	 * @var LatLongValue
	 */
	private $coordinates;

	/**
	 * @var string
	 */
	private $address;

	/**
	 * @var string
	 */
	private $icon = '';

	/**
	 * @var string
	 */
	private $group = '';

	/**
	 * @var string
	 */
	private $inlineLabel = '';

	/**
	 * @var string
	 */
	private $visitedIcon = '';

	public function __construct( LatLongValue $coordinates, string $title = '', string $text = '' ) {
		$this->coordinates = $coordinates;
		$this->setTitle( $title );
		$this->setText( $text );
	}

	public static function newFromLatLon( float $lat, float $lon ): self {
		return new self( new LatLongValue( $lat, $lon ) );
	}

	public function getCoordinates(): LatLongValue {
		return $this->coordinates;
	}

	public function getJSONObject( string $defText = '', string $defTitle = '', string $defIconUrl = '',
		string $defGroup = '', string $defInlineLabel = '', string $defVisitedIcon = '' ): array {

		$parentArray = parent::getJSONObject( $defText, $defTitle );

The method Maps\Elements\BaseElement::getJSONObject() has been deprecated.

		$array = [
			'lat' => $this->coordinates->getLatitude(),
			'lon' => $this->coordinates->getLongitude(),
			'icon' => $this->hasIcon() ? \Maps\MapsFunctions::getFileUrl( $this->getIcon() ) : $defIconUrl,

The method Maps\MapsFunctions::getFileUrl() has been deprecated.

		];
		$val = $this->getAddress();
		if ( $val !== '' ) {
			$array['address'] = $val;
		}
		$val = $this->hasGroup() ? $this->getGroup() : $defGroup;
		if ( !empty( $val ) ) {
			$array['group'] = $val;
		}
		$val = $this->hasInlineLabel() ? $this->getInlineLabel() : $defInlineLabel;
		if ( !empty( $val ) ) {
			$array['inlineLabel'] = $val;
		}
		$val = $this->hasVisitedIcon() ? $this->getVisitedIcon() : $defVisitedIcon;
		if ( !empty( $val ) ) {
			$array['visitedicon'] = $val;
		}

		return array_merge( $parentArray, $array );
	}

	public function hasIcon(): bool {
		return $this->icon !== '';
	}

	public function getIcon(): string {
		return $this->icon;
	}

	public function setIcon( string $icon ) {
		$this->icon = $icon;
	}

	/**
	 * Returns the address corresponding to this location.
	 * If there is none, and empty sting is returned.
	 */
	public function getAddress(): string {
		if ( is_null( $this->address ) ) {
			$this->address = '';
		}

		return $this->address;
	}

	/**
	 * Returns whether Location is assigned to a group.
	 */
	public function hasGroup(): bool {
		return $this->group !== '';
	}

	public function getGroup(): string {
		return $this->group;
	}

	public function setGroup( string $group ) {
		$this->group = trim( $group );
	}

	public function hasInlineLabel(): bool {
		return $this->inlineLabel !== '';
	}

	public function getInlineLabel(): string {
		return $this->inlineLabel;
	}

	public function setInlineLabel( string $label ) {
		$this->inlineLabel = $label;
	}

	public function hasVisitedIcon(): bool {
		return $this->visitedIcon !== '';
	}

	public function getVisitedIcon(): string {
		return $this->visitedIcon;
	}

	public function setVisitedIcon( string $visitedIcon ) {
		$this->visitedIcon = $visitedIcon;
	}

}