Datos Estadísticos y Geográficos
Estos endpoints devuelven datos demográficos, información urbanística y recursos visuales para enriquecer los reportes de tasación con contexto geográfico y normativo.
Resumen de Endpoints
| Endpoint | Descripción | Variantes |
|---|---|---|
/population | Datos de población de la zona | Por coordenadas, por requestCode, GeoJSON |
/regulatory-plan | Plan regulador urbano | Por coordenadas, por requestCode, GeoJSON |
/photo360 | Fotos 360° de la zona | 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
Datos de Población
Retorna información demográfica y de densidad poblacional para la zona especificada. Útil para gráficos demográficos y análisis de mercado.
Respuesta: Array de PopulationDto con datos de población por área.
Por coordenadas
Parámetros requeridos: region, lat, lng
Por requestCode
Formato GeoJSON
Retorna los datos de población en formato GeoJSON para visualización en mapas de calor o coropletas.
Plan Regulador
Retorna información del plan regulador urbano (zonificación, usos permitidos, restricciones de construcción) para la ubicación especificada.
Respuesta: Array de PlanDto con información normativa de la zona.
Por coordenadas
Parámetros requeridos: lat, lng
Este endpoint no requiere el parámetro region, solo las coordenadas.
Por requestCode
Formato GeoJSON
Retorna los polígonos de zonificación en formato GeoJSON para visualización en mapas.
Fotos 360°
Retorna URLs de fotografías panorámicas 360° disponibles cerca de la ubicación especificada. Útil para proporcionar contexto visual del entorno.
Respuesta: Array de PhotoDto con URLs de imágenes y coordenadas.
Por coordenadas
Parámetros requeridos: region, lat, lng
Por requestCode
Modelos de Datos
PopulationDto
| Campo | Tipo | Descripción |
|---|---|---|
lat | number | Latitud del punto de datos |
lng | number | Longitud del punto de datos |
population | number | Población estimada en el área |
PlanDto
| Campo | Tipo | Descripción |
|---|---|---|
name | string | Nombre de la zonificación |
color | string | Color para visualización (hex) |
block | string | Identificador del bloque/manzana |
geometry | string | Geometría del polígono (WKT o GeoJSON) |
PhotoDto
| Campo | Tipo | Descripción |
|---|---|---|
img | string | URL de la imagen 360° |
lat | number | Latitud donde se tomó la foto |
lng | number | Longitud donde se tomó la foto |
Ejemplos de Uso
Obtener datos de población
curl -X GET "https://api.placeanalyzer.com/report/population?region=AR&lat=-34.603722&lng=-58.381592" \
-H "X-API-KEY: tu_api_key"Obtener plan regulador por requestCode
curl -X GET "https://api.placeanalyzer.com/report/regulatory-plan/abc-123-xyz" \
-H "X-API-KEY: tu_api_key"Obtener fotos 360° en formato GeoJSON
curl -X GET "https://api.placeanalyzer.com/report/population-geojson?region=AR&lat=-34.603722&lng=-58.381592" \
-H "X-API-KEY: tu_api_key"Respuesta de población
[ { "lat": -34.6037, "lng": -58.3816, "population": 15420.5 }, { "lat": -34.6050, "lng": -58.3800, "population": 12350.0 } ]
Respuesta de plan regulador
[ { "name": "R2a - Residencial de Densidad Media", "color": "#4CAF50", "block": "1234-5", "geometry": "POLYGON((-58.38 -34.60, ...))" } ]
Respuesta de fotos 360°
[ { "img": "https://streetview.placeanalyzer.com/photo123.jpg", "lat": -34.6035, "lng": -58.3820 }, { "img": "https://streetview.placeanalyzer.com/photo456.jpg", "lat": -34.6040, "lng": -58.3815 } ]