Propuesta para la "Publicación de Actividades Comerciales" 2015

Transcripción

1 Propuesta para la "Publicación de Actividades Comerciales" 2015 Open Data Canarias San Cristóbal de La Laguna, marzo de 2015 Open Data Canarias

2 Control de Versiones Resumen de los cambios realizados en el documento: Fecha Versión Autor Cambios V0.1 Luis Alberto Rubio Rodríguez Creación e inicio del documento V0.1 Adrián Muñoz Barrera Modificados puntos 3, 4 y anexos V0.1 Luis Alberto Rubio Rodríguez Añadidas nuevas consideraciones V0.1 Adrián Muñoz Barrera Solucionados errores. Nota: Valorar si borrar esta sección en el documento final.

3

4 Índice 1 Introducción Modelo de datos de la información de Actividades Comerciales Justificación de CSV y JSON Propuesta del esquema que seguir... 5 Anexo I Modelo de datos CSV... 7 Anexo II Modelo de datos JSON Anexo III Consideraciones a utilizar... 9 Anexo IV Plantillas... 10

5 1 Introducción Este documento contiene una propuesta para la publicación de datos sobre actividades comerciales de un municipio. Se parte de datos existentes en conjuntos de datos de varias organizaciones y en este trabajo se plantea una estructura común para dicha información. Con las directrices que aquí se plantean, se pretende que esta liberación sea lo más homogénea posible en cuanto a metadatos y formatos utilizados, con el objetivo de facilitar la reutilización de la información. Esta propuesta se realiza como primera tarea de la colaboración entre RedELTIC (Red de Técnicos en Modernización y Tecnologías de la Información y las Comunicaciones de Entidades Locales de la isla de Tenerife) y el Proyecto Open Data Canarias. Se encuentra actualizada a febrero de 2015, fecha en la que se celebró la última reunión. En el estudio se han analizado diferentes conjuntos de datos tanto de miembros de RedELTIC como fuentes externas. Las fuentes analizadas han sido: Ayuntamiento de Arona - Actividades (ERP) o CSV: Ayuntamiento de Tegueste - Actividades comerciales geolocalizadas o CSV: f222d893e320/download/listadoempresasteguesteconestablecimientocon georeferencia2.csv 2 Modelo de datos de la información de Actividades Comerciales Vista la información que los diferentes ayuntamientos ofrecen sobre las actividades comerciales que tienen lugar en su municipio, se puede definir una estructura común que modele dichas actividades comerciales: Campo Descripción Identificador Identificador único para la actividad comercial. Nombre comercial Nombre comercial del establecimiento donde se realiza la actividad. Descripción de la actividad Información completa sobre la actividad que se ejerce. Epígrafe IAE principal Epígrafe principal del IAE al que corresponde la actividad. Localización - Dirección Lugar (calle, edificio, etc.) donde se realiza la actividad. Dirección no estructurada. - Código postal Código postal donde se realiza la actividad - Georreferencia Latitud y longitud del lugar donde se realiza la actividad. Contacto - Teléfono Teléfono de contacto de quien ejerce la actividad. - Fax Fax de quien ejerce la actividad. - de contacto de quien ejerce la actividad. Propuesta para la "Publicación de Actividades Comerciales" Open Data Canarias 4

6 Más información adicional Enlace a la página de quien ejerce la actividad, donde se encuentra información adicional. 3 Justificación de CSV y JSON El análisis se ha centrado en el uso de los formatos CSV y JSON (en sus diferentes versiones). CSV y JSON Ambos tipos de formatos son de formato abierto utilizados para la representación y el intercambio de datos. CSV (Comma-Separated Values) representa los datos en forma de tabla, donde las columnas se separan por comas y las filas por saltos de línea. Se trata de un formato muy sencillo, compacto y fácil de generar, leer y analizar. Por otro lado, JSON (JavaScript Object Notation) es un formato sencillo para el intercambio de datos. Se trata de un subconjunto de la notación de objetos de JavaScript. La simplicidad de este formato ha dado lugar que surja como alternativa a XML. La ventaja de JSON sobre XML como formatos de intercambio reside en la sencillez de realizar un análisis documentos en formato JSON, gracias a JavaScript. Es legible por un humano, así como por una máquina y es fácil de aprender ya que su sintaxis es reducida y no se extiende. Conclusiones de uso de CSV y JSON. Hemos decidido usar CSV y JSON como formato para la publicación inicial de contenidos referidos a las instalaciones. Ya que este sería un primer acercamiento, sería ideal un planteamiento sencillo para la publicación de dichos datos, que facilite su reutilización por los desarrolladores. Por sus características, anteriormente descritas, estos formatos cumplen dichos requisitos. En posteriores pasos, lo más conveniente sería publicar estos datos en un formato más rico, como RDF. 4 Propuesta del esquema que seguir Una vez seleccionados CSV y JSON como formatos que vamos a utilizar para la publicación de actividades comerciales, necesitamos definir la estructura completa de las actividades a publicar según la tabla del apartado 2. Los campos que usaremos para el formato CSV son los siguientes: Campo CSV Identificador Nombre comercial Descripción de la actividad Uso IDENTIFICADOR NOMBRE-COMERCIAL DESCRIPCION-ACTIVIDAD Propuesta para la "Publicación de Actividades Comerciales" Open Data Canarias 5

