GeoUtils (Elasticsearch: Core 2.3.0 API)

java.lang.Object
- org.elasticsearch.common.geo.GeoUtils

```
public class GeoUtils
extends Object
```

Field Summary

Fields
Modifier and Type	Field and Description
`static double`	`EARTH_AXIS_RATIO` Earth axis ratio defined by WGS 84 (0.996647189335)
`static double`	`EARTH_EQUATOR` Earth ellipsoid equator length in meters
`static double`	`EARTH_MEAN_RADIUS` Earth mean radius defined by WGS 84 in meters
`static double`	`EARTH_POLAR_DISTANCE` Earth ellipsoid polar distance in meters
`static double`	`EARTH_SEMI_MAJOR_AXIS` Earth ellipsoid major axis defined by WGS 84 in meters
`static double`	`EARTH_SEMI_MINOR_AXIS` Earth ellipsoid minor axis defined by WGS 84 in meters
`static String`	`GEOHASH`
`static String`	`LATITUDE`
`static String`	`LONGITUDE`

Method Summary

Methods
Modifier and Type	Method and Description
`static double`	`earthDiameter(double latitude)` Return an approximate value of the diameter of the earth (in meters) at the given latitude (in radians).
`static double`	`geoHashCellHeight(int level)` Calculate the height (in meters) of geohash cells at a specific level
`static double`	`geoHashCellSize(int level)` Calculate the size (in meters) of geohash cells at a specific level
`static double`	`geoHashCellWidth(int level)` Calculate the width (in meters) of geohash cells at a specific level
`static int`	`geoHashLevelsForPrecision(double meters)` Calculate the number of levels needed for a specific precision.
`static int`	`geoHashLevelsForPrecision(String distance)` Calculate the number of levels needed for a specific precision.
`static double`	`maxRadialDistance(GeoPoint center, double initialRadius)` Returns the minimum between the provided distance 'initialRadius' and the maximum distance/radius from the point 'center' before overlapping
`static double`	`normalizeLat(double lat)` Normalize latitude to lie within the -90 to 90 (both inclusive) range.
`static double`	`normalizeLon(double lon)` Normalize longitude to lie within the -180 (exclusive) to 180 (inclusive) range.
`static void`	`normalizePoint(double[] lonLat)`
`static void`	`normalizePoint(double[] lonLat, boolean normLon, boolean normLat)`
`static void`	`normalizePoint(GeoPoint point)` Normalize the geo `Point` for its coordinates to lie within their respective normalized ranges.
`static void`	`normalizePoint(GeoPoint point, boolean normLat, boolean normLon)` Normalize the geo `Point` for the given coordinates to lie within their respective normalized ranges.
`static GeoPoint`	`parseGeoPoint(String data, GeoPoint point)` parse a `GeoPoint` from a String
`static GeoPoint`	`parseGeoPoint(XContentParser parser)` Parse a `GeoPoint` with a `XContentParser`:
`static GeoPoint`	`parseGeoPoint(XContentParser parser, GeoPoint point)` Parse a `GeoPoint` with a `XContentParser`.
`static double`	`quadTreeCellHeight(int level)` Calculate the height (in meters) of quadtree cells at a specific level
`static double`	`quadTreeCellSize(int level)` Calculate the size (in meters) of quadtree cells at a specific level
`static double`	`quadTreeCellWidth(int level)` Calculate the width (in meters) of quadtree cells at a specific level
`static int`	`quadTreeLevelsForPrecision(double meters)` Calculate the number of levels needed for a specific precision.
`static int`	`quadTreeLevelsForPrecision(String distance)` Calculate the number of levels needed for a specific precision.

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Field Detail
  - LATITUDE
```
public static final String LATITUDE
```
    See Also:
    Constant Field Values
  - LONGITUDE
```
public static final String LONGITUDE
```
    See Also:
    Constant Field Values
  - GEOHASH
```
public static final String GEOHASH
```
    See Also:
    Constant Field Values
  - EARTH_SEMI_MAJOR_AXIS
```
public static final double EARTH_SEMI_MAJOR_AXIS
```
    Earth ellipsoid major axis defined by WGS 84 in meters
    
    See Also:
    Constant Field Values
  - EARTH_SEMI_MINOR_AXIS
