Saltar al contenido principal

Img-stats

Ver en Git


Img Stats

Mediante esta herramienta, es posible obtener estadísticas sobre múltiples regiones de una imagen.

Permiso necesario "Ver estadísticas de imágenes" (id: 50)

API

Authorization: Bearer <TOKEN>
POST /api/geo/imgstats
Body: application/json

En el cuerpo de la consulta es un objeto con las siguientes propiedades:

  • field_id: int id del lote
  • date: str: fecha de la imagen en formato YYYY-MM-DDTHH:MM:SSZ
  • layer_name: str nombre de la capa
  • operation: str operacion
  • geometries: object objeto con las geometrías
    • cada key es un identificador que luego se utilizara para identificar las estadísticas de cada AOI. El valor correspondiente es la geometría en format WKT o geojson, en la proyección de EPSG:4326

Ejemplo:

{
"field_id": 123,
"date": "2022-03-10T00:00:00Z",
"layer_name": "Senstinel2",
"operation": "ndvi1",
"geometries": {
"geom1": "Polygon ((-64.05647785376287118 -33.57509867311632945, -64.06239042094520642 -33.57658416885119834, -64.05409517743565573 -33.57936395789960926, -64.0532568283575614 -33.5781873276145717, -64.05647785376287118 -33.57509867311632945))",
"geom2": {"type":"Polygon", "coordinates":[[[-64.06158148762424,-33.57840794579301],[-64.06186093731694,-33.58164367907688],[-64.06409653485852,-33.58109948757005],[-64.06356705123025,-33.57792258580044],[-64.06158148762424,-33.57840794579301]]]}
}
}

Respuesta (application/json):

  • code: 0
  • data: data

donde data es un objeto cuyas keys son los identificadores enviados en la consulta y cuyos valores son objetos con las estadísticas correspondientes:

Ejemplo:

{
"code": 0,
"data": {
"geom1": {
"min": 0.4
"max": 0.9
"mean": 0.7
"total": 25
},
"geom2": {
"min": 0.3
"max": 0.8
"mean": 0.7
"total": 23
}
}
}

En caso que un AOI enviado no abarque datos de la imagen, las estadísticas tomarán un valor null.

Errores posibles:

  • code: -11, indicando que el usuario no tiene permisos.
  • code: LAYER_NOT_FOUND, indicando que la iamgen solicitada no está disponible
  • code: INVALID_GEOMETRY, indicando que al menos una de las geometrías es inválida. Se envía un parámetro extra "data": {"invalid": "geom1"}, indicando el identificador de la geometría inválida.