Package pygeodesy :: Module geohash :: Class Geohash |
[frames] | no frames]

# Class Geohash

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

Geohash class, a named `str`.

Instance Methods
adjacent(self, direction) Determine the adjacent cell in given compass direction. |
bounds(self, LatLon=None, **LatLon_kwds) Return the lower-left SW and upper-right NE bounds of this geohash cell. |
distance1To(self, other) Estimate the distance between this and an other geohash (from the cell sizes). |
distance1(self, other) DEPRECATED, use method distance1To. |
distance2To(self, other, radius=6371008.77141, adjust=False, wrap=False) Approximate the distance between this and an other geohash using the equirectangular. |
distance2(self, other, radius=6371008.77141, adjust=False, wrap=False) DEPRECATED, use method distance2To. |
distance3To(self, other, radius=6371008.77141, wrap=False) Compute the distance between this and an other geohash using the haversine formula. |
distance3(self, other, radius=6371008.77141, wrap=False) DEPRECATED, use method distance3To. |
toLatLon(self, LatLon=None, **LatLon_kwds) Return (the approximate center of) this geohash cell as an instance of the supplied `LatLon` class. |
Inherited from `units.Str`: `__repr__`, `__str__`, `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 `named._Named`: `_DOT_`, `attrs`, `classof`, `copy`, `toStr2` 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`.
| ab DEPRECATED, use property philam.
| precision Get this geohash's precision (`int`).
| sizes Get the lat- and longitudinal size of this cell as a LatLon2Tuple`(lat, lon)` with the latitudinal height and longitudinal width 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 `units._NamedUnit`: `std_repr`, `units` Inherited from `named._Named`: `classname`, `classnaming`, `name`, `named`, `named2`, `named3`, `named4` 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) |
Determine the adjacent cell in given compass direction. Arguments: `direction` - Compass direction ('N', 'S', 'E' or 'W'). 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 keyword arguments for {LatLon}. Returns: A Bounds2Tuple`(latlonSW, latlonNE)` of `LatLon`s or if `LatLon` is `None`, a Bounds4Tuple`(latS, lonW, latN, lonE)`.

