[android] #5858 - added convenience methods for color properties

1 files changed, 21 insertions, 0 deletions

diff --git a/platform/android/MapboxGLAndroidSDK/src/main/java/com/mapbox/mapboxsdk/style/sources/GeoJsonSource.java b/platform/android/MapboxGLAndroidSDK/src/main/java/com/mapbox/mapboxsdk/style/sources/GeoJsonSource.java
index f1399daf12..fc7928015e 100644
--- a/platform/android/MapboxGLAndroidSDK/src/main/java/com/mapbox/mapboxsdk/style/sources/GeoJsonSource.java
+++ b/platform/android/MapboxGLAndroidSDK/src/main/java/com/mapbox/mapboxsdk/style/sources/GeoJsonSource.java
@@ -3,12 +3,27 @@ package com.mapbox.mapboxsdk.style.sources;
 import java.net.URL;
 import java.util.HashMap;
 
+/**
+ * A GeoJson source.
+ *
+ * @see <a href="https://www.mapbox.com/mapbox-gl-style-spec/#sources-geojson">the style specification</a>
+ */
 public class GeoJsonSource extends Source {
     public static final String TYPE = "geojson";
     private static final String DATA_KEY = "data";
 
+    /**
+     * Create a GeoJsonSource from a raw json string
+     *
+     * @param id      the source id
+     * @param geoJson raw Json body
+     */
     public GeoJsonSource(String id, String geoJson) {
         super(id, TYPE);
+        if (geoJson == null || geoJson.startsWith("http")) {
+            throw new IllegalArgumentException("Expected a raw json body");
+        }
+
         //Wrap the String in a map as an Object is expected by the
         //style conversion template
         HashMap<String, String> wrapper = new HashMap<>();
@@ -16,6 +31,12 @@ public class GeoJsonSource extends Source {
         this.put(DATA_KEY, wrapper);
     }
 
+    /**
+     * Create a GeoJsonSource from a remote geo json file
+     *
+     * @param id  the source id
+     * @param url remote json file
+     */
     public GeoJsonSource(String id, URL url) {
         super(id, TYPE);
         this.put(DATA_KEY, url.toExternalForm());