org.apache.lucene.util

Class GeoDistanceUtils

java.lang.Object

org.apache.lucene.util.GeoDistanceUtils

public class GeoDistanceUtils
extends Object

Reusable geo-spatial distance utility methods.

WARNING: This API is experimental and might change in incompatible ways in the next release.

Constructor Summary

Constructors

Constructor and Description
GeoDistanceUtils()

Method Summary

Methods

Modifier and Type	Method and Description
static double	distanceToDegreesLat(double lat, double distance) Compute the inverse haversine to determine distance in degrees longitude for provided distance in meters
static double	distanceToDegreesLon(double lat, double distance) Compute the inverse haversine to determine distance in degrees longitude for provided distance in meters
static double	vincentyDistance(double lonA, double latA, double lonB, double latB) Compute the distance between two geo-points using vincenty distance formula Vincenty uses the oblate spheroid whereas haversine uses unit sphere, this will give roughly 22m better accuracy (in worst case) than haversine

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

GeoDistanceUtils

public GeoDistanceUtils()

Method Detail

vincentyDistance

public static final double vincentyDistance(double lonA,
                      double latA,
                      double lonB,
                      double latB)

Compute the distance between two geo-points using vincenty distance formula Vincenty uses the oblate spheroid whereas haversine uses unit sphere, this will give roughly 22m better accuracy (in worst case) than haversine

Parameters:

lonA - longitudinal coordinate of point A (in degrees)

latA - latitudinal coordinate of point A (in degrees)

lonB - longitudinal coordinate of point B (in degrees)

latB - latitudinal coordinate of point B (in degrees)

Returns:

distance (in meters) between point A and point B

distanceToDegreesLon

public static double distanceToDegreesLon(double lat,
                          double distance)

Compute the inverse haversine to determine distance in degrees longitude for provided distance in meters

Parameters:

lat - latitude to compute delta degrees lon

distance - distance in meters to convert to degrees lon

Returns:

Sloppy distance in degrees longitude for provided distance in meters

distanceToDegreesLat

public static double distanceToDegreesLat(double lat,
                          double distance)

Compute the inverse haversine to determine distance in degrees longitude for provided distance in meters

Parameters:

lat - latitude to compute delta degrees lon

distance - distance in meters to convert to degrees lon

Returns:

Sloppy distance in degrees longitude for provided distance in meters