PostGIS  2.5.0dev-r@@SVN_REVISION@@
char* lwgeom_geohash ( const LWGEOM lwgeom,
int  precision 
)

Calculate the GeoHash (http://geohash.org) string for a geometry.

Caller must free.

Definition at line 838 of file lwalgorithm.c.

References gbox_init(), geohash_point(), LW_FAILURE, lwerror(), lwgeom_calculate_gbox_cartesian(), lwgeom_geohash_precision(), GBOX::xmax, GBOX::xmin, GBOX::ymax, and GBOX::ymin.

Referenced by ST_GeoHash(), and test_geohash().

839 {
840  GBOX gbox;
841  GBOX gbox_bounds;
842  double lat, lon;
843  int result;
844 
845  gbox_init(&gbox);
846  gbox_init(&gbox_bounds);
847 
848  result = lwgeom_calculate_gbox_cartesian(lwgeom, &gbox);
849  if ( result == LW_FAILURE ) return NULL;
850 
851  /* Return error if we are being fed something outside our working bounds */
852  if ( gbox.xmin < -180 || gbox.ymin < -90 || gbox.xmax > 180 || gbox.ymax > 90 )
853  {
854  lwerror("Geohash requires inputs in decimal degrees, got (%g %g, %g %g).",
855  gbox.xmin, gbox.ymin,
856  gbox.xmax, gbox.ymax);
857  return NULL;
858  }
859 
860  /* What is the center of our geometry bounds? We'll use that to
861  ** approximate location. */
862  lon = gbox.xmin + (gbox.xmax - gbox.xmin) / 2;
863  lat = gbox.ymin + (gbox.ymax - gbox.ymin) / 2;
864 
865  if ( precision <= 0 )
866  {
867  precision = lwgeom_geohash_precision(gbox, &gbox_bounds);
868  }
869 
870  /*
871  ** Return the geohash of the center, with a precision determined by the
872  ** extent of the bounds.
873  ** Possible change: return the point at the center of the precision bounds?
874  */
875  return geohash_point(lon, lat, precision);
876 }
double xmax
Definition: liblwgeom.h:292
int lwgeom_geohash_precision(GBOX bbox, GBOX *bounds)
Definition: lwalgorithm.c:742
#define LW_FAILURE
Definition: liblwgeom.h:78
char * geohash_point(double longitude, double latitude, int precision)
Definition: lwalgorithm.c:581
double ymin
Definition: liblwgeom.h:293
void gbox_init(GBOX *gbox)
Zero out all the entries in the GBOX.
Definition: g_box.c:47
double xmin
Definition: liblwgeom.h:291
uint8_t precision
Definition: cu_in_twkb.c:25
double ymax
Definition: liblwgeom.h:294
void lwerror(const char *fmt,...)
Write a notice out to the error handler.
Definition: lwutil.c:190
int lwgeom_calculate_gbox_cartesian(const LWGEOM *lwgeom, GBOX *gbox)
Calculate the 2-4D bounding box of a geometry.
Definition: g_box.c:678

Here is the call graph for this function:

Here is the caller graph for this function: