Get Started Contact sales

GooglePlacesSwift Framework Reference

  • This page provides a comprehensive list of structures available globally within the Google Places SDK for iOS.

  • Each structure is accompanied by a brief description and a declaration in Swift.

  • These structures are essential for interacting with various functionalities of the Places SDK, such as place details, autocomplete, photos, and opening hours.

  • Developers can use these structures to build location-aware features into their iOS applications.

  • For detailed information on each structure, click on the corresponding link provided.

Structures

The following structures are available globally.

  • Information about the accessibility options a place offers.

    Declaration

    Swift

    struct AccessibilityOptions
     
    extension AccessibilityOptions : Copyable, CustomStringConvertible, Equatable, Escapable, Hashable

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

    Declaration

    Swift

    struct AddressComponent
     
    extension AddressComponent : Copyable, CustomStringConvertible, Equatable, Escapable, Hashable, Sendable, SendableMetatype

  • A relational description of a location. Includes a ranked set of nearby landmarks and precise containing areas and their relationship to the target location.

    Declaration

    Swift

    struct AddressDescriptor
     
    extension AddressDescriptor : Copyable, CustomStringConvertible, Equatable, Escapable, Hashable, Sendable, SendableMetatype

  • The configuration for the AdvancedPlaceDetailsCompactView component.

    Declaration

    Swift

    struct AdvancedPlaceDetailsCompactConfiguration
     
    extension AdvancedPlaceDetailsCompactConfiguration : Sendable, SendableMetatype

  • A premium view that displays place details results.

    Has additional configurations compared to its basic counterpart (PlaceDetailsCompactView).

    Declaration

    Swift

    @MainActor
struct AdvancedPlaceDetailsCompactView
     
    extension AdvancedPlaceDetailsCompactView : SearchMediaSupportable, Sendable, SendableMetatype, View

  • The configuration for the AdvancedPlaceDetailsView component.

    Declaration

    Swift

    struct AdvancedPlaceDetailsConfiguration
     
    extension AdvancedPlaceDetailsConfiguration : Sendable, SendableMetatype

  • A premium view that displays place details results.

    Has additional configurations compared to its basic counterpart (PlaceDetailsView).

    Declaration

    Swift

    @MainActor
@preconcurrency
struct AdvancedPlaceDetailsView
     
    extension AdvancedPlaceDetailsView : SearchMediaSupportable, SearchReviewsSupportable, Sendable, SendableMetatype, View

  • The configuration for the AdvancedPlaceListView component.

    Declaration

    Swift

    struct AdvancedPlaceListConfiguration
     
    extension AdvancedPlaceListConfiguration : Sendable, SendableMetatype

  • A premium view that displays a unique list of place details results.

    Declaration

    Swift

    @MainActor
struct AdvancedPlaceListView
     
    extension AdvancedPlaceListView : SearchMediaSupportable, Sendable, SendableMetatype, View

  • The configuration for the AdvancedPlaceSearchView component.

    Declaration

    Swift

    struct AdvancedPlaceSearchConfiguration
     
    extension AdvancedPlaceSearchConfiguration : Sendable, SendableMetatype

  • A premium view that displays a list of place search results.

    Has additional configurations compared to its basic counterpart (PlaceSearchView).

    Declaration

    Swift

    @MainActor
