El SDK de Places para Android (nuevo) ofrece un rendimiento mejorado y un nuevo modelo de precios, lo que hace que valga la pena actualizar las apps que usan el SDK de Places para Android (heredado). Para obtener más detalles sobre la comparación de funciones, consulta Elige tu SDK.
Usa esta guía para comprender las diferencias clave entre el SDK de Places para Android (nuevo) y el SDK de Places para Android (heredado), además de cómo controlar los cambios necesarios.
Prácticas recomendadas de facturación para la migración
Esta guía se aplica si el uso de la API es lo suficientemente alto como para pasar a los precios de segundo nivel. Cuando migras a una versión más reciente de una API, también se te factura un SKU diferente. Para evitar aumentos en los costos durante el mes de tu transición, te recomendamos que cambies a las nuevas APIs en producción lo más cerca posible del comienzo del mes. Esto garantizará que alcances los niveles de precios mensuales más rentables durante el mes de la migración. Para obtener información sobre los niveles de precios, consulta la página de precios y las preguntas frecuentes sobre precios.
Habilita la API de Places (nueva)
El SDK de Places para Android (heredado) se basa en el servicio de la API de Places. Para usar las funciones del SDK de Places para Android (nuevo), primero debes habilitar la API de Places (nueva) en tu proyecto de Google Cloud. Para obtener más información, consulta Configura tu proyecto de Google Cloud.
Luego, debes asegurarte de haber agregado la API de Places (nueva) a la lista de APIs autorizadas en la clave que usa tu app. Para obtener más información, consulta Usa claves de API.
Asegúrate de tener suficiente cuota en la API de Places (nueva)
Asegúrate de que haya suficiente cuota en la API de Places (nueva) para cubrir tu tráfico actual. Para revisar y administrar tus cuotas y límites de uso, consulta Cuotas y alertas de cuota.
Ten en cuenta la diferencia:
- La cuota del SDK de Places para Android (heredado) depende de la cuota del servicio de la API de Places. Es la suma de todos los métodos de la API de Places.
- La cuota del SDK de Places para Android (nuevo) depende de la cuota del servicio de la API de Places (nuevo). Existe una cuota independiente para cada método de la API.
Verifica si tu acuerdo negociado incluye la API de Places (nueva)
Si tienes un acuerdo negociado, verifica que incluya la API de Places (nueva) con los precios esperados. De lo contrario, comunícate con tu contacto de ventas en Google o con tu socio para analizar cómo puedes incluir esta API.
Cambios generales
Estos son algunos cambios generales que se aplican a varias APIs:
Utiliza un nuevo modelo de precios. Para obtener información sobre los precios de todas las APIs, consulta SDK de Places para Android (nuevo).
Debes inicializar tu app llamando al método
Places.initializeWithNewPlacesApiEnabled(). Para obtener más información sobre cómo seleccionar el servicio de la API de Places, consulta Configura tu proyecto de Google Cloud.Place Details (nuevo), Nearby Search (nuevo) y Text Search (nuevo) requieren máscaras de campo para especificar qué campos deseas que se muestren en la respuesta.
Se agregaron clases nuevas para definir las solicitudes o agregar campos nuevos a la respuesta.
El objeto de respuesta
Placecontiene el nuevo métodogetReviews()que devuelve una lista de objetosReview. Cuando tu app muestre información obtenida del objetoPlace, como fotos y opiniones, también deberá mostrar las atribuciones requeridas.Para obtener más información, consulta la documentación sobre las atribuciones.
Cambios específicos de la API
En esta sección, se incluyen las siguientes guías de migración para cada API:
- Migra de Place Details (heredado) a Place Details (nuevo)
- Migra de Place Photo (heredado) a Place Photo (nuevo)
- Migra de Autocomplete (heredado) a Autocomplete (nuevo)
- Migra de Current Place (heredado) a Nearby Search (nuevo)