Referencia rápida del SDK de Places para Android

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

Paquetes oficiales del SDK de Places para Android:

  • maven: com.google.android.libraries.places:places

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.Field en la lista de campos SearchNearbyRequest. 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 con Places.initializeWithNewPlacesApiEnabled(). Consulta /maps/documentation/places/android-sdk/legacy/migrate-overview.
  • Problema: El Place que muestra fetchPlace() no tiene PhotoMetadata (por lo que no hay nada que resolver) cuando la lista de campos omite PHOTO_METADATAS. Solución: Incluye Place.Field.PHOTO_METADATAS en la lista de campos. Dado que fetchResolvedPhotoUri() 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, PhotoMetadata y Review. 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() y awaitFindCurrentPlace() (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 clases FindCurrentPlaceRequest/FindCurrentPlaceResponse en la versión 6.0.2. Consulta la guía de migración.
  • PlacesClient.fetchPhoto() y awaitFetchPhoto(): 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 clases FetchPhotoRequest/FetchPhotoResponse en 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) o PlacesClient.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ó AutocompleteSupportFragment en 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

SDK de Places para Android: Places

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