Changes since v2.0.0-rc.1:

Packaging

• ⚠️ Turf requires Xcode 12.0 or above to build from source. (#152)

Geometry

• ⚠️ Replaced the GeoJSON class and GeoJSON protocol with a unified GeoJSONObject enumeration. Use JSONDecoder instead of the GeoJSON.parse(_:) or GeoJSON.parse<T: GeoJSONObject>(_:from:) method. (#154)

  v2.0.0-rc.1	if let feature = try GeoJSON.parse(data)?.decodedFeature, case let .lineString(lineString) = feature.geometry { … }
  v2.0.0-rc.2	if case let .feature(feature) = try JSONDecoder().decode(GeoJSONObject.self, from: data), case let .lineString(lineString) = feature.geometry { … }

• ⚠️ Removed the FeatureCollection.identifier and FeatureCollection.properties properties with no replacement. These properties had been represented in GeoJSON by foreign members, which are not yet implemented. If you had been relying on the identifier or properties foreign members of FeatureCollection objects, move the data to each individual feature in the collection. (#154)

  v2.0.0-rc.1	let uuid = UUID().description featureCollection.identifier = .string(uuid)
  v2.0.0-rc.2	let uuid = UUID().description for feature in featureCollection.features { $0.identifier = .string(uuid) }

• ⚠️ The Feature.properties property is now a JSONObject? (in other words, [String: JSONValue?]?). JSONObject is type-checked at compile time instead of runtime, but you can initialize it using a literal or full-width conversion from Any?. Code that builds a JSON object using literals will have to be modified to either specify a JSONValue case for each value or call the JSONObject(rawValue:) initializer. (#154)

  v2.0.0-rc.1	feature.properties = [ "name": "Wapakoneta", "population": 9_957, "favorite": isFavorite, ] let isBigCity = (feature.properties?["population"] as? Double).flatMap { $0 > 10_000 }
  v2.0.0-rc.2	feature.properties = [ "name": "Wapakoneta", "population": 9_957, "favorite": .boolean(isFavorite), ] var isBigCity: Bool? if case let .number(population) = feature.properties?["population"] { isBigCity = population > 10_000 }

• ⚠️ The Feature.geometry property is now optional. (#154)

• ⚠️ Removed the Geometry.type property. Use pattern matching (case let) instead. (#154)

  v2.0.0-rc.1	if geometry.type == .Point { … }
  v2.0.0-rc.2	if case .point = geometry { … }

• ⚠️ Removed the Geometry.value property. This type erasure is unnecessary and can potentially become a source of bugs. Use pattern matching instead. (#154)

  v2.0.0-rc.1	if let point = geometry.value as? Point { … }
  v2.0.0-rc.2	if case let .point(point) = geometry { … }

• ⚠️ Removed the Number enumeration in favor of a Double-typed FeatureIdentifier.number(_:) case. JSON doesn’t distinguish between integers and double-precision floating point numbers. Any distinction in the type system or encoded JSON is purely cosmetic. (#154)

  v2.0.0-rc.1	let randomNumber = Int.random(in: 0...255) feature.identifier = .number(.int(randomNumber)) if let number = feature.identifier?.value as? Int { print("You rolled a \(number)!") }
  v2.0.0-rc.2	let randomNumber = Int.random(in: 0...255) feature.identifier = .number(Double(randomNumber)) if let .number(number) = feature.identifier { print("You rolled a \(Int(number))!") }

• Feature and FeatureCollection now conform to the Equatable protocol. (#154)

• Each geometric type, such as Point, now conforms to the Codable and Equatable protocols. (#154)

• BoundingBox now conforms to the Hashable protocol. (#154)

Trigonometry

• Fixed an issue where the LineString.simplify(tolerance:highestQuality:) method returned a highest-quality result even if the highestQuality parameter was set to false. (#152)
• Fixed an issue where the Polygon.simplify(tolerance:highestQuality:) method incorrectly applied the tolerance. (#152)
• Fixed an issue where the Polygon.simplify(tolerance:highestQuality:) method failed to simplify the polygon at all if any of the linear rings was a triangle. (#152)