Package pygeodesy3 :: Package grids :: Module geohash :: Class Geohash

Class Geohash

        object --+            
                 |            
        basestring --+        
                     |        
                   str --+    
                         |    
        object --+       |    
                 |       |    
miscs.named._Named --+   |    
                     |   |    
 Base.units._NamedUnit --+    
                         |    
            Base.units.Str --+
                             |
                            Geohash

Geohash class, a named str.

Instance Methods

adjacent(self, direction, name='')
Determine the adjacent cell in the given compass direction.

bounds(self, LatLon=None, **LatLon_kwds)
Return the lower-left SW and upper-right NE bounds of this geohash cell.

distanceTo(self, other)
Estimate the distance between this and an other geohash based the cell sizes.

equirectangularTo(self, other, radius=6371008.771415, **adjust_limit_wrap)
Approximate the distance between this and an other geohash using the equirectangular function.

euclideanTo(self, other, **radius_adjust_wrap)
Approximate the distance between this and an other geohash using the euclidean function.

haversineTo(self, other, **radius_wrap)
Compute the distance between this and an other geohash using the haversine formula.

toLatLon(self, LatLon=None, **LatLon_kwds)
Return (the approximate center of) this geohash cell as an instance of the supplied LatLon class.

vincentysTo(self, other, **radius_wrap)
Compute the distance between this and an other geohash using the vincentys formula.

Inherited from Base.units.Str: __call__, __repr__, __str__, join_, toRepr, toStr

Inherited from str: __add__, __contains__, __eq__, __format__, __ge__, __getattribute__, __getitem__, __getnewargs__, __getslice__, __gt__, __hash__, __le__, __len__, __lt__, __mod__, __mul__, __ne__, __rmod__, __rmul__, __sizeof__, capitalize, center, count, decode, encode, endswith, expandtabs, find, format, index, isalnum, isalpha, isdigit, islower, isspace, istitle, isupper, join, ljust, lower, lstrip, partition, replace, rfind, rindex, rjust, rpartition, rsplit, rstrip, split, splitlines, startswith, strip, swapcase, title, translate, upper, zfill

Inherited from miscs.named._Named: __imatmul__, __matmul__, __rmatmul__, attrs, classof, copy, dup, methodname, rename

Inherited from object: __delattr__, __init__, __reduce__, __reduce_ex__, __setattr__, __subclasshook__

Static Methods

a new object with type S, a subtype of T

__new__(cls, cll, precision=None, name='')
New Geohash from an other Geohash instance or str or from a LatLon instance or str.

Properties
	latlon Get the lat- and longitude of (the approximate center of) this geohash as a LatLon2Tuple`(lat, lon)` in `degrees`.
	neighbors Get all 8 adjacent cells as a Neighbors8Dict`(N, NE, E, SE, S, SW, W, NW)` of Geohashes.
	philam Get the lat- and longitude of (the approximate center of) this geohash as a PhiLam2Tuple`(phi, lam)` in `radians`.
	precision Get this geohash's precision (`int`).
	sizes Get the lat- and longitudinal size of this cell as a LatLon2Tuple`(lat, lon)` in (`meter`).
	N Get the cell North of this (Geohash).
	S Get the cell South of this (Geohash).
	E Get the cell East of this (Geohash).
	W Get the cell West of this (Geohash).
	NE Get the cell NorthEast of this (Geohash).
	NW Get the cell NorthWest of this (Geohash).
	SE Get the cell SouthEast of this (Geohash).
	SW Get the cell SouthWest of this (Geohash).
Inherited from `Base.units._NamedUnit`: `std_repr`, `units` Inherited from `miscs.named._Named`: `classname`, `classnaming`, `iteration`, `name`, `named`, `named2`, `named3`, `named4`, `sizeof` Inherited from `object`: `__class__`

Method Details

new (cls, cll, precision=None, name='')
Static Method

New Geohash from an other Geohash instance or str or from a LatLon instance or str.

Arguments:

cll - Cell or location (Geohash, LatLon or str).
precision - Optional, the desired geohash length (int 1..12), see function geohash.encode for some examples.
name - Optional name (str).

Returns: a new object with type S, a subtype of T

New Geohash.

Raises:

