--- title: "Correspondance des données de l'API" date: "2021-04-30" categories: - "data-integration" - "tools" tags: - "api-data-mapping" - "data-integration" - "excel-data-mapping" - "mapforce" - "web-services" description: Apprenez à adapter la correspondance des données API dans MapForce pour tenir compte des modifications apportées aux réponses JSON, afin de garantir une intégration efficace des données et une production de rapports précise. --- Status: #blog Tags: #api-data-mapping #data-integration #excel-data-mapping #mapforce #web-services Categories: [data-integration](/blog/fr/category/data-integration.md) # Correspondance des données de l'API L'intégration de données de services web avec MapForce est une stratégie éprouvée et populaire pour collecter des informations pertinentes et en temps réel, destinées à l'analyse ou à la création de rapports faciles à utiliser. Dans un article précédent, nous avons montré comment mapper des données d'API pour des prévisions météorologiques de 5 jours, destinées aux ports de commerce maritime très fréquentés, en utilisant la lecture de.. [Données de services web au format JSON, avec conversion et affichage dans un tableur Excel richement formaté](https://www.altova.com/blog/web-service-data-integration/) tableurs. L'API météorologique que nous avons utilisée est hébergée par.. [OpenWeather](file:///C:/Users/dgm/Documents/Shipping%20post%20update/openweathermap.org), un fournisseur de données historiques, actuelles et de prévisions météorologiques. L'intégration de données provenant de n'importe quelle API n'est pas une tâche que l'on configure une fois pour toutes. Lorsque vous développez une solution basée sur des données externes, vous devez réagir rapidement lorsque la structure des données change. Dans notre projet d'intégration initial, OpenWeather a modifié les données fournies par leur API. L'API inclut désormais des prévisions de rafales de vent dans une propriété JSON distincte de la vitesse du vent. Étant donné que les rafales de vent sont suspectées d'être une cause de l'incident récent sur le canal de Suez, ces nouvelles données sont très pertinentes pour notre application ! Heureusement, le mappage des données MapForce et la feuille de calcul Excel peuvent être facilement modifiés pour intégrer les nouvelles données. ![](/blog/images/container_ship2.jpg) Nous devons comprendre les modifications apportées au nouveau format de sortie Excel avant de pouvoir modifier la correspondance des données de l'API. Voici la nouvelle section principale du tableau des prévisions pour 5 jours : [![Informations supplémentaires requises lors de la correspondance des données dans l'API](/blog/images/wind-gust-column.png)](wind-gust-column.png) Le créateur de la feuille de calcul a ajouté une nouvelle colonne, située entre les colonnes "Vitesse du vent" et "Direction du vent", afin d'afficher les rafales de vent prévues pour chaque prévision. Plusieurs modifications apparaissent également dans la section d'en-tête de la feuille de calcul. Une ligne indiquant la vitesse des rafales a été ajoutée au graphique des vents, les coordonnées géographiques du port ont été ajoutées, et la vitesse maximale des rafales sur la prévision de 5 jours est indiquée. [![De nouvelles informations sont requises dans la correspondance des données de l'API](/blog/images/new-chart-geolocation.png)](new-chart-geolocation.png) Un nouveau bouton cliquable, intitulé "Afficher l'activité actuelle du port", est apparu dans la feuille de calcul et ouvre une page web. Tous les navires commerciaux sont équipés de transpondeurs pour le système d'identification automatique ([AIS](https://en.wikipedia.org/wiki/Automatic_identification_system)) qui émet en continu la position du navire, afin d'éviter les collisions et de faciliter la cartographie. MyShipTracking.com est l'un des nombreux sites web et entreprises qui utilisent la technologie AIS pour diffuser des données AIS en temps réel et offrir une meilleure compréhension des mouvements des navires à travers le monde. En cliquant sur le bouton dans la feuille de calcul, une page s'ouvre sur le site myshiptracking.com, affichant les activités à proximité de la localisation géographique : [![Exemple du résultat obtenu en cliquant sur l'option "Afficher l'activité du portail" dans la feuille de calcul](/blog/images/port-map-1.png)](port-map-1.png) Nous n'avons besoin que de quelques modifications dans la correspondance des données pour prendre en charge ces améliorations de la sortie cible : il faut insérer les données de rafales au bon endroit dans le tableau, et nous devons également établir la correspondance des coordonnées géographiques. Tout d'abord, nous avons exécuté manuellement l'API météorologique dans une fenêtre de navigateur afin d'obtenir un nouvel exemple de réponse, incluant des données sur les rafales de vent, et nous avons généré un nouveau schéma JSON dans XMLSpy pour le résultat de l'API. Enregistrer le nouveau schéma JSON avec le nom de fichier original ajoute automatiquement le terme "rafale" dans la correspondance des données de la réponse de l'API. [![Un schéma JSON définit la structure de la réponse de l'API pour la cartographie](/blog/images/web-service-settings.png)](web-service-settings.png) Les étiquettes attachées aux coordonnées originales des données cartographiées facilitent la recherche de l'endroit approprié pour insérer la nouvelle colonne "Gust" dans la feuille de calcul Excel : ![Ajouter une nouvelle colonne à la correspondance des données de l'API pour la feuille de calcul cible](/blog/images/add-cell.png) La sélection de l'option "Insérer une cellule avant" dans le menu contextuel ouvre une fenêtre de dialogue permettant de saisir les informations nécessaires [![Dialogue pour définir les détails de la nouvelle plage de cellules cibles](/blog/images/add-cell-dialog.png)](add-cell-dialog.png) MapForce gère de manière pratique les connexions de mappage pour les colonnes K et L, ce qui nous permet de ne connecter que la colonne J. Les nouvelles coordonnées géographiques, pour la latitude et la longitude, se trouvent dans la feuille de calcul, respectivement aux cellules G5 et I5. Les coordonnées de chaque port sont déjà présentes dans la liste source des ports, car nous les utilisons pour demander des données de prévisions météorologiques à l'API. Nous avons ajouté ces références de cellules en bas de la liste cible. Voici une vue de la nouvelle configuration de mappage dans le panneau de mappage de MapForce, avec la nouvelle connexion pour les prévisions de rafales de vent mise en évidence : [![La totalité des données de l'API a été révisée, et les rafales de vent ainsi que les coordonnées géographiques ont été ajoutées aux résultats](/blog/images/new-map-1.png)](new-map-1.png) Pour une dernière amélioration, nous avons ajouté davantage de ports à la liste des demandes, notamment le canal de Suez et plusieurs grands ports maritimes en Europe. Nous avons ajouté ces nouveaux ports en modifiant le fichier JSON original contenant la liste des demandes, en utilisant le logiciel XMLSpy. Voici le nouveau fichier JSON contenant les demandes de ports, destiné à être utilisé comme source de données pour l'API, affiché sous forme de tableau dans [XMLSpy](https://www.altova.com/fr/xmlspy-xml-editor#JSON) : ![Les nouveaux ports répertoriés dans le fichier d'entrée généreront de nouvelles requêtes API et des résultats de mappage de données](/blog/images/XMLSpy-grid-view.png) En cliquant sur le bouton "Sortie" situé en bas du panneau de mappage, le processus de mappage est exécuté et la fenêtre "Sortie" s'ouvre, affichant le premier fichier de sortie. Si Excel 2007 ou une version ultérieure est installée sur le système, MapForce ouvre automatiquement Excel pour afficher le résultat : [![Aperçu de la première feuille de calcul générée grâce à la correspondance des données de l'API](/blog/images/output-preview-1.png)](output-preview-1.png) Les résultats ont été générés pour chaque port figurant dans la liste de sources. Vous pouvez sélectionner n'importe quel fichier Excel pour l'aperçu : [![Tous les 15 résultats ont été générés et sont disponibles pour être consultés](/blog/images/output-preview-2.png)](output-preview-2.png) Le bouton "Afficher l'activité du port actuelle" dans la fenêtre de prévisualisation fonctionne exactement de la même manière que lorsque le fichier est ouvert directement dans Excel : [![Un lien cliquable dans la fenêtre de prévisualisation](/blog/images/output-link.png)](output-link.png) Le résultat est basé sur la latitude et la longitude du port : [![Vue des navires près de l'entrée du canal de Suez](/blog/images/suez-activity.png)](suez-activity.png) Chaque point sur la carte représente un navire équipé d'un transpondeur AIS qui transmet des informations en temps réel. Pour valider davantage nos résultats, nous pouvons prévisualiser tout autre fichier de sortie et vérifier le lien pour un autre port. Voici la carte de Hambourg, en Allemagne : [![Le bouton "Activité du port" produit des résultats différents dans chaque fichier de sortie](/blog/images/hamburg-activity.png)](hamburg-activity.png) Les points rouges représentent les pétroliers, et les points verts représentent les navires de transport de marchandises. Nous pouvons cliquer sur n'importe quel point pour obtenir des informations détaillées sur le navire : [![Détails concernant un navire de transport amarré dans un port](/blog/images/hamburg-vessel.png)](hamburg-vessel.png) Tenez-vous au courant de.. [Article original sur l'intégration des services web](https://www.altova.com/blog/web-service-data-integration/), regarder rapidement [vidéo de démonstration](https://www.altova.com/fr/mapforce/demos) de MapForce, ou [Téléchargez une version d'essai gratuite](https://www.altova.com/fr/mapforce/download) y compris des tutoriels, une aide en ligne, et de nombreux exemples pour vous aider à démarrer votre propre projet de mappage de données API, ou pour d'autres tâches d'intégration, de conversion et de transformation de données !