Volver a las API
Datos independientes de Google Maps

Google Maps API

Descubra lugares públicos, consulte detalles normalizados de URL conocidas de Maps y obtenga reseñas públicas con contexto del lugar y del autor vinculado a la fuente.

API de Google Maps disponibles

Use Search para descubrir lugares por consulta y ubicación, Place Details para URL conocidas de Maps y Reviews para obtener reseñas públicas de forma acotada.

¿Qué datos de Google Maps se pueden obtener?

SocQ devuelve registros públicos PlaceItem normalizados para investigación de ubicaciones, descubrimiento de negocios, enriquecimiento de datos e instantáneas de mercado de un momento dado.

Identidad del lugar

Obtenga los ID de lugar, nombres, categorías, URL de origen, tipos de registro y marcas de tiempo de recolección que estén disponibles.

Direcciones y contexto geográfico

Conserve las direcciones con formato, las etiquetas de ubicación, las ciudades, las regiones, los países, la latitud y la longitud que estén disponibles.

Datos de contacto públicos

Obtenga teléfonos y sitios web públicos cuando un resultado de búsqueda los expone.

Calificaciones y conteo de reseñas

Conserve la calificación y la cantidad de reseñas que informa la fuente, sin inferir los valores ausentes.

Descripciones y categorías

Use el texto de resumen y las etiquetas de categoría disponibles para clasificar y preseleccionar los resultados de lugares.

Metadatos de tareas y paginación

Dé seguimiento al estado de la tarea y a result_count, y recorra los registros PlaceItem almacenados con next_cursor y has_more.

Texto de ubicación y contexto de coordenadas

Google Maps Search siempre requiere query y location. En la especificación actual de ejecución, las coordenadas son contexto opcional y no reemplazan a location.

Opción de entradaComportamiento en ejecuciónCuándo usarla
Solo locationEl texto de la ubicación se combina con query para el descubrimientoBúsquedas basadas en una ciudad, un distrito, un punto de referencia o una dirección
location más ambas coordenadaslocation sigue siendo obligatorio y las coordenadas se reenvían como lat y longSe dispone de un centro geográfico verificado
location más una coordenadaLa coordenada indicada se reenvía de forma independienteÚsela solo cuando el contexto geográfico parcial sea intencional
country y zoom_levelEl contexto opcional se reenvía junto con la fila de búsquedaLa solicitud necesita una pista de país o un zoom explícito de 0 a 21

Cómo funciona la API de Google Maps

Envíe una búsqueda de lugares acotada, espere la recolección asíncrona y recorra los registros normalizados almacenados para la tarea.

  1. 1. Definir la búsqueda de lugares

    Elija una query específica y la location obligatoria, y agregue solo el contexto geográfico opcional verificado que necesite.

  2. 2. Enviar y dar seguimiento a la tarea

    Envíe la solicitud por POST, guarde el task_id y consulte /v1/tasks/{task_id} hasta que el procesamiento termine con éxito o con error.

  3. 3. Leer los lugares normalizados

    Procese data.results.items y siga next_cursor mientras has_more sea true.

Buscar lugares públicos

Envíe una query y una location con un tope de resultados pequeño, y luego lea los resultados PlaceItem normalizados desde el endpoint de tareas compartido.

curl -X POST "https://api.socq.ai/v1/google-maps/search" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"coffee","location":"New York, NY","country":"US","results_limit":3}'

# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is true

Casos de uso frecuentes de la API de Google Maps

Descubrimiento de negocios locales

Encuentre negocios públicos que coincidan con una categoría o un servicio dentro de una ciudad, un distrito, un punto de referencia o una dirección.

Enriquecimiento de datos de lugares

Agregue los campos disponibles de contacto, dirección, categoría, calificación, conteo de reseñas, URL y coordenadas a lugares candidatos que ya tenga.

Instantáneas de mercados geográficos

Obtenga conjuntos de resultados acotados para zonas enviadas de forma independiente y compare la cobertura pública de lugares en momentos de recolección específicos.

Colas de verificación

Arme una lista preseleccionada a partir de los campos públicos de identidad, contacto, calificación y ubicación para una revisión posterior o un proceso de detalle independiente.

