GooglePlaces Framework Reference

Classes

The following classes are available globally.

• GMSAddressComponent

  Represents a component of an address, e.g., street number, postcode, city, etc.

  Declaration

  Swift

  class GMSAddressComponent : NSObject

  Objective-C

  @interface GMSAddressComponent : NSObject

• GMSAutocompleteFetcher

  GMSAutocompleteFetcher is a wrapper around the lower-level autocomplete APIs that encapsulates some of the complexity of requesting autocomplete predictions as the user is typing. Calling sourceTextHasChanged will generally result in the provided delegate being called with autocomplete predictions for the queried text, with the following provisos:

  • The fetcher may not necessarily request predictions on every call of sourceTextHasChanged if several requests are made within a short amount of time.
  • The delegate will only be called with prediction results if those predictions are for the text supplied in the most recent call to sourceTextHasChanged.

  Declaration

  Swift

  class GMSAutocompleteFetcher : NSObject

  Objective-C

  @interface GMSAutocompleteFetcher : NSObject

• GMSAutocompleteFilter

  This class represents a set of restrictions that may be applied to autocomplete requests. This allows customization of autocomplete suggestions to only those places that are of interest.

  Declaration

  Swift

  class GMSAutocompleteFilter : NSObject

  Objective-C

  @interface GMSAutocompleteFilter : NSObject

• GMSAutocompleteMatchFragment

  This class represents a matched fragment of a string. This is a contiguous range of characters in a string, suitable for highlighting in an autocompletion UI.

  Declaration

  Swift

  class GMSAutocompleteMatchFragment : NSObject

  Objective-C

  @interface GMSAutocompleteMatchFragment : NSObject

• GMSAutocompletePlaceSuggestion

  This class represents a place suggestion of a full query based on a partially typed string.

  Declaration

  Swift

  class GMSAutocompletePlaceSuggestion : NSObject

  Objective-C

  @interface GMSAutocompletePlaceSuggestion : NSObject

• GMSAutocompletePrediction

  This class represents a prediction of a full query based on a partially typed string.

  Declaration

  Swift

  class GMSAutocompletePrediction : NSObject

  Objective-C

  @interface GMSAutocompletePrediction : NSObject

• GMSAutocompleteRequest

  The request for autocomplete data.

  Declaration

  Swift

  class GMSAutocompleteRequest : NSObject

  Objective-C

  @interface GMSAutocompleteRequest : NSObject

• GMSAutocompleteResultsViewController

  GMSAutocompleteResultsViewController provides an interface that displays place autocomplete predictions in a table view. The table view will be automatically updated as input text changes.

  This class is intended to be used as the search results controller of a UISearchController. Pass an instance of GMSAutocompleteResultsViewController to UISearchController’s initWithSearchResultsController method, then set the controller as the UISearchController’s searchResultsUpdater property.

  Use the GMSAutocompleteResultsViewControllerDelegate delegate protocol to be notified when a place is selected from the list.

  Declaration

  Swift

  class GMSAutocompleteResultsViewController : UIViewController, UISearchResultsUpdating

  Objective-C

  @interface GMSAutocompleteResultsViewController
      : UIViewController <UISearchResultsUpdating>

• GMSAutocompleteSessionToken

  This class represents a session token to uniquely identify a series of queries to the Google Places API Services for fetching place predictions for a partial search string.

  Declaration

  Swift

  class GMSAutocompleteSessionToken : NSObject

  Objective-C

  @interface GMSAutocompleteSessionToken : NSObject

• GMSAutocompleteSuggestion

  This class represents a suggestion of a full query based on a partially typed string.

  Declaration

  Swift

  class GMSAutocompleteSuggestion : NSObject

  Objective-C

  @interface GMSAutocompleteSuggestion : NSObject

