Referencia rápida de la API de Places (heredada)

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

API de Places (heredada): Errores comunes

  • Problema: Si una solicitud de Place Details (heredada) omite el parámetro fields o no especifica ningún campo, la API devuelve todos los campos y te los factura. Solución: Configura siempre el parámetro fields o 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 fields para 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_reference y puede vencer, por lo que las referencias almacenadas dejan de funcionar. Solución: Obtén un photo_reference nuevo 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_DENIED con 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: Campo business_status. Consulta la guía de migración.
  • Campo de respuesta reference: Obsoleto desde el 3 de septiembre de 2019. Reemplazo: Campo place_id. Consulta la guía de migración.
  • Parámetro de solicitud name de Nearby Search (heredado): Obsoleto. Reemplazo: Parámetro keyword. Consulta la guía de migración.