Portic data API - Archive ouverte HAL Accéder directement au contenu
Logiciel Année : 2023

Portic data API

Portic data API

Résumé

This is a Web API (developped with Flask) for delivering data extracted from a postgres database. Source code is on humanum GIT : https://gitlab.huma-num.fr/portic/porticapi, released under the AGPL v3 licence. This API delivers data in either CSV or JSON format in a way that is useable for any software or anybody for further analysis or vizualisation task. All the fields are described in a dictionnary (porticapi\static\data\api_portic.csv), in a CSV format, readable online on http://apidemo.portic.fr In the SQL directory, the file `porticapi\sql\portic_routepaths_allfunctions.sql` provides a way to compute maritime paths that never intersect coast neither land, from one port to the other. A publication is under review for this subject. The set of PL/SQL procedures requires the postgis extension to be installed to work with. A preliminary publication has been done in [Eurocarto conference in Vienne, september 2022](https://www.abstr-int-cartogr-assoc.net/5/38/2022/ica-abs-5-38-2022.pdf) Data content is an extraction of the navigocorpus database, that has been cleaned and enriched during the ANR PORTIC programm by new variables (geographic nomenclatures, product nomenclatures, uncertainty quotation of various fields) and standardisation and translation of some fields (such as the name of port, of flags, of shipclass, etc.). See user manual first for details
Il s'agit d'une API Web (développée avec Flask) pour fournir des données extraites d'une base de données postgres. Le code source est sur humanum GIT : https://gitlab.huma-num.fr/portic/porticapi, publié sous la licence AGPL v3. Cette API fournit des données au format CSV ou JSON de manière à ce qu'elles puissent être utilisées par n'importe quel logiciel ou n'importe qui pour une analyse ou une visualisation plus poussée. Tous les champs sont décrits dans un dictionnaire (porticapi\static\data\api_portic.csv), au format CSV, lisible en ligne sur http://apidemo.portic.fr. Dans le répertoire SQL, le fichier `porticapi\sql\portic_routepaths_allfunctions.sql` contient un ensemble de procédures PL/SQL qui permettent de calculer les trajets maritimes qui ne croisent jamais les côtes ni les terres, d'un port à l'autre. Une publication est en cours de révision sur ce sujet. L'ensemble des procédures PL/SQL nécessite l'installation de l'extension postgis. Une publication préliminaire a été faite dans [Eurocarto conference in Vienne, september 2022] (https://www.abstr-int-cartogr-assoc.net/5/38/2022/ica-abs-5-38-2022.pdf). Le contenu des données est une extraction de la base de données navigocorpus, qui a été nettoyée et enrichie au cours du programme ANR PORTIC par de nouvelles variables (nomenclatures géographiques, nomenclatures de produits, cotation de l'incertitude de divers champs) et par la standardisation et la traduction de certains champs (tels que le nom du port, des pavillons, de la classe de navire, etc.). La base devrait bientôt être déposée dans NAKALA au format CSV et SQL plain text. Voir d'abord le manuel de l'utilisateur pour plus de détails sur les options offertes par les requêtes sur l'API.
57 Consultations
0 Téléchargements

Partager

Gmail Facebook X LinkedIn More