Genera un mapa cartográfico técnico con layout formal completo: título institucional · panel lateral (leyenda, convenciones, índice de localización) · franja inferior (norte, escala, parámetros/fuente). Devuelve además un reporte textual de la simbología realmente aplicada a cada capa: VERIFICARLO antes de afirmar que un color/estilo cambió.

Usar para productos formales ("mapa cartográfico", "carta", "entrega", "producto"). Para exploración rápida usar export_map_image.

Args: path: Ruta al archivo o directorio espacial. layer: Nombre de la capa (None = primera capa). limit: Máximo de features (default 5000). color_by: Campo para colorear por categoría (colores automáticos). where: Filtro SQL OGR. Si se aplica, la extensión del mapa se ajusta (zoom) a las features filtradas; las capas extra quedan como contexto recortado sin ampliar la vista. bbox: Extensión [xmin, ymin, xmax, ymax] en el CRS de la capa. style: Estilo avanzado (mismo formato que export_map_image): Categorizado: {"type":"categorized","field":"X", "categories":{"A":"#e74c3c"}} Graduado: {"type":"graduated","field":"X", "ramp":"RdYlGn_r","breaks":5} output_path: Ruta de salida. .jpg para trabajo, .pdf para entrega. Default: "{capa}_cartographic.jpg" junto al archivo fuente. dpi: Resolución (default 150). Con dpi > 150 los tiles del basemap se piden a mayor zoom para mantener la nitidez (descarga más tiles: más lento). figsize: [ancho, alto] en pulgadas. Default auto-calculado. title: Título del mapa. Default: nombre de la capa. credits: Texto de fuente/créditos para el panel inferior. Ej: "Fuente: IGAC 2024 | Sistema: WGS84 EPSG:4326" label_by: Campo para etiquetar features de la capa PRINCIPAL (colocación inteligente, anclada en la parte visible de la geometría). Para etiquetar capas extra, usar la clave 'label_by' dentro de cada entrada de extra_layers. El reporte de salida SIEMPRE indica cuántas etiquetas se renderizaron y cuántas se omitieron (y por qué). label_collision: "auto" (default) descarta etiquetas solapadas o de polígonos que ocupan <0.02% de la vista; "none" renderiza TODAS las etiquetas visibles aunque se amontonen. extra_layers: Capas adicionales (mismo formato que export_map_image, incluidas las claves 'crs' para capas sin CRS definido, 'label_by' para etiquetar cada capa extra por su propio campo, 'where' para filtrarla por atributo, y 'color_by'/'style' para categorizarla sin dividir el archivo). IMPORTANTE: pasar SIEMPRE 'color' explícito y distinto por capa (matiz diferente) y 'label' descriptivo; el gris default es solo para capas de puro contexto. source_crs: CRS a asumir para la capa principal SOLO si el archivo no define uno (ej. "EPSG:3116"). Ver export_map_image. basemap: URL de un basemap alternativo al default Esri World Light Gray Canvas: raíz de un ArcGIS MapServer con cache de tiles en Web Mercator o plantilla XYZ con tokens {z}/{x}/{y}. Ver export_map_image. markersize: Tamaño del marcador para capas de puntos, en pt². Default None = automático según número de puntos y ancho del lienzo, con halo blanco. Ver export_map_image.

Genera una imagen del mapa con basemap Esri World Light Gray Canvas mostrada INLINE en el chat y guardada en disco en alta resolución. Devuelve además un reporte textual de la simbología realmente aplicada a cada capa: VERIFICARLO antes de afirmar que un color/estilo fue cambiado.

