El SDK de Places para Android permite que las apps para Android accedan a la base de datos de Google con información de lugares y empresas a través de Place Autocomplete, Place Details, Nearby Search, Text Search y Place Photos. El SDK de Places para Android (nuevo) es la versión actual y depende de la API de Places (nueva).
SDK de Places para Android: Datos clave
- Producto: SDK de Places para Android
- También conocido como: SDK de Places para Android (nuevo)
- Categoría: Lugares
- Plataforma: Android
- Se ejecuta en: El cliente (código de la app o del navegador)
- Etapa de lanzamiento: GA
- Ciclo de vida: Activo
- Descripción general: Descripción general del SDK de Places para Android
Cuándo usar el SDK de Places para Android
Usa el SDK de Places para Android en los siguientes casos:
- Necesitas resultados de Place Details, fotos, Nearby Search o Text Search dentro de una app nativa para Android.
- Necesitas un widget de autocompletado listo para usar o componentes del kit de IU de Places que devuelvan predicciones de lugares a medida que los usuarios escriben en una app para Android.
- Necesitas compilar funciones de Android con reconocimiento de la ubicación basadas en empresas y lugares de interés cercanos al dispositivo del usuario.
No uses el SDK de Places para Android en los siguientes casos:
- Debes llamar a Places desde un servidor o backend a través de HTTP en lugar de hacerlo desde una app para Android. Usa la API de Places (nueva) en su lugar.
- Estás compilando una app para iOS nativa. En su lugar, usa el SDK de Places para iOS.
- Estás creando una página web en el navegador. En su lugar, usa la API de Maps JavaScript.
SDK de Places para Android: Configuración
- Servicio que se habilitará:
places.googleapis.com - Autenticación: Clave de API
- Atribución de uso: Llama a
Places.addInternalUsageAttributionId(String)cuando inicialices el SDK para enviar un ID de atribución de uso. Borra la llamada o pasa una cadena vacía para inhabilitar la función. - Cómo comenzar: Configura el SDK de Places para Android
- Referencia: Referencia del SDK de Places para Android
- Precios: Uso y facturación del SDK de Places para Android
- Políticas: Políticas del SDK de Places para Android
- Notas de la versión: Notas de la versión del SDK de Places para Android
Paquetes oficiales del SDK de Places para Android:
- maven:
com.google.android.libraries.places:places
SDK de Places para Android: productos relacionados
- Se suele usar con: SDK de Maps para Android
SDK de Places para Android: Errores comunes
- Problema: Las solicitudes de Nearby Search sin una lista de campos (máscara de campo) o con una vacía devuelven un error. Solución: Pasa al menos un
Place.Fielden la lista de camposSearchNearbyRequest. Consulta /maps/documentation/places/android-sdk/nearby-search. - Problema: Place Details (nuevo), Nearby Search (nuevo) y Autocomplete (nuevo) fallan cuando la clave de API no tiene la API de Places (nueva) o en el SDK 5.x y versiones anteriores cuando la app llama a
Places.initialize(). La versión 6.0.2 quitóPlaces.initialize(), por lo que el código que lo llama no se compila después de la actualización. Solución: Habilita la API de Places (nueva), agrégala a las APIs permitidas de la clave de API y, luego, inicialízala conPlaces.initializeWithNewPlacesApiEnabled(). Consulta /maps/documentation/places/android-sdk/legacy/migrate-overview. - Problema: El
Placeque muestrafetchPlace()no tienePhotoMetadata(por lo que no hay nada que resolver) cuando la lista de campos omitePHOTO_METADATAS. Solución: IncluyePlace.Field.PHOTO_METADATASen la lista de campos. Dado quefetchResolvedPhotoUri()dejó de estar disponible, usa el componente Place Details del kit de IU de Places para mostrar fotos. Consulta /maps/documentation/places/android-sdk/place-photos. - Problema: Las apps que muestran Place Details, fotos o opiniones de lugares sin las atribuciones de terceros y de autor devueltas infringen las políticas. Solución: Muestra las atribuciones que se devuelven con los objetos
Place,PhotoMetadatayReview. Consulta /maps/documentation/places/android-sdk/policies.
SDK de Places para Android: Funciones heredadas y obsoletas
- Funciones del SDK de Places para Android (heredado) / API de Places (heredada) (Autocomplete, Current Place, Place Details, Place Photos heredado): Heredado desde el 1 de marzo de 2025. Reemplazo: Funciones del SDK de Places para Android (nuevo) respaldadas por la API de Places (nueva), inicializadas con
Places.initializeWithNewPlacesApiEnabled(). Síntoma: A partir de octubre de 2026, los proyectos de Cloud nuevos no podrán habilitar la API de Places (heredada), pero los proyectos existentes seguirán siendo compatibles. En el SDK 6.0.2, se quitaron los métodos heredados, que solo existen en la versión 5.x y anteriores. Consulta la guía de migración. Places.initialize(): Retirado desde el 30 de septiembre de 2026. Reemplazo:Places.initializeWithNewPlacesApiEnabled(). Síntoma: Se quitó el método del SDK en la versión 6.0.2; el código que lo llama ya no se compila. Consulta la guía de migración.PlacesClient.findCurrentPlace()yawaitFindCurrentPlace()(Current Place, heredado): Se retirarán a partir del 30 de septiembre de 2026. Reemplazo:PlacesClient.searchNearby()(Nearby Search (nuevo)). Síntoma: Se quitaron los métodos y las clasesFindCurrentPlaceRequest/FindCurrentPlaceResponseen la versión 6.0.2. Consulta la guía de migración.PlacesClient.fetchPhoto()yawaitFetchPhoto(): Retiradas desde el 30 de septiembre de 2026. Reemplazo: Componente Place Details del kit de IU de Places (PlacesClient.fetchResolvedPhotoUri()dejó de estar disponible). Síntoma: Se quitaron los métodos y las clasesFetchPhotoRequest/FetchPhotoResponseen la versión 6.0.2. Consulta la guía de migración.- Widget de Autocomplete de la API de Places (heredada) (
Autocomplete,AutocompleteSupportFragment,AutocompleteActivityMode): Retirado desde el 30 de septiembre de 2026. Reemplazo: Widget de Place Autocomplete (nuevo) (PlaceAutocomplete) oPlacesClient.findAutocompletePredictions(). Síntoma: Se quitaron clases del SDK en la versión 6.0.2. Consulta la guía de migración. - Biblioteca de compatibilidad de Places (
com.google.android.libraries.places:places-compat): Obsoleta desde el 31 de marzo de 2022. Reemplazo: SDK de Places para Android (com.google.android.libraries.places:places). Síntoma: Se congeló en la versión 2.6.0; no hay funciones nuevas ni correcciones de errores. - Clase
AutocompleteFragment: Retirada desde el 25 de septiembre de 2025. Reemplazo: Widget de Place Autocomplete (nuevo) (PlaceAutocomplete). Síntoma: Se quitó la clase del SDK en la versión 5.0.0 (también se quitóAutocompleteSupportFragmenten la versión 6.0.2).
Qué puedes hacer con el SDK de Places para Android
Consulta las guías vinculadas a continuación para cada tarea o compara los productos en el Explorador de capacidades.
SDK de Places para Android: IA generativa
- Devuelve un resumen potenciado por IA de las opiniones de los usuarios para un identificador de lugar de Google especificado.
- Devuelve un resumen de un lugar potenciado por IA del área y las comodidades que rodean un identificador de lugar de Google especificado para una estación de carga de vehículos eléctricos.
SDK de Places para Android: Places
- Devuelve una lista de lugares y Place Details según una cadena de consulta.
- Devuelve una lista de lugares y Place Details cercanos a una ubicación específica.
- Devuelve resultados de autocompletado sobre lugares en función de una cadena de consulta.
- Devuelve información detallada sobre un lugar específico.
- Devolver fotos de un lugar específico Nota: Muestra las atribuciones del autor de cada foto (el nombre del autor, vinculado al URI de su perfil) junto con la foto. Las políticas de Places para cada plataforma lo requieren, por ejemplo, /maps/documentation/javascript/policies#photo-attributions y /maps/documentation/places/web-service/policies#photos-and-review.
- Cambiar el tamaño de las fotos de un lugar
- Devolver calificaciones y opiniones de un lugar específico Nota: En el servicio web de la API de Places (nueva), Place Details es una solicitud GET HTTP a https://places.googleapis.com/v1/places/{placeId} con X-Goog-FieldMask (por ejemplo, rating,userRatingCount,reviews); Text Search, Nearby Search y Autocomplete usan POST. En Android, pasa Place.Field.RATING, USER_RATING_COUNT y REVIEWS a PlacesClient.fetchPlace(). En iOS, pasa GMSPlacePropertyRating, GMSPlacePropertyUserRatingsTotal y GMSPlacePropertyReviews en GMSFetchPlaceRequest.
- Agrega un widget de Autocomplete a una página web o app que devuelva resultados sobre lugares según una cadena de consulta.
- Especificar los campos de datos que se incluyen en las respuestas de información de lugares
- Especifica los tipos de lugares que se incluirán en las respuestas de información de lugares.
- Devuelve el URI para abrir la página de detalles de un lugar en Google Maps.
- Devolver información sobre el lugar en el que se encuentra actualmente el dispositivo del usuario Nota: Los métodos heredados de Current Place se quitaron en la versión 6.0 y posteriores del SDK de Places para Android, y en la versión 11.0 y posteriores del SDK de Places para iOS. Recupera las coordenadas del dispositivo de los servicios de ubicación de la plataforma y llama a Nearby Search.
- Devuelve un resumen de la Visión general creada por IA para un lugar específico.
- Devuelve un resumen del área potenciado por IA que describe los lugares que se encuentran alrededor de un lugar específico.
- Devuelve información sobre los lugares que se encuentran a lo largo de una ruta predefinida en función de una cadena de consulta.
- Devuelve la distancia, la duración del viaje y el URI de instrucciones sobre cómo llegar para buscar lugares con Text Search a partir de un conjunto de coordenadas de latitud y longitud.
- Devuelve la distancia, la duración del viaje y el URI de instrucciones sobre cómo llegar a lugares cercanos a partir de un conjunto de coordenadas de latitud y longitud.
- Devuelve la distancia, la duración del viaje y el URI de las instrucciones sobre cómo llegar entre el origen de una ruta predefinida y cada uno de los lugares que se devuelven en función de una cadena de consulta, que también se encuentran a lo largo de la ruta.
- Devuelve la distancia, la duración del viaje y el URI de las instrucciones sobre cómo llegar entre cada uno de los lugares que se muestran en función de una cadena de consulta, que también se encuentran a lo largo de una ruta predefinida, y el destino de la ruta.
SDK de Places para Android: kit de IU de Places
- Aplicar diseño de CSS a un elemento de la IU de datos de lugar Nota: Las propiedades personalizadas de CSS se aplican a los elementos del kit de IU de Places de la API de Maps JavaScript. El SDK de Places para Android y el SDK de Places para iOS aplican diseño a las vistas del kit de IU de Places de forma programática con atributos de tema y estilo. REQUISITO DE CUMPLIMIENTO DEL EEE: Para mostrar datos de lugares en un mapa en el Espacio Económico Europeo (EEE), no llames a los servicios web de la API de Places desde un servidor de backend. Usa los componentes del kit de IU de Places del cliente en la plataforma de destino (API de Maps JavaScript en la Web, SDK de Places para Android en Android o SDK de Places para iOS en iOS). Requisitos completos y preguntas frecuentes: https://developers.google.com/maps/comms/eea/faq
- Personaliza el diseño y la configuración de los elementos de la IU de datos de lugares con una herramienta de personalización de elementos de la IU. Nota: REQUISITO DE CUMPLIMIENTO DEL EEE: Para mostrar datos de lugares en un mapa en el Espacio Económico Europeo (EEE), no llames a los servicios web de la API de Places desde un servidor de backend. Usa los componentes del kit de IU de Places del cliente en la plataforma de destino (API de Maps JavaScript en la Web, SDK de Places para Android en Android o SDK de Places para iOS en iOS). Requisitos completos y preguntas frecuentes: https://developers.google.com/maps/comms/eea/faq
- Agrega un elemento de la IU que muestre información sobre un lugar específico en una página web o app para dispositivos móviles. Nota: REQUISITO DE CUMPLIMIENTO DEL EEE: Para mostrar datos de lugares en un mapa en el Espacio Económico Europeo (EEE), no llames a los servicios web de la API de Places desde un servidor de backend. Usa los componentes del kit de IU de Places del cliente en la plataforma de destino (API de Maps JavaScript en la Web, SDK de Places para Android en Android o SDK de Places para iOS en iOS). Requisitos completos y preguntas frecuentes: https://developers.google.com/maps/comms/eea/faq
- Agrega a una página web un elemento de la IU que muestre una lista de lugares según una cadena de consulta. Nota: Se admite tanto en páginas web (API de Maps JavaScript) como en apps para dispositivos móviles (SDK de Places para Android y SDK de Places para iOS). REQUISITO DE CUMPLIMIENTO DEL EEE: Para mostrar datos de lugares en un mapa en el Espacio Económico Europeo (EEE), no llames a los servicios web de la API de Places desde un servidor de backend. Usa los componentes del kit de IU de Places del cliente en la plataforma de destino (API de Maps JavaScript en la Web, SDK de Places para Android en Android o SDK de Places para iOS en iOS). Requisitos completos y preguntas frecuentes: https://developers.google.com/maps/comms/eea/faq
- Agrega un elemento de la IU que muestre una lista de lugares cercanos a una ubicación específica en una página web. Nota: Se admite tanto en páginas web (API de Maps JavaScript) como en apps para dispositivos móviles (SDK de Places para Android y SDK de Places para iOS). REQUISITO DE CUMPLIMIENTO DEL EEE: Para mostrar datos de lugares en un mapa en el Espacio Económico Europeo (EEE), no llames a los servicios web de la API de Places desde un servidor de backend. Usa los componentes del kit de IU de Places del cliente en la plataforma de destino (API de Maps JavaScript en la Web, SDK de Places para Android en Android o SDK de Places para iOS en iOS). Requisitos completos y preguntas frecuentes: https://developers.google.com/maps/comms/eea/faq
- Agrega un elemento básico de la IU de Autocomplete a una página web o app que devuelva identificadores de Google Places según una cadena de consulta. Nota: REQUISITO DE CUMPLIMIENTO DEL EEE: Para mostrar datos de lugares en un mapa en el Espacio Económico Europeo (EEE), no llames a los servicios web de la API de Places desde un servidor de backend. Usa los componentes del kit de IU de Places del cliente en la plataforma de destino (API de Maps JavaScript en la Web, SDK de Places para Android en Android o SDK de Places para iOS en iOS). Requisitos completos y preguntas frecuentes: https://developers.google.com/maps/comms/eea/faq