```
public static final double EARTH_SEMI_MINOR_AXIS
```
    Earth ellipsoid minor axis defined by WGS 84 in meters
    
    See Also:
    Constant Field Values
  - EARTH_MEAN_RADIUS
```
public static final double EARTH_MEAN_RADIUS
```
    Earth mean radius defined by WGS 84 in meters
    
    See Also:
    Constant Field Values
  - EARTH_AXIS_RATIO
```
public static final double EARTH_AXIS_RATIO
```
    Earth axis ratio defined by WGS 84 (0.996647189335)
    
    See Also:
    Constant Field Values
  - EARTH_EQUATOR
```
public static final double EARTH_EQUATOR
```
    Earth ellipsoid equator length in meters
    
    See Also:
    Constant Field Values
  - EARTH_POLAR_DISTANCE
```
public static final double EARTH_POLAR_DISTANCE
```
    Earth ellipsoid polar distance in meters
    
    See Also:
    Constant Field Values
- Method Detail
  - maxRadialDistance
```
public static double maxRadialDistance(GeoPoint center,
                       double initialRadius)
```
    Returns the minimum between the provided distance 'initialRadius' and the maximum distance/radius from the point 'center' before overlapping
  - earthDiameter
```
public static double earthDiameter(double latitude)
```
    Return an approximate value of the diameter of the earth (in meters) at the given latitude (in radians).
  - geoHashCellWidth
```
public static double geoHashCellWidth(int level)
```
    Calculate the width (in meters) of geohash cells at a specific level
    
    Parameters:
    level - geohash level must be greater or equal to zero
    
    Returns:
    the width of cells at level in meters
  - quadTreeCellWidth
```
public static double quadTreeCellWidth(int level)
```
    Calculate the width (in meters) of quadtree cells at a specific level
    
    Parameters:
    level - quadtree level must be greater or equal to zero
    
    Returns:
    the width of cells at level in meters
  - geoHashCellHeight
```
public static double geoHashCellHeight(int level)
```
    Calculate the height (in meters) of geohash cells at a specific level
    
    Parameters:
    level - geohash level must be greater or equal to zero
    
    Returns:
    the height of cells at level in meters
  - quadTreeCellHeight
```
public static double quadTreeCellHeight(int level)
```
    Calculate the height (in meters) of quadtree cells at a specific level
    
    Parameters:
    level - quadtree level must be greater or equal to zero
    
    Returns:
    the height of cells at level in meters
  - geoHashCellSize
```
public static double geoHashCellSize(int level)
```
    Calculate the size (in meters) of geohash cells at a specific level
    
    Parameters:
    level - geohash level must be greater or equal to zero
    
    Returns:
    the size of cells at level in meters
  - quadTreeCellSize
```
public static double quadTreeCellSize(int level)
```
    Calculate the size (in meters) of quadtree cells at a specific level
    
    Parameters:
    level - quadtree level must be greater or equal to zero
    
    Returns:
    the size of cells at level in meters
  - quadTreeLevelsForPrecision
```
public static int quadTreeLevelsForPrecision(double meters)
```
    Calculate the number of levels needed for a specific precision. Quadtree cells will not exceed the specified size (diagonal) of the precision.
    
    Parameters:
    meters - Maximum size of cells in meters (must greater than zero)
    
    Returns:
    levels need to achieve precision
  - quadTreeLevelsForPrecision
```
public static int quadTreeLevelsForPrecision(String distance)
```
    Calculate the number of levels needed for a specific precision. QuadTree cells will not exceed the specified size (diagonal) of the precision.
    
    Parameters:
    distance - Maximum size of cells as unit string (must greater or equal to zero)
    
    Returns:
    levels need to achieve precision
  - geoHashLevelsForPrecision
```
public static int geoHashLevelsForPrecision(double meters)
```
    Calculate the number of levels needed for a specific precision. GeoHash cells will not exceed the specified size (diagonal) of the precision.
    
    Parameters:
    meters - Maximum size of cells in meters (must greater or equal to zero)
    
    Returns:
    levels need to achieve precision
  - geoHashLevelsForPrecision
```
public static int geoHashLevelsForPrecision(String distance)
```
    Calculate the number of levels needed for a specific precision. GeoHash cells will not exceed the specified size (diagonal) of the precision.
    
    Parameters:
    distance - Maximum size of cells as unit string (must greater or equal to zero)
    
    Returns:
    levels need to achieve precision
  - normalizeLon
