Added utility method to Mapcode.

Author: rijnb

pom.xml

@@ -74,7 +74,7 @@
         <jsr305.version>3.0.0</jsr305.version>
         <junit.version>4.12</junit.version>
         <log4j.version>1.2.17</log4j.version>
-        <slf4j.version>1.7.10</slf4j.version>
+        <slf4j.version>1.7.12</slf4j.version>
         <nexus-staging-maven-plugin.version>1.6.5</nexus-staging-maven-plugin.version>
         <maven-source-plugin.version>2.4</maven-source-plugin.version>
         <maven-javadoc-plugin.version>2.10.1</maven-javadoc-plugin.version>

src/main/java/com/mapcode/Mapcode.java

@@ -72,6 +72,26 @@ public String getMapcode() {
         return mapcodePrecision0;
     }
 
+    /**
+     * Alias for {@link #getMapcode}.
+     *
+     * @param precision Precision. Range: 0..2.
+     * @return Mapcode string.
+     */
+    @Nonnull
+    public String getMapcodePrecision(final int precision) {
+        switch (precision) {
+            case 0:
+                return mapcodePrecision0;
+            case 1:
+                return mapcodePrecision1;
+            case 2:
+                return mapcodePrecision2;
+            default:
+                throw new IllegalArgumentException("getMapcodePrecision: precision must be in [0..2]");
+        }
+    }
+
     /**
      * Alias for {@link #getMapcode}.
      *
@@ -123,9 +143,7 @@ public String getMapcodePrecision2() {
         return mapcodePrecision2;
     }
 
-    /**
-     * Deprecated alias for {@see #getMapcodePrecision2}.
-     */
+    // Deprecated alias for {@see #getMapcodePrecision2}.
     @Deprecated
     @Nonnull
     public String getMapcodeHighPrecision() {
@@ -162,7 +180,7 @@ public enum MapcodeFormatType {
 
     /**
      * This patterns/regular expressions is used for checking mapcode format strings.
-     * They've been made pulkic to allow others to use the correct regular expressions as well.
+     * They've been made public to allow others to use the correct regular expressions as well.
      */
     @Nonnull public static final String REGEX_MAPCODE_FORMAT =
         REGEX_MAPCODE_FORMAT1 + REGEX_MAPCODE_FORMAT2 + '(' + REGEX_MAPCODE_PRECISION + ")?$";

src/main/java/com/mapcode/MapcodeCodec.java

@@ -189,12 +189,12 @@ public static Mapcode encodeToInternational(
      * because no territory context is supplied (world-wide).
      *
      * The accepted format is:
-     * <mapcode>
-     * <territory-code> <mapcode>
+     * {mapcode}
+     * {territory-code} {mapcode}
      *
      * @param mapcode Mapcode.
      * @return Point corresponding to mapcode.
-     * @throws UnknownMapcodeException  Thrown if the mapcode has the correct synaxt,
+     * @throws UnknownMapcodeException  Thrown if the mapcode has the correct syntax,
      *                                  but cannot be decoded into a point.
      * @throws IllegalArgumentException Thrown if arguments are null, or if the syntax of the mapcode is incorrect.
      */
@@ -231,7 +231,7 @@ public static Point decode(
      * Decode a mapcode to a Point. A reference territory is supplied for disambiguation (only used if applicable).
      *
      * The accepted format is:
-     * <mapcode>        (note that a territory code is not allowed here)
+     * {mapcode}        (note that a territory code is not allowed here)
      *
      * @param mapcode          Mapcode.
      * @param territoryContext Territory for disambiguation purposes.
@@ -244,7 +244,7 @@ public static Point decode(
         @Nonnull final String mapcode,
         @Nonnull final Territory territoryContext) throws UnknownMapcodeException, IllegalArgumentException {
         checkNonnull("mapcode", mapcode);
-        checkNonnull("territoryConext", territoryContext);
+        checkNonnull("territoryContext", territoryContext);
         final String mapcodeTrimmed = mapcode.trim();
         if (!Mapcode.isValidMapcodeFormat(mapcodeTrimmed)) {
             throw new IllegalArgumentException(mapcode + " is not a correctly formatted mapcode; " +