De direcciones a coordenadas

14/08/2026 · Eduard Kazakov, Claudio Matko

Geocodificación con NextGIS Toolbox

Una hoja de cálculo con direcciones es casi un conjunto de datos espaciales: puede contener oficinas, clientes, ubicaciones de muestreo, objetos de infraestructura, escuelas, tiendas o cualquier otro tipo de lugar. Pero sin coordenadas, todavía no puedes poner esos registros en un mapa.

La geocodificación cierra esta brecha al convertir direcciones legibles por humanos y nombres de lugares en coordenadas geográficas.

NextGIS Toolbox proporciona dos herramientas para flujos de trabajo comunes de geocodificación:

Geocode a table: procesa un archivo CSV que contiene direcciones y añade latitud y longitud a cada registro geocodificado con éxito.
Geocode with Nominatim: resuelve una dirección o nombre de lugar individual utilizando OpenStreetMap Nominatim y devuelve sus coordenadas y su cuadro delimitador.

La primera convierte una tabla existente en un conjunto de datos listo para mapear. La segunda es particularmente útil cuando necesitas localizar un lugar o definir un área geográfica para otra tarea de procesamiento.

Puntos clave

Convierte una lista de direcciones en CSV en una tabla geocodificada sin tener que escribir un script.
Utiliza el geocodificador OpenStreetMap Nominatim o, para la geocodificación de tablas, otro proveedor compatible con tu propia clave API.
Conserva todos los atributos originales del CSV mientras añade latitud y longitud.
Convierte una ciudad, dirección o nombre de lugar en un dato geoespacial adecuado como entrada para otras herramientas de Toolbox.
Ejecuta ambos flujos de trabajo desde el navegador o automatízalos a través de la API de NextGIS Toolbox y el Python SDK.

Geocodificar una tabla de direcciones

Considera un conjunto de datos típico mantenido fuera de un SIG:

nombre	tipo	dirección
The Bright Lights	oficina	Bulevar oslobođenja 30, Novi Sad, Serbia
The Garden	almacén	Svetosavska 6, Nis, Serbia
X109 Group	oficina	Trg republike 5, Beograd, Serbia

Estos son datos comerciales útiles, pero el software SIG no sabe dónde pertenecen geográficamente estos registros. La herramienta Geocode a table toma un archivo CSV como este, envía los valores del campo de dirección seleccionado a un geocodificador y devuelve otro CSV que contiene los atributos originales más la latitud y la longitud.

El flujo de trabajo requiere cuatro parámetros.

1. Archivo fuente: Sube un archivo CSV que contenga tus datos. La primera fila debe contener los nombres de los campos y el archivo debe usar codificación UTF-8.
2. Geocodificador: Selecciona el proveedor de geocodificación. OpenStreetMap Nominatim está disponible sin clave API. Los demás geocodificadores disponibles requieren las credenciales del servicio correspondiente y están sujetos a las condiciones de licencia y uso de sus proveedores.
3. Campo de dirección: Selecciona la columna del CSV que contiene la dirección a geocodificar. Por ejemplo, dirección. Idealmente, los valores deben contener suficiente información para identificar una ubicación sin ambigüedades: Marienplatz 1, München, Alemania generalmente será más útil para un geocodificador que Marienplatz 1.
4. Clave API: Para Nominatim, deja este campo vacío. Cuando uses otro geocodificador compatible, proporciona una clave API para ese servicio.

Resultado

Ejecuta la herramienta y el CSV resultante contendrá todos los datos de origen más dos columnas adicionales con las coordenadas geográficas. Además, se crea automáticamente un GeoPackage junto con el archivo CSV.

El resultado se puede abrir en QGIS, importar a una base de datos, procesar con Python o utilizar en otro flujo de trabajo SIG.

Dónde es útil la geocodificación de tablas

Las listas de direcciones aparecen en casi todos los sectores:

Ubicaciones de clientes y socios. Mapa CRM de exportaciones o territorios de ventas.
Inventarios de activos. Convierte registros basados en direcciones de edificios y equipos en capas SIG.
Educación y salud. Mapa de escuelas, clínicas, farmacias u otros centros.
Trabajos de campo. Prepara un conjunto de datos espaciales a partir de ubicaciones recopiladas originalmente como direcciones.
Estudios urbanos. Localiza negocios, servicios, objetos culturales o infraestructura pública.
Logística. Mapa de almacenes, destinos de entrega y puntos de servicio.
Investigación. Espacializa registros tabulares ensamblados a partir de informes, archivos o bases de datos externas.

¡Toda la tabla se puede procesar en una sola ejecución!

Geocodificar un solo lugar con Nominatim