Args: path: Ruta al archivo o directorio espacial. layer: Nombre de la capa (None = primera capa). limit: Máximo de features (default 5000). color_by: Campo para colorear por categoría con colores automáticos. Alternativa simple a style. where: Filtro SQL OGR. Si se aplica, la extensión del mapa se ajusta (zoom) a las features filtradas; las capas extra quedan como contexto recortado sin ampliar la vista. bbox: Extensión [xmin, ymin, xmax, ymax]. style: Estilo avanzado: Categorizado: {"type": "categorized", "field": "Tipo", "categories": {"A": "#e74c3c", "B": "#2ecc71"}} Graduado: {"type": "graduated", "field": "Tiempo", "ramp": "RdYlGn_r", "breaks": 5} breaks = int (clases iguales) o lista de cortes explícitos. Rampas útiles: RdYlGn_r, YlOrRd, Blues, viridis, plasma. "field" en style tiene precedencia sobre color_by. output_path: Ruta completa de salida incluyendo extensión. .png = PNG lossless · .jpg = JPEG · .pdf = PDF vectorial · .svg = SVG. Si None guarda "{capa}_map.jpg" junto al archivo fuente. legend: Mostrar leyenda (default True). dpi: Resolución en DPI para disco (default 150). La imagen inline del chat siempre usa 72 DPI para mantener el tamaño manejable. Con dpi > 150 los tiles del basemap se piden a mayor zoom para mantener la nitidez (descarga más tiles: más lento). figsize: Tamaño [ancho, alto] en pulgadas, ej. [14, 8.5] para A4 horizontal. Default [10, 6]. scalebar: Mostrar barra de escala en esquina inferior izquierda (default True). north_arrow: Mostrar flecha de norte en esquina superior izquierda (default True). credits: Texto de créditos en pie de mapa, ej. "Fuente: INEGI 2024 | Elaborado con GeoAnalisis MCP". label_by: Campo para etiquetar cada feature de la capa PRINCIPAL (anclaje dentro de la parte visible de la geometría). Para etiquetar capas extra, usar la clave 'label_by' dentro de cada entrada de extra_layers. El reporte de salida SIEMPRE indica cuántas etiquetas se renderizaron y cuántas se omitieron (y por qué). label_collision: "auto" (default) descarta etiquetas que se solapan o cuyo polígono ocupa <0.02% de la vista; "none" desactiva ambos filtros y renderiza TODAS las etiquetas visibles aunque se amontonen. Usar "none" cuando el usuario pida ver todas. extra_layers: Capas adicionales a superponer sobre el basemap, en orden ascendente (primera entrada = capa más baja). Cada capa aparece en la leyenda. IMPORTANTE: pasar SIEMPRE 'color' explícito y distinto por capa (matiz diferente); el gris default es solo para puro contexto. Cada entrada es un dict con: path (str, requerido), layer (str), limit (int, default 10000), where (str; filtro SQL OGR aplicado a ESA capa, ej. "INTERVALO <= 10"), color_by (str; campo de ESA capa para colorear por categorías — un solo archivo con clases, sin dividirlo en varios), style (dict; simbología avanzada de ESA capa, mismo formato que el style de la capa principal: type "categorized" con categories, o "graduated" con field/ramp/breaks. La leyenda muestra cada clase prefijada con el nombre de la capa), color (str; ej. "#e74c3c". Default "#888" gris. Ignorado si se pasa color_by o style), alpha (float; default 0.9 líneas, 0.7 resto), linewidth (float; default 1.5 líneas, 0.5 resto), linestyle (str, default "-"; "--" discontinua, ":" punteada), edgecolor (str, default "none"), markersize (float, default 4), label (str; nombre en leyenda, default nombre de capa/archivo), label_by (str; campo de ESA capa para etiquetar sus features — colocación inteligente compartida con la capa principal: las etiquetas de la principal tienen prioridad), zorder (int; opcional, para dibujar sobre la capa principal), crs (str; ej. "EPSG:9377". Solo si el archivo NO define CRS: se asume ese. Si define uno, se respeta el del archivo). Cualquier otra clave se ignora y se reporta en el texto de salida. source_crs: CRS a asumir para la capa principal SOLO si el archivo no define uno (ej. "EPSG:3116"). Sin esto, una capa sin CRS con bounds lon/lat se asume EPSG:4326; con bounds proyectados se rechaza indicando cómo corregir. Todas las capas se reproyectan automáticamente a Web Mercator para el render. basemap: URL de un basemap alternativo al default Esri World Light Gray Canvas. Acepta la raíz de un servicio ArcGIS MapServer con cache de tiles en Web Mercator (ej. "https://host/arcgis/rest/services/ Nombre/MapServer": se valida el cache y se usa la plantilla /tile/{z}/{y}/{x}, con atribución del copyrightText) o una plantilla XYZ con tokens, ej. "https://tile.host/{z}/{x}/{y}.png". Si los tiles fallan al descargar se usa Esri World Light Gray Canvas como fallback y se reporta en el texto de salida. markersize: Tamaño del marcador para capas de puntos, en pt² (semántica matplotlib; ej. 100 ≈ círculo de 3.5 mm). Default None = automático según número de puntos y ancho del lienzo, con halo blanco para resaltar sobre el basemap.

