Análisis Comercial
Comprende el entorno comercial que rodea a una propiedad. Esta colección de endpoints te permite obtener desde un resumen rápido de los comercios más cercanos hasta un análisis detallado filtrado por categorías o sectores.
Resumen de Endpoints
| Endpoint | Descripción | Variantes |
|---|---|---|
/near-commerces | Comercios más cercanos | Por coordenadas, por requestCode |
/commercial-activity | Todos los comercios en la zona | Por coordenadas, por requestCode, GeoJSON |
/category | Comercios por categoría específica | Por coordenadas, por requestCode |
/sector | Comercios por sector/rubro | Por coordenadas, por requestCode |
/commerce-graphic | Datos para gráficos de actividad | Por coordenadas, por requestCode |
/sector-graphic | Datos para gráficos por sector | Por coordenadas, por requestCode |
Cada endpoint tiene dos variantes:
- Por coordenadas: Usa
region,lat,lngpara consultar cualquier ubicación - Por requestCode: Usa el código de un avalúo existente para obtener datos de esa ubicación
Comercios Cercanos
Retorna los comercios más cercanos a la ubicación, agrupados por tipo. Ideal para una vista rápida de "lo que hay cerca" de la propiedad.
Respuesta: Objeto con arrays de CommercesDto agrupados por tipo de comercio.
Por coordenadas
Parámetros requeridos: region, lat, lng
Por requestCode
Usa el código de un avalúo existente para obtener los comercios cercanos a esa propiedad.
Actividad Comercial
Retorna todos los comercios en un radio desde la ubicación. Es el endpoint principal para analizar la actividad comercial total de la zona.
Respuesta: Array de CommercesDto con todos los comercios encontrados.
Por coordenadas
Parámetros requeridos: region, lat, lng
Por requestCode
Formato GeoJSON
Retorna los datos en formato GeoJSON para visualización en mapas.
Comercios por Categoría
Retorna comercios filtrados por una categoría específica (ej. "restaurantes", "bebidas", "helados").
Parámetros adicionales: category (string) - La categoría a filtrar
Respuesta: Array de CommercesDto de la categoría especificada.
Por coordenadas
Parámetros requeridos: region, category, lat, lng
Por requestCode
Comercios por Sector
Retorna comercios filtrados por sector o rubro específico (ej. "Construcción", "Educación", "Servicios varios").
Parámetros adicionales: sector (string) - El sector/rubro a filtrar
Respuesta: Array de CommercesDto del sector especificado.
Por coordenadas
Parámetros requeridos: region, sector, lat, lng
Por requestCode
Gráficos de Actividad Comercial
Retorna datos agregados para construir gráficos de barras o torta sobre la distribución de comercios.
Respuesta: Array de CommerceGraphicDto con name (tipo de comercio) y probability (porcentaje).
Por coordenadas
Parámetros requeridos: region, lat, lng
Por requestCode
Gráficos por Sector
Similar al gráfico de actividad, pero agrupa los comercios por sector/rubro.
Parámetros adicionales: sector (string) - El sector a analizar
Respuesta: Array de CommerceGraphicDto con distribución por sector.
Por coordenadas
Parámetros requeridos: region, sector, lat, lng
Por requestCode
Modelo de Datos
CommercesDto
| Campo | Tipo | Descripción |
|---|---|---|
name | string | Nombre del comercio |
phone | string | Teléfono de contacto |
category | string | Categoría del comercio |
sector | string | Sector/rubro del comercio |
icon | string | URL del icono |
img | string | URL de la imagen |
lat | number | Latitud del comercio |
lng | number | Longitud del comercio |
CommerceGraphicDto
| Campo | Tipo | Descripción |
|---|---|---|
name | string | Nombre del tipo/categoría |
probability | integer | Porcentaje o cantidad |
API Reference
Comercios cercanos
Comercios cercanos (requestCode)
Actividad comercial
Actividad comercial (requestCode)
Actividad comercial GeoJSON
Por categoría
Por categoría (requestCode)
Por sector
Por sector (requestCode)
Gráfico de actividad
Gráfico actividad (requestCode)
Gráfico por sector
Gráfico sector (requestCode)