struct AdvancedPlaceSearchView
     
    extension AdvancedPlaceSearchView : SearchMediaSupportable, Sendable, SendableMetatype, View

  • Area information and the area’s relationship with the target location.

    Areas includes precise sublocality, neighborhoods, and large compounds that are useful for describing a location.

    Declaration

    Swift

    struct Area
     
    extension Area : Copyable, CustomStringConvertible, Equatable, Escapable, Hashable, Sendable, SendableMetatype

  • Declaration

    Swift

    struct AuthorAttribution
     
    extension AuthorAttribution : Copyable, CustomStringConvertible, Equatable, Escapable, Hashable, Sendable, SendableMetatype

  • 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

    struct AutocompleteFilter
     
    extension AutocompleteFilter : Sendable, SendableMetatype

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

    Declaration

    Swift

    struct AutocompletePlaceSuggestion
     
    extension AutocompletePlaceSuggestion : Copyable, CustomStringConvertible, Equatable, Escapable, Hashable, Sendable, SendableMetatype

  • The request for autocomplete suggestions based on a given partial query along with additional configuring properties.

    Declaration

    Swift

    struct AutocompleteRequest
     
    extension AutocompleteRequest : Sendable, SendableMetatype

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

    Declaration

    Swift

    struct AutocompleteSessionToken
     
    extension AutocompleteSessionToken : Copyable, CustomStringConvertible, Equatable, Escapable, Hashable, Sendable, SendableMetatype

  • UI customizations for the Autocomplete place picker.

    Declaration

    Swift

    struct AutocompleteUICustomization

  • CircularCoordinateRegion represents a circular bounding region on the Earth’s surface. CircularCoordinateRegion is immutable and can’t be modified after construction.

    Declaration

    Swift

    struct CircularCoordinateRegion
     
    extension CircularCoordinateRegion : CoordinateRegion, CoordinateRegionBias, CoordinateRegionRestriction, Copyable, Equatable, Escapable, Hashable, Sendable, SendableMetatype

  • A class that represents an EV charging connector aggregation.

    Declaration

    Swift

    struct ConnectorAggregation
     
    extension ConnectorAggregation : Copyable, CustomStringConvertible, Equatable, Escapable, Hashable, Sendable, SendableMetatype

  • A struct that represents a place’s consumer alert.

    Declaration

    Swift

    struct ConsumerAlert
     
    extension ConsumerAlert : Copyable, CustomStringConvertible, Equatable, Escapable, Hashable, Sendable, SendableMetatype

  • A struct that represents the details of a consumer alert.

    Declaration

    Swift

    struct ConsumerAlertDetails
     
    extension ConsumerAlertDetails : Copyable, CustomStringConvertible, Equatable, Escapable, Hashable, Sendable, SendableMetatype

  • A parent location that holds another place.

    Declaration

    Swift

    struct ContainingPlace
     
    extension ContainingPlace : Copyable, CustomStringConvertible, Equatable, Escapable, Hashable, Sendable, SendableMetatype

  • A struct that represents a content block.

    Declaration

    Swift

    struct ContentBlock
     
    extension ContentBlock : Copyable, CustomStringConvertible, Equatable, Escapable, Hashable, Sendable, SendableMetatype

  • Represents a custom place view action that can be displayed in the corner of a place view.

    Declaration

    Swift

    struct CornerPlaceAction

  • A struct that represents the summary of amenities near an EV charging station.

    Declaration

    Swift

    struct EVChargeAmenitySummary
     
    extension EVChargeAmenitySummary : AISummary, Copyable, CustomStringConvertible, Equatable, Escapable, Hashable, Sendable, SendableMetatype

  • A struct that represents a place’s EV charging options.

    Declaration

    Swift

    struct EVChargeOptions
     
    extension EVChargeOptions : Copyable, CustomStringConvertible, Equatable, Escapable, Hashable, Sendable, SendableMetatype

  • Searchable EV options of a place search request.

    Declaration

    Swift

    struct EVSearchOptions
     
    extension EVSearchOptions : Copyable, CustomStringConvertible, Equatable, Escapable, Hashable, Sendable, SendableMetatype

  • An encoded polyline for a route.

    See https://developers.google.com/maps/documentation/utilities/polylinealgorithm for more info.

    Declaration

    Swift

    struct EncodedPolyline
     
    extension EncodedPolyline : Copyable, CustomStringConvertible, Equatable, Escapable, Hashable, Polyline, Sendable, SendableMetatype

  • A class representing a open/close event in Period.

    Declaration

    Swift

    struct Event
     
    extension Event : Copyable, CustomStringConvertible, Equatable, Escapable, Hashable, Sendable, SendableMetatype

  • The request for a specific placeID and place properties to include in the Place response.

    Declaration

    Swift

    @available(*, deprecated, message: "This struct is deprecated, please use the Place Details component (https://developers.google.com/maps/documentation/places/ios-sdk/place-details-ui-kit﹚ instead.")