Obtiene el esquema completo de una capa espacial.

Devuelve: nombre de la capa, driver GDAL, tipo de geometría, número de features, CRS (código EPSG + WKT), extensión espacial (bbox) y lista de campos con sus tipos.

Args: path: Ruta al archivo o directorio espacial. layer: Nombre de la capa. Si es None usa la primera capa disponible.

Lista todas las capas disponibles en una fuente de datos espacial.

Soporta .gdb (FileGDB), .gpkg, .shp, .geojson, .kml y cualquier formato GDAL/OGR. Devuelve por capa: nombre y tipo de geometría, vía la enumeración liviana del catálogo (no abre cada capa individualmente) — seguro incluso en FileGDBs con cientos de capas o archivos .lock/.sr.lock residuales de ediciones previas en ArcGIS, donde abrir capa por capa puede colgar el driver OpenFileGDB.

Para feature_count, CRS, bbox y campos de una capa puntual usa get_layer_schema(layer=...).

Args: path: Ruta absoluta al archivo o directorio (.gdb es un directorio).

Previsualiza las geometrías de los primeros N features como WKT.

Devuelve para cada feature: índice, tipo de geometría, WKT de la geometría y su bounding box individual.

Args: path: Ruta al archivo o directorio espacial. layer: Nombre de la capa (None = primera capa). limit: Número de features a previsualizar (default 5).

Lee features de una capa y los devuelve como GeoJSON FeatureCollection.

Args: path: Ruta al archivo o directorio espacial. layer: Nombre de la capa (None = primera capa). limit: Número máximo de features a retornar (default 10). where: Filtro SQL OGR, ej: "POBLACION > 5000 AND TIPO = 'urbano'". bbox: Filtro espacial [xmin, ymin, xmax, ymax] en el CRS de la capa. geometry: Representación de la geometría en la salida — clave para no agotar el límite de salida con polígonos complejos (miles de vértices): "full" (default) geometría completa. "simplified" Douglas-Peucker con simplify_tolerance. "centroid" un punto representativo dentro de cada geometría. "bbox" el rectángulo envolvente de cada feature. "none" solo atributos; agrega la propiedad "bbox" [xmin, ymin, xmax, ymax] por feature. simplify_tolerance: Tolerancia para geometry="simplified", en unidades del CRS de la capa. Default: 1/1000 del lado mayor del bbox del resultado.

Si el resultado excede el límite de tamaño de salida devuelve un error con sugerencias (reducir limit, filtrar con where/bbox, o bajar el detalle con geometry="simplified"/"centroid"/"bbox"/"none").

Mapa DINÁMICO interactivo con Leaflet: pan, zoom, clic para inspeccionar atributos, VARIAS capas con control on/off (extra_layers), basemap configurable, simbología categorized/graduated (style), etiquetas (label_by), leyenda, escala y coordenadas del cursor.

Úsala cuando el usuario pida un mapa dinámico/interactivo, quiera COMBINAR VARIAS capas, pida un basemap específico o quiera el mapa como archivo HTML. Para la vista rápida de UNA sola capa en el chat usa view_layer; para una imagen estática export_map_image; para un producto formal con layout export_map_cartographic. No construyas mapas a mano con pyshp/pyproj/folium/Leaflet ni artefactos — NUNCA es necesario: esta herramienta embebe los datos server-side sin gastar contexto.

Genera DOS salidas: la vista inline del chat (los tiles externos están bloqueados en el sandbox, así que dibuja una grilla de coordenadas como fondo de respaldo) y un HTML de ALTA FIDELIDAD guardado en disco, donde el basemap sí carga al abrirlo en un navegador.

