Géométries

 

L'API des géométries de JMap est utilisée pour le développement dans JMap Pro et dans JMap Server.

Les géométries dans JMap sont à la base de tous les éléments vectoriels qui s'affichent sur la carte. Il s'agit de classes simples représentant les types géométriques de base tels que les points, les lignes et les surfaces. Le modèle de classes des géométries utilisé dans JMap est grandement inspiré du modèle de géométries publié par l'Open Geospatial Consortium. Les géométries ne contiennent ni attributs, ni identifiants, ni propriétés d'affichage mais seulement des coordonnées en 2 dimensions (x,y).

 

Dans JMap, les classes de géométries sont dans le package com.kheops.jmap.spatial. L'interface que toutes les géométries implémentent est Geometry.

Le type de géométrie de base dont toutes les géométries sont composées est le Point. Ce type contient uniquement une coordonnée (x,y). Cette classe est abstraite et il est donc nécessaire d'utiliser ses dérivées Point.Float (simple précision) et Point.Double (double précision).

 

Les principales classes de géométries sont les suivantes :

 

Des versions composites des géométries existent afin de supporter les collections de géométries de même type. Ces classes sont: MultiPoint, MultiCurve, MultiLineString, MultiSurface et MultiPolygon. De plus, la classe Complex est un type spécial de collection de géométries de types variés.

Afin de gérer plus facilement tous ces types de géométries, 3 interfaces sont disponibles : PointTypeGeometry, LineTypeGeometry, PolygonTypeGeometry, AnnotationTypeGeometry et EllipseTypeGeometry. Ces interfaces regroupent respectivement tous les types de géométries, incluant les collections.

Précision des géométries

Les géométries dans JMap peuvent être en double précision ou en simple précision. La simple précision, combinée avec d'autres stratégies, est utilisée principalement dans un but de compression des données, afin d'optimiser les performances du système. Comme programmeur, vous devriez utiliser uniquement la double précision.

Opérations sur les géométries

Opérateurs spatiaux

Les opérateurs spatiaux permettent de faire des calculs géométriques sur les géométries. Ces calculs peuvent donner des résultats de 3 types différents:

•résultats numériques (p. e. calculer la distance entre 2 géométries)

•résultats booléens (ex.: tester si 2 géométries s'intersectent)

•résultats géométriques (calculer l'union de 2 géométries).

La classe GeometryUtil fournit des méthodes simples pour effectuer des calculs sur les géométries. Les méthodes les plus souvent utilisées sont présentées dans le tableau suivant:

Modèles de précision

La classe PrecisionModel permet de définir la tolérance considérée pour effectuer les calculs utilisant les géométries. Le fait d'utiliser un modèle de précision bien adapté aux géométries permet d'obtenir des résultats plus précis lors des calculs.

Le modèle de précision varie en général selon le type d'unité des données (mètres, degrés, etc.). La classe PrecisionModelFactory permet d'obtenir une instance de PrecisionModel pour une unité donnée. Chaque instance de la classe Layer possède aussi sa propre instance de PrecisionModel qu'il est possible d'utiliser. Il est aussi possible de demander à JMap de déterminer le modèle de précision optimal pour une géométrie spécifique.

L'exemple suivant montre comment obtenir un modèle de précision de différentes manières.

Transformations

Les transformations permettent d'appliquer des transformations de toute nature sur les géométries. L'interface Geometry contient une méthode transform(Transformation) qui reçoit une instance de Transformation. Cette méthode crée un clone de la géométrie, applique la transformation spécifiée sur celui-ci et retourne la nouvelle géométrie transformée. Les transformations peuvent modifier les coordonnées qui composent la géométrie et même modifier la nature elle-même de la géométrie. Les transformations peuvent par exemple servir à appliquer une projection cartographique sur des géométries ou à effectuer une généralisation sur celles-ci.

Il est aussi possible d'appliquer des transformations en utilisant la méthode transform() de la classe Transformation. Dans ce cas, la géométrie n'est peut-être pas toujours clonée, selon le type de transformation. Consulter la documentation de chaque transformation pour en connaître davantage.

La classe UnaryTransformation est la classe de base des transformations qui ne modifient que les coordonnées qui composent la géométrie. Si vous devez implémenter votre propre classe de transformation, vous devrez probablement dériver de cette classe.

Le tableau suivant montre les transformations qui sont disponibles avec l'API de JMap.

 

L'exemple de code suivant montre comment utiliser la transformation de changement de précision.

 

 

L'exemple de code suivant montre comment utiliser la transformation de changement de projection cartographique.

 

 

L'exemple de code suivant montre comment créer une classe de transformation anonyme en utilisant l'adaptateur TransformationAdapter. La transformation convertit les points en ellipses.

 

Rectangle englobant

Le rectangle englobant (MBR pour Minimum Bounding Rectangle) d'une géométrie est le plus petit rectangle orthogonal qui englobe totalement la géométrie. Le MBR est utilisé dans JMap pour effectuer des analyses spatiales rapides sur une grande quantité de géométries avant d'utiliser des algorithmes plus précis (mais plus lents) sur un nombre plus restreint de géométries. Tel que prescrit par l'interface Geometry de JMap, tous les types de géométries implémentent la méthode getBounds() qui retourne le MBR de la géométrie.

Le MBR d'un point est un rectangle de largeur 0 et de hauteur 0. Le MBR d'une ligne verticale est un rectangle de largeur 0 et le MBR d'une ligne horizontale est un rectangle de hauteur 0.