io.github.jokoframework.utils.location

Class LocationUtils

java.lang.Object

io.github.jokoframework.utils.location.LocationUtils

public class LocationUtils
extends java.lang.Object

Utilidades para trabajar con geolocalizacion

Constructor Summary

Constructors

Constructor and Description
LocationUtils()

Method Summary

Modifier and Type	Method and Description
static double	distance(double lat1, double lat2, double lon1, double lon2, double el1, double el2) Calcula la distancia entre dos puntos en latitud y longitud tomando en cuenta la diferencia en elevación (Elevación en metros).
static double	distance(double lat1, double lon1, double lat2, double lon2, java.lang.String unit) Calcula la distancia entre dos puntos geográficos sin contar la altura y retorna dicha distancia en la medida que se incluye como argumento.
static java.lang.String	formatDistance(java.lang.Double distance) Utiliza el argumento "distance" tal que si este es menor o igual a 1000.0 se retorna un String que contiene el monto con dos decimales, separadores de miles y la unidad de medida "m" concatenada al final.

Methods inherited from class java.lang.Object

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

Constructor Detail

LocationUtils

public LocationUtils()

Method Detail

distance

public static double distance(double lat1,
                              double lat2,
                              double lon1,
                              double lon2,
                              double el1,
                              double el2)

Calcula la distancia entre dos puntos en latitud y longitud tomando en cuenta la diferencia en elevación (Elevación en metros). Si no esta interesado en tomar en cuenta la diferencia en elevación pasar 0.0 en ambas. Usa el método Haversine como su base.

Parameters:

lat1 - Latitud 1

lat2 - Latitud 2

lon1 - Longitud 1

lon2 - Longitud 2

el1 - Elevación 1

el2 - Elevación 2

Returns:

Distancia en metros

distance

public static double distance(double lat1,
                              double lon1,
                              double lat2,
                              double lon2,
                              java.lang.String unit)

Calcula la distancia entre dos puntos geográficos sin contar la altura y retorna dicha distancia en la medida que se incluye como argumento.

Parameters:

lat1 - Latitud 1

lon1 - Longitud 1

lat2 - Latitud 2

lon2 - Longitud 2

unit - String con la unidad de medida del resultado, "K" para kilómetros, "M" para metros, "N" para Millas Náuticas y cualquier otro valor para Millas

Returns:

Distancia entre dos puntos geográficos en la unidad de medida especificada (Si no se reconoce la medida sera en Millas)

formatDistance

public static java.lang.String formatDistance(java.lang.Double distance)

Utiliza el argumento "distance" tal que si este es menor o igual a 1000.0 se retorna un String que contiene el monto con dos decimales, separadores de miles y la unidad de medida "m" concatenada al final. Si es mayor a 1000.0 "distance" se retorna lo mencionado pero con el monto pasado a kilómetros, sin decimales y "km" concatenado

Parameters:

distance - Un Double conteniendo una distancia en metros

Returns:

Un String que contiene el argumento "distance" con solo 2 decimales, separadores de miles, unidad de medida, si la cantidad es mayor a 1,000 metros se devuelve el valor en kilometros y sin decimales