Ingeniería de costos · 18 de octubre de 2026 · 9 min de lectura

El fieldMask de Google Places: el campo que cuadruplica tu factura de leads

Dos llamadas al mismo endpoint, la misma consulta, los mismos 20 negocios devueltos. Una cuesta cero y la otra cuesta USD 0,035. La diferencia no es la paginación, ni el caché, ni la región: es una sola línea del cuerpo de la petición llamada fieldMask, y casi todos los tutoriales la escriben mal por generosidad.

Cómo te cobra de verdad la Places API (New)

El endpoint de Text Search tiene cuatro SKUs de facturación. No te cobran cuatro veces: te cobran una sola, a la tarifa más alta presente en la respuesta que pediste. Ese es todo el mecanismo, y es la razón por la que la máscara de campos es una decisión de precio y no un detalle de formato.

Fuente: página de precios de Google Maps Platform, consultada el 16/10/2026. Hay descuento por volumen: el segundo tramo baja Enterprise a USD 28,00 y Atmosphere a USD 32,00 por 1.000.

Qué campo te sube a qué SKU

Los campos están agrupados. Pide uno del grupo y toda la respuesta se factura a la tarifa de ese grupo:

Lee esa tabla como una lista de precios, porque eso es. En el momento en que agregas nationalPhoneNumber a una petición que solo necesitaba nombres, el precio de esa petición salta de USD 0 (solo IDs es gratis e ilimitado) a USD 0,035, y no vuelve a bajar hasta que quites el campo.

El error que más cuesta: el comodín

"fieldMask": "*" es la forma más rápida de escribir una petición que funcione y la más cara de ejecutar. Pide todo lo que el endpoint puede devolver, así que la respuesta siempre contiene un campo de Atmosphere, así que cada llamada se factura en el tramo más alto — incluidas las que solo querías para deduplicar.

Otras dos trampas que producen el mismo efecto sin comodín:

• Falta el prefijo places. La máscara se escribe campo por campo (places.displayName, places.websiteUri). Una máscara mal formada se rechaza, pero una copiada de un fragmento viejo puede incluir campos que nunca imprimes.
• Copiar el ejemplo «completo». La mayoría de los ejemplos públicos se escribieron para mostrar todos los campos disponibles, no para correr con presupuesto. Incluyen reviews de fábrica.

Qué pide nuestro flujo, y por qué no es la opción más barata

El flujo de prospección pide exactamente nueve campos y queda en el tramo Enterprise:

places.id
places.displayName
places.formattedAddress
places.primaryType
places.primaryTypeDisplayName
places.rating
places.userRatingCount
places.businessStatus
places.nationalPhoneNumber
places.websiteUri

Existe una máscara más barata y decidimos no usarla. Si quitas el teléfono y la web, la respuesta baja al tramo Pro (USD 32,00 por 1.000 en vez de USD 35,00), un ahorro de un 8 % aproximadamente. Pero sin teléfono ni web no hay con qué abrir una conversación: tienes una lista de nombres de negocios, no prospectos. Un lead al que no puedes contactar no es un lead, es una fila.

Ese es todo el intercambio, y es la razón por la que el costo documentado del kit es USD 1,81 por 1.000 leads cualificados y no USD 1,70: los tres centavos extra por cada mil solicitudes compran justamente los campos que hacen vendible la salida.

La aritmética real, en los volúmenes que la gente corre

Text Search devuelve un máximo de 20 negocios por solicitud (no es un límite de plan, es el endpoint). El flujo está configurado para paginar hasta tres veces por corrida, así que una corrida completa son 3 solicitudes y hasta 60 negocios.

La línea contraintuitiva es la cuarta: prospectar diez mil negocios cuesta cero, porque el tramo Enterprise incluye sus primeras 1.000 solicitudes cada mes. Por debajo de unos 20.000 leads al mes, el lado de Places de este pipeline es gratis. Lo que de verdad pagas a esa escala es el modelo, y ahí los números son cinco veces más chicos (USD 0,56 por 10.000 leads con caché).

Cómo bajar la factura sin adivinar

El método que usamos, en orden:

1. Parte de la máscara de solo IDs y agrega campos de a uno. Cada campo que agregas solo puede mantener la SKU o subirla. Agregarlos uno por uno te dice exactamente qué adición te costó dinero.
2. Nunca pidas reseñas, resúmenes ni contenido editorial si no los va a leer un humano. Son el grupo más caro y el menos útil para puntuar: con el rating y el número de reseñas ya sabes si el negocio tiene reputación.
3. Pon una cuota mensual por proyecto, no una alarma de presupuesto. La alarma te avisa cuando la plata ya se fue; la cuota por clave la corta. Google Maps Platform permite limitar solicitudes por día por API.
4. Cachea la respuesta, no la petición. Deduplica por placeId antes de volver a llamar: nuestro propio flujo lo aprendió a la mala, y una segunda corrida sobre la misma consulta legítimamente devuelve cero filas nuevas.

Qué significa esto si estás comprando una plantilla

Cuando un vendedor te dice «USD X por lead», pide ver el fieldMask. Es la línea que decide si la aritmética de la página de venta es real. Una plantilla que pide * no es deshonesta, está sin medir — y el que va a pagar 40 dólares por mil solicitudes mientras la página prometía treinta y cinco eres tú.

La nuestra está publicada completa, con la tabla de SKUs y los tramos gratuitos, en el documento de costos que va dentro del kit. Si prefieres verificarlo antes de comprar y no después, este artículo es la versión corta de ese documento.