Acceso a la API de Harvard Art Museums con R
Introducción
Los museos han desempeñado un papel de liderazgo en el desarrollo de la historia del arte, la conservación de la ciencias y en la evolución del museo de arte como institución.
A través de la investigación, la enseñanza, la capacitación profesional y la educación pública, Harvard Art Museums se esfuerza por promover la comprensión y la apreciación del arte.
Harvard Art Museums nos proporciona una API, la cuál, permite consultar los datos del museo. La API contiene toda la información sobre obras de arte, artistas, exposiciones y las categorizaciones. Sus datos provienen de tres fuentes: The Museum System, Google Analytics, Artificial Intelligence.
Los datos de Harvard Art Museums se pueden utilizar para generar investigaciones, explorar las colecciones y crear arte.
En esta publicación aprenderá que es una API, su utilidad y como recuperar los datos de Harvard Art Museums usando su API.
¿Qué es una API y para que sirve?
API significa interfaz de programación de aplicaciones. Es un conjunto de definiciones y protocolos que se utiliza para desarrollar e integrar el software de las aplicaciones. Las APIs permiten que sus productos y servicios se comuniquen con otros, sin necesidad de saber cómo están implementados
La APIs sirve de comunicación con una base de datos, sistemas operativos o protocolos de comunicaciones. Permite utilizar funciones de otro software o aprovechar la insfraestructura que existe en otra plataforma.
¿Qué es Harvard Art Museums?
Harvard Art Museums son tres museos de la Universidad de Harvard: the Fogg Museum (establecido en 1895), the Busch-Reisinger Museum (establecido en 1903), y the Arthur M. Sackler Museum (establecido en 1985) y cuatro centros de investigación: the Center for the Technical Study of Modern Art (fundado en 2002), the Harvard Art Museums Archives y the Straus Center for Conservation and Technical Studies (fundado en 1928).
Las colecciones incluyen aproximadamente 250.000 objetos en todos los medios, que van desde la antigüedad hasta el presente y se originan en Europa, Norteamérica, Norte de África, Medio Oriente, Sur de Asia, Este de Asia y Sudeste de Asia.
Algunas colecciones
¿Cómo se obtiene la API de Harvard Art Museums?
Primero visite el sitio web de Harvard Art Museums y vaya a Application Programming Interface (API), donde le darán las instrucciones necesarias.
Primero, regístrese para obtener una clave API usando este enlace. Recibirá un correo electrónico con una clave única que le permitirá acceder a los datos del museo. Cada clave es única para la persona que la solicita y debe tratarse como una contraseña.
Exploración de la API.
Para examinar la API, debe crear consultas para que API sepa qué buscar. Una consulta, en este caso es un URL, que consta de varios componentes que actúan como bloques de construcción.
La consulta tiene la siguiente estructura que consta de cuatro componentes.
Harvard Art Museums URL + recurso + filtro (opcional) + clave API
Veamos el siguiente ejemplo usando el recurso “object” en el año 2002:
https://api.harvardartmuseums.org/object?2002&apikey=0000-0000-0000-000
Guía de recursos.
Object: Contiene información detallada sobre los elementos de las colecciones de Harvard Art Museums.
Person: Contiene información sobre entidades que tienen alguna asociación a obras de arte de la colección o publicaciones. Las asociaciones incluyen artistas, modelos, impresores, donantes, autores, editores y más.
Exhibition: Contiene información sobre exposiciones pasadas como documentación del historial de exposiciones de un objeto y exposiciones actuales o futuras.
Publication: Contiene información sobre publicaciones sobre las que se ha escrito o contienen imágenes de obras de arte de la colección de Harvard Art Museums.
Gallery: Contiene información sobre espacios físicos dentro del edificio de los museos en 32 Quincy Street, Cambridge, MA.
Spectrum: Contiene una lista de los colores utilizados en el espectro de colores que forma parte de la marca de Harvard Art Museums.
Classification: Contiene información sobre los siglos utilizados para describir elementos de las colecciones de Harvard Art Museums.
Century: Contiene información sobre los siglos utilizados para describir elementos de las colecciones de Harvard Art Museums.
Color: Contiene información sobre los colores utilizados para describir elementos de las colecciones de Harvard Art Museums.
Culture: Contiene información sobre las culturas utilizadas para describir elementos en Harvard Art Museums
Group: Contiene información sobre las culturas utilizadas para describir elementos en Harvard Art Museums.
Medium: Contiene información sobre los medios (los materiales que se aplican en la fabricación de un objeto) utilizados para describir elementos en las colecciones de Harvard Art Museums.
Period: Contiene información sobre los períodos (movimientos artísticos dentro de un período de tiempo específico) utilizados para describir elementos en las colecciones de Harvard Art Museums.
Place: Contiene información sobre los lugares (estados, países, continentes o regiones históricas) que se utilizan para describir elementos de las colecciones de Harvard Art Museums
Technique: Contiene información sobre las técnicas (el proceso mediante el cual se crea un objeto) utilizadas en la producción de artículos en Harvard Art Museums.
Worktype: Contiene información sobre los tipos de obras de las colecciones de Harvard Art Museums. Las etiquetas de tipo de trabajo son clasificaciones más específicas del objeto.
Activity: Contiene información sobre actividades específicas de los objetos de las colecciones de Harvard Art Museums.
Site: Contiene información sobre los sitios que forman parte de Harvard Art Museums.
Video: Contiene información sobre los videos producidos por y asociados con Harvard Art Museums.
Image: Contiene información sobre las imágenes producidas y asociadas a Harvard Art Museums.
Audio: Contiene información sobre los clips de audio producidos por Harvard Art Museums y asociados con ellos.
Annotation: Contiene información sobre las anotaciones en las colecciones de Harvard Art Museums.
Exportar datos a R
La API es un servicio de estilo REST diseñado para desarrolladores que desean explorar e integrar las colecciones de los museos en sus proyectos. La API proporciona acceso directo a datos en formato JSON.
Para exportar los datos a R se debe contar con las librerías necesarias. Utilizaremos jsonlite para manejar los datos en formato JSON y httr para su interacción.
Vamos a empezar instalandolas, en caso de aún no contar con ellas.
Las cargaremos para poder utilizarlas.
Ahora ya podemos empezar con la exportación de datos. Como tenemos un URL con la dirección del sevidor, utilizaremos la función GET() de la librería httr para poder obtener los datos.
Se introduce la variable “API” de la siguiente forma. Dado que el URL es único para cada persona, se ha ocultado la APIkey.
La salida de la función GET () es una lista que contiene toda la información que devuelve el servidor API. Es decir, la variable “API” contiene la respuesta del servidor API a nuestra solicitud.
Veamos como se ve la variable “API”.
La variable “API” nos da una visión resumida. Nótese que contiene la URL; la fecha y hora en que se realizó la solicitud; el tipo de contenido, que nos dice que los datos tienen un formato json; el tamaño de respuesta y el estatus, que ha sido 200, que corresponde a una solicitud exitosa.
La variable “API” contiene lo siguiente:
Los datos de la variable “API” no se pueden utilizar. Los datos reales están contenidos como Unicode sin procesar en la lista, por lo que debe convertirse a formato JSON. Para eso se debe convertir el Unicode en un vector de caracteres. La función rawToChar () realizará lo deseado, como se muestra a continuación:
La información necesaria se encuentra en “content”, por lo que usando “$” seleccionaremos la variable “API” y los datos de “content”.
Esto nos dará una estructura JSON en formato de caracteres, por lo que podemos convertirlo en una estructura de datos usando la función fromJSON() de la biblioteca jsonlite, que guardaremos en la variable “Data”. Así tendremos un formato que podemos manipular fácilmente en R.
Veamos los nombres del contenido de la variable “Data”.
El conjunto de datos que nos interesa ver es “records”. Usemos el operador “$” para mirar directamente los datos.
Para visualizar mejor los datos usaremos la librería “kableExtra” de la siguiente manera:
En consecuencia, tenemos un data frame que nos permitirá visualizar y manipular los datos de nuestro interés.
Conclusión
En los ultimos años, se han generado oportunidades de investigación, por lo que Harvard Art Museums ha digitalizado sus colecciones, permitiendo que el público en general acceda a sus datos.
Conocer como acceder a la API facilitará la recolección de datos, permitiendole a los interesados del arte aprender, analizar e investigar sobre los datos de los museos.
Para mayor información, consulte la documentación detallada sobre cómo conectarse, utilizar los recursos de la API y los términos de uso, en este enlace.
Referencias
Harvard Art Museum https://harvardartmuseums.org
Application Programming Interface (API). https://harvardartmuseums.org/collections/api
Harvard Art Museums API Documentation https://github.com/harvardartmuseums/api-docs
