Muestreos

Se cuenta con una API para obtener los muestreos realizados desde la funcionalidad muestreos.

Endpoints

sampling

GET /api/sampling

Devuelve un arreglo con los samplings según los filtros indicados en la query string.

Se le debe enviar uno de los siguientes parámetros en la query string:

• field_id: ìnteger, id del lote
• sampling_uuid: string, uuid del muestreo (en caso de conocerlo)

Respuesta

La siguiente es una interfaz de un ejemplo de respuesta:

interface ApiSamplingI {
  code: int
  data: DataI[]
}

interface DataI {
  groups: GroupI[]
  yeargroup: number
  created_at: string
  field_id: number
  zoning: {
    info: {
      map_id: string
    }
    type: string
  }
  analysis: {
    [key: string]: AnalysisType[]
  }
  field_uuid: string
  sampling_name: string
  points: Point[]
  group_assigned_id: number
  sampling_uuid: string
  closed_at: string | null
  sample_set_uuid: string
}

interface GroupI {
  samples: SampleI[]
  group_data: {
    sampling: {
      color: string
      name: string
    }
  }
  group_uuid: string
}

interface SampleI {
  code: string
  spot_data: {
    variables: VariableI[]
    sampling: {
      analysis: string
    }
  }
  spot_uuid: string
}

interface VariableI {
  name: string
  value?: number
  unit_id: number
}

interface AnalysisType {
  name: string
  unit_id: number
}

interface Point {
  geometry: string
  point_uuid: string
  checked: number
  created_at: string
  group_uuid: string
}

analysis

GET /api/sampling/analysis

Devuelve un arreglo con los análisis y otros datos de muestreos según los filtros indicados en la query string.

Se le debe enviar uno de los siguientes parámetros en la query string:

• field_id: ìnteger, id del lote
• farm_id: ìnteger, id del campo
• sampling_uuid: string, uuid del muestreo (en caso de conocerlo)

Respuesta

La siguiente es una interfaz de un ejemplo de respuesta:

interface SamplingAnalysisI {
  code: number
  data: DataI[]
}

interface DataI {
  farm_id: number
  field_id: number
  zoning: ZoningI
  analysis: AnalysisI
  sampling_name: string
  sampling_uuid: string
  sample_set_uuid: string
}

interface ZoningI {
  info: {
    date: string // opcional
    layer: string // opcional
    operation: string // opcional
    hour: string // opcional
    provider: string // opcional
    map_id: string // opcional
  }
  type: string
}

interface AnalysisI {
  [key: string]: {
    name: string
    unit_id: number
  }[]
}

Lista de variables

GET /api/sampling/variablelist

Devuelve la lista de variables de los samplings.

No es necesario enviarle parámetros en la query string.

Respuesta

La siguiente es una interfaz de respuesta:

interface VariableListResponseI {
  code: number
  variablelist: Variablelist[]
}

interface Variablelist {
  items: Item[]
  list_name: string
  variablelist_uuid: string
}

interface Item {
  name: string
  value: number
}

Subir capa a partir de muestreo

Content-Type: application/json
POST /api/sampling/{sampling_uuid}/rasterize

Este endpoint permite agregar una nueva capa a partir de los valores cargados en el muestreo que se pase a través de la url (sampling_uuid).

• layers:Array contiene un objeto por cada capa a crear. Este objeto contiene las siguientes propiedades:
  • analysis: nombre del análisis.
  • variable_name: nombre de la variable.
  • layer_date: fecha de la capa - formato YYYY-MM-DDT00:00:00Z
  • layer_name: nombre de la capa
• interpolation_polygon:Boolean si el valor es falso se hace interpolación por kriging; en caso contrario se hace interpolación por el poligono del lote o del mapa que hace referencia el samplig.

Ejemplo de uso:

{
  "layers": [
    {
      "analysis": "0-20",
      "variable_name": "MO",
      "layer_date": "2024-11-26T16:29:31Z",
      "layer_name": "MO_20"
    }
  ],
  "interpolation_polygon": false
}

Errores

Estos errores son específicos de la API samplings, en adición a los errores generales de las APIs.

code	msg
-11	Permisos insuficientes