Propiedades Cercanas
Obtén información sobre propiedades comparables en la zona de la tasación. Estos endpoints son fundamentales para construir las secciones de análisis de mercado del reporte, mostrando propiedades similares en venta o alquiler.
Resumen de Endpoints
| Endpoint | Descripción | Variantes |
|---|---|---|
/near-properties | Propiedades cercanas filtradas por transacción | Por coordenadas, por requestCode |
Dos formas de consultar
El 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
Propiedades Cercanas
Retorna una lista de propiedades (casas y departamentos) cercanas a una ubicación específica, filtradas por tipo de transacción.
Este endpoint es esencial para mostrar comparables en el reporte y analizar el mercado inmobiliario en las inmediaciones de la propiedad valuada.
Parámetros
| Parámetro | Tipo | Requerido | Descripción |
|---|---|---|---|
region | string | ✅ | Región/país de la consulta |
lat | number | ✅ | Latitud de la ubicación |
lng | number | ✅ | Longitud de la ubicación |
transaction | string | ✅ | Tipo de transacción: Venta o Alquiler |
Por coordenadas
Por requestCode
Usa el código de un avalúo existente. Aún requiere el parámetro transaction.
Modelo de Datos
PropertyDto
| Campo | Tipo | Descripción |
|---|---|---|
title | string | Título o descripción de la propiedad |
saleOrRent | string | Tipo de transacción: "Venta" o "Alquiler" |
typeProperty | string | Tipo de propiedad (casa, departamento, etc.) |
m2 | number | Metros cuadrados de terreno |
m2Cons | number | Metros cuadrados construidos |
bedrooms | string | Número de dormitorios |
bathrooms | string | Número de baños |
price | number | Precio de la propiedad |
priceM2 | number | Precio por metro cuadrado |
img | string | URL de la imagen principal |
lat | number | Latitud de la propiedad |
lng | number | Longitud de la propiedad |
Ejemplo de Uso
Obtener comparables de venta
curl -X GET "https://api.placeanalyzer.com/report/near-properties?region=AR&lat=-34.603722&lng=-58.381592&transaction=Venta" \
-H "X-API-KEY: tu_api_key"Obtener comparables por requestCode
curl -X GET "https://api.placeanalyzer.com/report/near-properties/abc-123-xyz?transaction=Alquiler" \
-H "X-API-KEY: tu_api_key"Respuesta de ejemplo
[ { "title": "Casa 3 ambientes en Palermo", "saleOrRent": "Venta", "typeProperty": "Casa", "m2": 150, "m2Cons": 120, "bedrooms": "3", "bathrooms": "2", "price": 250000, "priceM2": 2083.33, "img": "https://images.example.com/property1.jpg", "lat": -34.5875, "lng": -58.4236 }, { "title": "Departamento 2 ambientes", "saleOrRent": "Venta", "typeProperty": "Departamento", "m2": 0, "m2Cons": 65, "bedrooms": "2", "bathrooms": "1", "price": 120000, "priceM2": 1846.15, "img": "https://images.example.com/property2.jpg", "lat": -34.5890, "lng": -58.4210 } ]