Module: RGeo::Feature::Point

Extended by:
Type
Includes:
Geometry
Included in:
Cartesian::PointImpl, Geographic::ProjectedPointImpl, Geographic::SphericalPointImpl, Geos::CAPIPointImpl, Geos::FFIPointImpl
Defined in:
lib/rgeo/feature/point.rb

Overview

SFS 1.1 Description

A Point is a 0-dimensional geometric object and represents a single location in coordinate space. A Point has an x-coordinate value and a y-coordinate value.

The boundary of a Point is the empty set.

Notes

Point is defined as a module and is provided primarily for the sake of documentation. Implementations need not necessarily include this module itself. Therefore, you should not depend on the kind_of? method to check type. Instead, use the provided check_type class method (or === operator) defined in the Type module.

Some implementations may support higher dimensional points.

Some libraries, such as GEOS, support “empty” points. Such objects might be returned as, for example, the centroid of an empty MultiPolygon. The SFS does not clearly define or even acknowledge the existence of such a type, so RGeo will currently generally replace them with empty GeometryCollection objects. Therefore, currently, every RGeo Point object represents an actual location with real coordinates.

Instance Method Summary collapse

Methods included from Type

add_subtype, check_type, each_immediate_subtype, extended, subtype_of?, supertype, type_name

Methods included from Geometry

#*, #+, #-, #==, #as_binary, #as_text, #boundary, #buffer, #contains?, #convex_hull, #coordinate_dimension, #crosses?, #difference, #dimension, #disjoint?, #distance, #empty?, #envelope, #eql?, #equals?, #factory, #geometry_type, #intersection, #intersects?, #is_3d?, #locate_along, #locate_between, #measured?, #overlaps?, #relate?, #rep_equals?, #simple?, #spatial_dimension, #srid, #sym_difference, #touches?, #transform, #unary_union, #union, #within?

Instance Method Details

#m ⇒ Object

Returns the m-coordinate for this Point as a floating-point scalar value.

This method may not be available if the point’s factory does not support M coordinates.

Raises:



80
81
82
 
# File 'lib/rgeo/feature/point.rb', line 80

def m
  raise Error::UnsupportedOperation, "Method #{self.class}#m not defined."
end

#x ⇒ Object

SFS 1.1 Description

The x-coordinate value for this Point.

Notes

Returns a floating-point scalar value.

Raises:



48
49
50
 
# File 'lib/rgeo/feature/point.rb', line 48

def x
  raise Error::UnsupportedOperation, "Method #{self.class}#x not defined."
end

#y ⇒ Object

SFS 1.1 Description

The y-coordinate value for this Point.

Notes

Returns a floating-point scalar value.

Raises:



60
61
62
 
# File 'lib/rgeo/feature/point.rb', line 60

def y
  raise Error::UnsupportedOperation, "Method #{self.class}#y not defined."
end

#z ⇒ Object

Returns the z-coordinate for this Point as a floating-point scalar value.

This method may not be available if the point’s factory does not support Z coordinates.

Raises:



70
71
72
 
# File 'lib/rgeo/feature/point.rb', line 70

def z
  raise Error::UnsupportedOperation, "Method #{self.class}#z not defined."
end