7 Epígrafe IAE principal Dirección Código Postal Latitud Longitud Teléfono Fax Web IAE DIRECCION CODIGO-POSTAL LATITUD LONGITUD TELEFONO FAX WEB Por otro lado, los campos que usaremos para el formato JSON son los siguientes: Campo JSON Entidad URL entidad Imagen entidad Identificador Nombre comercial Descripción de la actividad Epígrafe IAE principal Localización Dirección Código Postal Latitud Longitud Contacto Teléfono Fax Web Uso entidad url-entidad imagen-entidad identificador nombre-comercial descripcion-actividad iae localizacion direccion codigo-postal latitud longitud contacto telefono fax web Propuesta para la "Publicación de Actividades Comerciales" Open Data Canarias 6

8 Anexo I Modelo de datos CSV CSV Ejemplo 1 Ejemplo 2 - Identificador Nombre comercial Nombre 1 Nombre 2 - Descripción de la actividad Servicios Comercio - Epígrafe IAE principal Dirección Calle 1 Calle 2 - Código postal Latitud Longitud Teléfono Fax abc@abc.es def@def.es - Web Id, N.Comercial, "Descripción", "IAE", "Dirección", "CP", "Lat", "Lon", "Teléfono", "Fax", " ", "Web" Ej 1 1, "Nombre 1", "Servicios", "999", "Calle 1 ", "38280", "28.521", " ", " ", " ", "abc@abc.es", " Ej 2 2, "Nombre 2", "Comercio", "888", "Calle 2 ", "38280", "28.521", " ", " ", " ", "def@def.es", " Propuesta para la "Publicación de Actividades Comerciales" Open Data Canarias 7

9 Anexo II Modelo de datos JSON. Etiqueta Ejemplo JSON Ejemplo - Entidad Ayuntamiento 1 { "entidad": "Ayuntamiento 1", - URL entidad "url-entidad": " nto1.org iento1.org", - Imagen entidad "imagen-entidad": " to1.es/images/logo.png iento1.org/images/l ogo.png", "actividadeseconomicas": [ Actividad { - Identificador 1 "identificador": 1, - Nombre comercial Nombre 1 "nombre- "Nombre 1", comercial": - Descripción de la Servicios "descripcion- "Servicios", actividad actividad": - Epígrafe IAE principal 999 "iae": "999", - Localización "localizacion":{» Dirección Calle 1 "direccion": "Calle 1",» Código postal "codigo-postal": "38280",» Latitud "latitud": " ",» Longitud "longitud": " "}, - Contacto "contacto":{» abc@abc.es " ": "abc@abc.com",» Teléfono "telefono": " ",» Fax "fax": " "}, - Web "web": " }, Actividad {...}, Actividad {...}, ]} Propuesta para la "Publicación de Actividades Comerciales" Open Data Canarias 8

10 Anexo III Consideraciones a utilizar Atributos del formato CSV Los nombres de los atributos del formato CSV se escribirán en mayúsculas para diferenciarlos de los valores del resto de filas. Un ejemplo de CSV simplificado sería: IDENTIFICADOR NOMBRE-COMERCIAL DESCRIPCION-ACTIVIDAD 1 Nombre 1 Servicios Dirección La dirección de la actividad comercial se escribirá en el campo de texto dirección de forma no estructurada. Por ejemplo: Avenida Cuesta 17, Arona, Santa Cruz de Tenerife, España Correos electrónicos ( ) Los correos electrónicos se deben escribir siguiendo una forma natural: abc@abc.com (es decir:.+@.+). Por ejemplo: info@ayuntamiento.org. No está permitido: mailto:abc@abc.com Números de teléfono y fax Los números de teléfono y fax deben estar precedidos por el prefijo internacional correspondiente asignado por la UIT (para España: +34) y sin espacios entre los dígitos. Por ejemplo: Cómo comprobar el JSON Es posible comprobar la correcta sintaxis del JSON. Para ello, basta con introducir el contenido de éste o su URL de acceso en y pulsar el botón VALIDATE JSON. En caso de que lo detecte como correcto, la página devolverá: Cómo comprobar el CSV Es posible comprobar la correcta sintaxis del CSV. Para ello, basta con introducir el contenido de éste o su URL de acceso en y pulsar el botón Validate. En caso de que lo detecte como correcto, la página devolverá: Propuesta para la "Publicación de Actividades Comerciales" Open Data Canarias 9

11 Anexo IV Plantillas Plantilla JSON completa: { } "entidad": "Ayuntamiento 1", "url-entidad": " "imagen-entidad": " "actividades-economicas": [ { "identificador": 1, "nombre-comercial": "Nombre 1", "descripcion-actividad": "Servicios", "iae": "999", "localizacion": { "direccion": "Calle 1", "codigo-postal": "38280", "latitud": " ", "longitud": " " }, "contacto": { " ": "abc@abc.com", "telefono": " ", "fax": " " }, "web": " }, {... },... {... } ] Propuesta para la "Publicación de Actividades Comerciales" Open Data Canarias 10

12 Plantilla CSV completa: IDENTIFICADOR,NOMBRE-COMERCIAL,DESCRIPCION-ACTIVIDAD,IAC,DIRECCION,CODIGO- POSTAL,LATITUD,LONGITUD,TELEFONO,FAX, ,WEB 1,"Nombre 1","Servicios","999","Calle 1","38280"," ","- Propuesta para la "Publicación de Actividades Comerciales" Open Data Canarias 11