PostGIS - en to fr translation catalogue (337 entries)

note: Tag: title
en: Data Management
fr: Gestion des données

note: Tag: title
en: Spatial Data Model
fr: Modèle de données spatiales

note: Tag: title
en: OGC Geometry
fr: Géométrie OGC

note: Tag: para
en: The Open Geospatial Consortium (OGC) developed the <ulink url="https://www.ogc.org/standards/sfa"><emphasis>Simple Features Access</emphasis></ulink> standard (SFA) to provide a model for geospatial data. It defines the fundamental spatial type of <emphasis role="bold">Geometry</emphasis>, along with operations which manipulate and transform geometry values to perform spatial analysis tasks. PostGIS implements the OGC Geometry model as the PostgreSQL data types <link linkend="PostGIS_Geometry">geometry</link> and <link linkend="PostGIS_Geography">geography</link>.
fr: L'Open Geospatial Consortium (OGC) a développé le standard <ulink url="https://www.ogc.org/standards/sfa"><emphasis>Simple Features Access</emphasis></ulink> (SFA) pour fournir un modèle de données géospatiales. Ce standard définit le type spatial <emphasis role="bold">Geometry</emphasis>, ainsi que les opérations pour manipuler et transformer des géométries, et permettre des tâches d'analyses spatiales. PostGIS implémente le modèle OGC Geometry sous forme de types PostgreSQL <link linkend="PostGIS_Geometry">geometry</link> et <link linkend="PostGIS_Geography">geography</link>.

note: Tag: para
en: Geometry is an <emphasis>abstract</emphasis> type. Geometry values belong to one of its <emphasis>concrete</emphasis> subtypes which represent various kinds and dimensions of geometric shapes. These include the <emphasis role="bold">atomic</emphasis> types <link linkend="Point">Point</link>, <link linkend="LineString">LineString</link>, <link linkend="LinearRing">LinearRing</link> and <link linkend="Polygon">Polygon</link>, and the <emphasis role="bold">collection</emphasis> types <link linkend="MultiPoint">MultiPoint</link>, <link linkend="MultiLineString">MultiLineString</link>, <link linkend="MultiPolygon">MultiPolygon</link> and <link linkend="GeometryCollection">GeometryCollection</link>. The <ulink url="https://portal.ogc.org/files/?artifact_id=25355"><emphasis>Simple Features Access - Part 1: Common architecture v1.2.1</emphasis></ulink> adds subtypes for the structures <link linkend="PolyhedralSurface">PolyhedralSurface</link>, <link linkend="Triangle">Triangle</link> and <link linkend="TIN">TIN</link>.
fr: Geometry est un type <emphasis>abstrait</emphasis>. Les valeurs géométriques utilisent les sous-types <emphasis>concrets</emphasis>, qui représentent les diverses formes géométriques. Ces types incluent les types <emphasis role="bold">atomiques</emphasis> <link linkend="Point">Point</link>, <link linkend="LineString">LineString</link>, <link linkend="LinearRing">LinearRing</link> et <link linkend="Polygon">Polygon</link>, ainsi que les types de <emphasis role="bold">collections</emphasis> <link linkend="MultiPoint">MultiPoint</link>, <link linkend="MultiLineString">MultiLineString</link>, <link linkend="MultiPolygon">MultiPolygon</link> et <link linkend="GeometryCollection">GeometryCollection</link>. Le standard <ulink url="https://portal.ogc.org/files/?artifact_id=25355"><emphasis>Simple Features Access - Part 1: Common architecture v1.2.1</emphasis></ulink> ajoute les sous-types pour les structures <link linkend="PolyhedralSurface">PolyhedralSurface</link>, <link linkend="Triangle">Triangle</link> et <link linkend="TIN">TIN</link>.

note: Tag: para
en: Geometry models shapes in the 2-dimensional Cartesian plane. The PolyhedralSurface, Triangle, and TIN types can also represent shapes in 3-dimensional space. The size and location of shapes are specified by their <emphasis role="bold">coordinates</emphasis>. Each coordinate has a X and Y <emphasis role="bold">ordinate</emphasis> value determining its location in the plane. Shapes are constructed from points or line segments, with points specified by a single coordinate, and line segments by two coordinates.
fr: Geometry représente des formes dans le plan cartésien en 2 dimensions. Les types PolyhedralSurface, Triangle, et TIN peuvent également représenter des formes en 3 dimensions. La taille et la localisation des formes sont spécifiées par leurs <emphasis role="bold">coordonnées</emphasis>. Chaque coordonnées a une <emphasis role="bold">dimension</emphasis> X et une Y, qui déterminent sa position sur le plan. Les formes sont construites à partir de points ou de segments. Les points sont spécifiés par une seul coordonnée ; les segments par deux coordonnées.

note: Tag: para
en: Coordinates may contain optional Z and M ordinate values. The Z ordinate is often used to represent elevation. The M ordinate contains a measure value, which may represent time or distance. If Z or M values are present in a geometry value, they must be defined for each point in the geometry. If a geometry has Z or M ordinates the <emphasis role="bold">coordinate dimension</emphasis> is 3D; if it has both Z and M the coordinate dimension is 4D.
fr: Les coordonnées peuvent inclure des valeurs pour les dimensions optionnelles Z et M. La dimension Z est souvent utilisée pour représenter l'élévation. La dimension M contient une mesure, qui représente par exemple le temps ou une distance. Si la dimension Z ou M est présente pour une valeur géométrique, elle doit être définie pour tous les points de la géométrie. Si une géométrie a une dimension Z ou M, la <emphasis role="bold">dimension de la coordonnée</emphasis> est 3D ; si elle a à la fois les dimension Z et M, la dimension de la coordonnée est 4D.

note: Tag: para
en: Geometry values are associated with a <emphasis role="bold">spatial reference system</emphasis> indicating the coordinate system in which it is embedded. The spatial reference system is identified by the geometry SRID number. The units of the X and Y axes are determined by the spatial reference system. In <emphasis role="bold">planar</emphasis> reference systems the X and Y coordinates typically represent easting and northing, while in <emphasis role="bold">geodetic</emphasis> systems they represent longitude and latitude. SRID 0 represents an infinite Cartesian plane with no units assigned to its axes. See <xref linkend="spatial_ref_sys"/>.
fr: Les valeurs géométriques sont associées à un <emphasis role="bold">système de coordonnées de référence</emphasis> (SCR, ou en anglais spatial reference system, SRS), qui indique dans quel système de coordonnées les valeurs sont définies. Le SCR est identifié par un identifiant appelé SRID. Les unités sur les axes X et Y sont déterminées par ce système de coordonnées de référence. Dans un système <emphasis role="bold">planaire</emphasis>, les coordonnées X et Y représentent les distances respectivement selon l'Est et le Nord. Dans un système <emphasis role="bold">géodésique</emphasis> elles représentent la longitude et la latitude. L'identifiant SRID 0 représente un plan cartésien infini, sans unité sur ses axes. Voir <xref linkend="spatial_ref_sys"/>.

note: Tag: para
en: The geometry <emphasis role="bold">dimension</emphasis> is a property of geometry types. Point types have dimension 0, linear types have dimension 1, and polygonal types have dimension 2. Collections have the dimension of the maximum element dimension.
fr: La <emphasis role="bold">dimension</emphasis> d'une géométrie est une propriété des types géométriques. Les types Point ont une dimension 0, les types linéaires ont une dimension 1, et les types polygonaux ont une dimension 2. Les collections ont la dimension de leur élément de plus grande dimension.

note: Tag: para
en: A geometry value may be <emphasis role="bold">empty</emphasis>. Empty values contain no vertices (for atomic geometry types) or no elements (for collections).
fr: Une valeur géométrique peut être <emphasis role="bold">vide</emphasis>. Une valeur vide ne contient aucun vertex (pour les types de géométriques atomiques) ou aucun élément (pour les collections).

note: Tag: para
en: An important property of geometry values is their spatial <emphasis role="bold">extent</emphasis> or <emphasis role="bold">bounding box</emphasis>, which the OGC model calls <emphasis role="bold">envelope</emphasis>. This is the 2 or 3-dimensional box which encloses the coordinates of a geometry. It is an efficient way to represent a geometry's extent in coordinate space and to check whether two geometries interact.
fr: Une propriété important des valeurs géométriques est leur <emphasis role="bold">emprise</emphasis> spatiale (extent en anglais) ou leur <emphasis role="bold">boîte englobante</emphasis> (bounding box en anglais), que le modèle OGC nomme <emphasis role="bold">enveloppe</emphasis> (envelope). La boîte englobante est la boîte 2D ou 3D qui contient les coordonnées d'une géométrie. C'est une façon efficace de représenter l'emprise d'une géométrie dans un espace et de tester comment deux géométries interagissent.

note: Tag: para
en: The geometry model allows evaluating topological spatial relationships as described in <xref linkend="DE-9IM"/>. To support this the concepts of <emphasis role="bold">interior</emphasis>, <emphasis role="bold">boundary</emphasis> and <emphasis role="bold">exterior</emphasis> are defined for each geometry type. Geometries are topologically closed, so they always contain their boundary. The boundary is a geometry of dimension one less than that of the geometry itself.
fr: Le modèle de géométrie permet d'évaluer les relations topologiques, telles que décrites dans <xref linkend="DE-9IM"/>. Pour supporter cela, les concepts de <emphasis role="bold">intérieur</emphasis> (interior en anglais), <emphasis role="bold">frontière</emphasis> (boundary en anglais) et <emphasis role="bold">extérieur</emphasis> (exterior en anglais) sont définis pour tous les types de géométries. Les géométries sont topologiquement fermées, donc elle contiennent toujours leur frontière. La dimension de la géométrie de la frontière est la dimension de la géométrie moins un.

note: Tag: para
en: The OGC geometry model defines validity rules for each geometry type. These rules ensure that geometry values represents realistic situations (e.g. it is possible to specify a polygon with a hole lying outside the shell, but this makes no sense geometrically and is thus invalid). PostGIS also allows storing and manipulating invalid geometry values. This allows detecting and fixing them if needed. See <xref linkend="OGC_Validity"/>
fr: Le modèle de géométrie OGC définie des règles de validité pour chaque type géométrique. Ces règles permettent de s'assurer que les valeurs géométriques représentent des situations réalistes (e.g. il est possible de définir un polygone avec un trou à l'extérieur, mais cela n'a pas de sens au niveau géométrique, et est donc invalide). PostGIS permet de stocker et de manipuler des valeurs géométriques invalides, ceci permet de les détecter et de les corriger si besoin. Voir <xref linkend="OGC_Validity"/>

note: Tag: para
en: A Point is a 0-dimensional geometry that represents a single location in coordinate space.
fr: Un objet de type Point est une géométrie de dimension 0, qui représente un seul point dans l'espace.

note: Tag: para
en: A LineString is a 1-dimensional line formed by a contiguous sequence of line segments. Each line segment is defined by two points, with the end point of one segment forming the start point of the next segment. An OGC-valid LineString has either zero or two or more points, but PostGIS also allows single-point LineStrings. LineStrings may cross themselves (self-intersect). A LineString is <emphasis role="bold">closed</emphasis> if the start and end points are the same. A LineString is <emphasis role="bold">simple</emphasis> if it does not self-intersect.
fr: Le type LineString est une ligne, de dimension 1, formée par une séquence de segments linéaires contigus. Chaque segment est défini par deux points, l'extrémité d'un segment étant le point de départ du segment suivant. Un LineString valide au sens OGC a soit zéro, soit deux points ou plus, mais PostGIS permet d'avoir des LineStrings avec un seul point. LineStrings peuvent se croiser (auto-intersection). Un LineString peut être <emphasis role="bold">fermé</emphasis> si les points de début et fin sont les mêmes. Un LineString est dit <emphasis role="bold">simple</emphasis> s'il ne s'auto-intersecte pas.

note: Tag: para
en: A LinearRing is a LineString which is both closed and simple. The first and last points must be equal, and the line must not self-intersect.
fr: Le type LinearRing définit un LineString qui est à la fois fermé et simple. Autrement dit, le premier et dernier points doivent être égaux, et la ligne ne doit pas s'auto-intersecter.

note: Tag: para
en: A Polygon is a 2-dimensional planar region, delimited by an exterior boundary (the shell) and zero or more interior boundaries (holes). Each boundary is a <link linkend="LinearRing">LinearRing</link>.
fr: Un polygone, de type Polygon est une région d'un plan, de dimension 2, délimité par une frontière extérieure (la coquille, shell en anglais) et zéro, une ou plusieurs frontières intérieures (trous, holes en anglais). Chaque frontière est un <link linkend="LinearRing">LinearRing</link>.

note: Tag: para
en: A MultiPoint is a collection of Points.
fr: Le type MultiPoint est une collection de Points.

note: Tag: para
en: A MultiLineString is a collection of LineStrings. A MultiLineString is closed if each of its elements is closed.
fr: Le type MultiLineString est une collection de LineStrings. Un MultiLineString est fermé si tous ses éléments sont fermés.

note: Tag: para
en: A MultiPolygon is a collection of non-overlapping, non-adjacent Polygons. Polygons in the collection may touch only at a finite number of points.
fr: Un MultiPolygon est une collection de Polygons, non superposés et non adjacents. Les polygones de la collection peuvent se toucher, mais uniquement en un nombre fini de points.

note: Tag: para
en: A GeometryCollection is a heterogeneous (mixed) collection of geometries.
fr: Le type GeometryCollection représente une collection hétérogène de géométries (i.e. de types différents).

note: Tag: para
en: A PolyhedralSurface is a contiguous collection of patches or facets which share some edges. Each patch is a planar Polygon. If the Polygon coordinates have Z ordinates then the surface is 3-dimensional.
fr: Le type PolyhedralSurface modélise une surface polyédrique, sous la forme d'une collection de faces qui partagent des arêtes. Chaque face est un Polygon plan. Si les coordonnées du Polygon ont une dimension Z, alors la surface est de dimension 3.

note: Tag: para
en: A Triangle is a polygon defined by three distinct non-collinear vertices. Because a Triangle is a polygon it is specified by four coordinates, with the first and fourth being equal.
fr: Un Triangle est un polygone définit par trois sommets non colinéaires. Un Triangle étant un Polygon, et donc est fermé, il est définit par quatre coordonnées, la première et la dernière étant égales.

note: Tag: para
en: A TIN is a collection of non-overlapping <link linkend="Triangle">Triangle</link>s representing a <ulink url="https://en.wikipedia.org/wiki/Triangulated_irregular_network">Triangulated Irregular Network</ulink>.
fr: Un TIN est une collection de <link linkend="Triangle">Triangle</link>s non superposés, représentant un réseau irrégulier triangulé (<ulink url="https://en.wikipedia.org/wiki/Triangulated_irregular_network">Triangulated Irregular Network</ulink>).

note: Tag: title
en: SQL/MM Part 3 - Curves
fr: SQL/MM Part 3 - Courbes

note: Tag: para
en: The <ulink url="https://www.iso.org/obp/ui/#iso:std:iso-iec:13249:-3:ed-5:v1:en"><emphasis>ISO/IEC 13249-3 SQL Multimedia - Spatial</emphasis></ulink> standard (SQL/MM) extends the OGC SFA to define Geometry subtypes containing curves with circular arcs. The SQL/MM types support 3DM, 3DZ and 4D coordinates.
fr: La norme <ulink url="https://www.iso.org/obp/ui/#iso:std:iso-iec:13249:-3:ed-5:v1:en"><emphasis>ISO/IEC 13249-3 SQL Multimedia - Spatial</emphasis></ulink> (SQL/MM) étend l'OGC SFA pour définir des sous-types de géométrie contenant des courbes avec des arcs circulaires. Les types SQL/MM prennent en charge les coordonnées 3DM, 3DZ et 4D.

note: Tag: para
en: All floating point comparisons within the SQL-MM implementation are performed to a specified tolerance, currently 1E-8.
fr: Toutes les comparaisons en flottant dans l'implémentation de SQL-MM sont effectuées avec une tolérance spécifiée, actuellement 1E-8.

