Communitygithub.com

cadastral-to-vector

Convierte mapas catastrales (PNG) a capas de polígonos vectoriales (FileGDB/Shapefile). Detecta automáticamente la zona de proyección Gauss-Krüger CGCS2000 y el eje de coordenadas, extrae coordenadas de puntos límite mediante OCR y realiza una autocomprobación de cierre de área.

¿Qué es cadastral-to-vector?

Esta habilidad está diseñada para convertir mapas catastrales en formato ráster (PNG/JPG) en capas de polígonos vectoriales (FileGDB o Shapefile) aptas para registros de propiedad. Es útil para profesionales de SIG, topógrafos y desarrolladores que necesiten transformar mapas catastrales escaneados, tablas de coordenadas de puntos límite o determinar la zona de proyección Gauss-Krüger CGCS2000 con precisión de registro de propiedad. El flujo de trabajo típico comienza extrayendo coordenadas de puntos límite mediante OCR avanzado (priorizando el MCP analyze_image, luego PaddleOCR o Tesseract), seguido de la detección automática de la zona de proyección (zona de 3 grados CGCS2000 con prefijo de zona) y el orden de los ejes (este/norte). Después, las coordenadas se conectan en orden para formar polígonos cerrados y se escriben en FileGDB o Shapefile usando arcpy (preferido) o GDAL como fallback. La habilidad incluye una autocomprobación de cierre de área comparando el área calculada con el área del mapa, alertando si la diferencia supera el 0,5 %. Todas las detecciones automáticas se muestran al usuario para confirmación, garantizando precisión de nivel catastral. Soporta campos de atributos personalizados (titular, número de parcela, área, etc.) e incluye un campo source_file para trazabilidad.

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add edcfoshan/cadastral-to-vector

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

Cadastral to Vector (Conversión de mapas catastrales a vector)

Convierte imágenes PNG de mapas catastrales en capas de polígonos vectoriales aptas para registros de propiedad. Ruta: extracción de coordenadas de puntos límite mediante OCR → detección automática de zona de 3 grados CGCS2000 + ejes → conexión secuencial en polígonos cerrados → escritura en FileGDB/Shapefile, con autocomprobación de cierre de área.

Cuándo usarlo

  • Mapas catastrales/planos de parcela (PNG/JPG) → GDB o capa de polígonos en Shapefile
  • Tabla de coordenadas de puntos límite existente → capa de polígonos
  • Necesidad de determinar la zona de proyección Gauss-Krüger CGCS2000 (EPSG)
  • Precisión de nivel de registro de propiedad (coordenadas exactas, cierre topológico)

Flujo de trabajo

  1. Confirmar entrada: mapa catastral PNG (principal) o tabla de coordenadas en texto/CSV (alternativa). Preguntar si se requiere precisión de registro de propiedad.
  2. Extraer coordenadas y atributos mediante OCR:
    • Priorizar analyze_image MCP (multimodal, el más preciso); en el prompt solicitar extracción exacta dígito a dígito de la tabla de coordenadas y atributos (titular, número de parcela, área, uso, colindantes); si no se ve claro, indicar "poco claro" sin adivinar.
    • Sin MCP, ejecutar scripts/ocr_coords.py --method auto (PaddleOCR → Tesseract).
    • Si nada funciona, pedir al usuario que transcriba manualmente.
  3. Mostrar tabla de coordenadas al usuario para verificar: los resultados del OCR deben mostrarse al usuario para revisión individual (no se debe confiar ciegamente en precisión catastral). Las coordenadas verificadas se guardan en pts.txt (cada línea: punto_id, columnaA, columnaB, en orden de conexión de límites).
  4. Detección automática de zona, ejes y sistema de coordenadas: ejecutar scripts/coords_to_feature.py --coords pts.txt --source <imagen> --detect-only, o explicar según reglas:
    • Si una columna tiene prefijo de zona (número de 8 dígitos, primeros 2 entre 25-45) → esa columna es la coordenada este; la otra es norte.
    • Prefijo N → EPSG = 4488 + N, meridiano central = 3N.
    • Si ninguna columna tiene prefijo → solicitar al usuario la zona y el orden de ejes.
  5. El resultado de la detección debe ser confirmado por el usuario (paso obligatorio del flujo): mostrar zona/meridiano central/EPSG/columna este/columna norte; el usuario confirma antes de continuar.
  6. Campos de atributos: preguntar al usuario si desea incluir campos de negocio (titular, número de parcela, área, etc., seleccionables del resultado del OCR); el campo source_file se agrega automáticamente (registra la ruta del archivo de origen, trazable).
  7. Escribir GDB/shp: ejecutar scripts/coords_to_feature.py --out xxx.gdb --fig-area <área_en_imagen> [--attrs-json ...]. arcpy tiene prioridad; si no está disponible, fallback a GDAL; si no se puede escribir GDB, fallback a Shapefile.
  8. Autocomprobación y entrega: revisar la autocomprobación de área de la salida del script (PASS/FAIL); si FAIL, verificar coordenadas. Entregar .gdb/.shp, indicando que la tabla de atributos contiene source_file.

Dependencias

  • Python 3
  • Para escribir GDB: arcpy (incluido con ArcGIS Pro, entorno arcgispro-py3) o GDAL/osgeo ≥ 3.6 (controlador OpenFileGDB puede crear GDB)
  • OCR: analyze_image MCP (prioritario) / PaddleOCR / Tesseract (chi_sim) / transcripción manual

Scripts

  • scripts/coords_to_feature.py: tabla de coordenadas → capa de polígonos GDB/shp (detección automática + fallback arcpy/GDAL + source_file + autocomprobación de área)
  • scripts/ocr_coords.py: PNG → tabla de coordenadas + atributos (cadena de fallback PaddleOCR/Tesseract)

Notas

  • Precisión de registro de propiedad: un error de coordenada es un incidente grave. Todos los resultados de OCR y detección automática deben ser confirmados por el usuario.
  • Autocomprobación de área: compara el área calculada con el área del mapa; si el error supera el 0.5 %, se genera una alerta. Si los ejes están invertidos, el área calculada no cambia, por lo que la autocomprobación no lo detecta; la verificación del orden de ejes se realiza en el paso 5.
  • Múltiples parcelas: actualmente se admite una parcela por imagen (un polígono); la extensión a múltiples parcelas está planificada para el futuro.
  • Shapefile: los nombres de campo están limitados a 10 bytes; los nombres de campo de negocio en chino se truncarán. Se recomienda usar GDB o nombres de campo en inglés.

Skills relacionados