Add support for GeoJSON foreign members

geojson/src/commonMain/kotlin/io/github/dellisd/spatialk/geojson/Feature.kt

@@ -1,6 +1,8 @@
 package io.github.dellisd.spatialk.geojson
 
 import io.github.dellisd.spatialk.geojson.serialization.FeatureSerializer
+import io.github.dellisd.spatialk.geojson.serialization.foreignMembers
+import io.github.dellisd.spatialk.geojson.serialization.foreignMembersJsonProps
 import io.github.dellisd.spatialk.geojson.serialization.idProp
 import io.github.dellisd.spatialk.geojson.serialization.jsonProp
 import io.github.dellisd.spatialk.geojson.serialization.toBbox
@@ -36,7 +38,8 @@ class Feature(
     val geometry: Geometry?,
     properties: Map<String, JsonElement> = emptyMap(),
     val id: String? = null,
-    override val bbox: BoundingBox? = null
+    override val bbox: BoundingBox? = null,
+    override val foreignMembers: Map<String, JsonElement> = emptyMap()
 ) : GeoJson {
     private val _properties: MutableMap<String, JsonElement> = properties.toMutableMap()
     val properties: Map<String, JsonElement> get() = _properties
@@ -86,6 +89,7 @@ class Feature(
         if (id != other.id) return false
         if (bbox != other.bbox) return false
         if (_properties != other._properties) return false
+        if (foreignMembers != other.foreignMembers) return false
 
         return true
     }
@@ -95,13 +99,15 @@ class Feature(
         result = 31 * result + (id?.hashCode() ?: 0)
         result = 31 * result + (bbox?.hashCode() ?: 0)
         result = 31 * result + _properties.hashCode()
+        result = 31 * result + foreignMembers.hashCode()
         return result
     }
 
     operator fun component1() = geometry
     operator fun component2() = properties
     operator fun component3() = id
     operator fun component4() = bbox
+    operator fun component5() = foreignMembers
 
     override fun toString(): String = json()
 
@@ -113,16 +119,18 @@ class Feature(
                     JsonElement.serializer()
                 ), properties
             )
-        }}"""
+        }${foreignMembersJsonProps()}}"""
 
     fun copy(
         geometry: Geometry? = this.geometry,
         properties: Map<String, JsonElement> = this.properties,
         id: String? = this.id,
-        bbox: BoundingBox? = this.bbox
-    ): Feature = Feature(geometry, properties, id, bbox)
+        bbox: BoundingBox? = this.bbox,
+        foreignMembers: Map<String, JsonElement> = this.foreignMembers
+    ): Feature = Feature(geometry, properties, id, bbox, foreignMembers)
 
     companion object {
+
         @JvmStatic
         fun fromJson(json: String): Feature = fromJson(Json.decodeFromString(JsonObject.serializer(), json))
 
@@ -145,7 +153,10 @@ class Feature(
             val geom = json["geometry"]?.jsonObject
             val geometry: Geometry? = if (geom != null) Geometry.fromJson(geom) else null
 
-            return Feature(geometry, json["properties"]?.jsonObject ?: emptyMap(), id, bbox)
+            val properties = json["properties"]?.jsonObject ?: emptyMap()
+            val foreignMembers = json.foreignMembers()
+
+            return Feature(geometry, properties, id, bbox, foreignMembers)
         }
     }
 }

geojson/src/commonMain/kotlin/io/github/dellisd/spatialk/geojson/FeatureCollection.kt

@@ -1,11 +1,14 @@
 package io.github.dellisd.spatialk.geojson
 
 import io.github.dellisd.spatialk.geojson.serialization.FeatureCollectionSerializer
+import io.github.dellisd.spatialk.geojson.serialization.foreignMembers
+import io.github.dellisd.spatialk.geojson.serialization.foreignMembersJsonProps
 import io.github.dellisd.spatialk.geojson.serialization.jsonJoin
 import io.github.dellisd.spatialk.geojson.serialization.jsonProp
 import io.github.dellisd.spatialk.geojson.serialization.toBbox
 import kotlinx.serialization.Serializable
 import kotlinx.serialization.json.Json