Límites y política de datos públicos

Los resultados son registros públicos de un momento dado. La disponibilidad de la búsqueda y lo completo de los campos dependen de lo que la fuente exponga para la solicitud enviada.

  • query y location son cadenas obligatorias y no vacías; location no se puede reemplazar por coordenadas.
  • country, latitude, longitude y zoom_level son opcionales; la ejecución actual acepta latitude y longitude de forma independiente.
  • zoom_level debe ser un entero de 0 a 21, y results_limit tiene un valor predeterminado de 100 y un rango aceptado de 1 a 2,000.
  • results_limit es un máximo de recolección, mientras que el limit del GET de la tarea controla cada página de resultados almacenados que se devuelve.
  • Los resultados públicos pueden omitir descripciones, categorías, datos de contacto, calificaciones, conteos de reseñas, URL o subcampos geográficos.
  • Las identidades expuestas duplicadas se almacenan una sola vez por tarea, por lo que result_count puede ser menor que la cantidad de filas de la fuente observadas.

Preguntas frecuentes sobre la API de Google Maps

¿Qué es la API de Google Maps?

Las API de Google Maps buscan lugares públicos de forma asíncrona, resuelven URL conocidas de lugares y obtienen reseñas públicas como registros normalizados. Search acepta query y location, y devuelve registros PlaceItem con los campos disponibles de identidad, dirección, contacto, calificación, conteo de reseñas, URL y coordenadas.

¿Qué requiere Search?

Search requiere cadenas query y location no vacías. country, latitude, longitude, zoom_level y results_limit son opcionales.

¿En qué se diferencian la recolección y la paginación de la respuesta?

results_limit acota los registros que se recolectan para la búsqueda enviada. Después del éxito, el endpoint de tareas devuelve los registros almacenados en páginas controladas por sus propios parámetros limit y next_cursor.

¿Por qué los campos de un lugar pueden ser null?

Un resultado de búsqueda público puede no exponer todos los campos de contacto, calificación, reseñas, descripción, URL, dirección o coordenadas. El esquema normalizado conserva esos valores ausentes como null.

¿Cuánto cuestan los resultados de Google Maps Search?

Cada lugar almacenado cuesta 0.15 créditos. La estimación de la precarga usa results_limit, o 100 si se omite, y al completarse con éxito se liquida según la cantidad real de resultados almacenados.

Reúna en un mismo flujo de trabajo perfiles públicos, contenido y datos de interacción de distintas plataformas para dar seguimiento a marcas, creadores y temas, y para realizar monitoreo y análisis entre plataformas con más eficiencia.

Google Play API

Obtenga detalles públicos de apps de Google Play, clasificaciones por categoría y reseñas a partir de URL conocidas de la tienda, como registros normalizados de apps y reseñas.

Amazon API

Busque productos públicos de Amazon y obtenga registros normalizados de detalles de productos, Best Sellers, reseñas, perfiles de vendedores y tiendas de creadores de los marketplaces compatibles.

Apple App Store API

Obtenga detalles públicos de apps de Apple App Store, clasificaciones por categoría y reseñas a partir de URL conocidas de la tienda, como registros normalizados de apps y reseñas.

SEO API

Consulte resultados orgánicos de Google en vivo, compare la demanda de palabras clave y la dificultad de posicionamiento, amplíe términos semilla, descubra las palabras clave y las páginas que impulsan la visibilidad de un sitio en las búsquedas, clasifique la intención de búsqueda y recopile resultados de Google News, Google Images, Google Autocomplete, Bing y YouTube. Todos los endpoints usan la misma clave de API de SocQ, el mismo flujo de tareas asíncronas y el mismo formato de resultados normalizado.

Telegram API

Lea canales públicos de Telegram a partir de sus enlaces t.me: perfiles de canal con suscriptores, publicaciones con vistas y reacciones, publicaciones sueltas, comentarios de grupos de discusión, canales similares y búsqueda en todo el historial.

Link in Bio API

Convierta el único enlace de la bio de Instagram, TikTok o YouTube de un creador en datos estructurados: nombre visible, bio, avatar, correo de contacto indicado, perfiles sociales vinculados y cada botón de la página con su título y destino.