Places UI Kit customization tool. Create custom, cross-platform, Place Details configurations using our tool. You can use toggles to create your configuration, or upload an image to have Gemini get you started. Access the tool.
]]>Release 5.1.1
The Places SDK for Android version 5.1.1 is now available. For information about this release, and for all previous releases, see the Release Notes or subscribe to the Release Notes XML feed.
If you are a new user, see Set Up in the Google Cloud Console to start the installation process. If you are an existing customer, see the upgrade instructions at Versions.
Text Search (New) now supports pagination through the getPagination() method. For more information, see Pagination.
You can now use the custom styling Customization tool to create and visualize custom styling configurations for Places UI Kit elements.
You can now return a link to the Google Maps page for a place by including the GOOGLE_MAPS_LINKS field in your request.
The Places UI Kit Place Details Compact Widget now supports a Lightbox for full-screen photo enlargement. For more information, see Content display options.
ServiceConfigurationError when using R8 Full Mode. The interim solution for version 5.1.1 is to add a proguard keep rule:
-keepclassmembers class com.google.android.libraries.places.internal.** {
<init>();
}
The following previously deprecated fields have been removed:
ADDRESS - use FORMATTED_ADDRESS instead.ICON_URL - use ICON_MASK_URL instead.LAT_LNG - use LOCATION instead.NAME - use DISPLAY_NAME instead.PHONE_NUMBER - use INTERNATIONAL_PHONE_NUMBER instead.USER_RATINGS_TOTAL - use USER_RATING_COUNT instead.WHEELCHAIR_ACCESSIBLE_ENTRANCE - use ACCESSIBILITY_OPTIONS instead.For more information on alternate fields, see Place Data Fields (New).
The following Places SDK (Legacy) APIs are now deprecated:
Places.initialize() — use Places.initializeWithNewPlacesApiEnabled() instead.PlacesClient.findCurrentPlace() and the associated request and response classes — use PlacesClient.searchNearby() instead.PlacesClient.fetchPhoto() and the associated request and response classes — use PlacesClient.fetchResolvedPhotoUri() instead.AutocompleteActivityModePlacesClient.awaitFindCurrentPlace() and the associated request classPlacesClient.awaitFetchPhoto() and the associated request classIn accordance with the Mobile OS version support policy, we are freezing support for Android 6.0 (API levels 23 and below) as of Places SDK for Android v5.0.0. The new minSDK is Android 7.0 (API level 24). Earlier Places SDK versions will continue supporting Android 6.0.
If your dependencies do not specify a version number, your IDE will load the newest SDK version and new builds of your app will not support Android 6.0.
Specify a version of the Places SDKs for Android in your application's build dependencies in order to control when you raise the minimum supported OS for new versions of your app.
You can now define custom themes to modify the styling of both the Autocomplete (New) Place Autocomplete widget and the UI Kit Basic Place Autocomplete component. For more information, see Custom Styling.
Release 5.0.0
The Places SDK for Android version 5.0.0 is now available. For information about this release, and for all previous releases, see the Release Notes or subscribe to the Release Notes XML feed.
If you are a new user, see Set Up in the Google Cloud Console to start the installation process. If you are an existing customer, see the upgrade instructions at Versions.
The previously deprecated AutocompleteFragment class has been removed. Use AutocompleteSupportFragment instead.
Apps that use the Places SDK for Android must now enable Java 8 library support.
For more information, see https://developer.android.com/studio/write/java8-support.
The following Generative AI summary fields are now available:
The following classes and methods are now available:
The following previously deprecated methods have been removed from the Place class, along with their associated Place.Builder methods:
getAddress() - use getFormattedAddress() instead.getIconUrl() - use getIconMaskUrl() instead.getLatLng - use getLocation() instead.getName() - use getDisplayName() instead.getNameLanguageCode() - use getDisplayNameLanguageCode() instead.getPhoneNumber() - use getInternationalPhoneNumber() instead.getTypes() - use getPlaceTypes() instead.getUserRatingsTotal() - use getUserRatingCount() instead.getWheelchairAccessibleEntrance() - use getAccessibilityOptions() instead.Full Place Details available in Places UI Kit Place Details component
The Places UI Kit Place Details component now allows you to display full information about a place. See the full documentation
Release 4.4.1
The Places SDK for Android version 4.4.1 is now available. For information about this release, and for all previous releases, see the Release Notes or subscribe to the Release Notes XML feed.
If you are a new user, see Set Up in the Google Cloud Console to start the installation process. If you are an existing customer, see the upgrade instructions at Versions.
Places UI Kit Basic Place Autocomplete component
The Places UI Kit Autocomplete component allows you to customize the look, feel, and content of a full-screen search bar that provides autocomplete results as a user types. See the full documentation.
Places UI Kit Place Search component
The Places UI Kit Place Search component allows you to customize the look, feel, and content of the place card generated by a search by text or search nearby request. See the full documentation.
]]>The Place Autocomplete widget is now available for Autocomplete (New).
The Place Details UI Kit is now in General Availability.
Apps that use the Places SDK for Android 4.3.1 fail to build if the Material Components for Android are not included as a dependency. To resolve this issue, add the components as a dependency in your module-level build.gradle file:
dependencies {
implementation 'com.google.android.libraries.places:places:4.3.1'
implementation 'com.google.android.material:material:1.12.0'
}
Release 4.3.1
The Places SDK for Android version 4.3.1 is now available. For information about this release, and for all previous releases, see the Release Notes or subscribe to the Release Notes XML feed.
If you are a new user, see Set Up in the Google Cloud Console to start the installation process. If you are an existing customer, see the upgrade instructions at Versions.
]]>Release 4.2.0
The Places SDK for Android version 4.2.0 is now available. For information about this release, and for all previous releases, see the Release Notes or subscribe to the Release Notes XML feed.
If you are a new user, see Set Up in the Google Cloud Console to start the installation process. If you are an existing customer, see the upgrade instructions at Versions.
Apps configured with both minifyEnabled and coreLibraryDesugaringEnabled set to true may encounter a java.lang.NoSuchMethodException: j$.time.Instant.getNano crash. This issue is specific to release builds and has been fixed in version 4.3.1 of the Places SDK for Android.
To resolve this crash, please upgrade your Places SDK dependency to version 4.3.1.
Apps that use the Places SDK for Android 4.2.0 fail to build if the Material Components for Android are not included as a dependency. To resolve this issue, add the components as a dependency in your module-level build.gradle file:
dependencies {
implementation 'com.google.android.libraries.places:places:4.2.0'
implementation 'com.google.android.material:material:1.12.0'
}
The Place Details UI Kit for Place Details, now available as an Experimental feature, allows you to add an individual UI component that displays place details to your app.
For more information, see Places UI Kit: Place Details (Experimental).
]]>AppCheck is now available in the Places SDK for Android. AppCheck allows you to add another layer of security for your Google Maps Platform credentials.
For more information, see the AppCheck overview.
]]>Release 4.1.0
The Places SDK for Android version 4.1.0 is now available. For information about this release, and for all previous releases, see the Release Notes or subscribe to the Release Notes XML feed.
If you are a new user, see Set Up in the Google Cloud Console to start the installation process. If you are an existing customer, see the upgrade instructions at Versions.
Search Along Route features are now available, which allow you to search for places along predefined routes and calculate routing summaries to places in the search results.
For more information, see the Search Along Route overview.
The Places SDK (New) now supports 104 new types, which can be used to filter results in Autocomplete (New), Nearby Search (New), and Text Search (New) requests and are returned in the API response.
For a complete list of supported types, see Place Types (New).
]]>Native Kotlin APIs are now available for the Places SDK for Android.
For more information, including reference documentation see the Reference Overview.
New Place data fields are now available.
For a complete list of new fields, see Migrate to the new Place data fields in the Places SDK for Android 4.0.
In accordance with the Mobile OS version support policy, we are freezing support for Android 5 (API levels 22 and below) as of Places SDK for Android v4.0.0. The new minSDK is Android 5 (API level 23). Earlier Places SDK versions will continue supporting Android 5.
If your dependencies do not specify a version number, your IDE will load the newest SDK version and new builds of your app will not support Android 5.
Specify a version of the Places SDKs for Android in your application's build dependencies in order to control when you raise the minimum supported OS for new versions of your app.
Several of the Place data fields are now deprecated and have been replaced by new fields.
For a complete list of deprecated fields and their replacements, see Migrate to the new Place data fields in the Places SDK for Android 4.0.
Apps that use the Places SDK for Android now must now enable Java 8 library support.
For more information, see https://developer.android.com/studio/write/java8-support.
Release 4.0.0
The Places SDK for Android version 4.0.0 is now available. For information about this release, and for all previous releases, see the Release Notes or subscribe to the Release Notes XML feed.
If you are a new user, see Set Up in the Google Cloud Console to start the installation process.
If you are an existing customer, see the upgrade instructions at Versions.
]]>Release 3.5.0
The Places SDK for Android version 3.5.0 is now available. For information about this release, and for all previous releases, see the Release Notes or subscribe to the Release Notes XML feed.
If you are a new user, see Set Up in the Google Cloud Console to start the installation process.
If you are an existing customer, see the upgrade instructions at Versions.
The new features added to Places SDK for Android use a new pricing model. For pricing information for all new features, see Places SDK for Android (New).
The new version of Autocomplete is now available. Autocomplete (New) returns place predictions in response to user search queries. For more information, see Autocomplete (New).
Nearby Search is now available in the Places SDK for Android. A Nearby Search (New) request takes as input the region to search specified as a circle, defined by the latitude and longitude coordinates of the center point of the circle and the radius in meters. For more information, see Nearby Search (New).
isOpen() can now access results from Places Details (New). If Place Details (New) is enabled, the isOpen() request uses the Place Details (New) result. Otherwise, it uses the Place Details result. The result from both services is the same, but the pricing is different. For more information, see Places SDK for Android Usage and Billing.
Session tokens and session pricing are now supported for the Places SDK (New). For more information, see Session tokens.
Places SDK for Android version 3.5.0 requires a minimum of Kotlin 1.8.0. You can ensure that your Kotlin dependencies meet this minimum by updating the dependencies section of your module-level build.gradle file to add the kotlin-bom dependency:
dependencies {
implementation(platform("org.jetbrains.kotlin:kotlin-bom:1.8.0"))
implementation 'com.google.android.libraries.places:places:3.5.0'
}
For more information on the kotlin-bom dependency, see Usage of the latest kotlin-stdlib version in transitive dependencies.
Release 3.4.0
The Places SDK for Android version 3.4.0 is now available. For information about this release, and for all previous releases, see the Release Notes or subscribe to the Release Notes XML feed.
If you are a new user, see Set Up in the Google Cloud Console to start the installation process.
If you are an existing customer, see the upgrade instructions at Versions.
Places SDK for Android version 3.4.0 supports two SDK versions: the existing Places SDK for Android and Places SDK for Android (New), the next generation version of the SDK.
The new features added in version 3.4.0 are all part of Places SDK for Android (New), so you must use that SDK to access the new features.
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.
The Places SDK for Android added support for retrieving photo URIs for a place, along with the existing ability to retrieve photo bitmaps. For more information, see Place Photos.
Places SDK for Android version 3.4.0 requires a minimum of Kotlin 1.8.0. You can ensure that your Kotlin dependencies meet this minimum by updating the dependencies section of your module-level build.gradle file to add the kotlin-bom dependency:
dependencies {
implementation(platform("org.jetbrains.kotlin:kotlin-bom:1.8.0"))
implementation 'com.google.android.libraries.places:places:3.4.0'
}
For more information on the kotlin-bom dependency, see Usage of the latest kotlin-stdlib version in transitive dependencies.
SKU: Place Details (Location Only) is a Preview feature that contains fields that were previously included in SKU: Place Details (Basic). Usage during Preview is at no charge.
For more information, see SKU: Place Details (Location Only).
]]>Release 3.3.0
The Places SDK for Android version 3.3.0 is now available. For information about this release, and for all previous releases, see the Release Notes or subscribe to the Release Notes XML feed.
If you are a new user, see Set Up in the Google Cloud Console to start the installation process.
If you are an existing customer, see the upgrade instructions at Versions.
Places SDK for Android version 3.3.0 supports two SDK versions: the existing Places SDK for Android and Places SDK for Android (New), the next generation version of the SDK.
The new features added in v3.3.0 are all part of Places SDK for Android (New), so you must use that SDK to access the new features.
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.
The Places SDK for Android (New) adds the AuthorAttributions field to the PhotoMetadata class used by Place Photos. You must use Places SDK for Android (New) to be able to access author attributions.
The PhotoMetadata object returned by Place.getPhotoMetadas() can contain one or more author attributions represented by a List of AuthorAttribution objects.
Added Text Search, which returns information about a set of places based on a string — for example "pizza in New York" or "shoe stores near Ottawa" or "123 Main Street". You must use Places SDK for Android (New) to be able to use Text Search.
Place Details now includes the new Review class and the new language code for the name string in the response Place object. You must use Places SDK for Android (New) to be able to access these new fields.
Use the new Place.getReviews() method to return up to five reviews for a place.
Use the new Place.getNameLanguageCode() method to access the language code.
For more information, see Place Details.
New place type values are now available. You must use Places SDK for Android (New) to be able to access new type values.
Use the new Place.getPlaceTypes() method to access these new types.
If you run into errors for "Missing classes detected while running R8", please add the following rules to your existing keep rules in proguard-rules.pro:
-dontwarn io.grpc.internal.DnsNameResolverProvider
-dontwarn io.grpc.internal.PickFirstLoadBalancerProvider
Places SDK for Android version 3.3.0 requires a minimum of Kotlin 1.8.0. You can ensure that your Kotlin dependencies meet this minimum by updating the dependencies section of your module-level build.gradle file to add the kotlin-bom dependency:
dependencies {
implementation(platform("org.jetbrains.kotlin:kotlin-bom:1.8.0"))
implementation 'com.google.android.libraries.places:places:3.3.0'
}
For more information on the kotlin-bom dependency, see Usage of the latest kotlin-stdlib version in transitive dependencies.
New place type values have been added in v3.3.0. You must use Places SDK for Android (New) to be able to access new type values.
These new type values are not accessible by the existing Place.getTypes() method. Place.getTypes() in the Places SDK for Android
is deprecated as of v3.3.0.
Instead, use Place.getPlaceTypes().
The minimum version of the Places SDK for Android with Place.getPlaceTypes() is v3.3.0.
Release 3.2.0
The Places SDK for Android version 3.2.0 is now available. For information about this release, and for all previous releases, see the Release Notes or subscribe to the Release Notes XML feed.
If you are a new user, see Set Up in the Google Cloud Console to start the installation process.
If you are an existing customer, see the upgrade instructions at Versions.
To clarify which class provides supported String constants for filtering Place Autocomplete predictions, the TypeFilter class in the Places SDK for Android
is deprecated as of v3.2.0.
Instead, use PlaceTypes. For more information, see Filter results by place type or type collection.
The minimum version of the Places SDK for Android with PlaceTypes is v2.7.0. The v2.7.0 release notes have been amended to clarify that the deprecated methods in v2.7.0 should use PlaceTypes instead of TypeFilter.
Place Details now supports the following new Atmosphere Data Field, which contains a summary of a place up to 150 characters in length:
Place.Field.EDITORIAL_SUMMARYThe Place class now contain the following new methods to support this field:
getEditorialSummary()getEditorialSummaryLanguageCode()Release 3.1.0
The Places SDK for Android version 3.1.0 is now available. For information about this release, and for all previous releases, see the Release Notes or subscribe to the Release Notes XML feed.
If you are a new user, see Set Up in the Google Cloud Console to start the installation process.
If you are an existing customer, see the upgrade instructions at Versions.
To simplify filtering results by country, the following methods in the Places SDK for Android are deprecated as of v3.1.0:
FindAutocompletePredictionsRequest.Builder.setCountry(String countryCode)Autocomplete.setCountry(String country)AutocompleteSupportFragment.setCountry(String country)FindAutocompletePredictionsRequest.getCountry()Instead, use the following methods. The minimum version of the Places SDK for Android with the following methods is v2.2.0:
FindAutocompletePredictionsRequest.Builder.setCountries(List<String> countries)Autocomplete.IntentBuilder.setCountries(List<String> countries)AutocompleteSupportFragment.setCountries(List<String> countries)FindAutocompletePredictionsRequest.getCountries()To provide a more convenient method for checking on open status of a place, Place.isOpen()
is deprecated as of v3.1.0. Instead, use PlacesClient.isOpen(). The minimum version of the Places SDK for Android with PlacesClient.isOpen() is v3.1.0.
For more information on PlacesClient.isOpen(), see Get open status.
Place Details now supports the following new Basic Data Field:
Place.Field.WHEELCHAIR_ACCESSIBLE_ENTRANCEAnd the following new Atmosphere Data Fields:
Place.Field.RESERVABLEPlace.Field.SERVES_BEERPlace.Field.SERVES_BREAKFASTPlace.Field.SERVES_BRUNCHPlace.Field.SERVES_DINNERPlace.Field.SERVES_LUNCHPlace.Field.SERVES_VEGETARIAN_FOODPlace.Field.SERVES_WINEThe following methods have been added to Place:
getCurrentOpeningHours() returns a place's hours of operation over the next seven days. The time period starts at midnight on the date of the request and ends at 11:59 pm six days later.
getSecondaryOpeningHours() returns a place's secondary hours of operation over the next seven days. Secondary hours are different from a business's main hours. For example, a restaurant can specify drive through hours or delivery hours as secondary hours.
Release 3.0.0
The Places SDK for Android version 3.0.0 is now available. For information about this release, and for all previous releases, see the Release Notes or subscribe to the Release Notes XML feed.
If you are a new user, see Set Up in the Google Cloud Console to start the installation process.
If you are an existing customer, see the upgrade instructions at Versions.
According to the Mobile OS version support policy, we are freezing support for Android 4 (API levels 20 and below) as of Places SDK for Android v3.0.0. The new minSDK is Android 5 (API level 21). Earlier Places SDK versions will continue supporting Android 4.
If your dependencies do not specify a version number, your IDE will load the newest SDK version and new builds of your app will not support Android 4.
Specify a version of the Places SDKs for Android in your application's build dependencies in order to control when you raise the minimum supported OS for new versions of your app.
Place Details now supports four new Atmosphere Data Fields:
Place.Field.TAKEOUTPlace.Field.DELIVERYPlace.Field.DINE_INPlace.Field.CURBSIDE_PICKUPAdded new Place.BooleanPlaceAttributeValue class that defines the values of these new place attribute fields.
]]>Release 2.7.0
The Places SDK for Android version 2.7.0 is now available. For information about this release, and for all previous releases, see the Release Notes or subscribe to the Release Notes XML feed.
If you are a new user, see Set Up in the Google Cloud Console to start the installation process.
If you are an existing customer, see the upgrade instructions at Versions.
To provide expanded support for filtering Place Autocomplete by multiple place types, the following are deprecated as of v2.7.0:
AutocompleteSupportFragment.setTypeFilter(TypeFilter typeFilter)FindAutocompletePredictionsRequest.Builder.setTypeFilter(TypeFilter typeFilter)Autocomplete.IntentBuilder.setTypeFilter(TypeFilter typeFilter)Instead, use:
AutocompleteSupportFragment.setTypesFilter(List<String> placeTypes)FindAutocompletePredictionsRequest.Builder.setTypesFilter(List<String> placeTypes)Autocomplete.IntentBuilder.setTypesFilter(List<String> placeTypes)The minimum version of the Places SDK for Android with setTypesFilter(List<String> placeTypes) is v2.7.0.
Added the setTypesFilter(List<String> placeTypes) method to AutocompleteSupportFragment, FindAutocompletePredictionsRequest.Builder, and Autocomplete.IntentBuilder. Use this method to specify up to five values to restrict results from a Place Autocomplete request.
For more information, see Filter results by place type or type collection.
If your app does not use PlacesClient.findCurrentPlace(), you must now explicitly remove both the
ACCESS_FINE_LOCATION and ACCESS_COARSE_LOCATION permissions. In previous releases, you only had to remove ACCESS_FINE_LOCATION.
For more information, see Current Place.
122841340: When you call Places.initialize(Context, String, Locale) and the specified Locale is different from the device's locale, the autocomplete widget now localizes both the search hint and the search results based on the setting of Locale. If you omit Locale, then it uses the device's locale.