+import kotlinx.serialization.json.JsonElement
 import kotlinx.serialization.json.JsonObject
 import kotlinx.serialization.json.jsonArray
 import kotlinx.serialization.json.jsonObject
@@ -24,10 +27,15 @@ import kotlin.jvm.JvmStatic
 @Serializable(with = FeatureCollectionSerializer::class)
 class FeatureCollection(
     val features: List<Feature> = emptyList(),
-    override val bbox: BoundingBox? = null
+    override val bbox: BoundingBox? = null,
+    override val foreignMembers: Map<String, JsonElement> = emptyMap()
 ) : Collection<Feature> by features, GeoJson {
 
-    constructor(vararg features: Feature, bbox: BoundingBox? = null) : this(features.toMutableList(), bbox)
+    constructor(
+        vararg features: Feature,
+        bbox: BoundingBox? = null,
+        foreignMembers: Map<String, JsonElement> = emptyMap()
+    ) : this(features.toMutableList(), bbox, foreignMembers)
 
     override fun equals(other: Any?): Boolean {
         if (this === other) return true
@@ -37,25 +45,30 @@ class FeatureCollection(
 
         if (features != other.features) return false
         if (bbox != other.bbox) return false
+        if (foreignMembers != other.foreignMembers) return false
 
         return true
     }
 
     override fun hashCode(): Int {
         var result = features.hashCode()
         result = 31 * result + (bbox?.hashCode() ?: 0)
+        result = 31 * result + foreignMembers.hashCode()
         return result
     }
 
     override fun toString(): String = json()
 
+    @Suppress("MaxLineLength")
     override fun json(): String =
-        """{"type":"FeatureCollection",${bbox.jsonProp()}"features":${features.jsonJoin { it.json() }}}"""
+        """{"type":"FeatureCollection",${bbox.jsonProp()}"features":${features.jsonJoin { it.json() }}${foreignMembersJsonProps()}}"""
 
     operator fun component1(): List<Feature> = features
     operator fun component2(): BoundingBox? = bbox
+    operator fun component3(): Map<String, JsonElement> = foreignMembers
 
     companion object {
+
         @JvmStatic
         public fun fromJson(json: String): FeatureCollection =
             fromJson(Json.decodeFromString(JsonObject.serializer(), json))
@@ -75,8 +88,9 @@ class FeatureCollection(
 
             val bbox = json["bbox"]?.jsonArray?.toBbox()
             val features = json.getValue("features").jsonArray.map { Feature.fromJson(it.jsonObject) }
+            val foreignMembers = json.foreignMembers()
 
-            return FeatureCollection(features, bbox)
+            return FeatureCollection(features, bbox, foreignMembers)
         }
     }
 }

geojson/src/commonMain/kotlin/io/github/dellisd/spatialk/geojson/GeoJson.kt

@@ -1,12 +1,15 @@
 package io.github.dellisd.spatialk.geojson
 
+import kotlinx.serialization.json.JsonElement
+
 /**
  * A GeoJSON object represents a [Geometry], [Feature], or [collection of Features][FeatureCollection].
  *
  * @property bbox An optional bounding box used to represent the limits of the object's geometry.
  */
 interface GeoJson {
     val bbox: BoundingBox?
+    val foreignMembers: Map<String, JsonElement>
 
     /**
      * Gets a JSON representation of this object.

geojson/src/commonMain/kotlin/io/github/dellisd/spatialk/geojson/Geometry.kt

@@ -3,13 +3,38 @@ package io.github.dellisd.spatialk.geojson
 import io.github.dellisd.spatialk.geojson.serialization.GeometrySerializer
 import kotlinx.serialization.Serializable
 import kotlinx.serialization.json.Json
+import kotlinx.serialization.json.JsonElement
 import kotlinx.serialization.json.JsonObject
 import kotlinx.serialization.json.jsonPrimitive
 import kotlin.jvm.JvmStatic
 
 @Serializable(with = GeometrySerializer::class)
-sealed class Geometry protected constructor() : GeoJson {
-    abstract override val bbox: BoundingBox?
+sealed class Geometry protected constructor(
+    override val bbox: BoundingBox? = null,
+    override val foreignMembers: Map<String, JsonElement> = emptyMap()
+) : GeoJson {
+
+    protected abstract val coordinatesOrGeometries: Any
+
+    override fun equals(other: Any?): Boolean {
+        if (this === other) return true
+        if (other == null || this::class != other::class) return false
+
+        other as Geometry
+
+        if (coordinatesOrGeometries != other.coordinatesOrGeometries) return false
+        if (bbox != other.bbox) return false
+        if (foreignMembers != other.foreignMembers) return false
+
+        return true
+    }
+
+    override fun hashCode(): Int {
+        var result = coordinatesOrGeometries.hashCode()
+        result = 31 * result + (bbox?.hashCode() ?: 0)
+        result = 31 * result + foreignMembers.hashCode()
+        return result
+    }
 
     override fun toString(): String = json()
 

geojson/src/commonMain/kotlin/io/github/dellisd/spatialk/geojson/GeometryCollection.kt

@@ -1,11 +1,14 @@
 package io.github.dellisd.spatialk.geojson
 
 import io.github.dellisd.spatialk.geojson.serialization.GeometrySerializer
+import io.github.dellisd.spatialk.geojson.serialization.foreignMembers
+import io.github.dellisd.spatialk.geojson.serialization.foreignMembersJsonProps
 import io.github.dellisd.spatialk.geojson.serialization.jsonJoin
 import io.github.dellisd.spatialk.geojson.serialization.jsonProp
 import io.github.dellisd.spatialk.geojson.serialization.toBbox
 import kotlinx.serialization.Serializable
 import kotlinx.serialization.json.Json
+import kotlinx.serialization.json.JsonElement
 import kotlinx.serialization.json.JsonObject
 import kotlinx.serialization.json.jsonArray
 import kotlinx.serialization.json.jsonObject
@@ -17,31 +20,21 @@ import kotlin.jvm.JvmStatic
 @Serializable(with = GeometrySerializer::class)
 class GeometryCollection @JvmOverloads constructor(
     val geometries: List<Geometry>,
-    override val bbox: BoundingBox? = null
-) : Geometry(), Collection<Geometry> by geometries {
-    @JvmOverloads
-    constructor(vararg geometries: Geometry, bbox: BoundingBox? = null) : this(geometries.toList(), bbox)
-
-    override fun equals(other: Any?): Boolean {
-        if (this === other) return true
-        if (other == null || this::class != other::class) return false
-
-        other as GeometryCollection
-
-        if (geometries != other.geometries) return false
-        if (bbox != other.bbox) return false
+    bbox: BoundingBox? = null,
+    foreignMembers: Map<String, JsonElement> = emptyMap()
+) : Geometry(bbox, foreignMembers), Collection<Geometry> by geometries {
+    override val coordinatesOrGeometries get() = geometries
 
-        return true
-    }
-
-    override fun hashCode(): Int {
-        var result = geometries.hashCode()
-        result = 31 * result + (bbox?.hashCode() ?: 0)
-        return result
-    }
+    @JvmOverloads
+    constructor(
+        vararg geometries: Geometry,
+        bbox: BoundingBox? = null,
+        foreignMembers: Map<String, JsonElement> = emptyMap()
+    ) : this(geometries.toList(), bbox, foreignMembers)
 
+    @Suppress("MaxLineLength")
     override fun json(): String =
-        """{"type":"GeometryCollection",${bbox.jsonProp()}"geometries":${geometries.jsonJoin { it.json() }}}"""
+        """{"type":"GeometryCollection",${bbox.jsonProp()}"geometries":${geometries.jsonJoin { it.json() }}${foreignMembersJsonProps()}}"""
 
     companion object {
         @JvmStatic
@@ -66,8 +59,9 @@ class GeometryCollection @JvmOverloads constructor(
             }
 
             val bbox = json["bbox"]?.jsonArray?.toBbox()
+            val foreignMembers = json.foreignMembers()
 
-            return GeometryCollection(geometries, bbox)
+            return GeometryCollection(geometries, bbox, foreignMembers)
         }
     }
 }

geojson/src/commonMain/kotlin/io/github/dellisd/spatialk/geojson/LineString.kt

@@ -1,12 +1,15 @@
 package io.github.dellisd.spatialk.geojson
 
 import io.github.dellisd.spatialk.geojson.serialization.GeometrySerializer
+import io.github.dellisd.spatialk.geojson.serialization.foreignMembers
+import io.github.dellisd.spatialk.geojson.serialization.foreignMembersJsonProps
 import io.github.dellisd.spatialk.geojson.serialization.jsonJoin
 import io.github.dellisd.spatialk.geojson.serialization.jsonProp
 import io.github.dellisd.spatialk.geojson.serialization.toBbox
 import io.github.dellisd.spatialk.geojson.serialization.toPosition
 import kotlinx.serialization.Serializable
 import kotlinx.serialization.json.Json
+import kotlinx.serialization.json.JsonElement
 import kotlinx.serialization.json.JsonObject
 import kotlinx.serialization.json.jsonArray
 import kotlinx.serialization.json.jsonPrimitive
@@ -17,41 +20,32 @@ import kotlin.jvm.JvmStatic
 @Serializable(with = GeometrySerializer::class)
 class LineString @JvmOverloads constructor(
     val coordinates: List<Position>,
-    override val bbox: BoundingBox? = null
-) : Geometry() {
+    bbox: BoundingBox? = null,
+    foreignMembers: Map<String, JsonElement> = emptyMap()
+) : Geometry(bbox, foreignMembers) {
+    override val coordinatesOrGeometries get() = coordinates
+
     @JvmOverloads
-    constructor(vararg coordinates: Position, bbox: BoundingBox? = null) : this(coordinates.toList(), bbox)
+    constructor(
+        vararg coordinates: Position,
+        bbox: BoundingBox? = null,
+        foreignMembers: Map<String, JsonElement> = emptyMap()
+    ) : this(coordinates.toList(), bbox, foreignMembers)
 
     @JvmOverloads
     constructor(
         coordinates: Array<DoubleArray>,
-        bbox: BoundingBox? = null
-    ) : this(coordinates.map(::Position), bbox)
+        bbox: BoundingBox? = null,
+        foreignMembers: Map<String, JsonElement> = emptyMap()
+    ) : this(coordinates.map(::Position), bbox, foreignMembers)
 
     init {
         require(coordinates.size >= 2) { "LineString must have at least two positions" }
     }
 
-    override fun equals(other: Any?): Boolean {
-        if (this === other) return true
-        if (other == null || this::class != other::class) return false
-
-        other as LineString
-
-        if (coordinates != other.coordinates) return false
-        if (bbox != other.bbox) return false
-
-        return true
-    }
-
-    override fun hashCode(): Int {
-        var result = coordinates.hashCode()
-        result = 31 * result + (bbox?.hashCode() ?: 0)
-        return result
-    }
-
+    @Suppress("MaxLineLength")
     override fun json(): String =
-        """{"type":"LineString",${bbox.jsonProp()}"coordinates":${coordinates.jsonJoin(transform = Position::json)}}"""
+        """{"type":"LineString",${bbox.jsonProp()}"coordinates":${coordinates.jsonJoin(transform = Position::json)}${foreignMembersJsonProps()}}"""
 
     companion object {
         @JvmStatic
@@ -72,8 +66,9 @@ class LineString @JvmOverloads constructor(
 
             val coords = json.getValue("coordinates").jsonArray.map { it.jsonArray.toPosition() }
             val bbox = json["bbox"]?.jsonArray?.toBbox()
+            val foreignMembers = json.foreignMembers()
 
-            return LineString(coords, bbox)
+            return LineString(coords, bbox, foreignMembers)
         }
     }
 }