feat(plugins): data overlays (MIN-222)

Overlays

Get list of available data overlays

To get list of available data overlays, plugins can use the getDataOverlays method defined in window.minerva.overlays.data. This method returns array with all overlays.

Example of getDataOverlays usage:

window.minerva.overlays.data.getDataOverlays();

Get list of visible data overlays

To get list of visible data overlays, plugins can use the getVisibleDataOverlays method defined in window.minerva.overlays.data. This method returns array with all visible data overlays.

Example of getVisibleDataOverlays usage:

window.minerva.overlays.data.getVisibleDataOverlays();

Show an overlay

To show an overlay, plugins can use the showDataOverlay method defined in window.minerva.overlays. This method takes one argument: the ID of the overlay that the plugin wants to show.

Example of showDataOverlay usage:

window.minerva.overlays.showDataOverlay(109);

Hide an overlay

To hide an overlay, plugins can use the hideDataOverlay method defined in window.minerva.overlays. This method takes one argument: the ID of the overlay that the plugin wants to hide.

Example of showDataOverlay usage:

window.minerva.overlays.hideDataOverlay(109);

Add an overlay

To add an overlay, plugins can use the addDataOverlay method defined in window.minerva.overlays. This method takes one argument: the object with the following properties:

• name (string): The name of the overlay.

• description (optional string): A description of the overlay.

• filename (optional string): The filename of the overlay data.

• fileContent (string or text File): The content of the overlay data.

• type (optional string): The type of overlay data.

Example of addDataOverlay usage:

window.minerva.overlays.addDataOverlay({
  name: 'Plugin Test',
  fileContent: 'plugin test content',
});

Remove an overlay

To remove an overlay, plugins can use the removeDataOverlay method defined in window.minerva.overlays. This method takes one argument: the ID of the overlay that the plugin wants to remove.

Example of removeDataOverlay usage:

window.minerva.overlays.removeDataOverlay(129);

Get Api Urls: To get Api urls associated with the project, plugins can use the getApiUrls method defined in window.minerva.project.data object.

Example usage of getApiUrls method:

window.minerva.project.data.getApiUrls();

docs/plugins/errors.md

@@ -18,6 +18,22 @@
 
 - **Project does not exist**: This error occurs when the project data is not available.
 
+- **Project ID does not exist**: This error occurs when the project ID is not available.
+
+## Overlay Errors
+
+- **Overlay name is not provided**: This error occurs when the name of the overlay is missing or not provided.
+
+- **Failed to read file**: This error occurs when there is an issue reading the content of a file. Check if it's text file.
+
+- **Invalid type of fileContent**: This error occurs when the fileContent parameter is of an invalid type.
+
+- **Overlay with provided id does not exist**: This error occurs when the provided overlay id does not correspond to any existing overlay.
+
+- **Overlay with provided id is not active**: This error occurs when the provided overlay id corresponds to an overlay that is not currently active.
+
+- **Overlay with provided id is already active**: This error occurs when the provided overlay id corresponds to an overlay that is already active.
+
 ## Zoom errors
 
 - **Provided zoom value exeeds max zoom of ...**: This error occurs when `zoom` param of `setZoom` exeeds max zoom value of the selected map