Índice
La API de Google Places Ofrece funciones de búsqueda de lugares, autocompletado, descubrimiento de lugares cercanos, información sobre empresas y otras funciones basadas en la ubicación. El verdadero reto consiste en decidir qué servicio de «Lugares» se adapta mejor a la tarea, qué campos merece la pena solicitar y cómo esas decisiones afectan al coste.
El cambio de Google hacia la API de Places (nueva) modifica la forma en que los desarrolladores gestionan las solicitudes, la selección de campos, los datos de respuesta y la facturación. Los patrones de implementación anteriores no siempre se trasladan sin problemas, sobre todo cuando entran en juego las máscaras de campos y los precios basados en SKU.
La configuración adecuada depende de lo que estés desarrollando. Una búsqueda de ubicaciones dentro de una aplicación puede que solo necesite un pequeño conjunto de datos sobre los lugares. Un equipo que utilice el API de Google Places para la generación de clientes potenciales En muchas ciudades puede ser necesario un flujo de trabajo diferente. Tratar ambos casos de uso de la misma manera puede suponer un coste innecesario y un trabajo adicional con la API.
Antes de elegir un punto final o estimar el uso mensual, resulta útil comprender cómo estructura Google la búsqueda en Places, la selección de campos, la facturación y las cuotas. Esas decisiones también facilitan determinar cuándo la API oficial de Places es la más adecuada para la tarea y cuándo tiene más sentido utilizar un flujo de trabajo independiente para los datos empresariales.
Respuesta rápida: Cómo funciona la API de Google Places
- Busca lugares con la búsqueda por texto o la búsqueda de lugares cercanos.
- Consigue información detallada, fotos e identificadores de lugar (Place ID) de ubicaciones concretas.
- Utiliza la función de autocompletado para sugerir lugares a medida que los usuarios escriben.
- Configura un proyecto de Google Cloud, la facturación y una clave de API restringida.
- Utiliza las máscaras de campo para controlar los datos devueltos y la facturación.
- Los costes dependen del servicio, de los campos solicitados y del uso que se le dé.
- En el caso de grandes volúmenes de datos empresariales o campos de contacto adicionales, es posible que resulte más adecuado un flujo de trabajo de datos diferente.
¿Qué es la API de Google Places?
La API de Google Places forma parte de Google Maps Platform. Ofrece a los desarrolladores acceso programático a información sobre empresas, puntos de interés, direcciones, ubicaciones geográficas y otros lugares que figuran en la base de datos de lugares de Google.
Google afirma actualmente que API de lugares (nueva) proporciona datos de ubicación de más de 200 millones de lugares. Los desarrolladores pueden utilizarlo para añadir funciones de búsqueda de lugares, descubrimiento de lugares cercanos, autocompletado, información detallada sobre los lugares y fotos a sitios web, aplicaciones móviles y otro tipo de software.
Una solicitud típica comienza con una consulta de búsqueda, una zona geográfica o un Place ID conocido. Google devuelve información estructurada sobre el lugar en función del tipo de solicitud y de los campos seleccionados por el desarrollador.
Por ejemplo, una aplicación para buscar restaurantes podría utilizar la «Búsqueda cercana» para encontrar restaurantes en las inmediaciones de la ubicación del usuario. Una vez que el usuario selecciona un restaurante, la aplicación podría solicitar los «Detalles del lugar» para obtener información como su dirección, valoración, horario de apertura, número de teléfono o opiniones.
¿Qué datos puede devolver la API de Google Places?
Los campos disponibles dependen de la solicitud y de los campos incluidos en la máscara de campos. La API de lugares (nueva) puede devolver información como:
| Tipo de datos | Campos de ejemplo | Qué describe |
|---|---|---|
| Identidad | Nombre del lugar, ID del lugar, tipo de lugar | Identifica el lugar y su categoría. |
| Ubicación | Dirección, coordenadas geográficas | Indica dónde se encuentra el lugar. |
| Datos de la empresa | Situación de la empresa, número de teléfono, página web, horario de apertura | Proporciona información operativa y de contacto. |
| Información sobre el cliente | Valoraciones, opiniones e información sobre precios | Proporciona datos relacionados con valoraciones, reseñas y precios. |
| Medios de comunicación | Fotos | Devuelve las imágenes disponibles asociadas al lugar. |
| Accesibilidad | Información sobre accesibilidad | Describe las funciones de accesibilidad compatibles. |
| Opciones de servicio | Entrega a domicilio, servicio en el local, recogida en la acera | Muestra las opciones de servicio disponibles cuando sea posible. |
Google agrupa estos campos en diferentes niveles de precios. Algunos campos básicos se incluyen en SKU de menor coste, mientras que otros, como las valoraciones, los horarios de apertura y las reseñas, pueden dar lugar a SKU de mayor precio. Google explica la relación entre los campos y la facturación en su Documentación sobre los campos de datos de la API de Places. Solicita únicamente los campos que necesite la aplicación, ya que la selección de campos puede modificar el SKU de facturación.
La API de lugares (nueva) también requiere una máscara de campo para las solicitudes de «Detalles del lugar», «Búsqueda de texto» y «Búsqueda cercana». Se debe especificar al menos un campo. Una solicitud sin máscara de campo devuelve un error.
Cómo se integra la API de Lugares en Google Maps Platform
La API de lugares gestiona la información sobre lugares, pero solo es una parte de Google Maps Platform.
Un desarrollador puede utilizar la API de Places para buscar un negocio y, a continuación, utilizar otro servicio de Google Maps Platform para una tarea diferente. Por ejemplo, la API de geocodificación puede convertir una dirección en coordenadas, mientras que los servicios de cálculo de rutas pueden calcular las indicaciones o los tiempos de desplazamiento entre ubicaciones.
Dentro de la propia API de Places, los principales servicios se encargan de diferentes partes del proceso de búsqueda de lugares:
- Búsqueda de texto busca lugares a partir de consultas escritas.
- Búsqueda en las cercanías localiza lugares dentro de una zona geográfica definida.
- Detalles del lugar obtiene información sobre un lugar conocido.
- Autocompletar sugiere lugares a medida que el usuario escribe.
- Subir fotos Recupera las imágenes disponibles asociadas a un lugar.
Google recomienda utilizar Detalles del lugar cuando ya se conoce el identificador del lugar, ya que no es necesario realizar otra solicitud de búsqueda para ese mismo lugar.
Una búsqueda de negocios en una ciudad, un cuadro de autocompletado y una solicitud de información sobre una ubicación concreta requieren, cada una de ellas, un método diferente de la API de Places.
Cómo funciona la API de Google Places
La API de Google Places utiliza distintos métodos en función de la información de la que ya dispongas y del tipo de datos sobre lugares que necesites.
Una consulta escrita, un conjunto de coordenadas y un ID de lugar conocido requieren, cada uno, un método diferente. La API de lugares (nueva) ofrece actualmente búsqueda de texto, búsqueda cercana, detalles del lugar, autocompletado y fotos del lugar para estas tareas.
Búsqueda de texto
La búsqueda de texto permite encontrar lugares a partir de una consulta escrita, como el nombre de un negocio, una categoría, una dirección o una frase como pizza in New York.
La búsqueda de texto (nueva) utiliza una solicitud HTTP POST y devuelve los objetos «Place» que coincidan. Los parámetros opcionales permiten filtrar los resultados por ubicación, tipo de lugar, horario de apertura, valoración o nivel de precios.
Actualmente, Google muestra hasta 60 resultados en todas las páginas y señala que es posible que consultas idénticas no siempre arrojen la misma lista.
Búsqueda en las cercanías
La búsqueda cercana permite encontrar lugares dentro de un área geográfica definida.
La solicitud utiliza la latitud, la longitud y el radio, y luego filtra los resultados por uno o varios tipos de lugares. Por ejemplo, una aplicación podría buscar restaurantes que se encuentren a una distancia determinada de un hotel.
La búsqueda cercana (nueva) también utiliza HTTP POST y requiere una máscara de campo para los datos devueltos.
Detalles del lugar
«Detalles del lugar» recupera información sobre un lugar conocido utilizando su ID de lugar.
Un proceso habitual es el siguiente:
- Busca un lugar con la búsqueda por texto, la búsqueda de lugares cercanos o la función de autocompletado.
- Conserva su identificador de lugar.
- Solicita únicamente los datos que necesite la aplicación.
De este modo, se evita realizar otra búsqueda cuando ya se ha identificado el lugar.
Autocompletar
La función de autocompletado sugiere lugares mientras el usuario escribe en un campo de búsqueda.
Un token de sesión permite agrupar las solicitudes del usuario en una única sesión de búsqueda a efectos de facturación. Cada nueva búsqueda debe utilizar un token nuevo, y la sesión debe finalizar con una solicitud de «Detalles del lugar» o de «Validación de dirección» compatible.
Fotos de lugares e identificadores de lugares
«Fotos de lugares» recupera las imágenes asociadas a un lugar cuando el photos El campo lo devuelven las funciones «Búsqueda de texto», «Búsqueda cercana» o «Detalles del lugar».
Los identificadores de lugar identifican lugares concretos para que se pueda hacer referencia a ellos de nuevo en todos los servicios compatibles de Google Maps Platform.
Por ejemplo, una aplicación puede encontrar un negocio mediante la búsqueda por texto, guardar su Place ID y, más tarde, solicitar los detalles del lugar sin tener que repetir la búsqueda original.
API de lugares (nueva) frente a API de lugares (antigua)
Google pasó la API de Places original al estado «Legacy» el 1 de marzo de 2025. Los proyectos existentes aún pueden utilizarla, pero los nuevos proyectos de Cloud no pueden habilitar los servicios «Legacy».
La API de Places (Nueva) es ahora la versión que recomienda Google para los nuevos proyectos de desarrollo. Los cambios afectan a los métodos de solicitud, la selección de campos, la estructura de la respuesta, la autenticación y la facturación.
¿Qué ha cambiado en la API de Places (novedades)?
La búsqueda de texto y la búsqueda cercana utilizan ahora HTTP POST en lugar del patrón basado en GET que utilizaba la versión anterior.
La API de lugares (nueva) también admite claves de API y OAuth, devuelve respuestas en formato JSON y requiere máscaras de campo para los detalles del lugar, la búsqueda de texto y la búsqueda de lugares cercanos.
«Find Place» no tiene una nueva versión directa. Google redirige esas búsquedas a «Text Search».
Máscaras de campo y cambios en las respuestas
Las máscaras de campo son una de las principales diferencias entre la API de Places (nueva) y la API anterior.
En el caso de «Detalles del lugar», «Búsqueda de texto» y «Búsqueda cercana», la solicitud debe especificar al menos un campo que se vaya a devolver. Si no se incluye la máscara de campo, la solicitud fallará.
La selección de campos también afecta a la facturación, ya que Google asigna campos de datos de ubicación a diferentes SKU. En la sección sobre precios, más adelante en este artículo, se explica esa relación con más detalle.
Los objetos de respuesta también han cambiado. La API de Places (nueva) utiliza nombres de campos en «camelCase» en lugar de muchos de los nombres en «snake_case» que se encontraban en las respuestas de la versión anterior.
Algunos ejemplos son:
dirección_formateadase convierte endirección con formatobusiness_statusse convierte enestado de la empresanúmero_de_teléfono_formateadose convierte ennúmero de teléfono nacionalgeometría.ubicaciónse convierte enubicación
Las funciones «Búsqueda de texto» y «Búsqueda cercana» también muestran resultados en un lugares array en lugar de Legacy resultados matriz. La información sobre el estado y los errores utiliza ahora códigos y mensajes de respuesta HTTP estándar, en lugar de campos heredados como estado y la mensaje_de_error.
Estos cambios son importantes cuando las aplicaciones existentes analizan respuestas heredadas o dependen de nombres de campos antiguos.
Lo que los usuarios de la API heredada deben saber sobre la migración
La migración suele implicar algo más que cambiar el punto final. Google ofrece un Guía de migración de la API de Places en el que se abordan las principales diferencias entre la API heredada y la API de Places (nueva).
Comprueba primero estas áreas:
- Mueve las búsquedas de «Buscar lugar» a «Búsqueda de texto (nueva)».
- Cambia las solicitudes de «Búsqueda de texto» y «Búsqueda cercana» de GET a POST.
- Añade las máscaras de campo obligatorias.
- Actualiza el código que lee los campos de respuesta heredados.
- Revisa el SKU utilizado en cada solicitud.
Comprueba también que la API de Places (nueva) esté habilitada en el proyecto y que las restricciones de la clave de API la permitan.
Si es necesario que las solicitudes «Legacy» y «New» se ejecuten al mismo tiempo durante las pruebas, mantén separados ambos flujos. Google recomienda utilizar claves de API distintas durante la migración.
Las integraciones heredadas existentes pueden seguir funcionando por ahora, pero los nuevos proyectos deberían utilizar la API de Places (nueva).
Tutorial de la API de Google Places: configuración y tu primera solicitud
Para utilizar la API de Places (nueva), primero hay que disponer de un proyecto de Google Cloud vinculado a una cuenta de facturación. El proyecto debe tener habilitada la API de Places (nueva) antes de que se puedan enviar solicitudes autenticadas.
Para una solicitud básica de servicio web, la configuración consta de cinco pasos: elegir un proyecto en la nube, habilitar la API, crear una clave de API, restringir el uso de la clave y enviar una solicitud con los campos cuyos resultados se desean obtener.
Crear o seleccionar un proyecto de Google Cloud
Todas las solicitudes de Google Maps Platform pertenecen a un proyecto de Google Cloud.
Puedes crear un nuevo proyecto o utilizar uno ya existente. El proyecto seleccionado también debe tener una cuenta de facturación activa. Google utiliza el proyecto para realizar un seguimiento del acceso a la API, el uso, las cuotas y los cargos.
Mantener los proyectos separados también puede tener sentido cuando los entornos de desarrollo, pruebas y producción requieren credenciales o controles de uso diferentes.
Una vez seleccionado el proyecto correcto, se puede activar la API de Places (nueva) desde la Consola de Google Cloud.
Habilitar la API de Places (nuevo)
Es necesario habilitar la API de Places (nueva) para el proyecto antes de que la aplicación pueda invocar los métodos de su servicio web.
En la Consola de Google Cloud:
- Selecciona el proyecto que quieras utilizar.
- Abra la API y servicios.
- Buscar API de lugares (nueva) en la biblioteca de la API.
- Actívalo para el proyecto.
Esta distinción es importante para los proyectos más antiguos, ya que la API de Places (heredada) y la API de Places (nueva) son servicios independientes. Es posible que un proyecto que anteriormente utilizara la API heredada tenga que habilitar la API de Places (nueva) para que funcionen los puntos de conexión más recientes.
Configuración y restricciones de la clave API
Una clave API identifica el proyecto de Google Cloud que realiza la solicitud.
Google exige que la facturación esté activada antes de poder utilizar la API de Places (Nueva) para realizar solicitudes en tiempo real. Si solo estás siguiendo el proceso de configuración y aún no deseas vincular una cuenta de facturación, puedes detenerte antes de crear la clave y volver a este paso más adelante.
Cuando la facturación esté activada, crea una clave de API en Google Cloud Console y restringe su acceso antes de utilizarla en una aplicación.
En el caso de las solicitudes de la API de Places realizadas desde el lado del servidor, una restricción de direcciones IP puede limitar el uso de la clave a los servidores autorizados. También puedes restringir la clave para que solo funcione con la API de Places (Nueva) y con cualquier otro servicio de Google Maps Platform que la aplicación realmente necesite.
Google también exige que las solicitudes al servicio web de la API de Places utilicen HTTPS. La falta de una clave, una restricción incorrecta o una configuración no compatible pueden dar lugar a un REQUEST_DENIED respuesta.
Ejemplos de la API de Google Places: realiza tu primera solicitud de búsqueda de texto
«Búsqueda de texto» es un ejemplo sencillo de la API de Google Places que permite comprender el formato de la solicitud, el encabezado de la clave de la API y la máscara de campo.
La API de Places (nueva) envía solicitudes de búsqueda de texto a:
https://places.googleapis.com/v1/places:searchText
La solicitud utiliza el método HTTP POST. El texto de búsqueda se incluye en el cuerpo JSON, mientras que la clave de la API y la máscara de campo pueden enviarse a través de los encabezados de la solicitud.
Una solicitud básica puede tener este aspecto:
curl -X POST \
-H "Content-Type: application/json" \
-H "X-Goog-Api-Key: YOUR_API_KEY" \
-H "X-Goog-FieldMask: places.id,places.displayName,places.formattedAddress" \
-d '{ "textQuery": "dentists in Chicago" }' \
"https://places.googleapis.com/v1/places:searchText"
Esta consulta busca dentists in Chicago y le pide a Google que muestre únicamente:
- Identificación del lugar
- nombre para mostrar
- dirección con formato
Una respuesta correcta devuelve los objetos «Place» que coinciden dentro de un places matriz. Los campos que se incluyen en cada resultado dependen de la máscara de campos utilizada en la solicitud.
El uso de una máscara de campos limitados facilita la lectura de la respuesta y evita solicitar datos que la aplicación no necesita.
Para conocer los parámetros de solicitud actuales, los campos admitidos, los límites y los cambios en la API, consulta la página oficial Documentación de la API de Google Places.
Ejemplo de la API de Google Places: recuperar los detalles de un lugar
Una respuesta de «Búsqueda de texto» puede devolver un ID de lugar para cada ubicación que coincida. Una vez que la aplicación conoce el ID de lugar, puede utilizar «Detalles del lugar» para solicitar información sobre ese lugar concreto sin necesidad de realizar otra búsqueda.
La solicitud sigue este formato:
https://places.googleapis.com/v1/places/PLACE_ID
Por ejemplo:
curl -X GET -H "Content-Type: application/json" -H "X-Goog-Api-Key: YOUR_API_KEY" -H "X-Goog-FieldMask: id,displayName,formattedAddress" "https://places.googleapis.com/v1/places/PLACE_ID"
Sustituir PLACE_ID con el ID devuelto por «Búsqueda de texto», «Búsqueda cercana» u otro método de «Lugares» compatible.
Fíjate en que la máscara del campo «Detalles del lugar» utiliza id, displayNamey formattedAddress en lugar de places.id, places.displayNamey places.formattedAddress. «Place Details» devuelve un objeto «Place», mientras que «Text Search» devuelve objetos «Place» dentro de un places matriz.
Elige los campos que necesites
Las funciones «Detalles del lugar», «Búsqueda de texto» y «Búsqueda cercana» requieren una máscara de campo en la API de Places (Nueva). Si no se especifica ningún campo, la solicitud devuelve un error.
En el caso de la búsqueda de texto, una máscara de campo podría tener el siguiente aspecto:
places.displayName,places.formattedAddress
Si la solicitud también requiere una página web y una valoración, se puede ampliar la máscara de campo:
places.displayName,places.formattedAddress,places.websiteUri,places.rating
Google también admite * como comodín para todos los campos disponibles, aunque se desaconseja su uso en entornos de producción. Solicitar campos innecesarios puede aumentar la cantidad de datos devueltos y hacer que la solicitud pase a una SKU de facturación superior.
Limita la máscara de campos a los datos que la aplicación utiliza realmente. La selección de campos afecta tanto a la respuesta como al coste de la solicitud.
En la sección sobre precios que figura a continuación se explica cómo se corresponden esas opciones de campo con los SKU de la API de Google Places.
Utiliza Outscraper El Scraping de Google Maps para recopilar datos empresariales mediante un flujo de trabajo sin código, sin necesidad de configurar solicitudes individuales de la API de Places.
Precios y uso gratuito de la API de Google Places
La API de Google Places utiliza un modelo de tarificación de pago por uso. Cada solicitud se factura bajo un SKU específico, y el coste depende del método utilizado, de los campos solicitados y del número de eventos facturables mensuales.
Google ya no utiliza el antiguo crédito recurrente $200 de Maps Platform. El modelo actual asigna a cada SKU su propio límite mensual de uso gratuito. Dichos límites se restablecen al comienzo de cada mes.
Cómo funcionan los SKU de la API de Google Places
Un SKU es la categoría de facturación asociada a una solicitud de la API de Places.
La API de Places (nueva) divide muchas solicitudes en distintos niveles de precios, como Essentials, Pro y Enterprise. Los campos solicitados pueden hacer que una solicitud pase a una SKU de mayor precio.
Por ejemplo, los «Detalles del lugar» pueden facturarse con diferentes SKU en función de los campos solicitados:
- Datos básicos del lugar incluye un límite de uso gratuito mensual de 10 000 eventos.
- El límite mensual de uso gratuito para Detalles del lugar Pro es de 5.000 eventos.
- Para Detalles del lugar: Empresa, el límite mensual de uso gratuito es de 1.000 eventos.
Una vez superado el límite de uso gratuito, se aplica una tarifa por cada 1.000 eventos, que se reduce a medida que aumentan los volúmenes mensuales.
La búsqueda de texto y la búsqueda de lugares cercanos siguen una estructura similar.
En cuanto al primer nivel de uso de pago, Google indica actualmente las siguientes tarifas en la página oficial Página de precios de Google Maps Platform:
*Estas cifras corresponden al primer nivel de precios que aparece en la página de precios globales de Google. Los volúmenes mensuales más elevados se benefician de tarifas por cada 1.000 más bajas.
Google también ofrece algunas referencias de producto (SKU) que solo incluyen identificadores (ID) con uso gratuito ilimitado, entre las que se encuentran «Place Details Essentials (solo ID)» y «Text Search Essentials (solo ID)».
Límites actuales de uso gratuito
El uso gratuito se asocia a cada SKU individual, en lugar de a un crédito en dólares compartido.
Por ejemplo:
- Solicitudes de autocompletado: 10 000 eventos gratuitos al mes
- Datos básicos del lugar: 10 000
- Detalles del lugar Pro: 5.000
- Text Search Pro: 5.000
- Nearby Search Pro: 5.000
- Datos del lugar: Empresa: 1.000
- Búsqueda de texto para empresas: 1.000
- Empresas en las cercanías: 1.000
Algunos servicios a los que solo se puede acceder con un identificador ofrecen un uso gratuito e ilimitado.
Esto hace que las estimaciones de costes dependan en mayor medida de la solicitud concreta que en el antiguo sistema de créditos. Dos aplicaciones que realicen el mismo número de llamadas a la API de Places pueden tener facturas diferentes si solicitan campos distintos o utilizan métodos diferentes.
Cómo influyen los campos obligatorios en la facturación
Las máscaras de campo controlan algo más que el tamaño de la respuesta.
En el caso de «Detalles del lugar», «Búsqueda de texto» y «Búsqueda cercana», Google factura la solicitud según el SKU más alto que representen los campos solicitados. Si la máscara de campos incluye campos tanto de Essentials como de Pro, la solicitud se factura según el nivel Pro.
Por ejemplo, es posible que una aplicación que solo necesite un Place ID y una dirección no requiera los mismos campos que otra que solicite valoraciones, horarios de apertura, opiniones y otros atributos del lugar.
Esto hace que la selección de campos forme parte del cálculo de costes.
Evita solicitar todos los campos disponibles de forma predeterminada. Empieza por los campos que requiere la función y añade otros solo cuando tengan una finalidad clara.
Cómo afectan las sesiones de autocompletado a la facturación
El autocompletado se puede facturar por solicitud o como parte de una sesión.
Sin un token de sesión, cada solicitud de autocompletado se factura por separado bajo la referencia de producto «Solicitudes de autocompletado».
Una sesión agrupa las solicitudes de autocompletado de un usuario con la solicitud que completa la selección. Una sesión típica comienza con una o varias llamadas de autocompletado y finaliza con «Detalles del lugar (Nuevo)» o «Validación de la dirección». Cada nueva búsqueda de un usuario debe utilizar un nuevo token de sesión.
En el caso de las sesiones que finalizan con «Place Details Essentials», Google factura actualmente las primeras 12 solicitudes de autocompletado de forma individual. Las solicitudes posteriores a la duodécima se facturan bajo la partida «Uso de la sesión de autocompletado», que es gratuita. La solicitud de «Place Details» con la que finaliza la sesión se sigue facturando bajo su propia SKU.
Las sesiones abandonadas no se benefician de ese tratamiento. Si el usuario nunca completa la sesión con «Detalles del lugar» o «Validación de la dirección», las llamadas a Autocomplete vuelven a facturarse por solicitud.
Cómo calcular los costes de la API de Google Places
Para realizar una estimación de costes útil, hay que partir del flujo real de solicitudes, en lugar del número total de usuarios.
Comprueba:
- ¿Qué método de la API de Places se llamará?.
- Cuántas veces se invoca el método durante una acción del usuario.
- ¿Qué campos se incluyen en la máscara de campos?.
- ¿A qué SKU hacen referencia esos campos?.
- ¿Cuántos eventos facturables se prevén cada mes?.
- ¿Qué parte de ese consumo entra dentro del límite mensual gratuito de la SKU?.
- Si las solicitudes de autocompletado se agrupan en sesiones debidamente completadas.
Por ejemplo, una aplicación que realice 20 000 solicitudes mensuales de «Place Details Essentials» agotaría primero el límite mensual gratuito de 10 000 eventos. Los 10 000 eventos restantes se incluirían en el nivel de precios de pago.
Con la tarifa actual de primer nivel de $5 por cada 1.000 eventos, esas 10.000 solicitudes de pago costarían aproximadamente $50, sin incluir impuestos ni ningún otro uso de Maps Platform.
El cálculo cambia si la máscara de campo activa una referencia de producto (SKU) Pro o Enterprise, por lo que los campos previstos deben formar parte del presupuesto desde el principio.
Cuándo la API de Google Places es y cuándo no es la herramienta adecuada
La API de Google Places funciona bien cuando la información sobre lugares forma parte de una función de la aplicación. Un cuadro de búsqueda, un localizador de tiendas, una aplicación de viajes, una interfaz de reparto o una función de negocios cercanos pueden solicitar información sobre lugares cuando el usuario la necesite.
Los requisitos cambian cuando el objetivo principal es crear un conjunto de datos empresariales. Recopilar registros de numerosas categorías, ciudades o regiones supone un proceso diferente al de buscar lugares dentro de una aplicación.
Para una comparación más detallada entre el acceso a las API oficiales y la extracción de datos a gran escala, véase La API de Google Maps frente al web scraping.
Cuándo funciona bien la API de Google Places
Google ha diseñado la API de Places (nueva) en torno a las funciones de las aplicaciones basadas en la ubicación.
Es una opción muy adecuada cuando una aplicación necesita:
- buscar lugares a partir de los datos introducidos por el usuario
- encontrar negocios o lugares de interés cercanos
- sugerir lugares mientras alguien escribe
- obtener información sobre un lugar conocido
- mostrar fotos del lugar
- Utilizar los identificadores de lugar en todos los servicios compatibles de Google Maps Platform
Por ejemplo, una aplicación de reservas de hoteles podría mostrar restaurantes cercanos al establecimiento seleccionado. Una aplicación de reparto podría utilizar la función de autocompletado para ayudar al cliente a introducir un destino. Un localizador de tiendas podría mostrar información sobre una sucursal concreta una vez que el usuario la haya seleccionado.
Estas solicitudes suelen producirse como parte de una interacción dentro de la aplicación. El desarrollador controla qué método se invoca, qué campos se devuelven y cómo se muestran los resultados al usuario.
La documentación de Google describe la API de Places (nueva) en relación con este tipo de funciones de búsqueda de lugares, consulta, autocompletado y aplicaciones con reconocimiento de ubicación.
Cuando necesitas datos empresariales en grandes cantidades
Algunos proyectos necesitan un conjunto de datos en lugar de una función de búsqueda por ubicación.
En lugar de preguntar:
¿Qué restaurantes hay cerca de este usuario?
Un equipo de investigación puede necesitar:
¿Qué restaurantes operan en estas 50 ciudades?
Se observa el mismo patrón en diferentes equipos:
- Desarrolladores Es posible que sea necesario realizar una búsqueda de lugares o consultar datos dentro de una aplicación.
- Profesionales del marketing Es posible que necesite una lista de empresas por categoría y ubicación para realizar un estudio de mercado.
- Equipos de ventas es posible que necesite registros empresariales que se ajusten a determinados criterios geográficos o de empresa.
- Profesionales de los datos puede que necesite registros estructurados para análisis, paneles de control o sistemas internos.
Cuando el trabajo consiste en recopilar cientos o miles de registros empresariales, el proceso pasa de la búsqueda de datos puntuales a la recopilación de datos.
Para estudios de mercado, consulta Qué datos empresariales de Google Maps se deben recopilar para el análisis de mercado antes de decidir qué campos deben incluirse en tu conjunto de datos.
Una opción sin código para la recopilación de datos empresariales
Los equipos que no necesiten desarrollar una función de búsqueda de lugares pueden utilizar Outscraper El Scraping de Google Maps para recopilar registros empresariales sin necesidad de configurar solicitudes de Google Cloud ni escribir código de API.
Los usuarios pueden realizar búsquedas por categoría y ubicación, ejecutar la recopilación a través de la interfaz web y exportar los resultados con fines de investigación, prospección o análisis.
Para desarrolladores y equipos de datos que necesitan acceso programático, Outscraper API de Places de Google Maps es un servicio independiente del de Google API de lugares (nueva). Permite la recopilación masiva de datos empresariales. Consulta la Documentación de la API de Outscraper para consultar los detalles de la solicitud.
Una aplicación que necesita realizar búsquedas de lugares cercanos tiene unos requisitos de datos distintos a los de un equipo que está creando un conjunto de datos empresariales reutilizable.
Utiliza Outscraper API de Places de Google Maps cuando necesites registros empresariales de varias categorías o ubicaciones para investigación, ventas, análisis u otro flujo de trabajo relacionado con los datos.
Cuando necesites datos adicionales sobre la empresa o de contacto
La API de Google Places puede devolver direcciones, números de teléfono, sitios web, valoraciones, opiniones, horarios de apertura, estado de la empresa y otros campos relacionados con los lugares.
En el caso de la prospección o los estudios de mercado, es posible que aún queden lagunas. Es posible que los equipos también necesiten direcciones de correo electrónico, datos de contacto, perfiles en redes sociales u otra información sobre la empresa antes de que un registro esté listo para su uso.
Si necesitas añadir información de contacto y de la empresa después de haber recopilado los datos de la ubicación, consulta la guía sobre Enriquecimiento de datos de «Lugares» de Google Maps.
Un flujo de trabajo típico es el siguiente:
- Busca empresas por categoría y ubicación.
- Conserva los campos necesarios para la segmentación.
- Añade los datos de contacto o de la empresa.
- Exporta los registros para ventas, investigación u otro sistema.
Outscraper permite recopilar datos empresariales mediante flujos de trabajo sin código y a través de API, con opciones adicionales de enriquecimiento para correos electrónicos, contactos y perfiles en redes sociales.
La API de Google Places permite integrar la búsqueda de lugares y la información sobre los mismos en las aplicaciones. Los flujos de trabajo con datos empresariales que requieren datos de contacto, enriquecimiento o exportación suelen necesitar herramientas adicionales.
Límites, cuotas y riesgos de facturación de la API de Google Places
Una configuración de la API de Places puede funcionar en el entorno de pruebas y, aun así, presentar problemas relacionados con los costes, las cuotas o el acceso una vez que aumente el uso.
Google aplica cuotas por método de API y por proyecto, en lugar de mediante un límite diario común. El uso, las cuotas, los errores y la facturación se pueden consultar en Google Cloud Console.
Solicita solo los campos que necesites
Las máscaras de campo afectan tanto a la respuesta como a la referencia de facturación.
Si una solicitud incluye campos de nivel Pro, Google puede facturarla según la tarifa Pro, incluso aunque también se incluyan campos de menor coste. Limita la máscara de campos a los datos que la aplicación utilice realmente.
Utiliza el método de búsqueda adecuado
La búsqueda por texto se realiza a partir de una consulta escrita. La búsqueda por proximidad se realiza a partir de una zona geográfica definida y de criterios relacionados con el tipo de lugar.
Por ejemplo:
cafeterías en Bostones compatible con la búsqueda de texto.- Los restaurantes situados dentro de un radio determinado se incluyen en la búsqueda de locales cercanos.
Elegir el método adecuado reduce las solicitudes innecesarias y el filtrado adicional.
Gestionar correctamente las sesiones de autocompletado
La función de autocompletado puede generar varias solicitudes mientras el usuario escribe.
Utiliza un nuevo token de sesión para cada sesión de búsqueda y finaliza la sesión con una solicitud compatible de «Detalles del lugar» o «Validación de la dirección». Las sesiones abandonadas o configuradas incorrectamente pueden facturarse como solicitudes independientes.
Mantén separadas las solicitudes antiguas de las nuevas
La API de Places (antigua) y la API de Places (nueva) utilizan formatos de solicitud, nombres de campos y estructuras de respuesta diferentes.
No mezcles los tokens de sesión de autocompletado entre las solicitudes «Legacy» y las «New». Comprueba las integraciones anteriores antes de trasladar el tráfico de producción a la API de Places (New).
Restringe tus claves de API
Google recomienda restringir las claves de API por aplicación y por API.
En el caso de las solicitudes del lado del servidor, las restricciones de IP pueden limitar dónde se utiliza la clave. Las restricciones de la API pueden limitar el uso de esa misma clave a la API de Places (Nueva) y a otros servicios necesarios.
Una clave mal configurada también puede provocar SOLICITUD_DENEGADA errores, por lo que las restricciones deben someterse a pruebas antes de su uso en producción.
Establecer cuotas y alertas de facturación
Google Cloud Console permite realizar un seguimiento del tráfico, los errores, las cuotas y el gasto.
Establece límites de cuota y alertas de facturación antes de que aumente el volumen de solicitudes. Las alertas de facturación te avisan cuando el gasto alcanza los umbrales seleccionados, pero no detienen automáticamente el uso de la API.
Lista de comprobación final: antes de utilizar la API de Google Places
- Elige el método de la API de Places que se ajuste a la tarea.
- Utiliza la API de Places (nueva) y solicita solo los campos que necesites.
- Comprueba el SKU, el límite de uso gratuito y el coste mensual previsto.
- Restringe la clave de la API y configura cuotas o alertas de facturación.
- Decide si necesitas una búsqueda de lugares a través de una aplicación o la recopilación masiva de datos empresariales.
Usar Outscraper API de Google Maps Places para recopilar registros empresariales de distintas ubicaciones o categorías.
Preguntas más frecuentes
Preguntas y respuestas más frecuentes
La API de Google Places no es totalmente gratuita. Google aplica un modelo de pago por uso con límites mensuales de uso gratuito para cada SKU. Por ejemplo, las «Solicitudes de autocompletado» y «Detalles de lugares (Essentials)» incluyen actualmente 10 000 eventos mensuales gratuitos, mientras que otros SKU tienen límites más bajos.
La API de lugares se utiliza para buscar lugares y obtener información sobre empresas, puntos de interés y otras ubicaciones. La API de geocodificación se utiliza principalmente para convertir direcciones en coordenadas o, a la inversa, coordenadas en direcciones. Ambas pueden trabajar con identificadores de lugar, pero resuelven tareas diferentes relacionadas con los datos de ubicación.
La API de Places proporciona datos sobre lugares a través de solicitudes HTTP. La API de Maps JavaScript se utiliza para añadir mapas interactivos y funciones cartográficas basadas en el navegador a los sitios web. Su biblioteca Places también permite realizar búsquedas de lugares y ofrecer autocompletado dentro de una aplicación web.
Sí. Un proyecto de la API de Places en entorno de producción necesita un proyecto de Google Cloud vinculado a una cuenta de facturación. El proyecto también debe tener habilitado el servicio de la API de Places correspondiente y disponer de credenciales de autenticación válidas.
Un Place ID es un identificador textual de un lugar en la base de datos de Google Places y en Google Maps. Se puede utilizar en varios servicios de Google Maps Platform, entre ellos la API de Places, la API de geocodificación, la API de JavaScript de Maps y la API de rutas. Google señala que los Place ID pueden cambiar con el tiempo y recomienda actualizar los ID almacenados que tengan más de 12 meses de antigüedad.
La API de Places (nueva) es la versión actual para nuevos desarrollos. Algunos métodos heredados se corresponden directamente con métodos más recientes, mientras que otros han cambiado. Por ejemplo, «Búsqueda de texto (nueva)» sustituye a «Buscar lugar (heredada)». Los proyectos heredados existentes siguen siendo compatibles, pero los nuevos proyectos en la nube no pueden habilitar los servicios heredados.
En la lista actual de campos de datos de lugares de la API de Google Places (Nueva) no aparece ningún campo de correo electrónico de la empresa. La API puede devolver campos como números de teléfono y direcciones URL de sitios web, pero las direcciones de correo electrónico de la empresa no figuran como un campo de lugar compatible.
