This repository contains the Swift packages for the Places SDK for iOS and Places Swift SDK for iOS (Preview). For additional methods of installing the Places and Places Swift SDKs for iOS (Preview) including CocoaPods, see the Places SDK for iOS documentation.
As of November 11, 2024 this GitHub repository now contains the latest versions
of both GooglePlaces and GooglePlacesSwift Swift Packages. Visit
the developer documentation
to learn more about the Places Swift SDK for iOS (Preview).
[!TIP] The version of the GitHub release matches the version of
GooglePlaces, but not the version ofGooglePlacesSwift(Preview). We take care of the version dependency between GooglePlaces and GooglePlacesSwift in the package manifest. For example: To use version 9.2.0 of GooglePlaces, select 9.2.0 on the Xcode package dependency screen. To use version 0.3.0 of GooglePlacesSwift, you must choose the corresponding version of the GooglePlaces, which is 9.2.0.
If you have been using GooglePlaces through this GitHub repository and now would
like to also try GooglePlacesSwift,
delete that package dependency in Xcode,
then follow the installation instructions to add the package
dependency again from https://github.com/googlemaps/ios-places-sdk, choosing
version 9.2.0 or later.
This time, on the Choose Package Products window, add the
GooglePlacesSwift library to your project's target.
If you have been using GooglePlacesSwift through a different GitHub
repository,
delete that package dependency in Xcode,
then follow the installation instructions to add the package
dependency from https://github.com/googlemaps/ios-places-sdk, choosing version
9.2.0 or later.
This time, on the Choose Package Products window, add the
GooglePlacesSwift library to your project's target.
- Xcode version 15.0 or later
- An app targeting iOS 15 or later
- A Google Maps Platform project with the Places API enabled.
- An API key associated with the project above.
-
Follow the instructions for adding package dependencies to your app in Xcode.
-
In the "Enter Package URL" field, enter this GitHub repository:
https://github.com/googlemaps/ios-places-sdk -
Select the version of the Places SDK for iOS that you want to use. For new projects, we recommend specifying the latest version and using the "Exact Version" option.
-
Follow the instructions to add your API key to your app.
See samples demonstrating use of the Places SDK for iOS on developers.google.com or on GitHub.
See samples demonstrating use of the Places Swift SDK for iOS on GitHub.
Documentation for the Places SDK for iOS is available as guides and reference documentation.
External contributions are not accepted for this repository, per the Contributing guide.
This package uses Google Maps Platform services, and any use of Google Maps Platform is subject to the Terms of Service.
This repository is offered via an open source license. It is not governed by the Google Maps Platform Support Technical Support Services Guidelines, the SLA, or the Deprecation Policy (however, any Google Maps Platform services used by the library remain subject to the Google Maps Platform Terms of Service).
This repository adheres to semantic versioning to indicate when backwards-incompatible changes are introduced.
- For issues with the Places SDK for iOS, file an issue on the Places SDK for iOS issue tracker or open a support case.
- If you find a bug with the Swift package, please file an issue on GitHub.
If you would like to get answers to technical questions from other Google Maps Platform developers, ask through one of our developer community channels. You can also discuss this library on the Google Maps Platform Discord server.