struct FetchPhotoRequest
     
    extension FetchPhotoRequest : Sendable, SendableMetatype

  • The request for a specific placeID and place properties to include in the Place response.

    Declaration

    Swift

    struct FetchPlaceRequest
     
    extension FetchPlaceRequest : Sendable, SendableMetatype

  • The most recent information about fuel options in a gas station.

    Declaration

    Swift

    struct FuelOptions
     
    extension FuelOptions : Copyable, CustomStringConvertible, Equatable, Escapable, Hashable, Sendable, SendableMetatype

  • Fuel price information for a given fuel type.

    Declaration

    Swift

    struct FuelPrice
     
    extension FuelPrice : Copyable, CustomStringConvertible, Equatable, Escapable, Hashable, Sendable, SendableMetatype

  • A struct that represents a place’s generative summary.

    Declaration

    Swift

    struct GenerativeSummary
     
    extension GenerativeSummary : AISummary, Copyable, CustomStringConvertible, Equatable, Escapable, Hashable, Sendable, SendableMetatype

  • Links to trigger different Google Maps actions for a place.

    Declaration

    Swift

    struct GoogleMapsLinks
     
    extension GoogleMapsLinks : Copyable, CustomStringConvertible, Equatable, Escapable, Hashable, Sendable, SendableMetatype

  • Represents an IsPlaceOpenRequest definition to be sent via PlacesClient.

    Declaration

    Swift

    struct IsPlaceOpenRequest
     
    extension IsPlaceOpenRequest : Sendable, SendableMetatype

  • The response from the isPlaceOpen method.

    Declaration

    Swift

    struct IsPlaceOpenResponse
     
    extension IsPlaceOpenResponse : Sendable, SendableMetatype

  • Basic landmark information and the landmark’s relationship with the target location.

    Landmarks are prominent places that can be used to describe a location.

    Declaration

    Swift

    struct Landmark
     
    extension Landmark : Copyable, CustomStringConvertible, Equatable, Escapable, Hashable, Sendable, SendableMetatype

  • Leg

    A single portion of a trip from one location to another.

    Declaration

    Swift

    struct Leg
     
    extension Leg : Copyable, CustomStringConvertible, Equatable, Escapable, Hashable, Sendable, SendableMetatype

  • Represents a custom place view action that can be displayed in the main body area of a place view.

    Declaration

    Swift

    struct MainPlaceAction

  • Represents an amount of money with its currency type.

    Declaration

    Swift

    struct Money
     
    extension Money : Copyable, CustomStringConvertible, Equatable, Escapable, Hashable, Sendable, SendableMetatype

  • A struct that represents a summary of a neighborhood.

    Declaration

    Swift

    struct NeighborhoodSummary
     
    extension NeighborhoodSummary : AISummary, Copyable, CustomStringConvertible, Equatable, Escapable, Hashable, Sendable, SendableMetatype

  • A type to handle storing and accessing opening hours information for Place.

    Declaration

    Swift

    struct OpeningHours
     
    extension OpeningHours : Copyable, CustomStringConvertible, Equatable, Escapable, Hashable, Sendable, SendableMetatype

  • A struct that represents pagination in a search response.

    Declaration

    Swift

    struct Pagination<Response> where Response : SearchResponse
     
    extension Pagination : Copyable, CustomStringConvertible, Equatable, Escapable, Hashable, Sendable, SendableMetatype

  • A struct that represents parking options at a place.

    Declaration

    Swift

    struct ParkingOptions
     
    extension ParkingOptions : Copyable, CustomStringConvertible, Equatable, Escapable, Hashable, Sendable, SendableMetatype

  • A struct that represents payment options for a place.

    Declaration

    Swift

    struct PaymentOptions
     
    extension PaymentOptions : Copyable, CustomStringConvertible, Equatable, Escapable, Hashable, Sendable, SendableMetatype

  • A type representing a period of time where the place is operating for a Place.

    Contains an open Event and an optional close Event. The close event will be nil if the period is open 24hrs.

    Declaration

    Swift

    struct Period
     
    extension Period : Copyable, CustomStringConvertible, Equatable, Escapable, Hashable, Sendable, SendableMetatype

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

    Declaration

    Swift

    @available(*, deprecated, message: "This struct is deprecated, please use the Place Details component (https://developers.google.com/maps/documentation/places/ios-sdk/place-details-ui-kit﹚ instead.")
