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 houseDepartamento: Apartment in buildingTerreno: Land/LotDuplex: DuplexDeposito: WarehouseTinglado: ShedOficina: OfficeLocal Comercial: Commercial premisesPropiedad rural: Rural propertyCasa quinta: Country houseEdificio: Building
- Impacto: Afecta el modelo de tasación y comparables
propertyAge
- Definition: Property age
- Location: Inside the
propertyobject - 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
propertyobject - 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 aumentoSTABLE: Precios establesFALLING: Precios en descenso
marketLiquidity
HIGH: Muchas propiedades disponiblesMEDIUM: Cantidad moderada de propiedadesLOW: 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 baresSHOPS: Tiendas y comerciosSERVICES: Servicios profesionalesHEALTH: Salud y farmaciasEDUCATION: Educación e institucionesENTERTAINMENT: Entretenimiento y ocioTRANSPORT: Transporte públicoFINANCIAL: Servicios financierosOTHER: 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 metrosmaxFAR: Factor de ocupación máximo (área construida / área del terreno)minFrontSetback: Distancia mínima al frente del terrenomaxLotCoverage: 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 incorrectaMISSING_API_KEY: Falta API KeyAPI_KEY_EXPIRED: API Key vencida
Recursos
REQUEST_NOT_FOUND: requestCode no existeRESULT_NOT_AVAILABLE: Resultado no disponible aúnPROPERTY_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 zonacomparableProperties: Cantidad de propiedades similaresconfidence: Nivel de confianza de la tasación
Para zonas:
population.total: Población totalpopulation.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:
requestCodepara rastrear avalúos- Estados del ciclo de vida (
PENDING_PROCESSING→COMPLETED) - Diferencia entre
propertyTypey 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.