El SDK de Places te permite buscar y recuperar información de una variedad de tipos de lugares con una cadena de texto o por proximidad. El SDK de Places es la versión heredada del SDK de Places (nuevo).
Usa esta guía para comprender las diferencias clave entre las versiones del SDK de Places y migrar al SDK de Places (nuevo).
Funciones del SDK disponibles en cada versión
En la siguiente tabla, se muestran las versiones de SDK y API que se requieren para cada función del SDK:
| Función | API de Places habilitada en la clave de API | 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 (versión nueva) | API de Places (nuevo) | initializeWithNewPlacesApiEnabled() |
3.4.0 |
| Búsqueda de texto (nueva) | API de Places (nuevo) | initializeWithNewPlacesApiEnabled() |
3.3.0 |
| Place Autocomplete | API de Places | initialize() |
|
| Current Place | API de Places | initialize() |
|
| Place Details | API de Places | initialize() |
|
| Place Photos | API de Places | initialize() |
Migra a las nuevas APIs
Para migrar a las APIs nuevas, consulta las siguientes guías de migración:
- Cómo migrar a Place Details (nuevo)
- Cómo migrar a Place Photo (nueva)
- Cómo migrar 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 brinda un nivel de coherencia entre 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) proporciona un mejor rendimiento, 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 (versión nueva)
- Búsqueda de texto (nueva)
Nuevo servicio de Text Search
Text Search (nueva) muestra información sobre un conjunto de lugares en función de una cadena; por ejemplo, "pizza en Buenos Aires", "tiendas de zapatos cerca de Santiago" 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 Placed Details (nuevo) y Place Photos (nuevo)
Place Details (nuevo) ahora incluye la nueva clase Review en el objeto
Placede la respuesta. La clase Place contiene el nuevo métodogetReviews()para admitir este campo. Llama agetReviews()para mostrar hasta cinco opiniones de un lugar.Place Photo (nuevo) agrega
AuthorAttributionsa la clasePhotoMetadata.AuthorAttributionscontiene unListde objetosAuthorAttribution.
Se agregó una nueva respuesta de URI a las fotos de lugares (nueva)
Ahora puedes usar Colocar foto (Nuevo) para mostrar un URI a un mapa de bits de imagen. Anteriormente, solo podías mostrar el mapa de bits de la imagen.
Precios simplificados
Los precios se simplifican 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 y Text Search, puedes usar listas de campos para controlar la lista de campos que se mostrarán en la respuesta. Solo se te factura 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 información detallada sobre los precios de ambos SDKs, consulta Uso y facturación.
Tipos de lugares expandidos
El nuevo SDK incluye nuevos tipos de lugares, que se muestran como parte de las respuestas de Place Details y Text Search. También puedes usar estos tipos nuevos y los existentes en una búsqueda con la Búsqueda de texto. Los tipos nuevos se incluyen en la Tabla A.