Mapeo de datos de la API

La integración de datos de servicios web con MapForce es una estrategia popular y probada para obtener información oportuna para el análisis o la generación de informes fáciles de usar. En una publicación anterior, demostramos cómo mapear datos de una API en pronósticos meteorológicos de 5 días para puertos de transporte de carga, leyendo datos de servicios web en formato JSON y transformándolos en hojas de cálculo de Excel con un formato enriquecido. La API meteorológica que utilizamos es proporcionada por OpenWeather, un proveedor de datos históricos, actuales y de pronósticos meteorológicos.

Sin embargo, integrar datos de cualquier API no es una tarea que se pueda configurar una vez y olvidarse. Cuando se construye una solución basada en datos externos, es necesario reaccionar rápidamente cuando la estructura de los datos cambia. En nuestro proyecto de integración original, OpenWeather revisó los datos proporcionados por su API. La API ahora incluye predicciones de ráfagas de viento en una propiedad JSON separada de la velocidad del viento. Dado que se sospecha que las ráfagas de viento fueron una causa del reciente bloqueo del Canal de Suez, estos nuevos datos son muy relevantes para nuestra aplicación. Afortunadamente, tanto el mapeo de datos de MapForce como la hoja de cálculo de Excel se pueden actualizar fácilmente para agregar los nuevos datos.

Necesitamos comprender los cambios en el nuevo formato de salida de Excel antes de poder modificar la asignación de datos de la API. Aquí se muestra la nueva sección principal de la tabla del pronóstico de 5 días:

El creador de la hoja de cálculo añadió una nueva columna, ubicada entre las columnas de "Velocidad del viento" y "Dirección del viento", para mostrar las ráfagas de viento previstas en cada pronóstico.

Se han realizado varias modificaciones en la sección de encabezado de la hoja de cálculo. Se ha añadido una línea que indica la velocidad máxima de ráfaga en el gráfico del viento, se han añadido las coordenadas geográficas del puerto, y se muestra la velocidad máxima de ráfaga registrada durante el pronóstico de los próximos 5 días.

Un nuevo botón interactivo en la hoja de cálculo, etiquetado como "Ver la actividad actual del puerto", abre una página web. Todos los buques comerciales están equipados con transpondedores para el sistema de identificación automática (AIS), que transmiten continuamente la posición del buque para evitar colisiones y para la elaboración de cartas náuticas. MyShipTracking.com es uno de los muchos sitios web y otras empresas que utilizan la tecnología AIS para reportar datos AIS en tiempo real y proporcionar una mejor comprensión de cómo se desplazan los buques por todo el mundo.

Al hacer clic en el botón de la hoja de cálculo, se abre una página en myshiptracking.com que muestra la actividad cercana a la ubicación geográfica:

Necesitamos realizar solo algunas modificaciones en la asignación de datos para implementar estas mejoras en el resultado final: necesitamos insertar los datos del viento en la ubicación correcta dentro de la tabla, y también necesitamos asignar las coordenadas de geolocalización.

Primero, ejecutamos manualmente la API del clima en una ventana del navegador para obtener un nuevo ejemplo de respuesta, que incluía datos sobre las ráfagas de viento. Luego, generamos un nuevo esquema JSON en XMLSpy para el resultado de la API. Guardar el nuevo esquema JSON con el nombre de archivo original añade automáticamente el término "ráfaga" al campo "Respuesta" en el mapeo de datos de la API.

Las etiquetas adjuntas a las coordenadas originales de los datos mapeados facilitan la identificación del lugar correcto para insertar la nueva columna "Gust" en la hoja de cálculo de Excel:

Seleccionar la opción "Insertar celda antes" en el menú contextual abre un cuadro de diálogo para agregar los detalles:

MapForce mantiene de forma conveniente las conexiones de mapeo para las columnas K y L, por lo que solo necesitamos conectar la columna J.

Las nuevas coordenadas geográficas, correspondientes a la latitud y la longitud, se encuentran en las celdas G5 e I5 de la hoja de cálculo. Las coordenadas de cada puerto ya están incluidas en la lista de origen de puertos, ya que las utilizamos para solicitar datos del pronóstico del tiempo a través de la API. Hemos añadido esas referencias de celda al final de la lista de destino.

Aquí se muestra una vista del mapeo revisado en el panel de mapeo de MapForce, con la nueva conexión para las predicciones de ráfagas de viento resaltada

Para una última mejora, agregamos más puertos a la lista de solicitudes, incluyendo el Canal de Suez y varios puertos marítimos importantes en Europa. Añadimos los nuevos puertos editando el archivo JSON original que contiene la lista de solicitudes, utilizando el programa XMLSpy. A continuación, se muestra el nuevo archivo JSON con las solicitudes de puertos, listo para ser utilizado como entrada para el mapeo de datos de la API, visualizado en la vista de cuadrícula de XMLSpy:

Hacer clic en el botón "Salida" que se encuentra en la parte inferior del panel de mapeo ejecuta el proceso de mapeo y abre la vista de "Salida", mostrando el primer archivo de salida. Si Excel 2007 o una versión posterior está instalada en el sistema, MapForce abrirá automáticamente Excel para mostrar el resultado

Se han generado resultados para cada puerto de la lista de origen. Podemos seleccionar cualquier archivo de Excel para su visualización:

Hacer clic en el botón "Ver actividad del puerto actual" en la ventana de vista previa funciona exactamente igual que cuando se abre el archivo directamente en Excel:

El resultado se basa en la latitud y longitud del puerto:

Cada punto en el mapa representa una embarcación equipada con un transpondedor AIS que transmite información en tiempo real. Para validar aún más nuestros resultados, podemos previsualizar cualquier otro archivo de salida y verificar el enlace para otro puerto. Aquí está el mapa de Hamburgo, Alemania:

Los puntos rojos representan petroleros, y los puntos verdes representan buques de carga. Podemos hacer clic en cualquier punto para obtener información detallada sobre la embarcación:

Ponte al día con.. Publicación original sobre la integración de servicios web, ver rápidamente demostración en video de MapForce, o Descargue una versión de prueba gratuita incluyendo tutoriales, ayuda y muchos más ejemplos para que pueda comenzar con su propio proyecto de mapeo de datos de API, o para otras tareas de integración, conversión y transformación de datos.