Introducción
La API de Places (nueva) ofrece un mejor rendimiento y un nuevo modelo de precios, por lo que vale la pena actualizar las apps que usan la API de Places (heredada). Para obtener más detalles sobre la comparación de funciones, consulta Elige tu API.
Usa esta guía para comprender las diferencias clave entre la API de Places (nueva) y la API de Places (heredada), 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)
Para usar las funciones de la API de Places (nueva), 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 clave de API que usa tu app. Para obtener más información, consulta Usa claves de API.
Cambios generales
Estos son algunos cambios generales que se aplican a varias APIs:
- Todas las APIs nuevas admiten tanto las claves de API como los tokens de OAuth como mecanismo de autenticación.
- Solo se admite JSON como formato de respuesta.
- Place Details (nuevo), Nearby Search (nuevo) y Text Search (nuevo) requieren el uso de máscaras de campo para especificar qué campos deseas que se muestren en la respuesta. Para obtener más información, consulta FieldMask.
- Las APIs de Nearby Search (nuevo) y Text Search (nuevo) ahora devuelven los detalles completos del lugar para que coincidan con los detalles del lugar que devuelve Place Details (nuevo).
- El formato de respuesta JSON de las APIs de Place Details (nuevo), Nearby Search (nuevo) y Text Search (nuevo) cambió con respecto al formato de las APIs existentes. Para obtener más detalles, consulta Migra la respuesta de la API de Places.
Cambios específicos de la API
En esta sección, se incluyen las siguientes guías de migración para cada API:
- Migra a la Búsqueda cercana (nuevo)
- Migra a Text Search (nuevo)
- Migra a Place Details (nuevo)
- Migra a Place Photos (nuevo)
- Migrate to Autocomplete (New)