Skip to main content
placeanalyzerAPI ReferenceGuías

Glossary and States

This guide is your

reference dictionary to understand all the terms and states you'll encounter when using the Place Analyzer API.

📚 Glossary of Terms

Identifiers

requestCode

  • Definition: Unique identifier of an appraisal request
  • Format: PA-YYYY-NNNNNN (e.g.: PA-2025-001234)
  • Purpose: Track and query the status of a specific appraisal
  • Duration: Permanent, never reused
  • Usage: Get results and check status
// Ejemplo de uso
const requestCode = "PA-2025-001234";
const statusUrl = `/valuation-request/${requestCode}`;
const resultUrl = `/valuation-request/${requestCode}/result`;

propertyId

  • Definición: Identificador único interno de una propiedad
  • Formato: PROP-NNNNNN (ej: PROP-456789)
  • Propósito: Referenciar propiedades en el sistema
  • Duración: Permanente para la misma propiedad física
  • Uso: Consultas de propiedades existentes

batchId

  • Definición: Identificador único de un lote de avalúos
  • Formato: BATCH-YYYY-NNNNNN
  • Propósito: Procesar múltiples propiedades simultáneamente
  • Uso: Monitoreo de procesamiento masivo

Ubicación

lat, lng

  • Definición: Coordenadas geográficas (latitud, longitud)
  • Formato: Números decimales con hasta 6 decimales
  • Rango: lat (-90 a 90), lng (-180 a 180)
  • Precisión: 6 decimales ≈ 10 cm de precisión
  • Uso: Especificar ubicación exacta de la propiedad
// Buenos Aires, Argentina
{
  "lat": -34.603722,
  "lng": -58.381592
}

Propiedad

propertyType

  • Definición: Tipo de propiedad según uso principal
  • Valores válidos:
    • Casa: Single family house
    • Departamento: Apartment in building
    • Terreno: Land/Lot
    • Duplex: Duplex
    • Deposito: Warehouse
    • Tinglado: Shed
    • Oficina: Office
    • Local Comercial: Commercial premises
    • Propiedad rural: Rural property
    • Casa quinta: Country house
    • Edificio: Building
  • Impacto: Afecta el modelo de tasación y comparables

propertyAge

  • Definition: Property age
  • Location: Inside the property object
  • Valid values: En pozo, Nuevo, Semi nuevo, Medio, Antiguo
  • Required: Depends on propertyType (Departamento and other types; not required for Terreno)

propertyCondition

  • Definition: Property condition
  • Location: Inside the property object
  • Valid values: Excelente, Bueno, Regular, Malo
  • Required: Depends on propertyType (other types; not required for Terreno or Departamento)

m2Land (Land square meters)

  • Definition: Total land area in square meters
  • Validation: Must be >= 0
  • Required: Depends on propertyType (Terreno and other types; not required for Departamento)
  • Example: House with 300 m² of land
  • Use: Land value and urban regulations

m2Built (Built square meters)

  • Definition: Built area in square meters
  • Validation: Must be >= 0
  • Required: Depends on propertyType (other types; not required for Terreno or Departamento)
  • Example: House with 200 m² built
  • Use: Construction value

m2Covered (Covered square meters)

  • Definition: Covered area in square meters
  • Validation: Must be >= 0
  • Required: Depends on propertyType (required for Departamento)
  • Example: Apartment with 80 m² covered

m2SemiCovered (Semi-covered square meters)

  • Definition: Semi-covered area in square meters
  • Validation: Must be >= 0
  • Required: Depends on propertyType (required for Departamento)
  • Example: Apartment with 10 m² semi-covered

Valores

estimatedBuildValue

  • Definición: Valor estimado de la construcción
  • Moneda: Especificada en currency
  • Componente: Solo el valor de lo construido
  • Ejemplo: $45,000,000