• GMSAutocompleteTableDataSource

  GMSAutocompleteTableDataSource provides an interface for providing place autocomplete predictions to populate a UITableView by implementing the UITableViewDataSource and UITableViewDelegate protocols.

  GMSAutocompleteTableDataSource is designed to be used as the data source for a UISearchDisplayController.

  NOTE: UISearchDisplayController has been deprecated since iOS 8. It is now recommended to use UISearchController with GMSAutocompleteResultsViewController to display autocomplete results using the iOS search UI.

  Set an instance of GMSAutocompleteTableDataSource as the searchResultsDataSource and searchResultsDelegate properties of UISearchDisplayController. In your implementation of shouldReloadTableForSearchString, call sourceTextHasChanged with the current search string.

  Use the GMSAutocompleteTableDataSourceDelegate delegate protocol to be notified when a place is selected from the list. Because autocomplete predictions load asynchronously, it is necessary to implement didUpdateAutocompletePredictions and call reloadData on the UISearchDisplayController‘s table view.

  Declaration

  Swift

  class GMSAutocompleteTableDataSource : NSObject, UITableViewDataSource, UITableViewDelegate

  Objective-C

  @interface GMSAutocompleteTableDataSource
      : NSObject <UITableViewDataSource, UITableViewDelegate>

• GMSAutocompleteViewController

  GMSAutocompleteViewController provides an interface that displays a table of autocomplete predictions that updates as the user enters text. Place selections made by the user are returned to the app via the GMSAutocompleteViewControllerResultsDelegate protocol.

  To use GMSAutocompleteViewController, set its delegate to an object in your app that conforms to the GMSAutocompleteViewControllerDelegate protocol and present the controller (eg using presentViewController). The GMSAutocompleteViewControllerDelegate delegate methods can be used to determine when the user has selected a place or has cancelled selection.

  Declaration

  Swift

  class GMSAutocompleteViewController : UIViewController

  Objective-C

  @interface GMSAutocompleteViewController : UIViewController

• GMSFetchPhotoRequest

  Request object to use with GMSPlacesClient to fetch a photo.

  Declaration

  Swift

  class GMSFetchPhotoRequest : NSObject

  Objective-C

  @interface GMSFetchPhotoRequest : NSObject

• GMSFetchPlaceRequest

  Request object to use with GMSPlacesClient to fetch a place.

  Declaration

  Swift

  class GMSFetchPlaceRequest : NSObject

  Objective-C

  @interface GMSFetchPlaceRequest : NSObject

• GMSTime

  A class representing time in hours and minutes in a 24hr clock.

  Declaration

  Swift

  class GMSTime : NSObject

  Objective-C

  @interface GMSTime : NSObject

• GMSEvent

  A class representing a open/close event in GMSPeriod.

  Declaration

  Swift

  class GMSEvent : NSObject

  Objective-C

  @interface GMSEvent : NSObject

• GMSPeriod

  A class representing a period of time where the place is operating for a GMSPlace. It contains an open GMSEvent and an optional close GMSEvent. The close event will be nil if the period is open 24hrs.

  Declaration

  Swift

  class GMSPeriod : NSObject

  Objective-C

  @interface GMSPeriod : NSObject

• GMSOpeningHours

  A class to handle storing and accessing opening hours information for GMSPlace.

  Declaration

  Swift

  class GMSOpeningHours : NSObject

  Objective-C

  @interface GMSOpeningHours : NSObject

• GMSPlace

  Represents a particular physical place. A GMSPlace encapsulates information about a physical location, including its name, location, and any other information we might have about it. This class is immutable.

  Declaration

  Swift

  class GMSPlace : NSObject

  Objective-C

  @interface GMSPlace : NSObject

• GMSPlaceAuthorAttribution

  A class representing an author attribution.

  Declaration

  Swift

  class GMSPlaceAuthorAttribution : NSObject

  Objective-C

  @interface GMSPlaceAuthorAttribution : NSObject

