googlemaps / google-maps-ios-utils

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][sdk].
- **Geometry libraries** - [KML and GeoJSON rendering][geometry-rendering]
- **Geometry utilities** - Handy spherical [geometry utility][geometry-utils] functions
- **Heatmaps** - [Heatmap rendering][heatmap-rendering]
- **Marker clustering** — handles the display of a large number of points
- **Marker customization** - [display custom markers][customizing-markers]
- **Quadtree data structure** - indexes 2D geometry points and performs
2D range queries
## Requirements
- iOS 16.0+
- Xcode 15.0+
- [Maps SDK for iOS][sdk] (see Releases for minimum compatible version)
- A Google Maps Platform API key from a project with the **Maps SDK for iOS** enabled.
## Installation
1. Include the `GoogleMaps` dependency using one of the available installation options (Swift Package Manager, CocoaPods, or manual).
1. Add this utility library using one of the options below:
### Swift Package Manager
1. Follow the instructions for
 adding package dependencies to your app in Xcode.
2. In the "Enter Package URL" field, enter this GitHub repository:
 [code] 
> [!IMPORTANT]
> You also need to install the Maps SDK for iOS, which is also supported in Swift Package Manager at the URL `https://github.com/googlemaps/ios-maps-sdk`
3. Select the
 version
 of the Maps SDK for iOS Utility Library that you want to use. For new projects, we recommend specifying the latest version and using the "Up to next Major" option. See Release Notes for this library and the Maps SDK for iOS to select the correct version for you.
 - (Recommended) Version 6.x supports the Maps SDK for iOS v9.x
 - Version 5.0 supports the Maps SDK for iOS v8.x
 - Version 4.2.2 supports the Maps SDK for iOS v7.x
4. Follow the
 instructions to add your API key to your app.
5. See the Importing section for import statements specific to SPM installation.
### CocoaPods
1. In your `Podfile`:
 [code] 
 (You can omit the comment "x-release-please-start-version" which is used for release automation.)
 Replace `TARGET_NAME` and save the `Podfile`.
2. At the command line in directory containing your `Podfile`, run:
 [code] 
3. Open the `.xcworkspace` file that is created.
4. Follow the
 instructions to add your API key to your app.
5. See the Importing section for import statements specific to CocoaPods installation.
### Carthage
 Only supported if using Maps SDK v7.1.2 or earlier 
In your `Cartfile`:
 [code] 
See the [Carthage doc] for further installation instructions.
## Sample App
See the README for the Swift and Objective-C samples apps in /samples.
## Documentation
Read documentation about this utility library on [developers.google.com][devsite-guide] or within the /docs directory.
## Usage
### Importing
You may also need to `import GoogleMaps`.
Swift:
 [code] 
Objective-C:
 [code] 
### Cluste