Merge pull request #75 from maxmind/greg/clarify-accuracy-radius

Clarify what the accuracy radius is

Author: autarch

CHANGELOG.md

@@ -1,6 +1,12 @@
 CHANGELOG
 =========
 
+2.8.0 (2016-XX-XX)
+------------------
+
+* All changes included in 2.8.0-rc1.
+* Updated documentation to clarify what the accuracy radius refers to.
+
 2.8.0-rc1 (2016-06-20)
 ----------------------
 

src/main/java/com/maxmind/geoip2/record/Location.java

@@ -68,8 +68,11 @@ public String getTimeZone() {
     }
 
     /**
-     * @return The radius in kilometers around the specified location where the
-     * IP address is likely to be.
+     * @return The approximate accuracy radius in kilometers around the
+     * latitude and longitude for the IP address. This is the radius where we
+     * have a 67% confidence that the device using the IP address resides
+     * within the circle centered at the latitude and longitude with the
+     * provided radius.
      */
     @JsonProperty("accuracy_radius")
     public Integer getAccuracyRadius() {