| Server IP : 167.235.224.122 / Your IP : 216.73.216.110 Web Server : Apache/2.4.58 (Ubuntu) System : Linux newplayground 6.8.0-136-generic #136-Ubuntu SMP PREEMPT_DYNAMIC Wed Jul 1 21:33:11 UTC 2026 aarch64 User : deploy ( 1000) PHP Version : 8.4.23 Disable Function : NONE MySQL : OFF | cURL : ON | WGET : ON | Perl : ON | Python : OFF | Sudo : ON | Pkexec : OFF Directory : /var/www/html/wiki/extensions/SemanticMediaWiki/includes/dataitems/ |
Upload File : |
<?php
use SMW\Exception\DataItemException;
/**
* @license GPL-2.0-or-later
* @author Jeroen De Dauw < jeroendedauw@gmail.com >
*/
class SMWDIGeoCoord extends SMWDataItem {
/**
* @var float
*/
private $latitude;
/**
* @var float
*/
private $longitude;
/**
* @var float|null
*/
private $altitude = null;
/**
* @since 3.2
*/
public static function newFromLatLong( float $latitude, float $longitude ): self {
return new self( $latitude, $longitude );
}
/**
* Takes a latitude and longitude, and optionally an altitude. These can be provided in 2 forms:
* * An associative array with lat, lon and alt keys
* * Lat, lon and alt arguments
*
* The second way to provide the arguments, as well as the altitude argument, where introduced in SMW 1.7.
*/
public function __construct() {
$args = func_get_args();
$count = count( $args );
if ( $count === 1 && is_array( $args[0] ) ) {
if ( array_key_exists( 'lat', $args[0] ) && array_key_exists( 'lon', $args[0] ) ) {
$this->setLatitude( $args[0]['lat'] );
$this->setLongitude( $args[0]['lon'] );
if ( array_key_exists( 'alt', $args[0] ) ) {
$this->altitude = (float)$args[0]['alt'];
}
} else {
throw new DataItemException( 'Invalid coordinate data passed to the SMWDIGeoCoord constructor' );
}
} elseif ( $count === 2 || $count === 3 ) {
$this->setLatitude( $args[0] );
$this->setLongitude( $args[1] );
if ( $count === 3 ) {
$this->altitude = (float)$args[2];
}
} else {
throw new DataItemException( 'Invalid coordinate data passed to the SMWDIGeoCoord constructor' );
}
}
private function setLatitude( $latitude ) {
if ( is_int( $latitude ) ) {
$latitude = (float)$latitude;
}
if ( !is_float( $latitude ) ) {
throw new DataItemException( '$latitude should be a float' );
}
$this->latitude = $latitude;
}
private function setLongitude( $longitude ) {
if ( is_int( $longitude ) ) {
$longitude = (float)$longitude;
}
if ( !is_float( $longitude ) ) {
throw new DataItemException( '$longitude should be a float' );
}
$this->longitude = $longitude;
}
/**
* (non-PHPdoc)
* @see SMWDataItem::getDIType()
*/
public function getDIType() {
return SMWDataItem::TYPE_GEO;
}
/**
* Returns the coordinate set as an array with lat and long (and alt) keys
* pointing to float values.
*
* @return array
*/
public function getCoordinateSet() {
$coords = [ 'lat' => $this->latitude, 'lon' => $this->longitude ];
if ( $this->altitude !== null ) {
$coords['alt'] = $this->altitude;
}
return $coords;
}
/**
* (non-PHPdoc)
* @see SMWDataItem::getSortKey()
*/
public function getSortKey() {
return $this->latitude . ',' . $this->longitude . ( $this->altitude !== null ? ',' . $this->altitude : '' );
}
/**
* (non-PHPdoc)
* @see SMWDataItem::getSerialization()
*/
public function getSerialization() {
return implode( ',', $this->getCoordinateSet() );
}
/**
* Create a data item from the provided serialization string and type
* ID.
* @note PHP can convert any string to some number, so we do not do
* validation here (because this would require less efficient parsing).
*
* @param string $serialization
*
* @return self
*/
public static function doUnserialize( $serialization ) {
$parts = explode( ',', $serialization );
$count = count( $parts );
if ( $count !== 2 && $count !== 3 ) {
throw new DataItemException( 'Unserialization of coordinates failed' );
}
$coords = [ 'lat' => (float)$parts[0], 'lon' => (float)$parts[1] ];
if ( $count === 3 ) {
$coords['alt'] = (float)$parts[2];
}
return new self( $coords );
}
/**
* @return float
*/
public function getLatitude() {
return $this->latitude;
}
/**
* @return float
*/
public function getLongitude() {
return $this->longitude;
}
/**
* Returns the altitude if set, null otherwise.
*
* @return float|null
*/
public function getAltitude() {
return $this->altitude;
}
public function equals( SMWDataItem $di ) {
if ( $di->getDIType() !== SMWDataItem::TYPE_GEO ) {
return false;
}
return $di->getSerialization() === $this->getSerialization();
}
}