### distance1To (self, other) |
Estimate the distance between this and an other geohash (from 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`.

### distance1 (self, other) |
DEPRECATED, use method distance1To. Arguments: `other` - The other geohash (Geohash, `LatLon` or `str`). Returns: Approximate distance (`meter`). Raises: `TypeError` - The `other` is not a Geohash, `LatLon` or `str`.

### distance2To (self, other, radius=6371008.77141, adjust=False, wrap=False) |
Approximate the distance between this and an other geohash using the equirectangular. Arguments: `other` - The other geohash (Geohash, `LatLon` or `str`). `radius` - Mean earth radius (`meter`) or `None`. `adjust` - Adjust the wrapped, unrolled longitudinal delta by the cosine of the mean latitude `bool`). `wrap` - Wrap and unroll longitudes (`bool`). Returns: Approximate distance (`meter`, same units as `radius`) or distance squared (`degrees squared`) if `radius=None` or `radius=0`. Raises: `TypeError` - The other is not a Geohash, `LatLon` or `str`. See Also: Local, flat earth approximation, functions

### distance2 (self, other, radius=6371008.77141, adjust=False, wrap=False) |
DEPRECATED, use method distance2To. Arguments: `other` - The other geohash (Geohash, `LatLon` or `str`). `radius` - Mean earth radius (`meter`) or `None`. `adjust` - Adjust the wrapped, unrolled longitudinal delta by the cosine of the mean latitude `bool`). `wrap` - Wrap and unroll longitudes (`bool`). Returns: Approximate distance (`meter`, same units as `radius`) or distance squared (`degrees squared`) if `radius=None` or `radius=0`. Raises: `TypeError` - The other is not a Geohash, `LatLon` or `str`. See Also: Local, flat earth approximation, functions

### distance3To (self, other, radius=6371008.77141, wrap=False) |
Compute the distance between this and an other geohash using the haversine formula. Arguments: `other` - The other geohash (Geohash, `LatLon` or `str`). `radius` - Mean earth radius (`meter`). `wrap` - Wrap and unroll longitudes (`bool`). Returns: Great-circle distance (`meter`, same units as radius). Raises: `TypeError` - The other is not a Geohash, `LatLon` or `str`. `UnitError` - Invalid `radius`.

### distance3 (self, other, radius=6371008.77141, wrap=False) |
DEPRECATED, use method distance3To. Arguments: `other` - The other geohash (Geohash, `LatLon` or `str`). `radius` - Mean earth radius (`meter`). `wrap` - Wrap and unroll longitudes (`bool`). Returns: Great-circle distance (`meter`, same units as radius). Raises: `TypeError` - The other is not a Geohash, `LatLon` or `str`. `UnitError` - 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 keyword arguments for `LatLon`, ignored if `LatLon=None`. Returns: This geohash location (`LatLon`). Raises: `TypeError` - Invalid `LatLon` or `LatLon_kwds`. Example:
    >>> from sphericalTrigonometry import LatLon
    >>> ll = Geohash('u120fxw').toLatLon(LatLon)
    >>> print(repr(ll))  # LatLon(52°12′17.9″N, 000°07′07.64″E)
    >>> print(ll)  # 52.204971°N, 000.11879°E

Property Details

### latlon Get the lat- and longitude of (the approximate center of) this geohash as a LatLon2Tuple`(lat, lon)` in `degrees`. Example:
    >>> geohash.Geohash('geek').latlon  # 65.478515625, -17.75390625
    >>> geohash.decode('geek')  # '65.48', '-17.75'
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: _immutable(inst, value) - Throws an `AttributeError`, always.

### neighbors Get all 8 adjacent cells as a Neighbors8Dict`(N, NE, E, SE, S, SW, W, NW)` of Geohashes. JSname: neighbours. Get method: neighbors(self) - Get all 8 adjacent cells as a Neighbors8Dict`(N, NE, E, SE, S, SW, W, NW)` of Geohashes. Set method: _immutable(inst, value) - Throws an `AttributeError`, always.

### 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: _immutable(inst, value) - Throws an `AttributeError`, always.

### ab DEPRECATED, use property philam. 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: _immutable(inst, value) - Throws an `AttributeError`, always.

### precision Get this geohash's precision (`int`). Get method: precision(self) - Get this geohash's precision (`int`). Set method: _immutable(inst, value) - Throws an `AttributeError`, always.

### sizes Get the lat- and longitudinal size of this cell as a LatLon2Tuple`(lat, lon)` with the latitudinal height and longitudinal width in (`meter`). Get method: sizes(self) - Get the lat- and longitudinal size of this cell as a LatLon2Tuple`(lat, lon)` with the latitudinal height and longitudinal width in (`meter`). Set method: _immutable(inst, value) - Throws an `AttributeError`, always.

### N Get the cell North of this (Geohash). Get method: N(self) - Get the cell North of this (Geohash). Set method: _immutable(inst, value) - Throws an `AttributeError`, always.

### S Get the cell South of this (Geohash). Get method: S(self) - Get the cell South of this (Geohash). Set method: _immutable(inst, value) - Throws an `AttributeError`, always.

### E Get the cell East of this (Geohash). Get method: E(self) - Get the cell East of this (Geohash). Set method: _immutable(inst, value) - Throws an `AttributeError`, always.

### W Get the cell West of this (Geohash). Get method: W(self) - Get the cell West of this (Geohash). Set method: _immutable(inst, value) - Throws an `AttributeError`, always.

### NE Get the cell NorthEast of this (Geohash). Get method: NE(self) - Get the cell NorthEast of this (Geohash). Set method: _immutable(inst, value) - Throws an `AttributeError`, always.

### NW Get the cell NorthWest of this (Geohash). Get method: NW(self) - Get the cell NorthWest of this (Geohash). Set method: _immutable(inst, value) - Throws an `AttributeError`, always.

### SE Get the cell SouthEast of this (Geohash). Get method: SE(self) - Get the cell SouthEast of this (Geohash). Set method: _immutable(inst, value) - Throws an `AttributeError`, always.

### SW Get the cell SouthWest of this (Geohash). Get method: SW(self) - Get the cell SouthWest of this (Geohash). Set method: _immutable(inst, value) - Throws an `AttributeError`, always.