Com o SDK do Places para Android, você pode criar apps com reconhecimento de local que respondem
de forma contextual às empresas locais e a outros lugares perto do dispositivo do usuário. Isso significa que você
pode criar apps avançados com base em lugares que significam algo para o usuário, para complementar os
serviços geográficos simples oferecidos pelos
Serviços de localização do Android.
Conceitos
As interfaces a seguir oferecem os principais pontos de entrada do SDK do Places para Android:
Places
concede acesso programático ao banco de dados do Google, que tem informações sobre lugares e empresas,
bem como o local atual do dispositivo.
Autocomplete
fornece widgets pré-criados para retornar previsões de lugares em resposta a consultas de pesquisa do usuário.
Um lugar é definido como um espaço físico com nome. Outra maneira de pensar sobre um lugar é que ele é tudo o que você pode encontrar em um mapa.
Exemplos incluem empresas locais, pontos de interesse e locais
geográficos. Na API, um lugar é representado pela interface Place. Ele inclui informações como o nome e o endereço do lugar, a localização geográfica, o ID do lugar, o número de telefone, o tipo de lugar, o URL do site e muito mais.
Visão geral da API
Ajude os clientes a conhecer o local e o que há por perto:
O Place Autocomplete preenche automaticamente o nome e/ou o endereço de um lugar conforme os usuários digitam.
Place Details (Detalhes do lugar) retornam e mostram informações mais detalhadas sobre um lugar.
[null,null,["Última atualização 2025-08-22 UTC."],[[["\u003cp\u003eThe Places SDK for Android allows you to build location-aware apps that utilize Google's database of local place and business information.\u003c/p\u003e\n"],["\u003cp\u003eYou can choose between the Places SDK for Android and the Places SDK for Android (New), each with its own features and pricing model.\u003c/p\u003e\n"],["\u003cp\u003eKey functionalities include Place Autocomplete, Current Place, Place Details, Text Search, Place Photos, and Place IDs to enrich user experiences.\u003c/p\u003e\n"],["\u003cp\u003eBefore using the SDK, you need a project with a billing account and the Places API enabled, along with adhering to Google Maps Platform Terms of Service.\u003c/p\u003e\n"],["\u003cp\u003eEnsure your app displays relevant attributions when presenting information sourced from the Places SDK for Android.\u003c/p\u003e\n"]]],[],null,["Select platform: [Android](/maps/documentation/places/android-sdk/overview \"View this page for the Android platform docs.\") [iOS](/maps/documentation/places/ios-sdk/overview \"View this page for the iOS platform docs.\") [JavaScript](/maps/documentation/javascript/place \"View this page for the JavaScript platform docs.\") [Web Service](/maps/documentation/places/web-service/overview \"View this page for the Web Service platform docs.\") \n**European Economic Area (EEA) developers** If your billing address is in the European Economic Area, effective on 8 July 2025, the [Google Maps Platform EEA Terms of Service](https://cloud.google.com/terms/maps-platform/eea) will apply to your use of the Services. Functionality varies by region. [Learn more](/maps/comms/eea/faq).\n| **Before you begin:** Before you start using the Places SDK for Android, you need a project with a billing account and the Places API enabled. We recommend creating multiple Project Owners and Billing Administrators, so that you'll always have someone with these roles available to your team. To learn more, see [Set up in Cloud console](/maps/documentation/places/android-sdk/cloud-setup).\n\nIntroduction\n\nThe Places SDK for Android lets you build location-aware apps that respond\ncontextually to the local businesses and other places near the user's device. This means you\ncan build rich apps based on places that mean something to the user, to complement the\nstraightforward geographic-based services offered by the\n[Android location services](https://developer.android.com/training/location/index.html).\n| **Note:** Places SDK (New) is the current version of Places SDK for Android. Places SDK is now Legacy and can no longer be enabled. Legacy documentation and migration guides are available on the [Legacy](/maps/documentation/places/android-sdk/overview-legacy) tab.\n\nConcepts\n\nThe following interfaces provide the primary entry points to the\nPlaces SDK for Android:\n\n- [`Places`](/maps/documentation/places/android-sdk/reference/com/google/android/libraries/places/api/Places) provides programmatic access to Google's database of local place and business information, as well as the device's current place.\n- [`Autocomplete`](/maps/documentation/places/android-sdk/reference/com/google/android/libraries/places/widget/Autocomplete) provides pre-made widgets to return place predictions in response to user search queries.\n\nA *place* is defined as a physical space that has a name. Another way\nof thinking about a place is that it's anything you can find on a map.\nExamples include local businesses, points of interest, and geographic\nlocations. In the API, a place is represented by the\n[`Place`](/maps/documentation/places/android-sdk/reference/com/google/android/libraries/places/api/model/Place)\ninterface. It includes information such as the name of the place and its\naddress, geographical location, place ID, phone number, place type, website\nURL, and more.\n| **Note:** Whenever your app displays information about places sourced from the Places SDK for Android, the app must also show all relevant attributions that are returned by the API. See the documentation on [displaying\n| attributions](/maps/documentation/places/android-sdk/attributions).\n\nAPI overview\n\nHelp your customers explore where they are and what's around them:\n\n- [Place Autocomplete](/maps/documentation/places/android-sdk/place-autocomplete) automatically fills in the name and/or address of a place as users type.\n- [Place Details](/maps/documentation/places/android-sdk/details-place) return and display more detailed information about a place.\n- [Nearby Search](/maps/documentation/places/android-sdk/nearby-search) returns a list of places based on a location and a search radius.\n- [Place Photos](/maps/documentation/places/android-sdk/place-photos) returns high-quality images of a place.\n- [Text Search](/maps/documentation/places/android-sdk/text-search) returns places based on a search text string.\n- [Place IDs](/maps/documentation/places/android-sdk/place-id) store the unique ID for one or more places for retrieval of place information on demand.\n\n| **Note:** Google gathers anonymous usage statistics.\n\nPolicies and Terms\n\nAll applications that use the Places SDK for Android must adhere\nto the requirements described in the\n[Google Maps Platform Terms of Service](https://cloud.google.com/maps-platform/terms),\n[Usage and Billing](/maps/documentation/places/android-sdk/usage-and-billing), and\n[Displaying Attributions](/maps/documentation/places/android-sdk/attributions)."]]
