Swiftpack.co - Package - googlemaps/google-maps-ios-utils

Run unit tests pod Carthage compatible GitHub contributors Apache-2.0

Google Maps SDK for iOS Utility Library


This open-source library contains classes that are useful for a wide range of applications using the Google Maps SDK for iOS.


  • iOS 9.0+
  • CocoaPods



In your Podfile:


target 'TARGET_NAME' do
    pod 'Google-Maps-iOS-Utils', '~> 3.4.2'

Replace TARGET_NAME and then, in the Podfile directory, type:

$ pod install


In your Cartfile:

github "googlemaps/google-maps-ios-utils" ~> 3.4.2

See the Carthage doc for further installation instructions.

Swift Package Manager

Note: This feature is only available with Swift 5.3 (Xcode 12) or later.

Add the following to your dependencies value of your Package.swift file.

dependencies: [
    url: "https://github.com/googlemaps/google-maps-ios-utils.git",
    .upToNextMinor(from: "3.4.2")

Samples and Example Usage

e.g. Displaying KML data

import GoogleMapsUtils

func renderKml() {
    // Parse KML
    let path: String = // Path to your KML file...
    let kmlUrl = URL(fileURLWithPath: path)
    let kmlParser = GMUKmlParser(url: kmlUrl)

    // Render parsed KML
    let renderer = GMUGeometryRenderer(
        map: mapView,
        geometries: kmlParser.placemarks,
        styles: kmlParser.styles,
        styleMaps: kmlParser.styleMaps

You can see more example usages in our sample projects.


Encounter an issue while using this library?

If you find a bug or have a feature request, please file an issue. Or, if you'd like to contribute, please refer to our contributing guide and our code of conduct.

You can also reach us on our Discord channel.

For more information, check out the detailed guide on the Google Developers site.


Stars: 536


Used By

Total: 0


v3.4.2 -

3.4.2 (2020-11-24)

Bug Fixes

  • nil userData on marker when clustering/declustering. (#350) (1a5863e)
  • Run .releaserc on main (26e9455)

v3.4.1 -

3.4.1 (2020-10-19)

Bug Fixes

v3.4.0 -

3.4.0 (2020-10-13)


v3.3.1 -

3.3.1 (2020-09-25)

Bug Fixes

  • Clustering: Disappearing marker when zooming in. (#337) (29f43ba)

v3.3.0 -

3.3.0 (2020-08-28)


  • added heat map interpolation and unit tests (#328) (4aa7c02)

v3.2.1 -

v3.2.0 -

3.2.0 (2020-07-30)

Bug Fixes

  • Missing quote (3b1f2fa)
  • zip .xcframework. (e087037)
  • build: Run carthage update on release. (f826452)
  • build: Use sudo for xcode-select (02239da)


v3.1.4 -

3.1.4 (2020-05-13)

Bug Fixes

  • Make title and snippet mutable for GMUClusterItem. (#302) (7a820a1), closes #300

v3.1.3 -

3.1.3 (2020-05-13)

Bug Fixes

v3.1.2 -

3.1.2 (2020-05-12)

Bug Fixes

  • Publish: Update pbxproj file reference. (ff4ad3d)
  • Fixes broken info windows in clustered markers, and adds support to cluster GMSMarker (#299) (c0789a7)

v3.1.1 -

3.1.1 (2020-04-09)

Bug Fixes

v3.1.0 -


  • Allowing cluster distance customization for GMUNonHierarchicalDistanceBasedAlgorithm (#291)

Bug Fixes

v3.0.2 -


  • Remove version from podspec dependency. (#277) (9798ff2)

v3.0.1 -


  • Expose markers in GMUDefaultClusterRenderer. (#271) (e9dac24)

Bug Fixes

  • Fix broken Swift sample. (b05b1f4)

v3.0.0 -


  • update GMUFeature interface to conform to spec #rfc7946 (4a562be), closes #229

Bug Fixes


  • Make heat-map zoom intensities customizable (#186)
  • Adds support for StyleMap (#202)
  • cluster: expose private cluster configuration to public API, resolve Xcode 10 warnings (#220)
  • cluster: expose cluster-config properties (4c50c88)
  • Update Swift demo to use Swift 4.2 (#256) (2f4fd4a)

2.1.0 - Heatmap Rendering -


  • Added Heatmaps rendering.
  • Added a constructor for setting custom background colors of cluster icons.

Resolved Issues:

  • Forwarded mapView:didTapPOIWithPlaceID:name:location to underlying mapDelegate.
  • Fixed a minor Swift compatibility issue.

2.0.0 - KML and GeoJSON rendering -


  • KML and GeoJSON rendering.
  • Changed GMUClusterManagerDelegate's methods to return a BOOL to indicate whether the event should pass through to other handlers. This will give applications the ability to allow the default info window to be shown when tapping on a marker. Please note this is a breaking change so existing code needs to be updated.

1.1.2 - Fixed include paths to work with cocoapods -

1.1.1 - Added missing CHANGELOG -

Missing CHANGELOG for the 1.1.0 release with easy marker customization feature.

1.1.0 - Marker customization -

Added features for easy customization of markers. For more details see https://github.com/googlemaps/google-maps-ios-utils/blob/master/CustomMarkers.md

1.0.1 - Workaround cocoapods issue with GoogleMaps 2.0.0 -

1.0.0 - Initial release -