Optimiser la performance des applications JMap Survey / Optimize the performance of JMap Survey applications

Jump to English version

Cet article aborde des aspects à valider lors de la configuration pour optimiser la performance des applications JMap Survey. 

JMap Survey est une application mobile de la famille des applications JMap (JMap Pro, JMap Web et JMap Survey) qui fonctionne sur des téléphones intelligents et tablettes iOS et Android.

Elle permet notamment l'affichage de données vectorielles et matricielles d'un projet JMap et l'édition de données vectorielles, autant en mode connecté que déconnecté.

Ces caractéristiques rendent JMap Survey approprié pour la saisie des données sur le terrain lors de la réalisation de travaux tels que les inventaires d'arbres, les inspections de bâtiments et d'infrastructures ou le suivi de l'avancement de projets octroyés en sous-traitance. JMap Survey n'est pas une application appropriée pour l'analyse des données comme JMap Pro ou JMap Web.

Comment fonctionne JMap Survey

Contrairement à JMap Mobile, Survey ne fonctionne pas avec un déploiement. En fait, l'application se connecte directement avec un projet JMap à travers l'API REST. Il n'est donc plus nécessaire de produire un déploiement pour utiliser Survey, comme c'était le cas avec JMap Mobile. La configuration du projet a donc une importance majeure dans le bon fonctionnement de JMap Survey.

Les couches non éditables du projet (celles dont la source de données spatiales ne permet pas l'édition ou celles dont aucun formulaire n'est défini) sont converties en tuiles vectorielles MapBox (MVT) pour être envoyées à JMap Survey. 

Les couches éditables sont envoyées à JMap Survey en format GeoJSON.

Les données collectées ou modifiées avec JMap Survey sont écrites directement dans les sources de données correspondantes.

Fonctionnalités supportées

Les fonctionnalités suivantes sont supportées par JMap Survey :

• Visualisation du projet incluant les couches vectorielles et matricielles
• Permissions sur les couches
• Seuils d'échelles
• Hiérarchie des couches
• Infobulles (avec hyperliens et photos)
• Étiquettes automatiques
• Thématiques (seulement si actives par défaut dans le projet)
• Édition de points, lignes et polygones avec support des formulaires d'attributs, de BD externe incluant sous-formulaires
• Mode déconnecté
• Extension JMap Documents (Si détectée côté serveur)

Fonctionnalités non supportées

La version actuelle de JMap Survey ne supporte pas les fonctionnalités suivantes :

• Cartes de chaleur
• Regroupements de points
• Épaisseur des bordures de polygones
• Requêtes par attributs
• Métadonnées
• Rapports d'information
• Filtres dynamiques des couches

Limites de la version Android

• Extension JMap Documents n'est pas supportée
• Édition des lignes et polygones non supportée
• Fonctions username(), fullname(), date() et datetime() ne sont pas supportées

Conseils pour optimiser un projet pour JMap Survey

Plusieurs aspects de la configuration d'un projet peuvent contribuer à optimiser les applications JMap Survey. Voici quelques conseils pour la configuration d'un projet :

• Nous recommandons la création d'un projet dédié à JMap Survey contenant les couches éditables ainsi que quelques fonds de carte en guise de repère visuel. Un projet allégé favorise le fonctionnement optimal de JMap Survey.
• Les couches matricielles sont reprojetées à la volée. Si vous avez besoin d'ouvrir des couches matricielles avec JMap Survey, nous vous suggérons d'utiliser la projection EPSG:3857 dans votre projet. La projection des images doit être aussi EPSG:3857 pour que les images s'affichent correctement et rapidement.
• JMap Survey se connecte au projet JMap à travers l'API REST, le fonctionnement de l'application dépend donc de l'API. Assurez-vous que le service est disponible (ex. : l'adresse <adresse_jmap>/services/rest doit être accessible).

• Si JMap Survey est utilisé en mode proxy, vous devez déplier le fichier services.war sur le serveur de tomcat pour lui donner accès à l'API REST.

• Effectuez des test avant le travail en mode déconnecté, vérifiez les journaux pour déceler les problèmes potentiels moins apparents. Ainsi, vous évitez les risques de pertes de données dus aux problèmes de configuration.
• Comme dans le cas des applications JMap Web, assurez-vous que le tuilage des couches du projet chargées par tuiles est approprié pour le volume des données. Utilisez la fonction Estimer pour obtenir le meilleur tuilage (JMap Admin : Projet > Couche > Assistant de configuration de la couche > Mode de chargement).

English version

This article addresses details that need validation while doing the setup in order to optimize the performance of JMap Survey applications.

JMap Survey is a mobile application from the JMap family of applications (JMap Pro, JMap Web and JMap Survey) that runs on iOS and Android smartphones and tablets. It allows the display of vector and raster data from a JMap project and the editing of vector data, both in online and offline mode.

These features make JMap Survey suitable for collecting field data when performing work such as tree inventories, building and infrastructure inspections or monitoring the progress of subcontracted projects. JMap Survey is not an appropriate application for data analysis like JMap Pro or JMap Web.

How JMap Survey works

Unlike JMap Mobile, Survey does not work with a deployment. In fact, the application connects directly with a JMap project through the REST API. It is no longer necessary to produce a deployment to use Survey, as it was the case with JMap Mobile. The project configuration is therefore of major importance in the proper functioning of JMap Survey.

The non-editable layers of the project (those whose spatial data source does not allow editing or those with no form defined) are converted to MapBox vector tiles (MVT) to be sent to JMap Survey.

Editable layers are sent to JMap Survey in GeoJSON format.

The data collected or modified with JMap Survey is written directly to the corresponding data sources.

Supported features

The following features are supported by JMap Survey:

• Visualization of the project including the vector and raster layers
• Layer permissions
• Visibility thresholds
• Layers hierarchy
• Mouseover (with hyperlinks and photos)
• Automatic labeling
• Thematics (only if enabled by default in the project)
• Editing points, lines, and polygons with support for attribute forms, external DBs including subforms
• Offline mode
• JMap Documents Extension (If detected on the server side)

Unsupported features

The current version of JMap Survey does not support the following features:

• Heat maps
• Points clustering
• Thickness of polygon borders
• Attribute queries
• Metadata
• Information reports
• Dynamic filters

Limits of the Android version

• JMap Document Extension is not supported
• Editing of lines and polygons is not supported
• Username(), fullname(), date() and datetime() functions are not supported

Tips for optimizing a project for JMap Survey

Several aspects of the project configuration can help optimize JMap Survey applications. Here are some tips for configuring a project:

• We recommend the creation of a dedicated project for JMap Survey where editable layers and basemaps for visual reference are located. A lighter project optimizes the performance of JMap Survey.
• Raster layers are reprojected on the fly. If you need to open raster layers with JMap Survey, we suggest to use the EPSG:3857 projection in your project. The projection of the images must also be EPSG:3857 so that the images are displayed correctly and quickly.
• JMap Survey connects to the JMap project through the REST API, so the application depends on the API. Make sure that the service is available (e.g. : <address_jmap>/services/rest must be accessible).
• If JMap Survey is used with a proxy, you must deploy the services.war file on the tomcat server to give it access to the REST API.
• Perform tests before working offline, check the logs for less than obvious potential problems. This way, you avoid the risk of data loss due to a setup problem.
• As with JMap Web applications, make sure that tiling of tile-loaded project layers is appropriate for the volume of data. Use the Estimate function to get the best tiling (JMap Admin: Project>Layer>Layer Setup Wizard>Load Mode).