Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/danizd/geoviable/llms.txt

Use this file to discover all available pages before exploring further.

GeoViable’s cartographic viewer is a full-screen interactive Leaflet map centered by default on Galicia at latitude 42.8, longitude -8.0, zoom level 8. It is the starting point for every environmental feasibility assessment: before any analysis can be run, you must define the land parcel you want to evaluate by either drawing a polygon directly on the map or uploading a spatial file. The drawing workflow described here uses Leaflet Geoman, a plugin that adds a professional drawing toolbar directly to the map canvas.

Map controls overview

ControlLocationPurpose
Zoom in / Zoom outBottom-right (Leaflet built-in)Adjust map scale
✏️ Dibujar buttonFloating overlay, top of mapActivate / cancel polygon drawing mode
🛰️ Satélite buttonFloating overlay, top of mapToggle PNOA satellite imagery on/off
Geoman toolbarTop-left corner of the mapEdit (pencil) and delete (trash) drawn polygons

Base layers

GeoViable ships with two base layers you can switch between at any time:
  • OpenStreetMap — the default raster tile layer, loaded from https://{s}.tile.openstreetmap.org/{z}/{x}/{y}.png.
  • PNOA-IGN Satellite — high-resolution Spanish national orthophoto served as a WMS layer from https://www.ign.es/wms-inspire/pnoa-ma, using the OI.OrthoimageCoverage layer name.
The satellite layer can be toggled on or off via the 🛰️ Satélite floating button on the map or via the equivalent toggle in the sidebar’s Mapa base section.
Switch to the PNOA satellite layer before drawing polygons on agricultural land, forest parcels, or any area where field boundaries are unclear on the OpenStreetMap base. The high-resolution orthophoto makes it much easier to place vertices precisely along real parcel edges.

Drawing a polygon step by step

1

Open the drawing mode

Click the ✏️ Dibujar button that floats over the map. The button outline turns blue and the cursor changes to a crosshair, indicating that drawing mode is active. You can cancel at any time by clicking the button again before closing the polygon.
2

Place the first vertex

Click anywhere on the map to place the first vertex of your parcel polygon. A small circle marker appears at that point.
3

Trace the parcel boundary

Continue clicking to add successive vertices along the perimeter of your parcel. Each click adds a new corner point and a line segment connects it to the previous vertex. You can zoom or pan the map while in drawing mode without interrupting the polygon.
4

Close and finish the polygon

To complete the polygon, either double-click the final vertex or click back on the first vertex to close the ring. Leaflet Geoman will snap the last point to the first to form a closed polygon.
5

Review the result

After the polygon is closed, the map automatically calls fitBounds to zoom and pan so the entire polygon is visible within the viewport with a 50 px padding on all sides. The polygon is rendered with a #334155 (dark slate) border and a semi-transparent fill at 0.15 opacity. The parcel area in m² and hectares appears in the sidebar.

Polygon constraints enforced client-side

GeoViable validates your drawn polygon immediately after drawing completes. Any violation triggers an error toast and the polygon is removed from the map.
ConstraintLimitError message
Maximum area100 km²El polígono excede el área máxima permitida (100 km²)
Maximum vertex count10,000 verticesEl polígono tiene demasiados vértices (máximo 10.000)
Polygons per session1Ya existe un polígono. Bórralo antes de dibujar uno nuevo.
Geographic scopeGalicia bounding boxEl polígono se encuentra fuera de los límites de Galicia
GeoViable only supports one polygon at a time. If a polygon already exists on the map — whether drawn manually or loaded from a file — clicking ✏️ Dibujar will display an error and drawing mode will not activate. You must delete the existing polygon first using the Geoman trash icon before you can draw a new one.

Editing an existing polygon

To adjust the shape of a polygon after it has been drawn, use the Geoman edit mode accessible from the toolbar in the top-left corner of the map:
  1. Click the pencil icon in the Geoman toolbar to enter edit mode.
  2. Individual vertex handles appear on the polygon. Drag any handle to move that vertex.
  3. Click the pencil icon again (or click elsewhere) to exit edit mode and confirm the changes.
After editing, the polygon is re-validated against the same constraints (area, vertex count, bounds). If the edited shape violates any constraint, an error message is shown and the edit is not applied.

Deleting a polygon

You can delete the current polygon in two ways:
  • Geoman toolbar: Click the trash icon in the top-left Geoman toolbar, then click on the polygon on the map to remove it.
  • Sidebar shortcut: If a polygon is present, the 🗑️ Borrar polígono actual button appears in the sidebar’s drawing section. Click it to remove the polygon immediately.
After deletion, the map returns to the default Galicia view and the area display in the sidebar is cleared. You can then draw or upload a new parcel polygon.

Build docs developers (and LLMs) love