GeohashError - INValid or non-alphanumeric cll.
TypeError - Invalid cll.

Overrides: object.__new__

adjacent (self, direction, name='')

Determine the adjacent cell in the given compass direction.

Arguments:

direction - Compass direction ('N', 'S', 'E' or 'W').
name - Optional name (str), otherwise the name of this cell plus .Direction.

Returns:

Geohash of adjacent cell (Geohash).

Raises:

GeohashError - Invalid geohash or direction.

bounds (self, LatLon=None, **LatLon_kwds)

Return the lower-left SW and upper-right NE bounds of this geohash cell.

Arguments:

LatLon - Optional class to return bounds (LatLon) or None.
LatLon_kwds - Optional, additional LatLon keyword arguments, ignored if LatLon is None.

Returns:

A Bounds2Tuple(latlonSW, latlonNE) of LatLons or a Bounds4Tuple

(latS, lonW, latN, 
          lonE)

if LatLon is None,

distanceTo (self, other)

Estimate the distance between this and an other geohash based the cell sizes.

Arguments:

other - The other geohash (Geohash, LatLon or str).

Returns:

Approximate distance (meter).

Raises:

TypeError - The other is not a Geohash, LatLon or str.

equirectangularTo (self, other, radius=6371008.771415, **adjust_limit_wrap)

Approximate the distance between this and an other geohash using the equirectangular function.

Arguments:

other - The other geohash (Geohash, LatLon or str).
radius - Mean earth radius (meter), ellipsoid or datum (Ellipsoid, Ellipsoid2, Datum or a_f2Tuple) or None.
adjust_limit_wrap - Optional keyword arguments for function equirectangular, overriding defaults adjust=False, limit=None and wrap=False.

Returns:

Distance (meter, same units as radius or the ellipsoid or datum axes or in radians squared if

radius is 
          None

or 0).

Raises:

TypeError - The other is not a Geohash, LatLon or str or invalid radius.

See Also: Local, flat earth approximation, functions

euclideanTo (self, other, **radius_adjust_wrap)

Approximate the distance between this and an other geohash using the euclidean function.

Arguments:

other - The other geohash (Geohash, LatLon or str).
radius_adjust_wrap - Optional keyword arguments for function euclidean.

Returns:

Distance (meter, same units as radius or the ellipsoid or datum axes).

Raises:

TypeError - The other is not a Geohash, LatLon or str or invalid radius.

haversineTo (self, other, **radius_wrap)

Compute the distance between this and an other geohash using the haversine formula.

Arguments:

other - The other geohash (Geohash, LatLon or str).
radius_wrap - Optional keyword arguments for function haversine.

Returns:

Distance (meter, same units as radius or the ellipsoid or datum axes).

Raises:

TypeError - The other is not a Geohash, LatLon or str or invalid radius.

toLatLon (self, LatLon=None, **LatLon_kwds)

Return (the approximate center of) this geohash cell as an instance of the supplied LatLon class.

Arguments:

LatLon - Class to use (LatLon) or None.
LatLon_kwds - Optional, additional LatLon keyword arguments, ignored if LatLon is None.

Returns:

This geohash location (LatLon) or a LatLon2Tuple(lat, lon) if LatLon is None.

Raises:

TypeError - Invalid LatLon or LatLon_kwds.

vincentysTo (self, other, **radius_wrap)

Compute the distance between this and an other geohash using the vincentys formula.

Arguments:

other - The other geohash (Geohash, LatLon or str).
radius_wrap - Optional keyword arguments for function vincentys.

Returns:

Distance (meter, same units as radius or the ellipsoid or datum axes).

Raises:

TypeError - The other is not a Geohash, LatLon or str or invalid radius.

Property Details

latlon

Get the lat- and longitude of (the approximate center of) this geohash as a LatLon2Tuple(lat, lon) in degrees.

Get method:: latlon(self) - Get the lat- and longitude of (the approximate center of) this geohash as a LatLon2Tuple(lat, lon) in degrees.
Set method:: _fset_error(inst, val) - Throws an AttributeError, always.
Delete Method:: _fdel(inst) - Zap the cached/memoized property value.

neighbors

Get all 8 adjacent cells as a Neighbors8Dict(N, NE, E, SE, S, SW, W, NW) of Geohashes.

