Programme principal

L'interface finale de JaVelo est constituée d'une unique fenêtre montrant le fond de carte OpenStreetMap, qui peut être déplacé et dont l'échelle peut être changée. Au démarrage, la carte est affichée au niveau de zoom 12, et les coordonnées du coin haut-gauche, dans le système de coordonnées de la carte du monde entier, sont (x = 543200, y = 370650).

Chaque clic sur le fond de carte provoque l'ajout d'un nouveau point de passage après les éventuels déjà existants. La position d'un point peut être changée en cliquant sur lui puis en déplaçant la souris tout en maintenant le bouton enfoncé, avant de le relâcher à l'endroit désiré. Un clic sans déplacement provoque la suppression du point de passage. Lorsqu'un point de passage ne peut pas être ajouté ou déplacé à un endroit donné car aucune route ne se trouve à proximité, un message d'erreur apparaît temporairement à l'écran.

Dès qu'au moins deux points de passage sont présents, le meilleur itinéraire les reliant est calculé et affiché, sauf s'il est impossible de relier au moins deux des points successifs. Lorsqu'un itinéraire est affiché, son profil l'est également dans la partie inférieure de la fenêtre.

Une position le long de l'itinéraire peut être mise en évidence, et lorsque c'est le cas, elle l'est simultanément sur la carte — au moyen d'un disque rouge et blanc — et sur le profil — au moyen d'une ligne noire. La position mise en évidence est déterminée par celle du pointeur de la souris :

• s'il survole la carte et se trouve à moins de 15 pixels de l'itinéraire, alors la position de l'itinéraire la plus proche de lui est mise en évidence,
• s'il survole le graphe du profil, alors la position correspondante de l'itinéraire est mise en évidence.

Un clic sur le disque rouge et blanc de mise en évidence provoque l'ajout d'un nouveau point de passage entre les points voisins de la position qu'il représente.

Lorsqu'un itinéraire existe, il peut être exporté au format GPX en sélectionnant l'unique entrée du menu Fichier, qui se nomme Exporter GPX. L'itinéraire est exporté dans un fichier nommé javelo.gpx, placé dans le répertoire courant de l'application.

La vidéo ci-dessous illustre les principales fonctionalités de l'interface décrites à l'instant. Les données utilisées sont celles de la Suisse occidentale (ch_west), mais le répertoire les contenant a été renommé javelo-data conformément aux instructions de la §3.4.

Avant d'entamer cette étape, il convient de corriger certaines erreurs qui ont été faites durant les étapes précédentes.

SimpleLongProperty minScrollTime = new SimpleLongProperty();
pane.setOnScroll(e -> {
    if (e.getDeltaY() == 0d) return;
    long currentTime = System.currentTimeMillis();
    if (currentTime < minScrollTime.get()) return;
    minScrollTime.set(currentTime + 200);
    int zoomDelta = (int) Math.signum(e.getDeltaY());
    // … reste du code
  });

public int indexOfNonEmptySegmentAt(double position) {
  int index = route().indexOfSegmentAt(position);
  for (int i = 0; i <= index; i += 1) {
    int n1 = waypoints.get(i).nodeId();
    int n2 = waypoints.get(i + 1).nodeId();
    if (n1 == n2) index += 1;
  }
  return index;
}

La classe AnnotatedMapManager du sous-paquetage gui, publique et instanciable (donc finale), gère l'affichage de la carte « annotée », c.-à-d. le fond de carte au-dessus duquel sont superposés l'itinéraire et les points de passage.

L'unique constructeur public de cette classe prend en arguments :

• le graphe du réseau routier, de type Graph,
• le gestionnaire de tuiles OpenStreetMap, de type TileManager,
• le bean de l'itinéraire, de type RouteBean,
• un « consommateur d'erreurs » permettant de signaler une erreur, de type Consumer<String>.

Grâce à ces arguments, le constructeur crée un gestionnaire de fond de carte (BaseMapManager), un gestionnaire de points de passage (WaypointsManager) et un gestionnaire d'itinéraire (RouteManager) et combine, par empilement, leurs panneaux respectifs.

En dehors du constructeur, la classe AnnotatedMapManager offre deux méthodes publiques, qui sont :

• une méthode, nommée p. ex. pane, retournant le panneau contenant la carte annotée,
• une méthode, nommée p. ex. mousePositionOnRouteProperty, retournant la propriété contenant la position du pointeur de la souris le long de l'itinéraire.

La propriété retournée par mousePositionOnRouteProperty contient la position, le long de l'itinéraire, du point le plus proche du pointeur de la souris, ssi la distance séparant ce point du pointeur est inférieure ou égale à 15 unités JavaFX (pixels). Sinon, elle contient NaN.

La classe ErrorManager du sous-paquetage gui, publique et instanciable (donc finale), gère l'affichage de messages d'erreur.

Elle possède un constructeur public dénué d'arguments, et offre deux méthodes publiques :

• une méthode, nommée p. ex. pane, retournant le panneau, de type Pane, sur lequel apparaissent les messages d'erreur,
• une méthode, nommée p. ex. displayError, prenant en argument une chaîne de caractères représentant un (court) message d'erreur et le faisant apparaître temporairement à l'écran, accompagné d'un son indiquant l'erreur.

La classe JaVelo du sous-paquetage gui, publique et instanciable (donc finale), est la classe principale de l'application. Comme toute classe représentant une application JavaFX, elle hérite de Application.

La méthode start de JaVelo se charge de construire l'interface graphique finale en combinant les parties gérées par les classes écrites précédemment et en y ajoutant le menu très simple présenté plus haut.

Les différents composants créés par la classe JaVelo doivent être configurés ainsi :

• le graphe est chargé depuis le répertoire nommé javelo-data,
• le cache disque de tuiles est stocké dans le répertoire nommé osm-cache,
• l'hôte du serveur de tuiles est tile.openstreetmap.org,
• la fonction de coût est une instance de CityBikeCF,
• la taille minimale de la fenêtre est de 800×600 unités,
• le titre de la fenêtre est JaVelo.

Étant donné que la classe représentant le programme principal doit impérativement avoir le bon nom et posséder une méthode main ayant la bonne signature, nous vous fournissons une archive Zip contenant un fichier de vérification de signature pour cette étape. Il doit être intégré à votre projet comme ceux des étapes 1 à 6. Notez toutefois que les anciens fichiers de vérification de signature ne sont plus nécessaires, et peuvent être supprimés.