Merge "Update Location.convert() javadocs to reflect their inconsistency with locales."

This commit is contained in:
Soonil Nagarkar
2015-01-30 21:29:37 +00:00
committed by Android (Google) Code Review

View File

@@ -170,6 +170,9 @@ public class Location implements Parcelable {
* Converts a coordinate to a String representation. The outputType
* may be one of FORMAT_DEGREES, FORMAT_MINUTES, or FORMAT_SECONDS.
* The coordinate must be a valid double between -180.0 and 180.0.
* This conversion is performed in a method that is dependent on the
* default locale, and so is not guaranteed to round-trip with
* {@link #convert(String)}.
*
* @throws IllegalArgumentException if coordinate is less than
* -180.0, greater than 180.0, or is not a number.
@@ -217,7 +220,9 @@ public class Location implements Parcelable {
/**
* Converts a String in one of the formats described by
* FORMAT_DEGREES, FORMAT_MINUTES, or FORMAT_SECONDS into a
* double.
* double. This conversion is performed in a locale agnostic
* method, and so is not guaranteed to round-trip with
* {@link #convert(double, int)}.
*
* @throws NullPointerException if coordinate is null
* @throws IllegalArgumentException if the coordinate is not