• GMSPlaceIsOpenRequest

  Represents an is open request definition to be sent via GMSPlacesClient.

  Declaration

  Swift

  class GMSPlaceIsOpenRequest : NSObject

  Objective-C

  @interface GMSPlaceIsOpenRequest : NSObject

• GMSPlaceIsOpenResponse

  The response object for the isOpenWithRequest:callback: method.

  Declaration

  Swift

  class GMSPlaceIsOpenResponse : NSObject

  Objective-C

  @interface GMSPlaceIsOpenResponse : NSObject

• GMSPlaceLikelihood

  Represents a GMSPlace and the relative likelihood of the place being the best match within the list of returned places for a single request. For more information about place likelihoods, see GMSPlaceLikelihoodList.

  Declaration

  Swift

  class GMSPlaceLikelihood : NSObject, NSCopying

  Objective-C

  @interface GMSPlaceLikelihood : NSObject <NSCopying>

• GMSPlaceLikelihoodList

  Represents a list of places with an associated likelihood for the place being the correct place. For example, the Places service may be uncertain what the true Place is, but think it 55% likely to be PlaceA, and 35% likely to be PlaceB. The corresponding likelihood list has two members, one with likelihood 0.55 and the other with likelihood 0.35. The likelihoods are not guaranteed to be correct, and in a given place likelihood list they may not sum to 1.0.

  Declaration

  Swift

  class GMSPlaceLikelihoodList : NSObject

  Objective-C

  @interface GMSPlaceLikelihoodList : NSObject

• GMSPlacePhotoMetadata

  The metadata corresponding to a single photo associated with a place.

  Declaration

  Swift

  class GMSPlacePhotoMetadata : NSObject

  Objective-C

  @interface GMSPlacePhotoMetadata : NSObject

• GMSPlacePhotoMetadataList

  A list of GMSPlacePhotoMetadata objects.

  Declaration

  Swift

  class GMSPlacePhotoMetadataList : NSObject

  Objective-C

  @interface GMSPlacePhotoMetadataList : NSObject

• GMSPlaceReview

  This class represents a single place review.

  Declaration

  Swift

  class GMSPlaceReview : NSObject

  Objective-C

  @interface GMSPlaceReview : NSObject

• GMSPlaceSearchByTextRequest

  Represents a text search request definition to be sent via GMSPlacesClient.

  Declaration

  Swift

  class GMSPlaceSearchByTextRequest : NSObject

  Objective-C

  @interface GMSPlaceSearchByTextRequest : NSObject

• GMSPlaceSearchNearbyRequest

  Request object to use with GMSPlacesClient to fetch nearby places.

  Declaration

  Swift

  class GMSPlaceSearchNearbyRequest : NSObject

  Objective-C

  @interface GMSPlaceSearchNearbyRequest : NSObject

• GMSPlaceSpecialDay

  Represents information on a particular day which may have opening hours different than normal.

  Declaration

  Swift

  class GMSPlaceSpecialDay : NSObject

  Objective-C

  @interface GMSPlaceSpecialDay : NSObject

• GMSPlaceViewportInfo

  GMSPlaceViewportInfo represents a rectangular bounding box on the Earth’s surface. GMSPlaceViewportInfo is immutable and can’t be modified after construction.

  Declaration

  Swift

  class GMSPlaceViewportInfo : NSObject

  Objective-C

  @interface GMSPlaceViewportInfo : NSObject

• GMSPlacesClient

  Main interface to the Places SDK. Used for searching and getting details about places. This class should be accessed through the [GMSPlacesClient sharedClient] method.

  GMSPlacesClient 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

  class GMSPlacesClient : NSObject

  Objective-C

  @interface GMSPlacesClient : NSObject

• GMSPlusCode

  A class containing the Plus codes representation for a location. See https://plus.codes/ for more details.

  Declaration

  Swift

  class GMSPlusCode : NSObject

  Objective-C

  @interface GMSPlusCode : NSObject