5. Capas

Cada capa (Layer) representa un recursos. Es la entidad objetivo de almacenamiento del sistema.

Una capa queda definida por el siguiente JSON:

{
  "data": "string: datos a almacenar",
  "description": "string: descripción de los datos",
  "format": "GEOJSON | GEOJSON_CSS | WKT | GML | KML | TOPO_JSON | CUSTOM_TEXT",
  "id": "string: identificador autoasignado (debe indicarse para actualizar o consultar)",
  "lastUpdate": "última fecha de modificacion: por ejemplo 2017-12-15T11:20:38.987Z",
  "name": "string: nombre de la capa (no puede quedar vacío)",
  "openData": true,
  "projection": "string: proyección correspondiente a los datos"
}

API

Se puede acceder a la documentación completa en la url http://localhost:8080/swagger-ui.html del propio despliegue.

Para poder acceder a los recursos ofrecidos para usuario se debe estar autenticado con el ROL necesario. A continuación se detalla la API disponible para Usuarios.

GET /layers

Obtiene, de manera paginada, todas las capas almacenadas en el sistema

Cabeceras	Autorización	Respuesta	Parámetos
Content-Type: application/json Authorization: Bearer token	STORE_ADMIN o DATA_MANAGER	200 Página	page, size, sort spring page and sorting

Ejemplo de respuesta:

{
  "content": [
    {
      "data": "string",
      "description": "string",
      "format": "GEOJSON",
      "id": "string",
      "lastUpdate": "2017-12-26T08:07:52.050Z",
      "name": "string",
      "openData": true,
      "projection": "string"
    }
  ],
  "first": true,
  "last": true,
  "number": 0,
  "numberOfElements": 0,
  "size": 0,
  "sort": {},
  "totalElements": 0,
  "totalPages": 0
}

GET /opendata/layers

Obtiene, de manera paginada, todas las capas opendata almacenadas en el sistema. Son capas de libre acceso para todo el mundo, es decir, este recurso no requiere autenticación ni autorización.

Cabeceras	Autorización	Respuesta	Parámetos
Content-Type: application/json	NO REQUERIDA	200 Página	page, size, sort spring page and sorting

Ejemplo de respuesta:

{
  "content": [
    {
      "data": "string",
      "description": "string",
      "format": "GEOJSON",
      "id": "string",
      "lastUpdate": "2017-12-26T08:07:52.050Z",
      "name": "string",
      "openData": true,
      "projection": "string"
    }
  ],
  "first": true,
  "last": true,
  "number": 0,
  "numberOfElements": 0,
  "size": 0,
  "sort": {},
  "totalElements": 0,
  "totalPages": 0
}

GET /layers/{id}

Obtiene la capa indicada.

Cabeceras	Autorización	Respuesta	Parámetos
Content-Type: application/json Authorization: Bearer token	STORE_ADMIN DATA_MANAGER o usuario con acceso otorgado de lectura	200 Página	id: identificador del recurso

Ejemplo de respuesta:

{
  "data": "string: datos de la capa en formato GEOJSON",
  "description": "string",
  "format": "GEOJSON",
  "id": "5a3d276e99b0c811e95c4340",
  "lastUpdate": "2017-12-26T08:07:52.308Z",
  "name": "string",
  "openData": false,
  "projection": "string"
}

GET /opendata/layers/{id}

Obtiene la capa indicada.

Cabeceras	Autorización	Respuesta	Parámetos
Content-Type: application/json	NO REQUIERE	200 Página	id: identificador del recurso

Ejemplo de respuesta:

{
  "data": "string: datos de la capa en formato GEOJSON",
  "description": "string",
  "format": "GEOJSON",
  "id": "5a3d276e99b0c811e95c4340",
  "lastUpdate": "2017-12-26T08:07:52.308Z",
  "name": "string",
  "openData": true,
  "projection": "string"
}