struct Photo
     
    extension Photo : Copyable, CustomStringConvertible, Equatable, Escapable, Hashable, Sendable, SendableMetatype

  • Represents a particular physical place.

    A Place 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

    struct Place
     
    extension Place : Copyable, CustomStringConvertible, Equatable, Escapable, Hashable, PlaceProtocol, Sendable, SendableMetatype

  • The configuration of the place details compact view.

    Declaration

    Swift

    struct PlaceDetailsCompactConfiguration
     
    extension PlaceDetailsCompactConfiguration : Sendable, SendableMetatype

  • Declaration

    Swift

    @MainActor
struct PlaceDetailsCompactView
     
    extension PlaceDetailsCompactView : Sendable, SendableMetatype, View

  • Configuration for the Place Details component.

    Declaration

    Swift

    struct PlaceDetailsConfiguration
     
    extension PlaceDetailsConfiguration : Sendable, SendableMetatype

  • The place details component query.

    Declaration

    Swift

    struct PlaceDetailsQuery
     
    extension PlaceDetailsQuery : Equatable

  • The view for the place details component.

    Declaration

    Swift

    @MainActor
@preconcurrency
struct PlaceDetailsView
     
    extension PlaceDetailsView : Sendable, SendableMetatype, View

  • A SwiftUI View displaying a Place Marker (with an optional icon and text such as Rating, Price Range, Open Status, or Custom text).

    Fetches place details asynchronously using the provided PlaceIdentifier and renders the corresponding speech-bubble or custom marker when required attribute data is available.

    Declaration

    Swift

    @MainActor
struct PlaceMarker
     
    extension PlaceMarker : Sendable, SendableMetatype, View

  • Visual styling options for customizing PlaceMarker.

    Declaration

    Swift

    struct PlaceMarkerConfiguration
     
    extension PlaceMarkerConfiguration : Equatable, Sendable, SendableMetatype

  • The configuration of the place search view.

    Declaration

    Swift

    struct PlaceSearchConfiguration
     
    extension PlaceSearchConfiguration : Sendable, SendableMetatype

  • Declaration

    Swift

    @MainActor
struct PlaceSearchView
     
    extension PlaceSearchView : Sendable, SendableMetatype, View

  • All Places (NEW) API place types found at https://developers.google.com/maps/documentation/places/ios-sdk/place-types All Place Types found at https://developers.google.com/maps/documentation/places/ios-sdk/supported_types

    Declaration

    Swift

    struct PlaceType
     
    extension PlaceType : Equatable, Hashable, RawRepresentable, Sendable, SendableMetatype

  • The material attribution.

    Declaration

    Swift

    struct PlacesMaterialAttribution
     
    extension PlacesMaterialAttribution : Equatable, Hashable, Sendable, SendableMetatype

  • Material color tokens.

    Declaration

    Swift

    struct PlacesMaterialColor
     
    extension PlacesMaterialColor : Equatable, Hashable, Sendable, SendableMetatype

  • Material font tokens.

    Declaration

    Swift

    struct PlacesMaterialFont
     
    extension PlacesMaterialFont : Equatable, Hashable, Sendable, SendableMetatype

  • Measurement tokens.

    Declaration

    Swift

    struct PlacesMaterialMeasurement
     
    extension PlacesMaterialMeasurement : Equatable, Hashable, Sendable, SendableMetatype

  • Shape-related tokens.

    Declaration

    Swift

    struct PlacesMaterialShape
     
    extension PlacesMaterialShape : Equatable, Hashable, Sendable, SendableMetatype

  • General theming.

    Declaration

    Swift

    struct PlacesMaterialTheme
     
    extension PlacesMaterialTheme : Equatable, Hashable, Sendable, SendableMetatype

  • A class containing the Plus codes representation for a location.

    See https://plus.codes/ for more details.

    Declaration

    Swift

    struct PlusCode
     
    extension PlusCode : Copyable, CustomStringConvertible, Equatable, Escapable, Hashable, Sendable, SendableMetatype

  • Represents a postal address, such as for postal delivery or payments addresses. With a postal address, a postal service can deliver items to a premise, P.O. box, or similar. A postal address is not intended to model geographical locations like roads, towns, or mountains.

    Declaration

    Swift

    struct PostalAddress
     
    extension PostalAddress : Copyable, CustomStringConvertible, Equatable, Escapable, Hashable, Sendable, SendableMetatype

  • Price range associated with a place. When price range information is available for a place, the start price will always be set but the end price may not always be set with an upper boundary (eg: “More than $100”).

    Declaration

    Swift

    struct PriceRange
     
    extension PriceRange : Copyable, CustomStringConvertible, Equatable, Escapable, Hashable, Sendable, SendableMetatype

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

    Declaration

    Swift

    struct RectangularCoordinateRegion
     
    extension RectangularCoordinateRegion : CoordinateRegion, CoordinateRegionBias, CoordinateRegionRestriction, Copyable, Equatable, Escapable, Hashable, Sendable, SendableMetatype

  • Declaration

    Swift

    @available(*, deprecated, message: "This struct is deprecated, please use the Place Details component (https://developers.google.com/maps/documentation/places/ios-sdk/place-details-ui-kit﹚ instead.")
