====== Jour 15 – Données pour un tableur ======

Il est souvent utile de pouvoir exporter les données pour les utiliser dans un **tableur**. Overpass permet de produire le résultat au **format CSV** : chaque élément est exporté sur une ligne dont les tags sont séparées par une virgule (ou un autre séparateur). Le résultat n'est évidemment pas visible sur la carte mais dans l'onglet Données.

Exporter au format CSV se définit dans l'**entête de la requête**, avec la syntaxe ''[out:csv(<colonnes>]'', où <colonnes> énumère les tags à exporter, séparés par une virgule. Cet exemple produit la liste de tous les commerces de Montrouge portant le tag "opening_hours:covid19"

<code>
[out:csv(shop, name, "opening_hours:covid19")];
area[admin_level=8][name="Montrouge"];
nwr[shop]["opening_hours:covid19"](area);
out;
</code>

Notez que la présence d'un double-point dans la clef ''opening_hours:covid19'' exige de l'entourer de simple ou double-quotes.

<WRAP center round help 80%>
Vous ne connaissez pas le tag opening_hours:covid19 ?  Allez voir la carte des lieux ouverts pendant le confinement, un beau projet initié par le groupe OSM de Montrouge : https://www.caresteouvert.fr/ 
</WRAP>

Il est également possible d'**exporter les coordonnées géographiques** en utilisant les marqueurs ''::lat'' et ''::lon''. Ceux-ci ne sont disponibles que pour les nodes, mais il est possible de les utiliser pour les ways et relations, en utilisant l'option d'export ''out center'', qui produit un point à partir d'une ligne ou d'un polygone – attention ce point n'est pas garanti de se trouver à l'intérieur du polygone ou sur la ligne dont il est issu.

<code>
[out:csv(shop, name, "opening_hours:covid19", ::lat, ::lon)];
area[admin_level=8][name="Montrouge"];
nwr[shop]["opening_hours:covid19"](area);
out center;
</code>

Le séparateur par défaut est la tabulation. Il est possible de **définir le séparateur** en ajoutant après la liste des clefs un point-virgule (et non plus une virgule qui sépare chaque clef), suivi d'un booléen qui contrôle l'export des noms de colonnes en première ligne, puis du séparateur après un autre point-virgule. Exemple : 

<code>
[out:csv(shop, name, "opening_hours:covid19", ::lat, ::lon; true; ";")];
</code>

Remarquez que si la valeur d'un tag contient le séparateur (ce qui est courant avec le point-virgule, séparateur de valeurs pour les tags OSM), cette valeur est placée entre double-quotes.

À condition d'utiliser l'option d'export ''out meta'', il est également possible d'exporter certaines méta-données :
  * ''::version''   -> version de l'objet OSM
  * ''::timestamp'' -> date et heure de la dernière modification
  * ''::user'' -> contributeur ayant fait cette modification 
  * ''::type'' -> type de l'objet (node, way ou relation)
  * ''::id'' -> identifiant OSM de l'objet

La requête ci-dessous utilise une partie de ces options :
<code>
[out:csv(
  shop, name, "opening_hours:covid19", ::lat, ::lon,
  ::user, ::version, ::timestamp; true; ";")];
area[admin_level=8][name="Montrouge"];
nwr[shop]["opening_hours:covid19"](area);
out center meta;
</code>

© CC-by-sa Carto’Cité