--- title: "Mapeamento de dados da API" date: "2021-04-30" categories: - "data-integration" - "tools" tags: - "api-data-mapping" - "data-integration" - "excel-data-mapping" - "mapforce" - "web-services" description: Aprenda a adaptar o mapeamento de dados da API no MapForce para se ajustar a alterações nas respostas JSON, garantindo uma integração de dados eficaz para relatórios precisos. --- Status: #blog Tags: #api-data-mapping #data-integration #excel-data-mapping #mapforce #web-services Categories: [data-integration](/blog/pt/category/data-integration.md) # Mapeamento de dados da API A integração de dados de serviços web com o MapForce é uma estratégia popular e comprovada para recolher informações relevantes e atualizadas, que podem ser utilizadas para análise ou para a criação de relatórios fáceis de usar. Numa publicação anterior, demonstramos como mapear dados de APIs em previsões meteorológicas de 5 dias para portos de transporte de carga movimentados, através da leitura.. [Dados de serviços web em formato JSON e conversão para folhas de cálculo Excel com formatação avançada](https://www.altova.com/blog/web-service-data-integration/) planilhas. A API meteorológica que utilizamos é fornecida por: [OpenWeather](file:///C:/Users/dgm/Documents/Shipping%20post%20update/openweathermap.org), Um fornecedor de dados históricos, atuais e de previsões meteorológicas. No entanto, integrar dados de qualquer API não é uma tarefa que se faz uma vez e pronto. Quando se desenvolve uma solução baseada em dados externos, é preciso reagir rapidamente sempre que a estrutura dos dados muda. No nosso projeto de integração original, a OpenWeather alterou os dados fornecidos pela sua API. A API agora inclui previsões de rajadas de vento numa propriedade JSON separada da velocidade do vento. Como se suspeita que as rajadas de vento foram uma das causas do recente bloqueio do Canal de Suez, estes novos dados são muito relevantes para a nossa aplicação! Felizmente, tanto o mapeamento de dados do MapForce como a folha de cálculo do Excel podem ser facilmente atualizados para incluir os novos dados. ![](/blog/images/container_ship2.jpg) Precisamos compreender as alterações no novo formato de saída do Excel antes de podermos modificar o mapeamento de dados da API. A nova secção da tabela principal da previsão de 5 dias é apresentada aqui: [![Informações adicionais necessárias no mapeamento de dados da API](/blog/images/wind-gust-column.png)](wind-gust-column.png) O criador da folha de cálculo adicionou uma nova coluna, localizada entre a coluna "Velocidade do Vento" e a coluna "Direção do Vento", para mostrar as rajadas de vento previstas para cada previsão. Várias alterações também foram introduzidas na secção de cabeçalho da folha de cálculo. Uma linha que indica a velocidade das rajadas foi adicionada ao gráfico do vento, as coordenadas geográficas do porto foram adicionadas, e a velocidade máxima das rajadas de vento durante o período de previsão de 5 dias é apresentada. [![Novas informações necessárias no mapeamento de dados da API](/blog/images/new-chart-geolocation.png)](new-chart-geolocation.png) Um novo botão clicável na folha de cálculo, com a legenda "Visualizar atividade atual do porto", abre uma página web. Todas as embarcações comerciais possuem transponders para o sistema de identificação automática ([AIS](https://en.wikipedia.org/wiki/Automatic_identification_system)), que transmitem continuamente a posição do navio para evitar colisões e para a elaboração de cartas náuticas. MyShipTracking.com é um dos muitos sites e outras empresas que utilizam a tecnologia AIS para reportar dados AIS em tempo real e fornecer uma melhor compreensão de como as embarcações se movem pelo mundo. Clicar no botão na folha de cálculo abre uma página em myshiptracking.com que mostra a atividade nas proximidades da localização geográfica: [![Exemplo do resultado ao clicar em "Visualizar atividade do porto" na folha de cálculo](/blog/images/port-map-1.png)](port-map-1.png) Precisamos de apenas algumas alterações no mapeamento de dados para suportar estas melhorias na saída final: precisamos de inserir os dados de rajada no local correto na tabela e precisamos de mapear as coordenadas de geolocalização. Primeiramente, executámos manualmente a API meteorológica numa janela do navegador para obter um novo exemplo de resposta, incluindo dados sobre rajadas de vento, e criámos um novo esquema JSON no XMLSpy para o resultado da API. Ao guardar o novo esquema JSON com o nome de ficheiro original, o termo "Rajada" é automaticamente adicionado à secção "Resposta" no mapeamento dos dados da API. [![Um esquema JSON define a estrutura da resposta da API para o mapeamento](/blog/images/web-service-settings.png)](web-service-settings.png) As etiquetas anexadas às coordenadas originais dos dados mapeados facilitam a identificação do local correto para inserir a nova coluna "Gust" na folha de cálculo do Excel: ![Inserir uma nova coluna no mapeamento de dados da API para a folha de cálculo em questão](/blog/images/add-cell.png) Selecionar a opção "Adicionar célula antes" no menu de contexto abre uma janela para adicionar os detalhes: [![Diálogo para definir os detalhes do novo intervalo de células alvo](/blog/images/add-cell-dialog.png)](add-cell-dialog.png) O MapForce mantém convenientemente as ligações de mapeamento para as colunas K e L, pelo que só precisamos de estabelecer a ligação para a coluna J. As novas coordenadas geográficas, referentes à latitude e longitude, na folha de cálculo encontram-se nas células G5 e I5. As coordenadas de cada porto já estão presentes na lista de origem dos portos, uma vez que as utilizamos para solicitar dados de previsão meteorológica à API. Adicionámos esses endereços de célula na parte inferior da lista de destino. Aqui está uma visão da nova configuração de mapeamento no painel de mapeamento do MapForce, com a nova ligação para as previsões de rajadas de vento destacada: [![A estrutura completa e atualizada da API, com a inclusão de rajadas de vento e coordenadas geográficas nos resultados](/blog/images/new-map-1.png)](new-map-1.png) Para uma última melhoria, adicionámos mais portos à lista de pedidos, incluindo o Canal de Suez e vários grandes portos marítimos na Europa. Adicionámos os novos portos editando o ficheiro JSON original, que continha a lista de pedidos, no programa XMLSpy. Aqui está o novo ficheiro JSON com os pedidos de portos, para ser utilizado como entrada para o mapeamento de dados da API, visualizado na vista de grade do [XMLSpy](https://www.altova.com/pt/xmlspy-xml-editor#JSON): ![As novas portas listadas no ficheiro de entrada gerarão novas solicitações de API e resultados de mapeamento de dados](/blog/images/XMLSpy-grid-view.png) Clicar no botão "Saída" na parte inferior do painel de mapeamento executa o processo de mapeamento e abre a vista "Saída", mostrando o primeiro ficheiro de saída. Se o Excel 2007 ou uma versão mais recente estiver instalado no sistema, o MapForce abre automaticamente o Excel para apresentar o resultado: [![Pré-visualização da primeira folha de cálculo gerada a partir do mapeamento de dados da API](/blog/images/output-preview-1.png)](output-preview-1.png) Foram gerados resultados para cada porta na lista de origem. Podemos selecionar qualquer ficheiro Excel para visualização: [![Todos os 15 resultados foram gerados e estão disponíveis para visualização](/blog/images/output-preview-2.png)](output-preview-2.png) Clicar no botão "Visualizar atividade da porta atual" na janela de visualização funciona exatamente da mesma forma que quando o ficheiro é aberto diretamente no Excel: [![Um link clicável na janela de visualização](/blog/images/output-link.png)](output-link.png) O resultado é calculado com base na latitude e longitude do porto: [![Vista de embarcações perto da entrada do canal de Suez](/blog/images/suez-activity.png)](suez-activity.png) Cada ponto no mapa representa uma embarcação com um transponder AIS que transmite informações em tempo real. Para validar ainda mais os nossos resultados, podemos visualizar qualquer outro ficheiro de saída e verificar o link para outro porto. Aqui está o mapa de Hamburgo, na Alemanha: [![O botão "Atividade do Porto" produz resultados diferentes em cada ficheiro de saída](/blog/images/hamburg-activity.png)](hamburg-activity.png) Os pontos vermelhos representam petroleiros, e os pontos verdes representam navios de carga. Podemos clicar em qualquer ponto para obter informações detalhadas sobre a embarcação: [![Detalhes de um navio de carga no porto](/blog/images/hamburg-vessel.png)](hamburg-vessel.png) Coloque-se a par do.. [Publicação original sobre a integração de serviços web](https://www.altova.com/blog/web-service-data-integration/), ver rapidamente [demonstração em vídeo](https://www.altova.com/pt/mapforce/demos) do MapForce, ou [Descarregue uma versão de avaliação gratuita](https://www.altova.com/pt/mapforce/download) incluindo tutoriais, ajuda e muitos exemplos para começar o seu próprio projeto de mapeamento de dados de APIs, ou para outras tarefas de integração, conversão e transformação de dados!