This implementation of GeoJSON conforms to rfc7946 and is designed for usage with Codable objects.
This library includes both a dynamic and static variant of the GeoJSON models. The static variant is useful when handling pre-defined GeoJSON responses.
- iOS 12.0+ / macOS 10.13+ / tvOS 12.0+ / watchOS 4.0+
- Xcode 15+
- Swift 5.8+
The static models are recommended for when your project is set up to load data for which you know what structure to expect.
For example, if you know that you're loading a list of locations inside a "FeatureCollection" like this:
{
"features": [
{
"geometry": {
"coordinates": [
-0.452207,
51.471403
],
"type": "Point"
},
"properties": {
"address": "Longford, Hounslow TW6 1DB, UK",
"name": "Heathrow Airport"
},
"type": "Feature"
}
],
"type": "FeatureCollection"
}You can define the model using a struct and a typealias.
struct LocationProperties: Codable {
let address: String
let name: String
}
typealias LocationFeatureCollection = GeoJSONFeatureCollection<PointGeometry, LocationProperties>The benefit here is that you can access the specific geometry and all the properties directly, without having to perform any introspection. E.g.
let locationFeatures = try JSONDecoder().decode(LocationFeatureCollection.self, from: data)
let firstFeature = locationFeatures.features.first
firstFeature?.geometry.longitude // -0.452207
firstFeature?.properties?.name // "Heathrow Airport"A geometry collection is, by definition, not statically typed, as it can contain a mixed array of different GeoJSON geometry types. Therefore you will need to check each array by hand. (If somebody has a way of simplifying this, feel free to post a PR 😉)
let geometryColection = try JSONDecoder().decode(GeometryCollection.self, from: data)
if geometryColection.geometries.count > 0,
case GeoJSON.Geometry.point(let pointCoordinates) = geometryColection.geometries[0] {
let point = PointGeometry(coordinates: pointCoordinates)
} else {
// Failed to get expected geometry
}If you don't want or need any of the properties of the feature, you can define an empty struct and set it as the Properties template parameter.
struct EmptyProperties: Codable {}
typealias PointFeature = GeoJSONFeature<PointGeometry, EmptyProperties>This will result in the "Feature" objects containing only a point coordinate.
The dynamic models should only be used when the expected structure is undefined or may change.
First, let's assume that you have a GeoJSON data object. The first step is to decode it.
do {
switch try JSONDecoder().decode(GeoJSON.self, from: data) {
case .feature(let feature, _):
handleGeometry(feature.geometry)
case .featureCollection(let featureCollection, _):
for feature in featureCollection.features {
handleGeometry(feature.geometry)
}
case .geometry(let geometry, _):
handleGeometry(geometry)
}
} catch {
// Handle decoding error
}Then you can explore the different geometries provided.
func handleGeometry(_ geometry: GeoJSONGeometry?) {
guard let geometry = geometry else { return }
switch geometry {
case .point(let coordinates):
break
case .multiPoint(let coordinates):
break
case .lineString(let coordinates):
break
case .multiLineString(let coordinates):
break
case .polygon(let coordinates):
break
case .multiPolygon(let coordinates):
break
case .geometryCollection(let geometries):
for geometry in geometries {
handleGeometry(geometry)
}
}
}If you know the geometry type that you're looking for, you can try and get it directly.
func handleGeometry(_ geometry: GeoJSONGeometry?) {
guard case GeoJSONGeometry.polygon(let coordinates)? = geometry else { return }
displayPolygon(linearRings: coordinates)
}CocoaPods
To integrate CodableGeoJSON into your Xcode project using CocoaPods, specify it in your Podfile:
pod 'CodableGeoJSON'Swift Package Manager
You can use The Swift Package Manager to install CodableGeoJSON by adding the proper description to your Package.swift file:
import PackageDescription
let package = Package(
name: "YOUR_PROJECT_NAME",
targets: [],
dependencies: [
.package(url: "https://github.com/guykogus/CodableGeoJSON.git", from: "1.2.0")
]
)
Next, add CodableGeoJSON to your targets dependencies like so:
.target(
name: "YOUR_TARGET_NAME",
dependencies: [
"CodableGeoJSON",
]
),Then run swift package update.
CodableGeoJSON is available under the MIT license. See the LICENSE file for more info.