Contents

googlemaps/ios-places-sdk

This repository contains the Swift packages for the

Description

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.

Addition of GooglePlacesSwift to this repository

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 of GooglePlacesSwift (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.

Migration from GooglePlaces to GooglePlacesSwift (Preview)

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.

Migration from GooglePlacesSwift (Preview) v0.2.0 and earlier

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.

Note: If you try to add GooglePlacesSwift from a deprecated repository, you will see the following error message: Failed to resolve dependencies Dependencies could not be resolved because no versions of 'ios-places-swift-sdk' match the requirement 0.2.0 and root depends on 'ios-places-swift-sdk' 0.2.0.

Requirements

  • Xcode version 16.0 or later
  • An app targeting iOS 16 or later
  • A Google Maps Platform

project with the Places API enabled.

  • An

API key associated with the project above.

Installation

  1. Follow the instructions for

adding package dependencies to your app in Xcode.

  1. In the "Enter Package URL" field, enter this GitHub repository:

`` https://github.com/googlemaps/ios-places-sdk ``

  1. 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.

  1. Follow the

instructions to add your API key to your app.

Sample 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

Documentation for the Places SDK for iOS is available as guides and reference documentation.

Contributing

External contributions are not accepted for this repository, per the Contributing guide.

Terms of Service

This package uses Google Maps Platform services, and any use of Google Maps Platform is subject to the Terms of Service.

Support

For issues with the Places SDK for iOS, the primary support channel is to open a support case with the Google Maps Platform support team. Alternatively, you can file an issue on the Places SDK for iOS issue tracker.

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 on the Google Maps Platform Discord server.

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).

Versioning

This repository adheres to semantic versioning to indicate when backwards-incompatible changes are introduced. Accordingly, while the library is in version 0.x, backwards-incompatible changes may be introduced at any time.

Package Metadata

Repository: googlemaps/ios-places-sdk

Default branch: main

README: README.md