Set the location of addresses that are not located yet

[DariaSegalard]

Description

What is the valuable outcome that cannot be achieved with current features?

For the moment, users have to manually go to each vase's page to add the spatial attribute to localize them on the map. It would be easier for them to be able to see all the vases that doesn't have this spatial attribute and have for example a page that allows them to easily set the tomb's number of the vases that are not localized yet.

For which stakeholder (people, role, project, domain) is it important?

Especially for people who want to be able to see easily the vases not localized on the map yet (that miss the spatial attribute), and easily set the tomb where they were found, as a bulk.

Which user action should be enabled (or restricted)? For who?

Examples: Display non-localized vases on a specific page and set their location as a bulk.

• See which vases don't have a set spatial attribute.
• Offer to the user the possibility to set this attribute for all the unspecified vases (bulk).

Additional details (solutions you think about, or workarounds you tried)

Deliverables status

Phase 1

• Scenarios (Gherkin)
• Mockups
• Implementation strategy

Phase 2

• Implementation

Phase 3

• Screencast

[benel]

As discussed with @Hypertopic/vases-grecs-du-kerameikos, I transferred this ticket to GeoXene.

Please note that the description should be changed accordingly (esp. we told about choosing the location on a map and setting the corresponding label).

[benel]

@rooooose Please note that "localization" has a different meaning in software engineering (see Wiktionary). Hence the title should be rephrased.

[CarlaRGanier]

Réalisation des maquettes

Pour faire cette fonctionnalité, nous avons réalisé deux maquettes comportants plusieurs éléments supplémentaires sur GoeXene :

• Un clic sur la map fait apparaître un pointeur bleu qui deviendra rouge s'il est validé
• Lors de la création d'un pointeur, le champ "Address" est vide, il faut le remplir pour ajouter une localisation
• Un bouton "Add location" qui valide la localisation

Maquette n°1 : Création d'un pointeur pour une localisation

Maquette n°2 : Pointeur créé

Co-éditeur : Loïck N.

[LucasDaSilva95]

Scénario :

Soit l'utilisateur se trouve sur la page de Geoxene
Quand l'utilisateur a cliqué sur un point de la carte
Et l'utilisateur a renseigné "Tombe 40, Nécropole au Sud de l'Eridanos, Kerameikos" comme nom de localisation
Et l'utilisateur valide sa saisie
Alors la nouvelle localisation est créée

[LoickNosal]

Stratégie d'implémentation

Quelle partie du code sera impactée (classes, méthodes) ?

Côté BackEnd :
Le fichier server.js (seul fichier du projet GeoXene actuellement) :
Actuellement, les locations sont codées en dur dans le fichier server.js du projet GeoXene.
Afin de pouvoir ajouter une nouvelle localisation depuis GeoXene, il faut creer une table dans une base de données, qui répertoriera toutes les localisations.
Il faudra ajouter manuellement les localisations actuellement écrites dans le fichier dans la base de données.
Il faudra changer les routes existantes une fois la base de données implémentée :
get /json,
get /addresses
Il faudra également ajouter d'autres routes.

Côté FrontEnd :
Il faudra ajouter une icône de curseur (où on clique sur la carte) ainsi qu'un bouton qui permettra l'envoi du formulaire vers le BackEnd.

Les données dont vous avez besoin sont-elles déjà chargées par la page ?

Actuellement oui mais après l'ajout de la base de données, il faudra récupérer les localisations depuis la base.

Quelle est la structure des données et comment allez-vous récupérer précisément celles qui vous intéressent ?

On va utiliser une base de données SQLite Node.js.
Structure de la Table dans la base de données :
Nom (Varchar2), lat (Float(10,6)), lng (Float(10,6))

Existe-t-il des bibliothèques qui pourraient simplifier l'implémentation ? Quelles sont celles que vous choisiriez et pourquoi ?

Oui nous allons utiliser la bibliothèque SQLite Node.js (sqlite3). Cela permet d'implementer facilement une base de données dans un projet Node.js.
Voici un tutoriel afin de mettre en place une base de données SQLite : https://www.youtube.com/watch?v=ueCT4HlQDwQ

Doit-on intégrer des services extérieurs (ex : cartographie) ? De quelles fonctionnalités en particulier aura-t-on besoin ? Est-ce que le service choisi les propose ou doit-on passer chez un concurrent ? Comment s'utilisent ces fonctionnalités ? Avec quels paramètres ?

Non car le service Google Map est déjà implémenté. Il faudra cependant utiliser des fonctionnalités du service Google Map afin d'ajouter un curseur lors du clique sur la carte.

Co-éditeurs : Carla G.

[CarlaRGanier]

What could help for the front implementation :

Add markers on click :

• https://medium.com/@letian1997/click-javascript-google-map-add-draggable-markers-polyline-b834dd5762b2
• https://stackoverflow.com/questions/15792655/add-marker-to-google-map-on-click

Change marker's color :

• https://www.freecodecamp.org/news/how-to-change-javascript-google-map-marker-color-8a72131d1207/

[benel]

Remember to rename the issue (as it is not really related to "vases" but more generally to "addresses").