note: Tag: para
en: CircularString is the basic curve type, similar to a LineString in the linear world. A single arc segment is specified by three points: the start and end points (first and third) and some other point on the arc. To specify a closed circle the start and end points are the same and the middle point is the opposite point on the circle diameter (which is the center of the arc). In a sequence of arcs the end point of the previous arc is the start point of the next arc, just like the segments of a LineString. This means that a CircularString must have an odd number of points greater than 1.
fr: CircularString est le type de courbe de base, similaire à LineString dans le monde linéaire. Un segment d'arc unique est spécifié par trois points : les points de départ et d'arrivée (premier et troisième) et un autre point de l'arc. Pour spécifier un cercle fermé, les points de départ et d'arrivée sont les mêmes et le point central est le point opposé sur le diamètre du cercle (qui est le centre de l'arc). Dans une séquence d'arcs, le point final de l'arc précédent est le point de départ de l'arc suivant, tout comme les segments d'une LineString. Cela signifie qu'une CircularString doit avoir un nombre impair de points supérieur à 1.

note: Tag: para
en: A CompoundCurve is a single continuous curve that may contain both circular arc segments and linear segments. That means that in addition to having well-formed components, the end point of every component (except the last) must be coincident with the start point of the following component.
fr: Une CompoundCurve est une courbe continue unique qui peut contenir à la fois des segments d'arc de cercle et des segments linéaires. Cela signifie qu'en plus d'avoir des composantes bien formées, le point final de chaque composante (sauf la dernière) doit coïncider avec le point de départ de la composante suivante.

note: Tag: para
en: A CurvePolygon is like a polygon, with an outer ring and zero or more inner rings. The difference is that a ring can be a CircularString or CompoundCurve as well as a LineString.
fr: Un CurvePolygon est semblable à un polygone, avec un anneau extérieur et zéro ou plusieurs anneaux intérieurs. La différence est qu'un anneau peut être une CircularString ou une CompoundCurve ainsi qu'une LineString.

note: Tag: para
en: As of PostGIS 1.4 PostGIS supports compound curves in a curve polygon.
fr: Depuis PostGIS 1.4, PostGIS prend en charge les courbes composées dans un polygone de courbe.

note: Tag: para
en: Example: A CurvePolygon with the shell defined by a CompoundCurve containing a CircularString and a LineString, and a hole defined by a CircularString
fr: Exemple : Un PolygoneCourbe dont l'enveloppe est définie par une CompoundCurve contenant une CircularString et une LineString, et dont le trou est défini par une CircularString.

note: Tag: para
en: A MultiCurve is a collection of curves which can include LineStrings, CircularStrings or CompoundCurves.
fr: Une MultiCurve est un ensemble de courbes qui peuvent inclure des LineStrings, des CircularStrings ou des CompoundCurves.

note: Tag: para
en: A MultiSurface is a collection of surfaces, which can be (linear) Polygons or CurvePolygons.
fr: Une MultiSurface est un ensemble de surfaces, qui peuvent être des polygones (linéaires) ou des polygones courbes.

note: Tag: title
en: WKT and WKB
fr: WKT et WKB

note: Tag: para
en: The OGC SFA specification defines two formats for representing geometry values for external use: Well-Known Text (WKT) and Well-Known Binary (WKB). Both WKT and WKB include information about the type of the object and the coordinates which define it.
fr: La spécification OGC SFA définit deux formats pour représenter des valeurs géométriques : Well-Known Text (WKT) et Well-Known Binary (WKB). Ces deux formats incluent les informations sur le type d'objet et sur les coordonnées qui le définissent.

note: Tag: para
en: Well-Known Text (WKT) provides a standard textual representation of spatial data. Examples of WKT representations of spatial objects are:
fr: Well-Known Text (WKT) fournit un standard pour représenter de façon textuelle des données spatiales. Voici quelques exemples de représentations WKT :

note: Tag: para
en: Input and output of WKT is provided by the functions <xref linkend="ST_AsText"/> and <xref linkend="ST_GeomFromText"/>:
fr: Des méthodes d'entrée/sortie en WKT sont fournies via les fonctions <xref linkend="ST_AsText"/> et <xref linkend="ST_GeomFromText"/> :

note: Tag: para
en: For example, a statement to create and insert a spatial object from WKT and a SRID is:
fr: Par exemple, une requête pour créer et insérer une objet spatial sous forme de WKT et avec un SRID :

note: Tag: para
en: Well-Known Binary (WKB) provides a portable, full-precision representation of spatial data as binary data (arrays of bytes). Examples of the WKB representations of spatial objects are:
fr: Well-Known Binary (WKB) fournit un moyen portable et sans perte de précision pour représenter des données spatiales sous la forme de données binaires (tableau d'octets). Voici quelques exemples de représentations WKB :

note: Tag: para
en: WKT: POINT(1 1)
fr: WKT : POINT(1 1)

note: Tag: para
en: WKB: 0101000000000000000000F03F000000000000F03
fr: WKB : 0101000000000000000000F03F000000000000F03

note: Tag: para
en: WKT: LINESTRING (2 2, 9 9)
fr: WKT : LINESTRING (2 2, 9 9)

note: Tag: para
en: WKB: 0102000000020000000000000000000040000000000000004000000000000022400000000000002240
fr: WKB : 0102000000020000000000000000000040000000000000004000000000000022400000000000002240

note: Tag: para
en: Input and output of WKB is provided by the functions <xref linkend="ST_AsBinary"/> and <xref linkend="ST_GeomFromWKB"/>:
fr: Des méthodes d'entrée/sortie en WKB sont fournies via les fonctions <xref linkend="ST_AsBinary"/> et <xref linkend="ST_GeomFromWKB"/> :

note: Tag: para
en: For example, a statement to create and insert a spatial object from WKB is:
fr: Par exemple, une requête pour créer et insérer une objet spatial sous forme de WKB :

note: Tag: title
en: Geometry Data Type
fr: Type de données Geometry

note: Tag: para
en: PostGIS implements the OGC Simple Features model by defining a PostgreSQL data type called <varname>geometry</varname>. It represents all of the geometry subtypes by using an internal type code (see <xref linkend="GeometryType"/> and <xref linkend="ST_GeometryType"/>). This allows modelling spatial features as rows of tables defined with a column of type <varname>geometry</varname>.
fr: PostGIS implémente le modèle Simple Features de l'OGC via un type PostgreSQL <varname>geometry</varname>. Ce type représente tous les sous-types de géométries en utilisant un type interne (voir <xref linkend="GeometryType"/> et <xref linkend="ST_GeometryType"/>). Cela permet de modéliser les entités spatiales comme lignes de tables qui contiennent une colonne de type <varname>geometry</varname>.

note: Tag: para
en: The <varname>geometry</varname> data type is <emphasis>opaque</emphasis>, which means that all access is done via invoking functions on geometry values. Functions allow creating geometry objects, accessing or updating all internal fields, and compute new geometry values. PostGIS supports all the functions specified in the OGC <ulink url="https://portal.ogc.org/files/?artifact_id=25354"><emphasis>Simple feature access - Part 2: SQL option</emphasis></ulink> (SFS) specification, as well many others. See <xref linkend="reference"/> for the full list of functions.
fr: Le type <varname>geometry</varname> est <emphasis>opaque</emphasis>, ce qui veut dire que tout accès est fait en appelant des fonctions sur les valeurs géométriques. Des fonctions permettent la création d'objets géométriques, l'accès et la mise à jour des champs internes, ainsi que le calcul de nouvelles valeurs géométriques. PostGIS supporte toutes les fonctions spécifiées par la spécification OGC <ulink url="https://portal.ogc.org/files/?artifact_id=25354"><emphasis>Simple feature access - Part 2: SQL option</emphasis></ulink> (SFS), ainsi que de nombreuses autres. voir <xref linkend="reference"/> pour une liste complète des fonctions disponibles.

note: Tag: para
en: PostGIS follows the SFA standard by prefixing spatial functions with "ST_". This was intended to stand for "Spatial and Temporal", but the temporal part of the standard was never developed. Instead it can be interpreted as "Spatial Type".
fr: PostGIS respecte le standard SFA en préfixant toutes les fonctions spatiales par "ST_". Initialement, cela voulait dire "Spatial and Temporal" (Spatial et Temporel), mais l'aspect temporel du standard n'a pas été développé. À la place, ceci peut être interprété comme "Spatial Type" (Type Spatial).

note: Tag: para
en: The SFA standard specifies that spatial objects include a Spatial Reference System identifier (SRID). The SRID is required when creating spatial objects for insertion into the database (it may be defaulted to 0). See <xref linkend="ST_SRID"/> and <xref linkend="spatial_ref_sys"/>
fr: La standard SFA spécifie que les objets spatiaux doivent inclure un identifiant de système de coordonnées de référence (SRID). Ce SRID est obligatoire lors de la création d'objets spatiaux pour l'insertion dans la base de données (mais peut être défini par défaut à 0). Voir <xref linkend="ST_SRID"/> et <xref linkend="spatial_ref_sys"/>

note: Tag: para
en: To make querying geometry efficient PostGIS defines various kinds of spatial indexes, and spatial operators to use them. See <xref linkend="build-indexes"/> and <xref linkend="using-query-indexes"/> for details.
fr: Pour optimiser les requêtes sur les géométries, PostGIS définit plusieurs types d'index spatiaux, ainsi que des opérateurs spatiaux pour les utiliser. Voir <xref linkend="build-indexes"/> et <xref linkend="using-query-indexes"/> pour plus d'informations.

note: Tag: title
en: PostGIS EWKB and EWKT
fr: PostGIS EWKB et EWKT

note: Tag: para
en: OGC SFA specifications initially supported only 2D geometries, and the geometry SRID is not included in the input/output representations. The OGC SFA specification 1.2.1 (which aligns with the ISO 19125 standard) adds support for 3D (ZYZ) and measured (XYM and XYZM) coordinates, but still does not include the SRID value.
fr: Les spécifications OGC SFA ne supportaient initialement que les géométries 2D, et le SRID de la géométrie n'est pas inclut dans les représentations d'entrée/sortie. La spécification OGC SFA 1.2.1 (qui est alignée avec le standard ISO 19125) ajoute le support pour la 3D (ZYZ) et les mesures (XYM et XYZM), mais n'inclut toujours pas la valeur du SRID.

note: Tag: para
en: Because of these limitations PostGIS defined extended EWKB and EWKT formats. They provide 3D (XYZ and XYM) and 4D (XYZM) coordinate support and include SRID information. Including all geometry information allows PostGIS to use EWKB as the format of record (e.g. in DUMP files).
fr: À cause de ces limitations, PostGIS définit les formats étendus EWKB ((Extended Well-Known Binary) et EWKT (Extended Well-Known Text). Ils supportent la 3D (XYZ et XYM) et 4D (XYZM) et incluent l'information de SRID. Le format EWKB incluant toutes les informations de la géométrie, cela permet à PostGIS d'utiliser ce format pour les enregistrements (e.g. dans les fichiers DUMP).

note: Tag: para
en: EWKB and EWKT are used for the "canonical forms" of PostGIS data objects. For input, the canonical form for binary data is EWKB, and for text data either EWKB or EWKT is accepted. This allows geometry values to be created by casting a text value in either HEXEWKB or EWKT to a geometry value using <varname>::geometry</varname>. For output, the canonical form for binary is EWKB, and for text it is HEXEWKB (hex-encoded EWKB).
fr: EWKB et EWKT sont utilisés pour les "formes canoniques" des objets spatiaux de PostGIS. En tant qu'entrée, la forme canonique pour les données binaires est EWKB ; pour les données textuelles EWKB et EWKT sont tous deux acceptés. Cela permet de créer des valeurs géométriques en transtypant une valeur textuelle en HEXEWKB ou EWKT vers une valeur géométrique en utilisant <varname>::geometry</varname>. Pour la sortie, la forme canonique pour les données binaires est EWKB et HEXEWKB (hex-encoded EWKB) pour les données textuelles.

note: Tag: para
en: For example this statement creates a geometry by casting from an EWKT text value, and outputs it using the canonical form of HEXEWKB:
fr: Par exemple, cette requête créé une géométrie en transtypant depuis une chaîne de caractères contenant du EKWT, et retourne sa valeur sous sa forme canonique en HEXEWKB :

note: Tag: para
en: PostGIS EWKT output has a few differences to OGC WKT:
fr: La sortie PostGIS EWKT a quelques différences avec le OGC WKT :

note: Tag: para
en: For 3DZ geometries the Z qualifier is omitted:
fr: Pour les géométries 3DZ, le qualificatif Z est omis :

note: Tag: para
en: OGC: POINT Z (1 2 3)
fr: OGC : POINT Z (1 2 3)

note: Tag: para
en: EWKT: POINT (1 2 3)
fr: EWKT : POINT (1 2 3)

note: Tag: para
en: For 3DM geometries the M qualifier is included:
fr: Pour les géométries 3DM, le qualificatif M est inclus :

note: Tag: para
en: OGC: POINT M (1 2 3)
fr: OGC : POINT M (1 2 3)

note: Tag: para
en: EWKT: POINTM (1 2 3)
fr: EWKT : POINTM (1 2 3)

note: Tag: para
en: For 4D geometries the ZM qualifier is omitted:
fr: Pour les géométries 4D, le qualificatif ZM est omis :

note: Tag: para
en: OGC: POINT ZM (1 2 3 4)
fr: OGC : POINT ZM (1 2 3 4)

note: Tag: para
en: EWKT: POINT (1 2 3 4)
fr: EWKT : POINT (1 2 3 4)

note: Tag: para
en: EWKT avoids over-specifying dimensionality and the inconsistencies that can occur with the OGC/ISO format, such as:
fr: EWKT évite de sur-spécifier les dimensions et ainsi éviter les inconsistances possibles avec le format OGC/ISO, comme :

note: Tag: para
en: PostGIS extended formats are currently a superset of the OGC ones, so that every valid OGC WKB/WKT is also valid EWKB/EWKT. However, this might vary in the future, if the OGC extends a format in a way that conflicts with the PosGIS definition. Thus you SHOULD NOT rely on this compatibility!
fr: Les formats étendus PostGIS sont des sur-ensembles des formats OGC, donc les représentations valides WKB/WKT sont aussi des représentations EWKB/EWKT valides. Cependant, cela pourrait changer à l'avenir, si l'OGC définit un format qui rentrerait en conflit avec la définition de PosGIS. Vous ne devriez donc PAS vous appuyer sur cette compatibilité !

note: Tag: para
en: Examples of the EWKT text representation of spatial objects are:
fr: Voici quelques exemples de représentations d'objets spatiaux sous forme EWKT :

note: Tag: para
en: SRID=32632;POINT(0 0) -- XY with SRID
fr: SRID=32632;POINT(0 0) -- XY avec SRID

note: Tag: para
en: SRID=4326;MULTIPOINTM(0 0 0,1 2 1) -- XYM with SRID
fr: SRID=4326;MULTIPOINTM(0 0 0,1 2 1) -- XYM avec SRID

note: Tag: para
en: Input and output using these formats is available using the following functions:
fr: Des méthodes d'entrée/sortie sont fournies via les fonctions suivantes :

note: Tag: para
en: For example, a statement to create and insert a PostGIS spatial object using EWKT is:
fr: Par exemple, une requête pour créer et insérer une objet spatial sous forme de EWKT :

note: Tag: title
en: Geography Data Type
fr: Type de données Geography

note: Tag: para
en: The PostGIS <varname>geography</varname> data type provides native support for spatial features represented on "geographic" coordinates (sometimes called "geodetic" coordinates, or "lat/lon", or "lon/lat"). Geographic coordinates are spherical coordinates expressed in angular units (degrees).
fr: Le type de données PostGIS <varname>geography</varname> permet le support des entités spatiales utilisant un système de coordonnées géographique (parfois appelé géodésique, ou "latitude/longitude" ou "longitude/latitude"). Les coordonnées géographiques sont des coordonnées sphériques, exprimées en unités d'angle (degrés).

note: Tag: para
en: The basis for the PostGIS geometry data type is a plane. The shortest path between two points on the plane is a straight line. That means functions on geometries (areas, distances, lengths, intersections, etc) are calculated using straight line vectors and cartesian mathematics. This makes them simpler to implement and faster to execute, but also makes them inaccurate for data on the spheroidal surface of the earth.
fr: Le type geometry de PostGIS est lié à un plan. Ainsi, le chemin le plus court entre deux points sur un plan est la ligne droite. Les fonctions sur les types geometry (aires, distances, intersections, etc.) sont donc calculées en utilisant des lignes droites et les mathématiques cartésiennes. Cela permet des implémentations plus faciles et plus rapides à exécuter, mais cela devient imprécis lorsque la rotondité de la Terre entre en jeu.

note: Tag: para
en: The PostGIS geography data type is based on a spherical model. The shortest path between two points on the sphere is a great circle arc. Functions on geographies (areas, distances, lengths, intersections, etc) are calculated using arcs on the sphere. By taking the spheroidal shape of the world into account, the functions provide more accurate results.
fr: Le type PostGIS geography repose sur un modèle sphérique. Le chemin le plus court entre deux points sur une sphère est l'arc de cercle. Les fonctions sur les types geography (aires, distances, intersections, etc.) sont donc calculées en utilisant des arcs de cercle sur une sphère. En prenant en compte la rotondité de la Terre, ces fonctions permettent d'avoir une meilleure précision.

note: Tag: para
en: Because the underlying mathematics is more complicated, there are fewer functions defined for the geography type than for the geometry type. Over time, as new algorithms are added the capabilities of the geography type will expand. As a workaround one can convert back and forth between geometry and geography types.
fr: Les mathématiques utilisées pour les calculs étant plus compliquées, moins de fonctions sont définies pour le type geography que pour le type geometry. De nouveaux algorithmes sont ajoutés au fur et à mesure des versions de PostGIS, donc le support du type geography s'étend petit à petit. Si une fonction n'est pas disponible, il est toutefois possible de convertir un type geography en geometry puis vice-versa.

note: Tag: para
en: Like the geometry data type, geography data is associated with a spatial reference system via a spatial reference system identifier (SRID). Any geodetic (long/lat based) spatial reference system defined in the <varname>spatial_ref_sys</varname> table can be used. (Prior to PostGIS 2.2, the geography type supported only WGS 84 geodetic (SRID:4326)). You can add your own custom geodetic spatial reference system as described in <xref linkend="user-spatial-ref-sys"/>.
fr: Comme le type geometry, les données géographiques sont liées à un identifiant de système de coordonnées de référence (SRID). Tout système géodésique (reposant sur longitude/latitude) peut être utilisé, tant qu'il défini dans la table <varname>spatial_ref_sys</varname>. (Avant PostGIS 2.2, le type geography ne supportait que le SCR WGS 84 (SRID:4326)). Vous pouvez ajouter votre propre SCR géodésique, comme décrit dans <xref linkend="user-spatial-ref-sys"/>.

note: Tag: para
en: For all spatial reference systems the units returned by measurement functions (e.g. <xref linkend="ST_Distance"/>, <xref linkend="ST_Length"/>, <xref linkend="ST_Perimeter"/>, <xref linkend="ST_Area"/>) and for the distance argument of <xref linkend="ST_DWithin"/> are in meters.
fr: Pour tous les systèmes de coordonnées de référence, les unités des valeurs retournées par les fonctions de mesure (e.g. <xref linkend="ST_Distance"/>, <xref linkend="ST_Length"/>, <xref linkend="ST_Perimeter"/>, <xref linkend="ST_Area"/>) et le paramètre de distance de <xref linkend="ST_DWithin"/> sont en mètres.

note: Tag: title
en: Creating Geography Tables
fr: Création de tables géographiques

note: Tag: para
en: You can create a table to store geography data using the <ulink url="https://www.postgresql.org/docs/current/sql-createtable.html">CREATE TABLE</ulink> SQL statement with a column of type <varname>geography</varname>. The following example creates a table with a geography column storing 2D LineStrings in the WGS84 geodetic coordinate system (SRID 4326):
fr: Vous pouvez créer une table pour stocker des données géographiques en utilisant la requête SQL <ulink url="https://www.postgresql.org/docs/current/sql-createtable.html">CREATE TABLE</ulink>, avec une colonne de type <varname>geography</varname>. L'exemple suivant créé une table avec une colonne géographique pour stocker des lignes 2D dans un SCR géodésique WGS84 (SRID 4326) :

note: Tag: para
en: The geography type supports two optional type modifiers:
fr: Le type geography supporte deux modificateurs de type :

note: Tag: para
en: the spatial type modifier restricts the kind of shapes and dimensions allowed in the column. Values allowed for the spatial type are: POINT, LINESTRING, POLYGON, MULTIPOINT, MULTILINESTRING, MULTIPOLYGON, GEOMETRYCOLLECTION. The geography type does not support curves, TINS, or POLYHEDRALSURFACEs. The modifier supports coordinate dimensionality restrictions by adding suffixes: Z, M and ZM. For example, a modifier of 'LINESTRINGM' only allows linestrings with three dimensions, and treats the third dimension as a measure. Similarly, 'POINTZM' requires four dimensional (XYZM) data.
fr: le modificateur de type spatial restreint le type de formes et dimensions de la colonne. Les valeurs permises pour le type spatial sont : POINT, LINESTRING, POLYGON, MULTIPOINT, MULTILINESTRING, MULTIPOLYGON, GEOMETRYCOLLECTION. Le type geography ne supporte pas les CURVEs, TINS, ni POLYHEDRALSURFACEs. Le modificateur permet de restreindre la dimension, en ajoutant les suffixes : Z, M ou ZM. Par exemple, un modificateur 'LINESTRINGM' permet uniquement de stocker des LineStrings en 3D, et traite la troisième dimension comme une mesure. De façon similaire, 'POINTZM' limite aux données 4D (XYZM).

note: Tag: para
en: the SRID modifier restricts the spatial reference system SRID to a particular number. If omitted, the SRID defaults to 4326 (WGS84 geodetic), and all calculations are performed using WGS84.
fr: le modificateur SRID restreint à un SCR spécifique. Si omis, le SRID 4326 (WGS84 géodésique) est utilisé, et tous les calculs sont effectués en utilisant WGS84.

note: Tag: para
en: Examples of creating tables with geography columns:
fr: Exemples de création de tables utilisant des colonnes géographiques :

note: Tag: para
en: Create a table with 2D POINT geography with the default SRID 4326 (WGS84 long/lat):
fr: Création d'une table avec une géographie POINT 2D avec le SRID par défaut 4326 (WGS84 longitude/latitude) :

note: Tag: para
en: Create a table with 2D POINT geography in NAD83 longlat:
fr: Création d'une table avec une géographie POINT 2D dans le CRS NAD83 longlat :

note: Tag: para
en: Create a table with 3D (XYZ) POINTs and an explicit SRID of 4326:
fr: Création d'une table avec une géographie POINT 3D (XYZ) avec le SCR explicite 4326 :

note: Tag: para
en: Create a table with 2D LINESTRING geography with the default SRID 4326:
fr: Création d'une table avec une géographie LINESTRING 2D avec le SRID par défaut 4326 :

note: Tag: para
en: Create a table with 2D POLYGON geography with the SRID 4267 (NAD 1927 long lat):
fr: Création d'une table avec une géographie POLYGON 2D avec le SRC 4267 (NAD 1927 long lat) :

note: Tag: para
en: Geography fields are registered in the <varname>geography_columns</varname> system view. You can query the <varname>geography_columns</varname> view and see that the table is listed:
fr: Les colonnes géographiques sont enregistrées dans la vue système <varname>geography_columns</varname>. Vous pouvez effectuer un requête sur la vue <varname>geography_columns</varname> et vérifier que la table est bien listée :

note: Tag: para
en: Creating a spatial index works the same as for geometry columns. PostGIS will note that the column type is GEOGRAPHY and create an appropriate sphere-based index instead of the usual planar index used for GEOMETRY.
fr: La création d'index spatiaux sur les colonnes de type geography fonctionne de la même manière qu'avec le type geometry. PostGIS va prendre en compte que le type de la colonne est GEOGRAPHY et créer un index sphérique au lieu d'un index planaire utilisé pour GEOMETRY.

note: Tag: title
en: Using Geography Tables
fr: Utilisation des tables géographiques

note: Tag: para
en: You can insert data into geography tables in the same way as geometry. Geometry data will autocast to the geography type if it has SRID 4326. The <link linkend="EWKB_EWKT">EWKT and EWKB</link> formats can also be used to specify geography values.
fr: Vous pouvez insérer des données dans des tables géographiques de la même façon qu'avec les géométries. Les données géométriques seront automatiquement transtypées en type geography si le SRID des données est 4326. Les formats <link linkend="EWKB_EWKT">EWKT et EWKB</link> peuvent aussi être utilisés pour spécifier les valeurs géographiques.

note: Tag: para
en: Any geodetic (long/lat) spatial reference system listed in <varname>spatial_ref_sys</varname> table may be specified as a geography SRID. Non-geodetic coordinate systems raise an error if used.
fr: Tout CRS géodésique (longitude/latitude) disponible dans la table <varname>spatial_ref_sys</varname> peut être utilisé comme SRID d'une géographie. L'utilisation d'un CRS non géodésique provoquera une erreur.

note: Tag: para
en: Query and measurement functions use units of meters. So distance parameters should be expressed in meters, and return values should be expected in meters (or square meters for areas).
fr: Les requêtes et les fonctions de mesure utilisent le mètre comme unité. Les paramètres de distance doivent être exprimés en mètres, et les valeurs de retours seront également en mètres (ou en mètres carré pour les surfaces).

note: Tag: para
en: You can see the power of geography in action by calculating how close a plane flying a great circle route from Seattle to London (LINESTRING(-122.33 47.606, 0.0 51.5)) comes to Reykjavik (POINT(-21.96 64.15)) (<ulink url="http://gc.kls2.com/cgi-bin/gc?PATH=SEA-LHR">map the route</ulink>).
fr: Vous pouvez vérifier la puissance des géographies en calculant à quel point un avion s'approche de Reykjavik (POINT(-21.96 64.15)) lors d'un trajet en arc de cercle depuis Seattle à Londres (LINESTRING(-122.33 47.606, 0.0 51.5)) (<ulink url="http://gc.kls2.com/cgi-bin/gc?PATH=SEA-LHR">voir la route</ulink>).

note: Tag: para
en: The geography type calculates the true shortest distance of 122.235 km over the sphere between Reykjavik and the great circle flight path between Seattle and London.
fr: Le type geography donne la plus petite distance réelle de 122,235 km sur la sphère entre Reykjavik et l'arc de cercle entre Seattle et Londres.

note: Tag: para
en: The geometry type calculates a meaningless cartesian distance between Reykjavik and the straight line path from Seattle to London plotted on a flat map of the world. The nominal units of the result is "degrees", but the result doesn't correspond to any true angular difference between the points, so even calling them "degrees" is inaccurate.
fr: Le type geometry quant à lui calcule la distance cartésienne entre Reykjavik et la ligne droite entre Seattle et Londres, telle qu'elle serait tracée sur un plan. Cette distance n'a pas de sens réel, d'autant que l'unité du résultat est techniquement en degrés, mais que le résultat ne correspond à aucune différence angulaire entre les points, donc même considérer le résultat comme des degrés serait faux.

note: Tag: title
en: When to use the Geography data type
fr: Quand utiliser le type de données Geography

note: Tag: para
en: The geography data type allows you to store data in longitude/latitude coordinates, but at a cost: there are fewer functions defined on GEOGRAPHY than there are on GEOMETRY; those functions that are defined take more CPU time to execute.
fr: Le type de données geography permet de stocker des données en utilisant les coordonnées longitude/latitude, mais cela a un prix : il y a moins de fonctions disponibles sur le type GEOGRAPHY que sur le type GEOMETRY, et les fonctions disponibles prendront plus de temps CPU pour s'exécuter.

note: Tag: para
en: The data type you choose should be determined by the expected working area of the application you are building. Will your data span the globe or a large continental area, or is it local to a state, county or municipality?
fr: Le type de données à choisir devrait être déterminé par la zone de travail de l'application que vous construisez. Est-ce que vos données s'étendront sur l'ensemble du globe ou sur un continent, ou bien est-ce qu'elle seront locales, comme une région, un département ou une ville ?

note: Tag: para
en: If your data is contained in a small area, you might find that choosing an appropriate projection and using GEOMETRY is the best solution, in terms of performance and functionality available.
fr: Si vous données sont limitées à une petite zone, utiliser un SCR adéquat et le type GEOMETRY est la meilleure solution, à la fois en terme de performances que de fonctionnalités disponibles.

note: Tag: para
en: If your data is global or covers a continental region, you may find that GEOGRAPHY allows you to build a system without having to worry about projection details. You store your data in longitude/latitude, and use the functions that have been defined on GEOGRAPHY.
fr: Si vos données s'étendent sur le monde entier ou couvrent un continent, le type GEOGRAPHY peut vous permettre de construire votre application sans trop vous soucier des projections. Vous pouvez stocker vos données en utilisant les coordonnées longitude/latitude, et utiliser les fonctions définies sur les GEOGRAPHY.

note: Tag: para
en: If you don't understand projections, and you don't want to learn about them, and you're prepared to accept the limitations in functionality available in GEOGRAPHY, then it might be easier for you to use GEOGRAPHY than GEOMETRY. Simply load your data up as longitude/latitude and go from there.
fr: Si vous n'êtes pas à l'aise avec les projections, que vous ne souhaitez pas approfondir le sujet, et que vous êtes prêts à accepter les limitations sur les fonctionnalités offertes par GEOGRAPHY, alors ce peut être plus facile d'utiliser GEOGRAPHY au lieu de GEOMETRY. Chargez vos données en longitude/latitude et partez de là.

note: Tag: para
en: Refer to <xref linkend="PostGIS_TypeFunctionMatrix"/> for compare between what is supported for Geography vs. Geometry. For a brief listing and description of Geography functions, refer to <xref linkend="PostGIS_GeographyFunctions"/>
fr: Référez-vous à <xref linkend="PostGIS_TypeFunctionMatrix"/> pour comparer les supports Geography et Geometry. Pour avoir un résumé des fonctions géographiques disponibles, référez-vous à <xref linkend="PostGIS_GeographyFunctions"/>

note: Tag: title
en: Geography Advanced FAQ
fr: FAQ Geography avancée

note: Tag: para
en: Do you calculate on the sphere or the spheroid?
fr: Les calculs sont-ils faits sur la sphère ou sur la sphéroïde ?

note: Tag: para
en: By default, all distance and area calculations are done on the spheroid. You should find that the results of calculations in local areas match up will with local planar results in good local projections. Over larger areas, the spheroidal calculations will be more accurate than any calculation done on a projected plane.
fr: Par défaut, tous les calculs sur les distances et les surfaces sont effectués sur la sphéroïde. Les résultats des calculs sur les petites zones devraient coïncider avec les résultats des calculs planaire en utilisant les projections locales adéquates. Sur de plus grandes zones, les calculs sphéroïdaux seront plus précis que ceux effectués sur un plan projeté.

note: Tag: para
en: All the geography functions have the option of using a sphere calculation, by setting a final boolean parameter to 'FALSE'. This will somewhat speed up calculations, particularly for cases where the geometries are very simple.
fr: Toutes les fonctions géographiques ont une option pour calculer sur une sphère, en passant comme tout dernier paramètre booléen 'FALSE'. Ceci améliorera les performances des calculs, en particulier pour les géométries très simples.

note: Tag: para
en: What about the date-line and the poles?
fr: Qu'en est-il de la ligne de changement de date et des pôles ?

note: Tag: para
en: All the calculations have no conception of date-line or poles, the coordinates are spherical (longitude/latitude) so a shape that crosses the dateline is, from a calculation point of view, no different from any other shape.
fr: Tous les calculs omettent les concepts de ligne de changement de date et de pôles. Les coordonnées étant sphériques (longitude/latitude), une forme traversant la ligne de changement de date n'est, d'un point de vue calculs, pas différente de toute autre forme.

note: Tag: para
en: What is the longest arc you can process?
fr: Quel est l'arc le plus long que vous puissiez traiter ?

note: Tag: para
en: We use great circle arcs as the "interpolation line" between two points. That means any two points are actually joined up two ways, depending on which direction you travel along the great circle. All our code assumes that the points are joined by the *shorter* of the two paths along the great circle. As a consequence, shapes that have arcs of more than 180 degrees will not be correctly modelled.
fr: Nous utilisons les arcs de grand cercle comme "ligne d'interpolation" entre deux points. Cela signifie que deux points quelconques sont en fait reliés de deux manières différentes, selon la direction dans laquelle vous vous déplacez le long du grand cercle. Tout notre code suppose que les points sont reliés par le *plus court* des deux chemins le long du grand cercle. Par conséquent, les formes qui ont des arcs de plus de 180 degrés ne seront pas correctement modélisées.

note: Tag: para
en: Why is it so slow to calculate the area of Europe / Russia / insert big geographic region here ?
fr: Pourquoi est-il si lent de calculer la superficie de l'Europe / de la Russie / insérer une grande région géographique ici ?

note: Tag: para
en: Because the polygon is so darned huge! Big areas are bad for two reasons: their bounds are huge, so the index tends to pull the feature no matter what query you run; the number of vertices is huge, and tests (distance, containment) have to traverse the vertex list at least once and sometimes N times (with N being the number of vertices in the other candidate feature).
fr: Parce que le polygone est vraiment énorme ! Les grandes zones sont néfastes pour deux raisons : leurs limites sont énormes, de sorte que l'index a tendance à tirer l'élément, quelle que soit la requête que vous exécutez ; le nombre de sommets est énorme, et les tests (distance, confinement) doivent parcourir la liste des sommets au moins une fois et parfois N fois (N étant le nombre de sommets dans l'autre élément candidat).

note: Tag: para
en: As with GEOMETRY, we recommend that when you have very large polygons, but are doing queries in small areas, you "denormalize" your geometric data into smaller chunks so that the index can effectively subquery parts of the object and so queries don't have to pull out the whole object every time. Please consult <xref linkend="ST_Subdivide"/> function documentation. Just because you *can* store all of Europe in one polygon doesn't mean you *should*.
fr: Comme pour la GÉOMÉTRIE, nous vous recommandons, lorsque vous avez de très grands polygones, mais que vous effectuez des requêtes sur de petites zones, de "dénormaliser" vos données géométriques en morceaux plus petits, de sorte que l'index puisse effectivement interroger des parties de l'objet et que les requêtes n'aient pas à extraire l'objet entier à chaque fois. Veuillez consulter la documentation de la fonction <xref linkend="ST_Subdivide"/>. Ce n'est pas parce que vous *pouvez* stocker toute l'Europe dans un polygone que vous *devriez* le faire.

note: Tag: title
en: Geometry Validation
fr: Validation de la géométrie

note: Tag: para
en: PostGIS is compliant with the Open Geospatial Consortium’s (OGC) Simple Features specification. That standard defines the concepts of geometry being <emphasis>simple</emphasis> and <emphasis>valid</emphasis>. These definitions allow the Simple Features geometry model to represent spatial objects in a consistent and unambiguous way that supports efficient computation. (Note: the OGC SF and SQL/MM have the same definitions for simple and valid.)
fr: PostGIS est conforme à la spécification Simple Features de l'Open Geospatial Consortium (OGC). Cette norme définit les concepts de géométrie comme étant <emphasis>simple</emphasis> et <emphasis>valide</emphasis>. Ces définitions permettent au modèle géométrique Simple Features de représenter les objets spatiaux d'une manière cohérente et non ambiguë qui permet un calcul efficace. (Remarque : l'OGC SF et SQL/MM ont les mêmes définitions pour simple et valide).

note: Tag: title
en: Simple Geometry
fr: Géométrie simple

note: Tag: para
en: A <emphasis>simple</emphasis> geometry is one that has no anomalous geometric points, such as self intersection or self tangency.
fr: Une géométrie <emphasis>simple</emphasis> est une géométrie qui ne présente pas de points géométriques anormaux, tels qu'une intersection ou une tangence propre.

note: Tag: para
en: A <varname>POINT</varname> is inherently <emphasis>simple</emphasis> as a 0-dimensional geometry object.
fr: Un <varname>POINT</varname> est intrinsèquement <emphasis>simple</emphasis> en tant qu'objet géométrique à 0 dimension.

note: Tag: para
en: <varname>MULTIPOINT</varname>s are <emphasis>simple</emphasis> if no two coordinates (<varname>POINT</varname>s) are equal (have identical coordinate values).
fr: Les <varname>MULTIPOINT</varname> sont <emphasis>simples</emphasis> si deux coordonnées (<varname>POINT</varname>s) ne sont pas égales (ont des valeurs de coordonnées identiques).

note: Tag: para
en: A <varname>LINESTRING</varname> is <emphasis>simple</emphasis> if it does not pass through the same point twice, except for the endpoints. If the endpoints of a simple LineString are identical it is called <emphasis>closed</emphasis> and referred to as a Linear Ring.
fr: Une <varname>LINESTRING</varname> est <emphasis>simple</emphasis> si elle ne passe pas deux fois par le même point, à l'exception des extrémités. Si les extrémités d'une simple LineString sont identiques, elle est dite <emphasis>fermée</emphasis> et appelée anneau linéaire.

note: Tag: emphasis
en: <emphasis role="bold">(a)</emphasis> and <emphasis role="bold">(c)</emphasis> are simple <varname>LINESTRING</varname>s. <emphasis role="bold">(b)</emphasis> and <emphasis role="bold">(d)</emphasis> are not simple. <emphasis role="bold">(c)</emphasis> is a closed Linear Ring.
fr: <emphasis role="bold">(a)</emphasis> et <emphasis role="bold">(c)</emphasis> sont des <varname>LINESTRING</varname> simples. <emphasis role="bold">(b)</emphasis> et <emphasis role="bold">(d)</emphasis> ne sont pas simples. <emphasis role="bold">(c)</emphasis> est un anneau linéaire fermé.

note: Tag: para
en: A <varname>MULTILINESTRING</varname> is <emphasis>simple</emphasis> only if all of its elements are simple and the only intersection between any two elements occurs at points that are on the boundaries of both elements.
fr: Un <varname>MULTILINESTRING</varname> est <emphasis>simple</emphasis> uniquement si tous ses éléments sont simples et si la seule intersection entre deux éléments quelconques se produit en des points situés sur les limites des deux éléments.

note: Tag: emphasis
en: <emphasis role="bold">(e)</emphasis> and <emphasis role="bold">(f)</emphasis> are simple <varname>MULTILINESTRING</varname>s. <emphasis role="bold">(g)</emphasis> is not simple.
fr: <emphasis role="bold">(e)</emphasis> et <emphasis role="bold">(f)</emphasis> sont de simples <varname>MULTILINESTRING</varname>s. <emphasis role="bold">(g)</emphasis> n'est pas simple.

note: Tag: para
en: <varname>POLYGON</varname>s are formed from linear rings, so valid polygonal geometry is always <emphasis>simple</emphasis>.
fr: Les <varname>POLYGON</varname> sont formés à partir d'anneaux linéaires, de sorte que la géométrie polygonale valide est toujours <emphasis>simple</emphasis>.

note: Tag: para
en: To test if a geometry is simple use the <xref linkend="ST_IsSimple"/> function:
fr: Pour tester si une géométrie est simple, utilisez la fonction <xref linkend="ST_IsSimple"/> :

note: Tag: para
en: Generally, PostGIS functions do not require geometric arguments to be simple. Simplicity is primarily used as a basis for defining geometric validity. It is also a requirement for some kinds of spatial data models (for example, linear networks often disallow lines that cross). Multipoint and linear geometry can be made simple using <xref linkend="ST_UnaryUnion"/>.
fr: En général, les fonctions PostGIS n'exigent pas que les arguments géométriques soient simples. La simplicité est principalement utilisée comme base pour définir la validité géométrique. C'est également une exigence pour certains types de modèles de données spatiales (par exemple, les réseaux linéaires interdisent souvent les lignes qui se croisent). La géométrie multipoint et linéaire peut être rendue simple en utilisant <xref linkend="ST_UnaryUnion"/>.

note: Tag: title
en: Valid Geometry
fr: Géométrie valide

note: Tag: para
en: Geometry validity primarily applies to 2-dimensional geometries (<varname>POLYGON</varname>s and <varname>MULTIPOLYGON</varname>s) . Validity is defined by rules that allow polygonal geometry to model planar areas unambiguously.
fr: La validité géométrique s'applique principalement aux géométries bidimensionnelles (<varname>POLYGON</varname>s et <varname>MULTIPOLYGON</varname>s). La validité est définie par des règles qui permettent à la géométrie polygonale de modéliser des zones planes sans ambiguïté.

note: Tag: para
en: A <varname>POLYGON</varname> is <emphasis>valid</emphasis> if:
fr: Un <varname>POLYGON</varname> est <emphasis>valide</emphasis> si :

note: Tag: para
en: the polygon boundary rings (the exterior shell ring and interior hole rings) are <emphasis>simple</emphasis> (do not cross or self-touch). Because of this a polygon cannnot have cut lines, spikes or loops. This implies that polygon holes must be represented as interior rings, rather than by the exterior ring self-touching (a so-called "inverted hole").
fr: les anneaux de délimitation du polygone (l'anneau extérieur de la coquille et les anneaux intérieurs des trous) sont <emphasis>simples</emphasis> (ils ne se croisent pas et ne se touchent pas). Pour cette raison, un polygone ne peut pas avoir de lignes de coupe, de pointes ou de boucles. Cela implique que les trous des polygones doivent être représentés par des anneaux intérieurs, plutôt que par l'anneau extérieur qui se touche (ce qu'on appelle un "trou inversé").

note: Tag: para
en: boundary rings do not cross
fr: les anneaux de délimitation ne se croisent pas

note: Tag: para
en: boundary rings may touch at points but only as a tangent (i.e. not in a line)
fr: Les anneaux de délimitation peuvent se toucher en certains points, mais uniquement sous la forme d'une tangente (c'est-à-dire pas sous la forme d'une ligne).

note: Tag: para
en: interior rings are contained in the exterior ring
fr: les anneaux intérieurs sont contenus dans l'anneau extérieur

note: Tag: para
en: the polygon interior is simply connected (i.e. the rings must not touch in a way that splits the polygon into more than one part)
fr: l'intérieur du polygone est simplement connecté (c'est-à-dire que les anneaux ne doivent pas se toucher d'une manière qui divise le polygone en plus d'une partie)

note: Tag: emphasis
en: <emphasis role="bold">(h)</emphasis> and <emphasis role="bold">(i)</emphasis> are valid <varname>POLYGON</varname>s. <emphasis role="bold">(j-m)</emphasis> are invalid. <emphasis role="bold">(j)</emphasis> can be represented as a valid <varname>MULTIPOLYGON</varname>.
fr: <emphasis role="bold">(h)</emphasis> et <emphasis role="bold">(i)</emphasis> sont des <varname>POLYGON</varname> valides. <emphasis role="bold">(j-m)</emphasis> ne sont pas valides. <emphasis role="bold">(j)</emphasis> peut être représenté comme un <varname>MULTIPOLYGON</varname> valide.

note: Tag: para
en: A <varname>MULTIPOLYGON</varname> is <emphasis>valid</emphasis> if:
fr: Un <varname>MULTIPOLYGON</varname> est <emphasis>valide</emphasis> si :

note: Tag: para
en: its element <varname>POLYGON</varname>s are valid
fr: ses éléments <varname>POLYGON</varname> sont valides

note: Tag: para
en: elements do not overlap (i.e. their interiors must not intersect)
fr: les éléments ne se chevauchent pas (c'est-à-dire que leurs intérieurs ne doivent pas se croiser)

note: Tag: para
en: elements touch only at points (i.e. not along a line)
fr: les éléments ne se touchent que par des points (c'est-à-dire pas le long d'une ligne)

note: Tag: emphasis
en: <emphasis role="bold">(n)</emphasis> is a valid <varname>MULTIPOLYGON</varname>. <emphasis role="bold">(o)</emphasis> and <emphasis role="bold">(p)</emphasis> are invalid.
fr: <emphasis role="bold">(n)</emphasis> est un <varname>MULTIPOLYGON</varname> valide. <emphasis role="bold">(o)</emphasis> et <emphasis role="bold">(p)</emphasis> ne sont pas valides.

note: Tag: para
en: These rules mean that valid polygonal geometry is also <emphasis>simple</emphasis>.
fr: Ces règles signifient que la géométrie polygonale valide est également <emphasis>simple</emphasis>.

note: Tag: para
en: For linear geometry the only validity rule is that <varname>LINESTRING</varname>s must have at least two points and have non-zero length (or equivalently, have at least two distinct points.) Note that non-simple (self-intersecting) lines are valid.
fr: Pour la géométrie linéaire, la seule règle de validité est que les <varname>LINESTRING</varname> doivent avoir au moins deux points et une longueur non nulle (ou, de façon équivalente, au moins deux points distincts).

note: Tag: para
en: <varname>POINT</varname> and <varname>MULTIPOINT</varname> geometries have no validity rules.
fr: Les géométries <varname>POINT</varname> et <varname>MULTIPOINT</varname> n'ont pas de règles de validité.

note: Tag: title
en: Managing Validity
fr: Gestion de la validité

note: Tag: para
en: PostGIS allows creating and storing both valid and invalid Geometry. This allows invalid geometry to be detected and flagged or fixed. There are also situations where the OGC validity rules are stricter than desired (examples of this are zero-length linestrings and polygons with inverted holes.)
fr: PostGIS permet de créer et de stocker des géométries valides et non valides. Cela permet de détecter les géométries non valides et de les signaler ou de les corriger. Il existe également des situations où les règles de validité de l'OGC sont plus strictes que souhaité (par exemple, les lignes de longueur nulle et les polygones avec des trous inversés).

note: Tag: para
en: Many of the functions provided by PostGIS rely on the assumption that geometry arguments are valid. For example, it does not make sense to calculate the area of a polygon that has a hole defined outside of the polygon, or to construct a polygon from a non-simple boundary line. Assuming valid geometric inputs allows functions to operate more efficiently, since they do not need to check for topological correctness. (Notable exceptions are that zero-length lines and polygons with inversions are generally handled correctly.) Also, most PostGIS functions produce valid geometry output if the inputs are valid. This allows PostGIS functions to be chained together safely.
fr: De nombreuses fonctions fournies par PostGIS reposent sur l'hypothèse que les arguments géométriques sont valides. Par exemple, il n'est pas logique de calculer la surface d'un polygone dont le trou est défini à l'extérieur du polygone, ou de construire un polygone à partir d'une ligne de démarcation non simple. Le fait de supposer que les entrées géométriques sont valides permet aux fonctions de fonctionner plus efficacement, puisqu'elles n'ont pas besoin de vérifier l'exactitude topologique. (Les exceptions notables sont que les lignes de longueur nulle et les polygones avec des inversions sont généralement traités correctement). En outre, la plupart des fonctions PostGIS produisent une géométrie valide si les données d'entrée sont valides. Cela permet d'enchaîner les fonctions PostGIS en toute sécurité.

note: Tag: para
en: If you encounter unexpected error messages when calling PostGIS functions (such as "GEOS Intersection() threw an error!"), you should first confirm that the function arguments are valid. If they are not, then consider using one of the techniques below to ensure the data you are processing is valid.
fr: Si vous rencontrez des messages d'erreur inattendus lors de l'appel de fonctions PostGIS (tels que "GEOS Intersection() threw an error !"), vous devez d'abord vous assurer que les arguments de la fonction sont valides. Si ce n'est pas le cas, envisagez d'utiliser l'une des techniques ci-dessous pour vous assurer que les données que vous traitez sont valides.

note: Tag: para
en: If a function reports an error with valid inputs, then you may have found an error in either PostGIS or one of the libraries it uses, and you should report this to the PostGIS project. The same is true if a PostGIS function returns an invalid geometry for valid input.
fr: Si une fonction signale une erreur avec des entrées valides, il se peut que vous ayez trouvé une erreur dans PostGIS ou dans l'une des bibliothèques qu'il utilise, et vous devez le signaler au projet PostGIS. Il en va de même si une fonction PostGIS renvoie une géométrie non valide pour des données d'entrée valides.

note: Tag: para
en: To test if a geometry is valid use the <xref linkend="ST_IsValid"/> function:
fr: Pour vérifier si une géométrie est valide, utilisez la fonction <xref linkend="ST_IsValid"/> :

note: Tag: para
en: Information about the nature and location of an geometry invalidity are provided by the <xref linkend="ST_IsValidDetail"/> function:
fr: Les informations relatives à la nature et à la localisation d'une invalidité géométrique sont fournies par la fonction <xref linkend="ST_IsValidDetail"/> :

note: Tag: para
en: In some situations it is desirable to correct invalid geometry automatically. Use the <xref linkend="ST_MakeValid"/> function to do this. (<code>ST_MakeValid</code> is a case of a spatial function that <emphasis>does</emphasis> allow invalid input!)
fr: Dans certaines situations, il est souhaitable de corriger automatiquement la géométrie non valide. Utilisez la fonction <xref linkend="ST_MakeValid"/> pour ce faire. (<code>ST_MakeValid</code> est un exemple de fonction spatiale qui <emphasis>doit</emphasis> permettre une entrée non valide).

note: Tag: para
en: By default, PostGIS does not check for validity when loading geometry, because validity testing can take a lot of CPU time for complex geometries. If you do not trust your data sources, you can enforce a validity check on your tables by adding a check constraint:
fr: Par défaut, PostGIS ne vérifie pas la validité lors du chargement de la géométrie, car les tests de validité peuvent prendre beaucoup de temps CPU pour les géométries complexes. Si vous ne faites pas confiance à vos sources de données, vous pouvez imposer un contrôle de validité à vos tables en ajoutant une contrainte de contrôle :

note: Tag: title
en: Spatial Reference Systems
fr: Systèmes de référence spatiale

note: Tag: para
en: A <ulink url="https://en.wikipedia.org/wiki/Spatial_reference_system">Spatial Reference System</ulink> (SRS) (also called a Coordinate Reference System (CRS)) defines how geometry is referenced to locations on the Earth's surface. There are three types of SRS:
fr: Un <ulink url="https://en.wikipedia.org/wiki/Spatial_reference_system">système de référence spatiale</ulink> (SRS) (également appelé système de référence des coordonnées (SRC)) définit la manière dont la géométrie est référencée par rapport à des emplacements sur la surface de la Terre. Il existe trois types de SRS :

note: Tag: para
en: A <emphasis role="bold">geodetic</emphasis> SRS uses angular coordinates (longitude and latitude) which map directly to the surface of the earth.
fr: Un SRS <emphasis role="bold">géodésique</emphasis> utilise des coordonnées angulaires (longitude et latitude) qui correspondent directement à la surface de la terre.

note: Tag: para
en: A <emphasis role="bold">projected</emphasis> SRS uses a mathematical projection transformation to "flatten" the surface of the spheroidal earth onto a plane. It assigns location coordinates in a way that allows direct measurement of quantities such as distance, area, and angle. The coordinate system is Cartesian, which means it has a defined origin point and two perpendicular axes (usually oriented North and East). Each projected SRS uses a stated length unit (usually metres or feet). A projected SRS may be limited in its area of applicability to avoid distortion and fit within the defined coordinate bounds.
fr: Un SRS <emphasis role="bold">projeté</emphasis> utilise une transformation mathématique de projection pour "aplatir" la surface de la terre sphéroïdale sur un plan. Il attribue des coordonnées de localisation d'une manière qui permet de mesurer directement des quantités telles que la distance, la surface et l'angle. Le système de coordonnées est cartésien, ce qui signifie qu'il a un point d'origine défini et deux axes perpendiculaires (généralement orientés vers le nord et l'est). Chaque SRS projeté utilise une unité de longueur définie (généralement des mètres ou des pieds). Un SRS projeté peut être limité dans sa zone d'applicabilité afin d'éviter toute distorsion et de s'inscrire dans les limites des coordonnées définies.

note: Tag: para
en: A <emphasis role="bold">local</emphasis> SRS is a Cartesian coordinate system which is not referenced to the earth's surface. In PostGIS this is specified by a SRID value of 0.
fr: Un SRS <emphasis role="bold">local</emphasis> est un système de coordonnées cartésiennes qui n'est pas référencé à la surface de la terre. Dans PostGIS, ce système est spécifié par une valeur SRID de 0.

note: Tag: para
en: There are many different spatial reference systems in use. Common SRSes are standardized in the European Petroleum Survey Group <ulink url="http://www.epsg.org/">EPSG database</ulink>. For convenience PostGIS (and many other spatial systems) refers to SRS definitions using an integer identifier called a SRID.
fr: Il existe de nombreux systèmes de référence spatiale différents. Les SRS courants sont normalisés dans la base de données de l'European Petroleum Survey Group <ulink url="http://www.epsg.org/">EPSG database</ulink>. Par commodité, PostGIS (et de nombreux autres systèmes spatiaux) se réfère aux définitions des SRS à l'aide d'un identifiant entier appelé SRID.

note: Tag: para
en: A geometry is associated with a Spatial Reference System by its SRID value, which is accessed by <xref linkend="ST_SRID"/>. The SRID for a geometry can be assigned using <xref linkend="ST_SetSRID"/>. Some geometry constructor functions allow supplying a SRID (such as <xref linkend="ST_Point"/> and <xref linkend="ST_MakeEnvelope"/>). The <link linkend="EWKB_EWKT">EWKT</link> format supports SRIDs with the <code>SRID=n;</code> prefix.
fr: Une géométrie est associée à un système de référence spatiale par sa valeur SRID, à laquelle on accède par <xref linkend="ST_SRID"/>. Le SRID d'une géométrie peut être assigné en utilisant <xref linkend="ST_SetSRID"/>. Certaines fonctions de construction de géométrie permettent de fournir un SRID (telles que <xref linkend="ST_Point"/> et <xref linkend="ST_MakeEnvelope"/>). Le format <link linkend="EWKB_EWKT">EWKT</link> prend en charge les SRID avec le préfixe <code>SRID=n;</code>.

note: Tag: para
en: Spatial functions processing pairs of geometries (such as <link linkend="Overlay_Functions">overlay</link> and <link linkend="Spatial_Relationships">relationship</link> functions) require that the input geometries are in the same spatial reference system (have the same SRID). Geometry data can be transformed into a different spatial reference system using <xref linkend="ST_Transform"/> and <xref linkend="ST_TransformPipeline"/>. Geometry returned from functions has the same SRS as the input geometries.
fr: Les fonctions spatiales qui traitent des paires de géométries (telles que les fonctions <link linkend="Overlay_Functions">overlay</link> et <link linkend="Spatial_Relationships">relationship</link>) exigent que les géométries d'entrée soient dans le même système de référence spatiale (qu'elles aient le même SRID). Les données géométriques peuvent être transformées dans un système de référence spatiale différent en utilisant <xref linkend="ST_Transform"/> et <xref linkend="ST_TransformPipeline"/>. Les géométries renvoyées par les fonctions ont le même SRS que les géométries d'entrée.

note: Tag: title
en: SPATIAL_REF_SYS Table
fr: Table SPATIAL_REF_SYS

note: Tag: para
en: The <varname>SPATIAL_REF_SYS</varname> table used by PostGIS is an OGC-compliant database table that defines the available spatial reference systems. It holds the numeric SRIDs and textual descriptions of the coordinate systems.
fr: La table <varname>SPATIAL_REF_SYS</varname> utilisée par PostGIS est une table de base de données conforme à l'OGC qui définit les systèmes de référence spatiale disponibles. Elle contient les SRID numériques et les descriptions textuelles des systèmes de coordonnées.

note: Tag: para
en: The <varname>spatial_ref_sys</varname> table definition is:
fr: La définition de la table <varname>spatial_ref_sys</varname> est la suivante :

note: Tag: para
en: The columns are:
fr: Les colonnes sont :

note: Tag: para
en: An integer code that uniquely identifies the <ulink url="http://en.wikipedia.org/wiki/SRID">Spatial Reference System</ulink> (SRS) within the database.
fr: Un code entier qui identifie de manière unique le <ulink url="http://en.wikipedia.org/wiki/SRID">Système de référence spatiale</ulink> (SRS) dans la base de données.

note: Tag: para
en: The name of the standard or standards body that is being cited for this reference system. For example, "EPSG" is a valid <varname>auth_name</varname>.
fr: Le nom de la norme ou de l'organisme de normalisation qui est cité pour ce système de référence. Par exemple, "EPSG" est un <varname>auth_name</varname> valide.

note: Tag: para
en: The ID of the Spatial Reference System as defined by the Authority cited in the <varname>auth_name</varname>. In the case of EPSG, this is the EPSG code.
fr: L'ID du système de référence spatiale tel que défini par l'autorité citée dans le <varname>auth_name</varname>. Dans le cas de l'EPSG, il s'agit du code EPSG.

note: Tag: para
en: The Well-Known Text representation of the Spatial Reference System. An example of a WKT SRS representation is:
fr: Représentation Well-Known Text du système de référence spatiale. Un exemple de représentation WKT du SRS est le suivant :

note: Tag: para
en: For a discussion of SRS WKT, see the OGC standard <ulink url="http://docs.opengeospatial.org/is/12-063r5/12-063r5.html">Well-known text representation of coordinate reference systems</ulink>.
fr: Pour une discussion sur le SRS WKT, voir la norme OGC <ulink url="http://docs.opengeospatial.org/is/12-063r5/12-063r5.html">Well-known text representation of coordinate reference systems</ulink>.

note: Tag: para
en: PostGIS uses the PROJ library to provide coordinate transformation capabilities. The <varname>proj4text</varname> column contains the PROJ coordinate definition string for a particular SRID. For example:
fr: PostGIS utilise la bibliothèque PROJ pour fournir des capacités de transformation de coordonnées. La colonne <varname>proj4text</varname> contient la chaîne de caractères de définition des coordonnées PROJ pour un SRID particulier. Par exemple :

note: Tag: para
en: For more information see the <ulink url="https://proj.org/">PROJ web site</ulink>. The <filename>spatial_ref_sys.sql</filename> file contains both <varname>srtext</varname> and <varname>proj4text</varname> definitions for all EPSG projections.
fr: Pour plus d'informations, consultez le <ulink url="https://proj.org/">site web de PROJ</ulink>. Le fichier <filename>spatial_ref_sys.sql</filename> contient les définitions <varname>srtext</varname> et <varname>proj4text</varname> pour toutes les projections EPSG.

note: Tag: para
en: When retrieving spatial reference system definitions for use in transformations, PostGIS uses fhe following strategy:
fr: Lors de la récupération des définitions des systèmes de référence spatiale pour les utiliser dans les transformations, PostGIS utilise la stratégie suivante :

note: Tag: para
en: If <varname>auth_name</varname> and <varname>auth_srid</varname> are present (non-NULL) use the PROJ SRS based on those entries (if one exists).
fr: Si <varname>auth_name</varname> et <varname>auth_srid</varname> sont présents (non NULL), utiliser le PROJ SRS basé sur ces entrées (si au moins un existe).

note: Tag: para
en: If <varname>srtext</varname> is present create a SRS using it, if possible.
fr: Si <varname>srtext</varname> est présent, créez un SRS en l'utilisant, si possible.

note: Tag: para
en: If <varname>proj4text</varname> is present create a SRS using it, if possible.
fr: Si <varname>proj4text</varname> est présent, créez un SRS en l'utilisant, si possible.

note: Tag: title
en: User-Defined Spatial Reference Systems
fr: Systèmes de référence spatiale définis par l'utilisateur

note: Tag: para
en: The PostGIS <varname>spatial_ref_sys</varname> table contains over 3000 of the most common spatial reference system definitions that are handled by the <ulink url="https://proj.org">PROJ</ulink> projection library. But there are many coordinate systems that it does not contain. You can add SRS definitions to the table if you have the required information about the spatial reference system. Or, you can define your own custom spatial reference system if you are familiar with PROJ constructs. Keep in mind that most spatial reference systems are regional and have no meaning when used outside of the bounds they were intended for.
fr: La table PostGIS <varname>spatial_ref_sys</varname> contient plus de 3000 définitions des systèmes de référence spatiale les plus courants qui sont gérés par la bibliothèque de projection <ulink url="https://proj.org">PROJ</ulink>. Mais il existe de nombreux systèmes de coordonnées qu'elle ne contient pas. Vous pouvez ajouter des définitions de SRS à la table si vous disposez des informations requises sur le système de référence spatiale. Vous pouvez également définir votre propre système de référence spatiale personnalisé si vous êtes familiarisé avec les constructions PROJ. Gardez à l'esprit que la plupart des systèmes de référence spatiale sont régionaux et n'ont aucune signification lorsqu'ils sont utilisés en dehors des limites pour lesquelles ils ont été conçus.

note: Tag: para
en: A resource for finding spatial reference systems not defined in the core set is <ulink url="http://spatialreference.org/">http://spatialreference.org/</ulink>
fr: Une ressource permettant de trouver des systèmes de référence spatiale non définis dans le jeu de base est <ulink url="http://spatialreference.org/">http://spatialreference.org/</ulink>

note: Tag: para
en: Some commonly used spatial reference systems are: <ulink url="http://spatialreference.org/ref/epsg/4326/">4326 - WGS 84 Long Lat</ulink>, <ulink url="http://spatialreference.org/ref/epsg/4269/">4269 - NAD 83 Long Lat</ulink>, <ulink url="http://spatialreference.org/ref/epsg/3395/">3395 - WGS 84 World Mercator</ulink>, <ulink url="http://spatialreference.org/ref/epsg/2163/">2163 - US National Atlas Equal Area</ulink>, and the 60 WGS84 UTM zones. UTM zones are one of the most ideal for measurement, but only cover 6-degree regions. (To determine which UTM zone to use for your area of interest, see the <ulink url="http://trac.osgeo.org/postgis/wiki/UsersWikiplpgsqlfunctionsDistance">utmzone PostGIS plpgsql helper function</ulink>.)
fr: Les systèmes de référence spatiale les plus couramment utilisés sont les suivants : <ulink url="http://spatialreference.org/ref/epsg/4326/">4326 - WGS 84 Long Lat</ulink>, <ulink url="http://spatialreference.org/ref/epsg/4269/">4269 - NAD 83 Long Lat</ulink>, <ulink url="http://spatialreference.org/ref/epsg/3395/">3395 - WGS 84 World Mercator</ulink>, <ulink url="http://spatialreference.org/ref/epsg/2163/">2163 - US National Atlas Equal Area</ulink>, et les 60 zones UTM WGS84. Les zones UTM sont parmi les plus idéales pour les mesures, mais elles ne couvrent que des régions de 6 degrés. (Pour déterminer la zone UTM à utiliser pour votre zone d'intérêt, voir la <ulink url="http://trac.osgeo.org/postgis/wiki/UsersWikiplpgsqlfunctionsDistance">utmzone PostGIS plpgsql helper function</ulink>.)

note: Tag: para
en: US states use State Plane spatial reference systems (meter or feet based) - usually one or 2 exists per state. Most of the meter-based ones are in the core set, but many of the feet-based ones or ESRI-created ones will need to be copied from <ulink url="http://spatialreference.org">spatialreference.org</ulink>.
fr: Les États américains utilisent des systèmes de référence spatiale State Plane (basés sur le mètre ou le pied) - il en existe généralement un ou deux par État. La plupart des systèmes basés sur le mètre se trouvent dans le jeu de base, mais de nombreux systèmes basés sur le pied ou créés par ESRI devront être copiés à partir de <ulink url="http://spatialreference.org">spatialreference.org</ulink>.

note: Tag: para
en: You can even define non-Earth-based coordinate systems, such as <ulink url="http://spatialreference.org/ref/iau2000/mars-2000/">Mars 2000</ulink> This Mars coordinate system is non-planar (it's in degrees spheroidal), but you can use it with the <varname>geography</varname> type to obtain length and proximity measurements in meters instead of degrees.
fr: Vous pouvez même définir des systèmes de coordonnées non terrestres, tels que <ulink url="http://spatialreference.org/ref/iau2000/mars-2000/">Mars 2000</ulink> Ce système de coordonnées martien n'est pas planaire (il est en degrés sphéroïdaux), mais vous pouvez l'utiliser avec le type <varname>géographie</varname> pour obtenir des mesures de longueur et de proximité en mètres au lieu de degrés.

note: Tag: para
en: Here is an example of loading a custom coordinate system using an unassigned SRID and the PROJ definition for a US-centric Lambert Conformal projection:
fr: Voici un exemple de chargement d'un système de coordonnées personnalisé à l'aide d'un SRID non attribué et de la définition PROJ pour une projection Lambert conforme centrée sur les États-Unis :

note: Tag: title
en: Spatial Tables
fr: Tables spatiales

note: Tag: title
en: Creating a Spatial Table
fr: Créer une table spatiale

note: Tag: para
en: You can create a table to store geometry data using the <ulink url="https://www.postgresql.org/docs/current/sql-createtable.html">CREATE TABLE</ulink> SQL statement with a column of type <varname>geometry</varname>. The following example creates a table with a geometry column storing 2D (XY) LineStrings in the BC-Albers coordinate system (SRID 3005):
fr: Vous pouvez créer une table pour stocker des données géométriques en utilisant l'instruction SQL <ulink url="https://www.postgresql.org/docs/current/sql-createtable.html">CREATE TABLE</ulink> avec une colonne de type <varname>geometry</varname>. L'exemple suivant crée une table avec une colonne géométrie stockant des chaînes de lignes 2D (XY) dans le système de coordonnées BC-Albers (SRID 3005) :

note: Tag: para
en: The <varname>geometry</varname> type supports two optional <emphasis role="bold">type modifiers</emphasis>:
fr: Le type <varname>geometry</varname> prend en charge deux <emphasis role="bold">modificateurs de type</emphasis> facultatifs :

note: Tag: para
en: the <emphasis role="bold">spatial type modifier</emphasis> restricts the kind of shapes and dimensions allowed in the column. The value can be any of the supported <link linkend="RefObject">geometry subtypes</link> (e.g. POINT, LINESTRING, POLYGON, MULTIPOINT, MULTILINESTRING, MULTIPOLYGON, GEOMETRYCOLLECTION, etc). The modifier supports coordinate dimensionality restrictions by adding suffixes: Z, M and ZM. For example, a modifier of 'LINESTRINGM' allows only linestrings with three dimensions, and treats the third dimension as a measure. Similarly, 'POINTZM' requires four dimensional (XYZM) data.
fr: le <emphasis role="bold">modificateur de type spatial</emphasis> restreint le type de formes et de dimensions autorisées dans la colonne. La valeur peut être l'un des <link linkend="RefObject">sous-types de géométrie</link> pris en charge (par exemple POINT, LINESTRING, POLYGON, MULTIPOINT, MULTILINESTRING, MULTIPOLYGON, GEOMETRYCOLLECTION, etc). Le modificateur prend en charge les restrictions de dimensionnalité des coordonnées en ajoutant des suffixes : Z, M et ZM. Par exemple, le modificateur "LINESTRINGM" n'autorise que les lignes à trois dimensions et traite la troisième dimension comme une mesure. De même, "POINTZM" requiert des données à quatre dimensions (XYZM).

note: Tag: para
en: the <emphasis role="bold">SRID modifier</emphasis> restricts the <link linkend="spatial_ref_sys">spatial reference system</link> SRID to a particular number. If omitted, the SRID defaults to 0.
fr: le <emphasis role="bold">modificateur SRID</emphasis> limite le <link linkend="spatial_ref_sys">système de référence spatiale</link> SRID à un nombre particulier. S'il est omis, le SRID prend par défaut la valeur 0.

note: Tag: para
en: Examples of creating tables with geometry columns:
fr: Exemples de création de tableaux avec des colonnes géométriques :

note: Tag: para
en: Create a table holding any kind of geometry with the default SRID:
fr: Créer une table contenant n'importe quel type de géométrie avec le SRID par défaut :

note: Tag: para
en: Create a table with 2D POINT geometry with the default SRID:
fr: Créer une table avec une géométrie POINT 2D avec le SRID par défaut :

note: Tag: para
en: Create a table with 3D (XYZ) POINTs and an explicit SRID of 3005:
fr: Créer une table avec des POINTS 3D (XYZ) et un SRID explicite de 3005 :

note: Tag: para
en: Create a table with 4D (XYZM) LINESTRING geometry with the default SRID:
fr: Créer une table avec une géométrie 4D (XYZM) LINESTRING avec le SRID par défaut :

note: Tag: para
en: Create a table with 2D POLYGON geometry with the SRID 4267 (NAD 1927 long lat):
fr: Créer une table avec une géométrie POLYGON 2D avec le SRID 4267 (NAD 1927 long lat) :

note: Tag: para
en: It is possible to have more than one geometry column in a table. This can be specified when the table is created, or a column can be added using the <ulink url="https://www.postgresql.org/docs/current/sql-altertable.html">ALTER TABLE</ulink> SQL statement. This example adds a column that can hold 3D LineStrings:
fr: Il est possible d'avoir plus d'une colonne de géométrie dans une table. Cela peut être spécifié lors de la création de la table, ou une colonne peut être ajoutée à l'aide de l'instruction SQL <ulink url="https://www.postgresql.org/docs/current/sql-altertable.html">ALTER TABLE</ulink>. Cet exemple ajoute une colonne qui peut contenir des LineStrings 3D :

note: Tag: title
en: GEOMETRY_COLUMNS View
fr: Vue GEOMETRY_COLUMNS

note: Tag: para
en: The OGC <emphasis>Simple Features Specification for SQL</emphasis> defines the <varname>GEOMETRY_COLUMNS</varname> metadata table to describe geometry table structure. In PostGIS <varname>geometry_columns</varname> is a view reading from database system catalog tables. This ensures that the spatial metadata information is always consistent with the currently defined tables and views. The view structure is:
fr: L'OGC <emphasis>Simple Features Specification for SQL</emphasis> définit la table de métadonnées <varname>GEOMETRY_COLUMNS</varname> pour décrire la structure de la table géométrique. Dans PostGIS, <varname>geometry_columns</varname> est une vue qui lit les tables de catalogue du système de base de données. Cela garantit que les informations de métadonnées spatiales sont toujours cohérentes avec les tables et les vues actuellement définies. La structure de la vue est la suivante :

note: Tag: para
en: The fully qualified name of the feature table containing the geometry column. There is no PostgreSQL analogue of "catalog" so that column is left blank. For "schema" the PostgreSQL schema name is used (<varname>public</varname> is the default).
fr: Le nom complet de la table d'entités contenant la colonne géométrie. Il n'y a pas d'analogue PostgreSQL de "catalog", cette colonne est donc laissée vide. Pour "schema", le nom du schéma PostgreSQL est utilisé (<varname>public</varname> est la valeur par défaut).

note: Tag: para
en: The name of the geometry column in the feature table.
fr: Le nom de la colonne géométrique dans la table des caractéristiques.

note: Tag: para
en: The coordinate dimension (2, 3 or 4) of the column.
fr: La dimension des coordonnées (2, 3 ou 4) de la colonne.

note: Tag: para
en: The ID of the spatial reference system used for the coordinate geometry in this table. It is a foreign key reference to the <varname>spatial_ref_sys</varname> table (see <xref linkend="spatial_ref_sys_table"/>).
fr: L'ID du système de référence spatiale utilisé pour la géométrie des coordonnées dans cette table. Il s'agit d'une référence de clé étrangère à la table <varname>spatial_ref_sys</varname> (voir <xref linkend="spatial_ref_sys_table"/>).

note: Tag: para
en: The type of the spatial object. To restrict the spatial column to a single type, use one of: POINT, LINESTRING, POLYGON, MULTIPOINT, MULTILINESTRING, MULTIPOLYGON, GEOMETRYCOLLECTION or corresponding XYM versions POINTM, LINESTRINGM, POLYGONM, MULTIPOINTM, MULTILINESTRINGM, MULTIPOLYGONM, GEOMETRYCOLLECTIONM. For heterogeneous (mixed-type) collections, you can use "GEOMETRY" as the type.
fr: Le type de l'objet spatial. Pour limiter la colonne spatiale à un seul type, utilisez l'une des options suivantes : POINT, LINESTRING, POLYGON, MULTIPOINT, MULTILINESTRING, MULTIPOLYGON, GEOMETRYCOLLECTION ou les versions XYM correspondantes POINTM, LINESTRINGM, POLYGONM, MULTIPOINTM, MULTILINESTRINGM, MULTIPOLYGONM, GEOMETRYCOLLECTIONM. Pour les collections hétérogènes (de type mixte), vous pouvez utiliser "GEOMETRY" comme type.

note: Tag: title
en: Manually Registering Geometry Columns
fr: Enregistrement manuel des colonnes de géométrie

note: Tag: para
en: Two of the cases where you may need this are the case of SQL Views and bulk inserts. For bulk insert case, you can correct the registration in the geometry_columns table by constraining the column or doing an alter table. For views, you could expose using a CAST operation. Note, if your column is typmod based, the creation process would register it correctly, so no need to do anything. Also views that have no spatial function applied to the geometry will register the same as the underlying table geometry column.
fr: Deux des cas où vous pouvez avoir besoin de cela sont les cas de vues SQL et les insertions en masse. Dans le cas des insertions en masse, vous pouvez corriger l'enregistrement dans la table geometry_columns en contraignant la colonne ou en effectuant une modification de la table. Pour les vues, vous pouvez exposer en utilisant une opération CAST. Notez que si votre colonne est basée sur un typmod, le processus de création l'enregistrera correctement, il n'est donc pas nécessaire de faire quoi que ce soit. De même, les vues qui n'ont pas de fonction spatiale appliquée à la géométrie s'enregistreront de la même manière que la colonne géométrique de la table sous-jacente.

note: Tag: para
en: Although the old-constraint based method is still supported, a constraint-based geometry column used directly in a view, will not register correctly in geometry_columns, as will a typmod one. In this example we define a column using typmod and another using constraints.
fr: Bien que l'ancienne méthode basée sur les contraintes soit toujours supportée, une colonne géométrique basée sur les contraintes utilisée directement dans une vue ne s'enregistrera pas correctement dans geometry_columns, tout comme une colonne typmod. Dans cet exemple, nous définissons une colonne à l'aide de typmod et une autre à l'aide de contraintes.

note: Tag: para
en: If we run in psql
fr: Si nous exécutons dans psql

note: Tag: para
en: We observe they are defined differently -- one is typmod, one is constraint
fr: Nous observons qu'ils sont définis différemment - l'un est un typmod, l'autre une contrainte

note: Tag: para
en: In geometry_columns, they both register correctly
fr: Dans geometry_columns, les deux s'enregistrent correctement

note: Tag: para
en: However -- if we were to create a view like this
fr: Cependant, si nous devions créer une vue comme celle-ci

note: Tag: para
en: The typmod based geom view column registers correctly, but the constraint based one does not.
fr: La colonne de la vue géométrique basée sur le modèle s'enregistre correctement, mais pas celle basée sur les contraintes.

note: Tag: para
en: This may change in future versions of PostGIS, but for now to force the constraint-based view column to register correctly, you need to do this:
fr: Cela pourrait changer dans les prochaines versions de PostGIS, mais pour l'instant, pour forcer la colonne de vue basée sur les contraintes à s'enregistrer correctement, vous devez procéder comme suit :

note: Tag: title
en: Loading Spatial Data
fr: Chargement des données spatiales

note: Tag: para
en: Once you have created a spatial table, you are ready to upload spatial data to the database. There are two built-in ways to get spatial data into a PostGIS/PostgreSQL database: using formatted SQL statements or using the Shapefile loader.
fr: Une fois que vous avez créé une table spatiale, vous êtes prêt à charger des données spatiales dans la base de données. Il existe deux façons d'intégrer des données spatiales dans une base de données PostGIS/PostgreSQL : à l'aide d'instructions SQL formatées ou à l'aide de l'utilitaire qui permet de charger des Shapefiles.

note: Tag: title
en: Using SQL to Load Data
fr: Utilisation de SQL pour charger des données

note: Tag: para
en: If spatial data can be converted to a text representation (as either WKT or WKB), then using SQL might be the easiest way to get data into PostGIS. Data can be bulk-loaded into PostGIS/PostgreSQL by loading a text file of SQL <code>INSERT</code> statements using the <code>psql</code> SQL utility.
fr: Si les données spatiales peuvent être converties en une représentation textuelle (WKT ou WKB), l'utilisation de SQL pourrait être le moyen le plus simple d'introduire les données dans PostGIS. Les données peuvent être chargées en masse dans PostGIS/PostgreSQL en chargeant un fichier texte d'instructions SQL <code>INSERT</code> à l'aide de l'utilitaire SQL <code>psql</code>.

note: Tag: para
en: A SQL load file (<filename>roads.sql</filename> for example) might look like this:
fr: Un fichier de chargement SQL (<filename>roads.sql</filename> par exemple) peut ressembler à ceci :

note: Tag: para
en: The SQL file can be loaded into PostgreSQL using <code>psql</code>:
fr: Le fichier SQL peut être chargé dans PostgreSQL en utilisant <code>psql</code> :

note: Tag: title
en: Using the Shapefile Loader
fr: Utilisation de l'utilitaire qui permet de charger des fichiers Shapefile

note: Tag: para
en: The <filename>shp2pgsql</filename> data loader converts Shapefiles into SQL suitable for insertion into a PostGIS/PostgreSQL database either in geometry or geography format. The loader has several operating modes selected by command line flags.
fr: Le chargeur de données <filename>shp2pgsql</filename> convertit les Shapefiles en SQL pour les insérer dans une base de données PostGIS/PostgreSQL au format geometry ou geography. Le chargeur a plusieurs modes de fonctionnement sélectionnés par des indicateurs de ligne de commande.

note: Tag: para
en: There is also a <filename>shp2pgsql-gui</filename> graphical interface with most of the options as the command-line loader. This may be easier to use for one-off non-scripted loading or if you are new to PostGIS. It can also be configured as a plugin to PgAdminIII.
fr: Il existe également une interface graphique <filename>shp2pgsql-gui</filename> qui offre la plupart des options du chargeur en ligne de commande. Cette interface peut être plus facile à utiliser pour un chargement ponctuel sans script ou si vous êtes novice en matière de PostGIS. Il peut également être configuré comme un plugin pour PgAdminIII.

note: Tag: term
en: (c|a|d|p) These are mutually exclusive options:
fr: (c|a|d|p) Ces options s'excluent mutuellement :

note: Tag: para
en: Creates a new table and populates it from the Shapefile. <emphasis>This is the default mode.</emphasis>
fr: Crée une nouvelle table et la remplit à partir du fichier Shapefile. <emphasis>C'est le mode par défaut.</emphasis>

note: Tag: para
en: Appends data from the Shapefile into the database table. Note that to use this option to load multiple files, the files must have the same attributes and same data types.
fr: Ajoute les données du fichier Shapefile dans la table de la base de données. Notez que pour utiliser cette option afin de charger plusieurs fichiers, les fichiers doivent avoir les mêmes attributs et les mêmes types de données.

note: Tag: para
en: Drops the database table before creating a new table with the data in the Shapefile.
fr: Supprime la table de la base de données avant de créer une nouvelle table avec les données du fichier Shapefile.

note: Tag: para
en: Only produces the table creation SQL code, without adding any actual data. This can be used if you need to completely separate the table creation and data loading steps.
fr: Produit uniquement le code SQL de création de la table, sans ajouter de données réelles. Cette option peut être utilisée si vous souhaitez séparer complètement les étapes de création de la table et de chargement des données.

note: Tag: para
en: Display help screen.
fr: Afficher l'écran d'aide.

note: Tag: para
en: Use the PostgreSQL "dump" format for the output data. This can be combined with -a, -c and -d. It is much faster to load than the default "insert" SQL format. Use this for very large data sets.
fr: Utilise le format "dump" de PostgreSQL pour les données de sortie. Ce format peut être combiné avec -a, -c et -d. Il est beaucoup plus rapide à charger que le format SQL "insert" par défaut. Utilisez-le pour les très grands ensembles de données.

note: Tag: para
en: Creates and populates the geometry tables with the specified SRID. Optionally specifies that the input shapefile uses the given FROM_SRID, in which case the geometries will be reprojected to the target SRID.
fr: Crée et remplit les tables de géométrie avec le SRID spécifié. Il est possible de spécifier que le fichier de forme d'entrée utilise le FROM_SRID donné, auquel cas les géométries seront reprojetées dans le SRID cible.

note: Tag: para
en: Keep identifiers' case (column, schema and attributes). Note that attributes in Shapefile are all UPPERCASE.
fr: Conserver la casse des identifiants (colonne, schéma et attributs). Notez que les attributs dans Shapefile sont tous en majuscules.

note: Tag: para
en: Coerce all integers to standard 32-bit integers, do not create 64-bit bigints, even if the DBF header signature appears to warrant it.
fr: Contraindre tous les entiers à des entiers 32 bits standard, ne pas créer de bigints 64 bits, même si la signature de l'en-tête DBF semble le justifier.

note: Tag: para
en: Create a GiST index on the geometry column.
fr: Créer un index GiST sur la colonne géométrie.

note: Tag: para
en: -m <filename>a_file_name</filename> Specify a file containing a set of mappings of (long) column names to 10 character DBF column names. The content of the file is one or more lines of two names separated by white space and no trailing or leading space. For example:
fr: -m <filename>nom_de_fichier</filename> Spécifier un fichier contenant un ensemble de correspondances entre les noms de colonnes (longs) et les noms de colonnes DBF à 10 caractères. Le contenu du fichier est une ou plusieurs lignes de deux noms séparées par un espace blanc, sans espace de départ ni de fin. Par exemple :

note: Tag: para
en: Generate simple geometries instead of MULTI geometries. Will only succeed if all the geometries are actually single (I.E. a MULTIPOLYGON with a single shell, or or a MULTIPOINT with a single vertex).
fr: Génère des géométries simples au lieu de géométries MULTI. Ne réussira que si toutes les géométries sont en fait simples (c'est-à-dire un MULTIPOLYGON avec une seule enveloppe, ou un MULTIPOINT avec un seul sommet).

note: Tag: para
en: Force the output geometry to have the specified dimensionality. Use the following strings to indicate the dimensionality: 2D, 3DZ, 3DM, 4D.
fr: Force la géométrie de sortie à avoir la dimensionnalité spécifiée. Utilisez les chaînes de caractères suivantes pour indiquer la dimensionnalité : 2D, 3DZ, 3DM, 4D.

note: Tag: para
en: If the input has fewer dimensions that specified, the output will have those dimensions filled in with zeroes. If the input has more dimensions that specified, the unwanted dimensions will be stripped.
fr: Si l'entrée a moins de dimensions que celles spécifiées, la sortie aura ces dimensions remplies avec des zéros. Si l'entrée a plus de dimensions que celles spécifiées, les dimensions non désirées seront supprimées.

note: Tag: para
en: Output WKT format, instead of WKB. Note that this can introduce coordinate drifts due to loss of precision.
fr: Sortie au format WKT, au lieu de WKB. Notez que cela peut introduire des dérives de coordonnées dues à la perte de précision.

note: Tag: para
en: Execute each statement on its own, without using a transaction. This allows loading of the majority of good data when there are some bad geometries that generate errors. Note that this cannot be used with the -D flag as the "dump" format always uses a transaction.
fr: Exécuter chaque instruction séparément, sans utiliser de transaction. Cela permet de charger la majorité des bonnes données lorsqu'il y a quelques mauvaises géométries qui génèrent des erreurs. Notez que cela ne peut pas être utilisé avec l'option -D car le format "dump" utilise toujours une transaction.

note: Tag: para
en: Specify encoding of the input data (dbf file). When used, all attributes of the dbf are converted from the specified encoding to UTF8. The resulting SQL output will contain a <code>SET CLIENT_ENCODING to UTF8</code> command, so that the backend will be able to reconvert from UTF8 to whatever encoding the database is configured to use internally.
fr: Spécifie l'encodage des données d'entrée (fichier dbf). Lorsqu'il est utilisé, tous les attributs du fichier dbf sont convertis en UTF8 à partir de l'encodage spécifié. La sortie SQL résultante contiendra une commande <code>SET CLIENT_ENCODING to UTF8</code>, afin que le backend puisse reconvertir de UTF8 à n'importe quel encodage que la base de données est configurée pour utiliser en interne.

note: Tag: para
en: NULL geometries handling policy (insert*,skip,abort)
fr: Politique de gestion des géométries NULL (insert*, skip, abort)

note: Tag: para
en: -n Only import DBF file. If your data has no corresponding shapefile, it will automatically switch to this mode and load just the dbf. So setting this flag is only needed if you have a full shapefile set, and you only want the attribute data and no geometry.
fr: -n Importer uniquement le fichier DBF. Si vos données n'ont pas de fichier de forme correspondant, il passera automatiquement à ce mode et ne chargera que le fichier DBF. Cette option n'est donc nécessaire que si vous disposez d'un fichier de forme complet et que vous ne voulez que les données d'attributs et pas de géométrie.

note: Tag: para
en: Use geography type instead of geometry (requires lon/lat data) in WGS84 long lat (SRID=4326)
fr: Utiliser le type geography au lieu de geometry (nécessite des données lon/lat) dans WGS84 long lat (SRID=4326)

note: Tag: para
en: Specify the tablespace for the new table. Indexes will still use the default tablespace unless the -X parameter is also used. The PostgreSQL documentation has a good description on when to use custom tablespaces.
fr: Spécifiez le tablespace pour la nouvelle table. Les index utiliseront toujours le tablespace par défaut à moins que le paramètre -X ne soit également utilisé. La documentation de PostgreSQL contient une bonne description de l'utilisation des tablespaces personnalisés.

note: Tag: para
en: Specify the tablespace for the new table's indexes. This applies to the primary key index, and the GIST spatial index if -I is also used.
fr: Spécifier le tablespace pour les index de la nouvelle table. Ceci s'applique à l'index de clé primaire et à l'index spatial GIST si -I est également utilisé.

note: Tag: para
en: When used, this flag will prevent the generation of <code>ANALYZE</code> statements. Without the -Z flag (default behavior), the <code>ANALYZE</code> statements will be generated.
fr: Lorsqu'il est utilisé, cet indicateur empêche la génération des instructions <code>ANALYZE</code>. Sans l'option -Z (comportement par défaut), les instructions <code>ANALYZE</code> seront générées.

note: Tag: para
en: An example session using the loader to create an input file and loading it might look like this:
fr: Un exemple de session utilisant le chargeur pour créer un fichier d'entrée et le charger peut ressembler à ceci :

note: Tag: para
en: A conversion and load can be done in one step using UNIX pipes:
fr: Une conversion et un chargement peuvent être effectués en une seule étape à l'aide de pipes UNIX :

note: Tag: title
en: Extracting Spatial Data
fr: Extraction de données spatiales

note: Tag: para
en: Spatial data can be extracted from the database using either SQL or the Shapefile dumper. The section on SQL presents some of the functions available to do comparisons and queries on spatial tables.
fr: Les données spatiales peuvent être extraites de la base de données à l'aide de SQL ou de Shapefile dumper. La section sur SQL présente certaines des fonctions disponibles pour effectuer des comparaisons et des requêtes sur les tables spatiales.

note: Tag: title
en: Using SQL to Extract Data
fr: Utiliser SQL pour extraire des données

note: Tag: para
en: The most straightforward way of extracting spatial data out of the database is to use a SQL <code>SELECT</code> query to define the data set to be extracted and dump the resulting columns into a parsable text file:
fr: La manière la plus simple d'extraire des données spatiales de la base de données consiste à utiliser une requête SQL <code>SELECT</code> pour définir l'ensemble de données à extraire et à transférer les colonnes résultantes dans un fichier texte analysable :

note: Tag: para
en: There will be times when some kind of restriction is necessary to cut down the number of records returned. In the case of attribute-based restrictions, use the same SQL syntax as used with a non-spatial table. In the case of spatial restrictions, the following functions are useful:
fr: Il peut arriver qu'une restriction soit nécessaire pour réduire le nombre d'enregistrements renvoyés. Dans le cas de restrictions basées sur des attributs, utilisez la même syntaxe SQL que pour une table non spatiale. Dans le cas de restrictions spatiales, les fonctions suivantes sont utiles :

note: Tag: para
en: This function tells whether two geometries share any space.
fr: Cette fonction indique si deux géométries partagent un espace.

note: Tag: para
en: This tests whether two geometries are geometrically identical. For example, if 'POLYGON((0 0,1 1,1 0,0 0))' is the same as 'POLYGON((0 0,1 1,1 0,0 0))' (it is).
fr: Cette fonction permet de vérifier si deux géométries sont géométriquement identiques. Par exemple, si 'POLYGON((0 0,1 1,1 0,0 0))' est identique à 'POLYGON((0 0,1 1,1 0,0 0))' (c'est le cas).

note: Tag: para
en: Next, you can use these operators in queries. Note that when specifying geometries and boxes on the SQL command line, you must explicitly turn the string representations into geometries function. The 312 is a fictitious spatial reference system that matches our data. So, for example:
fr: Vous pouvez ensuite utiliser ces opérateurs dans des requêtes. Notez que lorsque vous spécifiez des géométries et des box sur la ligne de commande SQL, vous devez explicitement transformer les représentations de chaînes de caractères en fonction géométrique. Le 312 est un système de référence spatiale fictif qui correspond à nos données. Ainsi, par exemple, le 312 est un système de référence spatiale fictif qui correspond à nos données :

note: Tag: para
en: The above query would return the single record from the "ROADS_GEOM" table in which the geometry was equal to that value.
fr: La requête ci-dessus renverrait le seul enregistrement de la table "ROADS_GEOM" dont la géométrie est égale à cette valeur.

note: Tag: para
en: To check whether some of the roads passes in the area defined by a polygon:
fr: Vérifier si certaines routes passent dans la zone définie par un polygone :

note: Tag: para
en: The most common spatial query will probably be a "frame-based" query, used by client software, like data browsers and web mappers, to grab a "map frame" worth of data for display.
fr: La requête spatiale la plus courante sera probablement une requête "basée sur un cadre", utilisée par les logiciels clients, tels que les navigateurs de données et les cartographes web, pour saisir un "cadre de carte" d'une valeur de données pour l'affichage.

note: Tag: para
en: When using the "&amp;&amp;" operator, you can specify either a BOX3D as the comparison feature or a GEOMETRY. When you specify a GEOMETRY, however, its bounding box will be used for the comparison.
fr: Lorsque vous utilisez l'opérateur "&amp;&amp;", vous pouvez spécifier soit une BOX3D comme élément de comparaison, soit une GEOMETRY. Toutefois, lorsque vous spécifiez une GEOMETRY, c'est sa boîte de délimitation qui sera utilisée pour la comparaison.

note: Tag: para
en: Using a "BOX3D" object for the frame, such a query looks like this:
fr: En utilisant un objet "BOX3D" pour le cadre, une telle requête se présente comme suit :

note: Tag: para
en: Note the use of the SRID 312, to specify the projection of the envelope.
fr: Notez l'utilisation du SRID 312 pour spécifier la projection de l'enveloppe.

note: Tag: title
en: Using the Shapefile Dumper
fr: Utilisation de Shapefile Dumper

note: Tag: para
en: The <filename>pgsql2shp</filename> table dumper connects to the database and converts a table (possibly defined by a query) into a shape file. The basic syntax is:
fr: Le table dumper <filename>pgsql2shp</filename> se connecte à la base de données et convertit une table (éventuellement définie par une requête) en un fichier shape. La syntaxe de base est la suivante :

note: Tag: para
en: The commandline options are:
fr: Les options de la ligne de commande sont les suivantes :

note: Tag: para
en: Write the output to a particular filename.
fr: Écriture de la sortie dans un fichier particulier.

note: Tag: para
en: The database host to connect to.
fr: L'hôte de la base de données auquel se connecter.

note: Tag: para
en: The port to connect to on the database host.
fr: Le port auquel se connecter sur l'hôte de la base de données.

note: Tag: para
en: The password to use when connecting to the database.
fr: Le mot de passe à utiliser lors de la connexion à la base de données.

note: Tag: para
en: The username to use when connecting to the database.
fr: Le nom d'utilisateur à utiliser lors de la connexion à la base de données.

note: Tag: para
en: In the case of tables with multiple geometry columns, the geometry column to use when writing the shape file.
fr: Dans le cas de tableaux comportant plusieurs colonnes géométriques, la colonne géométrique à utiliser lors de l'écriture du fichier de forme.

note: Tag: para
en: Use a binary cursor. This will make the operation faster, but will not work if any NON-geometry attribute in the table lacks a cast to text.
fr: Utiliser un curseur binaire. L'opération sera plus rapide, mais ne fonctionnera pas si un attribut NON-geometry de la table n'est pas converti en texte.

note: Tag: para
en: Raw mode. Do not drop the <varname>gid</varname> field, or escape column names.
fr: Mode brut. Ne pas supprimer le champ <varname>gid</varname>, ni échapper les noms de colonnes.

note: Tag: para
en: Remap identifiers to ten character names. The content of the file is lines of two symbols separated by a single white space and no trailing or leading space: VERYLONGSYMBOL SHORTONE ANOTHERVERYLONGSYMBOL SHORTER etc.
fr: Remapper les identifiants en noms de dix caractères. Le contenu du fichier est constitué de lignes de deux symboles séparées par un seul espace blanc, sans espace de départ ni de fin : VERYLONGSYMBOL SHORTONE ANOTHERYLONGSYMBOL SHORTER etc.

note: Tag: title
en: Spatial Indexes
fr: Index spatiaux

note: Tag: para
en: Spatial indexes make using a spatial database for large data sets possible. Without indexing, a search for features requires a sequential scan of every record in the database. Indexing speeds up searching by organizing the data into a structure which can be quickly traversed to find matching records.
fr: Les index spatiaux permettent d'utiliser une base de données spatiales pour de grands ensembles de données. Sans indexation, la recherche de caractéristiques nécessite un balayage séquentiel de chaque enregistrement de la base de données. L'indexation accélère la recherche en organisant les données dans une structure qui peut être rapidement parcourue pour trouver les enregistrements correspondants.

note: Tag: para
en: The B-tree index method commonly used for attribute data is not very useful for spatial data, since it only supports storing and querying data in a single dimension. Data such as geometry (which has 2 or more dimensions) requires an index method that supports range query across all the data dimensions. One of the key advantages of PostgreSQL for spatial data handling is that it offers several kinds of index methods which work well for multi-dimensional data: GiST, BRIN and SP-GiST indexes.
fr: La méthode d'indexation B-tree couramment utilisée pour les données d'attributs n'est pas très utile pour les données spatiales, car elle ne permet de stocker et d'interroger les données que dans une seule dimension. Les données telles que la géométrie (qui a 2 dimensions ou plus) requièrent une méthode d'indexation qui supporte les requêtes sur toutes les dimensions des données. L'un des principaux avantages de PostgreSQL pour le traitement des données spatiales est qu'il offre plusieurs types de méthodes d'indexation qui fonctionnent bien pour les données multidimensionnelles : GiST, BRIN et SP-GiST.

note: Tag: para
en: <emphasis role="bold">GiST (Generalized Search Tree)</emphasis> indexes break up data into "things to one side", "things which overlap", "things which are inside" and can be used on a wide range of data-types, including GIS data. PostGIS uses an R-Tree index implemented on top of GiST to index spatial data. GiST is the most commonly-used and versatile spatial index method, and offers very good query performance.
fr: Les index <emphasis role="bold">GiST (Generalized Search Tree)</emphasis> décomposent les données en "choses à côté", "choses qui se chevauchent", "choses qui sont à l'intérieur" et peuvent être utilisés sur un large éventail de types de données, y compris les données SIG. PostGIS utilise un index R-Tree implémenté au-dessus de GiST pour indexer les données spatiales. GiST est la méthode d'indexation spatiale la plus couramment utilisée et la plus polyvalente, et offre de très bonnes performances en matière de requêtes.

note: Tag: para
en: <emphasis role="bold">BRIN (Block Range Index)</emphasis> indexes operate by summarizing the spatial extent of ranges of table records. Search is done via a scan of the ranges. BRIN is only appropriate for use for some kinds of data (spatially sorted, with infrequent or no update). But it provides much faster index create time, and much smaller index size.
fr: Les index <emphasis role="bold">BRIN (Block Range Index)</emphasis> fonctionnent en résumant l'étendue spatiale des plages d'enregistrements de la table. La recherche s'effectue par le biais d'un balayage des plages. L'index BRIN n'est approprié que pour certains types de données (triées dans l'espace, avec des mises à jour peu fréquentes ou inexistantes). Mais il permet une création d'index beaucoup plus rapide et une taille d'index beaucoup plus petite.

note: Tag: para
en: <emphasis role="bold">SP-GiST (Space-Partitioned Generalized Search Tree)</emphasis> is a generic index method that supports partitioned search trees such as quad-trees, k-d trees, and radix trees (tries).
fr: <emphasis role="bold">SP-GiST (Space-Partitioned Generalized Search Tree)</emphasis> est une méthode d'indexation générique qui prend en charge les arbres de recherche partitionnés tels que les arbres quadratiques, les arbres k-d et les arbres radix (tries).

note: Tag: para
en: Spatial indexes store only the bounding box of geometries. Spatial queries use the index as a <emphasis role="bold">primary filter</emphasis> to quickly determine a set of geometries potentially matching the query condition. Most spatial queries require a <emphasis role="bold">secondary filter</emphasis> that uses a spatial predicate function to test a more specific spatial condition. For more information on queying with spatial predicates see <xref linkend="using-query-indexes"/>.
fr: Les index spatiaux ne stockent que la boîte de délimitation des géométries. Les requêtes spatiales utilisent l'index comme <emphasis role="bold">filtre primaire</emphasis> pour déterminer rapidement un ensemble de géométries correspondant potentiellement à la condition de la requête. La plupart des requêtes spatiales nécessitent un <emphasis role="bold">filtre secondaire</emphasis> qui utilise une fonction de prédicat spatial pour tester une condition spatiale plus spécifique. Pour plus d'informations sur les requêtes avec des prédicats spatiaux, voir <xref linkend="using-query-indexes"/>.

note: Tag: para
en: See also the <ulink url="https://postgis.net/workshops/postgis-intro/indexing.html">PostGIS Workshop section on spatial indexes</ulink>, and the <ulink url="https://www.postgresql.org/docs/current/indexes.html">PostgreSQL manual</ulink>.
fr: Voir également <ulink url="https://postgis.net/workshops/postgis-intro/indexing.html">la section de l'atelier PostGIS sur les index spatiaux</ulink> et le <ulink url="https://www.postgresql.org/docs/current/indexes.html">manuel de PostgreSQL</ulink>.

note: Tag: title
en: GiST Indexes
fr: Index GiST

note: Tag: para
en: GiST stands for "Generalized Search Tree" and is a generic form of indexing for multi-dimensional data. PostGIS uses an R-Tree index implemented on top of GiST to index spatial data. GiST is the most commonly-used and versatile spatial index method, and offers very good query performance. Other implementations of GiST are used to speed up searches on all kinds of irregular data structures (integer arrays, spectral data, etc) which are not amenable to normal B-Tree indexing. For more information see the <ulink url="https://www.postgresql.org/docs/current/gist.html">PostgreSQL manual</ulink>.
fr: GiST signifie "Generalized Search Tree" (arbre de recherche généralisé) et constitue une forme générique d'indexation pour les données multidimensionnelles. PostGIS utilise un index R-Tree implémenté au-dessus de GiST pour indexer les données spatiales. GiST est la méthode d'indexation spatiale la plus couramment utilisée et la plus polyvalente, et offre de très bonnes performances en matière de requêtes. D'autres implémentations de GiST sont utilisées pour accélérer les recherches sur toutes sortes de structures de données irrégulières (tableaux d'entiers, données spectrales, etc.) qui ne se prêtent pas à l'indexation B-Tree normale. Pour plus d'informations, voir le <ulink url="https://www.postgresql.org/docs/current/gist.html">manuel PostgreSQL</ulink>.

note: Tag: para
en: Once a spatial data table exceeds a few thousand rows, you will want to build an index to speed up spatial searches of the data (unless all your searches are based on attributes, in which case you'll want to build a normal index on the attribute fields).
fr: Dès qu'une table de données spatiales dépasse quelques milliers de lignes, vous devez créer un index pour accélérer les recherches spatiales dans les données (sauf si toutes vos recherches sont basées sur des attributs, auquel cas vous devez créer un index normal sur les champs d'attributs).

note: Tag: para
en: The syntax for building a GiST index on a "geometry" column is as follows:
fr: La syntaxe pour construire un index GiST sur une colonne "geometry" est la suivante :

note: Tag: para
en: The above syntax will always build a 2D-index. To get the an n-dimensional index for the geometry type, you can create one using this syntax:
fr: La syntaxe ci-dessus permet toujours de créer un index 2D. Pour obtenir un index à n dimensions pour le type de géométrie, vous pouvez en créer un à l'aide de cette syntaxe :

note: Tag: para
en: Building a spatial index is a computationally intensive exercise. It also blocks write access to your table for the time it creates, so on a production system you may want to do in in a slower CONCURRENTLY-aware way:
fr: La construction d'un index spatial est un exercice de calcul intensif. Il bloque également l'accès en écriture à votre table pendant le temps de sa création, donc sur un système de production, vous voudrez peut-être le faire d'une manière plus lente, en tenant compte de la notion de CONCURRENCE :

note: Tag: para
en: After building an index, it is sometimes helpful to force PostgreSQL to collect table statistics, which are used to optimize query plans:
fr: Après avoir construit un index, il est parfois utile de forcer PostgreSQL à collecter les statistiques de la table, qui sont utilisées pour optimiser les plans de requête :

note: Tag: title
en: BRIN Indexes
fr: Index BRIN

note: Tag: para
en: BRIN stands for "Block Range Index". It is a general-purpose index method introduced in PostgreSQL 9.5. BRIN is a <emphasis>lossy</emphasis> index method, meaning that a secondary check is required to confirm that a record matches a given search condition (which is the case for all provided spatial indexes). It provides much faster index creation and much smaller index size, with reasonable read performance. Its primary purpose is to support indexing very large tables on columns which have a correlation with their physical location within the table. In addition to spatial indexing, BRIN can speed up searches on various kinds of attribute data structures (integer, arrays etc). For more information see the <ulink url="https://www.postgresql.org/docs/current/brin.html">PostgreSQL manual</ulink>.
fr: BRIN signifie "Block Range Index". C'est une méthode d'indexation générale introduite dans PostgreSQL 9.5. BRIN est une méthode d'indexation <emphasis>lossy</emphasis>, ce qui signifie qu'une vérification secondaire est nécessaire pour confirmer qu'un enregistrement correspond à une condition de recherche donnée (ce qui est le cas pour tous les index spatiaux fournis). Elle permet une création d'index beaucoup plus rapide et une taille d'index beaucoup plus petite, avec des performances de lecture raisonnables. Son objectif principal est de permettre l'indexation de très grandes tables sur des colonnes qui ont une corrélation avec leur emplacement physique dans la table. Outre l'indexation spatiale, BRIN peut accélérer les recherches sur divers types de structures de données d'attributs (entiers, tableaux, etc.). Pour plus d'informations, voir le <ulink url="https://www.postgresql.org/docs/current/brin.html">Manuel de PostgreSQL</ulink>.

note: Tag: para
en: Once a spatial table exceeds a few thousand rows, you will want to build an index to speed up spatial searches of the data. GiST indexes are very performant as long as their size doesn't exceed the amount of RAM available for the database, and as long as you can afford the index storage size, and the cost of index update on write. Otherwise, for very large tables BRIN index can be considered as an alternative.
fr: Dès qu'une table spatiale dépasse quelques milliers de lignes, vous voudrez construire un index pour accélérer les recherches spatiales dans les données. Les index GiST sont très performants tant que leur taille ne dépasse pas la quantité de mémoire vive disponible pour la base de données, et tant que vous pouvez vous permettre la taille de stockage de l'index et le coût de la mise à jour de l'index en écriture. Sinon, pour les très grandes tables, l'index BRIN peut être considéré comme une alternative.

note: Tag: para
en: A BRIN index stores the bounding box enclosing all the geometries contained in the rows in a contiguous set of table blocks, called a <emphasis>block range</emphasis>. When executing a query using the index the block ranges are scanned to find the ones that intersect the query extent. This is efficient only if the data is physically ordered so that the bounding boxes for block ranges have minimal overlap (and ideally are mutually exclusive). The resulting index is very small in size, but is typically less performant for read than a GiST index over the same data.
fr: Un index BRIN stocke la boîte englobant toutes les géométries contenues dans les lignes d'un ensemble contigu de blocs de table, appelé <emphasis>plage de blocs</emphasis>. Lors de l'exécution d'une requête à l'aide de l'index, les plages de blocs sont examinées pour trouver celles qui recoupent l'étendue de la requête. Cette méthode n'est efficace que si les données sont physiquement ordonnées de manière à ce que les zones de délimitation des plages de blocs se chevauchent le moins possible (et, dans l'idéal, s'excluent mutuellement). L'index qui en résulte est de très petite taille, mais il est généralement moins performant en lecture qu'un index GiST sur les mêmes données.

note: Tag: para
en: Building a BRIN index is much less CPU-intensive than building a GiST index. It's common to find that a BRIN index is ten times faster to build than a GiST index over the same data. And because a BRIN index stores only one bounding box for each range of table blocks, it's common to use up to a thousand times less disk space than a GiST index.
fr: La construction d'un index BRIN est beaucoup moins gourmande en ressources CPU que la construction d'un index GiST. Il est courant de constater qu'un index BRIN est dix fois plus rapide à construire qu'un index GiST pour les mêmes données. Et comme un index BRIN ne stocke qu'une seule boîte englobante pour chaque plage de blocs de table, il est courant d'utiliser jusqu'à mille fois moins d'espace disque qu'un index GiST.

note: Tag: para
en: You can choose the number of blocks to summarize in a range. If you decrease this number, the index will be bigger but will probably provide better performance.
fr: Vous pouvez choisir le nombre de blocs à résumer dans une plage. Si vous diminuez ce nombre, l'index sera plus volumineux mais offrira probablement de meilleures performances.

note: Tag: para
en: For BRIN to be effective, the table data should be stored in a physical order which minimizes the amount of block extent overlap. It may be that the data is already sorted appropriately (for instance, if it is loaded from another dataset that is already sorted in spatial order). Otherwise, this can be accomplished by sorting the data by a one-dimensional spatial key. One way to do this is to create a new table sorted by the geometry values (which in recent PostGIS versions uses an efficient Hilbert curve ordering):
fr: Pour que le BRIN soit efficace, les données de la table doivent être stockées dans un ordre physique qui minimise le chevauchement de l'étendue du bloc. Il se peut que les données soient déjà triées de manière appropriée (par exemple, si elles sont chargées à partir d'un autre jeu de données déjà trié dans l'ordre spatial). Dans le cas contraire, il est possible de trier les données en fonction d'une clé spatiale unidimensionnelle. Une façon de procéder consiste à créer une nouvelle table triée par les valeurs géométriques (qui, dans les versions récentes de PostGIS, utilisent un classement efficace par courbe de Hilbert) :

note: Tag: para
en: Alternatively, data can be sorted in-place by using a GeoHash as a (temporary) index, and clustering on that index:
fr: Il est également possible de trier les données en place en utilisant un GeoHash comme index (temporaire) et en effectuant un regroupement sur cet index :

note: Tag: para
en: The syntax for building a BRIN index on a <code>geometry</code> column is:
fr: La syntaxe pour construire un index BRIN sur une colonne <code>geometry</code> est la suivante :

note: Tag: para
en: The above syntax builds a 2D index. To build a 3D-dimensional index, use this syntax:
fr: La syntaxe ci-dessus permet de créer un index en 2D. Pour construire un index à trois dimensions, utilisez la syntaxe suivante :

note: Tag: para
en: You can also get a 4D-dimensional index using the 4D operator class:
fr: Vous pouvez également obtenir un index quadridimensionnel à l'aide de la classe d'opérateurs 4D :

note: Tag: para
en: The above commands use the default number of blocks in a range, which is 128. To specify the number of blocks to summarise in a range, use this syntax
fr: Les commandes ci-dessus utilisent le nombre par défaut de blocs dans une plage, qui est de 128. Pour spécifier le nombre de blocs à résumer dans une plage, utilisez la syntaxe suivante

note: Tag: para
en: Keep in mind that a BRIN index only stores one index entry for a large number of rows. If your table stores geometries with a mixed number of dimensions, it's likely that the resulting index will have poor performance. You can avoid this performance penalty by choosing the operator class with the least number of dimensions of the stored geometries
fr: Gardez à l'esprit qu'un index BRIN ne stocke qu'une entrée d'index pour un grand nombre de lignes. Si votre table stocke des géométries avec un nombre variable de dimensions, il est probable que l'index qui en résultera sera peu performant. Vous pouvez éviter cette pénalité de performance en choisissant la classe d'opérateur avec le plus petit nombre de dimensions des géométries stockées

note: Tag: para
en: The <code>geography</code> datatype is supported for BRIN indexing. The syntax for building a BRIN index on a geography column is:
fr: Le type de données <code>geography</code> est pris en charge pour l'indexation BRIN. La syntaxe pour construire un index BRIN sur une colonne géographique est la suivante :

note: Tag: para
en: The above syntax builds a 2D-index for geospatial objects on the spheroid.
fr: La syntaxe ci-dessus permet de créer un index 2D pour les objets géospatiaux sur le sphéroïde.

note: Tag: para
en: Currently, only "inclusion support" is provided, meaning that just the <varname>&amp;&amp;</varname>, <varname>~</varname> and <varname>@</varname> operators can be used for the 2D cases (for both <code>geometry</code> and <code>geography</code>), and just the <varname>&amp;&amp;&amp;</varname> operator for 3D geometries. There is currently no support for kNN searches.
fr: Actuellement, seul le "support d'inclusion" est fourni, ce qui signifie que seuls les opérateurs <varname>&amp;&amp;</varname>, <varname>~</varname> et <varname>@</varname> peuvent être utilisés pour les cas 2D (à la fois pour <code>geometry</code> et <code>geography</code>), et seulement l'opérateur <varname>&amp;&amp;&amp;</varname> pour les géométries 3D. Il n'y a actuellement pas de support pour les recherches kNN.

note: Tag: para
en: An important difference between BRIN and other index types is that the database does not maintain the index dynamically. Changes to spatial data in the table are simply appended to the end of the index. This will cause index search performance to degrade over time. The index can be updated by performing a <code>VACUUM</code>, or by using a special function <code>brin_summarize_new_values(regclass)</code>. For this reason BRIN may be most appropriate for use with data that is read-only, or only rarely changing. For more information refer to the <ulink url="https://www.postgresql.org/docs/current/brin-intro.html#BRIN-OPERATION">manual</ulink>.
fr: Une différence importante entre BRIN et les autres types d'index est que la base de données ne maintient pas l'index de manière dynamique. Les modifications apportées aux données spatiales de la table sont simplement ajoutées à la fin de l'index. Cela entraîne une dégradation des performances de recherche de l'index au fil du temps. L'index peut être mis à jour en effectuant un <code>VACUUM</code>, ou en utilisant une fonction spéciale <code>brin_summarize_new_values(regclass)</code>. C'est la raison pour laquelle BRIN peut être plus approprié pour les données qui sont en lecture seule ou qui ne changent que rarement. Pour plus d'informations, consultez le <ulink url="https://www.postgresql.org/docs/current/brin-intro.html#BRIN-OPERATION">manuel</ulink>.

note: Tag: para
en: To summarize using BRIN for spatial data:
fr: En résumé, l'utilisation de BRIN pour les données spatiales :

note: Tag: para
en: Index build time is very fast, and index size is very small.
fr: Le temps de construction de l'index est très rapide et la taille de l'index est très réduite.

note: Tag: para
en: Index query time is slower than GiST, but can still be very acceptable.
fr: Le temps d'interrogation de l'index est plus lent que celui de GiST, mais reste très acceptable.

note: Tag: para
en: Requires table data to be sorted in a spatial ordering.
fr: Nécessite que les données du tableau soient triées dans un ordre spatial.

note: Tag: para
en: Requires manual index maintenance.
fr: Nécessite une maintenance manuelle de l'index.

note: Tag: para
en: Most appropriate for very large tables, with low or no overlap (e.g. points), which are static or change infrequently.
fr: Plus approprié pour les tables de très grande taille, avec peu ou pas de chevauchement (par exemple des points), qui sont statiques ou qui changent peu souvent.

note: Tag: para
en: More effective for queries which return relatively large numbers of data records.
fr: Plus efficace pour les requêtes qui renvoient un nombre relativement important d'enregistrements de données.

note: Tag: title
en: SP-GiST Indexes
fr: Index SP-GiST

note: Tag: para
en: SP-GiST stands for "Space-Partitioned Generalized Search Tree" and is a generic form of indexing for multi-dimensional data types that supports partitioned search trees, such as quad-trees, k-d trees, and radix trees (tries). The common feature of these data structures is that they repeatedly divide the search space into partitions that need not be of equal size. In addition to spatial indexing, SP-GiST is used to speed up searches on many kinds of data, such as phone routing, ip routing, substring search, etc. For more information see the <ulink url="https://www.postgresql.org/docs/current/spgist.html">PostgreSQL manual</ulink>.
fr: SP-GiST signifie "Space-Partitioned Generalized Search Tree" et est une forme générique d'indexation pour les types de données multidimensionnelles qui prend en charge les arbres de recherche partitionnés, tels que les arbres quadratiques, les arbres k-d et les arbres radix (tries). La caractéristique commune de ces structures de données est qu'elles divisent de manière répétée l'espace de recherche en partitions qui ne sont pas nécessairement de taille égale. Outre l'indexation spatiale, SP-GiST est utilisé pour accélérer les recherches sur de nombreux types de données, telles que le routage téléphonique, le routage ip, la recherche de substrats, etc. Pour plus d'informations, voir le <ulink url="https://www.postgresql.org/docs/current/spgist.html">manuel PostgreSQL</ulink>.

note: Tag: para
en: As it is the case for GiST indexes, SP-GiST indexes are lossy, in the sense that they store the bounding box enclosing spatial objects. SP-GiST indexes can be considered as an alternative to GiST indexes.
fr: Comme pour les index GiST, les index SP-GiST sont avec perte, dans le sens où ils stockent la boîte englobante qui entoure les objets spatiaux. Les index SP-GiST peuvent être considérés comme une alternative aux index GiST.

note: Tag: para
en: Once a GIS data table exceeds a few thousand rows, an SP-GiST index may be used to speed up spatial searches of the data. The syntax for building an SP-GiST index on a "geometry" column is as follows:
fr: Lorsqu'une table de données SIG dépasse quelques milliers de lignes, un index SP-GiST peut être utilisé pour accélérer les recherches spatiales dans les données. La syntaxe pour construire un index SP-GiST sur une colonne "géométrie" est la suivante :

note: Tag: para
en: The above syntax will build a 2-dimensional index. A 3-dimensional index for the geometry type can be created using the 3D operator class:
fr: La syntaxe ci-dessus permet de créer un index bidimensionnel. Un index tridimensionnel pour le type de géométrie peut être créé à l'aide de la classe d'opérateurs 3D :

note: Tag: para
en: Building a spatial index is a computationally intensive operation. It also blocks write access to your table for the time it creates, so on a production system you may want to do in in a slower CONCURRENTLY-aware way:
fr: La création d'un index spatial est une opération très gourmande en ressources informatiques. Elle bloque également l'accès en écriture à votre table pendant la durée de la création, donc sur un système de production, vous voudrez peut-être le faire d'une manière plus lente, en tenant compte de la notion de CONCURRENCE :

note: Tag: para
en: An SP-GiST index can accelerate queries involving the following operators:
fr: Un index SP-GiST peut accélérer les requêtes impliquant les opérateurs suivants :

note: Tag: para
en: &lt;&lt;, &amp;&lt;, &amp;&gt;, &gt;&gt;, &lt;&lt;|, &amp;&lt;|, |&amp;&gt;, |&gt;&gt;, &amp;&amp;, @&gt;, &lt;@, and ~=, for 2-dimensional indexes,
fr: &lt;&lt;, &amp;&lt;, &amp;&gt;, &gt;&gt;, &lt;&lt;|, &amp;&lt;|, |&amp;&gt;, |&gt;&gt;, &amp;&amp;, @&gt;, &lt;@, et ~=, pour les index à 2 dimensions,

note: Tag: para
en: &amp;/&amp;, ~==, @&gt;&gt;, and &lt;&lt;@, for 3-dimensional indexes.
fr: &amp;/&amp;, ~==, @&gt;&gt;, et &lt;&lt;@, pour les index à 3 dimensions.

note: Tag: para
en: There is no support for kNN searches at the moment.
fr: Il n'y a pas de support pour les recherches kNN pour le moment.

note: Tag: title
en: Tuning Index Usage
fr: Optimisation de l'utilisation de l'index

note: Tag: para
en: Ordinarily, indexes invisibly speed up data access: once an index is built, the PostgreSQL query planner automatically decides when to use it to improve query performance. But there are some situations where the planner does not choose to use existing indexes, so queries end up using slow sequential scans instead of a spatial index.
fr: Normalement, les index accélèrent de manière invisible l'accès aux données : une fois qu'un index est construit, le planificateur de requêtes de PostgreSQL décide automatiquement quand l'utiliser pour améliorer les performances de la requête. Mais dans certaines situations, le planificateur ne choisit pas d'utiliser les index existants, et les requêtes finissent par utiliser des balayages séquentiels lents au lieu d'un index spatial.

note: Tag: para
en: If you find your spatial indexes are not being used, there are a few things you can do:
fr: Si vous constatez que vos index spatiaux ne sont pas utilisés, il y a plusieurs choses que vous pouvez faire :

note: Tag: para
en: Examine the query plan and check your query actually computes the thing you need. An erroneous JOIN, either forgotten or to the wrong table, can unexpectedly retrieve table records multiple times. To get the query plan, execute with <code>EXPLAIN</code> in front of the query.
fr: Examinez le plan de requête et vérifiez que votre requête calcule effectivement ce dont vous avez besoin. Un JOIN erroné, oublié ou vers la mauvaise table, peut récupérer plusieurs fois des enregistrements de la table de manière inattendue. Pour obtenir le plan de la requête, exécutez avec <code>EXPLAIN</code> devant la requête.

note: Tag: para
en: Make sure statistics are gathered about the number and distributions of values in a table, to provide the query planner with better information to make decisions around index usage. <command>VACUUM ANALYZE</command> will compute both.
fr: Assurez-vous que des statistiques sont collectées sur le nombre et la distribution des valeurs dans une table, afin de fournir au planificateur de requêtes de meilleures informations pour prendre des décisions concernant l'utilisation de l'index. La <command>VACUUM ANALYZE</command> calculera les deux.

note: Tag: para
en: You should regularly vacuum your databases anyways. Many PostgreSQL DBAs run <command>VACUUM</command> as an off-peak cron job on a regular basis.
fr: Vous devriez de toute façon vacuum régulièrement vos bases de données. De nombreux administrateurs de bases de données PostgreSQL exécutent <command>VACUUM</command> en tant que tâche cron en dehors des heures de pointe sur une base régulière.

note: Tag: para
en: If vacuuming does not help, you can temporarily force the planner to use the index information by using the command <command>SET ENABLE_SEQSCAN TO OFF;</command>. This way you can check whether the planner is at all able to generate an index-accelerated query plan for your query. You should only use this command for debugging; generally speaking, the planner knows better than you do about when to use indexes. Once you have run your query, do not forget to run <command>SET ENABLE_SEQSCAN TO ON;</command> so that the planner will operate normally for other queries.
fr: Si vacuum ne suffit pas, vous pouvez temporairement forcer le planificateur à utiliser les informations d'index en utilisant la commande <command>SET ENABLE_SEQSCAN TO OFF;</command>. De cette façon, vous pouvez vérifier si le planificateur est capable de générer un plan de requête accéléré par l'index pour votre requête. Vous ne devez utiliser cette commande qu'à des fins de débogage ; en règle générale, le planificateur sait mieux que vous quand utiliser les index. Une fois que vous avez exécuté votre requête, n'oubliez pas de lancer la commande <command>SET ENABLE_SEQSCAN TO ON;</command> afin que le planificateur fonctionne normalement pour les autres requêtes.

note: Tag: para
en: If <command>SET ENABLE_SEQSCAN TO OFF;</command> helps your query to run faster, your Postgres is likely not tuned for your hardware. If you find the planner wrong about the cost of sequential versus index scans try reducing the value of <varname>RANDOM_PAGE_COST</varname> in <code>postgresql.conf</code>, or use <command>SET RANDOM_PAGE_COST TO 1.1;</command>. The default value for <varname>RANDOM_PAGE_COST</varname> is 4.0. Try setting it to 1.1 (for SSD) or 2.0 (for fast magnetic disks). Decreasing the value makes the planner more likely to use index scans.
fr: Si <command>SET ENABLE_SEQSCAN TO OFF;</command> aide votre requête à s'exécuter plus rapidement, votre Postgres n'est probablement pas adapté à votre matériel. Si vous trouvez que le planificateur se trompe sur le coût des balayages séquentiels par rapport aux balayages d'index, essayez de réduire la valeur de <varname>RANDOM_PAGE_COST</varname> dans <code>postgresql.conf</code>, ou utilisez <command>SET RANDOM_PAGE_COST TO 1.1;</command>. La valeur par défaut de <varname>RANDOM_PAGE_COST</varname> est 4.0. Essayez de la fixer à 1.1 (pour les disques SSD) ou à 2.0 (pour les disques magnétiques rapides). En diminuant la valeur, le planificateur est plus enclin à utiliser les balayages d'index.

note: Tag: para
en: If <command>SET ENABLE_SEQSCAN TO OFF;</command> does not help your query, the query may be using a SQL construct that the Postgres planner is not yet able to optimize. It may be possible to rewrite the query in a way that the planner is able to handle. For example, a subquery with an inline SELECT may not produce an efficient plan, but could possibly be rewritten using a LATERAL JOIN.
fr: Si la <command>SET ENABLE_SEQSCAN TO OFF;</command> n'aide pas votre requête, il se peut qu'elle utilise une construction SQL que le planificateur Postgres n'est pas encore en mesure d'optimiser. Il peut être possible de réécrire la requête de manière à ce que le planificateur soit en mesure de la traiter. Par exemple, une sous-requête avec un SELECT en ligne peut ne pas produire un plan efficace, mais peut être réécrite en utilisant un JOIN LATERAL.

note: Tag: para
en: For more information see the Postgres manual section on <ulink url="https://www.postgresql.org/docs/current/runtime-config-query.html">Query Planning</ulink>.
fr: Pour plus d'informations, voir la section du manuel Postgres sur <ulink url="https://www.postgresql.org/docs/current/runtime-config-query.html">Query Planning</ulink>.