```
public static double normalizeLon(double lon)
```
    Normalize longitude to lie within the -180 (exclusive) to 180 (inclusive) range.
    
    Parameters:
    lon - Longitude to normalize
    
    Returns:
    The normalized longitude.
  - normalizeLat
```
public static double normalizeLat(double lat)
```
    Normalize latitude to lie within the -90 to 90 (both inclusive) range.
    Note: You should not normalize longitude and latitude separately, because when normalizing latitude it may be necessary to add a shift of 180° in the longitude. For this purpose, you should call the normalizePoint(GeoPoint) function.
    
    Parameters:
    lat - Latitude to normalize
    
    Returns:
    The normalized latitude.
    See Also:
    normalizePoint(GeoPoint)
  - normalizePoint
```
public static void normalizePoint(GeoPoint point)
```
    Normalize the geo Point for its coordinates to lie within their respective normalized ranges.
    Note: A shift of 180° is applied in the longitude if necessary, in order to normalize properly the latitude.
    
    Parameters:
    point - The point to normalize in-place.
  - normalizePoint
```
public static void normalizePoint(GeoPoint point,
                  boolean normLat,
                  boolean normLon)
```
    Normalize the geo Point for the given coordinates to lie within their respective normalized ranges.
    You can control which coordinate gets normalized with the two flags.
    Note: A shift of 180° is applied in the longitude if necessary, in order to normalize properly the latitude. If normalizing latitude but not longitude, it is assumed that the longitude is in the form x+k*360, with x in ]-180;180], and k is meaningful to the application. Therefore x will be adjusted while keeping k preserved.
    
    Parameters:
    point - The point to normalize in-place.
    normLat - Whether to normalize latitude or leave it as is.
    normLon - Whether to normalize longitude.
  - normalizePoint
```
public static void normalizePoint(double[] lonLat)
```
  - normalizePoint
```
public static void normalizePoint(double[] lonLat,
                  boolean normLon,
                  boolean normLat)
```
  - parseGeoPoint
```
public static GeoPoint parseGeoPoint(XContentParser parser)
                              throws IOException,
                                     ElasticsearchParseException
```
    Parse a GeoPoint with a XContentParser:
    
    Parameters:
    parser - XContentParser to parse the value from
    
    Returns:
    new GeoPoint parsed from the parse
    
    Throws:
    
    IOException
    
    ElasticsearchParseException
  - parseGeoPoint
```
public static GeoPoint parseGeoPoint(XContentParser parser,
                     GeoPoint point)
                              throws IOException,
                                     ElasticsearchParseException
```
    Parse a GeoPoint with a XContentParser. A geopoint has one of the following forms:
    - Object:
      {"lat": <latitude>, "lon": <longitude>}
    - String:
      "<latitude>,<longitude>"
    - Geohash:
      "<geohash>"
    - Array:
      [<longitude>,<latitude>]
    Parameters:
    parser - XContentParser to parse the value from
    point - A GeoPoint that will be reset by the values parsed
    
    Returns:
    new GeoPoint parsed from the parse
    
    Throws:
    
    IOException
    
    ElasticsearchParseException
  - parseGeoPoint
```
public static GeoPoint parseGeoPoint(String data,
                     GeoPoint point)
```
    parse a GeoPoint from a String

Class GeoUtils

Field Summary

Method Summary

Methods inherited from class java.lang.Object

Field Detail

LATITUDE

LONGITUDE

GEOHASH

EARTH_SEMI_MAJOR_AXIS

EARTH_SEMI_MINOR_AXIS

EARTH_MEAN_RADIUS

EARTH_AXIS_RATIO

EARTH_EQUATOR

EARTH_POLAR_DISTANCE

Method Detail

maxRadialDistance

earthDiameter

geoHashCellWidth

quadTreeCellWidth

geoHashCellHeight

quadTreeCellHeight

geoHashCellSize

quadTreeCellSize

quadTreeLevelsForPrecision

quadTreeLevelsForPrecision

geoHashLevelsForPrecision

geoHashLevelsForPrecision

normalizeLon

normalizeLat

normalizePoint

normalizePoint

normalizePoint

normalizePoint

parseGeoPoint

parseGeoPoint

parseGeoPoint