Places Swift SDK for iOS Sample App

The GooglePlacesDemos folder contains a comprehensive demo application showcasing various features of the Places Swift SDK for iOS. Built with SwiftUI, it demonstrates modern iOS development practices while implementing key Places SDK functionality.

The demo app includes several sample implementations:

• Address Autocomplete Form with integrated map view
• Place Details Card showing business information, hours, and ratings
• Places Search with text and nearby location options
• Place Photos integration and management
• Places Autocomplete with custom SwiftUI interface
• Interactive map integration using Google Maps SDK

• Xcode 16.2 or later with iOS SDK 17.0 or later
• iOS Simulator or device running iOS 17+
• An API key from Google Cloud with the Places API (New) enabled
• Swift and SwiftUI knowledge

This repository contains six sample apps. All manage the Places API key the same way — you create a git-ignored Secrets.xcconfig next to that app's Info.plist; only the folder changes. Each app has a checked-in <AppName>.xcconfig that includes your Secrets.xcconfig (#include? "Secrets.xcconfig"); if the key is missing the app still builds but fails at launch with a message naming the file to create.

The two Archive/GooglePlaces-Objc apps are older Objective-C samples kept for reference.

1. Set up a Google Cloud project and enable the Places API (New).

2. Clone this repository

   git clone git@github.com:googlemaps-samples/ios-places-sdk-samples.git
   

3. For the CocoaPods samples, install the pods first (this also generates the .xcworkspace you open):

   cd ios-places-sdk-samples/GooglePlaces-Swift && pod install          # GooglePlacesSwiftDemos, GooglePlacesSwiftXCFrameworkDemos
   cd ios-places-sdk-samples/Archive/GooglePlaces-Objc && pod install   # the two archived Obj-C apps
   

4. Open the app you want to run in Xcode (see the "Open" column above).

5. Create a Secrets.xcconfig file next to that app's Info.plist (see the last column above). It is git-ignored, so your key is never checked into source control.

6. Add a single line to Secrets.xcconfig, substituting your key from Step 1:

   PLACES_API_KEY = YOUR_PLACES_API_KEY
   

   (See https://help.apple.com/xcode/#/dev745c5c974 for more information about xcconfig files.)

• Built with SwiftUI and MVVM design pattern
• Uses ObservableObject view models for state management
• Modular components for reusability

• PlaceDetailsManager - Handles place details data fetching and state
• PlaceDetailsCard - A reusable SwiftUI view component that displays formatted Place information including:
  • Business name and rating
  • Opening hours and current status
  • Price level and business type
  • Rating stars visualization
  • Support for editorial summary

• Places Swift SDK Overview
• Places Swift SDK Reference
• Migration Guide

Please see CONTRIBUTING.md.

This repository uses Google Maps Platform services. Use of Google Maps Platform services through this library is subject to the Google Maps Platform Terms of Service.

European Economic Area (EEA) developers

If your billing address is in the European Economic Area, effective on 8 July 2025, the Google Maps Platform EEA Terms of Service will apply to your use of the Services. Functionality varies by region. Learn more.

This repository is not a Google Maps Platform Core Service. Therefore, the Google Maps Platform Terms of Service (e.g. Technical Support Services, Service Level Agreements, and Deprecation Policy) do not apply to the code in this repository.

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

If you find a bug, or have a feature request, 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. If you'd like to contribute, please check the Contributing guide.

You can also discuss this library on our Discord server.