Saltar al contenido principal

PPC-modificar-shape

Ver en Git

title: 'PPC: modificar shape'​

Polígonos Por Camapaña

El shape de un lote se puede modificar se puede modificar para una campaña. Al modificarse, las campañas siguientes tendrán el mismo shape.

PPC_timeline

APIS​

Nuevo shape de campaña​

Para crear un shape en una campaña o modificar el shape que ya existe para una campaña

Sólo se puede hacer si:

  • El usuario(+extensión) tienen el permiso "Modificar forma Lote" (220)
  • No se están procesando imágenes para el lote (ver enpoint más abajo)
  • El nuevo shape se encuentra dentro del recinto permitido (ver enpoint más abajo)

POST /api/fields/v2/shapes
  Body application/json
  {
    'type': 'object',
    'properties': {
        'field_id': {"type": "integer", "min": 1},
        'campaign': {"type": "integer", "min": 1},
        'shape': {'type': 'string', 'description': 'WKT en EPSG 4326'},
    },
    'required': ['field_id', 'campaign', 'shape'],
  }

Respuesta:

{
  "info": "shape was created", 
  "data":  {
        "images_reprocessing": true
    }
}

El parámetro images_reprocessing indica si hubo que reprocesar las imágenes. En caso de ser verdadero, no se podrá modificar el shape hasta que no se termine de reprocesar.

ERRORES (además de los code (int) < 0)​

  • ReprocessLockError: En caso que las imágenes aún se estén procesando

    • code = 'REPROCESSING'
    • msg = 'The previous shape is still being processed'

  • InvalidGeometryError:

    • code = 'INVALID_GEOMETRY'
    • msg = 'The provided geometry is invalid'

  • NotEnoughQuotaError:

    • code = 'NOT_ENOUGH_QUOTA'
    • msg = 'User has exceeded the assigned quota'

  • NotEnoughWorkspaceQuotaError:

    • code = 'NOT_ENOUGH_QUOTA_WORKSPACE'
    • msg = 'Workspace has exceeded the assigned quota'

  • MaxShapeAreaExceededError:

    • code = 'MAX_SHAPE_AREA_EXCEEDED'
    • msg = 'The requested Shape exceeds area limits'

  • ShapeExpansionLimitError:

    • code = 'SHAPE_EXPANSION_LIMIT'
    • msg = 'The provided shape exceeds the defined expansion limits'

Verificar si aún se están procesando las imágenes​

GET /api/fields/v2/shape/lock ? field_id = XXXX

Para verificar si anú se están procesando las imágenes de un lote.

  • En caso que las imágenes aún se estén reprocesando, levantará el error REPROCESSING
  • De responder ok, significa que el reprocesamiento ha terminado.

Respuesta:

{
  "info": "shape was modified", 
  "data":  {
        "images_reprocessing": true
    }
}
ERRORES​

Los mismos que en la api anterior

Obtener los límites de expansión​

Cuando se modifica un shape, el mismo debe estar dentro de este recinto.

GET /api/fields/v2/shape/limits ? field_id = XXXX

Respuesta:

{
  "info": "shape expansion limits retrieved", 
  "data": {
    "limits_4326": "MULTIPOLYGON(.....)",
    "limits_3857": "MULTIPOLYGON(.....)"}
}
ERRORES​

Los mismos que en la api anterior