A veces ni siquiera tienes una tabla, solo sabes el lugar que te interesa. Para este caso, NextGIS Toolbox proporciona Geocode with Nominatim.

La herramienta envía la consulta a la API de OpenStreetMap Nominatim y devuelve la ubicación encontrada junto con sus coordenadas geográficas y su cuadro delimitador.

Hay dos entradas.

1. Dirección / Nombre de lugar: Ingresa un nombre de lugar o dirección legible por humanos. Por ejemplo: Buxoro shahri
2. Amortiguamiento (buffer): Opcionalmente, expande el cuadro delimitador devuelto por una distancia especificada en kilómetros. Esto es útil cuando una dirección puntual debe convertirse en un área de trabajo práctica. Por ejemplo, geocodificar una dirección con un amortiguamiento de 5 km te da una extensión geográfica que cubre los alrededores de esa dirección.

Resultado

La herramienta Nominatim devuelve varias salidas:

un cuadro delimitador en JSON que contiene oeste, sur, este y norte;
un resumen legible por humanos del resultado de la geocodificación;
un manifiesto JSON completo que contiene coordenadas, cuadro delimitador, área y metadatos adicionales.

¡La salida del cuadro delimitador es especialmente útil! Esta es la misma representación que comúnmente utilizan otras herramientas de geoprocesamiento y descarga de datos. Eso significa que la geocodificación puede ser el primer paso de un flujo de trabajo más grande en Toolbox.

¿Qué herramienta deberías usar?

	Geocode a table	Geocode with Nominatim
Entrada	CSV con muchas direcciones	Una dirección o nombre de lugar
Propósito principal	Añadir coordenadas a los registros	Resolver una ubicación y su extensión
Salida	CSV con latitud y longitud; GeoPackage	Coordenadas, cuadro delimitador, metadatos JSON
Geocodificador	Nominatim, Yandex o Google	OpenStreetMap Nominatim
Clave API	No requerida	No requerida para Nominatim
Ideal para	Convertir direcciones en conjuntos de datos listos para SIG	Encontrar un área para otra operación espacial

Usa Geocode a table cuando las direcciones sean en sí mismas tu conjunto de datos.

Usa Geocode with Nominatim cuando una dirección o nombre de lugar describa dónde debería ocurrir otra operación.

Ejecutar geocodificación desde Python

Al igual que otras herramientas de NextGIS Toolbox, ambas operaciones de geocodificación también están disponibles mediante programación.

Cada página de herramienta incluye un ejemplo listo para usar del NextGIS Toolbox SDK.

Instálalo con pip install toolbox-sdk

Por ejemplo, Geocode with Nominatim se puede invocar a través del SDK usando el identificador de la herramienta:

from toolbox_sdk import ToolboxClient 

# Inicializa el cliente de Toolbox 
toolbox = ToolboxClient("TU_CLAVE_API_TOOLBOX") 

# Selecciona la herramienta 
nominatim_geocode = toolbox.tool("nominatim_geocode") 

# Geocodifica un lugar y expande su cuadro delimitador en 5 km 
result = nominatim_geocode( { 
             "query": "Novi Sad, Serbia",
             "buffer_km": 5,
         })
# Inspecciona todas las salidas devueltas
print(result.outputs)

y Geocode a table a través de:

from toolbox_sdk import ToolboxClient 

# Inicializa el cliente de Toolbox
toolbox = ToolboxClient("TU_CLAVE_API_TOOLBOX") 

# Selecciona la herramienta 
geocodetable = toolbox.tool("geocodetable") 

# Ejecútala de forma sincrónica 
result = geocodetable( { 
             "table": toolbox.upload_file("offices.csv"),
             "geocoder_vendor": "nominatim",
             "addr_field": "address",
             "api_key": "", 
         })
# Descarga el CSV resultante en el directorio actual
toolbox.download_results(result, ".")

Esto hace que la geocodificación sea fácil de incluir en scripts y en flujos de procesamiento más grandes.

Por ejemplo, un flujo de trabajo automatizado podría: Exportar direcciones desde una base de datos -> Geocodificar el CSV -> Crear entidades espaciales -> Ejecutar análisis espacial -> Publicar el resultado
Otra aplicación podría comenzar solo con un lugar proporcionado por el usuario: el usuario ingresa “Novi Sad, Serbia” -> Geocode with Nominatim -> Obtener cuadro delimitador -> Solicitar datos para esta área -> Ejecutar análisis

Estas herramientas son útiles tanto como utilidades basadas en el navegador como componentes básicos para el procesamiento geoespacial reproducible.

Comienza ahora

Ambas herramientas son gratuitas. Todo lo que necesitas hacer es crear una cuenta en my.nextgis.com.