Descripción general del SDK de Places para Android (heredado)

Usa esta guía para comprender las diferencias clave entre las versiones del SDK de Places y migrar al SDK de Places para Android (nuevo).

Funciones del SDK disponibles en cada versión

En la siguiente tabla, se muestran las versiones del SDK y de la API que se requieren para cada función del SDK:

Función	Versión de la API de Places	Método de inicialización	Versión mínima del SDK
Autocompletar (nuevo)	API de Places (nuevo)	initializeWithNewPlacesApiEnabled()	3.5.0
Place Details (nuevo)	API de Places (nuevo)	initializeWithNewPlacesApiEnabled()	3.3.0
Nearby Search (nuevo)	API de Places (nuevo)	initializeWithNewPlacesApiEnabled()	3.5.0
Place Photos (nuevo)	API de Places (nuevo)	initializeWithNewPlacesApiEnabled()	3.4.0
Text Search (nuevo)	API de Places (nuevo)	initializeWithNewPlacesApiEnabled()	3.3.0
Place Autocomplete	API de Places (heredada)	initialize() (obsoleto)
Current Place	API de Places (heredada)	initialize() (obsoleto)
Place Details	API de Places (heredada)	initialize() (obsoleto)
Place Photos	API de Places (heredada)	initialize() (obsoleto)

Obsoleto: El método Places.initialize dejó de estar disponible. En su lugar, usa Places.initializeWithNewPlacesApiEnabled(). Ten en cuenta que, para usar Places.initializeWithNewPlacesApiEnabled(), debes habilitar la API de Places (nueva) en tu clave de API en la consola de Google Cloud.

Migra a las nuevas APIs

Para migrar a las nuevas APIs, consulta las siguientes guías de migración:

• Migra a Place Details (nuevo)
• Migra a Place Photos (nuevo)
• Migra a Autocomplete (nuevo)

Mejoras en el SDK de Places para Android (nuevo)

En esta sección, se describen las funciones clave que se agregaron al SDK de Places para Android (nuevo).

Se implementó en la plataforma estándar de Google Cloud

El SDK de Places para Android (nuevo) se implementa en la infraestructura de servicios en Google Cloud. Esta implementación brinda una plataforma más segura y confiable. Este diseño estándar aporta un nivel de coherencia en todos los SDKs que mejora la eficiencia del desarrollo con el SDK de Places para Android (nuevo).

Rendimiento mejorado

El SDK de Places para Android (nuevo) ofrece un rendimiento mejorado, por lo que vale la pena reemplazar las apps que usan el SDK existente.

Nuevas funciones

El SDK de Places para Android (nuevo) incluye las versiones más recientes de todas las funciones del SDK:

• Autocompletar (nuevo)
• Place Details (nuevo)
• Nearby Search (nuevo)
• Place Photos (nuevo)
• Text Search (nuevo)

Text Search (nueva)

Text Search (nuevo) devuelve información sobre un conjunto de lugares en función de una cadena; por ejemplo, "pizza en Nueva York", "tiendas de zapatos cerca de Ottawa" o "Calle principal 123". El servicio responde con una lista de lugares que coinciden con la cadena de texto y con cualquier personalización de ubicación que se haya establecido.

Se agregaron nuevos datos de respuesta a Place Details (nuevo) y Place Photos (nuevo)

• Place Details (nuevo) ahora incluye la nueva clase Review en el objeto de respuesta Place. La clase Place contiene el nuevo método getReviews() para admitir este campo. Llama a getReviews() para devolver hasta cinco opiniones sobre un lugar.

• Place Photos (nuevo) agrega AuthorAttributions a la clase PhotoMetadata. AuthorAttributions contiene un List de objetos AuthorAttribution.

Se agregó una nueva respuesta de URI a Place Photos (nuevo)

Ahora puedes usar Place Photos (New) para devolver un URI a un mapa de bits de imagen. Anteriormente, solo podías devolver el mapa de bits de la imagen.

Precios simplificados

Los precios se simplificaron con el SDK de Places para Android (nuevo) para que solo pagues por los datos que usas. Los precios simplificados se implementan con listas de campos, también llamadas máscaras de campo.

Con Place Details (nuevo) y Text Search (nuevo), puedes usar listas de campos para controlar la lista de campos que se devolverán en la respuesta. Luego, solo se te facturará por los datos solicitados. Usar una lista de campos es una práctica de diseño recomendada para garantizar que no solicites datos innecesarios, lo que ayuda a evitar tiempos de procesamiento y cargos de facturación adicionales.

Para obtener más información sobre los precios, consulta Uso y facturación.

Tipos de lugares expandidos

El nuevo SDK incluye nuevos tipos de lugares, que se muestran como parte de la respuesta de Place Details (nuevo) y Text Search (nuevo). También puedes usar estos tipos nuevos y los existentes en una búsqueda con Text Search (nuevo). Los tipos nuevos se incluyen en la Tabla A.