Introduction
The Places SDK for iOS lets you build location-aware apps that respond
contextually to the local businesses and other places near the device. This means you
can build rich apps based on places that mean something to the user.
Concepts
A
place
is defined as a physical space that has a name. Another way
of thinking about a place is that it's anything you can find on a map.
Examples include local businesses, points of interest, and geographic
locations. In the API, a place is represented by the
GMSPlace Class Reference
.
It includes information such as the name of the place and its address, geographical location,
place ID, phone number, place type, website URL, and more.
Choose your version of the SDK
Places SDK for iOS version 9.0.0 supports two SDK versions: the existing
Places SDK for iOS
and
Places SDK for iOS (New)
,
the next generation of the SDK.
Your first task is to decide which SDK to use. This is true if you are a new customer or an
existing customer already using the SDK. To learn the key differences between the two SDK versions,
see
Choose your SDK version
.
Pricing for each SDK version
Your chosen version of the SDK controls pricing.
Places SDK for iOS (New) supports a simplified pricing model so that you
only pay for the data that you use. For detailed pricing information for both SDKs, see
Usage and Billing
.
Preview release of GooglePlacesSwift
This release contains the Preview release of GooglePlacesSwift version 0.1.0. GooglePlacesSwift
lets you use a new Swift interface to call Place APIs, including all of the APIs in
Places SDK for iOS (New)
:
- Place Autocomplete (New)
- Place Details (New)
- Place Photos (New)
- Text Search (New)
- Nearby Search (New)
GooglePlacesSwift requires:
For more information, see the
GooglePlacesSwift API Reference
.
SDK overview
Use Places SDK for iOS to help your customers explore where they are and what's around
them. Places SDK for iOS provides the following APIs:
Places SDK for iOS (New)
|
Places SDK for iOS
|
Description
|
Place Details (New)
|
Place Details
|
Returns information about places, including the place's name and address, the geographical location, the type of place (such as night club, pet store, museum), and more.
|
Place Photo (New)
|
Place Photo
|
Returns high-quality images of a place.
|
Text Search (New)
|
|
Returns information about a set of places based on a text search.
|
Nearby Search (New)
|
|
Returns information about a set of places by specifying a location as a search area.
|
Autocomplete (New)
|
Autocomplete
|
Automatically fills in the name and/or address of a place as users type.
|
|
Current Place
|
Returns a list of places where the user's device is last known to be located along with an indication of the relative likelihood for each place.
|
Other highlights of the SDKs include:
- Accurate place detection at low power with Wi-Fi scan.
- On-device caching: Most requests to the Places SDK for iOS may
involve a round trip to a Google server, but you can also cache data
locally for 30 days.
Policies and terms
All applications that use the Places SDK for iOS must adhere
to the requirements described in the
Google Maps Platform Terms of Service
,
and
Displaying Attributions
.