scripts/kartaview_exif_mapper/README.md

# Kartaview exif mapper

Mapper les données exif des photos exportées de kartaview.

# installation
utiliser `npm i`
# mode d'action

configurer le dossier en argument dans le script, ou bien lancer celui ci avec l'argument folder.

```bash
ts-node main.ts --folder=/folder/path
```

Cela va convertir en trace GPX les fichiers de métadonnées kartaview
retrouver le dossier et les photos correspondantes, et appliquer les informations exif de positionnement gps aux photos afin de les envoyer sur panoramax avec l'outil geovisio_cli.

Pour appliquer les métadonnées aux photos, un script bash utilisant **exiftool** est généré dans le dossier d'output.

## options de CLI

sequence : numéro de séquence, correspond à un dossier photo de l'export

folder : chemin du dossier contenant l'export kartaview

gpx-output : nom de fichier de gpx en sortie de conversion

gpx-input : un chemin de fichier txt de kartaview donnant les informations de positionnements de trace pour une séquence

# trace gpx example
prendre dans la section body, l'info géographique g, colonne 3 et 4 pour latitude, longitude.

> METADATA:2.0
  HEADER
  ALIAS:d;DEVICE;1;1
  ALIAS:g;GPS;1;1
  ALIAS:o;OBD;1;1
  ALIAS:cam;CAMERA;2;2
  ALIAS:exif;EXIF;2;2
  ALIAS:p;PRESSURE;1;1
  ALIAS:c;COMPASS;1;1
  ALIAS:f;PHOTO;1;1
  ALIAS:a;ACCELERATION;1;1
  ALIAS:y;ATTITUDE;1;1
  ALIAS:x;GRAVITY;1;1
  BODY
  1599225187.923:d:Android;P;9;OnePlus ONEPLUS A5000;3.1.6;3.1.6;photo
  1599225187.958:exif:4.103;3840;2160
  1599225187.958:cam:64.8699962380788;51.01659133079809;1.7
  1599225189.000:g:48.61844552;2.12523291;155.55169677734375;3.216;3.216;0.0
>
> ...
>
> END
# liens entre les fichiers
Les photos exportées de kartaview n'ont pas d'informations GPS.

kartaview n'a pas documenté ses liens entre fichiers, on devine donc que les dossiers ont un numéro qui relient les infos de séquence dans un fichier texte au format privé .txt avec les photos concernées.

## Example de nom de dossier
3596249
## Example de timestamp dans le fichier de métadonnées txt
1599225189.000
correspond à :
Date Fri Sep 04 2020 15:13:09 GMT+0200 (heure d’été d’Europe centrale)

```  
let d = new Date(1599225189*1000);
```
## Example de nom de fichier photo
3596249_f3ccd_60a0f9cda58b5.jpg