Análisis Comercial
Entendé el entorno comercial que rodea a una propiedad.
Resumen de Endpoints
| Endpoint | Descripción | Variantes |
|---|---|---|
/commerce-graphic | Datos para gráficos de actividad | Por coordenadas, por requestCode |
Gráficos de Actividad Comercial
Retorna las actividades y comercios más comunes alrededor de la ubicación, ordenados de mayor a menor, para armar una tabla o un gráfico.
Respuesta: Array de CommerceGraphicDto con name (tipo de comercio) y probability (porcentaje).
Por coordenadas
Parámetros requeridos: region, lat, lng
Valores permitidos para region:
- Paraguay:
py - Uruguay:
uy - Argentina (Buenos Aires):
ar_bsas - Bolivia (Santa Cruz):
bo_santacruz - Perú (Lima):
pe_lima - Ecuador (Pichincha):
ec_pichincha - España (Centro):
es_centro
Por requestCode
CommerceGraphicDto
| Campo | Tipo | Descripción |
|---|---|---|
name | string | Nombre del tipo/categoría |
probability | double | Peso de la actividad en la zona, de 0 a 1. La más común vale 1.0 y el resto es relativo a ella. |
Ejemplo
curl -X GET "https://api.place-api.com/report/v1/commerce-graphic?region=py&lat=-25.2969&lng=-57.5850" \
-H "X-API-KEY: tu_api_key"Respuesta real (recortada), para un avalúo en Central, Paraguay:
[ { "name": "quinta", "probability": 1.0 }, { "name": "granja", "probability": 0.7 }, { "name": "despensa", "probability": 0.42 }, { "name": "capilla", "probability": 0.39 } ]
Si falta region, la respuesta es 400 con "message": "campo [region] es requerido".