struct Review
     
    extension Review : Copyable, CustomStringConvertible, Equatable, Escapable, Hashable, Sendable, SendableMetatype

  • A struct that represents an AI-generated summary of the place using user reviews.

    Declaration

    Swift

    struct ReviewSummary
     
    extension ReviewSummary : AISummary, Copyable, CustomStringConvertible, Equatable, Escapable, Hashable, Sendable, SendableMetatype

  • Encapsulates a set of optional conditions to satisfy when calculating the routes.

    Declaration

    Swift

    struct RouteModifiers
     
    extension RouteModifiers : Copyable, CustomStringConvertible, Equatable, Escapable, Hashable, Sendable, SendableMetatype

  • Parameters to configure the routing calculations to the places in the response, both along a route (where result ranking will be influenced) and for calculating travel times on results.

    Declaration

    Swift

    struct RoutingParameters
     
    extension RoutingParameters : Copyable, CustomStringConvertible, Equatable, Escapable, Hashable, Sendable, SendableMetatype

  • The duration and distance from the routing origin to a place in the response, and a second leg from that place to the destination, if requested.

    Declaration

    Swift

    struct RoutingSummary
     
    extension RoutingSummary : Copyable, CustomStringConvertible, Equatable, Escapable, Hashable, Sendable, SendableMetatype

  • Additional parameters for searching along a route.

    Declaration

    Swift

    struct SearchAlongRouteParameters
     
    extension SearchAlongRouteParameters : Copyable, CustomStringConvertible, Equatable, Escapable, Hashable, Sendable, SendableMetatype

  • Declaration

    Swift

    struct SearchByTextRequest
     
    extension SearchByTextRequest : Equatable, Sendable, SendableMetatype

  • The response object for the searchByText method.

    Declaration

    Swift

    struct SearchByTextResponse
     
    extension SearchByTextResponse : SearchResponse, Sendable, SendableMetatype

  • The options to use when searching through a place’s media.

    Declaration

    Swift

    struct SearchMediaOptions
     
    extension SearchMediaOptions : Equatable, Sendable, SendableMetatype

  • Summary of results returned from a search media request.

    Declaration

    Swift

    struct SearchMediaSummary
     
    extension SearchMediaSummary : Sendable, SendableMetatype

  • Declaration

    Swift

    struct SearchNearbyRequest
     
    extension SearchNearbyRequest : Equatable, Sendable, SendableMetatype

  • The response object for the searchNearby method.

    Declaration

    Swift

    struct SearchNearbyResponse
     
    extension SearchNearbyResponse : SearchResponse, Sendable, SendableMetatype

  • The options to use when searching through a place’s reviews.

    Declaration

    Swift

    struct SearchReviewsOptions
     
    extension SearchReviewsOptions : Equatable, Sendable, SendableMetatype

  • Summary of results returned from a search reviews request.

    Declaration

    Swift

    struct SearchReviewsSummary

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

    Declaration

    Swift

    struct SpecialDay
     
    extension SpecialDay : Copyable, CustomStringConvertible, Equatable, Escapable, Hashable, Sendable, SendableMetatype

  • Time represents time in hours and minutes in a 24hr clock.

    Declaration

    Swift

    struct Time
     
    extension Time : Copyable, CustomStringConvertible, Equatable, Escapable, Hashable, Sendable, SendableMetatype