A partir de octubre de 2026, ya no se podrá habilitar la API de Places (heredada) para proyectos nuevos de Google Cloud. Los proyectos existentes siguen siendo totalmente compatibles. Para obtener funciones nuevas y un mejor rendimiento, migra a la API de Places (nueva).
API de Places (heredada): Datos clave
- Producto: API de Places (heredada)
- También se conoce como: API de Places (servicio web heredado), servicio web de la API de Places (maps/api/place)
- Categoría: Lugares
- Plataforma: Servicio web (REST)
- Se ejecuta en: Servidor (código de backend)
- Etapa de lanzamiento: GA
- Ciclo de vida: Heredado
- Reemplazada por: API de Places (nueva)
- Descripción general: Descripción general de la API de Places (heredada)
API de Places (heredada): Cuándo usarla
Usa la API de Places (heredada) en los siguientes casos:
- Mantienes un proyecto existente que ya tiene habilitada la API de Places (heredada) y llama a los extremos de
maps.googleapis.com/maps/api/place. - Necesitas que las llamadas existentes a Find Place, Nearby Search, Text Search, Details, Photos o Autocomplete (heredadas) sigan funcionando mientras realizas la migración.
No uses la API de Places (heredada) en los siguientes casos:
- Estás iniciando un proyecto nuevo de Google Cloud. A partir de octubre de 2026, no se podrá habilitar la API de Places (heredada) para proyectos nuevos. En su lugar, usa la API de Places (nueva).
- Necesitas funciones nuevas, autenticación de OAuth o máscaras de campo en Nearby Search y Text Search para pagar solo por los campos que solicitas. En su lugar, usa la API de Places (nueva).
- Necesitas Find Place (heredado) o Query Autocomplete (heredado) en el código nuevo. Text Search (nuevo) y Autocomplete (nuevo) los reemplazan. En su lugar, usa la API de Places (nueva).
API de Places (heredada): Configuración
- Servicio que se habilitará:
places-backend.googleapis.com - Autenticación: Clave de API
- Precios: Uso y facturación de la API de Places (heredada)
- Políticas: Políticas de la API de Places (heredada)
API de Places (heredada): Errores comunes
- Problema: Si una solicitud de Place Details (heredada) omite el parámetro
fieldso no especifica ningún campo, la API devuelve todos los campos y te los factura. Solución: Configura siempre el parámetrofieldso migra a Place Details (nuevo) con una máscara de campo. Consulta /maps/documentation/places/web-service/legacy/details. - Problema: Nearby Search (heredada) y Text Search (heredada) no admiten que se especifiquen los campos que se devuelven. Siempre devuelven un conjunto fijo de campos (un subconjunto de campos de Place Details) y activan los SKUs de Basic Data, Contact Data y Atmosphere Data. Solución: Migra a Nearby Search (nuevo) o Text Search (nuevo) con una máscara de campo, o bien usa Find Place (heredado) con el parámetro
fieldspara solicitar y pagar solo por los campos que necesitas. Consulta /maps/billing-and-pricing/sku-details/legacy#places_nearby-search-legacy-pro-sku. - Problema: No se puede almacenar en caché un
photo_referencey puede vencer, por lo que las referencias almacenadas dejan de funcionar. Solución: Obtén unphoto_referencenuevo de una respuesta de Place Details, Find Place, Nearby Search o Text Search antes de solicitar una foto. Consulta /maps/documentation/places/web-service/legacy/photos. - Problema: Las llamadas a la API de Places (heredada) desde un proyecto que no la tiene habilitada devuelven
REQUEST_DENIEDcon el mensaje de error "Estás llamando a una API heredada, que no está habilitada para tu proyecto…". (LegacyApiNotActivatedMapError). A partir de octubre de 2026, no se podrá habilitar la API de Places (heredada) para proyectos nuevos. Solución: Usa la API de Places (nueva) para los proyectos nuevos y migra las apps existentes. Mientras realizas la migración, puedes solicitar la activación a corto plazo de la API heredada a través del formulario de comentarios que se encuentra en la página de la API heredada. Consulta /maps/legacy#LegacyApiNotActivatedMapError.
API de Places (heredada): funciones heredadas y obsoletas
- Campo de respuesta
permanently_closed: Obsoleto desde el 26 de mayo de 2020. Reemplazo: Campobusiness_status. Consulta la guía de migración. - Campo de respuesta
reference: Obsoleto desde el 3 de septiembre de 2019. Reemplazo: Campoplace_id. Consulta la guía de migración. - Parámetro de solicitud
namede Nearby Search (heredado): Obsoleto. Reemplazo: Parámetrokeyword. Consulta la guía de migración.