Recursos

1.- ASPECTOS TÉCNICOS: FORMATO XML, JSON Y FECHAS

Los conjuntos de datos disponibles en estos formatos se pueden identificar gracias a las etiquetas de formato que aparecen bajo la descripción en el catálogo de datos. Si se desea descargar los datos, es necesario acceder al conjunto de datos y, a continuación, pinchar sobre el botón “Explora” y seleccionar el formato de descarga.

En la nueva plataforma de datos abiertos del Gobierno de Navarra, los formatos XML, JSON y fechas se presentan con una estructura distinta a la del portal anterior.
 

XML:
Anteriormente, la etiqueta de inicio de los documentos XML era <OpenData>, en cambio, actualmente, se ha modificado por <data>. Además, la etiqueta de fila <OpenData> se ha sustituido por <row _id=" ">, donde se indica el número de fila.
Fuente: Captura del documento XML de Centros sanitarios del portal de Datos Abiertos de Navarra
 
JSON:
Actualmente su estructura se compone de dos bloques: por un lado, el bloque fields, donde se recoge el identificador del campo y el tipo de datos que contiene, y, por otro lado, el bloque records, que contiene los valores de cada campo por filas.
Fuente: Captura del documento JSON de Centros sanitarios del portal de Datos Abiertos de Navarra

 
FECHAS:
Respecto al formato de las fechas, por defecto estas se proporcionan en formato texto, no obstante, es posible que en determinados datasets se haya modificado y, en ese caso, se proporcionan en formato fecha “timestamp” presentando las fechas en el formato "AAAA-MM-DDTHH:MM:SS".
 

 
2.- API PARA DESCARGA DE DATOS

Acceso a recursos de datos mediante una API web con servicio de consulta completo. Este apartado ofrece una API para leer, buscar y filtrar datos sin la necesidad de descargar el archivo completo. Los diferentes recursos están en una base de datos lo que le permite buscar un recurso, así como realizar consultas sobre los mismos.

La API de Datos es accesible a través de las siguientes acciones:

  • Consulta: https://datosabiertos.navarra.es/es/api/3/action/datastore_search?IDrecurso
  • Consulta (vía SQL): https://datosabiertos.navarra.es/es/api/3/action/datastore_search_sql=Select

 
Consulta ejemplo primeros cinco resultados
https://datosabiertos.navarra.es/es/api/3/action/datastore_search?resource_id=ID_RECURSO&limit=5
Consulta ejemplo resultados que contienen 'jones'
https://datosabiertos.navarra.es/es/api/3/action/datastore_search?q=jones&resource_id=ID_RECURSO
Consulta ejemplo vía sentencia SQL
https://datosabiertos.navarra.es/es/api/3/action/datastore_search_sql?sql=SELECT * from "c736f9a3-3efc-4b89-9d31-ef859607bc27" WHERE title LIKE 'jones'

 
Ejemplo Javascript:

Una simple consulta ajax (JSONP) a la data API usando jQuery.
        var data = {
          resource_id: 'ID_RECURSO', // the resource id
          limit: 5, // get 5 results
          q: 'jones' // query for 'jones'
        };
        $.ajax({
          url: 'https://datosabiertos.navarra.es/es/api/3/action/datastore_search',
          data: data,
          dataType: 'jsonp',
          success: function(data) {
            alert('Total results found: ' + data.result.total)
          }
        });

 
Ejemplo Python:

      import urllib
      url = 'https://datosabiertos.navarra.es/es/api/3/action/datastore_search?resource_id=ID_RECURSO&limit=5&q=title:jones' 
      fileobj = urllib.urlopen(url)
      print fileobj.read()

     

 
3.- API PARA VISUALIZAR DATOS GEORREFERENCIADOS EN APLICACIONES WEB

Es una API JavaScript que permite incluir en páginas y aplicaciones web un visor de mapas interactivo y así representar información georreferenciada.

Es un producto desarrollado para su uso en aplicaciones web de Gobierno de Navarra, pero puede ser utilizado por cualquier usuario y organización en sus páginas web.

Versión actual de la API:

  • - Ofrece funciones habituales de navegación de los visores de mapas, como zoom, mapa de situación y herramientas de medición.
  • - Permite buscar un municipio de Navarra por su denominación y también buscar un punto por sus coordenadas.
  • - Tiene una configuración por defecto que permite de manera fácil crear un mapa básico de Navarra, con herramientas de uso común y cuatro mapas de fondo procedentes de Idena, en concreto la Ortofoto de 2012, el mapa base, la cartografía topográfica y el catastro.
  • - Es posible añadir información geográfica mediante servicios WMS y WMTS.
  • - Permite crear marcadores puntuales con información asociada.
  • - También es posible cargar información geográfica desde un fichero KML.

Este es el aspecto del mapa básico que se obtiene con la configuración por defecto de la API visor de datos georreferenciados.


La API está basada en diversas bibliotecas JavaScript de terceros, pero está completamente autocontenida y simplemente cargando en la página el script de la API se cargan dinámicamente los recursos que necesita. El objetivo ha sido facilitar su uso para un desarrollador sin grandes conocimientos GIS.

Con el fin de facilitar la comprensión de la API consulte la documentación y ejemplos disponibles en este recurso.