GooglePlacesSwift Framework Reference
Stay organized with collections
Save and categorize content based on your preferences.
Protocols
The following protocols are available globally.
-
A protocol for fetching the App Check token.
Declaration
Swift
protocol AppCheckTokenProvider : Sendable
-
Specifies coordinate region information.
Declaration
Swift
protocol CoordinateRegion : Hashable
-
Specifies that the coordinate region can be used as a search bias.
Warning
This should not be conformed to by types outside of GooglePlacesSwift. Doing so may
result in a fatal error.
-
Specifies that the coordinate region can be used as a search restriction.
Warning
This should not be conformed to by types outside of GooglePlacesSwift. Doing so may
result in a fatal error.
-
Declaration
Swift
protocol PlaceProtocol : CustomStringConvertible, Hashable, Sendable
-
Main interface to the Places SDK, used for searching and getting details about places.
This type should be accessed through PlacesClient.shared
.
PlacesClient methods should only be called from the main thread. Calling these methods from
another thread will result in an exception or undefined behavior. Unless otherwise specified,
all callbacks will be invoked on the main thread.
Declaration
Swift
protocol PlacesClientProtocol : AnyObject, Sendable
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2025-08-27 UTC.
[null,null,["Last updated 2025-08-27 UTC."],[[["\u003cp\u003eThis documentation details globally available protocols within the Places SDK for iOS.\u003c/p\u003e\n"],["\u003cp\u003eThese protocols provide functionality for tasks such as fetching App Check tokens, defining coordinate regions, and interacting with the Places SDK.\u003c/p\u003e\n"],["\u003cp\u003eSome protocols, like \u003ccode\u003eCoordinateRegionBias\u003c/code\u003e and \u003ccode\u003eCoordinateRegionRestriction\u003c/code\u003e, should not be conformed to by external types to avoid errors.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003ePlacesClientProtocol\u003c/code\u003e is the primary interface for using the Places SDK, offering methods for searching and retrieving place details.\u003c/p\u003e\n"],["\u003cp\u003eAll interactions with the Places SDK, including calls to \u003ccode\u003ePlacesClient\u003c/code\u003e methods, should occur on the main thread for stability and predictable behavior.\u003c/p\u003e\n"]]],["The core content details several Swift protocols available globally: `AppCheckTokenProvider` for fetching App Check tokens, `CoordinateRegion` for specifying coordinate region information, and `CoordinateRegionBias` and `CoordinateRegionRestriction` for defining search biases and restrictions. `PlaceProtocol` is available and the `PlacesClientProtocol` serves as the main interface for searching and retrieving place details, accessible via `PlacesClient.shared` and it must be used only from the main thread.\n"],null,["# GooglePlacesSwift Framework Reference\n\nProtocols\n=========\n\nThe following protocols are available globally.\n- `\n ``\n ``\n `\n\n ### [AppCheckTokenProvider](/maps/documentation/places/ios-sdk/reference/swift/Protocols/AppCheckTokenProvider)\n\n `\n ` \n A protocol for fetching the App Check token. \n\n #### Declaration\n\n Swift \n\n protocol AppCheckTokenProvider : Sendable\n\n- `\n ``\n ``\n `\n\n ### [CoordinateRegion](#/s:17GooglePlacesSwift16CoordinateRegionP)\n\n `\n ` \n Specifies coordinate region information. \n\n #### Declaration\n\n Swift \n\n protocol CoordinateRegion : Hashable\n\n- `\n ``\n ``\n `\n\n ### [CoordinateRegionBias](/maps/documentation/places/ios-sdk/reference/swift/Protocols/CoordinateRegionBias)\n\n `\n ` \n Specifies that the coordinate region can be used as a search bias. \n Warning\n This should not be conformed to by types outside of GooglePlacesSwift. Doing so may result in a fatal error. \n\n #### Declaration\n\n Swift \n\n protocol CoordinateRegionBias : /maps/documentation/places/ios-sdk/reference/swift/Protocols#/s:17GooglePlacesSwift16CoordinateRegionP\n\n- `\n ``\n ``\n `\n\n ### [CoordinateRegionRestriction](/maps/documentation/places/ios-sdk/reference/swift/Protocols/CoordinateRegionRestriction)\n\n `\n ` \n Specifies that the coordinate region can be used as a search restriction. \n Warning\n This should not be conformed to by types outside of GooglePlacesSwift. Doing so may result in a fatal error. \n\n #### Declaration\n\n Swift \n\n protocol CoordinateRegionRestriction : /maps/documentation/places/ios-sdk/reference/swift/Protocols#/s:17GooglePlacesSwift16CoordinateRegionP\n\n- `\n ``\n ``\n `\n\n ### [PlaceProtocol](/maps/documentation/places/ios-sdk/reference/swift/Protocols/PlaceProtocol)\n\n `\n ` \n\n #### Declaration\n\n Swift \n\n protocol PlaceProtocol : CustomStringConvertible, Hashable, Sendable\n\n- `\n ``\n ``\n `\n\n ### [PlacesClientProtocol](/maps/documentation/places/ios-sdk/reference/swift/Protocols/PlacesClientProtocol)\n\n `\n ` \n Main interface to the Places SDK, used for searching and getting details about places.\n\n This type should be accessed through [PlacesClient.shared](/maps/documentation/places/ios-sdk/reference/swift/Classes/PlacesClient#/s:17GooglePlacesSwift0B6ClientC6sharedACvpZ).\n\n PlacesClient methods should only be called from the main thread. Calling these methods from\n another thread will result in an exception or undefined behavior. Unless otherwise specified,\n all callbacks will be invoked on the main thread. \n\n #### Declaration\n\n Swift \n\n protocol PlacesClientProtocol : AnyObject, Sendable"]]