Args: path: Ruta al archivo o directorio espacial. layer: Nombre de la capa (None = primera capa). limit: Máximo de features a renderizar (default 2000). color_by: Campo para colorear features por categoría. where: Filtro SQL OGR. bbox: Extensión espacial [xmin, ymin, xmax, ymax]. source_crs: CRS a asumir SOLO si el archivo no define uno (ej. "EPSG:3116"). Se reproyecta automáticamente a WGS84. style: Estilo avanzado categorized/graduated, mismo formato que export_map_image ("field" tiene precedencia sobre color_by). label_by: Campo para etiquetar features (tooltip fijo si ≤30 features; al pasar el cursor si son más). extra_layers: Capas adicionales bajo la principal, cada una con checkbox on/off en el control de capas. Entrada: dict con path (requerido), layer, limit (default 10000), where (filtro SQL OGR sobre ESA capa), color (IMPORTANTE: explícito y distinto por capa), alpha, linewidth, linestyle ("--" discontinua, ":" punteada), label, markersize, crs (solo si el archivo no define CRS). Para categorizar una capa extra por campo (color_by/style) usa export_map_image o export_map_cartographic. basemap: URL de basemap alternativo (raíz de ArcGIS MapServer tileado o plantilla XYZ {z}/{x}/{y}), igual que en los exports. Default Esri World Light Gray Canvas. Solo visible fuera del sandbox. markersize: Tamaño de puntos de la capa principal en pt² (semántica de los exports); default automático según cantidad de puntos. output_path: Ruta del HTML de alta fidelidad. Default: junto al archivo fuente como "{capa}_dynamic.html".

Calcula estadísticas descriptivas por campo en una capa espacial.

Campos numéricos → min, max, media, desviación estándar, nulos. Campos de texto/categoría → conteo de únicos, muestra de valores, nulos.

Args: path: Ruta al archivo o directorio espacial. layer: Nombre de la capa (None = primera capa). fields: Lista de campos a analizar. None = todos los campos no-geometría. max_features: Límite de features a leer para calcular estadísticas (default 50000).

Vista rápida de UNA capa, mostrada directamente en el chat. Úsala cuando el usuario pida "ver", "visualizar" o "mostrar" una capa, un "mapa básico" o una vista simple — sin multicapa, sin basemap y sin archivos.

Devuelve DOS representaciones de la misma vista, sin depender de detectar el cliente MCP: una IMAGEN estática (JPEG inline, sin basemap/escala/norte) que se muestra en cualquier cliente — es la garantía real de visibilidad, incluyendo Claude Desktop/Cowork, que no renderiza recursos HTML — y, además, un mapa HTML interactivo (pan/zoom, popups de atributos al clic, grilla de coordenadas de fondo) que solo se ve inline en clientes que renderizan recursos text/html como iframe (ej. claude.ai); en los que no, llega como texto/JSON crudo y debe ignorarse — no es un error de datos. NUNCA construyas esta vista a mano con HTML/folium/Leaflet ni artefactos: esta herramienta embebe los datos server-side sin gastar contexto.

Escalar a otra herramienta cuando el usuario pida más: varias capas, basemap o archivo HTML → render_map · imagen con basemap/escala/norte/ disco → export_map_image · producto formal con layout → export_map_cartographic.

Args: path: Ruta al archivo o directorio espacial. layer: Nombre de la capa (None = primera capa). limit: Máximo de features a renderizar (default 2000). color_by: Campo para colorear features por categoría. where: Filtro SQL OGR. bbox: Extensión espacial [xmin, ymin, xmax, ymax]. source_crs: CRS a asumir SOLO si el archivo no define uno (ej. "EPSG:3116"). Se reproyecta automáticamente a WGS84. style: Estilo avanzado categorized/graduated, mismo formato que export_map_image ("field" tiene precedencia sobre color_by). label_by: Campo para etiquetar features (tooltip fijo si ≤30 features; al pasar el cursor si son más). markersize: Tamaño de puntos en pt² (semántica de los exports); default automático según cantidad de puntos.