1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
|
/*
* Copyright 2002-2017 Drew Noakes
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*
* More information about this project is available at:
*
* https://drewnoakes.com/code/exif/
* https://github.com/drewnoakes/metadata-extractor
*/
package com.drew.lang;
import com.drew.lang.annotations.NotNull;
import com.drew.lang.annotations.Nullable;
import java.text.DecimalFormat;
/**
* Represents a latitude and longitude pair, giving a position on earth in spherical coordinates.
* <p>
* Values of latitude and longitude are given in degrees.
* <p>
* This type is immutable.
*/
public final class GeoLocation
{
private final double _latitude;
private final double _longitude;
/**
* Instantiates a new instance of {@link GeoLocation}.
*
* @param latitude the latitude, in degrees
* @param longitude the longitude, in degrees
*/
public GeoLocation(double latitude, double longitude)
{
_latitude = latitude;
_longitude = longitude;
}
/**
* @return the latitudinal angle of this location, in degrees.
*/
public double getLatitude()
{
return _latitude;
}
/**
* @return the longitudinal angle of this location, in degrees.
*/
public double getLongitude()
{
return _longitude;
}
/**
* @return true, if both latitude and longitude are equal to zero
*/
public boolean isZero()
{
return _latitude == 0 && _longitude == 0;
}
/**
* Converts a decimal degree angle into its corresponding DMS (degrees-minutes-seconds) representation as a string,
* of format: {@code -1° 23' 4.56"}
*/
@NotNull
public static String decimalToDegreesMinutesSecondsString(double decimal)
{
double[] dms = decimalToDegreesMinutesSeconds(decimal);
DecimalFormat format = new DecimalFormat("0.##");
return String.format("%s\u00B0 %s' %s\"", format.format(dms[0]), format.format(dms[1]), format.format(dms[2]));
}
/**
* Converts a decimal degree angle into its corresponding DMS (degrees-minutes-seconds) component values, as
* a double array.
*/
@NotNull
public static double[] decimalToDegreesMinutesSeconds(double decimal)
{
int d = (int)decimal;
double m = Math.abs((decimal % 1) * 60);
double s = (m % 1) * 60;
return new double[] { d, (int)m, s};
}
/**
* Converts DMS (degrees-minutes-seconds) rational values, as given in {@link com.drew.metadata.exif.GpsDirectory},
* into a single value in degrees, as a double.
*/
@Nullable
public static Double degreesMinutesSecondsToDecimal(@NotNull final Rational degs, @NotNull final Rational mins, @NotNull final Rational secs, final boolean isNegative)
{
double decimal = Math.abs(degs.doubleValue())
+ mins.doubleValue() / 60.0d
+ secs.doubleValue() / 3600.0d;
if (Double.isNaN(decimal))
return null;
if (isNegative)
decimal *= -1;
return decimal;
}
@Override
public boolean equals(final Object o)
{
if (this == o) return true;
if (o == null || getClass() != o.getClass()) return false;
GeoLocation that = (GeoLocation) o;
if (Double.compare(that._latitude, _latitude) != 0) return false;
if (Double.compare(that._longitude, _longitude) != 0) return false;
return true;
}
@Override
public int hashCode()
{
int result;
long temp;
temp = _latitude != +0.0d ? Double.doubleToLongBits(_latitude) : 0L;
result = (int) (temp ^ (temp >>> 32));
temp = _longitude != +0.0d ? Double.doubleToLongBits(_longitude) : 0L;
result = 31 * result + (int) (temp ^ (temp >>> 32));
return result;
}
/**
* @return a string representation of this location, of format: {@code 1.23, 4.56}
*/
@Override
@NotNull
public String toString()
{
return _latitude + ", " + _longitude;
}
/**
* @return a string representation of this location, of format: {@code -1° 23' 4.56", 54° 32' 1.92"}
*/
@NotNull
public String toDMSString()
{
return decimalToDegreesMinutesSecondsString(_latitude) + ", " + decimalToDegreesMinutesSecondsString(_longitude);
}
}
|
