srgray / geoswiftmapboxgl Goto Github PK

GEOSwiftMapboxGL makes it easy generate annotations to display on MapboxGL. On each Geometry instance you can call one of the related convenience func mapboxShape(), that will return an annotation object ready to be added as annotations to a MGLMapView:

• A pure-Swift, type-safe, optional-aware programming interface
• Automatically-typed geometry deserialization from WKT and WKB representations
• MapboxGL integration
• Quicklook integration
• A lightweight GEOJSON parser
• Extensively tested

• iOS 8.0+ / Mac OS X 10.10+
• Xcode 8
• Swift 3
• CocoaPods 1.2.1+

import GEOSwift
import Mapbox
import GEOSwiftMapboxGL

...

let point = Waypoint(WKT: "POINT(10 45)")!
let polygon = Geometry.create("POLYGON((35 10, 45 45.5, 15 40, 10 20, 35 10),(20 30, 35 35, 30 20, 20 30))")!

let annotations = [
    point.mapboxShape(),
    polygon.mapboxShape()
]
self.mapView.showAnnotations(annotations, animated: true)

...

Example:

let point = Waypoint(WKT: "POINT(10 45)")
let shape1 = point.mapboxShape() // will return a MGLPointAnnotation

let polygon = Geometry.create("POLYGON((35 10, 45 45.5, 15 40, 10 20, 35 10),(20 30, 35 35, 30 20, 20 30))")
let shape2 = polygon.mapboxShape() // Will return a MGLPolygon

In this table you can find which annotation class you should expect when calling mapboxShape() on a geometry:

TODO

Embedded frameworks require a minimum deployment target of iOS 8 or OS X Mavericks. GEOS is a configure/install project licensed under LGPL 2.1: it is difficult to build for iOS and its compatibility with static linking is at least controversial. Use of GEOSwiftMapboxGL without CocoaPods and with a project targeting iOS 7, even if possible, is advised against.

CocoaPods is a dependency manager for Cocoa projects. To install GEOSwiftMapboxGL with CocoaPods:

• Make sure CocoaPods is installed (GEOSwiftMapboxGL requires version 1.2.1 or greater).

• Update your Podfile to include the following:

use_frameworks!
pod 'GEOSwiftMapboxGL'

• Run pod install.

NOTE: running pod install may cause some errors if your machine does not have autoconf, automake and glibtool, if you encounter those errors you can run brew install autoconf automake libtool to install those packages and run again pod install.

Andrea Cremaschi (@andreacremaschi)

• GEOSwiftMapboxGL was released by Andrea Cremaschi (@andreacremaschi) under a MIT license. See LICENSE for more information.
• GEOSwift was released by Andrea Cremaschi (@andreacremaschi) under a MIT license. See LICENSE for more information.
• GEOS stands for Geometry Engine - Open Source, and is a C++ library, ported from the Java Topology Suite. GEOS implements the OpenGIS Simple Features for SQL spatial predicate functions and spatial operators. GEOS, now an OSGeo project, was initially developed and maintained by Refractions Research of Victoria, Canada.