Différences

Ci-dessous, les différences entre deux révisions de la page.

--- tutoverpass:jour_1_la_requete_elementaire [2020/05/14 09:16] – [Jour #1 – La requête élémentaire] admin
+++ tutoverpass:jour_1_la_requete_elementaire [2023/11/06 12:52] (Version actuelle) – [Jour 1 – La requête élémentaire] charles
@@ Ligne 1: / Ligne 1: @@
-====== Jour #1 – La requête élémentaire ======
+====== Jour 1 – La requête élémentaire ======
-La requête élémentaire est constituée de deux instructions :
+La requête élémentaire est constituée de **deux instructions** :
-/ La première instruction sélectionne dans la base de données OSM (ou plutôt dans une copie) un lot de données. Voici sa syntaxe :
+La première instruction consiste à **sélectionner un lot de données** dans la base de données OSM (ou plutôt dans une copie). Voici sa syntaxe :
-  * node, way ou rel : le type d'élément recherché
+  * ''node'', ''way'' ou ''rel'' : le type d'élément recherché
-  * entre [ ] : un ou plusieurs filtres sur les tags
+  * entre ''[ ]'' : un ou plusieurs filtres sur les tags
-  * entre ( ) : d'autres types de filtres
+  * entre ''( )'' : un ou plusieurs filtres de divers types
-Toute instruction se termine par un point-virgule.
+Les filtres entre parenthèses sont souvent des filtres géographiques, comme ''%%{{bbox}}%%'' qui décrit la zone visible sur la carte sur Overpass Turbo. Nous en verrons d'autres.
-Les autres types de filtres sont souvent des filtres géographiques, comme %%{{bbox}}%% qui décrit la zone visible sur la carte sur Overpass Turbo. Nous en verrons d'autres.
+La seconde instruction consiste à **retourner ce lot de données** comme //résultat de la requête// Overpass. Il s'agit de l'instruction ''out'' dont nous verrons quelques variantes.
-La **seconde instruction** consiste à retourner ce lot de données comme **résultat** de la requête Overpass. Il s'agit de l'action 'out' dont nous verrons quelques variantes.
+Par exemple, la requête suivante retourne les arrêts de bus avec un abri. L'instruction de sélection combine deux filtres sur les //tags// et un filtre géographique : les 3 conditions doivent être remplies (//ET// logique). Seuls les //nodes// qui portent les //tags// ''highway=bus_stop'' **//ET//** ''shelter=yes'', **//ET//** se trouvent dans la zone visible de la carte, sont sélectionnés.
-Par exemple, la requête suivante retourne les arrêts de bus avec un abri. L'instruction de sélection combine deux filtres sur les tags et un filtre géographique : les 3 conditions doivent être remplies. Seuls les nodes qui portent les tags <tt>highway=bus_stop</tt> et <tt>shelter=yes</tt>, et se trouvent dans la zone visible de la carte, sont sélectionnés.
 <code>
@@ Ligne 23: / Ligne 21: @@
 </code>
-Un filtre sur les tags peut ne contenir que la clef : sont retournés tous les éléments pour lequel ce tag **est défini**, //quelle que soit sa valeur// :
+<WRAP center round info 80%>
+Une instruction peut être écrite sur une ou plusieurs lignes, cela n'a pas d'importance. Par contre, toute instruction Overpass, se termine par un point-virgule : '';''. Il est même possible de placer plusieurs instructions sur la même ligne, ainsi la requête ci-dessus peut être écrite :
+<code>
+node[highway=bus_stop][shelter=yes]({{bbox}}); out;
+</code>
+</WRAP>
+Un filtre de tag peut ne contenir que la //clef// : sont conservés les éléments pour lequel ce //tag// **est défini**, //quelle que soit sa valeur// :
 <code>
@@ Ligne 42: / Ligne 47: @@
 </code>
-Lorsque la clef ou la valeur du filtre contient un espace, un accent ou un caractère spécial, il est nécessaire de placer cette clef et/ou cette valeur **entre quotes**. Exemple avec un nom de lieu en breton :
+Lorsque la //clef// ou la //valeur// du filtre contient une espace, un accent ou un caractère spécial, il est nécessaire de placer cette //clef// et/ou cette //valeur// **entre //quotes//**. Exemple avec un nom de lieu en breton :
 <code>
@@ Ligne 51: / Ligne 56: @@
 </code>
-Les quotes simples et doubles sont possibles, je conseille toutefois les **quotes doubles** qui ne seront pas perturbées par la présence de quotes simples dans les noms.
+Les //quotes// simples et doubles sont possibles, je conseille toutefois les **//quotes// doubles** qui ne seront pas perturbées par la présence de //quotes// simples dans les noms.
+<WRAP center round important>
+Notez que cette dernière requête contient deux filtres de tags mais **aucun filtre géographique**. Les filtres de tags sont en effet suffisamment restrictifs pour que le résultat soit de taille raisonnable. Mais ne faites pas ça pour obtenir tous les restaurants de la planète : les serveurs Overpass sont très utilisés et limitent la durée d'exécution d'une requête et le volume du résultat.
+</WRAP>
 ===== Exercices =====