estimatedLandValue

  • Definición: Valor estimado del terreno
  • Moneda: Especificada en currency
  • Componente: Solo el valor del terreno
  • Ejemplo: $30,000,000

totalEstimatedValue

  • Definición: Suma de terreno + construcción
  • Fórmula: estimatedLandValue + estimatedBuildValue
  • Ejemplo: $75,000,000

currency

  • Definición: Moneda de la tasación
  • Valores comunes: ARS, USD, EUR
  • Uso: Interpretar correctamente los valores

confidence

  • Definición: Nivel de confianza de la tasación (0-1)
  • Interpretación:
    • 0.9-1.0: Muy alta confianza
    • 0.7-0.9: Alta confianza
    • 0.5-0.7: Confianza moderada
    • <0.5: Baja confianza
  • Factores: Cantidad de comparables, calidad de datos

🔄 Estados del Ciclo de Vida

Los avalúos pasan por diferentes estados durante su procesamiento:

Estados de Solicitud

PENDING_PROCESSING

  • Definición: Solicitud recibida, en cola para procesar
  • ¿Resultado disponible?: ❌ No
  • Tiempo típico: 0-30 segundos
  • Acción recomendada: Esperar y consultar estado

PROCESSING

  • Definición: Algoritmo de tasación ejecutándose
  • ¿Resultado disponible?: ❌ No
  • Tiempo típico: 2-5 minutos
  • Acción recomendada: Esperar y consultar estado

COMPLETED

  • Definición: Tasación finalizada exitosamente
  • ¿Resultado disponible?: ✅ Sí
  • Tiempo típico: N/A (estado final)
  • Acción recomendada: Obtener resultado

FAILED

  • Definición: Error durante el procesamiento
  • ¿Resultado disponible?: ❌ No
  • Causa común: Datos insuficientes o inválidos
  • Acción recomendada: Revisar datos y crear nueva solicitud

CANCELLED

  • Definición: Solicitud cancelada por el usuario
  • ¿Resultado disponible?: ❌ No
  • Causa: Cancelación manual
  • Acción recomendada: Crear nueva solicitud si es necesario

Estados de Lotes

CREATED

  • Definición: Lote creado, archivos subidos
  • ¿Procesamiento iniciado?: ❌ No

PROCESSING

  • Definición: Procesando propiedades del lote
  • ¿Progreso disponible?: ✅ Sí (porcentaje)

COMPLETED

  • Definición: Todo el lote procesado exitosamente
  • ¿Resultados disponibles?: ✅ Sí

FAILED

  • Definición: Error en el procesamiento del lote
  • Causa común: Archivo CSV malformado

📊 Tipos de Análisis

marketAnalysis

Análisis del mercado inmobiliario en la zona:

{
  "zoneName": "Palermo",
  "averagePricePerM2": 250000,
  "priceTrend": "STABLE", // STABLE, RISING, FALLING
  "comparableProperties": 15,
  "marketLiquidity": "HIGH" // HIGH, MEDIUM, LOW
}

priceTrend

  • RISING: Precios en aumento
  • STABLE: Precios estables
  • FALLING: Precios en descenso

marketLiquidity

  • HIGH: Muchas propiedades disponibles
  • MEDIUM: Cantidad moderada de propiedades
  • LOW: Pocas propiedades en venta

propertyDetails

Detalles específicos de la propiedad tasada:

{
  "lat": -34.603722,
  "lng": -58.381592,
  "m2Land": 300,
  "m2Built": 200,
  "propertyType": "Casa",
  "yearBuilt": 2010,
  "bedrooms": 3,
  "bathrooms": 2,
  "parkingSpaces": 1,
  "amenities": ["GARDEN", "GARAGE"]
}

🏪 Categorías Comerciales

commerceAnalysis

Análisis del entorno comercial:

