View Javadoc

1   /**
2    * Copyright (c) 2011, The University of Southampton and the individual contributors.
3    * All rights reserved.
4    *
5    * Redistribution and use in source and binary forms, with or without modification,
6    * are permitted provided that the following conditions are met:
7    *
8    *   * 	Redistributions of source code must retain the above copyright notice,
9    * 	this list of conditions and the following disclaimer.
10   *
11   *   *	Redistributions in binary form must reproduce the above copyright notice,
12   * 	this list of conditions and the following disclaimer in the documentation
13   * 	and/or other materials provided with the distribution.
14   *
15   *   *	Neither the name of the University of Southampton nor the names of its
16   * 	contributors may be used to endorse or promote products derived from this
17   * 	software without specific prior written permission.
18   *
19   * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND
20   * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
21   * WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
22   * DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR
23   * ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
24   * (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
25   * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON
26   * ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
27   * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
28   * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
29   */
30  package org.openimaj.demos.mediaeval13.placing;
31  
32  /**
33   * A geolocation consisting of a latitude and longitude
34   * 
35   * @author Jonathon Hare (jsh2@ecs.soton.ac.uk)
36   * 
37   */
38  public class GeoLocation {
39  	public static final double EARTH_RADIUS_KM = 6371;// In kilometers
40  
41  	/**
42  	 * The latitude
43  	 */
44  	public double latitude;
45  
46  	/**
47  	 * The longitude
48  	 */
49  	public double longitude;
50  
51  	public GeoLocation(double lat, double lng) {
52  		this.latitude = lat;
53  		this.longitude = lng;
54  	}
55  
56  	/**
57  	 * Compute the haversine distance between two points on the Earth's surface
58  	 * in kilometers.
59  	 * 
60  	 * @param actual
61  	 * @return
62  	 */
63  	public double haversine(GeoLocation actual) {
64  		return haversine(this.latitude, this.longitude, actual.latitude, actual.longitude);
65  	}
66  
67  	static double haversine(double lat1, double lon1, double lat2, double lon2) {
68  		final double dLat = Math.toRadians(lat2 - lat1);
69  		final double dLon = Math.toRadians(lon2 - lon1);
70  		lat1 = Math.toRadians(lat1);
71  		lat2 = Math.toRadians(lat2);
72  
73  		final double a = Math.sin(dLat / 2) * Math.sin(dLat / 2) + Math.sin(dLon / 2) * Math.sin(dLon / 2)
74  				* Math.cos(lat1) * Math.cos(lat2);
75  		final double c = 2 * Math.asin(Math.sqrt(a));
76  		return EARTH_RADIUS_KM * c;
77  	}
78  
79  	@Override
80  	public String toString() {
81  		return latitude + " " + longitude;
82  	}
83  }