class Point in geoPHP 7
Same name and namespace in other branches
Point: The most basic geometry type. All other geometries are built out of Points.
Hierarchy
Expanded class hierarchy of Point
13 string references to 'Point'
- Collection::centroid in geoPHP/
lib/ geometry/ Collection.class.php - Collection::getBBox in geoPHP/
lib/ geometry/ Collection.class.php - EWKB::write in geoPHP/
lib/ adapters/ EWKB.class.php - Serialize geometries into an EWKB binary string.
- GeoHash::write in geoPHP/
lib/ adapters/ GeoHash.class.php - Convert the geometry to geohash.
- geoPHP::geometryList in geoPHP/
geoPHP.inc
File
- geoPHP/
lib/ geometry/ Point.class.php, line 7
View source
class Point extends Geometry {
public $coords = array(
2,
);
protected $geom_type = 'Point';
protected $dimension = 2;
/**
* Constructor
*
* @param numeric $x The x coordinate (or longitude)
* @param numeric $y The y coordinate (or latitude)
* @param numeric $z The z coordinate (or altitude) - optional
*/
public function __construct($x = NULL, $y = NULL, $z = NULL) {
// Check if it's an empty point
if ($x === NULL && $y === NULL) {
$this->coords = array(
NULL,
NULL,
);
$this->dimension = 0;
return;
}
$x = (double) str_replace(',', '.', $x);
$y = (double) str_replace(',', '.', $y);
// Basic validation on x and y
if (!is_numeric($x) || !is_numeric($y)) {
throw new Exception("Cannot construct Point. x and y should be numeric");
}
// Check to see if this is a 3D point
if ($z !== NULL) {
if (!is_numeric($z)) {
throw new Exception("Cannot construct Point. z should be numeric");
}
$this->dimension = 3;
}
// Convert to floatval in case they are passed in as a string or integer etc.
$x = floatval($x);
$y = floatval($y);
$z = floatval($z);
// Add poitional elements
if ($this->dimension == 2) {
$this->coords = array(
$x,
$y,
);
}
if ($this->dimension == 3) {
$this->coords = array(
$x,
$y,
$z,
);
}
}
/**
* Get X (longitude) coordinate
*
* @return float The X coordinate
*/
public function x() {
return $this->coords[0];
}
/**
* Returns Y (latitude) coordinate
*
* @return float The Y coordinate
*/
public function y() {
return $this->coords[1];
}
/**
* Returns Z (altitude) coordinate
*
* @return float The Z coordinate or NULL is not a 3D point
*/
public function z() {
if ($this->dimension == 3) {
return $this->coords[2];
}
else {
return NULL;
}
}
// A point's centroid is itself
public function centroid() {
return $this;
}
public function getBBox() {
return array(
'maxy' => $this
->getY(),
'miny' => $this
->getY(),
'maxx' => $this
->getX(),
'minx' => $this
->getX(),
);
}
public function asArray($assoc = FALSE) {
return $this->coords;
}
public function area() {
return 0;
}
public function length() {
return 0;
}
public function greatCircleLength() {
return 0;
}
public function haversineLength() {
return 0;
}
// The boundary of a point is itself
public function boundary() {
return $this;
}
public function dimension() {
return 0;
}
public function isEmpty() {
if ($this->dimension == 0) {
return TRUE;
}
else {
return FALSE;
}
}
public function numPoints() {
return 1;
}
public function getPoints() {
return array(
$this,
);
}
public function equals($geometry) {
if (get_class($geometry) != 'Point') {
return FALSE;
}
if (!$this
->isEmpty() && !$geometry
->isEmpty()) {
return $this
->x() == $geometry
->x() && $this
->y() == $geometry
->y();
}
else {
if ($this
->isEmpty() && $geometry
->isEmpty()) {
return TRUE;
}
else {
return FALSE;
}
}
}
public function isSimple() {
return TRUE;
}
// Not valid for this geometry type
public function numGeometries() {
return NULL;
}
public function geometryN($n) {
return NULL;
}
public function startPoint() {
return NULL;
}
public function endPoint() {
return NULL;
}
public function isRing() {
return NULL;
}
public function isClosed() {
return NULL;
}
public function pointN($n) {
return NULL;
}
public function exteriorRing() {
return NULL;
}
public function numInteriorRings() {
return NULL;
}
public function interiorRingN($n) {
return NULL;
}
public function pointOnSurface() {
return NULL;
}
public function explode() {
return NULL;
}
}