Ce que fait cet outil
Les fichiers GeoParquet ne sont pas lisibles par un humain. Contrairement au GeoJSON, on ne peut pas ouvrir un fichier .parquet dans un éditeur de texte pour en voir les coordonnées, et la plupart des outils SIG de bureau classiques ne savent toujours pas ouvrir ce format directement. Il existe donc un écart entre le fait de posséder un fichier .parquet et celui de vraiment savoir ce qu'il contient : combien d'entités, quel type de géométrie, quelles colonnes, quelle zone il couvre.
Ce visualiseur comble cet écart. Déposez un fichier et il lit le conteneur Parquet, vérifie les métadonnées GeoParquet propres au fichier pour repérer la colonne de géométrie et son encodage, décode chaque valeur WKB (Well-Known Binary) pour retrouver de vraies coordonnées, puis dessine le résultat sur une carte. Cliquez sur n'importe quelle entité pour voir sa table d'attributs complète, ajustez la couleur et le style pour mieux faire ressortir les tendances, et exportez le tout en fichier GeoJSON quand vous avez besoin d'un format que davantage d'outils comprennent déjà. Aucun fichier n'est envoyé où que ce soit : le lecteur Parquet est une compilation WebAssembly qui s'exécute entièrement sur votre machine.
Comment le visualiseur lit un fichier GeoParquet
Le traitement se déroule en trois étapes. D'abord, une compilation WebAssembly de la bibliothèque Parquet en Rust lit les données brutes des colonnes et les restitue sous forme de table Apache Arrow, le même format en mémoire utilisé en interne par GeoPandas et DuckDB. Ensuite, le visualiseur lit les métadonnées du schéma de la table à la recherche d'une clé nommée "geo", le petit bloc JSON que tout fichier GeoParquet transporte et qui nomme la colonne de géométrie principale, indique son encodage et liste les types de géométrie présents. Si cette clé est absente, le fichier est un simple fichier Parquet, pas un GeoParquet, et le visualiseur l'indique clairement plutôt que de deviner.
Enfin, le visualiseur parcourt chaque ligne de la colonne de géométrie, qui contient des valeurs WKB brutes, et décode chacune d'elles pour retrouver des coordonnées : un octet indiquant l'ordre des octets, quatre octets pour le code du type de géométrie, puis les coordonnées elles-mêmes sous forme de paires de nombres sur 8 octets. Le même décodeur reconnaît aussi l'indicateur SRID que PostGIS ajoute à sa sortie EWKB, ainsi que les marqueurs de dimension Z/M de la norme ISO WKB, si bien que les fichiers exportés depuis une base de données spatiale se lisent correctement eux aussi. Les propriétés de chaque autre colonne sont lues de la même façon qu'Arrow les stocke déjà et sont rattachées à chaque entité, et l'ensemble devient une FeatureCollection GeoJSON standard prête à être dessinée sur la carte.
Guide étape par étape
Cliquez sur "Importer" et choisissez un fichier .parquet, glissez-déposez-en un sur la carte, ou cliquez sur "Exemple de données" pour charger un petit exemple déjà prêt.
Le fichier est décodé entièrement dans votre navigateur. Le panneau Informations sur le fichier affiche le nombre d'entités, le type de géométrie, le nom de la colonne de géométrie, le CRS et la taille du fichier, directement à partir des métadonnées du fichier.
Cliquez sur un point, une ligne ou un polygone sur la carte pour ouvrir une fenêtre listant toutes les propriétés enregistrées pour cette entité.
Utilisez le panneau Style pour changer la couleur, l'épaisseur des lignes et l'opacité du remplissage appliquées à chaque entité de la carte.
Cliquez sur "Télécharger en GeoJSON" pour exporter chaque entité décodée sous forme de fichier GeoJSON standard.
Cas d'usage concrets
Les situations où ouvrir directement un fichier GeoParquet, sans écrire une seule ligne de code, est vraiment utile.
- Vérifier rapidement la sortie d'un pipeline de données. Si un script ou un traitement ETL produit des fichiers GeoParquet, glisser le dernier fichier généré directement dans ce visualiseur permet de confirmer rapidement que la géométrie et les attributs sont corrects avant de faire confiance au fichier en aval.
- Explorer un jeu de données ouvert avant d'écrire la moindre ligne de code. Des jeux de données comme Overture Maps ou les collections de Source Cooperative sont distribués au format GeoParquet. Télécharger un petit extrait et le visualiser ici montre exactement quelles colonnes et quels types de géométrie il contient, avant même de mettre en place DuckDB ou GeoPandas.
- Vérifier une conversion de GeoJSON vers GeoParquet. Après avoir converti un fichier avec un outil comme le convertisseur GeoJSON vers GeoParquet de ce site, recharger le résultat dans ce visualiseur confirme que la conversion a bien préservé chaque entité et chaque propriété.
- Relire des données avant de les publier en open data. Les équipes municipales et de recherche publient de plus en plus de fichiers GeoParquet en complément du GeoJSON. Une vérification visuelle rapide ici permet de repérer les problèmes évidents, comme une colonne de géométrie vide ou une emprise dans le mauvais hémisphère, avant la mise en ligne du fichier.
- Enseigner ou présenter le format GeoParquet. Comme le panneau d'informations sur le fichier affiche la colonne de géométrie principale, le CRS et l'encodage directement à partir des métadonnées du fichier, c'est un moyen pratique de montrer à des étudiants ou des collègues ce que contient réellement un fichier GeoParquet.
- Récupérer des données utilisables quand aucun autre visualiseur n'est disponible. Tous les outils SIG de bureau ne savent pas encore lire le GeoParquet. Quand vous avez simplement besoin de voir ce que contient un fichier .parquet dans l'instant, ou de le ressortir en GeoJSON pour un outil qui ne comprend que ce format, cela évite d'avoir à installer quoi que ce soit.
Questions fréquentes
Quel type de fichier puis-je ouvrir ici ?
Tout fichier conforme à la spécification GeoParquet : un fichier Apache Parquet classique comportant, au niveau du schéma, une clé de métadonnées "geo" décrivant une colonne de géométrie. Les fichiers produits par GeoPandas, l'extension spatiale de DuckDB, ogr2ogr, Apache Sedona, ou par le convertisseur GeoJSON vers GeoParquet de ce site fonctionnent tous.
Quel encodage de géométrie le visualiseur prend-il en charge ?
Le WKB (Well-Known Binary), qui est l'encodage par défaut et de loin le plus courant pour les fichiers GeoParquet aujourd'hui. GeoParquet 1.1 définit aussi des encodages Arrow natifs distincts pour chaque type de géométrie ; les fichiers utilisant ces encodages ne sont pas encore pris en charge, et le visualiseur vous le signalera clairement le cas échéant.
Prend-il en charge les fichiers de points, lignes et polygones, y compris les géométries multi-parties ?
Oui. Point, LineString, Polygon, MultiPoint, MultiLineString et MultiPolygon sont tous décodés correctement, y compris les fichiers qui mélangent plusieurs types de géométrie dans la même colonne.
Que deviennent les coordonnées 3D (Z) ou mesurées (M) ?
Le lecteur reconnaît à la fois le style EWKB de PostGIS et le style ISO WKB pour marquer les dimensions Z et M, et ignore correctement ces valeurs supplémentaires afin que le reste de la géométrie continue à se décoder normalement. Comme la sortie GeoJSON et la carte sont intrinsèquement en 2D, seuls X et Y sont conservés pour l'affichage.
Comment le visualiseur sait-il quelle colonne contient la géométrie ?
Il lit le champ "primary_column" dans les métadonnées "geo" du fichier, que tout fichier GeoParquet valide doit inclure. C'est aussi ainsi que le visualiseur indique le CRS et confirme l'encodage avant de tenter de décoder quoi que ce soit.
Que se passe-t-il si mon fichier ne contient aucune métadonnée "geo" ?
C'est alors un simple fichier Parquet, pas un fichier GeoParquet, et le visualiseur l'indiquera plutôt que de deviner. Une colonne de géométrie sans métadonnées associées pourrait être en WKB, en WKT ou dans un tout autre format, il n'existe donc aucun moyen sûr de la décoder automatiquement.
Y a-t-il une limite de taille de fichier ?
Les fichiers importés sont limités à 100 Mo. Les très gros fichiers peuvent aussi être lents à afficher sur la carte, car chaque entité devient une couche Leaflet ; pour les fichiers comptant plusieurs centaines de milliers de lignes, l'affichage initial peut prendre quelques secondes.
Puis-je récupérer mes données en GeoJSON ?
Oui. Le bouton "Télécharger en GeoJSON" exporte chaque entité décodée, géométrie et propriétés comprises, sous forme d'une FeatureCollection GeoJSON standard que vous pouvez ouvrir dans n'importe quel outil SIG.
Mon fichier est-il envoyé sur un serveur ?
Non. La lecture du fichier Parquet, le décodage de la géométrie WKB et l'affichage de la carte se déroulent entièrement en local dans votre navigateur grâce à WebAssembly. Le fichier ne quitte jamais votre appareil.
La lecture s'effectue entièrement dans votre navigateur grâce à Apache Arrow et à une compilation WebAssembly de parquet-wasm. Aucun fichier n'est jamais envoyé à un serveur. Tuiles de carte © contributeurs d'OpenStreetMap, dessinées avec Protomaps (hébergé par KONAKTIVE), avec CARTO en secours.
