# Pywikibot/coordinate import.py

El script coordinate_import.py es una herramienta poderosa dentro de Pywikibot, diseñada para importar coordenadas geográficas desde diferentes fuentes externas, como archivos CSV, directamente a artículos de proyectos Wikimedia. Este script es particularmente útil en situaciones donde es necesario agregar o actualizar la información de coordenadas geográficas en una gran cantidad de páginas, como puede ser el caso de artículos sobre ubicaciones geográficas, monumentos o sitios de interés.

## Usos típicos

* Importar coordenadas de bases de datos externas a Wikidata.
* Añadir o actualizar coordenadas en plantillas de Wikipedia (por ejemplo, la plantilla de coordenadas).
* Automatizar la adición de información geográfica a artículos específicos.

## Sección teórica

El script coordinate_import.py funciona al tomar datos externos estructurados (como archivos CSV con coordenadas geográficas) y transformarlos en ediciones automáticas en una wiki. Utiliza la API de Pywikibot para interactuar con la base de datos del proyecto Wikimedia y modificar las páginas apropiadas. Este proceso automatizado reduce el tiempo necesario para ingresar manualmente las coordenadas y disminuye los errores humanos.
Algunos puntos clave del funcionamiento del script incluyen:
* Uso de la API de Wikidata para crear y actualizar elementos con coordenadas.
* Lectura y procesamiento de archivos CSV u otros formatos estructurados.
* Validación de datos de coordenadas para asegurarse de que sean precisos antes de importarlos.

## Requisitos previos

Antes de usar coordinate_import.py, asegúrate de tener lo siguiente:
* Instalación de Pywikibot: El entorno de Pywikibot debe estar correctamente configurado. Si no lo has hecho aún, consulta la guía oficial de instalación de Pywikibot.
* Conexión a Wikidata: Es necesario estar autenticado en Wikidata con permisos de edición.
* Conocimiento básico de Python y edición en Wikimedia: Aunque el script es relativamente sencillo de ejecutar, es útil tener un conocimiento básico de los comandos de Pywikibot y de la edición de páginas en Wikidata o Wikipedia.
* Archivos de datos: El script requiere un archivo CSV o similar que contenga coordenadas geográficas. Asegúrate de que tus datos estén bien formateados antes de proceder.

## Guía paso a paso
### Ejecución básica

Para empezar a usar el script, sigue los siguientes pasos:
* Preparación del archivo de coordenadas: Crea un archivo CSV que contenga las coordenadas que deseas importar. El archivo debe tener al menos tres columnas: el identificador del artículo, la latitud y la longitud. Ejemplo:
* Ejecución del script: Navega a la carpeta donde tienes Pywikibot instalado y ejecuta el script con el siguiente comando:
Aquí, -csvfile especifica la ubicación de tu archivo CSV. Asegúrate de que el formato y la ruta sean correctos.
* Verificación de datos: El script comenzará a procesar los datos y mostrar una salida en tu terminal. Verifica que las coordenadas se estén importando correctamente.

### Ejemplo práctico

Si tienes un archivo CSV con coordenadas de monumentos en una ciudad, el script podrá actualizarlas automáticamente en los artículos correspondientes de Wikipedia o Wikidata.

## Ejercicio práctico
### Tarea

Importa las coordenadas geográficas de un conjunto de monumentos en tu país.
* Prepara un archivo CSV con al menos cinco monumentos y sus respectivas coordenadas.
* Ejecuta el script para importar esas coordenadas en los artículos correspondientes de Wikidata.
* Reflexiona sobre los resultados: ¿Hubo algún problema con los datos? ¿Qué pasos adicionales se podrían tomar para mejorar la automatización en este caso?

### Preguntas de reflexión

* ¿Qué tan preciso fue el script al insertar las coordenadas?
* ¿Hubo algún error que tuviste que corregir manualmente? ¿Cómo lo solucionaste?

## Opciones avanzadas y parámetros

El script coordinate_import.py incluye diversas opciones y parámetros que permiten personalizar su comportamiento:
* -dry: Ejecuta el script en modo prueba, sin realizar cambios en las páginas.
Este parámetro es útil para verificar si los datos se procesarán correctamente antes de hacer modificaciones.
* -summary: Añade un resumen personalizado a las ediciones realizadas.
* -overwrite: Este parámetro permite sobrescribir coordenadas existentes en los artículos.

## Resolución de problemas comunes

* Error al procesar el archivo CSV: Asegúrate de que el formato del archivo sea correcto, con las columnas adecuadas. Revisa los delimitadores y el uso de comillas si es necesario.
* Coordenadas incorrectas: Verifica la precisión de tus coordenadas antes de la importación. Si las coordenadas son incorrectas, edita manualmente el archivo CSV y vuelve a ejecutar el script.
* Problemas de autenticación: Asegúrate de que tu cuenta esté correctamente configurada en Pywikibot y que tengas permisos de edición en los elementos de Wikidata que deseas modificar.

## Discusión y reflexión

Al trabajar con grandes volúmenes de datos geográficos, puede haber desafíos relacionados con la precisión y la verificación de la información. Algunos temas para discutir en un entorno colaborativo podrían incluir:
* ¿Cómo podemos garantizar que las coordenadas que importamos son precisas y confiables?
* ¿Qué otras fuentes de datos podríamos utilizar para mejorar el proceso de importación de coordenadas?
* ¿Sería útil implementar validaciones adicionales dentro del script para detectar errores de formato o datos duplicados?

## Conclusión

En este subartículo hemos explorado cómo usar el script coordinate_import.py de Pywikibot para importar coordenadas geográficas desde un archivo CSV a proyectos Wikimedia. El uso de este script es ideal para gestionar grandes volúmenes de datos geográficos de forma eficiente, ahorrando tiempo y reduciendo errores.

### Recursos adicionales

* Documentación oficial de Pywikibot
* Guía de edición en Wikidata