APIs · Google
Buscar lugares con la Places API
La Places API entrega nombre, dirección, teléfono, horario, calificación, reseñas y fotos de millones de lugares. La versión nueva usa una búsqueda de texto con un FieldMask obligatorio que define — y limita — qué datos pides y qué pagas.
1. Lanza una búsqueda de texto
Con tu API key habilitada para Places, una búsqueda de texto se ve así:
curl -X POST "https://places.googleapis.com/v1/places:searchText" \
-H "Content-Type: application/json" \
-H "X-Goog-Api-Key: TU_API_KEY" \
-H "X-Goog-FieldMask: places.displayName,places.formattedAddress,places.rating,places.userRatingCount" \
-d '{"textQuery": "cafeterías en Monterrey centro", "languageCode": "es"}'El FieldMask es obligatorio y define el costo: pide solo los campos que de verdad necesitas.
Para obtener las fotos
Si además quieres imágenes, agrega places.photos al FieldMask y usa el name de cada foto para descargarla a un archivo local. Antes de empezar necesitas una API key con facturación activa. Detalle completo en la guía de APIs de Google.
Tareas relacionadas
Preguntas frecuentes
¿Por qué la Places API exige un FieldMask?
Porque define exactamente qué campos devuelve y, con ello, cuánto cuesta la llamada: los datos se cobran por categoría. Pedir solo lo que necesitas mantiene la respuesta barata; pedir todo "por si acaso" infla el costo sin razón. Es un campo obligatorio en la versión nueva.
¿Puedo usar la Places API gratis?
Tiene una capa gratuita mensual por categoría de llamada, suficiente para muchos sitios, pero requiere facturación activa con tarjeta de antemano. El costo real depende de qué campos pidas en el FieldMask y de cuántas búsquedas hagas.
¿En qué idioma devuelve los resultados?
En el que indiques con languageCode. En el ejemplo, "es" pide los datos en español cuando están disponibles, lo cual importa para nombres, direcciones y reseñas en mercados de habla hispana como México.