Get method:: neighbors(self) - Get all 8 adjacent cells as a Neighbors8Dict(N, NE, E, SE, S, SW, W, NW) of Geohashes.
Set method:: _fset_error(inst, val) - Throws an AttributeError, always.
Delete Method:: _fdel(inst) - Zap the cached/memoized property value.

philam

Get the lat- and longitude of (the approximate center of) this geohash as a PhiLam2Tuple(phi, lam) in radians.

Get method:: philam(self) - Get the lat- and longitude of (the approximate center of) this geohash as a PhiLam2Tuple(phi, lam) in radians.
Set method:: _fset_error(inst, val) - Throws an AttributeError, always.
Delete Method:: _fdel(inst) - Zap the cached/memoized property value.

precision

Get this geohash's precision (int).

Get method:: precision(self) - Get this geohash's precision (int).
Set method:: _fset_error(inst, val) - Throws an AttributeError, always.
Delete Method:: _fdel(inst) - Zap the cached/memoized property value.

sizes

Get the lat- and longitudinal size of this cell as a LatLon2Tuple(lat, lon) in (meter).

Get method:: sizes(self) - Get the lat- and longitudinal size of this cell as a LatLon2Tuple(lat, lon) in (meter).
Set method:: _fset_error(inst, val) - Throws an AttributeError, always.
Delete Method:: _fdel(inst) - Zap the cached/memoized property value.

N

Get the cell North of this (Geohash).

Get method:: N(self) - Get the cell North of this (Geohash).
Set method:: _fset_error(inst, val) - Throws an AttributeError, always.
Delete Method:: _fdel(inst) - Zap the cached/memoized property value.

S

Get the cell South of this (Geohash).

Get method:: S(self) - Get the cell South of this (Geohash).
Set method:: _fset_error(inst, val) - Throws an AttributeError, always.
Delete Method:: _fdel(inst) - Zap the cached/memoized property value.

E

Get the cell East of this (Geohash).

Get method:: E(self) - Get the cell East of this (Geohash).
Set method:: _fset_error(inst, val) - Throws an AttributeError, always.
Delete Method:: _fdel(inst) - Zap the cached/memoized property value.

W

Get the cell West of this (Geohash).

Get method:: W(self) - Get the cell West of this (Geohash).
Set method:: _fset_error(inst, val) - Throws an AttributeError, always.
Delete Method:: _fdel(inst) - Zap the cached/memoized property value.

NE

Get the cell NorthEast of this (Geohash).

Get method:: NE(self) - Get the cell NorthEast of this (Geohash).
Set method:: _fset_error(inst, val) - Throws an AttributeError, always.
Delete Method:: _fdel(inst) - Zap the cached/memoized property value.

NW

Get the cell NorthWest of this (Geohash).

Get method:: NW(self) - Get the cell NorthWest of this (Geohash).
Set method:: _fset_error(inst, val) - Throws an AttributeError, always.
Delete Method:: _fdel(inst) - Zap the cached/memoized property value.

SE

Get the cell SouthEast of this (Geohash).

Get method:: SE(self) - Get the cell SouthEast of this (Geohash).
Set method:: _fset_error(inst, val) - Throws an AttributeError, always.
Delete Method:: _fdel(inst) - Zap the cached/memoized property value.

SW

Get the cell SouthWest of this (Geohash).

Get method:: SW(self) - Get the cell SouthWest of this (Geohash).
Set method:: _fset_error(inst, val) - Throws an AttributeError, always.
Delete Method:: _fdel(inst) - Zap the cached/memoized property value.

Class Geohash

__new__ (cls, cll, precision=None, name='') Static Method

adjacent (self, direction, name='')

bounds (self, LatLon=None, **LatLon_kwds)

distanceTo (self, other)

equirectangularTo (self, other, radius=6371008.771415, **adjust_limit_wrap)

euclideanTo (self, other, **radius_adjust_wrap)

haversineTo (self, other, **radius_wrap)

toLatLon (self, LatLon=None, **LatLon_kwds)

vincentysTo (self, other, **radius_wrap)

latlon

neighbors

philam

precision

sizes

N

S

E

W

NE

NW

SE

SW

new (cls, cll, precision=None, name='')
Static Method