UrbvanCenterPinMapView
Examples
Requirements
- iOS 11.0+
- Xcode 11.6
Installation
UrbvanCenterPinMapView is available through CocoaPods. To install it, simply add the following line to your Podfile:
pod 'UrbvanCenterPinMapView'Usage
- Change the class of a view from UIView to UrbvanCenterPinMapView
- Programmatically:
let pinMapView = UrbvanCenterPinMapView(frame: myFrame)
let pinMapView = UrbvanCenterPinMapView(frame: myFrame)
Customization
pinImage
Center Pin's Pin image view's image to assign a custom pin asset
pinMapView.pinImage = UIImage(named: "my-pin-image")shadowImage
Center Pin's Shadow image view's image to assign a custom pin asset
pinMapView.shadowImage = UIImage(named: "my-shadow-image")shadowImageWhenDragged
Alternate shadow image, if specified the center pin's shadow will change to this one while the user us dragging the map
pinMapView.shadowImageWhenDragged = UIImage(named: "my-optional-second-shadow-image")shadowAlpha
Center Pin's Shadow image view alpha value customization
pinMapView.shadowAlpha = 0.8Center Pin and Shadow Offsets
Different offsets if you want to adjust your custom assets for pin and shadow
pinMapView.pinOffsetY = 13
pinMapView.shadowOffsetX = 12
pinMapView.shadowOffsetY = 10isDragging
If you would like to know if map is being moved
Delegate
You can implement UrbvanCenterPinMapView delegate to implement your own didStartDragging and didEndDragging functionality.
pinMapView.delegate = self
extension MyViewController: UrbvanCenterPinMapViewDelegate {
func didStartDragging() {
// My custom actions
}
func didEndDragging() {
// My custom actions
selectedLocation = pinMapView.mapview.centerCoordinate
}
}
You can also set your own MKMapView delegate while keeping UrbvanCenterPinMapView core functionality by using updateDragging() un MKMapViewDelegate
pinMapView.mapview.delegate = self
extension MyViewController: MKMapViewDelegate {
func mapView(_ mapView: MKMapView, viewFor annotation: MKAnnotation) -> MKAnnotationView? {
// My custom implementation
}
func mapView(_ mapView: MKMapView, rendererFor overlay: MKOverlay) -> MKOverlayRenderer {
// My custom implementation
}
func mapView(_ mapView: MKMapView, regionWillChangeAnimated animated: Bool) {
// My custom implementation
pinMapView.updateDragging() // Place this code to keep UrbvanCenterPinMapView delegate functionality
}
func mapView(_ mapView: MKMapView, regionDidChangeAnimated animated: Bool) {
// My custom implementation
pinMapView.updateDragging() // Place this code to keep UrbvanCenterPinMapView delegate functionality
}
}
Animate Pin
If you would like to animate your pin while its being dragged you shloud use UIImageView animation. example:
pinMapView.delegate = self
let pinImages = (1...36).map { UIImage(named: "pin-\($0)")! }
pinMapView.pin.pin.animationImages = pinImages
pinMapView.pin.pin.animationDuration = 0.8
pinMapView.delegate = self
extension MyViewController: UrbvanCenterPinMapViewDelegate {
func didStartDragging() {
// My custom actions
pinMapView.pin.pin.startAnimating()
}
func didEndDragging() {
// My custom actions
pinMapView.pin.pin.stopAnimating()
}
}
Centering Map
You can center UrbvanCenterPinMapView on your current location by using:
pinMapView.pinMapView.centerOnUserLocation()Or you cans set a custom coordinate where you want to center your map:
pinMapView.pinMapView.center(on coordinate: myCoordinate)On both methods you can set a custom span for how much map you wish to show:
let mySpan = MKCoordinateSpan(latitudeDelta: 0.01, longitudeDelta: 0.01)
pinMapView.pinMapView.center(on coordinate: myCoordinate, span: mySpan)Supports Setting Map Insets
If you update your map insets at run time you should call:
pinMapView.pinMapView.updateFrames(animated: true)to set a new center for the pin in a smooth transition.
Author
Daniel Esteban Salinas Suárez @Urbvan, danielesalinas23@gmail.com
License
UrbvanCenterPinMapView is available under the MIT license. See the LICENSE file for more info.
