/google-maps-ios-utils

Google Maps SDK for iOS Utility Library

Primary LanguageObjective-CApache License 2.0Apache-2.0

Run unit tests pod Carthage compatible GitHub contributors Apache-2.0

Google Maps SDK for iOS Utility Library

Description

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

Requirements

  • iOS 10.0+

Installation

In your Podfile:

use_frameworks!

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

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

$ pod install

In your Cartfile:

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

See the Carthage doc for further installation instructions.

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: [
  .package(
    url: "https://github.com/googlemaps/google-maps-ios-utils.git",
    .upToNextMinor(from: "3.9.0")
  )
]

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)
    kmlParser.parse()

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

You can see more example usages in our sample projects.

Support

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.