tykayn/mapping-geojson-osm
1
0
Fork 0
Code Issues Pull Requests Projects Releases Wiki Activity

up doc

Browse Source
This commit is contained in:
Tykayn 2024-07-08 11:47:51 +02:00 committed by tykayn
parent 7388cf8461
commit ad9a0e0676
3 changed files with 39 additions and 23 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

12
docs/configuration_de_conversion.md
View File

@ -52,16 +52,16 @@ Ce qui équivaut à une utilisation d'objet ainsi
Les propriétés possibles sont: Les propriétés possibles sont:
| Clé | Description | Type | Valeur par défaut | | Clé | Description | Type | Valeur par défaut |
| --- | --- | --- | --- | |------------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| --- | --- |
| conditional_values | Valeurs conditionnelles, détail ci après | objet | null | | conditional_values | Valeurs conditionnelles, détail ci après | objet | null |
| convert_to_boolean_value | Convertit la valeur en booléen | boolean | false | | convert_to_boolean_value | Convertit la valeur en booléen | boolean | false |
| convert_to_phone | Convertir en numéro de téléphone | boolean | false | | convert_to_phone | Convertir en numéro de téléphone | boolean | false |
| ignore_if_falsy | Ignorer cette ligne si elle vaut false ou 0 | boolean | false | | ignore_if_falsy | Ignorer cette ligne si elle vaut false ou 0 | boolean | false |
| invert_boolean_value | Inverser la valeur booléenne | boolean | false |
| key_converted | Convertir en clé OSM | string | null | | key_converted | Convertir en clé OSM | string | null |
| remove_original_key | Enlever la ligne | boolean | false | | remove_original_key | Enlever la ligne | boolean | false |
| socket_output_find_correspondances | Chercher une puissance de socket pour borne de recharge électrique | boolean | false | | socket_output_find_correspondances | Chercher une puissance de socket pour borne de recharge électrique | boolean | false |
| truthy_value | Convertir en valeur truthy, true ou 1 | boolean | false |
Exemple: Exemple:
@ -93,11 +93,15 @@ Un objet décrivant par ses clés des comportements à faire selon la valeur don
Propriétés: Propriétés:
| Clé | Description | Type | Valeur par défaut | | Clé | Description | Type | Valeur par défaut |
| --- | --- | --- | --- | | --- |-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| --- | --- |
| ignore_this_data | Ignorer, pour évacuer des valeurs indésirables | | | | ignore_this_data | Ignorer, pour évacuer des valeurs indésirables | | |
| tags_to_add | Tags à ajouter | objet | | | tags_to_add | Tags à ajouter | objet | |
| transform_function | Une fonction à appliquer à la valeur | | | | transform_function | Une fonction à appliquer à la valeur | | |
| convert_to_boolean_value | Convertit en 'yes' si la valeur est Truthy, et en 'no' si elle est Falsy. Et ne change pas la valeur si elle n'est ni Truthy ni Falsy. | | |
| value_converted | valeur à convertir | string ou number | | | value_converted | valeur à convertir | string ou number | |
| truthy_value | Convertir la valeur dans le cas où elle est Truthy. exemple: le jeu de données dit que la colonne cable_t2_attache vaut "True", mais on veut le convertir en "1". On met donc truthy_value: '1' | boolean | false |
| falsy_value | Convertir la valeur dans le cas où elle est Falsy, comme pour truthy_value. | boolean | false |
| invert_boolean_value | Inverser la valeur booléenne | boolean | false |
### Tags à ajouter ### Tags à ajouter
Quand on utilise la clé "tags_to_add", on lui met en valeur un tableau de tags OSM à ajouter. Quand on utilise la clé "tags_to_add", on lui met en valeur un tableau de tags OSM à ajouter.

19
docs/engine.md
View File

@ -8,8 +8,25 @@ Les conversions de jeux de données Geojson se font via des règles définies pa
- filtrer les données selon des critères géographiques ou d'offset limité - filtrer les données selon des critères géographiques ou d'offset limité
Après initialisation de l'Engine avec un `Mapper`, on lui passe un jeu de données geojson et on lance la conversion de données avec `mapElementFromConf()`. Après initialisation de l'Engine avec [un `Mapper`](configuration_de_conversion.md), on lui passe un jeu de données geojson et on lance la conversion de données avec `mapElementFromConf()`.
Cela est réalisé dans le point d'entrée principal en node typescript: `convert_to_osm_tags.ts` Cela est réalisé dans le point d'entrée principal en node typescript: `convert_to_osm_tags.ts`
Les conversions de chaque propriété sont faites par la fonction convertProperty:
```
convertProperty(pointKeyName, mappingKeys, featurePoint, newProperties) convertProperty(pointKeyName, mappingKeys, featurePoint, newProperties)
```
| paramètre | description |
|---------------|---------------------------------------|
| pointKeyName | clé de propriété du geojson |
| mappingKeys | liste des clés de propriétés du Point |
| featurePoint | Point geojson |
| newProperties | objet des nouvelles propriétés |
# Jardinage à partir d'OSM
L'option jardinage permet de ne pas convertir les propriétés de Geojson dans le cas où l'on extrait les données d'OSM.
Cela nécessite un mappeur différent pour appliquer des transformations de mise en qualité.
# Stats
L'engine publie des statistiques de conversion de données

5
mappings/engine.ts
View File

@ -248,14 +248,9 @@ export default class {
if (configObject.key_converted) { if (configObject.key_converted) {
newKey = configObject.key_converted newKey = configObject.key_converted
} }
if (configObject.transform_function) { if (configObject.transform_function) {
// une transformation de la valeur
// apply transformation to value
convertedValue = configObject.transform_function(originalValue) convertedValue = configObject.transform_function(originalValue)
// console.log('transform_function: originalValue', originalValue, convertedValue)
// this.stats.power_output++
} }