{
  "totalCommerces": 1250,
  "byCategory": {
    "RESTAURANTS": 25.2,
    "SHOPS": 18.8,
    "SERVICES": 15.4,
    "HEALTH": 12.1,
    "EDUCATION": 8.9,
    "ENTERTAINMENT": 7.3,
    "TRANSPORT": 6.2,
    "FINANCIAL": 3.8,
    "OTHER": 2.3
  }
}

Categorías disponibles:

  • RESTAURANTS: Restaurantes y bares
  • SHOPS: Tiendas y comercios
  • SERVICES: Servicios profesionales
  • HEALTH: Salud y farmacias
  • EDUCATION: Educación e instituciones
  • ENTERTAINMENT: Entretenimiento y ocio
  • TRANSPORT: Transporte público
  • FINANCIAL: Servicios financieros
  • OTHER: Otras categorías

📋 Niveles Socioeconómicos

socioeconomicLevel

Clasificación ABC1 de niveles socioeconómicos:

  • A: Nivel socioeconómico alto
  • B: Nivel socioeconómico medio-alto
  • C: Nivel socioeconómico medio
  • D: Nivel socioeconómico bajo
{
  "A": 12.5,  // 12.5% de la población
  "B": 28.7,  // 28.7% de la población
  "C": 45.2,  // 45.2% de la población
  // C+D = 58.8% de la población
}

🏛️ Información Regulatoria

regulatoryInfo

Información urbanística y normativa:

{
  "zoning": "R2B1",
  "zoningDescription": "Residencial con comercio en planta baja",
  "allowedUses": [
    "RESIDENTIAL",
    "COMMERCIAL_GROUND_FLOOR",
    "OFFICES"
  ],
  "buildingRestrictions": {
    "maxHeight": 25,        // metros
    "maxFAR": 3.5,          // Factor de ocupación del suelo
    "minFrontSetback": 3,   // retranqueo mínimo (metros)
    "maxLotCoverage": 0.7   // cobertura máxima del lote
  }
}

Restricciones de construcción:

  • maxHeight: Altura máxima permitida en metros
  • maxFAR: Factor de ocupación máximo (área construida / área del terreno)
  • minFrontSetback: Distancia mínima al frente del terreno
  • maxLotCoverage: Porcentaje máximo del terreno que se puede construir

🚨 Códigos de Error

Principales categorías:

Validación (VALIDATION_ERROR)

  • Datos faltantes o inválidos
  • Formato incorrecto
  • Valores fuera de rango

Autenticación

  • INVALID_API_KEY: API Key incorrecta
  • MISSING_API_KEY: Falta API Key
  • API_KEY_EXPIRED: API Key vencida

Recursos

  • REQUEST_NOT_FOUND: requestCode no existe
  • RESULT_NOT_AVAILABLE: Resultado no disponible aún
  • PROPERTY_NOT_FOUND: Propiedad no encontrada

Rate Limiting

  • RATE_LIMIT_EXCEEDED: Límite de requests excedido

📊 Métricas y KPIs

Para propiedades:

  • averagePricePerM2: Precio promedio por m² en la zona
  • comparableProperties: Cantidad de propiedades similares
  • confidence: Nivel de confianza de la tasación

Para zonas:

  • population.total: Población total
  • population.density: Densidad poblacional (hab/km²)
  • commerceAnalysis.totalCommerces: Total de comercios

Conclusión

Este glosario cubre los términos esenciales para trabajar con Place Analyzer API:

✅ Conceptos clave:

  • requestCode para rastrear avalúos
  • Estados del ciclo de vida (PENDING_PROCESSING → COMPLETED)
  • Diferencia entre propertyType y tipos de análisis

✅ Estructura de datos:

  • Valores estimados y componentes
  • Análisis de mercado y regulatorio
  • Información demográfica y comercial

✅ Mejores prácticas:

  • Validar datos antes de enviar
  • Implementar polling para estados asíncronos
  • Manejar errores apropiadamente

¿Falta algún término? Consulta la

referencia completa de API o guía de manejo de errores.