postgis 3.5 - en to fr translation catalogue (4753 entries)

note: Tag: title
en: PostGIS Administration
fr: Administration de PostGIS

note: Tag: title
en: Configuring raster support
fr: Configurer la prise en charge du raster

note: Tag: para
en: If you enabled raster support you may want to read below how to properly configure it.
fr: Si vous activez la prise en charge du raster, vous devriez lire ce qui suit afin de bien la configurer.

note: Tag: para
en: As of PostGIS 2.1.3, out-of-db rasters and all raster drivers are disabled by default. In order to re-enable these, you need to set the following environment variables <varname>POSTGIS_GDAL_ENABLED_DRIVERS</varname> and <varname>POSTGIS_ENABLE_OUTDB_RASTERS</varname> in the server environment. For PostGIS 2.2, you can use the more cross-platform approach of setting the corresponding <xref linkend="PostGIS_GUC"/>.
fr: À partir de PostGIS 2.1.3, tous les pilotes raster, et la prise en charge des rasters hors-connexion (out-of-db) est désactivé par défaut. Pour les activer, vous devez définir les variables d'environnement suivantes dans l'environnement du serveur : <varname>POSTGIS_GDAL_ENABLED_DRIVERS</varname> and <varname>POSTGIS_ENABLE_OUTDB_RASTERS</varname>. Depuis PostGIS 2.2, vous pouvez utiliser la méthode plus générique en définissant les <xref linkend="PostGIS_GUC"/> correspondantes.

note: Tag: para
en: If you want to enable offline raster:
fr: Si vous souhaitez activer le raster hors connexion :

note: Tag: para
en: Any other setting or no setting at all will disable out of db rasters.
fr: Si la variable a n'importe quelle autre valeur, ou si elle n'a pas de valeur, le support du raster hors-connexion sera désactivé.

note: Tag: para
en: In order to enable all GDAL drivers available in your GDAL install, set this environment variable as follows
fr: Pour utiliser tous les pilotes GDAL disponibles dans votre installation GDAL, définissez la variable d'environnement via

note: Tag: para
en: If you want to only enable specific drivers, set your environment variable as follows:
fr: Si vous souhaitez activer une liste de pilotes spécifiques, définissez la variable d'environnement via :

note: Tag: para
en: If you are on windows, do not quote the driver list
fr: Si vous êtes sous Windows, ne pas mettre de guillemets autour de la liste des pilotes

note: Tag: para
en: Setting environment variables varies depending on OS. For PostgreSQL installed on Ubuntu or Debian via apt-postgresql, the preferred way is to edit <filename>/etc/postgresql/<replaceable>10</replaceable>/<replaceable>main</replaceable>/environment</filename> where 10 refers to version of PostgreSQL and main refers to the cluster.
fr: La définition des variables d'environnement dépend de votre système d'exploitation. Sous Ubuntu ou Debian avec PostgreSQL installé via apt-postgresql, la méthode conseillée est d'éditer le fichier de configuration <filename>/etc/postgresql/<replaceable>10</replaceable>/<replaceable>main</replaceable>/environment</filename> où 10 est la version de PostgreSQL et main est le groupe de bases de données (cluster).

note: Tag: para
en: On windows, if you are running as a service, you can set via System variables which for Windows 7 you can get to by right-clicking on Computer-&gt;Properties Advanced System Settings or in explorer navigating to <varname>Control Panel\All Control Panel Items\System</varname>. Then clicking <emphasis>Advanced System Settings -&gt;Advanced-&gt;Environment Variables</emphasis> and adding new system variables.
fr: Sous Windows, si vous fonctionnez en tant que service, vous pouvez définir des variables système auxquelles vous pouvez accéder, sous Windows 7, en cliquant avec le bouton droit de la souris sur Ordinateur -&gt;Propriétés - Paramètres système avancés ou, dans l'explorateur, en naviguant jusqu'à <varname>Panneau de configuration - Tous les éléments du panneau de configuration - Système</varname>. Cliquez ensuite sur <emphasis>Advanced System Settings -&gt;Advanced-&gt;Environment Variables</emphasis> et ajoutez de nouvelles variables système.

note: Tag: para
en: After you set the environment variables, you'll need to restart your PostgreSQL service for the changes to take effect.
fr: Après avoir changé les variables d'environnement, vous devrez redémarrer le service PostgreSQL pour prendre en compte les changements.

note: Tag: title
en: Creating spatial databases
fr: Création de bases de données spatiales

note: Tag: title
en: Spatially enable database using EXTENSION
fr: Base de données spatiale en utilisant EXTENSION

note: Tag: para
en: If you are using PostgreSQL 9.1+ and have compiled and installed the extensions/postgis modules, you can turn a database into a spatial one using the EXTENSION mechanism.
fr: Si vous utilisez PostgreSQL 9.1+ et avez compilé et installé les modules extensions/postgis, vous pouvez transformer une base de données en base de données spatiale en utilisant le mécanisme EXTENSION.

note: Tag: para
en: Core postgis extension includes geometry, geography, spatial_ref_sys and all the functions and comments. Raster and topology are packaged as a separate extension.
fr: L'extension cœur postgis inclus le support des types geometry et geography, la table spatial_ref_sys ainsi que toutes les fonctions et commentaires. Les supports de raster et topologie sont fournis par des extensions dédiées.

note: Tag: para
en: Run the following SQL snippet in the database you want to enable spatially:
fr: Exécutez les requêtes SQL suivantes dans la base de données où vous souhaitez activer le support spatial :

note: Tag: title
en: Spatially enable database without using EXTENSION (discouraged)
fr: Base de données spatiale sans utiliser EXTENSION (non recommandé)

note: Tag: para
en: This is generally only needed if you cannot or don't want to get PostGIS installed in the PostgreSQL extension directory (for example during testing, development or in a restricted environment).
fr: Cette méthode n'est en générale nécessaire que si vous ne pouvez pas ou ne voulez pas que PostGIS soit installé dans le répertoire des extensions PostgreSQL (par exemple pour des tests, du développement, ou dans un environnement restreint).

note: Tag: para
en: Adding PostGIS objects and function definitions into your database is done by loading the various sql files located in <filename>[prefix]/share/contrib</filename> as specified during the build phase.
fr: L'ajout des objets et définitions des fonctions PostGIS dans votre base de données se fait en chargeant plusieurs fichiers sql présents dans <filename>[prefix]/share/contrib</filename>, cet emplacement est celui qui a été défini durant la phase de compilation.

note: Tag: para
en: The core PostGIS objects (geometry and geography types, and their support functions) are in the <filename>postgis.sql</filename> script. Raster objects are in the <filename>rtpostgis.sql</filename> script. Topology objects are in the <filename>topology.sql</filename> script.
fr: Les objets au cœur de PostGIS (types geometry et geography, et les fonctions associées) sont dans le script <filename>postgis.sql</filename>. Les objets raster sont dans le script <filename>rtpostgis.sql</filename>. Les objets de topologie sont dans le script <filename>topology.sql</filename>.

note: Tag: para
en: For a complete set of EPSG coordinate system definition identifiers, you can also load the <filename>spatial_ref_sys.sql</filename> definitions file and populate the <varname>spatial_ref_sys</varname> table. This will permit you to perform ST_Transform() operations on geometries.
fr: Pour avoir la liste complète des définitions des systèmes de coordonnées EPSG, vous pouvez aussi charger le script <filename>spatial_ref_sys.sql</filename> pour remplir la table <varname>spatial_ref_sys</varname>. Cela permettre d'utiliser la fonction ST_Transform() pour effectuer des reprojections sur les géométries.

note: Tag: para
en: If you wish to add comments to the PostGIS functions, you can find them in the <filename>postgis_comments.sql</filename> script. Comments can be viewed by simply typing <command>\dd [function_name]</command> from a <command>psql</command> terminal window.
fr: Si vous souhaitez ajouter les commentaires sur les fonctions PostGIS, vous pouvez les trouver dans le script <filename>postgis_comments.sql</filename>. Vous pouvez accéder aux commentaires d'une fonction en tapant <command>\dd [nom_de_la_fonction]</command> depuis un terminal <command>psql</command>.

note: Tag: para
en: Run the following Shell commands in your terminal:
fr: Exécutez les commandes Shell suivantes dans votre terminal :

note: Tag: title
en: Upgrading spatial databases
fr: Mise à jour des bases de données spatiales

note: Tag: para
en: Upgrading existing spatial databases can be tricky as it requires replacement or introduction of new PostGIS object definitions.
fr: La mise à jour des bases de données spatiales existantes peut s'avérer délicate car elle nécessite le remplacement ou l'introduction de nouvelles définitions d'objets PostGIS.

note: Tag: para
en: Unfortunately not all definitions can be easily replaced in a live database, so sometimes your best bet is a dump/reload process.
fr: Malheureusement, toutes les définitions ne peuvent pas être facilement remplacées dans une base de données active, de sorte que la meilleure solution consiste parfois à effectuer un processus de dump/rechargement.

note: Tag: para
en: PostGIS provides a SOFT UPGRADE procedure for minor or bugfix releases, and a HARD UPGRADE procedure for major releases.
fr: PostGIS propose une procédure SOFT UPGRADE pour les versions mineures ou les corrections de bugs, et une procédure HARD UPGRADE pour les versions majeures.

note: Tag: para
en: Before attempting to upgrade PostGIS, it is always worth to backup your data. If you use the -Fc flag to pg_dump you will always be able to restore the dump with a HARD UPGRADE.
fr: Avant d'essayer de mettre à jour PostGIS, il est toujours utile de sauvegarder vos données. Si vous utilisez l'option -Fc pour pg_dump, vous serez toujours en mesure de restaurer le dump lors d'un HARD UPGRADE.

note: Tag: title
en: Soft upgrade
fr: Mise à niveau progressive (Soft upgrade)

note: Tag: para
en: If you installed your database using extensions, you'll need to upgrade using the extension model as well. If you installed using the old sql script way, you are advised to switch your install to extensions because the script way is no longer supported.
fr: Si vous avez installé votre base de données en utilisant des extensions, vous devrez également mettre à jour en utilisant le modèle d'extension. Si vous avez installé votre base de données à l'aide de l'ancien script SQL, il vous est conseillé de passer à l'extension car le script n'est plus pris en charge.

note: Tag: title
en: Soft Upgrade 9.1+ using extensions
fr: Mise à niveau progressive (Soft upgrade) 9.1+ utilisant des extensions

note: Tag: para
en: If you originally installed PostGIS with extensions, then you need to upgrade using extensions as well. Doing a minor upgrade with extensions, is fairly painless.
fr: Si vous avez installé PostGIS à l'origine avec des extensions, vous devez également effectuer une mise à jour en utilisant des extensions. Faire une mise à jour mineure avec les extensions est assez facile.

note: Tag: para
en: If you are running PostGIS 3 or above, then you should use the <xref linkend="PostGIS_Extensions_Upgrade"/> function to upgrade to the latest version you have installed.
fr: Si vous utilisez PostGIS 3 ou une version supérieure, vous devez utiliser la fonction <xref linkend="PostGIS_Extensions_Upgrade"/> pour passer à la dernière version que vous avez installée.

note: Tag: para
en: If you are running PostGIS 2.5 or lower, then do the following:
fr: Si vous utilisez PostGIS 2.5 ou une version inférieure, procédez comme suit :

note: Tag: para
en: If you have multiple versions of PostGIS installed, and you don't want to upgrade to the latest, you can explicitly specify the version as follows:
fr: Si plusieurs versions de PostGIS sont installées et que vous ne souhaitez pas mettre à niveau vers la dernière version, vous pouvez spécifier explicitement la version comme suit :

note: Tag: para
en: If you get an error notice something like:
fr: Si vous obtenez un message d'erreur du type :

note: Tag: para
en: Then you'll need to backup your database, create a fresh one as described in <xref linkend="create_new_db_extensions"/> and then restore your backup on top of this new database.
fr: Vous devrez alors sauvegarder votre base de données, en créer une nouvelle comme décrit dans <xref linkend="create_new_db_extensions"/>, puis restaurer votre sauvegarde sur cette nouvelle base de données.

note: Tag: para
en: If you get a notice message like:
fr: Si vous obtenez un message du type :

note: Tag: para
en: Then everything is already up to date and you can safely ignore it. <emphasis role="bold">UNLESS</emphasis> you're attempting to upgrade from an development version to the next (which doesn't get a new version number); in that case you can append "next" to the version string, and next time you'll need to drop the "next" suffix again:
fr: Dans ce cas, tout est déjà à jour et vous pouvez l'ignorer en toute sécurité. <emphasis role="bold">Sauf</emphasis> vous essayez de passer d'une version de développement à la suivante (qui ne reçoit pas de nouveau numéro de version) ; dans ce cas, vous pouvez ajouter "next" à la chaîne de caractères de la version, et la prochaine fois, vous devrez à nouveau supprimer le suffixe "next" :

note: Tag: para
en: If you installed PostGIS originally without a version specified, you can often skip the reinstallation of postgis extension before restoring since the backup just has <code>CREATE EXTENSION postgis</code> and thus picks up the newest latest version during restore.
fr: Si vous avez installé PostGIS à l'origine sans spécifier de version, vous pouvez souvent ignorer la réinstallation de l'extension postgis avant la restauration puisque la sauvegarde a juste exécuté <code>CREATE EXTENSION postgis</code> et récupère donc la dernière version la plus récente lors de la restauration.

note: Tag: para
en: If you are upgrading PostGIS extension from a version prior to 3.0.0, you will have a new extension <emphasis>postgis_raster</emphasis> which you can safely drop, if you don't need raster support. You can drop as follows:
fr: Si vous mettez à jour l'extension PostGIS à partir d'une version antérieure à 3.0.0, vous aurez une nouvelle extension <emphasis>postgis_raster</emphasis> que vous pouvez abandonner en toute sécurité, si vous n'avez pas besoin du support raster. Vous pouvez abandonner l'extension comme suit :

note: Tag: title
en: Soft Upgrade Pre 9.1+ or without extensions
fr: Mise à niveau progressive (Soft Upgrade) Pre 9.1+ ou sans extensions

note: Tag: para
en: This section applies only to those who installed PostGIS not using extensions. If you have extensions and try to upgrade with this approach you'll get messages like:
fr: Cette section ne s'applique qu'à ceux qui ont installé PostGIS sans utiliser d'extensions. Si vous avez des extensions et que vous essayez de faire une mise à jour avec cette approche, vous obtiendrez des messages comme :

note: Tag: para
en: NOTE: if you are moving from PostGIS 1.* to PostGIS 2.* or from PostGIS 2.* prior to r7409, you cannot use this procedure but would rather need to do a <link linkend="hard_upgrade">HARD UPGRADE</link>.
fr: NOTE : si vous passez de PostGIS 1.* à PostGIS 2.* ou de PostGIS 2.* antérieur à r7409, vous ne pouvez pas utiliser cette procédure mais devrez plutôt faire une <link linkend="hard_upgrade">HARD UPGRADE</link>.

note: Tag: para
en: After compiling and installing (make install) you should find a set of <filename>*_upgrade.sql</filename> files in the installation folders. You can list them all with:
fr: Après la compilation et l'installation (make install), vous devriez trouver un ensemble de fichiers <filename>*_upgrade.sql</filename> dans les dossiers d'installation. Vous pouvez les lister avec :

note: Tag: para
en: Load them all in turn, starting from <filename>postgis_upgrade.sql</filename>.
fr: Chargez-les tous à tour de rôle, en commençant par <filename>postgis_upgrade.sql</filename>.

note: Tag: para
en: The same procedure applies to raster, topology and sfcgal extensions, with upgrade files named <filename>rtpostgis_upgrade.sql</filename>, <filename>topology_upgrade.sql</filename> and <filename>sfcgal_upgrade.sql</filename> respectively. If you need them:
fr: La même procédure s'applique aux extensions raster, topologie et sfcgal, avec des fichiers de mise à niveau nommés respectivement <filename>rtpostgis_upgrade.sql</filename>, <filename>topology_upgrade.sql</filename> et <filename>sfcgal_upgrade.sql</filename>. Si vous en avez besoin :

note: Tag: para
en: You are advised to switch to an extension based install by running
fr: Il est conseillé de passer à une installation basée sur l'extension en lançant

note: Tag: para
en: If you can't find the <filename>postgis_upgrade.sql</filename> specific for upgrading your version you are using a version too early for a soft upgrade and need to do a <link linkend="hard_upgrade">HARD UPGRADE</link>.
fr: Si vous ne trouvez pas le <filename>postgis_upgrade.sql</filename> spécifique à la mise à niveau de votre version, vous utilisez une version trop ancienne pour une mise à niveau progressive (Soft Upgrade) et vous devez faire une <link linkend="hard_upgrade">HARD UPGRADE</link>.

note: Tag: para
en: The <xref linkend="PostGIS_Full_Version"/> function should inform you about the need to run this kind of upgrade using a "procs need upgrade" message.
fr: La fonction <xref linkend="PostGIS_Full_Version"/> devrait vous informer de la nécessité d'exécuter ce type de mise à niveau à l'aide d'un message "procs need upgrade".

note: Tag: title
en: Hard upgrade
fr: Mise à niveau complète (Hard upgrade)

note: Tag: para
en: By HARD UPGRADE we mean full dump/reload of postgis-enabled databases. You need a HARD UPGRADE when PostGIS objects' internal storage changes or when SOFT UPGRADE is not possible. The <link linkend="release_notes">Release Notes</link> appendix reports for each version whether you need a dump/reload (HARD UPGRADE) to upgrade.
fr: Par HARD UPGRADE, nous entendons un dump/recharge complet des bases de données compatibles avec PostGIS. Vous avez besoin d'une mise à jour complète lorsque le stockage interne des objets PostGIS change ou lorsque la mise à jour progressive (Soft upgrade) n'est pas possible. L'annexe <link linkend="release_notes">Release Notes</link> indique pour chaque version si vous avez besoin d'un dump/recharge (HARD UPGRADE) pour effectuer la mise à jour.

note: Tag: para
en: The dump/reload process is assisted by the postgis_restore script which takes care of skipping from the dump all definitions which belong to PostGIS (including old ones), allowing you to restore your schemas and data into a database with PostGIS installed without getting duplicate symbol errors or bringing forward deprecated objects.
fr: Le processus de dump/rechargement est assisté par le script postgis_restore.pl qui se charge de sauter du dump toutes les définitions qui appartiennent à PostGIS (y compris les anciennes), ce qui vous permet de restaurer vos schémas et vos données dans une base de données où PostGIS est installé sans obtenir d'erreurs de symboles dupliqués ou d'avancer des objets obsolètes.

note: Tag: para
en: Supplementary instructions for windows users are available at <link xlink:href="http://trac.osgeo.org/postgis/wiki/UsersWikiWinUpgrade">Windows Hard upgrade</link>.
fr: Des instructions supplémentaires pour les utilisateurs de Windows sont disponibles sur <link xlink:href="http://trac.osgeo.org/postgis/wiki/UsersWikiWinUpgrade">Windows Hard upgrade</link>.

note: Tag: para
en: The Procedure is as follows:
fr: La procédure est la suivante :

note: Tag: para
en: Create a "custom-format" dump of the database you want to upgrade (let's call it <varname>olddb</varname>) include binary blobs (-b) and verbose (-v) output. The user can be the owner of the db, need not be postgres super account.
fr: Créer un dump au format personnalisé de la base de données que vous souhaitez mettre à jour (appelons-le <varname>olddb</varname>) et inclure des blobs binaires (-b) et une sortie verbose (-v). L'utilisateur peut être le propriétaire de la base de données, il n'a pas besoin d'être le super utilisateur postgres.

note: Tag: para
en: Do a fresh install of PostGIS in a new database -- we'll refer to this database as <varname>newdb</varname>. Please refer to <xref linkend="create_new_db"/> and <xref linkend="create_new_db_extensions"/> for instructions on how to do this.
fr: Effectuez une nouvelle installation de PostGIS dans une nouvelle base de données - nous appellerons cette base de données <varname>newdb</varname>. Veuillez vous référer à <xref linkend="create_new_db"/> et <xref linkend="create_new_db_extensions"/> pour les instructions sur la façon de procéder.

note: Tag: para
en: The spatial_ref_sys entries found in your dump will be restored, but they will not override existing ones in spatial_ref_sys. This is to ensure that fixes in the official set will be properly propagated to restored databases. If for any reason you really want your own overrides of standard entries just don't load the spatial_ref_sys.sql file when creating the new db.
fr: Les entrées spatial_ref_sys trouvées dans votre dump seront restaurées, mais elles ne remplaceront pas les entrées existantes dans spatial_ref_sys. Cela permet de s'assurer que les corrections du jeu officiel seront correctement propagées dans les bases de données restaurées. Si, pour une raison quelconque, vous souhaitez vraiment que vos propres entrées standard soient remplacées, ne chargez pas le fichier spatial_ref_sys.sql lors de la création de la nouvelle base de données.

note: Tag: para
en: If your database is really old or you know you've been using long deprecated functions in your views and functions, you might need to load <filename>legacy.sql</filename> for all your functions and views etc. to properly come back. Only do this if _really_ needed. Consider upgrading your views and functions before dumping instead, if possible. The deprecated functions can be later removed by loading <filename>uninstall_legacy.sql</filename>.
fr: Si votre base de données est très ancienne ou si vous savez que vous avez utilisé des fonctions dépréciées depuis longtemps dans vos vues et fonctions, vous devrez peut-être charger <filename>legacy.sql</filename> pour que toutes vos fonctions, vues, etc. reviennent correctement. Ne le faites que si c'est _vraiment_ nécessaire. Envisagez plutôt de mettre à jour vos vues et fonctions avant de faire le dumping, si possible. Les fonctions dépréciées peuvent être supprimées plus tard en chargeant <filename>uninstall_legacy.sql</filename>.

note: Tag: para
en: Restore your backup into your fresh <varname>newdb</varname> database using postgis_restore. Unexpected errors, if any, will be printed to the standard error stream by psql. Keep a log of those.
fr: Restaurez votre sauvegarde dans votre nouvelle base de données <varname>newdb</varname> à l'aide de postgis_restore. Les erreurs inattendues, s'il y en a, seront imprimées par psql dans le flux d'erreurs standard. Conservez un journal de ces erreurs.

note: Tag: para
en: Errors may arise in the following cases:
fr: Des erreurs peuvent survenir dans les cas suivants :

note: Tag: para
en: Some of your views or functions make use of deprecated PostGIS objects. In order to fix this you may try loading <filename>legacy.sql</filename> script prior to restore or you'll have to restore to a version of PostGIS which still contains those objects and try a migration again after porting your code. If the <filename>legacy.sql</filename> way works for you, don't forget to fix your code to stop using deprecated functions and drop them loading <filename>uninstall_legacy.sql</filename>.
fr: Certaines de vos vues ou fonctions utilisent des objets PostGIS obsolètes. Pour y remédier, vous pouvez essayer de charger le script <filename>legacy.sql</filename> avant la restauration ou vous devrez restaurer vers une version de PostGIS qui contient encore ces objets et réessayer une migration après le portage de votre code. Si la méthode <filename>legacy.sql</filename> fonctionne pour vous, n'oubliez pas de corriger votre code pour arrêter d'utiliser les fonctions dépréciées et de les supprimer en chargeant <filename>uninstall_legacy.sql</filename>.

note: Tag: para
en: Some custom records of spatial_ref_sys in dump file have an invalid SRID value. Valid SRID values are bigger than 0 and smaller than 999000. Values in the 999000.999999 range are reserved for internal use while values &gt; 999999 can't be used at all. All your custom records with invalid SRIDs will be retained, with those &gt; 999999 moved into the reserved range, but the spatial_ref_sys table would lose a check constraint guarding for that invariant to hold and possibly also its primary key ( when multiple invalid SRIDS get converted to the same reserved SRID value ).
fr: Certains enregistrements personnalisés de spatial_ref_sys dans le fichier dump ont une valeur SRID invalide. Les valeurs SRID valides sont supérieures à 0 et inférieures à 999000. Les valeurs comprises entre 999000 et 999999 sont réservées à un usage interne, tandis que les valeurs &gt; 999999 ne peuvent pas être utilisées du tout. Tous vos enregistrements personnalisés avec des SRID invalides seront conservés, avec les valeurs &gt; 999999 déplacées dans la plage réservée, mais la table spatial_ref_sys perdrait une contrainte de contrôle qui protège cet invariant et peut-être aussi sa clé primaire (lorsque plusieurs SRIDS invalides sont convertis en la même valeur SRID réservée).

note: Tag: para
en: In order to fix this you should copy your custom SRS to a SRID with a valid value (maybe in the 910000..910999 range), convert all your tables to the new srid (see <xref linkend="UpdateGeometrySRID"/>), delete the invalid entry from spatial_ref_sys and re-construct the check(s) with:
fr: Pour résoudre ce problème, vous devez copier votre SRS personnalisé vers un SRID avec une valeur valide (peut-être dans la plage 910000..910999), convertir toutes vos tables vers le nouveau SRID (voir <xref linkend="UpdateGeometrySRID"/>), supprimer l'entrée invalide de spatial_ref_sys et reconstruire le(s) contrôle(s) avec :

note: Tag: para
en: If you are upgrading an old database containing french <link xlink:href="https://en.wikipedia.org/wiki/Institut_g%C3%A9ographique_national"> IGN </link> cartography, you will have probably SRIDs out of range and you will see, when importing your database, issues like this :
fr: Si vous mettez à jour une ancienne base de données contenant une cartographie française <link xlink:href="https://en.wikipedia.org/wiki/Institut_g%C3%A9ographique_national"> IGN </link>, vous aurez probablement des SRID hors limites et vous verrez, lors de l'importation de votre base de données, des problèmes comme celui-ci :

note: Tag: para
en: In this case, you can try following steps : first throw out completely the IGN from the sql which is resulting from postgis_restore. So, after having run :
fr: Dans ce cas, vous pouvez essayer les étapes suivantes : d'abord supprimer complètement l'IGN du sql qui résulte de postgis_restore. Ainsi, après avoir exécuté :

note: Tag: para
en: run this command :
fr: Exécutez cette commande :

note: Tag: para
en: Create then your newdb, activate the required Postgis extensions, and insert properly the french system IGN with : <link xlink:href="https://raw.githubusercontent.com/Remi-C/IGN_spatial_ref_for_PostGIS/master/Put_IGN_SRS_into_Postgis.sql"> this script </link> After these operations, import your data :
fr: Créez ensuite votre newdb, activez les extensions Postgis nécessaires, et insérez correctement l'IGN du système français avec : <link xlink:href="https://raw.githubusercontent.com/Remi-C/IGN_spatial_ref_for_PostGIS/master/Put_IGN_SRS_into_Postgis.sql"> ce script </link> Après ces opérations, importez vos données :

note: Tag: title
en: Performance Tuning
fr: Optimisation des performances

note: Tag: para
en: Tuning for PostGIS performance is much like tuning for any PostgreSQL workload. The only additional consideration is that geometries and rasters are usually large, so memory-related optimizations generally have more of an impact on PostGIS than other types of PostgreSQL queries.
fr: Le réglage des performances de PostGIS est similaire à celui de n'importe quelle charge de travail PostgreSQL. La seule considération supplémentaire est que les géométries et les rasters sont généralement de grande taille, donc les optimisations liées à la mémoire ont généralement plus d'impact sur PostGIS que sur d'autres types de requêtes PostgreSQL.

note: Tag: para
en: For general details about optimizing PostgreSQL, refer to <link xlink:href="https://wiki.postgresql.org/wiki/Tuning_Your_PostgreSQL_Server">Tuning your PostgreSQL Server</link>.
fr: Pour plus de détails sur l'optimisation de PostgreSQL, reportez-vous à <link xlink:href="https://wiki.postgresql.org/wiki/Tuning_Your_PostgreSQL_Server">Tuning your PostgreSQL Server</link>.

note: Tag: para
en: For PostgreSQL 9.4+ configuration can be set at the server level without touching <code>postgresql.conf</code> or <code>postgresql.auto.conf</code> by using the <code>ALTER SYSTEM</code> command.
fr: Pour PostgreSQL 9.4+, la configuration peut être définie au niveau du serveur sans toucher à <code>postgresql.conf</code> ou <code>postgresql.auto.conf</code> en utilisant la commande <code>ALTER SYSTEM</code>.

note: Tag: para
en: In addition to the Postgres settings, PostGIS has some custom settings which are listed in <xref linkend="PostGIS_GUC"/>.
fr: En plus des paramètres de Postgres, PostGIS a quelques paramètres personnalisés qui sont listés dans <xref linkend="PostGIS_GUC"/>.

note: Tag: title
en: Startup
fr: Démarrage

note: Tag: para
en: These settings are configured in <code>postgresql.conf</code>:
fr: Ces paramètres sont configurés dans <code>postgresql.conf</code> :

note: Tag: para
en: Default: partition
fr: Valeur par défaut : partition

note: Tag: para
en: This is generally used for table partitioning. The default for this is set to "partition" which is ideal for PostgreSQL 8.4 and above since it will force the planner to only analyze tables for constraint consideration if they are in an inherited hierarchy and not pay the planner penalty otherwise.
fr: Ceci est généralement utilisé pour le partitionnement des tables. La valeur par défaut est "partition", ce qui est idéal pour PostgreSQL 8.4 et plus car cela force le planificateur à n'analyser les tables pour la prise en compte des contraintes que si elles sont dans une hiérarchie héritée et à ne pas payer de pénalité au planificateur dans le cas contraire.

note: Tag: para
en: Default: ~128MB in PostgreSQL 9.6
fr: Valeur par défaut : ~128MB dans PostgreSQL 9.6

note: Tag: para
en: Set to about 25% to 40% of available RAM. On windows you may not be able to set as high.
fr: Réglez-le à environ 25 à 40 % de la mémoire vive disponible. Sous Windows, il se peut que vous ne puissiez pas définir une valeur aussi élevée.

note: Tag: para
en: <link xlink:href="https://www.postgresql.org/docs/current/static/runtime-config-resource.html#GUC-MAX-WORKER-PROCESSES">max_worker_processes</link> This setting is only available for PostgreSQL 9.4+. For PostgreSQL 9.6+ this setting has additional importance in that it controls the max number of processes you can have for parallel queries.
fr: <link xlink:href="https://www.postgresql.org/docs/current/static/runtime-config-resource.html#GUC-MAX-WORKER-PROCESSES">max_worker_processes</link> Ce paramètre n'est disponible que pour PostgreSQL 9.4+. Pour PostgreSQL 9.6+, ce paramètre a une importance supplémentaire car il contrôle le nombre maximum de processus que vous pouvez avoir pour les requêtes parallèles.

note: Tag: para
en: Default: 8
fr: Valeur par défaut : 8

note: Tag: para
en: Sets the maximum number of background processes that the system can support. This parameter can only be set at server start.
fr: Définit le nombre maximum de processus d'arrière-plan que le système peut prendre en charge. Ce paramètre ne peut être défini qu'au démarrage du serveur.

note: Tag: title
en: Runtime
fr: Temps d'exécution

note: Tag: para
en: <link xlink:href="http://www.postgresql.org/docs/current/static/runtime-config-resource.html#GUC-WORK-MEM">work_mem</link> - sets the size of memory used for sort operations and complex queries
fr: <link xlink:href="http://www.postgresql.org/docs/current/static/runtime-config-resource.html#GUC-WORK-MEM">work_mem</link> - définit la taille de la mémoire utilisée pour les opérations de tri et les requêtes complexes

note: Tag: para
en: Default: 1-4MB
fr: Valeur par défaut : 1-4MB

note: Tag: para
en: Adjust up for large dbs, complex queries, lots of RAM
fr: Ajustement pour les grandes bases de données, les requêtes complexes, beaucoup de RAM

note: Tag: para
en: Adjust down for many concurrent users or low RAM.
fr: Ajuster à la baisse pour de nombreux utilisateurs simultanés ou une faible mémoire vive.

note: Tag: para
en: If you have lots of RAM and few developers:
fr: Si vous avez beaucoup de mémoire vive et peu de développeurs :

note: Tag: para
en: <link xlink:href="http://www.postgresql.org/docs/current/static/runtime-config-resource.html#GUC-MAINTENANCE-WORK-MEM">maintenance_work_mem</link> - the memory size used for VACUUM, CREATE INDEX, etc.
fr: <link xlink:href="http://www.postgresql.org/docs/current/static/runtime-config-resource.html#GUC-MAINTENANCE-WORK-MEM">maintenance_work_mem</link> - la taille de la mémoire utilisée pour VACUUM, CREATE INDEX, etc.

note: Tag: para
en: Default: 16-64MB
fr: Valeur par défaut : 16-64MB

note: Tag: para
en: Generally too low - ties up I/O, locks objects while swapping memory
fr: Généralement trop faible - immobilise les Entrées/Sorties, bloque les objets pendant l'échange de mémoire

note: Tag: para
en: Recommend 32MB to 1GB on production servers w/lots of RAM, but depends on the # of concurrent users. If you have lots of RAM and few developers:
fr: Nous recommandons 32MB à 1GB sur les serveurs de production avec beaucoup de RAM, mais cela dépend du nombre d'utilisateurs simultanés. Si vous avez beaucoup de RAM et peu de développeurs :

note: Tag: para
en: This setting is only available for PostgreSQL 9.6+ and will only affect PostGIS 2.3+, since only PostGIS 2.3+ supports parallel queries. If set to higher than 0, then some queries such as those involving relation functions like <code>ST_Intersects</code> can use multiple processes and can run more than twice as fast when doing so. If you have a lot of processors to spare, you should change the value of this to as many processors as you have. Also make sure to bump up <code>max_worker_processes</code> to at least as high as this number.
fr: Ce paramètre n'est disponible que pour PostgreSQL 9.6+ et n'affecte que PostGIS 2.3+, puisque seul PostGIS 2.3+ supporte les requêtes parallèles. Si ce paramètre est supérieur à 0, certaines requêtes telles que celles impliquant des fonctions de relation comme <code>ST_Intersects</code> peuvent utiliser plusieurs processus et s'exécuter plus de deux fois plus rapidement. Si vous avez beaucoup de processeurs à disposition, vous devriez changer la valeur de ce paramètre pour autant de processeurs que vous avez. Assurez-vous également d'augmenter <code>max_worker_processes</code> à une valeur au moins égale à ce nombre.

note: Tag: para
en: Default: 0
fr: Valeur par défaut : 0

note: Tag: para
en: Sets the maximum number of workers that can be started by a single <varname>Gather</varname> node. Parallel workers are taken from the pool of processes established by <varname>max_worker_processes</varname>. Note that the requested number of workers may not actually be available at run time. If this occurs, the plan will run with fewer workers than expected, which may be inefficient. Setting this value to 0, which is the default, disables parallel query execution.
fr: Définit le nombre maximum de workers qui peuvent être démarrés par un seul nœud <varname>Gather</varname>. Les workers parallèles sont pris dans le pool de processus établi par <varname>max_worker_processes</varname>. Notez que le nombre de workers demandé peut ne pas être disponible au moment de l'exécution. Dans ce cas, le plan s'exécutera avec moins de workers que prévu, ce qui peut s'avérer inefficace. La définition de cette valeur à 0, qui est la valeur par défaut, désactive l'exécution parallèle des requêtes.

note: Tag: para
en: This chapter documents features found in the extras folder of the PostGIS source tarballs and source repository. These are not always packaged with PostGIS binary releases, but are usually PL/pgSQL based or standard shell scripts that can be run as is.
fr: Ce chapitre documente les fonctionnalités trouvées dans le dossier extras des fichiers tarballs et du dépôt de sources de PostGIS. Celles-ci ne sont pas toujours packagées avec les versions binaires de PostGIS, mais sont généralement basées sur PL/pgSQL ou des scripts shell standard qui peuvent être exécutés tels quels.

note: Tag: para
en: This is a fork of the <link xlink:href="http://www.pagcgeo.org/docs/html/pagc-11.html">PAGC standardizer</link> (original code for this portion was <link xlink:href="http://sourceforge.net/p/pagc/code/360/tree/branches/sew-refactor/postgresql">PAGC PostgreSQL Address Standardizer</link>).
fr: Il s'agit d'un fork du <link xlink:href="http://www.pagcgeo.org/docs/html/pagc-11.html">PAGC standardizer</link> (le code original de cette partie était <link xlink:href="http://sourceforge.net/p/pagc/code/360/tree/branches/sew-refactor/postgresql">PAGC PostgreSQL Address Standardizer</link>).

note: Tag: para
en: The address standardizer is a single line address parser that takes an input address and normalizes it based on a set of rules stored in a table and helper lex and gaz tables.
fr: Address standardizer est un analyseur d'adresses qui prend une adresse en entrée et la normalise sur la base d'un ensemble de règles stockées dans une table et des tables d'aide lex et gaz.

note: Tag: para
en: The code is built into a single PostgreSQL extension library called <code>address_standardizer</code> which can be installed with <code>CREATE EXTENSION address_standardizer;</code>. In addition to the address_standardizer extension, a sample data extension called <code>address_standardizer_data_us</code> extensions is built, which contains gaz, lex, and rules tables for US data. This extensions can be installed via: <code>CREATE EXTENSION address_standardizer_data_us;</code>
fr: Le code est intégré dans une seule bibliothèque d'extension PostgreSQL appelée <code>address_standardizer</code> qui peut être installée avec <code>CREATE EXTENSION address_standardizer;</code>. En plus de l'extension address_standardizer, une extension de données d'exemple appelée <code>address_standardizer_data_us</code> extensions est construite, qui contient des tables de gaz, de lex et de règles pour les données américaines. Cette extension peut être installée via : <code>CREATE EXTENSION address_standardizer_data_us;</code>

note: Tag: para
en: The code for this extension can be found in the PostGIS <filename>extensions/address_standardizer</filename> and is currently self-contained.
fr: Le code de cette extension se trouve dans le <filename>extensions/address_standardizer</filename> de PostGIS et est actuellement indépendant.

note: Tag: para
en: For installation instructions refer to: <xref linkend="installing_pagc_address_standardizer"/>.
fr: Pour les instructions d'installation, voir : <xref linkend="installing_pagc_address_standardizer"/>.

note: Tag: title
en: How the Parser Works
fr: Fonctionnement de l'analyseur

note: Tag: para
en: The parser works from right to left looking first at the macro elements for postcode, state/province, city, and then looks micro elements to determine if we are dealing with a house number street or intersection or landmark. It currently does not look for a country code or name, but that could be introduced in the future.
fr: L'analyseur fonctionne de droite à gauche en examinant d'abord les macroéléments (code postal, état/province, ville), puis les microéléments afin de déterminer s'il s'agit d'un numéro de maison, d'une rue, d'une intersection ou d'un point de repère. Pour l'instant, il ne recherche pas le code ou le nom du pays, mais cela pourrait être introduit à l'avenir.

note: Tag: term
en: Country code
fr: Code pays

note: Tag: para
en: Assumed to be US or CA based on: postcode as US or Canada state/province as US or Canada else US
fr: On suppose qu'il s'agit des États-Unis ou du Canada sur la base des éléments suivants : code postal (États-Unis ou Canada), état/province (États-Unis ou Canada), autre (États-Unis)

note: Tag: term
en: Postcode/zipcode
fr: Code postal

note: Tag: para
en: These are recognized using Perl compatible regular expressions. These regexs are currently in the parseaddress-api.c and are relatively simple to make changes to if needed.
fr: Ils sont reconnus à l'aide d'expressions régulières compatibles avec Perl. Ces expressions régulières se trouvent actuellement dans le fichier parseaddress-api.c et sont relativement simples à modifier si nécessaire.

note: Tag: term
en: State/province
fr: État/province

note: Tag: para
en: These are recognized using Perl compatible regular expressions. These regexs are currently in the parseaddress-api.c but could get moved into includes in the future for easier maintenance.
fr: Ils sont reconnus à l'aide d'expressions régulières compatibles avec Perl. Ces expressions régulières sont actuellement dans le fichier parseaddress-api.c mais pourraient être déplacées dans includes dans le futur pour faciliter la maintenance.

note: Tag: title
en: Address Standardizer Types
fr: Types de normalisateurs d'adresses

note: Tag: para
en: This section lists the PostgreSQL data types installed by Address Standardizer extension. Note we describe the casting behavior of these which is very important especially when designing your own functions.
fr: Cette section liste les types de données PostgreSQL installés par l'extension Address Standardizer. Notez que nous décrivons le comportement de casting (transformation du type) de ces types de données, ce qui est très important, en particulier lors de la conception de vos propres fonctions.

note: Tag: refpurpose
en: A composite type that consists of the elements of an address. This is the return type for <varname>standardize_address</varname> function.
fr: Type composite composé des éléments d'une adresse. Il s'agit du type de retour de la fonction <varname>standardize_address</varname>.

note: Tag: para
en: A composite type that consists of elements of an address. This is the return type for <xref linkend="standardize_address"/> function. Some descriptions for elements are borrowed from <link xlink:href="http://www.pagcgeo.org/docs/html/pagc-12.html#ss12.1">PAGC Postal Attributes</link>.
fr: Type composite composé d'éléments d'une adresse. Il s'agit du type de retour pour la fonction <xref linkend="standardize_address"/>. Certaines descriptions d'éléments sont empruntées à <link xlink:href="http://www.pagcgeo.org/docs/html/pagc-12.html#ss12.1">PAGC Postal Attributes</link>.

note: Tag: para
en: The token numbers denote the output reference number in the <xref linkend="rulestab"/>.
fr: Les numéros de jetons indiquent le numéro de référence de la sortie dans le <xref linkend="rulestab"/>.

note: Tag: para
en: is text (token number <code>0</code>): Refers to building number or name. Unparsed building identifiers and types. Generally blank for most addresses.
fr: est un texte (jeton numéro <code>0</code>) : Fait référence au numéro ou au nom du bâtiment. Identifiants et types de bâtiments non analysés. Généralement vide pour la plupart des adresses.

note: Tag: para
en: is a text (token number <code>1</code>): This is the street number on a street. Example <emphasis>75</emphasis> in <code>75 State Street</code>.
fr: est un texte (jeton numéro <code>1</code>) : Il s'agit du numéro d'une rue. Exemple <emphasis>75</emphasis> dans <code>75 State Street</code>.

note: Tag: para
en: is text (token number <code>2</code>): STREET NAME PRE-DIRECTIONAL such as North, South, East, West etc.
fr: est un texte (jeton numéro <code>2</code>) : NOM DE RUE PRÉDIRECTIONNEL tel que Nord, Sud, Est, Ouest, etc.

note: Tag: para
en: is text (token number <code>3</code>): STREET NAME PRE-MODIFIER Example <emphasis>OLD</emphasis> in <code>3715 OLD HIGHWAY 99</code>.
fr: est un texte (jeton numéro <code>3</code>) : NOM DE RUE PRE-MODIFIER Exemple <emphasis>OLD</emphasis> dans <code>3715 OLD HIGHWAY 99</code>.

note: Tag: para
en: is text (token number <code>4</code>): STREET PREFIX TYPE
fr: est un texte (jeton numéro <code>4</code>) : TYPE DE PRÉFIXE DE RUE

note: Tag: para
en: is text (token number <code>5</code>): STREET NAME
fr: est un texte (jeton numéro <code>5</code>) : NOM DE RUE

note: Tag: para
en: is text (token number <code>6</code>): STREET POST TYPE e.g. St, Ave, Cir. A street type following the root street name. Example <emphasis>STREET</emphasis> in <code>75 State Street</code>.
fr: est un texte (jeton numéro <code>6</code>) : STREET POST TYPE e.g. St, Ave, Cir. Un type de rue suivant le nom de la rue racine. Exemple <emphasis>STREET</emphasis> dans <code>75 State Street</code>.

note: Tag: para
en: is text (token number <code>7</code>): STREET POST-DIRECTIONAL A directional modifier that follows the street name.. Example <emphasis>WEST</emphasis> in <code>3715 TENTH AVENUE WEST</code>.
fr: est un texte (jeton numéro <code>7</code>) : STREET POST-DIRECTIONAL Un modificateur directionnel qui suit le nom de la rue. Exemple <emphasis>WEST</emphasis> dans <code>3715 TENTH AVENUE WEST</code>.

note: Tag: para
en: is text (token number <code>8</code>): RURAL ROUTE . Example <emphasis>7</emphasis> in <code>RR 7</code>.
fr: est un texte (jeton numéro <code>8</code>) : RURAL ROUTE . Exemple <emphasis>7</emphasis> dans <code>RR 7</code>.

note: Tag: para
en: is text: Extra information like Floor number.
fr: est un texte : Informations supplémentaires telles que le numéro d'étage.

note: Tag: para
en: is text (token number <code>10</code>): Example Boston.
fr: est un texte (jeton numéro <code>10</code>) : Exemple Boston.

note: Tag: para
en: is text (token number <code>11</code>): Example <code>MASSACHUSETTS</code>
fr: est un texte (jeton numéro <code>11</code>) : Exemple <code>MASSACHUSETTS</code>

note: Tag: para
en: is text (token number <code>12</code>): Example <code>USA</code>
fr: est un texte (jeton numéro <code>12</code>) : Exemple <code>USA</code>

note: Tag: para
en: is text POSTAL CODE (ZIP CODE) (token number <code>13</code>): Example <code>02109</code>
fr: est le texte POSTAL CODE (ZIP CODE) (numéro de jeton <code>13</code>) : Exemple <code>02109</code>

note: Tag: para
en: is text POSTAL BOX NUMBER (token number <code>14 and 15</code>): Example <code>02109</code>
fr: est le texte POSTAL BOX NUMBER (numéro de jeton <code>14 et 15</code>) : Exemple <code>02109</code>

note: Tag: para
en: is text Apartment number or Suite Number (token number <code>17</code>): Example <emphasis>3B</emphasis> in <code>APT 3B</code>.
fr: est le texte Numéro d'appartement ou numéro de suite (numéro de jeton <code>17</code>) : Exemple <emphasis>3B</emphasis> dans <code>APT 3B</code>.

note: Tag: title
en: Address Standardizer Tables
fr: Tables Address Standardizer

note: Tag: para
en: This section lists the PostgreSQL table formats used by the address_standardizer for normalizing addresses. Note that these tables do not need to be named the same as what is referenced here. You can have different lex, gaz, rules tables for each country for example or for your custom geocoder. The names of these tables get passed into the address standardizer functions.
fr: Cette section liste les formats de tables PostgreSQL utilisés par address_standardizer pour la normalisation des adresses. Notez que ces tables n'ont pas besoin d'être nommées de la même manière que ce qui est référencé ici. Vous pouvez avoir des tables lex, gaz, rules différentes pour chaque pays par exemple ou pour votre géocodeur personnalisé. Les noms de ces tables sont transmis aux fonctions de normalisation des adresses.

note: Tag: para
en: The packaged extension <varname>address_standardizer_data_us</varname> contains data for standardizing US addresses.
fr: L'extension packagée <varname>address_standardizer_data_us</varname> contient des données pour la normalisation des adresses américaines.

note: Tag: refpurpose
en: The rules table contains a set of rules that maps address input sequence tokens to standardized output sequence. A rule is defined as a set of input tokens followed by -1 (terminator) followed by set of output tokens followed by -1 followed by number denoting kind of rule followed by ranking of rule.
fr: La table rules contient un ensemble de règles qui établit une correspondance entre les jetons de la séquence d'entrée de l'adresse et la séquence de sortie normalisée. Une règle est définie comme un ensemble de jetons d'entrée suivi de -1 (terminateur) suivi d'un ensemble de jetons de sortie suivi de -1 suivi d'un nombre indiquant le type de règle suivi du classement de la règle.

note: Tag: para
en: A rules table must have at least the following columns, though you are allowed to add more for your own uses.
fr: La table rules doit comporter au moins les colonnes suivantes, mais vous pouvez en ajouter d'autres pour vos propres besoins.

note: Tag: para
en: Primary key of table
fr: Clé primaire de la table

note: Tag: para
en: text field denoting the rule. Details at <link xlink:href="http://www.pagcgeo.org/docs/html/pagc-12.html#--r-rec--">PAGC Address Standardizer Rule records</link>.
fr: champ de texte indiquant la règle. Pour plus de détails, voir <link xlink:href="http://www.pagcgeo.org/docs/html/pagc-12.html#--r-rec--">PAGC Address Standardizer Rule records</link>.

note: Tag: para
en: A rule consists of a set of non-negative integers representing input tokens, terminated by a -1, followed by an equal number of non-negative integers representing postal attributes, terminated by a -1, followed by an integer representing a rule type, followed by an integer representing the rank of the rule. The rules are ranked from 0 (lowest) to 17 (highest).
fr: Une règle se compose d'un ensemble d'entiers non négatifs représentant les jetons d'entrée, terminés par un -1, suivis d'un nombre égal d'entiers non négatifs représentant les attributs postaux, terminés par un -1, suivis d'un entier représentant un type de règle, suivi d'un entier représentant le rang de la règle. Les règles sont classées de 0 (la plus basse) à 17 (la plus haute).

note: Tag: para
en: So for example the rule <code>2 0 2 22 3 -1 5 5 6 7 3 -1 2 6</code> maps to sequence of output tokens <emphasis>TYPE NUMBER TYPE DIRECT QUALIF</emphasis> to the output sequence <emphasis>STREET STREET SUFTYP SUFDIR QUALIF</emphasis>. The rule is an ARC_C rule of rank 6.
fr: Ainsi, par exemple, la règle <code>2 0 2 22 3 -1 5 5 6 7 3 -1 2 6</code> associe la séquence de jetons de sortie <emphasis>TYPE NUMBER TYPE DIRECT QUALIF</emphasis> à la séquence de sortie <emphasis>STREET STREET SUFTYP SUFDIR QUALIF</emphasis>. La règle est une règle ARC_C de rang 6.

note: Tag: para
en: Numbers for corresponding output tokens are listed in <xref linkend="stdaddr"/>.
fr: Les numéros des jetons de sortie correspondants sont énumérés dans <xref linkend="stdaddr"/>.

note: Tag: title
en: Input Tokens
fr: Jetons d'entrée

note: Tag: para
en: Each rule starts with a set of input tokens followed by a terminator <code>-1</code>. Valid input tokens excerpted from <link xlink:href="http://www.pagcgeo.org/docs/html/pagc-12.html#ss12.2">PAGC Input Tokens</link> are as follows:
fr: Chaque règle commence par un ensemble de jetons d'entrée suivi d'un terminateur <code>-1</code>. Les jetons d'entrée valides extraits de <link xlink:href="http://www.pagcgeo.org/docs/html/pagc-12.html#ss12.2">Tokens d'entrée du PAGC</link> sont les suivants :

note: Tag: emphasis
en: Form-Based Input Tokens
fr: Jetons de saisie basés sur la forme

note: Tag: para
en: (13). The ampersand (&amp;) is frequently used to abbreviate the word "and".
fr: (13). L'esperluette (&amp;) est fréquemment utilisée pour abréger le mot "et".

note: Tag: para
en: (9). A punctuation character.
fr: (9). Un caractère de ponctuation.

note: Tag: para
en: (21). A sequence of two letters. Often used as identifiers.
fr: (21). Séquence de deux lettres. Souvent utilisé comme identifiant.

note: Tag: para
en: (25). Fractions are sometimes used in civic numbers or unit numbers.
fr: (25). Les fractions sont parfois utilisées dans les nombres civiques ou les nombres unitaires.

note: Tag: para
en: (23). An alphanumeric string that contains both letters and digits. Used for identifiers.
fr: (23). Chaîne alphanumérique contenant à la fois des lettres et des chiffres. Utilisée pour les identifiants.

note: Tag: para
en: (0). A string of digits.
fr: (0). Une chaîne de chiffres.

note: Tag: para
en: (15). Representations such as First or 1st. Often used in street names.
fr: (15). Représentations telles que First or 1st. Souvent utilisé dans les noms de rue.

note: Tag: para
en: (18). A single letter.
fr: (18). Une seule lettre.

note: Tag: para
en: (1). A word is a string of letters of arbitrary length. A single letter can be both a SINGLE and a WORD.
fr: (1). Un mot est une chaîne de lettres de longueur arbitraire. Une même lettre peut être à la fois SINGLE et WORD.

note: Tag: emphasis
en: Function-based Input Tokens
fr: Jetons d'entrée basés sur des fonctions

note: Tag: para
en: (14). Words used to denote post office boxes. For example <emphasis>Box</emphasis> or <emphasis>PO Box</emphasis>.
fr: (14). Mots utilisés pour désigner les boîtes postales. Par exemple <emphasis>Box</emphasis> ou <emphasis>PO Box</emphasis>.

note: Tag: para
en: (19). Words used to denote buildings or building complexes, usually as a prefix. For example: <emphasis>Tower</emphasis> in <emphasis>Tower 7A</emphasis>.
fr: (19). Mots utilisés pour désigner des bâtiments ou des ensembles de bâtiments, généralement sous forme de préfixe. Par exemple : <emphasis>Tower</emphasis> dans <emphasis>Tower 7A</emphasis>.

note: Tag: para
en: (24). Words and abbreviations used to denote buildings or building complexes, usually as a suffix. For example: <emphasis>Shopping Centre</emphasis>.
fr: (24). Mots et abréviations utilisés pour désigner des bâtiments ou des ensembles de bâtiments, généralement sous forme de suffixe. Par exemple : <emphasis>Shopping Centre</emphasis>.

note: Tag: para
en: (22). Words used to denote directions, for example <emphasis>North</emphasis>.
fr: (22). Mots utilisés pour indiquer des directions, par exemple <emphasis>Nord</emphasis>.

note: Tag: para
en: (20). Words used to denote milepost addresses.
fr: (20). Mots utilisés pour indiquer les adresses des points kilométriques.

note: Tag: para
en: (6). Words and abbreviations used to denote highways and roads. For example: the <emphasis>Interstate</emphasis> in <emphasis>Interstate 5</emphasis>
fr: (6). Mots et abréviations utilisés pour désigner les autoroutes et les routes. Par exemple : l'<emphasis>Interstate</emphasis> dans <emphasis>Interstate 5</emphasis>

note: Tag: para
en: (8). Words and abbreviations used to denote rural routes. <emphasis>RR</emphasis>.
fr: (8). Mots et abréviations utilisés pour désigner les routes rurales. <emphasis>RR</emphasis>.

note: Tag: para
en: (2). Words and abbreviation used to denote street typess. For example: <emphasis>ST</emphasis> or <emphasis>AVE</emphasis>.
fr: (2). Mots et abréviations utilisés pour désigner les types de rues. Par exemple : <emphasis>ST</emphasis> ou <emphasis>AVE</emphasis>.

note: Tag: para
en: (16). Words and abbreviation used to denote internal subaddresses. For example, <emphasis>APT</emphasis> or <emphasis>UNIT</emphasis>.
fr: (16). Mots et abréviations utilisés pour désigner les sous-adresses internes. Par exemple, <emphasis>APT</emphasis> ou <emphasis>UNIT</emphasis>.

note: Tag: emphasis
en: Postal Type Input Tokens
fr: Type de poste Jetons d'entrée

note: Tag: para
en: (28). A 5 digit number. Identifies a Zip Code
fr: (28). Un nombre à 5 chiffres. Identifie un code postal

note: Tag: para
en: (29). A 4 digit number. Identifies ZIP4.
fr: (29). Un numéro à 4 chiffres. Identifie le ZIP4.

note: Tag: para
en: (27). A 3 character sequence of letter number letter. Identifies an FSA, the first 3 characters of a Canadian postal code.
fr: (27). Séquence de 3 caractères composée d'une lettre, d'un numéro et d'une lettre. Identifie un FSA, les 3 premiers caractères d'un code postal canadien.

note: Tag: para
en: (26). A 3 character sequence of number letter number. Identifies an LDU, the last 3 characters of a Canadian postal code.
fr: (26). Séquence de 3 caractères composée d'un numéro, d'une lettre et d'un chiffre. Identifie un LDU, les 3 derniers caractères d'un code postal canadien.

note: Tag: para
en: STOPWORDS combine with WORDS. In rules a string of multiple WORDs and STOPWORDs will be represented by a single WORD token.
fr: STOPWORDS se combinent avec WORDS. Dans les règles, une chaîne de plusieurs WORDs et STOPWORDs sera représentée par un seul mot-clé WORD.

note: Tag: para
en: (7). A word with low lexical significance, that can be omitted in parsing. For example: <emphasis>THE</emphasis>.
fr: (7). Un mot de faible importance lexicale, qui peut être omis dans l'analyse syntaxique. Par exemple : <emphasis>THE</emphasis>.

note: Tag: title
en: Output Tokens
fr: Jetons de sortie

note: Tag: para
en: After the first -1 (terminator), follows the output tokens and their order, followed by a terminator <code>-1</code>. Numbers for corresponding output tokens are listed in <xref linkend="stdaddr"/>. What are allowed is dependent on kind of rule. Output tokens valid for each rule type are listed in <xref linkend="rule_types_rank"/>.
fr: Après le premier -1 (terminateur), suivent les jetons de sortie et leur ordre, suivis d'un terminateur <code>-1</code>. Les numéros des jetons de sortie correspondants sont énumérés dans <xref linkend="stdaddr"/>. Les éléments autorisés dépendent du type de règle. Les jetons de sortie valables pour chaque type de règle sont énumérés dans <xref linkend="rule_types_rank"/>.

note: Tag: title
en: Rule Types and Rank
fr: Types de règles et rangs

note: Tag: para
en: The final part of the rule is the rule type which is denoted by one of the following, followed by a rule rank. The rules are ranked from 0 (lowest) to 17 (highest).
fr: La dernière partie de la règle est le type de règle qui est désigné par l'un des éléments suivants, suivi du rang de la règle. Les règles sont classées de 0 (la plus faible) à 17 (la plus élevée).

note: Tag: para
en: (token number = "<emphasis role="bold">0</emphasis>"). The class of rules for parsing MACRO clauses such as <emphasis>PLACE STATE ZIP</emphasis>
fr: (numéro du jeton = "<emphasis role="bold">0</emphasis>"). La classe de règles pour l'analyse des clauses MACRO telles que <emphasis>PLACE STATE ZIP</emphasis>

note: Tag: para
en: <emphasis role="bold"><varname>MACRO_C</varname> output tokens</emphasis> (excerpted from <link xlink:href="http://www.pagcgeo.org/docs/html/pagc-12.html#--r-typ--">http://www.pagcgeo.org/docs/html/pagc-12.html#--r-typ--</link>.
fr: <emphasis role="bold"><varname>MACRO_C</varname> jetons de sortie ("output tokens") </emphasis> (excepté pour <link xlink:href="http://www.pagcgeo.org/docs/html/pagc-12.html#--r-typ--">http://www.pagcgeo.org/docs/html/pagc-12.html#--r-typ--</link>.

note: Tag: para
en: (token number "10"). Example "Albany"
fr: (jeton numéro "10"). Exemple "Albany"

note: Tag: para
en: (token number "11"). Example "NY"
fr: (jeton numéro "11"). Exemple "NY"

note: Tag: para
en: (token number "12"). This attribute is not used in most reference files. Example "USA"
fr: (numéro de jeton "12"). Cet attribut n'est pas utilisé dans la plupart des fichiers de référence. Exemple "USA"

note: Tag: para
en: (token number "13"). (SADS elements "ZIP CODE" , "PLUS 4" ). This attribute is used for both the US Zip and the Canadian Postal Codes.
fr: (nombre de jetons "13"). (éléments SADS "ZIP CODE" , "PLUS 4" ). Cet attribut est utilisé à la fois pour le code postal américain et le code postal canadien.

note: Tag: para
en: (token number = "<emphasis role="bold">1</emphasis>"). The class of rules for parsing full MICRO clauses (such as House, street, sufdir, predir, pretyp, suftype, qualif) (ie ARC_C plus CIVIC_C). These rules are not used in the build phase.
fr: (numéro du jeton = "<emphasis role="bold">1</emphasis>"). La classe de règles pour l'analyse des clauses MICRO complètes (telles que House, street, sufdir, predir, pretyp, suftype, qualif) (c'est-à-dire ARC_C plus CIVIC_C). Ces règles ne sont pas utilisées dans la phase de construction.

note: Tag: para
en: <emphasis role="bold"><varname>MICRO_C</varname> output tokens</emphasis> (excerpted from <link xlink:href="http://www.pagcgeo.org/docs/html/pagc-12.html#--r-typ--">http://www.pagcgeo.org/docs/html/pagc-12.html#--r-typ--</link>.
fr: <emphasis role="bold"><varname>MICRO_C</varname> jetons de sortie ("output tokens") </emphasis> (exceptés pour <link xlink:href="http://www.pagcgeo.org/docs/html/pagc-12.html#--r-typ--">http://www.pagcgeo.org/docs/html/pagc-12.html#--r-typ--</link>.

note: Tag: para
en: (token number = "<emphasis role="bold">2</emphasis>"). The class of rules for parsing MICRO clauses, excluding the HOUSE attribute. As such uses same set of output tokens as MICRO_C minus the HOUSE token.
fr: (numéro de jeton = "<emphasis role="bold">2</emphasis>"). Classe de règles pour l'analyse des clauses MICRO, à l'exclusion de l'attribut HOUSE. En tant que telle, elle utilise le même ensemble de jetons de sortie que MICRO_C, à l'exception du jeton HOUSE.

note: Tag: para
en: (token number = "<emphasis role="bold">3</emphasis>"). The class of rules for parsing the HOUSE attribute.
fr: (numéro du jeton = "<emphasis role="bold">3</emphasis>"). La classe de règles pour l'analyse de l'attribut HOUSE.

note: Tag: para
en: (token number = "<emphasis role="bold">4</emphasis>"). The class of rules for parsing EXTRA attributes - attributes excluded from geocoding. These rules are not used in the build phase.
fr: (numéro du jeton = "<emphasis role="bold">4</emphasis>"). La classe de règles pour l'analyse des attributs EXTRA - attributs exclus du géocodage. Ces règles ne sont pas utilisées dans la phase de construction.

note: Tag: para
en: <emphasis role="bold"><varname>EXTRA_C</varname> output tokens</emphasis> (excerpted from <link xlink:href="http://www.pagcgeo.org/docs/html/pagc-12.html#--r-typ--">http://www.pagcgeo.org/docs/html/pagc-12.html#--r-typ--</link>.
fr: <emphasis role="bold"><varname>EXTRA_C</varname> jetons de sortie ("output tokens")</emphasis> (excepté pour <link xlink:href="http://www.pagcgeo.org/docs/html/pagc-12.html#--r-typ--">http://www.pagcgeo.org/docs/html/pagc-12.html#--r-typ--</link>.

note: Tag: para
en: (token number <code>0</code>): Unparsed building identifiers and types.
fr: (numéro de jeton <code>0</code>) : Identifiants et types de bâtiments non analysés.

note: Tag: para
en: (token number <code>14</code>): The <emphasis role="bold">BOX</emphasis> in <code>BOX 3B</code>
fr: (numéro de jeton <code>14</code>) : Le <emphasis role="bold">BOX</emphasis> dans <code>BOX 3B</code>

note: Tag: para
en: (token number <code>15</code>): The <emphasis role="bold">3B</emphasis> in <code>BOX 3B</code>
fr: (token number <code>15</code>) : La <emphasis role="bold">3B</emphasis> dans <code>BOX 3B</code>

note: Tag: para
en: (token number <code>8</code>): The <emphasis role="bold">RR</emphasis> in <code>RR 7</code>
fr: (token number <code>8</code>) : Le <emphasis role="bold">RR</emphasis> dans <code>RR 7</code>

note: Tag: para
en: (token number <code>16</code>): The <emphasis role="bold">APT</emphasis> in <code>APT 3B</code>
fr: (numéro de jeton <code>16</code>) : L'<emphasis role="bold">APT</emphasis> dans <code>APT 3B</code>

note: Tag: para
en: (token number <code>17</code>): The <emphasis role="bold">3B</emphasis> in <code>APT 3B</code>
fr: (numéro de jeton <code>17</code>) : La <emphasis role="bold">3B</emphasis> dans <code>APT 3B</code>

note: Tag: para
en: (token number <code>9</code>): An otherwise unclassified output.
fr: (numéro de jeton <code>9</code>) : Une sortie non classée par ailleurs.

note: Tag: refpurpose
en: A lex table is used to classify alphanumeric input and associate that input with (a) input tokens ( See <xref linkend="rule_input_tokens"/>) and (b) standardized representations.
fr: La table lex est utilisée pour classer les entrées alphanumériques et les associer (a) à des jetons d'entrée (voir <xref linkend="rule_input_tokens"/>) et (b) à des représentations normalisées.

note: Tag: para
en: A lex (short for lexicon) table is used to classify alphanumeric input and associate that input with <xref linkend="rule_input_tokens"/> and (b) standardized representations. Things you will find in these tables are <code>ONE</code> mapped to stdword: <code>1</code>.
fr: La table lex (abréviation de lexicon) est utilisée pour classer les entrées alphanumériques et les associer à des <xref linkend="rule_input_tokens"/> et (b) à des représentations normalisées. Les éléments que vous trouverez dans ces tables sont <code>ONE</code> mappé à stdword : <code>1</code>.

note: Tag: para
en: A lex has at least the following columns in the table. You may add
fr: La table lex comporte au moins les colonnes suivantes. Vous pouvez ajouter

note: Tag: para
en: integer: definition number?
fr: entier : définition du nombre ?

note: Tag: para
en: text: the input word
fr: texte : le mot en entrée

note: Tag: para
en: text: the standardized replacement word
fr: texte : le mot de remplacement normalisé

note: Tag: para
en: integer: the kind of word it is. Only if it is used in this context will it be replaced. Refer to <link xlink:href="http://www.pagcgeo.org/docs/html/pagc-12.html#--i-tok--">PAGC Tokens</link>.
fr: entier : le type de mot dont il s'agit. Il ne sera remplacé que s'il est utilisé dans ce contexte. Voir <link xlink:href="http://www.pagcgeo.org/docs/html/pagc-12.html#--i-tok--">Tokens PAGC</link>.

note: Tag: refpurpose
en: A gaz table is used to standardize place names and associate that input with (a) input tokens ( See <xref linkend="rule_input_tokens"/>) and (b) standardized representations.
fr: La table gaz est utilisée pour normaliser les noms de lieux et associer cette entrée avec (a) des tokens d'entrée ( Voir <xref linkend="rule_input_tokens"/>) et (b) des représentations normalisées.

note: Tag: para
en: A gaz (short for gazeteer) table is used to standardize place names and associate that input with <xref linkend="rule_input_tokens"/> and (b) standardized representations. For example if you are in US, you may load these with State Names and associated abbreviations.
fr: La table gaz (abréviation de gazeteer) est utilisée pour normaliser les noms de lieux et associer cette entrée à des <xref linkend="rule_input_tokens"/> et (b) à des représentations normalisées. Par exemple, si vous êtes aux États-Unis, vous pouvez charger ces tableaux avec les noms des États et les abréviations associées.

note: Tag: para
en: A gaz table has at least the following columns in the table. You may add more columns if you wish for your own purposes.
fr: La table gaz comporte au moins les colonnes suivantes. Vous pouvez ajouter d'autres colonnes si vous le souhaitez pour vos propres besoins.

note: Tag: para
en: integer: definition number? - identifier used for that instance of the word
fr: entier : définition nombre ? - identificateur utilisé pour cette instance du mot

note: Tag: title
en: Address Standardizer Functions
fr: Fonctions Address Standardizer

note: Tag: refpurpose
en: Returns a json formatted text listing the parse tokens and standardizations
fr: Retourne une chaîne au format json avec les jetons d'entrée et les normalisations

note: Tag: para
en: This is a function for debugging address standardizer rules and lex/gaz mappings. It returns a json formatted text that includes the matching rules, mapping of tokens, and best standardized address <xref linkend="stdaddr"/> form of an input address utilizing <xref linkend="lextab"/> table name, <xref linkend="gaztab"/>, and <xref linkend="rulestab"/> table names and an address.
fr: Ceci est une fonction pour déboguer les règles de normalisation des adresses et les correspondances lex/gaz. Cette fonction retourne une chaîne au format json qui inclut les règles correspondantes, la correspondance des jetons d'entrées et la meilleure adresse normalisée selon <xref linkend="stdaddr"/>, en utilisant les tables <xref linkend="lextab"/>, <xref linkend="gaztab"/> et <xref linkend="rulestab"/>, ainsi qu'une adresse.

note: Tag: para
en: For single line addresses use just <varname>micro</varname>
fr: Pour une adresse sur une seule ligne, utiliser <varname>micro</varname>

note: Tag: para
en: For two line address A <varname>micro</varname> consisting of standard first line of postal address e.g. <code>house_num street</code>, and a macro consisting of standard postal second line of an address e.g <code>city, state postal_code country</code>.
fr: Pour une adresse sur deux lignes, utiliser <varname>micro</varname> pour la première ligne standard d'une adresse postale par exemple <code>house_num street</code>, et macro pour la deuxième ligne postale standard de l'adresse, par exemple <code>city, state postal_code country</code>.

note: Tag: para
en: Elements returned in the json document are
fr: Les éléments retournées dans le document json sont

note: Tag: para
en: For each word in the input address, returns the position of the word, token categorization of the word, and the standard word it is mapped to. Note that for some input words, you might get back multiple records because some inputs can be categorized as more than one thing.
fr: Pour chaque mot de l'adresse d'entrée, retourne la position du mot, la catégorisation du jeton correspondant au mot, et le mot standard correspondant. A noter que pour certains mots d'entrée, vous pouvez obtenir plusieurs enregistrements car certaines entrées peuvent correspondre à plusieurs catégories à la fois.

note: Tag: para
en: The set of rules matching the input and the corresponding score for each. The first rule (highest scoring) is what is used for standardization
fr: L'ensemble des règles correspondant à l'entrée, et le score de correspondance pour chacune. La première règle (avec le plus haut score) est celle utilisée pour la normalisation

note: Tag: para
en: The standardized address elements <xref linkend="stdaddr"/> that would be returned when running <xref linkend="standardize_address"/>
fr: Les éléments de l'adresse normalisée <xref linkend="stdaddr"/>, qui seraient retournés par <xref linkend="standardize_address"/>

note: Tag: para
en: Availability: 3.4.0
fr: Disponibilité : 3.4.0

note: Tag: title
en: Examples
fr: Exemples

note: Tag: para
en: Using address_standardizer_data_us extension
fr: Utilisation de l'extension address_standardizer_data_us

note: Tag: para
en: Variant 1: Single line address and returning the input tokens
fr: Variante 1 : prend une adresse sur une seule ligne et retourne les jetons d'entrée

note: Tag: para
en: Variant 2: Multi line address and returning first rule input mappings and score
fr: Variante 2 : Adresse en deux parties et retourne la première règle de correspondance et son score

note: Tag: title
en: See Also
fr: Voir aussi

note: Tag: refpurpose
en: Takes a 1 line address and breaks into parts
fr: Prend une adresse d'une ligne et la décompose en plusieurs parties

note: Tag: para
en: Returns takes an address as input, and returns a record output consisting of fields <emphasis>num</emphasis>, <emphasis>street</emphasis>, <emphasis>street2</emphasis>, <emphasis>address1</emphasis>, <emphasis>city</emphasis>, <emphasis>state</emphasis>, <emphasis>zip</emphasis>, <emphasis>zipplus</emphasis>, <emphasis>country</emphasis>.
fr: Prend une adresse en entrée et renvoie un enregistrement composé des champs <emphasis>num</emphasis>, <emphasis>street</emphasis>, <emphasis>street2</emphasis>, <emphasis>address1</emphasis>, <emphasis>city</emphasis>, <emphasis>state</emphasis>, <emphasis>zip</emphasis>, <emphasis>zipplus</emphasis>, <emphasis>country</emphasis>.

note: Tag: para
en: Availability: 2.2.0
fr: Disponibilité : 2.2.0

note: Tag: para
en: Single Address
fr: Une seule adresse

note: Tag: para
en: Table of addresses
fr: Table des adresses

note: Tag: refpurpose
en: Returns an stdaddr form of an input address utilizing lex, gaz, and rule tables.
fr: Renvoie une forme stdaddr d'une adresse d'entrée en utilisant les tables lex, gaz et rule.

note: Tag: para
en: Returns an <xref linkend="stdaddr"/> form of an input address utilizing <xref linkend="lextab"/> table name, <xref linkend="gaztab"/>, and <xref linkend="rulestab"/> table names and an address.
fr: Renvoie une forme <xref linkend="stdaddr"/> d'une adresse d'entrée utilisant des <xref linkend="lextab"/> noms de tables, <xref linkend="gaztab"/>, et <xref linkend="rulestab"/> noms de tables et une adresse.

note: Tag: para
en: Variant 1: Takes an address as a single line.
fr: Variante 1 : prend une adresse sur une seule ligne.

note: Tag: para
en: Variant 2: Takes an address as 2 parts. A <varname>micro</varname> consisting of standard first line of postal address e.g. <code>house_num street</code>, and a macro consisting of standard postal second line of an address e.g <code>city, state postal_code country</code>.
fr: Variante 2 : prend une adresse en deux parties. Une <varname>micro</varname> constituée de la première ligne standard d'une adresse postale, par exemple <code>house_num street</code>, et une macro constituée de la deuxième ligne postale standard d'une adresse, par exemple <code>city, state postal_code country</code>.

note: Tag: para
en: Variant 1: Single line address. This doesn't work well with non-US addresses
fr: Variante 1 : adresse sur une seule ligne. Cela ne fonctionne pas bien avec les adresses non américaines

note: Tag: para
en: Using tables packaged with tiger geocoder. This example only works if you installed <varname>postgis_tiger_geocoder</varname>.
fr: Utilisation des tables fournies avec tiger geocoder. Cet exemple ne fonctionne que si vous avez installé <varname>postgis_tiger_geocoder</varname>.

note: Tag: para
en: Make easier to read we'll dump output using hstore extension CREATE EXTENSION hstore; you need to install
fr: Pour faciliter la lecture, nous utiliserons l'extension hstore CREATE EXTENSION hstore ; vous devez installer

note: Tag: para
en: Variant 2: As a two part Address
fr: Variante 2 : adresse en deux parties

note: Tag: title
en: History Tracking
fr: Suivi d'historique

note: Tag: para
en: Suppose you have a table of data that represents the current state of a particular geographic feature. A parcels table, or a roads table, or a fruit trees table, whatever. Generally, GIS tools understand a table as a single entity into which they can update, insert and delete rows from. How you do allow common GIS tools to work against your data, while maintaining an audit trail of what changes have been made, by whom, and what the past state of the data is?
fr: Supposons que vous disposiez d'une table de données représentant l'état actuel d'une entité géographique particulière. Une table de parcelles, une table de routes, une table d'arbres fruitiers, etc. En général, les outils SIG considèrent une table comme une entité unique dans laquelle ils peuvent mettre à jour, insérer et supprimer des lignes. Comment permettre aux outils SIG courants de travailler avec vos données, tout en conservant une piste d'audit des modifications effectuées, par qui et quel est l'état antérieur des données ?

note: Tag: para
en: This <varname>history_table</varname> extra module provides some utility functions for creating and maintaining history.
fr: Ce module supplémentaire <varname>history_table</varname> fournit quelques fonctions utilitaires pour la création et la gestion de l'historique.

note: Tag: para
en: The <varname>history_table</varname> was also packaged in PostGIS 1.5, but added to the documentation in PostGIS 2.0. This package is written in plpgsql and located in the <varname>extras/history_table</varname> of PostGIS source tar balls and source repository.
fr: Le <varname>history_table</varname> a également été intégré dans PostGIS 1.5, mais a été ajouté à la documentation dans PostGIS 2.0. Ce paquetage est écrit en plpgsql et se trouve dans le <varname>extras/history_table</varname> du dépôt source de PostGIS et dans les archives tar du dépôt source.

note: Tag: para
en: If you have a table 'roads', this module will maintain a 'roads_history' side table, which contains all the columns of the parent table, and the following additional columns:
fr: Si vous avez une table "routes", ce module maintiendra une table secondaire "roads_history", qui contient toutes les colonnes de la table parent, ainsi que les colonnes supplémentaires suivantes :

note: Tag: para
en: When you insert a new record into 'roads' a record is automatically inserted into 'roads_history', with the 'date_added' filled in the 'date_deleted' set to NULL, a unique 'history_id', a 'last_operation' of 'INSERT' and 'active_user' set.
fr: Lors de l'insertion d'un enregistrement dans la table 'roads' un enregistrement est automatiquement créé dans la table 'roads_history' avec 'date_added' renseigné, 'date_deleted' défini à NULL, 'history_id' avec une valeur unique, 'last_operation' défini à 'INSERT' et 'active_user' également défini.

note: Tag: para
en: When you delete a record in 'roads', the record in the history table is *not* deleted, but the 'date_deleted' is set to the current date.
fr: Lors de la suppression d'un enregistrement de la table 'roads' l'enregistrement correspondant dans la table d'historique n'est *pas* supprimé mais le champ 'date_deleted' est définit avec la date courante.

note: Tag: para
en: When you update a record in 'roads', the current record has 'date_deleted' filled in and a new record is created with the 'date_added' set and 'date_deleted' NULL.
fr: Lors de la mise à jour d'un enregistrement de la table 'roads', l'enregistrement courant est mis à jour avec le champ 'date_deleted' définit et un nouvel enregistrement est créé avec 'date_added' définit et 'date_deleted' définit à NULL.

note: Tag: para
en: With this information maintained, it is possible to retrieve the history of any record in the roads table:
fr: Grâce à ces informations, il est possible de retrouver l'historique de n'importe quel enregistrement de la table des routes :

note: Tag: para
en: Or, to retrieve a view of the roads table at any point in the past:
fr: Ou pour obtenir une vue de la table des routes à n'importe quel moment dans le passé :

note: Tag: refpurpose
en: Creates a table that will hold some interesting values for managing history tables.
fr: Crée une table qui contiendra des valeurs intéressantes pour la gestion des tables d'historique.

note: Tag: para
en: Creates a table that will hold some interesting values for managing history tables. Creates a table called <varname>historic_information</varname>
fr: Crée une table qui contiendra des valeurs intéressantes pour la gestion des tables d'historique. Crée une table appelée <varname>historic_information</varname>

note: Tag: para
en: Availability: 1.5.0
fr: Disponibilité : 1.5.0

note: Tag: refpurpose
en: Registers a table in the history_information table for tracking and also adds in side line history table and insert, update, delete rules on the table.
fr: Enregistre une table dans la table history_information pour le suivi et ajoute également une table d'historique de ligne latérale et des règles d'insertion, de mise à jour et de suppression sur la table.

note: Tag: para
en: Registers a table in the history_information table for tracking and also adds in side line history table with same name as table but prefixed with <varname>history</varname> in the same schema as the original table. Puts in insert, update, delete rules on the table. Any inserts,updates,deletes of the geometry are recorded in the history table.
fr: Enregistre une table dans la table history_information pour le suivi et ajoute également en ligne latérale une table history portant le même nom que la table mais préfixée par <varname>history</varname> dans le même schéma que la table d'origine. Instaure des règles d'insertion, de mise à jour et de suppression pour la table. Toutes les insertions, mises à jour et suppressions de la géométrie sont enregistrées dans la table d'historique.

note: Tag: para
en: This function currently relies on a geometry column being registered in <varname>geometry_columns</varname> and fails if the geometry column is not present in <varname>geometry_columns</varname> table.
fr: Cette fonction repose actuellement sur l'enregistrement d'une colonne géométrique dans <varname>geometry_columns</varname> et échoue si la colonne géométrique n'est pas présente dans la table <varname>geometry_columns</varname>.

note: Tag: title
en: Tiger Geocoder
fr: Géocodeur Tiger

note: Tag: para
en: A plpgsql based geocoder written to work with the <link xlink:href="http://www.census.gov/geo/www/tiger/">TIGER (Topologically Integrated Geographic Encoding and Referencing system ) / Line and Master Address database export</link> released by the US Census Bureau.
fr: Un géocodeur basé sur plpgsql écrit pour fonctionner avec le <link xlink:href="http://www.census.gov/geo/www/tiger/">TIGER (Topologically Integrated Geographic Encoding and Referencing system ) / Line and Master Address database export</link> publié par le US Census Bureau.

note: Tag: para
en: There are four components to the geocoder: the data loader functions, the address normalizer, the address geocoder, and the reverse geocoder.
fr: Le géocodeur se compose de quatre éléments : les fonctions de chargement des données, le normalisateur d'adresses, le géocodeur d'adresses et le géocodeur inverse.

note: Tag: para
en: Although it is designed specifically for the US, a lot of the concepts and functions are applicable and can be adapted to work with other country address and road networks.
fr: Bien qu'il soit conçu spécifiquement pour les États-Unis, un grand nombre de concepts et de fonctions sont applicables et peuvent être adaptés pour fonctionner avec les adresses et les réseaux routiers d'autres pays.

note: Tag: para
en: The script builds a schema called <varname>tiger</varname> to house all the tiger related functions, reusable lookup data such as road type prefixes, suffixes, states, various control tables for managing data load, and skeleton base tables from which all the tiger loaded tables inherit from.
fr: Le script construit un schéma appelé <varname>tiger</varname> pour héberger toutes les fonctions liées au tiger, les données de référence réutilisables telles que les préfixes de type de route, les suffixes, les états, diverses tables de contrôle pour gérer le chargement des données, et les tables de base squelettiques dont héritent toutes les tables chargées par le tiger.

note: Tag: para
en: Another schema called <varname>tiger_data</varname> is also created which houses all the census data for each state that the loader downloads from Census site and loads into the database. In the current model, each set of state tables is prefixed with the state code e.g <varname>ma_addr</varname>, <varname>ma_edges</varname> etc with constraints to enforce only that state data. Each of these tables inherits from the tables <varname>addr</varname>, <varname>faces</varname>, <varname>edges</varname>, etc located in the <varname>tiger schema</varname>.
fr: Un autre schéma appelé <varname>tiger_data</varname> est également créé. Il contient toutes les données de recensement pour chaque État que le chargeur télécharge à partir du site du recensement et charge dans la base de données. Dans le modèle actuel, chaque ensemble de tables d'État est préfixé par le code de l'État, par exemple <varname>ma_addr</varname>, <varname>ma_edges</varname> etc. avec des contraintes pour appliquer uniquement les données de l'État. Chacune de ces tables hérite des tables <varname>addr</varname>, <varname>faces</varname>, <varname>edges</varname>, etc. situées dans le <varname>tiger schema</varname>.

note: Tag: para
en: All the geocode functions only reference the base tables, so there is no requirement that the data schema be called <varname>tiger_data</varname> or that data can't be further partitioned into other schemas -- e.g a different schema for each state, as long as all the tables inherit from the tables in the <varname>tiger</varname> schema.
fr: Toutes les fonctions de géocodage ne font référence qu'aux tables de base, de sorte qu'il n'est pas nécessaire que le schéma de données s'appelle <varname>tiger_data</varname> ou que les données ne puissent pas être subdivisées en d'autres schémas - par exemple un schéma différent pour chaque État, tant que toutes les tables héritent des tables du schéma <varname>tiger</varname>.

note: Tag: para
en: For instructions on how to enable the extension in your database and also to load data using it, refer to <xref linkend="install_tiger_geocoder_extension"/>.
fr: Pour savoir comment activer l'extension dans votre base de données et charger des données à l'aide de celle-ci, consultez <xref linkend="install_tiger_geocoder_extension"/>.

note: Tag: para
en: If you are using tiger geocoder (tiger_2010), you can upgrade the scripts using the accompanying upgrade_geocoder.bat / .sh scripts in extras/tiger. One major change between <varname>tiger_2010</varname> and <varname>tiger_2011+</varname> is that the <varname>county</varname> and <varname>state</varname> tables are no longer broken out by state. If you have data from tiger_2010 and want to replace with tiger_2015, refer to <xref linkend="upgrade_tiger_geocoder"/>
fr: Si vous utilisez tiger geocoder (tiger_2010), vous pouvez mettre à jour les scripts en utilisant les scripts upgrade_geocoder.bat / .sh dans extras/tiger. Un changement majeur entre <varname>tiger_2010</varname> et <varname>tiger_2011+</varname> est que les tables <varname>county</varname> et <varname>state</varname> ne sont plus ventilées par état. Si vous avez des données provenant de tiger_2010 et que vous souhaitez les remplacer par tiger_2015, consultez <xref linkend="upgrade_tiger_geocoder"/>

note: Tag: para
en: New in PostGIS 2.2.0 release is support for Tiger 2015 data and inclusion of Address Standardizer as part of PostGIS.
fr: Les nouveautés de la version 2.2.0 de PostGIS sont la prise en charge des données Tiger 2015 et l'intégration d'Address Standardizer dans PostGIS.

note: Tag: para
en: New in PostGIS 2.1.0 release is ability to install tiger geocoder with PostgreSQL extension model if you are running PostgreSQL 9.1+. Refer to <xref linkend="install_tiger_geocoder_extension"/> for details.
fr: La nouveauté de la version 2.1.0 de PostGIS est la possibilité d'installer le géocodeur tiger avec le modèle d'extension PostgreSQL si vous utilisez PostgreSQL 9.1+. Référez-vous à <xref linkend="install_tiger_geocoder_extension"/> pour plus de détails.

note: Tag: para
en: The <xref linkend="Pagc_Normalize_Address"/> function as a drop in replacement for in-built <xref linkend="Normalize_Address"/>. Refer to <xref linkend="installing_pagc_address_standardizer"/> for compile and installation instructions.
fr: Le <xref linkend="Pagc_Normalize_Address"/> remplace directement le <xref linkend="Normalize_Address"/> intégré. Référez-vous à <xref linkend="installing_pagc_address_standardizer"/> pour les instructions de compilation et d'installation.

note: Tag: para
en: Design:
fr: Conception :

note: Tag: para
en: The goal of this project is to build a fully functional geocoder that can process an arbitrary United States address string and using normalized TIGER census data, produce a point geometry and rating reflecting the location of the given address and likeliness of the location. The higher the rating number the worse the result.
fr: L'objectif de ce projet est de construire un géocodeur entièrement fonctionnel capable de traiter une chaîne d'adresses arbitraires aux États-Unis et, à l'aide des données normalisées du recensement TIGER, de produire une géométrie de points et une évaluation reflétant la localisation de l'adresse donnée et la vraisemblance de la localisation. Plus l'indice est élevé, plus le résultat est mauvais.

note: Tag: para
en: The <varname>reverse_geocode</varname> function, introduced in PostGIS 2.0.0 is useful for deriving the street address and cross streets of a GPS location.
fr: La fonction <varname>reverse_geocode</varname>, introduite dans PostGIS 2.0.0, est utile pour dériver l'adresse de la rue et les rues transversales d'une position GPS.

note: Tag: para
en: The geocoder should be simple for anyone familiar with PostGIS to install and use, and should be easily installable and usable on all platforms supported by PostGIS.
fr: Le géocodeur doit être simple à installer et à utiliser pour toute personne familiarisée avec PostGIS, et doit être facilement installable et utilisable sur toutes les plateformes supportées par PostGIS.

note: Tag: para
en: It should be robust enough to function properly despite formatting and spelling errors.
fr: Il doit être suffisamment robuste pour fonctionner correctement malgré les erreurs de formatage et d'orthographe.

note: Tag: para
en: It should be extensible enough to be used with future data updates, or alternate data sources with a minimum of coding changes.
fr: Il doit être suffisamment extensible pour pouvoir être utilisé avec de futures mises à jour de données ou d'autres sources de données avec un minimum de changements de codage.

note: Tag: para
en: The <varname>tiger</varname> schema must be added to the database search path for the functions to work properly.
fr: Le schéma <varname>tiger</varname> doit être ajouté au search path de la base de données pour que les fonctions fonctionnent correctement.

note: Tag: para
en: There are a couple other open source geocoders for PostGIS, that unlike tiger geocoder have the advantage of multi-country geocoding support
fr: Il existe quelques autres géocodeurs open source pour PostGIS qui, contrairement au géocodeur Tiger, présentent l'avantage de prendre en charge le géocodage multi-pays

note: Tag: para
en: <link xlink:href="http://wiki.openstreetmap.org/wiki/Nominatim">Nominatim</link> uses OpenStreetMap gazeteer formatted data. It requires osm2pgsql for loading the data, PostgreSQL 8.4+ and PostGIS 1.5+ to function. It is packaged as a webservice interface and seems designed to be called as a webservice. Just like the tiger geocoder, it has both a geocoder and a reverse geocoder component. From the documentation, it is unclear if it has a pure SQL interface like the tiger geocoder, or if a good deal of the logic is implemented in the web interface.
fr: <link xlink:href="http://wiki.openstreetmap.org/wiki/Nominatim">Nominatim</link> utilise les données formatées de OpenStreetMap gazeteer. Il nécessite osm2pgsql pour charger les données, PostgreSQL 8.4+ et PostGIS 1.5+ pour fonctionner. Il est présenté sous la forme d'une interface webservice et semble conçu pour être appelé en tant que webservice. Tout comme le tiger geocoder, il possède à la fois un géocodeur et un géocodeur inversé. La documentation n'indique pas clairement s'il dispose d'une interface SQL pure comme le géocodeur tiger, ou si une grande partie de la logique est implémentée dans l'interface web.

note: Tag: para
en: <link xlink:href="http://www.gisgraphy.com/">GIS Graphy</link> also utilizes PostGIS and like Nominatim works with OpenStreetMap (OSM) data. It comes with a loader to load OSM data and similar to Nominatim is capable of geocoding not just US. Much like Nominatim, it runs as a webservice and relies on Java 1.5, Servlet apps, Solr. GisGraphy is cross-platform and also has a reverse geocoder among some other neat features.
fr: <link xlink:href="http://www.gisgraphy.com/">GIS Graphy</link> utilise également PostGIS et, comme Nominatim, fonctionne avec des données OpenStreetMap (OSM). Il est livré avec un chargeur pour charger les données OSM et, comme Nominatim, il est capable de géocoder d'autres pays que les États-Unis. Tout comme Nominatim, il fonctionne comme un service web et s'appuie sur Java 1.5, Servlet apps, Solr. GisGraphy est multiplateforme et dispose également d'un géocodeur inversé parmi d'autres fonctionnalités intéressantes.

note: Tag: refpurpose
en: <refpurpose>Generates a script that drops all non-primary key and non-unique indexes on tiger schema and user specified schema. Defaults schema to <varname>tiger_data</varname> if no schema is specified.</refpurpose>
fr: <refpurpose>Génère un script qui supprime toutes les clés non primaires et les index non uniques sur le schéma tiger et le schéma spécifié par l'utilisateur. Le schéma par défaut est <varname>tiger_data</varname> si aucun schéma n'est spécifié.</refpurpose>

note: Tag: para
en: <para>Generates a script that drops all non-primary key and non-unique indexes on tiger schema and user specified schema. Defaults schema to <varname>tiger_data</varname> if no schema is specified.</para>
fr: <para>Génère un script qui supprime toutes les clés non primaires et les index non uniques sur le schéma tiger et le schéma spécifié par l'utilisateur. Le schéma par défaut est <varname>tiger_data</varname> si aucun schéma n'est spécifié.</para>

note: Tag: para
en: This is useful for minimizing index bloat that may confuse the query planner or take up unnecessary space. Use in combination with <xref linkend="Install_Missing_Indexes"/> to add just the indexes used by the geocoder.
fr: Ceci est utile pour minimiser le gonflement de l'index qui peut perturber le planificateur de requêtes ou prendre de l'espace inutilement. A utiliser en combinaison avec <xref linkend="Install_Missing_Indexes"/> pour ajouter uniquement les index utilisés par le géocodeur.

note: Tag: para
en: Availability: 2.0.0
fr: Disponibilité : 2.0.0

note: Tag: refpurpose
en: Generates a script that drops all tables in the specified schema that start with <varname>county_all</varname>, <varname>state_all</varname> or state code followed by <varname>county</varname> or <varname>state</varname>.
fr: Génère un script qui supprime toutes les tables du schéma spécifié qui commencent par <varname>county_all</varname>, <varname>state_all</varname> ou code d'état suivi de <varname>county</varname> ou <varname>state</varname>.

note: Tag: para
en: Generates a script that drops all tables in the specified schema that start with <varname>county_all</varname>, <varname>state_all</varname> or state code followed by <varname>county</varname> or <varname>state</varname>. This is needed if you are upgrading from <varname>tiger_2010</varname> to <varname>tiger_2011</varname> data.
fr: Génère un script qui supprime toutes les tables du schéma spécifié qui commencent par <varname>county_all</varname>, <varname>state_all</varname> ou code d'état suivi de <varname>county</varname> ou <varname>state</varname>. Ceci est nécessaire si vous mettez à jour les données de <varname>tiger_2010</varname> vers <varname>tiger_2011</varname>.

note: Tag: para
en: Availability: 2.1.0
fr: Disponibilité : 2.1.0

note: Tag: refpurpose
en: Generates a script that drops all tables in the specified schema that are prefixed with the state abbreviation. Defaults schema to <varname>tiger_data</varname> if no schema is specified.
fr: Génère un script qui supprime toutes les tables du schéma spécifié qui sont préfixées par l'abréviation de l'état. La valeur par défaut du schéma est <varname>tiger_data</varname> si aucun schéma n'est spécifié.

note: Tag: para
en: Generates a script that drops all tables in the specified schema that are prefixed with the state abbreviation. Defaults schema to <varname>tiger_data</varname> if no schema is specified. This function is useful for dropping tables of a state just before you reload a state in case something went wrong during your previous load.
fr: Génère un script qui supprime toutes les tables du schéma spécifié qui sont préfixées par l'abréviation de l'état. Le schéma par défaut est <varname>tiger_data</varname> si aucun schéma n'est spécifié. Cette fonction est utile pour supprimer les tables d'un état juste avant de le recharger, au cas où quelque chose se serait mal passé lors du chargement précédent.

note: Tag: refpurpose
en: Takes in an address as a string (or other normalized address) and outputs a set of possible locations which include a point geometry in NAD 83 long lat, a normalized address for each, and the rating. The lower the rating the more likely the match. Results are sorted by lowest rating first. Can optionally pass in maximum results, defaults to 10, and restrict_region (defaults to NULL)
fr: Prend une adresse sous forme de chaîne de caractères (ou autre adresse normalisée) et produit un ensemble de lieux possibles comprenant une géométrie de point en NAD 83 long lat, une adresse normalisée pour chacun d'entre eux et l'évaluation. Plus la note est basse, plus la correspondance est probable. Les résultats sont triés par ordre décroissant. Il est possible d'indiquer en option le nombre maximum de résultats (10 par défaut) et la restriction de la région (NULL par défaut)

note: Tag: para
en: Takes in an address as a string (or already normalized address) and outputs a set of possible locations which include a point geometry in NAD 83 long lat, a <varname>normalized_address</varname> (addy) for each, and the rating. The lower the rating the more likely the match. Results are sorted by lowest rating first. Uses Tiger data (edges,faces,addr), PostgreSQL fuzzy string matching (soundex,levenshtein) and PostGIS line interpolation functions to interpolate address along the Tiger edges. The higher the rating the less likely the geocode is right. The geocoded point is defaulted to offset 10 meters from center-line off to side (L/R) of street address is located on.
fr: Prend une adresse sous forme de chaîne de caractères (ou une adresse déjà normalisée) et produit un ensemble de lieux possibles comprenant une géométrie de point en NAD 83 long lat, une <varname>adresse_normalisée</varname> (addy) pour chacun d'entre eux, et l'évaluation. Plus la note est basse, plus la correspondance est probable. Les résultats sont triés en fonction de la note la plus basse. Utilise les données du tiger (edges, faces, addr), la correspondance floue de PostgreSQL (soundex, levenshtein) et les fonctions d'interpolation de lignes de PostGIS pour interpoler l'adresse le long des bords du tigre. Plus la note est élevée, moins le géocodage a de chances d'être correct. Par défaut, le point géocodé est décalé de 10 mètres par rapport à la ligne centrale du côté (L/R) de la rue où se trouve l'adresse.

note: Tag: para
en: Enhanced: 2.0.0 to support Tiger 2010 structured data and revised some logic to improve speed, accuracy of geocoding, and to offset point from centerline to side of street address is located on. The new parameter <varname>max_results</varname> useful for specifying number of best results or just returning the best result.
fr: Amélioration : 2.0.0 pour prendre en charge les données structurées Tiger 2010 et révision de certaines logiques pour améliorer la vitesse et la précision du géocodage, et pour décaler le point de la ligne centrale vers le côté de la rue où se trouve l'adresse. Le nouveau paramètre <varname>max_results</varname> permet de spécifier le nombre de meilleurs résultats ou de renvoyer uniquement le meilleur résultat.

note: Tag: title
en: Examples: Basic
fr: Exemples : De base

note: Tag: para
en: The below examples timings are on a 3.0 GHZ single processor Windows 7 machine with 2GB ram running PostgreSQL 9.1rc1/PostGIS 2.0 loaded with all of MA,MN,CA, RI state Tiger data loaded.
fr: Les exemples de temps ci-dessous ont été calculés sur une machine Windows 7 à un processeur 3.0 GHZ avec 2 Go de mémoire vive, PostgreSQL 9.1rc1/PostGIS 2.0 avec toutes les données de MA, MN, CA, RI State Tiger.

note: Tag: para
en: Exact matches are faster to compute (61ms)
fr: Les correspondances exactes sont calculées plus rapidement (61 ms)

note: Tag: para
en: Even if zip is not passed in the geocoder can guess (took about 122-150 ms)
fr: Même si le code postal n'est pas transmis, le géocodeur peut deviner (cela a pris environ 122-150 ms)

note: Tag: para
en: Can handle misspellings and provides more than one possible solution with ratings and takes longer (500ms).
fr: Peut gérer les fautes d'orthographe et propose plusieurs solutions possibles avec des évaluations, mais prend plus de temps (500 ms).

note: Tag: para
en: Using to do a batch geocode of addresses. Easiest is to set <varname>max_results=1</varname>. Only process those not yet geocoded (have no rating).
fr: Utilisation pour effectuer un géocodage par lots d'adresses. Le plus simple est de mettre <varname>max_results=1</varname>. Ne traiter que les adresses qui n'ont pas encore été géocodées (qui n'ont pas d'évaluation).

note: Tag: title
en: Examples: Using Geometry filter
fr: Exemples : Utilisation du filtre de géométrie

note: Tag: refpurpose
en: Takes in 2 streets that intersect and a state, city, zip, and outputs a set of possible locations on the first cross street that is at the intersection, also includes a geomout as the point location in NAD 83 long lat, a <varname>normalized_address</varname> (addy) for each location, and the rating. The lower the rating the more likely the match. Results are sorted by lowest rating first. Can optionally pass in maximum results, defaults to 10. Uses Tiger data (edges, faces, addr), PostgreSQL fuzzy string matching (soundex, levenshtein).
fr: Prend 2 rues qui s'intersectent et un état, une ville, un code postal, et produit un ensemble d'emplacements possibles sur la première rue croisée qui est à l'intersection, comprend également un "geomout" comme emplacement du point en NAD 83 long lat, une <varname>adresse_normalisée</varname> (addy) pour chaque emplacement, et l'évaluation. Plus la note est basse, plus la correspondance est probable. Les résultats sont triés en fonction de la note la plus basse. Il est possible d'indiquer le nombre maximum de résultats, la valeur par défaut étant de 10. Utilise les données Tiger (edges, faces, addr), la correspondance floue de PostgreSQL (soundex, levenshtein).

note: Tag: para
en: Takes in 2 streets that intersect and a state, city, zip, and outputs a set of possible locations on the first cross street that is at the intersection, also includes a point geometry in NAD 83 long lat, a normalized address for each location, and the rating. The lower the rating the more likely the match. Results are sorted by lowest rating first. Can optionally pass in maximum results, defaults to 10. Returns <varname>normalized_address</varname> (addy) for each, geomout as the point location in nad 83 long lat, and the rating. The lower the rating the more likely the match. Results are sorted by lowest rating first. Uses Tiger data (edges,faces,addr), PostgreSQL fuzzy string matching (soundex,levenshtein)
fr: Prend 2 rues qui s'intersectent et un état, une ville, un code postal, et produit un ensemble d'emplacements possibles sur la première rue croisée qui est à l'intersection, comprend également une géométrie de point dans NAD 83 long lat, une adresse normalisée pour chaque emplacement, et la cote. Plus la note est basse, plus la correspondance est probable. Les résultats sont triés par ordre décroissant. Il est possible d'indiquer le nombre maximum de résultats, la valeur par défaut étant de 10. Retourne <varname>adresse_normalisée</varname> (addy) pour chaque, "geomout" comme emplacement du point en nad 83 long lat, et la note. Plus la note est basse, plus la correspondance est probable. Les résultats sont triés en fonction de la note la plus basse. Utilise les données Tiger (bords, visages, adresses), la correspondance floue de PostgreSQL (soundex, levenshtein)

note: Tag: para
en: The below examples timings are on a 3.0 GHZ single processor Windows 7 machine with 2GB ram running PostgreSQL 9.0/PostGIS 1.5 loaded with all of MA state Tiger data loaded. Currently a bit slow (3000 ms)
fr: Les exemples de temps ci-dessous sont basés sur une machine Windows 7 à un processeur 3.0 GHZ avec 2 Go de mémoire vive, avec PostgreSQL 9.0/PostGIS 1.5 et toutes les données de MA State Tiger chargées. Actuellement un peu lent (3000 ms)

note: Tag: para
en: Testing on Windows 2003 64-bit 8GB on PostGIS 2.0 PostgreSQL 64-bit Tiger 2011 data loaded -- (41ms)
fr: Test sur Windows 2003 64-bit 8GB sur PostGIS 2.0 PostgreSQL 64-bit Tiger 2011 données chargées -- (41ms)

note: Tag: para
en: Even if zip is not passed in the geocoder can guess (took about 3500 ms on the windows 7 box), on the windows 2003 64-bit 741 ms
fr: Même si le code postal n'est pas transmis, le géocodeur peut deviner (cela a pris environ 3500 ms sur la boîte Windows 7), sur la boîte Windows 2003 64-bit 741 ms

note: Tag: refpurpose
en: Returns value of specific setting stored in tiger.geocode_settings table.
fr: Renvoie la valeur d'un paramètre spécifique stocké dans la table tiger.geocode_settings.

note: Tag: para
en: Returns value of specific setting stored in tiger.geocode_settings table. Settings allow you to toggle debugging of functions. Later plans will be to control rating with settings. Current list of settings are as follows:
fr: Renvoie la valeur d'un paramètre spécifique stocké dans la table tiger.geocode_settings. Les paramètres permettent d'activer le débogage des fonctions. Plus tard, il sera possible de contrôler la notation à l'aide des paramètres. La liste actuelle des paramètres est la suivante :

note: Tag: para
en: Changed: 2.2.0 : default settings are now kept in a table called geocode_settings_default. Use customized settingsa are in geocode_settings and only contain those that have been set by user.
fr: Modifié : 2.2.0 : les paramètres par défaut sont désormais conservés dans une table appelée geocode_settings_default. Les paramètres personnalisés sont dans geocode_settings et ne contiennent que ceux qui ont été définis par l'utilisateur.

note: Tag: title
en: Example return debugging setting
fr: Exemple de paramétrage du débogage de retour

note: Tag: refpurpose
en: Returns census tract or field from tract table of where the geometry is located. Default to returning short name of tract.
fr: Renvoie le secteur de recensement ou le champ de la table des secteurs où se trouve la géométrie. Par défaut, le nom court du secteur est renvoyé.

note: Tag: para
en: Given a geometry will return the census tract location of that geometry. NAD 83 long lat is assumed if no spatial ref sys is specified.
fr: Une géométrie donnée renvoie la localisation du secteur de recensement de cette géométrie. Le NAD 83 long lat est supposé si aucun système de référence spatiale n'est spécifié.

note: Tag: para
en: This function uses the census <varname>tract</varname> which is not loaded by default. If you have already loaded your state table, you can load tract as well as bg, and tabblock using the <xref linkend="Loader_Generate_Census_Script"/> script.
fr: Cette fonction utilise le recensement <varname>tract</varname> qui n'est pas chargé par défaut. Si vous avez déjà chargé votre table d'état, vous pouvez charger tract ainsi que bg, et tabblock en utilisant le script <xref linkend="Loader_Generate_Census_Script"/>.

note: Tag: para
en: If you have not loaded your state data yet and want these additional tables loaded, do the following
fr: Si vous n'avez pas encore chargé les données de votre État et que vous souhaitez charger ces tableaux supplémentaires, procédez comme suit

note: Tag: para
en: then they will be included by the <xref linkend="Loader_Generate_Script"/>.
fr: alors ils seront inclus par le <xref linkend="Loader_Generate_Script"/>.

note: Tag: refpurpose
en: Finds all tables with key columns used in geocoder joins and filter conditions that are missing used indexes on those columns and will add them.
fr: Recherche toutes les tables dont les colonnes clés sont utilisées dans les jointures du géocodeur et les conditions de filtrage qui n'ont pas d'index utilisés sur ces colonnes et les ajoute.

note: Tag: para
en: Finds all tables in <varname>tiger</varname> and <varname>tiger_data</varname> schemas with key columns used in geocoder joins and filters that are missing indexes on those columns and will output the SQL DDL to define the index for those tables and then execute the generated script. This is a helper function that adds new indexes needed to make queries faster that may have been missing during the load process. This function is a companion to <xref linkend="Missing_Indexes_Generate_Script"/> that in addition to generating the create index script, also executes it. It is called as part of the <filename>update_geocode.sql</filename> upgrade script.
fr: Recherche toutes les tables dans les schémas <varname>tiger</varname> et <varname>tiger_data</varname> avec des colonnes clés utilisées dans les jointures et les filtres du géocodeur qui n'ont pas d'index sur ces colonnes et produira le DDL SQL pour définir l'index pour ces tables et exécutera ensuite le script généré. Il s'agit d'une fonction d'aide qui ajoute de nouveaux index nécessaires pour rendre les requêtes plus rapides et qui peuvent avoir été manquants au cours du processus de chargement. Cette fonction accompagne <xref linkend="Missing_Indexes_Generate_Script"/> qui, en plus de générer le script de création d'index, l'exécute également. Elle est appelée dans le cadre du script de mise à niveau <filename>update_geocode.sql</filename>.

note: Tag: refpurpose
en: Generates a shell script for the specified platform for the specified states that will download Tiger census state tract, bg, and tabblocks data tables, stage and load into <varname>tiger_data</varname> schema. Each state script is returned as a separate record.
fr: Génère un script shell pour la plate-forme spécifiée et les états spécifiés qui téléchargera les tables de données Tiger census state tract, bg et tabblocks, les structurera et les chargera dans le schéma <varname>tiger_data</varname>. Chaque script d'état est renvoyé sous la forme d'un enregistrement distinct.

note: Tag: para
en: Generates a shell script for the specified platform for the specified states that will download Tiger data census state <varname>tract</varname>, block groups <varname>bg</varname>, and <varname>tabblocks</varname> data tables, stage and load into <varname>tiger_data</varname> schema. Each state script is returned as a separate record.
fr: Génère un script shell pour la plate-forme spécifiée et les états spécifiés, qui téléchargera les données de recensement Tiger <varname>tract</varname>, les tables de données <varname>bg</varname> et <varname>tabblocks</varname>, les étapes et le chargement dans le schéma <varname>tiger_data</varname>. Chaque script d'état est renvoyé sous la forme d'un enregistrement distinct.

note: Tag: para
en: It uses unzip on Linux (7-zip on Windows by default) and wget to do the downloading. It uses <xref linkend="shp2pgsql_usage"/> to load in the data. Note the smallest unit it does is a whole state. It will only process the files in the staging and temp folders.
fr: Il utilise unzip sous Linux (7-zip sous Windows par défaut) et wget pour effectuer le téléchargement. Il utilise <xref linkend="shp2pgsql_usage"/> pour charger les données. Notez que la plus petite unité qu'il traite est un état entier. Il ne traitera que les fichiers des dossiers staging et temp.

note: Tag: para
en: It uses the following control tables to control the process and different OS shell syntax variations.
fr: Il utilise les tables de contrôle suivantes pour contrôler le processus et les différentes variations syntaxiques de l'interpréteur de commandes du système d'exploitation.

note: Tag: para
en: <varname>loader_variables</varname> keeps track of various variables such as census site, year, data and staging schemas
fr: <varname>loader_variables</varname> garde la trace de diverses variables telles que le site de recensement, l'année, les données et les schémas d'étape

note: Tag: para
en: <varname>loader_platform</varname> profiles of various platforms and where the various executables are located. Comes with windows and linux. More can be added.
fr: <varname>loader_platform</varname> profils des différentes plates-formes et de l'emplacement des différents exécutables. Livré avec windows et linux. D'autres peuvent être ajoutés.

note: Tag: para
en: <varname>loader_lookuptables</varname> each record defines a kind of table (state, county), whether to process records in it and how to load them in. Defines the steps to import data, stage data, add, removes columns, indexes, and constraints for each. Each table is prefixed with the state and inherits from a table in the tiger schema. e.g. creates <varname>tiger_data.ma_faces</varname> which inherits from <varname>tiger.faces</varname>
fr: <varname>loader_lookuptables</varname> chaque enregistrement définit un type de table (state, county), s'il faut y traiter les enregistrements et comment les charger. Définit les étapes d'importation des données, de structuration des données, d'ajout et de suppression de colonnes, d'index et de contraintes pour chaque table. Chaque table est préfixée par l'état et hérite d'une table du schéma tigre. Par exemple, crée <varname>tiger_data.ma_faces</varname> qui hérite de <varname>tiger.faces</varname>

note: Tag: para
en: includes this logic, but if you installed tiger geocoder prior to PostGIS 2.0.0 alpha5, you'll need to run this on the states you have already done to get these additional tables.
fr: inclut cette logique, mais si vous avez installé tiger geocoder avant PostGIS 2.0.0 alpha5, vous devrez l'exécuter sur les états que vous avez déjà faits pour obtenir ces tables supplémentaires.

note: Tag: para
en: Generate script to load up data for select states in Windows shell script format.
fr: Générer un script pour charger des données pour des états sélectionnés dans le format d'un script shell Windows.

note: Tag: para
en: Generate sh script
fr: Générer le script sh

note: Tag: refpurpose
en: Generates a shell script for the specified platform for the specified states that will download Tiger data, stage and load into <varname>tiger_data</varname> schema. Each state script is returned as a separate record. Latest version supports Tiger 2010 structural changes and also loads census tract, block groups, and blocks tables.
fr: Génère un script shell pour la plateforme spécifiée et les états spécifiés qui téléchargera les données Tiger, les structurera et les chargera dans le schéma <varname>tiger_data</varname>. Chaque script d'état est renvoyé sous la forme d'un enregistrement séparé. La dernière version prend en charge les modifications structurelles de Tiger 2010 et charge également les tableaux de secteurs de recensement, de groupes d'îlots et d'îlots.

note: Tag: para
en: Generates a shell script for the specified platform for the specified states that will download Tiger data, stage and load into <varname>tiger_data</varname> schema. Each state script is returned as a separate record.
fr: Génère un script shell pour la plateforme spécifiée et les états spécifiés qui téléchargera les données Tiger, les structurera et les chargera dans le schéma <varname>tiger_data</varname>. Chaque script d'état est renvoyé sous la forme d'un enregistrement séparé.

note: Tag: para
en: It uses unzip on Linux (7-zip on Windows by default) and wget to do the downloading. It uses <xref linkend="shp2pgsql_usage"/> to load in the data. Note the smallest unit it does is a whole state, but you can overwrite this by downloading the files yourself. It will only process the files in the staging and temp folders.
fr: Il utilise unzip sous Linux (7-zip sous Windows par défaut) et wget pour effectuer le téléchargement. Il utilise <xref linkend="shp2pgsql_usage"/> pour charger les données. Notez que la plus petite unité qu'il traite est un état entier, mais vous pouvez l'écraser en téléchargeant les fichiers vous-même. Il ne traitera que les fichiers des dossiers staging et temp.

note: Tag: para
en: Availability: 2.0.0 to support Tiger 2010 structured data and load census tract (tract), block groups (bg), and blocks (tabblocks) tables .
fr: Disponibilité : 2.0.0 pour prendre en charge les données structurées de Tiger 2010 et charger les tableaux de secteurs de recensement (tract), de groupes d'îlots (bg) et d'îlots (tabblocks).

note: Tag: para
en: If you are using pgAdmin 3, be warned that by default pgAdmin 3 truncates long text. To fix, change <emphasis>File -&gt; Options -&gt; Query Tool -&gt; Query Editor - &gt; Max. characters per column</emphasis> to larger than 50000 characters.
fr: Si vous utilisez pgAdmin 3, sachez que par défaut pgAdmin 3 tronque les textes longs. Pour corriger cela, modifiez <emphasis>Fichier -&gt; Options -&gt; Outil de requête -&gt; Editeur de requête -&gt; Caractères max. par colonne</emphasis> à plus de 50000 caractères.

note: Tag: para
en: Using psql where gistest is your database and <filename>/gisdata/data_load.sh</filename> is the file to create with the shell commands to run.
fr: En utilisant psql où gistest est votre base de données et <filename>/gisdata/data_load.sh</filename> est le fichier à créer avec les commandes shell à exécuter.

note: Tag: para
en: Generate script to load up data for 2 states in Windows shell script format.
fr: Générer un script pour charger des données pour 2 états dans le format d'un script shell Windows.

note: Tag: refpurpose
en: Generates a shell script for the specified platform that loads in the county and state lookup tables.
fr: Génère un script shell pour la plate-forme spécifiée qui charge les données dans les tables county et state.

note: Tag: para
en: Generates a shell script for the specified platform that loads in the <varname>county_all</varname>, <varname>county_all_lookup</varname>, <varname>state_all</varname> tables into <varname>tiger_data</varname> schema. These inherit respectively from the <varname>county</varname>, <varname>county_lookup</varname>, <varname>state</varname> tables in <varname>tiger</varname> schema.
fr: Génère un script shell pour la plate-forme spécifiée qui charge les tables <varname>county_all</varname>, <varname>county_all_lookup</varname>, <varname>state_all</varname> dans le schéma <varname>tiger_data</varname>. Elles héritent respectivement des tables <varname>county</varname>, <varname>county_lookup</varname>, <varname>state</varname> dans le schéma <varname>tiger</varname>.

note: Tag: para
en: It uses unzip on Linux (7-zip on Windows by default) and wget to do the downloading. It uses <xref linkend="shp2pgsql_usage"/> to load in the data.
fr: Il utilise unzip sous Linux (7-zip sous Windows par défaut) et wget pour effectuer le téléchargement. Il utilise <xref linkend="shp2pgsql_usage"/> pour charger les données.

note: Tag: para
en: It uses the following control tables <varname>tiger.loader_platform</varname>, <varname>tiger.loader_variables</varname>, and <varname>tiger.loader_lookuptables</varname> to control the process and different OS shell syntax variations.
fr: Il utilise les tables de contrôle suivantes <varname>tiger.loader_platform</varname>, <varname>tiger.loader_variables</varname> et <varname>tiger.loader_lookuptables</varname> pour contrôler le processus et les différentes variations syntaxiques de l'interpréteur de commandes du système d'exploitation.

note: Tag: para
en: <varname>loader_platform</varname> profiles of various platforms and where the various executables are located. Comes with windows and linux/unix. More can be added.
fr: <varname>loader_platform</varname> profils des différentes plates-formes et de l'emplacement des différents exécutables. Fourni avec windows et linux/unix. D'autres peuvent être ajoutés.

note: Tag: para
en: Enhanced: 2.4.1 zip code 5 tabulation area (zcta5) load step was fixed and when enabled, zcta5 data is loaded as a single table called zcta5_all as part of the nation script load.
fr: Amélioré : 2.4.1 L'étape de chargement de la zone de tabulation du code postal 5 (zcta5) a été corrigée et, lorsqu'elle est activée, les données zcta5 sont chargées sous la forme d'une table unique appelée zcta5_all dans le cadre du chargement du script de la nation.

note: Tag: para
en: If you want zip code 5 tabulation area (zcta5) to be included in your nation script load, do the following:
fr: Si vous souhaitez que la zone de tabulation du code postal 5 (zcta5) soit incluse dans le chargement de votre script nation, procédez comme suit :

note: Tag: para
en: If you were running <varname>tiger_2010</varname> version and you want to reload as state with newer tiger data, you'll need to for the very first load generate and run drop statements <xref linkend="Drop_Nation_Tables_Generate_Script"/> before you run this script.
fr: Si vous utilisiez la version <varname>tiger_2010</varname> et que vous souhaitez recharger en tant qu'état avec des données tiger plus récentes, vous devrez, pour le tout premier chargement, générer et exécuter des instructions de dépôt <xref linkend="Drop_Nation_Tables_Generate_Script"/> avant d'exécuter ce script.

note: Tag: para
en: Generate script script to load nation data Windows.
fr: Générer un script pour charger les données de la nation sur Windows.

note: Tag: para
en: Generate script to load up data for Linux/Unix systems.
fr: Générer un script pour charger les données pour les systèmes Linux/Unix.

note: Tag: refpurpose
en: Finds all tables with key columns used in geocoder joins that are missing indexes on those columns and will output the SQL DDL to define the index for those tables.
fr: Recherche toutes les tables dont les colonnes clés sont utilisées dans les jointures du géocodeur et qui n'ont pas d'index sur ces colonnes, et génère le DDL SQL permettant de définir l'index pour ces tables.

note: Tag: para
en: Finds all tables in <varname>tiger</varname> and <varname>tiger_data</varname> schemas with key columns used in geocoder joins that are missing indexes on those columns and will output the SQL DDL to define the index for those tables. This is a helper function that adds new indexes needed to make queries faster that may have been missing during the load process. As the geocoder is improved, this function will be updated to accommodate new indexes being used. If this function outputs nothing, it means all your tables have what we think are the key indexes already in place.
fr: Trouve toutes les tables dans les schémas <varname>tiger</varname> et <varname>tiger_data</varname> avec des colonnes clés utilisées dans les jointures du géocodeur qui n'ont pas d'index sur ces colonnes et produira le DDL SQL pour définir l'index pour ces tables. Il s'agit d'une fonction d'aide qui ajoute de nouveaux index nécessaires pour rendre les requêtes plus rapides et qui peuvent avoir été manquants au cours du processus de chargement. Au fur et à mesure de l'amélioration du géocodeur, cette fonction sera mise à jour pour prendre en compte les nouveaux index utilisés. Si cette fonction ne produit rien, cela signifie que toutes vos tables ont ce que nous pensons être les index clés déjà en place.

note: Tag: refpurpose
en: Given a textual street address, returns a composite <varname>norm_addy</varname> type that has road suffix, prefix and type standardized, street, streetname etc. broken into separate fields. This function will work with just the lookup data packaged with the tiger_geocoder (no need for tiger census data).
fr: Étant donné une adresse textuelle, cette fonction renvoie un type composite <varname>norm_addy</varname> qui contient le suffixe de la route, le préfixe et le type normalisé, la rue, le nom de la rue, etc. divisés en champs distincts. Cette fonction fonctionne uniquement avec les données de recherche fournies avec le géocodeur tiger (pas besoin pour les données de recensement tiger).

note: Tag: para
en: Given a textual street address, returns a composite <varname>norm_addy</varname> type that has road suffix, prefix and type standardized, street, streetname etc. broken into separate fields. This is the first step in the geocoding process to get all addresses into normalized postal form. No other data is required aside from what is packaged with the geocoder.
fr: Étant donné une adresse textuelle, cette fonction renvoie un type composite <varname>norm_addy</varname> qui contient le suffixe de la route, le préfixe et le type normalisé, la rue, le nom de la rue, etc. divisés en champs distincts. Il s'agit de la première étape du processus de géocodage visant à normaliser toutes les adresses sous forme postale. Aucune autre donnée n'est nécessaire en dehors de celles fournies avec le géocodeur.

note: Tag: para
en: This function just uses the various direction/state/suffix lookup tables preloaded with the tiger_geocoder and located in the <varname>tiger</varname> schema, so it doesn't need you to download tiger census data or any other additional data to make use of it. You may find the need to add more abbreviations or alternative namings to the various lookup tables in the <varname>tiger</varname> schema.
fr: Cette fonction utilise simplement les différentes tables de recherche direction/état/suffixe préchargées avec le géocodeur tiger et situées dans le schéma <varname>tiger</varname>, de sorte qu'il n'est pas nécessaire de télécharger les données de recensement tiger ou d'autres données supplémentaires pour l'utiliser. Il se peut que vous ayez besoin d'ajouter des abréviations ou des noms alternatifs aux différentes tables de recherche du schéma <varname>tiger</varname>.

note: Tag: para
en: It uses various control lookup tables located in <varname>tiger</varname> schema to normalize the input address.
fr: Il utilise diverses tables de contrôle situées dans le schéma <varname>tiger</varname> pour normaliser l'adresse d'entrée.

note: Tag: para
en: Fields in the <varname>norm_addy</varname> type object returned by this function in this order where () indicates a field required by the geocoder, [] indicates an optional field:
fr: Les champs de l'objet de type <varname>norm_addy</varname> renvoyés par cette fonction dans cet ordre où () indique un champ requis par le géocodeur, [] indique un champ optionnel :

note: Tag: para
en: Enhanced: 2.4.0 norm_addy object includes additional fields zip4 and address_alphanumeric.
fr: Amélioré : 2.4.0 L'objet norm_addy comprend des champs supplémentaires zip4 et address_alphanumeric.

note: Tag: para
en: <varname>address</varname> is an integer: The street number
fr: <varname>address</varname> est un nombre entier : Le numéro de la rue

note: Tag: para
en: <varname>predirAbbrev</varname> is varchar: Directional prefix of road such as N, S, E, W etc. These are controlled using the <varname>direction_lookup</varname> table.
fr: <varname>predirAbbrev</varname> est varchar : Préfixe directionnel de la route tel que N, S, E, W, etc. Ces préfixes sont contrôlés à l'aide de la table <varname>direction_lookup</varname>.

note: Tag: para
en: <varname>streetTypeAbbrev</varname> varchar abbreviated version of street type: e.g. St, Ave, Cir. These are controlled using the <varname>street_type_lookup</varname> table.
fr: <varname>streetTypeAbbrev</varname> varchar version abrégée du type de rue : par exemple St, Ave, Cir. Ceux-ci sont contrôlés à l'aide de la table <varname>street_type_lookup</varname>.

note: Tag: para
en: <varname>postdirAbbrev</varname> varchar abbreviated directional suffice of road N, S, E, W etc. These are controlled using the <varname>direction_lookup</varname> table.
fr: <varname>postdirAbbrev</varname> varchar abrégé directionnel suffixe de la route N, S, E, W etc. Elles sont contrôlées à l'aide de la table <varname>direction_lookup</varname>.

note: Tag: para
en: <varname>internal</varname> varchar internal address such as an apartment or suite number.
fr: <varname>internal</varname> varchar adresse interne telle qu'un numéro d'appartement ou de suite.

note: Tag: para
en: <varname>location</varname> varchar usually a city or governing province.
fr: <varname>location</varname> varchar généralement une ville ou une province.

note: Tag: para
en: <varname>stateAbbrev</varname> varchar two character US State. e.g MA, NY, MI. These are controlled by the <varname>state_lookup</varname> table.
fr: <varname>stateAbbrev</varname> varchar deux caractères État américain, par exemple MA, NY, MI. Ceux-ci sont contrôlés par la table <varname>state_lookup</varname>.

note: Tag: para
en: <varname>zip</varname> varchar 5-digit zipcode. e.g. 02109.
fr: <varname>zip</varname> varchar Code postal à 5 chiffres, par exemple 02109.

note: Tag: para
en: <varname>parsed</varname> boolean - denotes if address was formed from normalize process. The normalize_address function sets this to true before returning the address.
fr: <varname>parsed</varname> booléen - indique si l'adresse a été formée à partir du processus de normalisation. La fonction normalize_address fixe cette valeur à true avant de renvoyer l'adresse.

note: Tag: para
en: <varname>zip4</varname> last 4 digits of a 9 digit zip code. Availability: PostGIS 2.4.0.
fr: <varname>zip4</varname> 4 derniers chiffres d'un code postal à 9 chiffres. Disponibilité : PostGIS 2.4.0.

note: Tag: para
en: <varname>address_alphanumeric</varname> Full street number even if it has alpha characters like 17R. Parsing of this is better using <xref linkend="Pagc_Normalize_Address"/> function. Availability: PostGIS 2.4.0.
fr: <varname>address_alphanumeric</varname> Numéro de rue complet, même s'il contient des caractères alpha comme 17R. Il est préférable d'utiliser la fonction <xref linkend="Pagc_Normalize_Address"/>. Disponibilité : PostGIS 2.4.0.

note: Tag: para
en: Output select fields. Use <xref linkend="Pprint_Addy"/> if you want a pretty textual output.
fr: Sortie des champs de sélection. Utilisez <xref linkend="Pprint_Addy"/> si vous souhaitez une sortie textuelle.

note: Tag: refpurpose
en: Given a textual street address, returns a composite <varname>norm_addy</varname> type that has road suffix, prefix and type standardized, street, streetname etc. broken into separate fields. This function will work with just the lookup data packaged with the tiger_geocoder (no need for tiger census data). Requires address_standardizer extension.
fr: Étant donné une adresse textuelle, cette fonction renvoie un type composite <varname>norm_addy</varname> qui contient le suffixe de la route, le préfixe et le type normalisé, la rue, le nom de la rue, etc. divisés en champs distincts. Cette fonction fonctionne uniquement avec les données de recherche fournies avec le géocodeur tiger (pas besoin pour les données de recensement tiger). Nécessite l'extension address_standardizer.

note: Tag: para
en: This function just uses the various pagc_* lookup tables preloaded with the tiger_geocoder and located in the <varname>tiger</varname> schema, so it doesn't need you to download tiger census data or any other additional data to make use of it. You may find the need to add more abbreviations or alternative namings to the various lookup tables in the <varname>tiger</varname> schema.
fr: Cette fonction utilise simplement les diverses tables de recherche pagc_* préchargées avec le géocodeur tiger et situées dans le schéma <varname>tiger</varname>, de sorte qu'il n'est pas nécessaire de télécharger les données de recensement tiger ou d'autres données supplémentaires pour l'utiliser. Il se peut que vous ayez besoin d'ajouter des abréviations ou des noms alternatifs aux différentes tables de recherche du schéma <varname>tiger</varname>.

note: Tag: para
en: There are slight variations in casing and formatting over the <xref linkend="Normalize_Address"/>.
fr: Il existe de légères variations dans la casse et le formatage des <xref linkend="Normalize_Address"/>.

note: Tag: para
en: The native standardaddr of address_standardizer extension is at this time a bit richer than norm_addy since its designed to support international addresses (including country). standardaddr equivalent fields are:
fr: Le standardaddr natif de l'extension address_standardizer est pour l'instant un peu plus riche que norm_addy puisqu'il est conçu pour prendre en charge les adresses internationales (y compris le pays). Les champs équivalents au standardaddr sont :

note: Tag: para
en: Single call example
fr: Exemple d'appel unique

note: Tag: para
en: Batch call. There are currently speed issues with the way postgis_tiger_geocoder wraps the address_standardizer. These will hopefully be resolved in later editions. To work around them, if you need speed for batch geocoding to call generate a normaddy in batch mode, you are encouraged to directly call the address_standardizer standardize_address function as shown below which is similar exercise to what we did in <xref linkend="Normalize_Address"/> that uses data created in <xref linkend="Geocode"/>.
fr: Appel par lots. Il y a actuellement des problèmes de vitesse avec la façon dont postgis_tiger_geocoder mobilise l'address_standardizer. Ces problèmes seront résolus dans les prochaines éditions. Pour les contourner, si vous avez besoin de rapidité pour le géocodage par lots pour appeler la génération d'un normaddy en mode batch, nous vous encourageons à appeler directement la fonction address_standardizer standardize_address comme indiqué ci-dessous qui est un exercice similaire à ce que nous avons fait dans <xref linkend="Normalize_Address"/> qui utilise les données créées dans <xref linkend="Geocode"/>.

note: Tag: refpurpose
en: Given a <varname>norm_addy</varname> composite type object, returns a pretty print representation of it. Usually used in conjunction with normalize_address.
fr: Étant donné un objet de type composite <varname>norm_addy</varname>, renvoie une jolie représentation de celui-ci. Généralement utilisé en conjonction avec normalize_address.

note: Tag: para
en: Given a <varname>norm_addy</varname> composite type object, returns a pretty print representation of it. No other data is required aside from what is packaged with the geocoder.
fr: Étant donné un objet de type composite <varname>norm_addy</varname>, il renvoie une jolie représentation de cet objet. Aucune autre donnée n'est nécessaire en dehors de celles fournies avec le géocodeur.

note: Tag: para
en: Usually used in conjunction with <xref linkend="Normalize_Address"/>.
fr: Généralement utilisé en conjonction avec <xref linkend="Normalize_Address"/>.

note: Tag: para
en: Pretty print a single address
fr: Jolie représentation d'une adresse unique

note: Tag: para
en: Pretty print address a table of addresses
fr: Jolie représentation d'adresses à partir d'une table d'adresses

note: Tag: refpurpose
en: Takes a geometry point in a known spatial ref sys and returns a record containing an array of theoretically possible addresses and an array of cross streets. If include_strnum_range = true, includes the street range in the cross streets.
fr: Prend un point géométrique dans un système spatial connu et renvoie un enregistrement contenant un tableau d'adresses théoriquement possibles et un tableau de rues transversales. Si include_strnum_range = true, la plage de rues est incluse dans les rues transversales.

note: Tag: para
en: Takes a geometry point in a known spatial ref and returns a record containing an array of theoretically possible addresses and an array of cross streets. If include_strnum_range = true, includes the street range in the cross streets. include_strnum_range defaults to false if not passed in. Addresses are sorted according to which road a point is closest to so first address is most likely the right one.
fr: Prend un point géométrique dans un réf spatial connu et renvoie un enregistrement contenant un tableau d'adresses théoriquement possibles et un tableau de rues transversales. Si include_strnum_range = true, la plage de rues est incluse dans les rues transversales. include_strnum_range prend par défaut la valeur false s'il n'est pas fourni. Les adresses sont triées en fonction de la route dont le point est le plus proche, de sorte que la première adresse est très probablement la bonne.

note: Tag: para
en: Why do we say theoretical instead of actual addresses. The Tiger data doesn't have real addresses, but just street ranges. As such the theoretical address is an interpolated address based on the street ranges. Like for example interpolating one of my addresses returns a 26 Court St. and 26 Court Sq., though there is no such place as 26 Court Sq. This is because a point may be at a corner of 2 streets and thus the logic interpolates along both streets. The logic also assumes addresses are equally spaced along a street, which of course is wrong since you can have a municipal building taking up a good chunk of the street range and the rest of the buildings are clustered at the end.
fr: Pourquoi parle-t-on d'adresses théoriques plutôt que d'adresses réelles ? Les données Tiger ne contiennent pas d'adresses réelles, mais seulement des tranches de rues. L'adresse théorique est donc une adresse interpolée sur la base de l'étendue des rues. Par exemple, l'interpolation d'une de mes adresses donne 26 Court St. et 26 Court Sq. alors que le 26 Court Sq. n'existe pas. Cela s'explique par le fait qu'un point peut se trouver à l'angle de deux rues et que la logique interpole donc le long des deux rues. La logique suppose également que les adresses sont également espacées le long d'une rue, ce qui est bien sûr faux puisqu'un bâtiment municipal peut occuper une bonne partie de la rue et que le reste des bâtiments est regroupé à l'extrémité.

note: Tag: para
en: Note: Hmm this function relies on Tiger data. If you have not loaded data covering the region of this point, then hmm you will get a record filled with NULLS.
fr: Note : Hmm cette fonction repose sur les données Tiger. Si vous n'avez pas chargé de données couvrant la région de ce point, vous obtiendrez un enregistrement rempli de NULLS.

note: Tag: para
en: Returned elements of the record are as follows:
fr: Les éléments renvoyés de l'enregistrement sont les suivants :

note: Tag: para
en: <varname>intpt</varname> is an array of points: These are the center line points on the street closest to the input point. There are as many points as there are addresses.
fr: <varname>intpt</varname> est un tableau de points : Il s'agit des points de la ligne centrale de la rue les plus proches du point d'entrée. Il y a autant de points que d'adresses.

note: Tag: para
en: <varname>addy</varname> is an array of norm_addy (normalized addresses): These are an array of possible addresses that fit the input point. The first one in the array is most likely. Generally there should be only one, except in the case when a point is at the corner of 2 or 3 streets, or the point is somewhere on the road and not off to the side.
fr: <varname>addy</varname> est un tableau de norm_addy (adresses normalisées) : Il s'agit d'un tableau d'adresses possibles correspondant au point d'entrée. La première adresse du tableau est la plus probable. En général, il ne devrait y en avoir qu'une seule, sauf dans le cas où un point se trouve à l'angle de deux ou trois rues, ou si le point se trouve quelque part sur la route et non sur le côté.

note: Tag: para
en: <varname>street</varname> an array of varchar: These are cross streets (or the street) (streets that intersect or are the street the point is projected to be on).
fr: <varname>street</varname> un tableau de varchar : Il s'agit des rues transversales (ou de la rue) (rues qui croisent ou sont la rue sur laquelle le point est projeté).

note: Tag: para
en: Enhanced: 2.4.1 if optional zcta5 dataset is loaded, the reverse_geocode function can resolve to state and zip even if the specific state data is not loaded. Refer to <xref linkend="Loader_Generate_Nation_Script"/> for details on loading zcta5 data.
fr: Amélioration : 2.4.1 si le jeu de données optionnel zcta5 est chargé, la fonction reverse_geocode peut résoudre l'état et le code postal même si les données spécifiques à l'état ne sont pas chargées. Voir <xref linkend="Loader_Generate_Nation_Script"/> pour plus de détails sur le chargement des données zcta5.

note: Tag: para
en: Example of a point at the corner of two streets, but closest to one. This is approximate location of MIT: 77 Massachusetts Ave, Cambridge, MA 02139 Note that although we don't have 3 streets, PostgreSQL will just return null for entries above our upper bound so safe to use. This includes street ranges
fr: Exemple d'un point situé à l'angle de deux rues, mais le plus proche d'une seule. C'est l'emplacement approximatif du MIT : 77 Massachusetts Ave, Cambridge, MA 02139 Notez que bien que nous n'ayons pas 3 rues, PostgreSQL retournera simplement null pour les entrées supérieures à notre limite supérieure, ce qui permet de l'utiliser en toute sécurité. Cela inclut les plages de rues

note: Tag: para
en: Here we choose not to include the address ranges for the cross streets and picked a location really really close to a corner of 2 streets thus could be known by two different addresses.
fr: Ici, nous avons choisi de ne pas inclure les plages d'adresses pour les rues transversales et nous avons choisi un emplacement vraiment très proche d'un coin de deux rues, qui pourrait donc être connu sous deux adresses différentes.

note: Tag: para
en: For this one we reuse our geocoded example from <xref linkend="Geocode"/> and we only want the primary address and at most 2 cross streets.
fr: Pour celui-ci, nous réutilisons notre exemple géocodé de <xref linkend="Geocode"/> et nous ne voulons que l'adresse principale et au plus deux rues transversales.

note: Tag: refpurpose
en: Loads a defined region of tiger data into a PostGIS Topology and transforming the tiger data to spatial reference of the topology and snapping to the precision tolerance of the topology.
fr: Charge une région définie de données tiger dans une topologie PostGIS et transforme les données tiger en référence spatiale de la topologie et en s'adaptant à la tolérance de précision de la topologie.

note: Tag: para
en: Loads a defined region of tiger data into a PostGIS Topology. The faces, nodes and edges are transformed to the spatial reference system of the target topology and points are snapped to the tolerance of the target topology. The created faces, nodes, edges maintain the same ids as the original Tiger data faces, nodes, edges so that datasets can be in the future be more easily reconciled with tiger data. Returns summary details about the process.
fr: Charge une région définie de données tigrées dans une topologie PostGIS. Les faces, les nœuds et les arêtes sont transformés dans le système de référence spatiale de la topologie cible et les points sont adaptés à la tolérance de la topologie cible. Les faces, les nœuds et les arêtes créés conservent les mêmes identifiants que les faces, les nœuds et les arêtes des données Tiger d'origine, de sorte que les ensembles de données puissent à l'avenir être plus facilement réconciliés avec les données Tiger. Renvoie un résumé des détails du processus.

note: Tag: para
en: This would be useful for example for redistricting data where you require the newly formed polygons to follow the center lines of streets and for the resulting polygons not to overlap.
fr: Cela peut s'avérer utile, par exemple, pour les données de redécoupage, lorsque les polygones nouvellement formés doivent suivre les lignes centrales des rues et que les polygones résultants ne doivent pas se chevaucher.

note: Tag: para
en: This function relies on Tiger data as well as the installation of the PostGIS topology module. For more information, refer to <xref linkend="Topology"/> and <xref linkend="installation_configuration"/>. If you have not loaded data covering the region of interest, then no topology records will be created. This function will also fail if you have not created a topology using the topology functions.
fr: Cette fonction repose sur les données Tiger ainsi que sur l'installation du module topologique PostGIS. Pour plus d'informations, voir <xref linkend="Topology"/> et <xref linkend="installation_configuration"/>. Si vous n'avez pas chargé de données couvrant la région concernée, aucun enregistrement topologique ne sera créé. Cette fonction échouera également si vous n'avez pas créé de topologie à l'aide des fonctions de topologie.

note: Tag: para
en: Most topology validation errors are a result of tolerance issues where after transformation the edges points don't quite line up or overlap. To remedy the situation you may want to increase or lower the precision if you get topology validation failures.
fr: La plupart des erreurs de validation de la topologie sont dues à des problèmes de tolérance : après la transformation, les points des arêtes ne s'alignent pas tout à fait ou ne se chevauchent pas. Pour remédier à cette situation, vous pouvez augmenter ou réduire la précision si vous obtenez des échecs de validation de la topologie.

note: Tag: para
en: Required arguments:
fr: Arguments requis :

note: Tag: para
en: <varname>topo_name</varname> The name of an existing PostGIS topology to load data into.
fr: <varname>topo_name</varname> Le nom d'une topologie PostGIS existante dans laquelle charger les données.

note: Tag: para
en: <varname>region_type</varname> The type of bounding region. Currently only <varname>place</varname> and <varname>county</varname> are supported. Plan is to have several more. This is the table to look into to define the region bounds. e.g <varname>tiger.place</varname>, <varname>tiger.county</varname>
fr: <varname>region_type</varname> Type de région délimitée. Actuellement, seuls <varname>place</varname> et <varname>county</varname> sont pris en charge. Il est prévu d'en avoir plusieurs autres. Il s'agit de la table à consulter pour définir les limites de la région, par exemple <varname>tiger.place</varname>, <varname>tiger.county</varname>

note: Tag: para
en: <varname>region_id</varname> This is what TIGER calls the geoid. It is the unique identifier of the region in the table. For place it is the <varname>plcidfp</varname> column in <varname>tiger.place</varname>. For county it is the <varname>cntyidfp</varname> column in <varname>tiger.county</varname>
fr: <varname>region_id</varname> C'est ce que TIGER appelle le geoid. Il s'agit de l'identifiant unique de la région dans la table. Pour la table place, il s'agit de la colonne <varname>plcidfp</varname> dans <varname>tiger.place</varname>. Pour la table county, il s'agit de la colonne <varname>cntyidfp</varname> dans <varname>tiger.county</varname>

note: Tag: title
en: Example: Boston, Massachusetts Topology
fr: Exemple : Boston, Massachusetts Topologie

note: Tag: para
en: Create a topology for Boston, Massachusetts in Mass State Plane Feet (2249) with tolerance 0.25 feet and then load in Boston city tiger faces, edges, nodes.
fr: Créez une topologie pour Boston, Massachusetts dans Mass State Plane Feet (2249) avec une tolérance de 0,25 pied, puis chargez dans Boston city tiger faces, edges, nodes.

note: Tag: title
en: Example: Suffolk, Massachusetts Topology
fr: Exemple : Suffolk, Massachusetts Topologie

note: Tag: para
en: Create a topology for Suffolk, Massachusetts in Mass State Plane Meters (26986) with tolerance 0.25 meters and then load in Suffolk county tiger faces, edges, nodes.
fr: Créez une topologie pour Suffolk, Mass State Plane Meters (26986) avec une tolérance de 0,25 mètre, puis chargez dans le schéma tiger du comté de Suffolk les faces, edges, nodes.

note: Tag: refpurpose
en: Sets a setting that affects behavior of geocoder functions.
fr: Définit un paramètre qui affecte le comportement des fonctions du géocodeur.

note: Tag: para
en: Sets value of specific setting stored in <varname>tiger.geocode_settings</varname> table. Settings allow you to toggle debugging of functions. Later plans will be to control rating with settings. Current list of settings are listed in <xref linkend="Get_Geocode_Setting"/>.
fr: Définit la valeur d'un paramètre spécifique stocké dans la table <varname>tiger.geocode_settings</varname>. Les paramètres permettent d'activer le débogage des fonctions. Plus tard, il sera envisagé de contrôler la notation à l'aide de paramètres. La liste actuelle des paramètres est listée dans <xref linkend="Get_Geocode_Setting"/>.

note: Tag: para
en: If you run <xref linkend="Geocode"/> when this function is true, the NOTICE log will output timing and queries.
fr: Si vous exécutez <xref linkend="Geocode"/> alors que cette fonction est vraie, le journal NOTICE indiquera le temps et les requêtes.

note: Tag: title
en: Topology
fr: Topologie

note: Tag: para
en: The PostGIS Topology types and functions are used to manage topological objects such as faces, edges and nodes.
fr: Les types et fonctions topologiques de PostGIS sont utilisés pour gérer les objets topologiques tels que les faces, les arêtes et les des noeuds.

note: Tag: para
en: Sandro Santilli's presentation at PostGIS Day Paris 2011 conference gives a good synopsis of PostGIS Topology and where it is headed <link xlink:href="http://strk.kbt.io/projects/postgis/Paris2011_TopologyWithPostGIS_2_0.pdf">Topology with PostGIS 2.0 slide deck</link>.
fr: La présentation de Sandro Santilli à la conférence PostGIS Day Paris 2011 donne un bon aperçu de PostGIS Topology et de son évolution <link xlink:href="http://strk.kbt.io/projects/postgis/Paris2011_TopologyWithPostGIS_2_0.pdf">Topology with PostGIS 2.0 slide deck</link>.

note: Tag: para
en: Vincent Picavet provides a good synopsis and overview of what is Topology, how is it used, and various FOSS4G tools that support it in <link xlink:href="https://gitlab.com/Oslandia/documentation/presentations/-/blob/master/2012/pgconf_eu_2012/pgconfeu2012_vincent_picavet_postgis_topology.pdf">PostGIS Topology PGConf EU 2012</link>.
fr: Vincent Picavet fournit un bon résumé et une vue d'ensemble de ce qu'est la topologie, comment elle est utilisée, et divers outils FOSS4G qui la supportent dans <link xlink:href="https://gitlab.com/Oslandia/documentation/presentations/-/blob/master/2012/pgconf_eu_2012/pgconfeu2012_vincent_picavet_postgis_topology.pdf">PostGIS Topology PGConf EU 2012</link>.

note: Tag: para
en: An example of a topologically based GIS database is the <link xlink:href="https://www.census.gov/geo/maps-data/data/tiger.html">US Census Topologically Integrated Geographic Encoding and Referencing System (TIGER)</link> database. If you want to experiment with PostGIS topology and need some data, check out <xref linkend="Topology_Load_Tiger"/>.
fr: Un exemple de base de données SIG topologique est la base de données <link xlink:href="https://www.census.gov/geo/maps-data/data/tiger.html">US Census Topologically Integrated Geographic Encoding and Referencing System (TIGER)</link>. Si vous souhaitez expérimenter la topologie PostGIS et avez besoin de quelques données, consultez <xref linkend="Topology_Load_Tiger"/>.

note: Tag: para
en: The PostGIS topology module has existed in prior versions of PostGIS but was never part of the Official PostGIS documentation. In PostGIS 2.0.0 major cleanup is going on to remove use of all deprecated functions in it, fix known usability issues, better document the features and functions, add new functions, and enhance to closer conform to SQL-MM standards.
fr: Le module sur la topologie de PostGIS existe dans les versions précédentes de PostGIS mais n'a jamais fait partie de la documentation officielle de PostGIS. Dans la version 2.0.0 de PostGIS, un grand nettoyage est en cours pour en éliminer l'utilisation de toutes les fonctions obsolètes, résoudre les problèmes d'utilisabilité connus, mieux documenter les caractéristiques et les fonctions, ajouter de nouvelles fonctions, et l'améliorer afin de mieux se conformer aux normes SQL-MM.

note: Tag: para
en: Details of this project can be found at <link xlink:href="http://trac.osgeo.org/postgis/wiki/UsersWikiPostgisTopology">PostGIS Topology Wiki</link>
fr: Les détails sur ce projet peuvent être trouvés à <link xlink:href="http://trac.osgeo.org/postgis/wiki/UsersWikiPostgisTopology">PostGIS Topology Wiki</link>

note: Tag: para
en: All functions and tables associated with this module are installed in a schema called <varname>topology</varname>.
fr: Toutes les fonctions et toutes les tables associées à ce module sont installées dans un schéma appelé <varname>topology</varname>.

note: Tag: para
en: Functions that are defined in SQL/MM standard are prefixed with ST_ and functions specific to PostGIS are not prefixed.
fr: Les fonctions qui sont définies dans le standard SQL/MM sont préfixées par ST_ et les fonctions spécifiques à PostGIS ne sont pas préfixées.

note: Tag: para
en: Topology support is build by default starting with PostGIS 2.0, and can be disabled specifying --without-topology configure option at build time as described in <xref linkend="postgis_installation"/>
fr: Le support topologique est compilé par défaut à partir de PostGIS 2.0, et peut être désactivé en spécifiant l'option de configuration --without-topology au moment de la construction, comme décrit dans <xref linkend="postgis_installation"/>

note: Tag: title
en: Topology Types
fr: Les types associés à "Topology"

note: Tag: para
en: This section lists the PostgreSQL data types installed by PostGIS Topology. Note we describe the casting behavior of these which is very important especially when designing your own functions.
fr: Cette section liste les types de données de PostgreSQL installés par "PostGIS Topology". Notez que nous décrivons leurs comportements de transtypage, ce qui est très important en particulièrement lorsque l'on définit ses propres fonctions.

note: Tag: refpurpose
en: A composite type that consists of a sequence number and an edge number.
fr: Type composite composé d'un numéro de séquence et d'un numéro d'arête.

note: Tag: para
en: A composite type that consists of a sequence number and an edge number. This is the return type for <varname>ST_GetFaceEdges</varname> and <varname>GetNodeEdges</varname> functions.
fr: Type composite composé d'un numéro de séquence et d'un numéro d'arête. Il s'agit du type de retour pour les fonctions <varname>ST_GetFaceEdges</varname> et <varname>GetNodeEdges</varname>.

note: Tag: para
en: <varname>sequence</varname> is an integer: Refers to a topology defined in the topology.topology table which defines the topology schema and srid.
fr: <varname>sequence</varname> est un entier. Il fait référence à un élément topologique défini dans la table topology.topology qui définit le schéma de la topologie et le srid.

note: Tag: para
en: <varname>edge</varname> is an integer: The identifier of an edge.
fr: <varname>edge</varname> est un entier : c'est l'identifiant d'une arête.

note: Tag: refpurpose
en: A composite type representing a topologically defined geometry.
fr: Un type composite représentant une géométrie topologiquement définie.

note: Tag: para
en: A composite type that refers to a topology geometry in a specific topology layer, having a specific type and a specific id. The elements of a TopoGeometry are the properties: topology_id, layer_id, id integer, type integer.
fr: Un type composite qui fait référence à une géométrie topologique dans une couche topologique spécifique, ayant un type et un identifiant spécifiques. Les éléments d'une TopoGeometry ont les propriétés suivantes : topology_id, layer_id, id integer, type integer.

note: Tag: para
en: <varname>topology_id</varname> is an integer: Refers to a topology defined in the topology.topology table which defines the topology schema and srid.
fr: <varname>topology_id</varname> est un entier : il fait référence à un élément topologique défini dans la table topology.topology qui définit le schéma de la topologie et le srid.

note: Tag: para
en: <varname>layer_id</varname> is an integer: The layer_id in the layers table that the TopoGeometry belongs to. The combination of topology_id, layer_id provides a unique reference in the topology.layers table.
fr: <varname>layer_id</varname> est un entier : L'identifiant de la couche dans la table des couches à laquelle la TopoGeometry appartient. La combinaison de topology_id, layer_id fournit une référence unique dans la table topology.layers.

note: Tag: para
en: <varname>id</varname> is an integer: The id is the autogenerated sequence number that uniquely defines the topogeometry in the respective topology layer.
fr: <varname>id</varname> est un nombre entier : L'id est le numéro de séquence autogénéré qui définit de manière unique la topogeometry dans la couche topologique correspondante.

note: Tag: para
en: <varname>type</varname> integer between 1 - 4 that defines the geometry type: 1:[multi]point, 2:[multi]line, 3:[multi]poly, 4:collection
fr: <varname>type</varname> un entier entre 1 et 4 qui définit le type de la géométrie : 1 : [multi]point, 2 : [multi]line, 3 : [multi]poly, 4 : collection

note: Tag: title
en: Casting Behavior
fr: Transtypages

note: Tag: para
en: This section lists the automatic as well as explicit casts allowed for this data type
fr: Cette section liste les transtypages autorisés pour ce type de donnée, qu'ils soient automatiques ou bien explicites

note: Tag: entry
en: Cast To
fr: Transtypage vers

note: Tag: entry
en: Behavior
fr: Comportement

note: Tag: entry
en: automatic
fr: automatique

note: Tag: refpurpose
en: A composite type that consists of an error message and id1 and id2 to denote location of error. This is the return type for <varname>ValidateTopology</varname>.
fr: Un type composite composé d'un message d'erreur et de id1 et id2 pour indiquer l'emplacement de l'erreur. Il s'agit du type de retour pour <varname>ValidateTopology</varname>.

note: Tag: para
en: A composite type that consists of an error message and two integers. The <xref linkend="ValidateTopology"/> function returns a set of these to denote validation errors and the id1 and id2 to denote the ids of the topology objects involved in the error.
fr: Un type composite composé d'un message d'erreur et de deux nombres entiers. La fonction <xref linkend="ValidateTopology"/> renvoie un ensemble d'entiers pour indiquer les erreurs de validation et les id1 et id2 pour indiquer les id des objets topologiques concernés par l'erreur.

note: Tag: para
en: <varname>error</varname> is varchar: Denotes type of error.
fr: <varname>error</varname> est une variable : Indique le type d'erreur.

note: Tag: para
en: Current error descriptors are: coincident nodes, edge crosses node, edge not simple, edge end node geometry mismatch, edge start node geometry mismatch, face overlaps face,face within face,
fr: Les descripteurs d'erreurs actuels sont les suivants : nœuds coïncidents, arête traversant un nœud, arête non simple, mauvaise correspondance de la géométrie de l'extrémité du nœud, mauvaise correspondance de la géométrie du début du nœud, face chevauchant la face, face à l'intérieur de la face,

note: Tag: para
en: <varname>id1</varname> is an integer: Denotes identifier of edge / face / nodes in error.
fr: <varname>id1</varname> est un nombre entier : Indique l'identifiant de l'arête / de la face / des nœuds en erreur.

note: Tag: para
en: <varname>id2</varname> is an integer: For errors that involve 2 objects denotes the secondary edge / or node
fr: <varname>id2</varname> est un nombre entier : Pour les erreurs qui impliquent 2 objets, indique l'arête / ou le nœud secondaire

note: Tag: title
en: Topology Domains
fr: Domaines de topologie

note: Tag: para
en: This section lists the PostgreSQL domains installed by PostGIS Topology. Domains can be used like object types as return objects of functions or table columns. The distinction between a domain and a type is that a domain is an existing type with a check constraint bound to it.
fr: Cette section énumère les domaines PostgreSQL installés par PostGIS Topology. Les domaines peuvent être utilisés comme des types d'objets, en tant qu'objets de retour de fonctions ou de colonnes de tables. La distinction entre un domaine et un type est qu'un domaine est un type existant avec une contrainte de vérification liée à lui.

note: Tag: refpurpose
en: An array of 2 integers generally used to identify a TopoGeometry component.
fr: Un tableau de 2 entiers généralement utilisé pour identifier un composant TopoGeometry.

note: Tag: para
en: An array of 2 integers used to represent one component of a simple or hierarchical <xref linkend="topogeometry"/>.
fr: Un tableau de 2 entiers utilisé pour représenter une composante d'une <xref linkend="topogeometry"/> simple ou hiérarchique.

note: Tag: para
en: In the case of a simple TopoGeometry the first element of the array represents the identifier of a topological primitive and the second element represents its type (1:node, 2:edge, 3:face). In the case of a hierarchical TopoGeometry the first element of the array represents the identifier of a child TopoGeometry and the second element represents its layer identifier.
fr: Dans le cas d'une TopoGeometry simple, le premier élément du tableau représente l'identifiant d'une primitive topologique et le deuxième élément représente son type (1:nœud, 2:arête, 3:face). Dans le cas d'une TopoGeometry hiérarchique, le premier élément du tableau représente l'identifiant d'une TopoGeometry enfant et le deuxième élément représente son identifiant de couche.

note: Tag: para
en: For any given hierarchical TopoGeometry all child TopoGeometry elements will come from the same child layer, as specified in the topology.layer record for the layer of the TopoGeometry being defined.
fr: Pour une TopoGeometry hiérarchique donnée, tous les éléments TopoGeometry enfants proviendront de la même couche enfant, comme spécifié dans l'enregistrement topology.layer pour la couche de la TopoGeometry en cours de définition.

note: Tag: refpurpose
en: An array of TopoElement objects.
fr: Un tableau d'objets TopoElement.

note: Tag: para
en: An array of 1 or more TopoElement objects, generally used to pass around components of TopoGeometry objects.
fr: Un tableau de 1 ou plusieurs objets TopoElement, généralement utilisé pour transmettre des composants d'objets TopoGeometry.

note: Tag: title
en: Topology and TopoGeometry Management
fr: Gestion de la topologie et de TopoGeometry

note: Tag: para
en: This section lists the Topology functions for building new Topology schemas, validating topologies, and managing TopoGeometry Columns
fr: Cette section énumère les fonctions topologiques permettant de créer de nouveaux schémas topologiques, de valider les topologies et de gérer les colonnes TopoGeometry

note: Tag: refpurpose
en: Adds a topogeometry column to an existing table, registers this new column as a layer in topology.layer and returns the new layer_id.
fr: Ajoute une colonne topogeometry à une table existante, enregistre cette nouvelle colonne en tant que couche dans topology.layer et renvoie le nouveau numéro d'identification de la couche.

note: Tag: para
en: Each TopoGeometry object belongs to a specific Layer of a specific Topology. Before creating a TopoGeometry object you need to create its TopologyLayer. A Topology Layer is an association of a feature-table with the topology. It also contain type and hierarchy information. We create a layer using the AddTopoGeometryColumn() function:
fr: Chaque objet TopoGeometry appartient à une couche spécifique d'une topologie spécifique. Avant de créer un objet TopoGeometry, il faut créer sa couche topologique. Une couche topologique est une association d'une table de caractéristiques avec la topologie. Elle contient également des informations sur le type et la hiérarchie. Nous créons une couche à l'aide de la fonction AddTopoGeometryColumn() :

note: Tag: para
en: This function will both add the requested column to the table and add a record to the topology.layer table with all the given info.
fr: Cette fonction ajoutera la colonne demandée à la table et ajoutera un enregistrement à la table topology.layer avec toutes les informations données.

note: Tag: para
en: If you don't specify [child_layer] (or set it to NULL) this layer would contain Basic TopoGeometries (composed by primitive topology elements). Otherwise this layer will contain hierarchical TopoGeometries (composed by TopoGeometries from the child_layer).
fr: Si vous ne spécifiez pas [child_layer] (ou si vous lui attribuez la valeur NULL), cette couche contiendra des TopoGeometries basiques (composées d'éléments topologiques primitifs). Sinon, cette couche contiendra des TopoGeometries hiérarchiques (composées de TopoGéométries de la couche_enfant).

note: Tag: para
en: Once the layer is created (its id is returned by the AddTopoGeometryColumn function) you're ready to construct TopoGeometry objects in it
fr: Une fois la couche créée (son identifiant est renvoyé par la fonction AddTopoGeometryColumn), vous êtes prêt à y construire des objets TopoGeometry

note: Tag: para
en: Valid <varname>feature_type</varname>s are: POINT, MULTIPOINT, LINE, MULTILINE, POLYGON, MULTIPOLYGON, COLLECTION
fr: Les <varname>feature_type</varname> valides sont : POINT, MULTIPOINT, LINE, MULTILINE, POLYGON, MULTIPOLYGON, COLLECTION

note: Tag: para
en: Availability: 1.1
fr: DIsponibilité : 1.1

note: Tag: refpurpose
en: Renames a topogeometry column
fr: Renomme une colonne topogeometry

note: Tag: para
en: This function changes the name of an existing TopoGeometry column ensuring metadata information about it is updated accordingly.
fr: Cette fonction modifie le nom d'une colonne TopoGeometry existante en veillant à ce que les informations de métadonnées la concernant soient mises à jour en conséquence.

note: Tag: refpurpose
en: Use with caution: Drops a topology schema and deletes its reference from topology.topology table and references to tables in that schema from the geometry_columns table.
fr: À utiliser avec précaution : Abandonne un schéma de topologie et supprime sa référence dans la table topology.topology et les références aux tables de ce schéma dans la table geometry_columns.

note: Tag: para
en: Drops a topology schema and deletes its reference from topology.topology table and references to tables in that schema from the geometry_columns table. This function should be USED WITH CAUTION, as it could destroy data you care about. If the schema does not exist, it just removes reference entries the named schema.
fr: Abandonne un schéma topologique et supprime sa référence dans la table topology.topology et les références aux tables de ce schéma dans la table geometry_columns. Cette fonction doit être utilisée avec précaution, car elle peut détruire des données qui vous sont chères. Si le schéma n'existe pas, elle supprime simplement les entrées de référence du schéma nommé.

note: Tag: para
en: Cascade drops the ma_topo schema and removes all references to it in topology.topology and geometry_columns.
fr: Cascade abandonne le schéma ma_topo et supprime toutes les références à ce schéma dans topology.topology et geometry_columns.

note: Tag: refpurpose
en: Renames a topology
fr: Renomme une topologie

note: Tag: para
en: Renames a topology schema, updating its metadata record in the <varname>topology.topology</varname> table.
fr: Renomme un schéma topologique, en mettant à jour son enregistrement de métadonnées dans la table <varname>topology.topology</varname>.

note: Tag: para
en: Rename a topology from <varname>topo_stage</varname> to <varname>topo_prod</varname>.
fr: Renommer une topologie de <varname>topo_stage</varname> à <varname>topo_prod</varname>.

note: Tag: refpurpose
en: Drops the topogeometry column from the table named <varname>table_name</varname> in schema <varname>schema_name</varname> and unregisters the columns from topology.layer table.
fr: Supprime la colonne topogeometry de la table nommée <varname>table_name</varname> dans le schéma <varname>schema_name</varname> et désenregistre les colonnes de la table topology.layer.

note: Tag: para
en: Drops the topogeometry column from the table named <varname>table_name</varname> in schema <varname>schema_name</varname> and unregisters the columns from topology.layer table. Returns summary of drop status. NOTE: it first sets all values to NULL before dropping to bypass referential integrity checks.
fr: Supprime la colonne topogeometry de la table nommée <varname>table_name</varname> dans le schéma <varname>schema_name</varname> et désenregistre les colonnes de la table topology.layer. Renvoie un résumé de l'état d'abandon. NOTE : il définit d'abord toutes les valeurs à NULL avant de procéder à l'abandon afin de contourner les contrôles d'intégrité référentielle.

note: Tag: refpurpose
en: Adds missing entries to topology.layer table by reading metadata from topo tables.
fr: Ajoute les entrées manquantes à la table topology.layer en lisant les métadonnées des tables topo.

note: Tag: para
en: Adds missing entries to the <varname>topology.layer</varname> table by inspecting topology constraints on tables. This function is useful for fixing up entries in topology catalog after restores of schemas with topo data.
fr: Ajoute les entrées manquantes à la table <varname>topology.layer</varname> en inspectant les contraintes topologiques sur les tables. Cette fonction est utile pour corriger les entrées dans le catalogue topologique après la restauration de schémas contenant des données topographiques.

note: Tag: para
en: It returns the list of entries created. Returned columns are <varname>schema_name</varname>, <varname>table_name</varname>, <varname>feature_column</varname>.
fr: Elle renvoie la liste des entrées créées. Les colonnes retournées sont <varname>schema_name</varname>, <varname>table_name</varname>, <varname>feature_column</varname>.

note: Tag: para
en: Availability: 2.3.0
fr: Disponibilité : 2.3.0

note: Tag: refpurpose
en: <refpurpose>Takes a topology name and provides summary totals of types of objects in topology.</refpurpose>
fr: <refpurpose>Prend un nom de topologie et fournit des totaux récapitulatifs des types d'objets dans la topologie.</refpurpose>

note: Tag: para
en: <para>Takes a topology name and provides summary totals of types of objects in topology.</para>
fr: <para>Prend un nom de topologie et fournit des totaux récapitulatifs des types d'objets dans la topologie.</para>

note: Tag: refpurpose
en: Returns a set of validatetopology_returntype objects detailing issues with topology.
fr: Renvoie un ensemble d'objets validatetopology_returntype détaillant les problèmes liés à la topologie.

note: Tag: para
en: Returns a set of <xref linkend="validatetopology_returntype"/> objects detailing issues with topology, optionally limiting the check to the area specified by the <varname>bbox</varname> parameter.
fr: Renvoie un ensemble d'objets <xref linkend="validatetopology_returntype"/> détaillant les problèmes de topologie, en limitant éventuellement la vérification à la zone spécifiée par le paramètre <varname>bbox</varname>.

note: Tag: para
en: List of possible errors, what they mean and what the returned ids represent are displayed below:
fr: La liste des erreurs possibles, ce qu'elles signifient et ce que représentent les identifiants renvoyés est affichée ci-dessous :

note: Tag: entry
en: Error
fr: Erreur

note: Tag: entry
en: Meaning
fr: Signification

note: Tag: entry
en: coincident nodes
fr: nœuds coïncidents

note: Tag: entry
en: Identifier of first node.
fr: Identifiant du premier nœud.

note: Tag: entry
en: Identifier of second node.
fr: Identifiant du second nœud.

note: Tag: entry
en: Two nodes have the same geometry.
fr: Deux nœuds ont la même géométrie.

note: Tag: entry
en: edge crosses node
fr: l'arête croise le nœud

note: Tag: entry
en: Identifier of the edge.
fr: Identifiant de l'arête.

note: Tag: entry
en: Identifier of the node.
fr: Identifiant du nœud.

note: Tag: entry
en: An edge has a node in its interior. See <xref linkend="ST_Relate"/>.
fr: Une arête a un nœud à l'intérieur. Voir <xref linkend="ST_Relate"/>.

note: Tag: entry
en: invalid edge
fr: arête invalide

note: Tag: entry
en: An edge geometry is invalid. See <xref linkend="ST_IsValid"/>.
fr: La géométrie d'une arête n'est pas valide. Voir <xref linkend="ST_IsValid"/>.

note: Tag: entry
en: edge not simple
fr: l'arête n'est pas simple

note: Tag: entry
en: An edge geometry has self-intersections. See <xref linkend="ST_IsSimple"/>.
fr: Une géométrie d'arête possède des auto-intersections. Voir <xref linkend="ST_IsSimple"/>.

note: Tag: entry
en: edge crosses edge
fr: une arête croise une arête

note: Tag: entry
en: Identifier of first edge.
fr: Identifiant de la première arête.

note: Tag: entry
en: Identifier of second edge.
fr: Identifiant de la deuxième arête.

note: Tag: entry
en: Two edges have an interior intersection. See <xref linkend="ST_Relate"/>.
fr: Deux arêtes ont une intersection intérieure. Voir <xref linkend="ST_Relate"/>.

note: Tag: entry
en: edge start node geometry mismatch
fr: arête début nœud géométrie inadéquate

note: Tag: entry
en: Identifier of the indicated start node.
fr: Identifiant du nœud de départ indiqué.

note: Tag: entry
en: The geometry of the node indicated as the starting node for an edge does not match the first point of the edge geometry. See <xref linkend="ST_StartPoint"/>.
fr: La géométrie du nœud indiqué comme nœud de départ d'une arête ne correspond pas au premier point de la géométrie de l'arête. Voir <xref linkend="ST_StartPoint"/>.

note: Tag: entry
en: edge end node geometry mismatch
fr: arête extrémité nœud géométrie non conforme

note: Tag: entry
en: Identifier of the indicated end node.
fr: Identifiant du nœud final indiqué.

note: Tag: entry
en: The geometry of the node indicated as the ending node for an edge does not match the last point of the edge geometry. See <xref linkend="ST_EndPoint"/>.
fr: La géométrie du nœud indiqué comme nœud final d'une arête ne correspond pas au dernier point de la géométrie de l'arête. Voir <xref linkend="ST_EndPoint"/>.

note: Tag: entry
en: face without edges
fr: face sans arêtes

note: Tag: entry
en: Identifier of the orphaned face.
fr: Identifiant de la face orpheline.

note: Tag: entry
en: No edge reports an existing face on either of its sides (left_face, right_face).
fr: Aucune arête ne signale une face existante sur l'un ou l'autre de ses côtés (face_gauche, face_droite).

note: Tag: entry
en: face has no rings
fr: la face n'a pas d'anneaux

note: Tag: entry
en: Identifier of the partially-defined face.
fr: Identifiant de la face partiellement définie.

note: Tag: entry
en: Edges reporting a face on their sides do not form a ring.
fr: Les arêtes rapportant une face sur leurs côtés ne forment pas un anneau.

note: Tag: entry
en: face has wrong mbr
fr: la face n'a pas le bon mbr (minimum bounding rectangle)

note: Tag: entry
en: Identifier of the face with wrong mbr cache.
fr: Identifiant de la face avec un cache mbr (minimum bounding rectangle) erroné.

note: Tag: entry
en: Minimum bounding rectangle of a face does not match minimum bounding box of the collection of edges reporting the face on their sides.
fr: Le rectangle minimal de délimitation d'une face ne correspond pas au rectangle minimal de délimitation de la collection d'arêtes rapportant la face sur leurs côtés.

note: Tag: entry
en: hole not in advertised face
fr: le trou n'est pas dans la face annoncée

note: Tag: entry
en: Signed identifier of an edge, identifying the ring. See <xref linkend="GetRingEdges"/>.
fr: Identifiant signé d'une arête, identifiant l'anneau. Voir <xref linkend="GetRingEdges"/>.

note: Tag: entry
en: A ring of edges reporting a face on its exterior is contained in different face.
fr: Un anneau d'arêtes rapportant une face sur son extérieur est contenu dans une face différente.

note: Tag: entry
en: not-isolated node has not- containing_face
fr: le nœud non isolé a une face non-contenante

note: Tag: entry
en: Identifier of the ill-defined node.
fr: Identifiant du nœud mal défini.

note: Tag: entry
en: A node which is reported as being on the boundary of one or more edges is indicating a containing face.
fr: Un nœud signalé comme étant à la limite d'une ou plusieurs arêtes indique une face contenante.

note: Tag: entry
en: isolated node has containing_face
fr: le nœud isolé a une face contenante

note: Tag: entry
en: A node which is not reported as being on the boundary of any edges is lacking the indication of a containing face.
fr: Un nœud qui n'est pas signalé comme étant à la limite d'une arête n'a pas l'indication d'une face contenante.

note: Tag: entry
en: isolated node has wrong containing_face
fr: Le nœud isolé n'a pas la bonne face contenante

note: Tag: entry
en: Identifier of the misrepresented node.
fr: Identifiant du nœud mal représenté.

note: Tag: entry
en: A node which is not reported as being on the boundary of any edges indicates a containing face which is not the actual face containing it. See <xref linkend="GetFaceContainingPoint"/>.
fr: Un nœud qui n'est pas signalé comme étant à la limite d'une arête indique une face contenante qui n'est pas la face réelle qui le contient. Voir <xref linkend="GetFaceContainingPoint"/>.

note: Tag: entry
en: invalid next_right_edge
fr: next_right_edge invalide

note: Tag: entry
en: Identifier of the misrepresented edge.
fr: Identifiant de l'arête mal représentée.

note: Tag: entry
en: Signed id of the edge which should be indicated as the next right edge.
fr: Identifiant signé de l'arête qui doit être indiqué comme la prochaine arête droite.

note: Tag: entry
en: The edge indicated as the next edge encountered walking on the right side of an edge is wrong.
fr: L'arête indiquée comme le prochaine arête rencontrée en évoluant sur le côté droit d'une arête est faux.

note: Tag: entry
en: invalid next_left_edge
fr: next_left_edge invalide

note: Tag: entry
en: Signed id of the edge which should be indicated as the next left edge.
fr: Identifiant signé de l'arête qui doit être indiquée comme l'arête gauche suivante.

note: Tag: entry
en: The edge indicated as the next edge encountered walking on the left side of an edge is wrong.
fr: L'arête indiquée comme la prochaine arête rencontrée en évoluant sur le côté gauche d'une arête est faux.

note: Tag: entry
en: mixed face labeling in ring
fr: étiquetage mixte des faces dans l'anneau

note: Tag: entry
en: Edges in a ring indicate conflicting faces on the walking side. This is also known as a "Side Location Conflict".
fr: Les arêtes d'un anneau indiquent des faces conflictuelles dans le sens de la progression. C'est ce que l'on appelle un "Side Location Conflict" (Conflit d'emplacement latéral).

note: Tag: entry
en: non-closed ring
fr: anneau non fermé

note: Tag: entry
en: A ring of edges formed by following next_left_edge/next_right_edge attributes starts and ends on different nodes.
fr: Un anneau d'arêtes formé par les attributs next_left_edge/next_right_edge commence et se termine sur différents nœuds.

note: Tag: entry
en: face has multiple shells
fr: la face a plusieurs enveloppes

note: Tag: entry
en: Identifier of the contended face.
fr: Identifiant de la face contestée.

note: Tag: entry
en: More than a one ring of edges indicate the same face on its interior.
fr: Plus d'un anneau d'arêtes indique la même face à l'intérieur.

note: Tag: para
en: Availability: 1.0.0
fr: Disponibilité : 1.0.0

note: Tag: para
en: Enhanced: 2.0.0 more efficient edge crossing detection and fixes for false positives that were existent in prior versions.
fr: Amélioration : 2.0.0 détection plus efficace des croisements d'arêtes et correction des faux positifs qui existaient dans les versions précédentes.

note: Tag: para
en: Changed: 2.2.0 values for id1 and id2 were swapped for 'edge crosses node' to be consistent with error description.
fr: Modifié : 2.2.0 les valeurs pour id1 et id2 ont été échangées pour "edge crosses node" pour être cohérent avec la description de l'erreur.

note: Tag: para
en: Changed: 3.2.0 added optional bbox parameter, perform face labeling and edge linking checks.
fr: Modifié : 3.2.0 a ajouté le paramètre optionnel bbox, effectuant des vérifications de l'étiquetage des faces et de la liaison des arêtes.

note: Tag: refpurpose
en: Returns info about invalid topology relation records
fr: Renvoie des informations sur les enregistrements de relations topologiques non valides

note: Tag: para
en: Returns a set records giving information about invalidities in the relation table of the topology.
fr: Renvoie un ensemble d'enregistrements donnant des informations sur les invalidités dans la table des relations de la topologie.

note: Tag: para
en: Availability: 3.2.0
fr: Disponibilité : 3.2.0

note: Tag: refpurpose
en: Returns a topology record by different means.
fr: Renvoie un enregistrement topologique par différents moyens.

note: Tag: para
en: Takes a topology identifier or the identifier of a topology-related object and returns a topology.topology record.
fr: Prend un identifiant de topologie ou l'identifiant d'un objet lié à la topologie et renvoie un enregistrement topology.topology.

note: Tag: refpurpose
en: Returns a topology.layer record by different means.
fr: Renvoie un enregistrement topology.layer par différents moyens.

note: Tag: para
en: Takes a layer identifier or the identifier of a topology-related object and returns a topology.layer record.
fr: Prend un identifiant de couche ou l'identifiant d'un objet lié à la topologie et renvoie un enregistrement topology.layer.

note: Tag: title
en: Topology Statistics Management
fr: Gestion des statistiques de topologie

note: Tag: para
en: This section discusses management of database statistics during topology building.
fr: Cette section traite de la gestion des statistiques de la base de données pendant la construction de la topologie.

note: Tag: para
en: Adding elements to a topology triggers many database queries for finding existing edges that will be split, adding nodes and updating edges that will node with the new linework. For this reason it is useful that statistics about the data in the topology tables are up-to-date.
fr: L'ajout d'éléments à une topologie déclenche de nombreuses requêtes dans la base de données pour trouver les arêtes existantes qui seront divisées, ajouter des nœuds et mettre à jour les arêtes qui formeront un nœud avec le nouveau réseau de lignes. C'est pourquoi il est utile que les statistiques relatives aux données contenues dans les tables de topologie soient à jour.

note: Tag: para
en: PostGIS Topology population and editing functions do not automatically update the statistics because a updating stats after each and every change in a topology would be overkill, so it is the caller's duty to take care of that.
fr: Les fonctions d'insertion et d'édition de topologie de PostGIS ne mettent pas automatiquement à jour les statistiques, car une mise à jour des statistiques après chaque changement dans une topologie serait exagérée, et c'est donc à l'appelant de s'en charger.

note: Tag: para
en: That the statistics updated by autovacuum will NOT be visible to transactions which started before autovacuum process completed, so long-running transactions will need to run ANALYZE themselves, to use updated statistics.
fr: Les statistiques mises à jour par autovacuum ne seront PAS visibles pour les transactions qui ont démarré avant la fin du processus d'autovacuum, de sorte que les transactions de longue durée devront exécuter ANALYZE elles-mêmes, pour utiliser les statistiques mises à jour.

note: Tag: title
en: Topology Constructors
fr: Constructeurs de topologie

note: Tag: para
en: This section covers the topology functions for creating new topologies.
fr: Cette section couvre les fonctions de topologie permettant de créer de nouvelles topologies.

note: Tag: refpurpose
en: Creates a new topology schema and registers it in the topology.topology table.
fr: Crée un nouveau schéma topologique et l'enregistre dans la table topology.topology.

note: Tag: para
en: Creates a new topology schema with name <varname>topology_name</varname> and registers it in the <varname>topology.topology</varname> table. Topologies must be uniquely named. The topology tables (<varname>edge_data</varname>, <varname>face</varname>, <varname>node</varname>,and <varname>relation</varname> are created in the schema. It returns the id of the topology.
fr: Crée un nouveau schéma de topologie portant le nom <varname>topology_name</varname> et l'enregistre dans la table <varname>topology.topology</varname>. Les topologies doivent porter un nom unique. Les tables de topologie (<varname>edge_data</varname>, <varname>face</varname>, <varname>node</varname> et <varname>relation</varname>) sont créées dans le schéma. Elle renvoie l'identifiant de la topologie.

note: Tag: para
en: The <varname>srid</varname> is the <link linkend="spatial_ref_sys">spatial reference system</link> SRID for the topology.
fr: Le <varname>srid</varname> est le <link linkend="spatial_ref_sys">système de référence spatiale</link> SRID pour la topologie.

note: Tag: para
en: The tolerance <varname>prec</varname> is measured in the units of the spatial reference system. The tolerance defaults to 0.
fr: La tolérance <varname>prec</varname> est mesurée dans les unités du système de référence spatiale. La tolérance est fixée par défaut à 0.

note: Tag: para
en: <varname>hasz</varname> defaults to false if not specified.
fr: <varname>hasz</varname> La valeur par défaut est false si elle n'est pas spécifiée.

note: Tag: para
en: This is similar to the SQL/MM <xref linkend="ST_InitTopoGeo"/> but has more functionality.
fr: Cette fonction est similaire à la fonction SQL/MM <xref linkend="ST_InitTopoGeo"/> mais possède plus de fonctionnalités.

note: Tag: para
en: Enhanced: 2.0 added the signature accepting hasZ
fr: Amélioration : 2.0 ajout de la signature acceptant hasZ

note: Tag: para
en: Create a topology schema called <varname>ma_topo</varname> that stores edges and nodes in Massachusetts State Plane-meters (SRID = 26986). The tolerance represents 0.5 meters since the spatial reference system is meter-based.
fr: Créez un schéma topologique appelé <varname>ma_topo</varname> qui stocke les arêtes et les nœuds en mètres de Massachusetts State Plane (SRID = 26986). La tolérance est de 0,5 mètre puisque le système de référence spatiale est basé sur le mètre.

note: Tag: para
en: Create a topology for Rhode Island called <varname>ri_topo</varname> in spatial reference system State Plane-feet (SRID = 3438)
fr: Créer une topologie pour Rhode Island appelée <varname>ri_topo</varname> dans le système de référence spatiale State Plane-feet (SRID = 3438)

note: Tag: refpurpose
en: Makes a copy of a topology (nodes, edges, faces, layers and TopoGeometries) into a new schema
fr: Copie une topologie (nœuds, arêtes, faces, couches et TopoGeometries) dans un nouveau schéma

note: Tag: para
en: Creates a new topology with name <varname>new_name</varname>, with SRID and precision copied from <varname>existing_topology_name</varname> The nodes, edges and faces in <varname>existing_topology_name</varname> are copied into the new topology, as well as Layers and their associated TopoGeometries.
fr: Crée une nouvelle topologie avec le nom <varname>new_name</varname>, avec le SRID et la précision copiés à partir de <varname>existing_topology_name</varname> Les nœuds, les arêtes et les faces dans <varname>existing_topology_name</varname> sont copiés dans la nouvelle topologie, ainsi que les couches et leurs TopoGeometries associées.

note: Tag: para
en: The new rows in the <varname>topology.layer</varname> table contain synthetic values for schema_name, table_name and feature_column. This is because the TopoGeometry objects exist only as a definition and are not yet available in a user-defined table.
fr: Les nouvelles lignes de la table <varname>topology.layer</varname> contiennent des valeurs synthétiques pour schema_name, table_name et feature_column. Ceci est dû au fait que les objets TopoGeometry n'existent qu'en tant que définition et ne sont pas encore disponibles dans une table définie par l'utilisateur.

note: Tag: para
en: Make a backup of a topology called <varname>ma_topo</varname>.
fr: Faire une sauvegarde d'une topologie appelée <varname>ma_topo</varname>.

note: Tag: para
en: This is the SQL-MM equivalent of <xref linkend="CreateTopology"/>. It lacks options for spatial reference system and tolerance. it returns a text description of the topology creation, instead of the topology id.
fr: C'est l'équivalent SQL-MM de <xref linkend="CreateTopology"/>. Il manque des options pour le système de référence spatial et la tolérance. Il renvoie une description textuelle de la création de la topologie, au lieu de l'identifiant de la topologie.

note: Tag: para
en: &sqlmm_compliant; SQL-MM 3 Topo-Geo and Topo-Net 3: Routine Details: X.3.17
fr: &sqlmm_compliant; SQL-MM 3 Topo-Geo et Topo-Net 3 : Routine Details : X.3.17

note: Tag: refpurpose
en: <refpurpose>Adds a collection of geometries to a given empty topology and returns a message detailing success.</refpurpose>
fr: <refpurpose> Ajoute une collection de géométries à une topologie vide donnée et renvoie un message détaillant le succès.</refpurpose>

note: Tag: para
en: <para>Adds a collection of geometries to a given empty topology and returns a message detailing success.</para>
fr: <para>Ajoute une collection de géométries à une topologie vide donnée et renvoie un message détaillant le succès.</para>

note: Tag: para
en: Useful for populating an empty topology.
fr: Utile pour remplir une topologie vide.

note: Tag: para
en: Availability: 2.0
fr: Disponibilité : 2.0

note: Tag: para
en: &sqlmm_compliant; SQL-MM: Topo-Geo and Topo-Net 3: Routine Details -- X.3.18
fr: &sqlmm_compliant; SQL-MM: Topo-Geo et Topo-Net 3: Routine Details -- X.3.18

note: Tag: refpurpose
en: Adds a point to an existing topology using a tolerance and possibly splitting an existing edge.
fr: Ajoute un point à une topologie existante en utilisant une tolérance et en divisant éventuellement une arête existante.

note: Tag: para
en: Adds a point to an existing topology and returns its identifier. The given point will snap to existing nodes or edges within given tolerance. An existing edge may be split by the snapped point.
fr: Ajoute un point à une topologie existante et renvoie son identifiant. Le point donné s'accroche aux nœuds ou aux arêtes existants dans la limite d'une tolérance donnée. Une arête existante peut être divisée par le point accroché.

note: Tag: para
en: Updating statistics about topologies being loaded via this function is up to caller, see <xref linkend="Topology_StatsManagement"/>.
fr: La mise à jour des statistiques sur les topologies chargées via cette fonction est du ressort de l'appelant, voir <xref linkend="Topology_StatsManagement"/>.

note: Tag: refpurpose
en: Adds a polygon to an existing topology using a tolerance and possibly splitting existing edges/faces. Returns face identifiers.
fr: Ajoute un polygone à une topologie existante en utilisant une tolérance et en divisant éventuellement les arêtes/faces existantes. Renvoie les identifiants des faces.

note: Tag: para
en: Adds a polygon to an existing topology and returns a set of face identifiers forming it up. The boundary of the given polygon will snap to existing nodes or edges within given tolerance. Existing edges and faces may be split by the boundary of the new polygon.
fr: Ajoute un polygone à une topologie existante et renvoie un ensemble d'identifiants de face le constituant. La limite du polygone donné s'accrochera aux nœuds ou aux arêtes existants dans la limite d'une tolérance donnée. Les arêtes et les faces existantes peuvent être divisées par la limite du nouveau polygone.

note: Tag: refpurpose
en: Load a geometry into an existing topology, snapping and splitting as needed.
fr: Charge une géométrie dans une topologie existante, en effectuant de l'accrochage et des divisions si nécessaire.

note: Tag: para
en: Loads a geometry into an existing topology. The given geometry will snap to existing nodes or edges within given tolerance. Existing edges and faces may be split as a consequence of the load.
fr: Charge une géométrie dans une topologie existante. La géométrie donnée s'accrochera aux nœuds ou au arêtes existantes dans la limite d'une tolérance donnée. Les arêtes et les faces existantes peuvent être divisées suite au chargement.

note: Tag: para
en: Availability: 3.5.0
fr: Disponibilité : 3.5.0

note: Tag: title
en: Topology Editors
fr: Éditeurs de topologie

note: Tag: para
en: This section covers topology functions for adding, moving, deleting, and splitting edges, faces, and nodes. All of these functions are defined by ISO SQL/MM.
fr: Cette section traite des fonctions topologiques permettant d'ajouter, de déplacer, de supprimer et de diviser des arêtes, des faces et des nœuds. Toutes ces fonctions sont définies par ISO SQL/MM.

note: Tag: refpurpose
en: Adds an isolated node to a face in a topology and returns the nodeid of the new node. If face is null, the node is still created.
fr: Ajoute un noeud isolé à une face dans une topologie et renvoie le nodeid du nouveau noeud. Si la face est nulle, le noeud est quand même créé.

note: Tag: para
en: Adds an isolated node with point location <varname>apoint</varname> to an existing face with faceid <varname>aface</varname> to a topology <varname>atopology</varname> and returns the nodeid of the new node.
fr: Ajoute un noeud isolé avec un point <varname>apoint</varname> à une face existante avec un faceid <varname>aface</varname> à une topologie <varname>atopology</varname> et renvoie le nodeid du nouveau noeud.

note: Tag: para
en: If the spatial reference system (srid) of the point geometry is not the same as the topology, the <varname>apoint</varname> is not a point geometry, the point is null, or the point intersects an existing edge (even at the boundaries) then an exception is thrown. If the point already exists as a node, an exception is thrown.
fr: Si le système de référence spatiale (srid) de la géométrie du point n'est pas le même que la topologie, si le <varname>apoint</varname> n'est pas une géométrie de point, si le point est nul ou si le point croise une arête existante (même aux limites), une exception est levée. Si le point existe déjà en tant que nœud, une exception est levée.

note: Tag: para
en: If <varname>aface</varname> is not null and the <varname>apoint</varname> is not within the face, then an exception is thrown.
fr: Si <varname>aface</varname> n'est pas null et que le <varname>apoint</varname> n'est pas à l'intérieur de la face, une exception est levée.

note: Tag: para
en: &sqlmm_compliant; SQL-MM: Topo-Net Routines: X+1.3.1
fr: &sqlmm_compliant; SQL-MM: Topo-Net Routines : X+1.3.1

note: Tag: refpurpose
en: <refpurpose>Adds an isolated edge defined by geometry <varname>alinestring</varname> to a topology connecting two existing isolated nodes <varname>anode</varname> and <varname>anothernode</varname> and returns the edge id of the new edge.</refpurpose>
fr: <refpurpose> Ajoute une arête isolée définie par la géométrie <varname>alinestring</varname> à une topologie reliant deux nœuds isolés existants <varname>anode</varname> et <varname>anothernode</varname> et renvoie l'identifiant de l'arête de la nouvelle arête.</refpurpose>

note: Tag: para
en: <para>Adds an isolated edge defined by geometry <varname>alinestring</varname> to a topology connecting two existing isolated nodes <varname>anode</varname> and <varname>anothernode</varname> and returns the edge id of the new edge.</para>
fr: <para>Ajoute une arête isolée définie par la géométrie <varname>alinestring</varname> à une topologie reliant deux nœuds isolés existants <varname>anode</varname> et <varname>anothernode</varname> et renvoie l'identifiant de l'arête de la nouvelle arête.</para>

note: Tag: para
en: If the spatial reference system (srid) of the <varname>alinestring</varname> geometry is not the same as the topology, any of the input arguments are null, or the nodes are contained in more than one face, or the nodes are start or end nodes of an existing edge, then an exception is thrown.
fr: Si le système de référence spatiale (srid) de la géométrie <varname>alinestring</varname> n'est pas le même que la topologie, si l'un des arguments d'entrée est nul, si les noeuds sont contenus dans plus d'une face, ou si les noeuds sont des noeuds de départ ou d'arrivée d'une arête existante, une exception est levée.

note: Tag: para
en: If the <varname>alinestring</varname> is not within the face of the face the <varname>anode</varname> and <varname>anothernode</varname> belong to, then an exception is thrown.
fr: Si le <varname>alinestring</varname> ne se trouve pas à l'intérieur de la face à laquelle appartiennent le <varname>anode</varname> et le <varname>anothernode</varname>, une exception est levée.

note: Tag: para
en: If the <varname>anode</varname> and <varname>anothernode</varname> are not the start and end points of the <varname>alinestring</varname> then an exception is thrown.
fr: Si le <varname>anode</varname> et le <varname>anothernode</varname> ne sont pas les points de départ et d'arrivée du <varname>alinestring</varname>, une exception est levée.

note: Tag: para
en: &sqlmm_compliant; SQL-MM: Topo-Geo and Topo-Net 3: Routine Details: X.3.4
fr: &sqlmm_compliant; SQL-MM: Topo-Geo et Topo-Net 3: Routine Details: X.3.4

note: Tag: refpurpose
en: Add a new edge and, if in doing so it splits a face, delete the original face and replace it with two new faces.
fr: Ajoutez une nouvelle arête et, si elle divise une face, supprimez la face d'origine et remplacez-la par deux nouvelles faces.

note: Tag: para
en: Add a new edge and, if in doing so it splits a face, delete the original face and replace it with two new faces. Returns the id of the newly added edge.
fr: Ajoutez une nouvelle arête et, si elle divise une face, supprimez la face d'origine et remplacez-la par deux nouvelles faces. Renvoie l'identifiant de l'arête nouvellement ajoutée.

note: Tag: para
en: Updates all existing joined edges and relationships accordingly.
fr: Met à jour toutes les arêtes jointes existantes et les relations en conséquence.

note: Tag: para
en: If any arguments are null, the given nodes are unknown (must already exist in the <varname>node</varname> table of the topology schema) , the <varname>acurve</varname> is not a <varname>LINESTRING</varname>, the <varname>anode</varname> and <varname>anothernode</varname> are not the start and endpoints of <varname>acurve</varname> then an error is thrown.
fr: Si l'un des arguments est nul, les nœuds donnés sont inconnus (doivent déjà exister dans la table <varname>node</varname> du schéma topologique), la <varname>acurve</varname> n'est pas une <varname>LINESTRING</varname>, le <varname>anode</varname> et <varname>anothernode</varname> ne sont pas les points de départ et d'arrivée de <varname>acurve</varname>, une erreur est générée.

note: Tag: para
en: If the spatial reference system (srid) of the <varname>acurve</varname> geometry is not the same as the topology an exception is thrown.
fr: Si le système de référence spatiale (srid) de la géométrie <varname>acurve</varname> n'est pas le même que la topologie, une exception est levée.

note: Tag: para
en: &sqlmm_compliant; SQL-MM: Topo-Geo and Topo-Net 3: Routine Details: X.3.12
fr: &sqlmm_compliant; SQL-MM: Topo-Geo et Topo-Net 3: Routine Details: X.3.12

note: Tag: refpurpose
en: Add a new edge and, if in doing so it splits a face, modify the original face and add a new face.
fr: Ajoutez une nouvelle arête et, si elle divise une face, modifiez la face d'origine et ajoutez une nouvelle face.

note: Tag: para
en: Add a new edge and, if doing so splits a face, modify the original face and add a new one.
fr: Ajouter une nouvelle arête et, si cela divise une face, modifier la face d'origine et en ajouter une nouvelle.

note: Tag: para
en: If possible, the new face will be created on left side of the new edge. This will not be possible if the face on the left side will need to be the Universe face (unbounded).
fr: Si possible, la nouvelle face sera créée sur le côté gauche de la nouvelle arête. Cela ne sera pas possible si la face du côté gauche doit être la face de l'univers (non borné).

note: Tag: para
en: Returns the id of the newly added edge.
fr: Renvoie l'identifiant de l'arête nouvellement ajoutée.

note: Tag: para
en: &sqlmm_compliant; SQL-MM: Topo-Geo and Topo-Net 3: Routine Details: X.3.13
fr: &sqlmm_compliant; SQL-MM: Topo-Geo et Topo-Net 3: Routine Details: X.3.13

note: Tag: refpurpose
en: <refpurpose>Removes an edge and, if the removed edge separated two faces, delete the original faces and replace them with a new face.</refpurpose>
fr: <refpurpose>Enlève une arête et, si l'arête enlevée séparait deux faces, supprime les faces originales et les remplace par une nouvelle face.</refpurpose>

note: Tag: para
en: <para>Removes an edge and, if the removed edge separated two faces, delete the original faces and replace them with a new face.</para>
fr: <para>Supprime une arête et, si l'arête supprimée séparait deux faces, supprime les faces originales et les remplace par une nouvelle face.</para>

note: Tag: para
en: Returns the id of a newly created face or NULL, if no new face is created. No new face is created when the removed edge is dangling or isolated or confined with the universe face (possibly making the universe flood into the face on the other side).
fr: Renvoie l'identifiant d'une face nouvellement créée ou NULL, si aucune nouvelle face n'est créée. Aucune nouvelle face n'est créée lorsque l'arête supprimée est pendante, isolée ou confinée avec la face de l'univers (ce qui peut entraîner "l'inondation de la face" de l'autre côté de l'univers).

note: Tag: para
en: Refuses to remove an edge participating in the definition of an existing TopoGeometry. Refuses to heal two faces if any TopoGeometry is defined by only one of them (and not the other).
fr: Refuse de supprimer une arête participant à la définition d'une TopoGeometry existante. Refuse de recoller deux faces si une TopoGeometry n'est définie que par l'une d'entre elles (et non par l'autre).

note: Tag: para
en: If any arguments are null, the given edge is unknown (must already exist in the <varname>edge</varname> table of the topology schema), the topology name is invalid then an error is thrown.
fr: Si l'un des arguments est nul, si l'arête donnée est inconnue (elle doit déjà exister dans la table <varname>edge</varname> du schéma topologique), si le nom de la topologie n'est pas valide, une erreur est générée.

note: Tag: para
en: &sqlmm_compliant; SQL-MM: Topo-Geo and Topo-Net 3: Routine Details: X.3.14
fr: &sqlmm_compliant; SQL-MM: Topo-Geo et Topo-Net 3: Routine Details: X.3.14

note: Tag: refpurpose
en: Removes an edge, and if the edge separates two faces deletes one face and modifies the other face to cover the space of both.
fr: Supprime une arête et, si l'arête sépare deux faces, supprime une face et modifie l'autre face pour couvrir l'espace des deux.

note: Tag: para
en: Removes an edge, and if the removed edge separates two faces deletes one face and modifies the other face to cover the space of both. Preferentially keeps the face on the right, to be consistent with <xref linkend="ST_AddEdgeModFace"/>. Returns the id of the face which is preserved.
fr: Supprime une arête et, si l'arête supprimée sépare deux faces, supprime une face et modifie l'autre face pour couvrir l'espace des deux. La face de droite est conservée de préférence, par souci de cohérence avec <xref linkend="ST_AddEdgeModFace"/>. Renvoie l'identifiant de la face conservée.

note: Tag: para
en: &sqlmm_compliant; SQL-MM: Topo-Geo and Topo-Net 3: Routine Details: X.3.15
fr: &sqlmm_compliant; SQL-MM: Topo-Geo et Topo-Net 3: Routine Details: X.3.15

note: Tag: refpurpose
en: <refpurpose>Changes the shape of an edge without affecting the topology structure.</refpurpose>
fr: <refpurpose>Modifie la forme d'une arête sans affecter la structure de la topologie.</refpurpose>

note: Tag: para
en: <para>Changes the shape of an edge without affecting the topology structure.</para>
fr: <para>Modifie la forme d'une arête sans affecter la structure de la topologie.</para>

note: Tag: para
en: If any arguments are null, the given edge does not exist in the <varname>edge</varname> table of the topology schema, the <varname>acurve</varname> is not a <varname>LINESTRING</varname>, or the modification would change the underlying topology then an error is thrown.
fr: Si l'un des arguments est nul, si l'arête donnée n'existe pas dans la table <varname>edge</varname> du schéma topologique, si la <varname>acurve</varname> n'est pas une <varname>LINESTRING</varname>, ou si la modification changerait la topologie sous-jacente, une erreur est déclenchée.

note: Tag: para
en: If the new <varname>acurve</varname> is not simple, then an error is thrown.
fr: Si la nouvelle <varname>acurve</varname> n'est pas simple, une erreur est générée.

note: Tag: para
en: If moving the edge from old to new position would hit an obstacle then an error is thrown.
fr: Si le déplacement de l'arête de l'ancienne à la nouvelle position heurte un obstacle, une erreur est générée.

note: Tag: para
en: Availability: 1.1.0
fr: Disponibilité : 1.1.0

note: Tag: para
en: Enhanced: 2.0.0 adds topological consistency enforcement
fr: Amélioration : 2.0.0 ajoute l'application de la cohérence topologique

note: Tag: para
en: &sqlmm_compliant; SQL-MM: Topo-Geo and Topo-Net 3: Routine Details X.3.6
fr: &sqlmm_compliant; SQL-MM: Topo-Geo et Topo-Net 3: Routine Details X.3.6

note: Tag: refpurpose
en: Split an edge by creating a new node along an existing edge, modifying the original edge and adding a new edge.
fr: Fractionner une arête en créant un nouveau nœud le long d'une arête existante, en modifiant l'arête d'origine et en ajoutant une nouvelle arête.

note: Tag: para
en: Split an edge by creating a new node along an existing edge, modifying the original edge and adding a new edge. Updates all existing joined edges and relationships accordingly. Returns the identifier of the newly added node.
fr: Fractionner une arête en créant un nouveau nœud le long d'une arête existante, en modifiant l'arête d'origine et en ajoutant une nouvelle arête. Cette opération met à jour toutes les arêtes jointes existantes et les relations en conséquence. Renvoie l'identifiant du nœud nouvellement ajouté.

note: Tag: para
en: Changed: 2.0 - In prior versions, this was misnamed ST_ModEdgesSplit
fr: Modifié : 2.0 - Dans les versions antérieures, cette fonction était mal nommée ST_ModEdgesSplit

note: Tag: para
en: &sqlmm_compliant; SQL-MM: Topo-Geo and Topo-Net 3: Routine Details: X.3.9
fr: &sqlmm_compliant; SQL-MM: Topo-Geo et Topo-Net 3: Routine Details: X.3.9

note: Tag: refpurpose
en: Heals two edges by deleting the node connecting them, modifying the first edge and deleting the second edge. Returns the id of the deleted node.
fr: Répare deux arêtes en supprimant le nœud qui les relie, en modifiant la première arête et en supprimant la seconde. Renvoie l'identifiant du nœud supprimé.

note: Tag: para
en: Heals two edges by deleting the node connecting them, modifying the first edge and deleting the second edge. Returns the id of the deleted node. Updates all existing joined edges and relationships accordingly.
fr: Répare deux arêtes en supprimant le nœud qui les relie, en modifiant la première arête et en supprimant la seconde. Renvoie l'identifiant du nœud supprimé. Met à jour toutes les arêtes jointes existantes et les relations en conséquence.

note: Tag: refpurpose
en: Heals two edges by deleting the node connecting them, deleting both edges, and replacing them with an edge whose direction is the same as the first edge provided.
fr: Répare deux arêtes en supprimant le nœud qui les relie, en supprimant les deux arêtes et en les remplaçant par une arête dont la direction est la même que la première arête fournie.

note: Tag: para
en: Heals two edges by deleting the node connecting them, deleting both edges, and replacing them with an edge whose direction is the same as the first edge provided. Returns the id of the new edge replacing the healed ones. Updates all existing joined edges and relationships accordingly.
fr: Répare deux arêtes en supprimant le nœud qui les relie, en supprimant les deux arêtes et en les remplaçant par une arête dont la direction est la même que la première arête fournie. Renvoie l'identifiant de la nouvelle arête remplaçant les arêtes réparées. Met à jour toutes les arêtes jointes existantes et les relations en conséquence.

note: Tag: refpurpose
en: Moves an isolated node in a topology from one point to another. If new <varname>apoint</varname> geometry exists as a node an error is thrown. Returns description of move.
fr: Déplace un nœud isolé dans une topologie d'un point à un autre. Si la nouvelle géométrie <varname>apoint</varname> existe en tant que noeud, une erreur est générée. Retourne la description du déplacement.

note: Tag: para
en: Moves an isolated node in a topology from one point to another. If new <varname>apoint</varname> geometry exists as a node an error is thrown.
fr: Déplace un nœud isolé dans une topologie d'un point à un autre. Si la nouvelle géométrie <varname>apoint</varname> existe en tant que noeud, une erreur est générée.

note: Tag: para
en: If any arguments are null, the <varname>apoint</varname> is not a point, the existing node is not isolated (is a start or end point of an existing edge), new node location intersects an existing edge (even at the end points) or the new location is in a different face (since 3.2.0) then an exception is thrown.
fr: Si l'un des arguments est nul, si le <varname>apoint</varname> n'est pas un point, si le noeud existant n'est pas isolé (c'est un point de départ ou d'arrivée d'une arête existante), si l'emplacement du nouveau noeud coupe une arête existante (même aux points d'arrivée) ou si le nouvel emplacement se trouve dans une face différente (depuis la version 3.2.0), une exception est levée.

note: Tag: para
en: If the spatial reference system (srid) of the point geometry is not the same as the topology an exception is thrown.
fr: Si le système de référence spatiale (srid) de la géométrie du point n'est pas le même que la topologie, une exception est levée.

note: Tag: para
en: Enhanced: 3.2.0 ensures the nod cannot be moved in a different face
fr: Amélioration : la version 3.2.0 garantit que le nœud ne peut pas être déplacé vers une autre face

note: Tag: refpurpose
en: Split an edge by creating a new node along an existing edge, deleting the original edge and replacing it with two new edges. Returns the id of the new node created that joins the new edges.
fr: Fractionne une arête en créant un nouveau nœud le long d'une arête existante, en supprimant l'arête d'origine et en la remplaçant par deux nouvelles arêtes. Renvoie l'identifiant du nouveau nœud créé qui relie les nouvelles arêtes.

note: Tag: para
en: Split an edge with edge id <varname>anedge</varname> by creating a new node with point location <varname>apoint</varname> along current edge, deleting the original edge and replacing it with two new edges. Returns the id of the new node created that joins the new edges. Updates all existing joined edges and relationships accordingly.
fr: Divise une arête avec l'identifiant <varname>anedge</varname> en créant un nouveau noeud avec l'emplacement du point <varname>apoint</varname> le long de l'arête actuelle, en supprimant l'arête d'origine et en la remplaçant par deux nouvelles arêtes. Renvoie l'identifiant du nouveau nœud créé qui relie les nouvelles arêtes. Met à jour toutes les arêtes jointes existantes et les relations en conséquence.

note: Tag: para
en: If the spatial reference system (srid) of the point geometry is not the same as the topology, the <varname>apoint</varname> is not a point geometry, the point is null, the point already exists as a node, the edge does not correspond to an existing edge or the point is not within the edge then an exception is thrown.
fr: Si le système de référence spatiale (srid) de la géométrie du point n'est pas le même que la topologie, si le <varname>apoint</varname> n'est pas une géométrie de point, si le point est nul, si le point existe déjà en tant que nœud, si l'arête ne correspond pas à une arête existante ou si le point n'est pas à l'intérieur de l'arête, une exception est levée.

note: Tag: refpurpose
en: <refpurpose>Removes an isolated node and returns description of action. If the node is not isolated (is start or end of an edge), then an exception is thrown.</refpurpose>
fr: <refpurpose>Supprime un noeud isolé et renvoie la description de l'action. Si le noeud n'est pas isolé (début ou fin d'une arête), une exception est levée.</refpurpose>

note: Tag: para
en: <para>Removes an isolated node and returns description of action. If the node is not isolated (is start or end of an edge), then an exception is thrown.</para>
fr: <para>Supprime un noeud isolé et renvoie la description de l'action. Si le nœud n'est pas isolé (est le début ou la fin d'une arête), une exception est levée.</para>

note: Tag: para
en: &sqlmm_compliant; SQL-MM: Topo-Geo and Topo-Net 3: Routine Details: X+1.3.3
fr: &sqlmm_compliant; SQL-MM: Topo-Geo et Topo-Net 3: Routine Details: X+1.3.3

note: Tag: refpurpose
en: <refpurpose>Removes an isolated edge and returns description of action. If the edge is not isolated, then an exception is thrown.</refpurpose>
fr: <refpurpose>Supprime une arête isolée et renvoie la description de l'action. Si l'arête n'est pas isolée, une exception est levée.</refpurpose>

note: Tag: para
en: <para>Removes an isolated edge and returns description of action. If the edge is not isolated, then an exception is thrown.</para>
fr: <para>Supprime une arête isolée et renvoie la description de l'action. Si l'arête n'est pas isolée, une exception est levée.</para>

note: Tag: title
en: Topology Accessors
fr: Accès à la topologie

note: Tag: refpurpose
en: Finds the edge-id of an edge that intersects a given point.
fr: Trouve l'identifiant d'une arête qui coupe un point donné.

note: Tag: para
en: Retrieves the id of an edge that intersects a Point.
fr: Récupère l'identifiant d'une arête qui coupe un point.

note: Tag: para
en: The function returns an integer (id-edge) given a topology, a POINT and a tolerance. If tolerance = 0 then the point has to intersect the edge.
fr: La fonction renvoie un entier (id-edge) à partir d'une topologie, d'un POINT et d'une tolérance. Si la tolérance = 0, le point doit couper l'arête.

note: Tag: para
en: If <varname>apoint</varname> doesn't intersect an edge, returns 0 (zero).
fr: Si <varname>apoint</varname> n'intersecte pas une arête, renvoie 0 (zéro).

note: Tag: para
en: If use tolerance &gt; 0 and there is more than one edge near the point then an exception is thrown.
fr: Si la tolérance d'utilisation &gt; 0 et qu'il y a plus d'une arête près du point, une exception est levée.

note: Tag: para
en: If tolerance = 0, the function uses ST_Intersects otherwise uses ST_DWithin.
fr: Si la tolérance = 0, la fonction utilise ST_Intersects, sinon elle utilise ST_DWithin.

note: Tag: para
en: Performed by the GEOS module.
fr: Effectué par le module GEOS.

note: Tag: para
en: These examples use edges we created in <xref linkend="AddEdge"/>
fr: Ces exemples utilisent les arêtes que nous avons créées dans <xref linkend="AddEdge"/>

note: Tag: refpurpose
en: Finds face intersecting a given point.
fr: Recherche la face intersectant un point donné.

note: Tag: para
en: Finds a face referenced by a Point, with given tolerance.
fr: Recherche une face référencée par un point, avec une tolérance donnée.

note: Tag: para
en: The function will effectively look for a face intersecting a circle having the point as center and the tolerance as radius.
fr: La fonction recherchera effectivement une face coupant un cercle dont le point est le centre et la tolérance le rayon.

note: Tag: para
en: If no face intersects the given query location, 0 is returned (universal face).
fr: Si aucune face n'intersecte l'emplacement de la requête, la valeur 0 est renvoyée (face universelle).

note: Tag: para
en: If more than one face intersect the query location an exception is thrown.
fr: Si plus d'une face croise l'emplacement de la requête, une exception est levée.

note: Tag: para
en: Enhanced: 3.2.0 more efficient implementation and clearer contract, stops working with invalid topologies.
fr: Amélioration : 3.2.0 mise en œuvre plus efficace et contrat plus clair, arrêt du fonctionnement avec des topologies non valides.

note: Tag: refpurpose
en: Finds the face containing a point.
fr: Recherche la face contenant un point.

note: Tag: para
en: Returns the id of the face containing a point.
fr: Renvoie l'identifiant de la face contenant un point.

note: Tag: para
en: An exception is thrown if the point falls on a face boundary.
fr: Une exception est levée si le point tombe sur la limite d'une face.

note: Tag: para
en: The function relies on a valid topology, using edge linking and face labeling.
fr: La fonction repose sur une topologie valide, utilisant la liaison des arêtes et l'étiquetage des faces.

note: Tag: refpurpose
en: Finds the node-id of a node at a point location.
fr: Recherche l'identifiant d'un nœud à un point donné.

note: Tag: para
en: Retrieves the id of a node at a point location.
fr: Récupère l'identifiant d'un nœud à un point donné.

note: Tag: para
en: The function returns an integer (id-node) given a topology, a POINT and a tolerance. If tolerance = 0 means exact intersection, otherwise retrieves the node from an interval.
fr: La fonction renvoie un entier (id-node) à partir d'une topologie, d'un POINT et d'une tolérance. Si tolérance = 0, il s'agit d'une intersection exacte, sinon le nœud est extrait d'un intervalle.

note: Tag: para
en: If <varname>apoint</varname> doesn't intersect a node, returns 0 (zero).
fr: Si <varname>apoint</varname> n'intersecte pas un noeud, renvoie 0 (zéro).

note: Tag: para
en: If use tolerance &gt; 0 and there is more than one node near the point then an exception is thrown.
fr: Si la tolérance d'utilisation &gt; 0 et qu'il y a plus d'un nœud près du point, une exception est levée.

note: Tag: refpurpose
en: <refpurpose>Returns the id of a topology in the topology.topology table given the name of the topology.</refpurpose>
fr: <refpurpose>Retourne l'identifiant d'une topologie dans la table topology.topology étant donné le nom de la topologie.</refpurpose>

note: Tag: para
en: <para>Returns the id of a topology in the topology.topology table given the name of the topology.</para>
fr: <para>Retourne l'identifiant d'une topologie dans la table topology.topology en fonction du nom de la topologie.</para>

note: Tag: refpurpose
en: Returns the SRID of a topology in the topology.topology table given the name of the topology.
fr: Renvoie le SRID d'une topologie dans la table topology.topology en fonction du nom de la topologie.

note: Tag: para
en: Returns the spatial reference id of a topology in the topology.topology table given the name of the topology.
fr: Renvoie l'identifiant de référence spatiale d'une topologie dans la table topology.topology en fonction du nom de la topologie.

note: Tag: refpurpose
en: Returns the name of a topology (schema) given the id of the topology.
fr: Renvoie le nom d'une topologie (schéma) en fonction de l'identifiant de la topologie.

note: Tag: para
en: Returns the topology name (schema) of a topology from the topology.topology table given the topology id of the topology.
fr: Renvoie le nom de la topologie (schéma) d'une topologie de la table topology.topology en fonction de l'identifiant de la topologie.

note: Tag: refpurpose
en: Returns a set of ordered edges that bound <varname>aface</varname>.
fr: Renvoie un ensemble d'arêtes ordonnées qui délimitent <varname>aface</varname>.

note: Tag: para
en: Returns a set of ordered edges that bound <varname>aface</varname>. Each output consists of a sequence and edgeid. Sequence numbers start with value 1.
fr: Renvoie un ensemble d'arêtes ordonnées qui délimitent <varname>aface</varname>. Chaque sortie se compose d'une séquence et d'un numéro d'arête. Les numéros de séquence commencent par la valeur 1.

note: Tag: para
en: Enumeration of each ring edges start from the edge with smallest identifier. Order of edges follows a left-hand-rule (bound face is on the left of each directed edge).
fr: L'énumération des arêtes de chaque anneau commence par l'arête dont l'identifiant est le plus petit. L'ordre des arêtes suit la règle de la main gauche (la face liée se trouve à gauche de chaque arête dirigée).

note: Tag: para
en: &sqlmm_compliant; SQL-MM 3 Topo-Geo and Topo-Net 3: Routine Details: X.3.5
fr: &sqlmm_compliant; SQL-MM 3 Topo-Geo et Topo-Net 3: Routine Details: X.3.5

note: Tag: refpurpose
en: Returns the polygon in the given topology with the specified face id.
fr: Renvoie le polygone dans la topologie donnée avec l'identifiant de face spécifié.

note: Tag: para
en: Returns the polygon in the given topology with the specified face id. Builds the polygon from the edges making up the face.
fr: Renvoie le polygone dans la topologie donnée avec l'identifiant de face spécifié. Construit le polygone à partir des arêtes composant la face.

note: Tag: para
en: &sqlmm_compliant; SQL-MM 3 Topo-Geo and Topo-Net 3: Routine Details: X.3.16
fr: &sqlmm_compliant; SQL-MM 3 Topo-Geo et Topo-Net 3: Routine Details: X.3.16

note: Tag: refpurpose
en: Returns the ordered set of signed edge identifiers met by walking on an a given edge side.
fr: Renvoie l'ensemble ordonné des identifiants d'arêtes signés rencontrés en évoluant sur un côté d'arête donné.

note: Tag: para
en: Returns the ordered set of signed edge identifiers met by walking on an a given edge side. Each output consists of a sequence and a signed edge id. Sequence numbers start with value 1.
fr: Renvoie l'ensemble ordonné des identifiants d'arêtes signés rencontrés en évoluant sur un côté d'arête donné. Chaque sortie se compose d'une séquence et d'un identifiant d'arête signé. Les numéros de séquence commencent par la valeur 1.

note: Tag: para
en: If you pass a positive edge id, the walk starts on the left side of the corresponding edge and follows the edge direction. If you pass a negative edge id, the walk starts on the right side of it and goes backward.
fr: Si vous passez un identifiant d'arête positif, la marche commence du côté gauche de l'arête correspondante et suit la direction de l'arête. Si vous passez un identifiant d'arête négatif, la marche commence du côté droit de l'arête correspondante et va vers l'arrière.

note: Tag: para
en: If <varname>max_edges</varname> is not null no more than those records are returned by that function. This is meant to be a safety parameter when dealing with possibly invalid topologies.
fr: Si <varname>max_edges</varname> n'est pas nul, cette fonction ne renvoie pas plus que ces enregistrements. Il s'agit d'un paramètre de sécurité dans le cas de topologies éventuellement non valides.

note: Tag: para
en: This function uses edge ring linking metadata.
fr: Cette fonction utilise les métadonnées de liaison des anneaux des arêtes.

note: Tag: refpurpose
en: Returns an ordered set of edges incident to the given node.
fr: Renvoie un ensemble ordonné d'arêtes incidentes au nœud donné.

note: Tag: para
en: Returns an ordered set of edges incident to the given node. Each output consists of a sequence and a signed edge id. Sequence numbers start with value 1. A positive edge starts at the given node. A negative edge ends into the given node. Closed edges will appear twice (with both signs). Order is clockwise starting from northbound.
fr: Renvoie un ensemble ordonné d'arêtes incidentes au nœud donné. Chaque sortie se compose d'une séquence et d'un numéro d'arête signé. Les numéros de séquence commencent par la valeur 1. Une arête positive commence au nœud donné. Une arête négative se termine au nœud donné. Les arêtes fermées apparaissent deux fois (avec les deux signes). L'ordre est celui des aiguilles d'une montre en partant du nord.

note: Tag: para
en: This function computes ordering rather than deriving from metadata and is thus usable to build edge ring linking.
fr: Cette fonction calcule l'ordre plutôt que de dériver des métadonnées et peut donc être utilisée pour établir des liens entre les anneaux des arêtes.

note: Tag: title
en: Topology Processing
fr: Traitement de la topologie

note: Tag: para
en: This section covers the functions for processing topologies in non-standard ways.
fr: Cette section couvre les fonctions permettant de traiter les topologies de manière non standard.

note: Tag: refpurpose
en: Finds and registers all faces defined by topology edges.
fr: Recherche et enregistre toutes les faces définies par les arêtes de la topologie.

note: Tag: para
en: Registers all faces that can be built out a topology edge primitives.
fr: Enregistre toutes les faces qui peuvent être construites à partir d'une primitive d'arête topologique.

note: Tag: para
en: The target topology is assumed to contain no self-intersecting edges.
fr: La topologie cible est supposée ne pas contenir d'arêtes s'auto-intersectant.

note: Tag: para
en: Already known faces are recognized, so it is safe to call Polygonize multiple times on the same topology.
fr: Les faces déjà connues sont reconnues, de sorte qu'il est possible d'appeler Polygonize plusieurs fois sur la même topologie.

note: Tag: para
en: This function does not use nor set the next_left_edge and next_right_edge fields of the edge table.
fr: Cette fonction n'utilise ni ne définit les champs next_left_edge et next_right_edge de la table des arêtes.

note: Tag: refpurpose
en: Adds a point node to the node table in the specified topology schema and returns the nodeid of new node. If point already exists as node, the existing nodeid is returned.
fr: Ajoute un nœud ponctuel à la table des nœuds dans le schéma topologique spécifié et renvoie le nodeid du nouveau nœud. Si le point existe déjà en tant que nœud, l'identifiant du nœud existant est renvoyé.

note: Tag: para
en: Adds a point node to the node table in the specified topology schema. The <xref linkend="AddEdge"/> function automatically adds start and end points of an edge when called so not necessary to explicitly add nodes of an edge.
fr: Ajoute un nœud ponctuel à la table des nœuds dans le schéma topologique spécifié. La fonction <xref linkend="AddEdge"/> ajoute automatiquement les points de départ et d'arrivée d'une arête lorsqu'elle est appelée, de sorte qu'il n'est pas nécessaire d'ajouter explicitement les nœuds d'une arête.

note: Tag: para
en: If any edge crossing the node is found either an exception is raised or the edge is split, depending on the <varname>allowEdgeSplitting</varname> parameter value.
fr: Si une arête traversant le nœud est trouvée, une exception est levée ou l'arête est scindée, en fonction de la valeur du paramètre <varname>allowEdgeSplitting</varname>.

note: Tag: para
en: If <varname>computeContainingFace</varname> is true a newly added node would get the correct containing face computed.
fr: Si <varname>computeContainingFace</varname> est true, un nœud nouvellement ajouté verra sa face contenante calculée correctement.

note: Tag: para
en: If the <varname>apoint</varname> geometry already exists as a node, the node is not added but the existing nodeid is returned.
fr: Si la géométrie <varname>apoint</varname> existe déjà en tant que noeud, le noeud n'est pas ajouté mais le nodeid existant est renvoyé.

note: Tag: refpurpose
en: Adds a linestring edge to the edge table and associated start and end points to the point nodes table of the specified topology schema using the specified linestring geometry and returns the edgeid of the new (or existing) edge.
fr: Ajoute une arête linéaire à la table des arêtes et les points de départ et d'arrivée associés à la table des nœuds de points du schéma topologique spécifié en utilisant la géométrie linéaire spécifiée et renvoie l'identifiant de l'arête nouvelle (ou existante).

note: Tag: para
en: Adds an edge to the edge table and associated nodes to the nodes table of the specified <varname>toponame</varname> schema using the specified linestring geometry and returns the edgeid of the new or existing record. The newly added edge has "universe" face on both sides and links to itself.
fr: Ajoute une arête à la table des arêtes et les nœuds associés à la table des nœuds du schéma <varname>toponame</varname> spécifié en utilisant la géométrie de ligne spécifiée et renvoie l'identifiant de l'arête du nouvel enregistrement ou de l'enregistrement existant. L'arête nouvellement ajoutée a une face "univers" des deux côtés et est liée à elle-même.

note: Tag: para
en: If the <varname>aline</varname> geometry crosses, overlaps, contains or is contained by an existing linestring edge, then an error is thrown and the edge is not added.
fr: Si la géométrie <varname>aline</varname> croise, chevauche, contient ou est contenue par un bord de ligne existant, une erreur est générée et l'arête n'est pas ajoutée.

note: Tag: para
en: The geometry of <varname>aline</varname> must have the same <varname>srid</varname> as defined for the topology otherwise an invalid spatial reference sys error will be thrown.
fr: La géométrie de <varname>aline</varname> doit avoir la même <varname>srid</varname> que celle définie pour la topologie, sinon une erreur sys de référence spatiale non valide sera levée.

note: Tag: refpurpose
en: <refpurpose>Registers a face primitive to a topology and gets its identifier.</refpurpose>
fr: <refpurpose>Enregistre une primitive de face dans une topologie et obtient son identifiant.</refpurpose>

note: Tag: para
en: <para>Registers a face primitive to a topology and gets its identifier.</para>
fr: <para>Enregistre une primitive de face dans une topologie et obtient son identifiant.</para>

note: Tag: para
en: For a newly added face, the edges forming its boundaries and the ones contained in the face will be updated to have correct values in the left_face and right_face fields. Isolated nodes contained in the face will also be updated to have a correct containing_face field value.
fr: Pour une face nouvellement ajoutée, les arêtes formant ses limites et celles contenues dans la face seront mises à jour pour que les valeurs des champs left_face et right_face soient correctes. Les nœuds isolés contenus dans la face seront également mis à jour pour que la valeur du champ containing_face soit correcte.

note: Tag: para
en: The target topology is assumed to be valid (containing no self-intersecting edges). An exception is raised if: The polygon boundary is not fully defined by existing edges or the polygon overlaps an existing face.
fr: La topologie cible est supposée valide (ne contenant pas d'arêtes se recoupant). Une exception est levée si : La limite du polygone n'est pas entièrement définie par les arêtes existantes ou le polygone chevauche une face existante.

note: Tag: para
en: If the <varname>apolygon</varname> geometry already exists as a face, then: if <varname>force_new</varname> is false (the default) the face id of the existing face is returned; if <varname>force_new</varname> is true a new id will be assigned to the newly registered face.
fr: Si la géométrie <varname>apolygon</varname> existe déjà en tant que face, alors : si <varname>force_new</varname> est false (par défaut), l'identifiant de la face existante est renvoyé ; si <varname>force_new</varname> est true, un nouvel identifiant sera attribué à la face nouvellement enregistrée.

note: Tag: para
en: When a new registration of an existing face is performed (force_new=true), no action will be taken to resolve dangling references to the existing face in the edge, node an relation tables, nor will the MBR field of the existing face record be updated. It is up to the caller to deal with that.
fr: Lorsqu'un nouvel enregistrement d'une face existante est effectué (force_new=true), aucune action ne sera entreprise pour résoudre les références pendantes à la face existante dans les tables d'arêtes, de nœuds et de relations, et le champ MBR (Minimum Bounding Rectangle) de l'enregistrement de la face existante ne sera pas mis à jour. C'est à l'appelant de s'en occuper.

note: Tag: para
en: The <varname>apolygon</varname> geometry must have the same <varname>srid</varname> as defined for the topology otherwise an invalid spatial reference sys error will be thrown.
fr: La géométrie <varname>apolygon</varname> doit avoir la même <varname>srid</varname> que celle définie pour la topologie, sinon une erreur sys de référence spatiale non valide sera déclenchée.

note: Tag: refpurpose
en: Returns a "simplified" geometry version of the given TopoGeometry using the Douglas-Peucker algorithm.
fr: Renvoie une version géométrique "simplifiée" de la TopoGeometry donnée en utilisant l'algorithme de Douglas-Peucker.

note: Tag: para
en: Returns a "simplified" geometry version of the given TopoGeometry using the Douglas-Peucker algorithm on each component edge.
fr: Renvoie une version géométrique "simplifiée" de la TopoGeometry donnée en utilisant l'algorithme de Douglas-Peucker sur chaque arête de la composante.

note: Tag: para
en: The returned geometry may be non-simple or non-valid.
fr: La géométrie renvoyée peut être non simple ou non valide.

note: Tag: para
en: Splitting component edges may help retaining simplicity/validity.
fr: La séparation des arêtes des composants peut contribuer à préserver la simplicité et la validité.

note: Tag: refpurpose
en: Removes topology primitives which not needed to define existing TopoGeometry objects.
fr: Supprime les primitives topologiques qui ne sont pas nécessaires pour définir les objets TopoGeometry existants.

note: Tag: para
en: Finds all primitives (nodes, edges, faces) that are not strictly needed to represent existing TopoGeometry objects and removes them, maintaining topology validity (edge linking, face labeling) and TopoGeometry space occupation.
fr: Recherche toutes les primitives (nœuds, arêtes, faces) qui ne sont pas strictement nécessaires pour représenter les objets TopoGeometry existants et les supprime, en maintenant la validité de la topologie (liaison des arêtes, étiquetage des faces) et l'occupation de l'espace TopoGeometry.

note: Tag: para
en: No new primitive identifiers are created, but rather existing primitives are expanded to include merged faces (upon removing edges) or healed edges (upon removing nodes).
fr: Aucun nouvel identifiant de primitive n'est créé, mais les primitives existantes sont étendues pour inclure les faces fusionnées (en supprimant les arêtes) ou les arêtes réparées (en supprimant les nœuds).

note: Tag: para
en: Availability: 3.3.0
fr: Disponibilité : 3.3.0

note: Tag: title
en: TopoGeometry Constructors
fr: Constructeurs de TopoGeometry

note: Tag: para
en: This section covers the topology functions for creating new topogeometries.
fr: Cette section couvre les fonctions de topologie permettant de créer de nouvelles topogéométries.

note: Tag: refpurpose
en: Creates a new topo geometry object from topo element array - tg_type: 1:[multi]point, 2:[multi]line, 3:[multi]poly, 4:collection
fr: Crée un nouvel objet géométrique topo à partir d'un tableau d'éléments topo - tg_type : 1 :[multi]point, 2 :[multi]ligne, 3 :[multi]poly, 4:collection

note: Tag: para
en: Creates a topogeometry object for layer denoted by <varname>layer_id</varname> and registers it in the relations table in the <varname>toponame</varname> schema.
fr: Crée un objet topogéométrique pour la couche désignée par <varname>layer_id</varname> et l'enregistre dans la table des relations du schéma <varname>toponame</varname>.

note: Tag: para
en: <varname>tg_type</varname> is an integer: 1:[multi]point (punctal), 2:[multi]line (lineal), 3:[multi]poly (areal), 4:collection. <varname>layer_id</varname> is the layer id in the topology.layer table.
fr: <varname>tg_type</varname> est un nombre entier : 1 : [multi]point (ponctuel), 2 : [multi]ligne (linéaire), 3 : [multi]poly (aréolaire), 4:collection. <varname>layer_id</varname> est l'identifiant de la couche dans la table topology.layer.

note: Tag: para
en: punctal layers are formed from set of nodes, lineal layers are formed from a set of edges, areal layers are formed from a set of faces, and collections can be formed from a mixture of nodes, edges, and faces.
fr: Les couches ponctuelles sont formées à partir d'un ensemble de nœuds, les couches linéaires sont formées à partir d'un ensemble d'arêtes, les couches aréales sont formées à partir d'un ensemble de faces, et les collections peuvent être formées à partir d'un mélange de nœuds, d'arêtes et de faces.

note: Tag: para
en: Omitting the array of components generates an empty TopoGeometry object.
fr: L'omission du tableau de composants génère un objet TopoGeometry vide.

note: Tag: title
en: Examples: Form from existing edges
fr: Exemples : Forme à partir d'arêtes existantes

note: Tag: para
en: Create a topogeom in ri_topo schema for layer 2 (our ri_roads), of type (2) LINE, for the first edge (we loaded in <varname>ST_CreateTopoGeo</varname>).
fr: Créer un topogeom dans le schéma ri_topo pour la couche 2 (nos ri_roads), de type (2) LINE, pour la première arête (que nous avons chargée dans <varname>ST_CreateTopoGeo</varname>).

note: Tag: title
en: Examples: Convert an areal geometry to best guess topogeometry
fr: Exemples : Convertir une géométrie aréolaire en une topogeometry de meilleure qualité

note: Tag: para
en: Lets say we have geometries that should be formed from a collection of faces. We have for example blockgroups table and want to know the topo geometry of each block group. If our data was perfectly aligned, we could do this:
fr: Supposons que nous ayons des géométries qui doivent être formées à partir d'une collection de faces. Nous disposons par exemple d'un tableau de groupes de blocs et nous voulons connaître la géométrie topographique de chaque groupe de blocs. Si nos données étaient parfaitement alignées, nous pourrions le faire :

note: Tag: refpurpose
en: Converts a simple Geometry into a topo geometry.
fr: Convertit une géométrie simple en une géométrie topographique.

note: Tag: para
en: Converts a simple Geometry into a <xref linkend="topogeometry"/>.
fr: Convertit une géométrie simple en une <xref linkend="topogeometry"/>.

note: Tag: para
en: Topological primitives required to represent the input geometry will be added to the underlying topology, possibly splitting existing ones, and they will be associated with the output TopoGeometry in the <varname>relation</varname> table.
fr: Les primitives topologiques requises pour représenter la géométrie d'entrée seront ajoutées à la topologie sous-jacente, éventuellement en divisant les primitives existantes, et elles seront associées à la TopoGeometry de sortie dans la table <varname>relation</varname>.

note: Tag: para
en: Existing TopoGeometry objects (with the possible exception of <varname>topogeom</varname>, if given) will retain their shapes.
fr: Les objets TopoGeometry existants (à l'exception éventuelle de <varname>topogeom</varname>, s'il en existe) conserveront leur forme.

note: Tag: para
en: When <varname>tolerance</varname> is given it will be used to snap the input geometry to existing primitives.
fr: Lorsque <varname>tolerance</varname> est donné, il sera utilisé pour accrocher la géométrie d'entrée aux primitives existantes.

note: Tag: para
en: In the first form a new TopoGeometry will be created for the given layer (<varname>layer_id</varname>) of the given topology (<varname>toponame</varname>).
fr: Dans le premier formulaire, une nouvelle TopoGéométrie sera créée pour la couche donnée (<varname>layer_id</varname>) de la topologie donnée (<varname>toponame</varname>).

note: Tag: para
en: In the second form the primitives resulting from the conversion will be added to the pre-existing TopoGeometry (<varname>topogeom</varname>), possibly adding space to its final shape. To have the new shape completely replace the old one see <xref linkend="clearTopoGeom"/>.
fr: Dans la seconde forme, les primitives résultant de la conversion seront ajoutées à la TopoGeometry préexistante (<varname>topogeom</varname>), ajoutant éventuellement de l'espace à sa forme finale. Pour que la nouvelle forme remplace complètement l'ancienne, voir <xref linkend="clearTopoGeom"/>.

note: Tag: para
en: Enhanced: 2.1.0 adds the version taking an existing TopoGeometry.
fr: Amélioré : 2.1.0 ajoute la version d'une TopoGeometry existante.

note: Tag: para
en: This is a full self-contained workflow
fr: Il s'agit d'un flux de travail complet et autonome

note: Tag: refpurpose
en: Returns a <varname>topoelementarray</varname> for a set of element_id, type arrays (topoelements).
fr: Renvoie un <varname>topoelementarray</varname> pour un ensemble de tableaux de type, element_id (topoelements).

note: Tag: para
en: Used to create a <xref linkend="topoelementarray"/> from a set of <xref linkend="topoelement"/>.
fr: Utilisé pour créer un <xref linkend="topoelementarray"/> à partir d'un ensemble de <xref linkend="topoelement"/>.

note: Tag: refpurpose
en: Converts a topogeometry to a topoelement.
fr: Convertit une topogeometry en un topoelement.

note: Tag: para
en: Converts a <xref linkend="topogeometry"/> to a <xref linkend="topoelement"/>.
fr: Convertit une <xref linkend="topogeometry"/> en <xref linkend="topoelement"/>.

note: Tag: title
en: TopoGeometry Editors
fr: Editeurs de TopoGeometry

note: Tag: para
en: This section covers the topology functions for editing existing topogeometries.
fr: Cette section couvre les fonctions de topologie permettant d'éditer les topogeometries existantes.

note: Tag: refpurpose
en: Clears the content of a topo geometry.
fr: Efface le contenu d'une géométrie topo.

note: Tag: para
en: Clears the content a <xref linkend="topogeometry"/> turning it into an empty one. Mostly useful in conjunction with <xref linkend="toTopoGeom"/> to replace the shape of existing objects and any dependent object in higher hierarchical levels.
fr: Efface le contenu d'une <xref linkend="topogeometry"/> en la transformant en une vide. Principalement utile en conjonction avec <xref linkend="toTopoGeom"/> pour remplacer la forme des objets existants et de tout objet dépendant dans les niveaux hiérarchiques supérieurs.

note: Tag: para
en: Availability: 2.1
fr: Disponibilité : 2.1

note: Tag: refpurpose
en: Adds an element to the definition of a TopoGeometry.
fr: Ajoute un élément à la définition d'une TopoGeometry.

note: Tag: para
en: Adds a <xref linkend="topoelement"/> to the definition of a TopoGeometry object. Does not error out if the element is already part of the definition.
fr: Ajoute un <xref linkend="topoelement"/> à la définition d'un objet TopoGeometry. Il n'y a pas d'erreur si l'élément fait déjà partie de la définition.

note: Tag: para
en: Availability: 2.3
fr: Disponibilité : 2.3

note: Tag: refpurpose
en: Removes an element from the definition of a TopoGeometry.
fr: Supprime un élément de la définition d'une TopoGeometry.

note: Tag: para
en: Removes a <xref linkend="topoelement"/> from the definition of a TopoGeometry object.
fr: Supprime une <xref linkend="topoelement"/> de la définition d'un objet TopoGeometry.

note: Tag: refpurpose
en: Adds element of a TopoGeometry to the definition of another TopoGeometry.
fr: Ajoute un élément d'une TopoGeometry à la définition d'une autre TopoGeometry.

note: Tag: para
en: Adds the elements of a <xref linkend="topogeometry"/> to the definition of another TopoGeometry, possibly changing its cached type (type attribute) to a collection, if needed to hold all elements in the source object.
fr: Ajoute les éléments d'une <xref linkend="topogeometry"/> à la définition d'une autre TopoGeometry, en changeant éventuellement son type mis en cache (attribut type) en une collection, si nécessaire pour contenir tous les éléments de l'objet source.

note: Tag: para
en: The two TopoGeometry objects need be defined against the *same* topology and, if hierarchically defined, need be composed by elements of the same child layer.
fr: Les deux objets TopoGeometry doivent être définis par rapport à la même topologie et, s'ils sont définis hiérarchiquement, ils doivent être composés d'éléments de la même couche enfant.

note: Tag: para
en: Availability: 3.2
fr: Disponibilité : 3.2

note: Tag: refpurpose
en: Adds a geometry shape to an existing topo geometry.
fr: Ajoute une forme géométrique à une géométrie topographique existante.

note: Tag: para
en: Refer to <xref linkend="toTopoGeom"/>.
fr: Se référer à <xref linkend="toTopoGeom"/>.

note: Tag: title
en: TopoGeometry Accessors
fr: Accès aux TopoGeometry

note: Tag: refpurpose
en: Returns a <varname>topoelementarray</varname> (an array of topoelements) containing the topological elements and type of the given TopoGeometry (primitive elements).
fr: Renvoie un <varname>topoelementarray</varname> (un tableau de topoelements) contenant les éléments topologiques et le type de la TopoGeometry donnée (éléments primitifs).

note: Tag: para
en: Returns a <xref linkend="topoelementarray"/> containing the topological elements and type of the given TopoGeometry (primitive elements). This is similar to GetTopoGeomElements except it returns the elements as an array rather than as a dataset.
fr: Renvoie un <xref linkend="topoelementarray"/> contenant les éléments topologiques et le type de la TopoGeometry donnée (éléments primitifs). Cette fonction est similaire à GetTopoGeomElements, sauf qu'elle renvoie les éléments sous la forme d'un tableau plutôt que sous la forme d'un ensemble de données.

note: Tag: para
en: tg_id is the topogeometry id of the topogeometry object in the topology in the layer denoted by <varname>layer_id</varname> in the topology.layer table.
fr: tg_id est l'identifiant topogeometry de l'objet topogeometry de la topologie dans la couche désignée par <varname>layer_id</varname> dans la table topology.layer.

note: Tag: refpurpose
en: Returns a set of <varname>topoelement</varname> objects containing the topological element_id,element_type of the given TopoGeometry (primitive elements).
fr: Renvoie un ensemble d'objets <varname>topoelement</varname> contenant les éléments topologiques element_id,element_type de la TopoGeometry donnée (éléments primitifs).

note: Tag: para
en: Returns a set of element_id,element_type (topoelements) corresponding to primitive topology elements <xref linkend="topoelement"/> (1: nodes, 2: edges, 3: faces) that a given topogeometry object in <varname>toponame</varname> schema is composed of.
fr: Renvoie un ensemble de element_id,element_type (topoelements) correspondant aux éléments topologiques primitifs <xref linkend="topoelement"/> (1 : noeuds, 2 : arêtes, 3 : faces) dont est composé un objet topogeometry donné dans le schéma <varname>toponame</varname>.

note: Tag: refpurpose
en: Returns the spatial reference identifier for a topogeometry.
fr: Renvoie l'identifiant de référence spatiale d'une topogeometry.

note: Tag: para
en: Returns the spatial reference identifier for the ST_Geometry as defined in spatial_ref_sys table. <xref linkend="spatial_ref_sys"/>
fr: Renvoie l'identifiant de référence spatiale pour la ST_Geometry tel que défini dans la table spatial_ref_sys. <xref linkend="spatial_ref_sys"/>

note: Tag: para
en: spatial_ref_sys table is a table that catalogs all spatial reference systems known to PostGIS and is used for transformations from one spatial reference system to another. So verifying you have the right spatial reference system identifier is important if you plan to ever transform your geometries.
fr: La table spatial_ref_sys est une table qui répertorie tous les systèmes de référence spatiale connus de PostGIS et qui est utilisée pour les transformations d'un système de référence spatiale à un autre. Il est donc important de vérifier que vous disposez du bon identifiant de système de référence spatiale si vous envisagez de transformer vos géométries.

note: Tag: title
en: TopoGeometry Outputs
fr: Sorties TopoGeometry

note: Tag: refpurpose
en: Returns the GML representation of a topogeometry.
fr: Renvoie la représentation GML d'une topogeometry.

note: Tag: para
en: Returns the GML representation of a topogeometry in version GML3 format. If no <varname>nsprefix_in</varname> is specified then <varname>gml</varname> is used. Pass in an empty string for nsprefix to get a non-qualified name space. The precision (default: 15) and options (default 1) parameters, if given, are passed untouched to the underlying call to ST_AsGML.
fr: Renvoie la représentation GML d'une topogeometry au format GML3. Si aucun <varname>nsprefix_in</varname> n'est spécifié, <varname>gml</varname> est utilisé. Fournir une chaîne de caractères vide pour nsprefix afin d'obtenir un espace de noms non qualifié. Les paramètres precision (par défaut : 15) et options (par défaut 1), s'ils sont donnés, sont transmis tels quels à l'appel sous-jacent à ST_AsGML.

note: Tag: para
en: The <varname>visitedTable</varname> parameter, if given, is used for keeping track of the visited Node and Edge elements so to use cross-references (xlink:xref) rather than duplicating definitions. The table is expected to have (at least) two integer fields: 'element_type' and 'element_id'. The calling user must have both read and write privileges on the given table. For best performance, an index should be defined on <varname>element_type</varname> and <varname>element_id</varname>, in that order. Such index would be created automatically by adding a unique constraint to the fields. Example:
fr: Le paramètre <varname>visitedTable</varname>, s'il est donné, est utilisé pour garder une trace des éléments de nœud et d'arêtes visités afin d'utiliser des références croisées (xlink:xref) plutôt que de dupliquer les définitions. La table doit comporter (au moins) deux champs entiers : "element_type" et "element_id". L'utilisateur appelant doit avoir les privilèges de lecture et d'écriture sur la table donnée. Pour de meilleures performances, un index doit être défini sur <varname>element_type</varname> et <varname>element_id</varname>, dans cet ordre. Cet index sera créé automatiquement par l'ajout d'une contrainte d'unicité aux champs. Exemple :

note: Tag: para
en: The <varname>idprefix</varname> parameter, if given, will be prepended to Edge and Node tag identifiers.
fr: Le paramètre <varname>idprefix</varname>, s'il est indiqué, sera ajouté aux identifiants des balises Edge et Node.

note: Tag: para
en: The <varname>gmlver</varname> parameter, if given, will be passed to the underlying ST_AsGML. Defaults to 3.
fr: Le paramètre <varname>gmlver</varname>, s'il est donné, sera transmis au ST_AsGML sous-jacent. La valeur par défaut est 3.

note: Tag: para
en: This uses the topo geometry we created in <xref linkend="CreateTopoGeom"/>
fr: Ceci utilise la géométrie topo que nous avons créée dans <xref linkend="CreateTopoGeom"/>

note: Tag: para
en: Same exercise as previous without namespace
fr: Même exercice que le précédent sans namespace

note: Tag: refpurpose
en: Returns the TopoJSON representation of a topogeometry.
fr: Renvoie la représentation TopoJSON d'une topogeometry.

note: Tag: para
en: Returns the TopoJSON representation of a topogeometry. If <varname>edgeMapTable</varname> is not null, it will be used as a lookup/storage mapping of edge identifiers to arc indices. This is to be able to allow for a compact "arcs" array in the final document.
fr: Renvoie la représentation TopoJSON d'une topogeometry. Si <varname>edgeMapTable</varname> n'est pas nul, il sera utilisé comme correspondance de consultation/stockage des identifiants d'arêtes aux indices d'arcs. Cela permet d'obtenir un tableau compact des "arcs" dans le document final.

note: Tag: para
en: The table, if given, is expected to have an "arc_id" field of type "serial" and an "edge_id" of type integer; the code will query the table for "edge_id" so it is recommended to add an index on that field.
fr: La table, si elle est donnée, doit avoir un champ "arc_id" de type "serial" et un champ "edge_id" de type integer ; le code interrogera la table pour "edge_id" et il est donc recommandé d'ajouter un index sur ce champ.

note: Tag: para
en: Arc indices in the TopoJSON output are 0-based but they are 1-based in the "edgeMapTable" table.
fr: Les indices d'arc dans la sortie TopoJSON sont basés sur 0 mais ils sont basés sur 1 dans la table "edgeMapTable".

note: Tag: para
en: A full TopoJSON document will be need to contain, in addition to the snippets returned by this function, the actual arcs plus some headers. See the <link xlink:href="http://github.com/mbostock/topojson-specification/blob/master/README.md">TopoJSON specification</link>.
fr: Un document TopoJSON complet devra contenir, en plus des extraits renvoyés par cette fonction, les arcs proprement dits et quelques en-têtes. Voir le <link xlink:href="http://github.com/mbostock/topojson-specification/blob/master/README.md">TopoJSON specification</link>.

note: Tag: para
en: Enhanced: 2.2.1 added support for puntal inputs
fr: Amélioration : 2.2.1 ajout de la prise en charge des entrées "puntal"

note: Tag: title
en: Topology Spatial Relationships
fr: Relations spatiales de topologie

note: Tag: para
en: This section lists the Topology functions used to check relationships between topogeometries and topology primitives
fr: Cette section énumère les fonctions de topologie utilisées pour vérifier les relations entre les topogeometries et les primitives topologiques

note: Tag: refpurpose
en: Returns true if two topogeometries are composed of the same topology primitives.
fr: Retourne vrai si deux topogeometries sont composées des mêmes primitives topologiques.

note: Tag: para
en: Returns true if two topogeometries are composed of the same topology primitives: faces, edges, nodes.
fr: Retourne vrai si deux topogeometries sont composées des mêmes primitives topologiques : faces, arêtes, nœuds.

note: Tag: para
en: This function not supported for topogeometries that are geometry collections. It also can not compare topogeometries from different topologies.
fr: Cette fonction n'est pas prise en charge pour les topogeometries qui sont des collections de géométries. Elle ne permet pas non plus de comparer des topogeometries issues de topologies différentes.

note: Tag: refpurpose
en: <refpurpose>Returns true if any pair of primitives from the two topogeometries intersect.</refpurpose>
fr: <refpurpose>Retourne true si une paire de primitives des deux topogeometries s'intersectent.</refpurpose>

note: Tag: para
en: <para>Returns true if any pair of primitives from the two topogeometries intersect.</para>
fr: <para>Retourne true si une paire de primitives des deux topogeometries s'intersectent.</para>

note: Tag: para
en: This function not supported for topogeometries that are geometry collections. It also can not compare topogeometries from different topologies. Also not currently supported for hierarchical topogeometries (topogeometries composed of other topogeometries).
fr: Cette fonction n'est pas prise en charge pour les topogeometries qui sont des collections de géométries. Elle ne permet pas non plus de comparer des topogeometries issues de topologies différentes. Elle n'est pas non plus compatible avec les topogeometries hiérarchiques (topogeometries composées d'autres topogeometries).

note: Tag: title
en: Importing and exporting Topologies
fr: Importer et exporter des topologies

note: Tag: para
en: Once you have created topologies, and maybe associated topological layers, you might want to export them into a file-based format for backup or transfer into another database.
fr: Une fois que vous avez créé des topologies, et éventuellement des couches topologiques associées, vous pouvez les exporter dans un format de fichier pour les sauvegarder ou les transférer dans une autre base de données.

note: Tag: para
en: Using the standard dump/restore tools of PostgreSQL is problematic because topologies are composed by a set of tables (4 for primitives, an arbitrary number for layers) and records in metadata tables (topology.topology and topology.layer). Additionally, topology identifiers are not univoque across databases so that parameter of your topology will need to be changes upon restoring it.
fr: L'utilisation des outils standards de dump/restauration de PostgreSQL est problématique car les topologies sont composées d'un ensemble de tables (4 pour les primitives, un nombre arbitraire pour les couches) et d'enregistrements dans des tables de métadonnées (topology.topology et topology.layer). De plus, les identifiants de topologie ne sont pas univoques d'une base de données à l'autre, de sorte que les paramètres de votre topologie devront être modifiés lors de sa restauration.

note: Tag: para
en: In order to simplify export/restore of topologies a pair of executables are provided: <filename>pgtopo_export</filename> and <filename>pgtopo_import</filename>. Example usage:
fr: Afin de simplifier l'exportation/la restauration des topologies, une paire d'exécutables est fournie : <filename>pgtopo_export</filename> et <filename>pgtopo_import</filename>. Exemple d'utilisation :

note: Tag: title
en: Using the Topology exporter
fr: Utiliser l'exportateur de topologie

note: Tag: para
en: The <filename>pgtopo_export</filename> script takes the name of a database and a topology and outputs a dump file which can be used to import the topology (and associated layers) into a new database.
fr: Le script <filename>pgtopo_export</filename> prend le nom d'une base de données et d'une topologie et produit un fichier dump qui peut être utilisé pour importer la topologie (et les couches associées) dans une nouvelle base de données.

note: Tag: para
en: By default <filename>pgtopo_export</filename> writes the dump file to the standard output so that it can be piped to <filename>pgtopo_import</filename> or redirected to a file (refusing to write to terminal). You can optionally specify an output filename with the <code>-f</code> commandline switch.
fr: Par défaut, <filename>pgtopo_export</filename> écrit le fichier dump sur la sortie standard afin qu'il puisse être acheminé vers <filename>pgtopo_import</filename> ou redirigé vers un fichier (refusant d'écrire dans le terminal). Vous pouvez optionnellement spécifier un nom de fichier de sortie en utilisant l'argument <code>-f</code> dans la ligne de commandes.

note: Tag: para
en: By default <filename>pgtopo_export</filename> includes a dump of all layers defined against the given topology. This may be more data than you need, or may be non-working (in case your layer tables have complex dependencies) in which case you can request skipping the layers with the <code>--skip-layers</code> switch and deal with those separately.
fr: Par défaut <filename>pgtopo_export</filename> inclut un dump de toutes les couches définies par rapport à la topologie donnée. Cela peut être plus de données que vous n'en avez besoin, ou peut ne pas fonctionner (dans le cas où vos tables de couches ont des dépendances complexes), auquel cas vous pouvez demander à ignorer les couches avec l'argument <code>--skip-layers</code> et les traiter séparément.

note: Tag: para
en: Invoking <filename>pgtopo_export</filename> with the <code>--help</code> (or <code>-h</code> for short) switch will always print short usage string.
fr: En utilisant <filename>pgtopo_export</filename> avec l'argument <code>--help</code> (ou <code>-h</code> en abrégé) affichera toujours une courte chaîne de caractères sur l'utilisation.

note: Tag: para
en: The dump file format is a compressed tar archive of a <filename>pgtopo_export</filename> directory containing at least a <filename>pgtopo_dump_version</filename> file with format version info. As of version <code>1</code> the directory contains tab-delimited CSV files with data of the topology primitive tables (node, edge_data, face, relation), the topology and layer records associated with it and (unless <code>--skip-layers</code> is given) a custom-format PostgreSQL dump of tables reported as being layers of the given topology.
fr: Le format du fichier dump est une archive tar compressée d'un répertoire <filename>pgtopo_export</filename> contenant au moins un fichier <filename>pgtopo_dump_version</filename> avec des informations sur la version du format. A partir de la version <code>1</code>, le répertoire contient des fichiers CSV délimités par des tabulations avec les données des tables primitives de topologie (node, edge_data, face, relation), les enregistrements de topologie et de couche associés et (sauf si <code>--skip-layers</code> est donné) un dump PostgreSQL au format personnalisé des tables signalées comme étant des couches de la topologie donnée.

note: Tag: title
en: Using the Topology importer
fr: Utiliser l'importateur de topologie

note: Tag: para
en: The <filename>pgtopo_import</filename> script takes a <code>pgtopo_export</code> format topology dump and a name to give to the topology to be created and outputs an SQL script reconstructing the topology and associated layers.
fr: Le script <filename>pgtopo_import</filename> prend un dump topologique au format <code>pgtopo_export</code> et un nom à donner à la topologie à créer et produit un script SQL reconstruisant la topologie et les couches associées.

note: Tag: para
en: The generated SQL file will contain statements that create a topology with the given name, load primitive data in it, restores and registers all topology layers by properly linking all TopoGeometry values to their correct topology.
fr: Le fichier SQL généré contiendra des instructions qui créent une topologie avec le nom donné, chargent les données primitives, restaurent et enregistrent toutes les couches de la topologie en liant correctement toutes les valeurs TopoGeometry à leur topologie correcte.

note: Tag: para
en: By default <filename>pgtopo_import</filename> reads the dump from the standard input so that it can be used in conjunction with <filename>pgtopo_export</filename> in a pipeline. You can optionally specify an input filename with the <code>-f</code> commandline switch.
fr: Par défaut, <filename>pgtopo_import</filename> lit le dump depuis l'entrée standard afin qu'il puisse être utilisé en conjonction avec <filename>pgtopo_export</filename> dans une chaîne de traitement. Vous pouvez optionnellement spécifier un nom de fichier d'entrée avec l'argument <code>-f</code> en ligne de commande.

note: Tag: para
en: By default <filename>pgtopo_import</filename> includes in the output SQL file the code to restore all layers found in the dump.
fr: Par défaut, <filename>pgtopo_import</filename> inclut dans le fichier SQL de sortie le code permettant de restaurer toutes les couches trouvées dans le dump.

note: Tag: para
en: This may be unwanted or non-working in case your target database already have tables with the same name as the ones in the dump. In that case you can request skipping the layers with the <code>--skip-layers</code> switch and deal with those separately (or later).
fr: Ceci peut être indésirable ou ne pas fonctionner si votre base de données cible a déjà des tables avec le même nom que celles dans le dump. Dans ce cas, vous pouvez demander à ignorer les couches avec l'argument <code>--skip-layers</code> et les traiter séparément (ou plus tard).

note: Tag: para
en: SQL to only load and link layers to a named topology can be generated using the <code>--only-layers</code> switch. This can be useful to load layers AFTER resolving the naming conflicts or to link layers to a different topology (say a spatially-simplified version of the starting topology).
fr: SQL pour charger et lier uniquement les couches à une topologie nommée peut être généré en utilisant l'argument <code>--only-layers</code>. Cela peut être utile pour charger des couches APRÈS avoir résolu les conflits de noms ou pour lier des couches à une topologie différente (par exemple une version spatialement simplifiée de la topologie de départ).

note: Tag: title
en: PostGIS Installation
fr: Installation de PostGIS

note: Tag: para
en: This chapter details the steps required to install PostGIS.
fr: Ce chapitre décrit les étapes nécessaires pour installer PostGIS.

note: Tag: title
en: Short Version
fr: Version courte

note: Tag: para
en: To compile assuming you have all the dependencies in your search path:
fr: Pour compiler, en supposant que toutes les dépendances soient dans votre chemin de recherche :

note: Tag: para
en: Once PostGIS is installed, it needs to be enabled (<xref linkend="create_spatial_db"/>) or upgraded (<xref linkend="upgrading"/>) in each individual database you want to use it in.
fr: Une fois PostGIS installé, il est nécessaire de l'activer (<xref linkend="create_spatial_db"/>) ou de le mettre à jour (<xref linkend="upgrading"/>) dans chaque base de données où vous voulez l'utiliser.

note: Tag: title
en: Compiling and Install from Source
fr: Compilation et installation depuis les sources

note: Tag: para
en: Many OS systems now include pre-built packages for PostgreSQL/PostGIS. In many cases compilation is only necessary if you want the most bleeding edge versions or you are a package maintainer.
fr: La plupart des systèmes d'exploitation dispose de paquets pré-compilés de PostgreSQL/PostGIS. La compilation est réellement nécessaire uniquement pour disposer des toutes dernières fonctionnalités ou pour les responsables de paquets PostGIS.

note: Tag: para
en: This section includes general compilation instructions, if you are compiling for Windows etc or another OS, you may find additional more detailed help at <link xlink:href="https://trac.osgeo.org/postgis/wiki/UsersWikiInstall">PostGIS User contributed compile guides</link> and <link xlink:href="http://trac.osgeo.org/postgis/wiki/DevWikiMain">PostGIS Dev Wiki</link>.
fr: Cette section décrit le processus générique de compilation. Si vous compilez pour Windows ou d'autres systèmes d'exploitation, vous trouverez des instructions plus détaillées dans les wiki de la communauté <link xlink:href="https://trac.osgeo.org/postgis/wiki/UsersWikiInstall">guides de compilation</link> et <link xlink:href="http://trac.osgeo.org/postgis/wiki/DevWikiMain">PostGIS Dev Wiki</link>.

note: Tag: para
en: Pre-Built Packages for various OS are listed in <link xlink:href="https://trac.osgeo.org/postgis/wiki/UsersWikiPackages">PostGIS Pre-built Packages</link>
fr: Les paquets pré-compilés pour de multiples systèmes d'exploitation sont listés dans <link xlink:href="https://trac.osgeo.org/postgis/wiki/UsersWikiPackages">PostGIS Pre-built Packages</link>

note: Tag: para
en: If you are a windows user, you can get stable builds via Stackbuilder or <link xlink:href="https://postgis.net/windows_downloads">PostGIS Windows download site</link> We also have <link xlink:href="https://postgis.net/windows_downloads">very bleeding-edge windows experimental builds</link> that are built usually once or twice a week or whenever anything exciting happens. You can use these to experiment with the in progress releases of PostGIS
fr: Pour les utilisateurs Windows, des versions stables sont disponibles sur Stackbuilder ou sur <link xlink:href="https://postgis.net/windows_downloads">le site de téléchargement PostGIS Windows</link>. Des <link xlink:href="https://postgis.net/windows_downloads">compilations expérimentales</link> incluant les dernières fonctionnalités sont disponibles. Ces compilations sont généralement mises à jour une ou deux fois par semaines, ou chaque fois qu'une nouvelle fonctionnalité intéressante est ajoutée. Vous pouvez les utiliser pour suivre l'avancée des versions de PostGIS

note: Tag: para
en: The PostGIS module is an extension to the PostgreSQL backend server. As such, PostGIS &last_release_version; <emphasis>requires</emphasis> full PostgreSQL server headers access in order to compile. It can be built against PostgreSQL versions &min_postgres_version; - &max_postgres_version;. Earlier versions of PostgreSQL are <emphasis>not</emphasis> supported.
fr: Le module PostGIS est une extensions pour le serveur backend PostgreSQL. Par conséquent, PostGIS &last_release_version; <emphasis>nécessite</emphasis> l'ensemble des entêtes du serveur PostgreSQL pour pouvoir être compilé. PostGIS peut être compilé pour les versions PostgreSQL &min_postgres_version; à &max_postgres_version;. Les versions précédentes de PostgreSQL ne sont <emphasis>pas</emphasis> supportées.

note: Tag: para
en: Refer to the PostgreSQL installation guides if you haven't already installed PostgreSQL. <link xlink:href="https://www.postgresql.org"> https://www.postgresql.org </link> .
fr: Référez-vous aux guides d'installation de PostgreSQL si vous ne l'avez pas encore installé : <link xlink:href="https://www.postgresql.org"> https://www.postgresql.org </link> .

note: Tag: para
en: For GEOS functionality, when you install PostgreSQL you may need to explicitly link PostgreSQL against the standard C++ library:
fr: Pour les fonctionnalités de GEOS, quand vous installez PostgreSQL, vous aurez peut-être besoin de lier explicitement PostgreSQL avec la bibliothèque standard C++ :

note: Tag: para
en: This is a workaround for bogus C++ exceptions interaction with older development tools. If you experience weird problems (backend unexpectedly closed or similar things) try this trick. This will require recompiling your PostgreSQL from scratch, of course.
fr: Ceci est une solution de contournement d'exceptions C++ d'interactions bugués dans des outils de développements plus ancien. Si vous tombez sur ce genre de problèmes (backend soudainement fermé ou des choses similaires) essayez cette astuce. Cela nécessite de recompiler votre PostgreSQL du début, bien sur.

note: Tag: para
en: The following steps outline the configuration and compilation of the PostGIS source. They are written for Linux users and will not work on Windows or Mac.
fr: Les étapes suivantes résument la configuration et la compilation des sources PostGIS. Elles ont été rédigées pour les utilisateurs sous Linux et ne fonctionneront pas pour Windows et Mac.

note: Tag: title
en: Getting the Source
fr: Obtenir les Sources

note: Tag: para
en: Retrieve the PostGIS source archive from the downloads website <link xlink:href="&postgis_download_url;"> &postgis_download_url; </link>
fr: Les sources de PostGIS sont disponible depuis <link xlink:href="&postgis_download_url;"> &postgis_download_url; </link>

note: Tag: para
en: This will create a directory called <varname>postgis-&last_release_version;</varname> in the current working directory.
fr: Un répertoire appelé <varname>postgis-&last_release_version;</varname> sera créé dans le répertoire courant.

note: Tag: para
en: Alternatively, checkout the source from the <link xlink:href="https://git-scm.com/"> git </link> repository <link xlink:href="https://git.osgeo.org/gitea/postgis/postgis/"> https://git.osgeo.org/gitea/postgis/postgis/ </link> .
fr: Les sources peuvent également être obtenues depuis le dépôt <link xlink:href="https://git-scm.com/"> git </link> <link xlink:href="https://git.osgeo.org/gitea/postgis/postgis/"> https://git.osgeo.org/gitea/postgis/postgis/ </link>.

note: Tag: para
en: Change into the newly created <varname>postgis</varname> directory to continue the installation.
fr: Se placer dans le nouveau répertoire créé <varname>postgis-&last_release_version;</varname> pour poursuivre l'installation.

note: Tag: title
en: Install Requirements
fr: Pré requis à l'installation

note: Tag: para
en: PostGIS has the following requirements for building and usage:
fr: La compilation et l'utilisation de PostGIS nécessitent les éléments suivants :

note: Tag: emphasis
en: Required
fr: Obligatoire

note: Tag: para
en: PostgreSQL &min_postgres_version; - &max_postgres_version;. A complete installation of PostgreSQL (including server headers) is required. PostgreSQL is available from <link xlink:href="https://www.postgresql.org"> https://www.postgresql.org </link> .
fr: PostgreSQL &min_postgres_version; - &max_postgres_version;. Une installation complète de PostgreSQL (y compris les en-têtes du serveur) est nécessaire. PostgreSQL est disponible à partir de <link xlink:href="https://www.postgresql.org"> https://www.postgresql.org </link> .

note: Tag: para
en: For a full PostgreSQL / PostGIS support matrix and PostGIS/GEOS support matrix refer to <link xlink:href="https://trac.osgeo.org/postgis/wiki/UsersWikiPostgreSQLPostGIS">https://trac.osgeo.org/postgis/wiki/UsersWikiPostgreSQLPostGIS</link>
fr: Pour une matrice complète de compatibilité PostgreSQL/PostGIS et PostGIS/GEOS, référez-vous à <link xlink:href="https://trac.osgeo.org/postgis/wiki/UsersWikiPostgreSQLPostGIS">https://trac.osgeo.org/postgis/wiki/UsersWikiPostgreSQLPostGIS</link>

note: Tag: para
en: GNU C compiler (<filename>gcc</filename>). Some other ANSI C compilers can be used to compile PostGIS, but we find far fewer problems when compiling with <filename>gcc</filename>.
fr: Un compilateur GNUC C (<filename>gcc</filename>). D'autres compilateurs ANSI C peuvent être utilisés, mais la compilation avec <filename>gcc</filename> est source de moins de problèmes.

note: Tag: para
en: GNU Make (<filename>gmake</filename> or <filename>make</filename>). For many systems, GNU <filename>make</filename> is the default version of make. Check the version by invoking <filename>make -v</filename>. Other versions of <filename>make</filename> may not process the PostGIS <filename>Makefile</filename> properly.
fr: GNU Make (<filename>gmake</filename> ou <filename>make</filename>). Sur beaucoup de systemes, GNU <filename>make</filename> est la version par défaut de make. Vous pouvez vérifier la version de make avec la commande <filename>make -v</filename>. D'autres versions de <filename>make</filename> peuvent ne pas être compatibles avec le <filename>Makefile</filename> de PostGIS.

note: Tag: para
en: Proj reprojection library. Proj 6.1 or above is required. The Proj library is used to provide coordinate reprojection support within PostGIS. Proj is available for download from <link xlink:href="https://proj.org/"> https://proj.org/ </link> .
fr: Proj, bibliothèque de reprojection. Proj 6.1 ou supérieur est nécessaire. La bibliothèque Proj est utilisée pour fournir le support de reprojection de coordonnées dans PostGIS. Proj est disponible au téléchargement depuis <link xlink:href="https://proj.org/"> https://proj.org/ </link> .

note: Tag: para
en: GEOS geometry library, version &min_geos_version; or greater, but GEOS 3.12+ is required to take full advantage of all the new functions and features. GEOS is available for download from <link xlink:href="https://libgeos.org/"> https://libgeos.org </link>.
fr: La bibliothèque de géométrie GEOS, version &min_geos_version; ou supérieure, mais GEOS 3.12+ est nécessaire pour profiter pleinement de toutes les nouvelles fonctions et caractéristiques. GEOS peut être téléchargé à partir de <link xlink:href="https://libgeos.org/"> https://libgeos.org </link>.

note: Tag: para
en: LibXML2, version 2.5.x or higher. LibXML2 is currently used in some imports functions (ST_GeomFromGML and ST_GeomFromKML). LibXML2 is available for download from <link xlink:href="https://gitlab.gnome.org/GNOME/libxml2/-/releases">https://gitlab.gnome.org/GNOME/libxml2/-/releases</link>.
fr: LibXML2, version 2.5.x ou supérieur. LibXML2 est actuellement utilisée dans certaines fonctions d'import (ST_GeomFromGML et ST_GeomFromKML). LibXML2 est disponible au téléchargement depuis <link xlink:href="https://gitlab.gnome.org/GNOME/libxml2/-/releases">https://gitlab.gnome.org/GNOME/libxml2/-/releases</link>.

note: Tag: para
en: JSON-C, version 0.9 or higher. JSON-C is currently used to import GeoJSON via the function ST_GeomFromGeoJson. JSON-C is available for download from <link xlink:href="https://github.com/json-c/json-c/releases">https://github.com/json-c/json-c/releases/</link>.
fr: JSON-C, version 0.9 ou supérieure. JSON-C est utilisé pour l'import GeoJSON avec la fonction ST_GeomFromGeoJson. JSON-C est disponible depuis <link xlink:href="https://github.com/json-c/json-c/releases">https://github.com/json-c/json-c/releases/</link>.

note: Tag: para
en: If compiling with PostgreSQL+JIT, LLVM version &gt;=6 is required <link xlink:href="https://trac.osgeo.org/postgis/ticket/4125">https://trac.osgeo.org/postgis/ticket/4125</link>.
fr: Si vous compilez avec PostgreSQL+JIT, LLVM version &gt;=6 est nécessaire <link xlink:href="https://trac.osgeo.org/postgis/ticket/4125">https://trac.osgeo.org/postgis/ticket/4125</link>.

note: Tag: emphasis
en: Optional
fr: Optionnel

note: Tag: para
en: GDAL (pseudo optional) only if you don't want raster you can leave it out. Also make sure to enable the drivers you want to use as described in <xref linkend="raster_configuration"/>.
fr: GDAL (pseudo optionnel) vous pouvez l'omettre seulement si vous ne voulez pas du support raster. Pensez également à activer les pilotes que vous souhaitez utiliser, comme décrit dans <xref linkend="raster_configuration"/>.

note: Tag: para
en: GTK (requires GTK+2.0, 2.8+) to compile the shp2pgsql-gui shape file loader. <link xlink:href="http://www.gtk.org/"> http://www.gtk.org/ </link> .
fr: GTK (GTK+2.0, 2.8+) pour compiler le chargeur de shape file shp2pgsql-gui. <link xlink:href="http://www.gtk.org/"> http://www.gtk.org/ </link> .

note: Tag: para
en: In order to build the <xref linkend="Address_Standardizer"/> you will also need PCRE <link xlink:href="http://www.pcre.org">http://www.pcre.org</link> (which generally is already installed on nix systems). <xref linkend="Address_Standardizer"/> will automatically be built if it detects a PCRE library, or you pass in a valid <varname>--with-pcre-dir=/path/to/pcre</varname> during configure.
fr: Pour compiler <xref linkend="Address_Standardizer"/>, vous aurez également besoin de PCRE <link xlink:href="http://www.pcre.org">http://www.pcre.org</link> (qui est généralement déjà installé sur les systèmes nix). <xref linkend="Address_Standardizer"/> sera automatiquement compilé s'il détecte une bibliothèque PCRE, ou si vous passez un <varname>--with-pcre-dir=/path/to/pcre</varname> valide pendant la configuration.

note: Tag: para
en: To enable ST_AsMVT protobuf-c library 1.1.0 or higher (for usage) and the protoc-c compiler (for building) are required. Also, pkg-config is required to verify the correct minimum version of protobuf-c. See <link xlink:href="https://github.com/protobuf-c/protobuf-c">protobuf-c</link>. By default, Postgis will use Wagyu to validate MVT polygons faster which requires a c++11 compiler. It will use CXXFLAGS and the same compiler as the PostgreSQL installation. To disable this and use GEOS instead use the <varname>--without-wagyu</varname> during the configure step.
fr: Pour permettre d'utiliser ST_AsMVT, la bibliothèque protobuf-c 1.1.0 ou supérieur (pour l'utilisation) et le compilateur protoc-c (pour la compilation) sont nécessaires. Également, pkg-config est nécessaire pour vérifier la version minimale correcte de protobuf-c. Voir <link xlink:href="https://github.com/protobuf-c/protobuf-c">protobuf-c</link>. Par défaut, PostGIS utilise Wagyu pour valider les polygones MVT plus rapidement, ce qui nécessite un compilateur c++11. Ceci utilisera les CXXFLAGS et le même compilateur que l'installation PostgreSQL. Pour désactiver cela et utiliser GEOS à la place, utilisez la variable <varname>--without-wagyu</varname> pendant l'étape de configuration.

note: Tag: para
en: CUnit (<filename>CUnit</filename>). This is needed for regression testing. <link xlink:href="http://cunit.sourceforge.net/">http://cunit.sourceforge.net/</link>
fr: CUnit (<filename>CUnit</filename>). Nécessaire pour les tests de régression. <link xlink:href="http://cunit.sourceforge.net/">http://cunit.sourceforge.net/</link>

note: Tag: para
en: DocBook (<filename>xsltproc</filename>) is required for building the documentation. Docbook is available from <link xlink:href="http://www.docbook.org/"> http://www.docbook.org/ </link> .
fr: DocBook (<filename>xsltproc</filename>) est nécessaire pour générer la documentation. Docbook est disponible depuis le site <link xlink:href="http://www.docbook.org/"> http://www.docbook.org/ </link> .

note: Tag: para
en: DBLatex (<filename>dblatex</filename>) is required for building the documentation in PDF format. DBLatex is available from <link xlink:href="http://dblatex.sourceforge.net/"> http://dblatex.sourceforge.net/ </link> .
fr: DBLatex (<filename>dblatex</filename>) est nécessaire pour générer la documentation au format PDF. DBLatex est disponible depuis <link xlink:href="http://dblatex.sourceforge.net/"> http://dblatex.sourceforge.net/ </link> .

note: Tag: para
en: ImageMagick (<filename>convert</filename>) is required to generate the images used in the documentation. ImageMagick is available from <link xlink:href="http://www.imagemagick.org/"> http://www.imagemagick.org/ </link> .
fr: ImageMagick (<filename>convert</filename>) est nécessaire pour générer les images de la documentation. ImageMagick is available from <link xlink:href="http://www.imagemagick.org/"> http://www.imagemagick.org/ </link> .

note: Tag: title
en: Build configuration
fr: Configuration de la compilation

note: Tag: para
en: As with most linux installations, the first step is to generate the Makefile that will be used to build the source code. This is done by running the shell script
fr: Comme pour la plupart des installations linux, la première étape est de générer le Makefile qui sera utilisé pour compiler le code source. Ceci est réalisée en lançant le script shell

note: Tag: para
en: With no additional parameters, this command will attempt to automatically locate the required components and libraries needed to build the PostGIS source code on your system. Although this is the most common usage of <command>./configure</command>, the script accepts several parameters for those who have the required libraries and programs in non-standard locations.
fr: Sans paramètre supplémentaire, cette commande tentera de localiser automatiquement les composants requis et les bibliothèques nécessaires à la compilation de PostGIS. Bien que cela soit l'utilisation la plus commune de la commande <command>./configure</command>, vous pouvez également ajouter différents paramètres à ce script. Par exemple, vous pouvez définir l'emplacement de bibliothèques ou de programmes si ceux-ci ne sont pas localisés à un emplacement standard.

note: Tag: para
en: The following list shows only the most commonly used parameters. For a complete list, use the <command>--help</command> or <command>--help=short</command> parameters.
fr: La liste suivante présente les options les plus courantes. Pour consulter la liste complète utilisez l'option <command>--help</command> ou <command>--help=short</command>.

note: Tag: para
en: Starting with PostGIS 3.0, the library files generated by default will no longer have the minor version as part of the file name. This means all PostGIS 3 libs will end in <code>postgis-3</code>. This was done to make pg_upgrade easier, with downside that you can only install one version PostGIS 3 series in your server. To get the old behavior of file including the minor version: e.g. <code>postgis-3.0</code> add this switch to your configure statement.
fr: À partir de PostGIS 3.0, les fichiers de bibliothèque générés par défaut n'auront plus la version mineur dans le nom de fichier. Ceci signifie que les libs PostGIS 3 se termineront par <code>postgis-3</code>. Ceci a été fait pour faciliter l'usage de pg_upgrade, avec la contrainte que vous ne pouvez installer qu'une seule version de PostGIS 3 sur votre serveur. Pour basculer sur l'ancien comportement et avoir des fichiers qui incluent la version mineure : e.g. <code>postgis-3.0</code>, ajoutez ce paramètre dans la commande de configuration.

note: Tag: para
en: This is the location the PostGIS loader executables and shared libs will be installed. By default, this location is the same as the detected PostgreSQL installation.
fr: Cela correspond à l'emplacement où les exécutables et librairies de PostGIS seront installés. Par défaut, cet emplacement est le même que celui de l'installation de PostgreSQL.

note: Tag: para
en: This parameter is currently broken, as the package will only install into the PostgreSQL installation directory. Visit <link xlink:href="http://trac.osgeo.org/postgis/ticket/635"> http://trac.osgeo.org/postgis/ticket/635 </link> to track this bug.
fr: Ce paramètre est actuellement défectueux : le paquet s'installe uniquement dans le répertoire d'installation de PostgreSQL. Le suivi de ce bug est disponible depuis <link xlink:href="http://trac.osgeo.org/postgis/ticket/635"> http://trac.osgeo.org/postgis/ticket/635 </link>.

note: Tag: para
en: PostgreSQL provides a utility called <command>pg_config</command> to enable extensions like PostGIS to locate the PostgreSQL installation directory. Use this parameter (<command>--with-pgconfig=/path/to/pg_config</command>) to manually specify a particular PostgreSQL installation that PostGIS will build against.
fr: PostgreSQL fournit l'utilitaire <command>pg_config</command> permettant aux extensions comme PostGIS de localiser le répertoire d'installation de PostgreSQL. Utiliser ce paramètre (<command>--with-pgconfig=/path/to/pg_config</command>) pour spécifier une installation particulière de PostgreSQL pour laquelle PostGIS doit être compilée.

note: Tag: para
en: GDAL, a required library, provides functionality needed for raster support <command>gdal-config</command> to enable software installations to locate the GDAL installation directory. Use this parameter (<command>--with-gdalconfig=/path/to/gdal-config</command>) to manually specify a particular GDAL installation that PostGIS will build against.
fr: GDAL, une des bibliothèques requises pour le support des rasters. <command>gdal-config</command> pour permettre au logiciel de localiser le répertoire d'installation de GDAL. Utiliser ce paramètre (<command>--with-gdalconfig=/path/to/gdal-config</command>) pour spécifier un répertoire d'installation particulier de GDAL qui sera utilisé pour compiler PostGIS.

note: Tag: para
en: GEOS, a required geometry library, provides a utility called <command>geos-config</command> to enable software installations to locate the GEOS installation directory. Use this parameter (<command>--with-geosconfig=/path/to/geos-config</command>) to manually specify a particular GEOS installation that PostGIS will build against.
fr: GEOS, une des bibliothèques requises, fournit un utilitaire appelé <command>geos-config</command> permettant aux logiciels de localiser le répertoire d'installation de GEOS. Utiliser ce paramètre (<command>--with-geosconfig=/path/to/geos-config</command>) pour spécifier le repertoire de GEOS qui sera utilisé pour la compilation de PostGIS.

note: Tag: para
en: LibXML is the library required for doing GeomFromKML/GML processes. It normally is found if you have libxml installed, but if not or you want a specific version used, you'll need to point PostGIS at a specific <filename>xml2-config</filename> confi file to enable software installations to locate the LibXML installation directory. Use this parameter (<command>&gt;--with-xml2config=/path/to/xml2-config</command>) to manually specify a particular LibXML installation that PostGIS will build against.
fr: LibXML est la bibliothèque requise pour les processus GeomFromKML/GML. Elle est normalement trouvée si libxml est installé, mais si ce n'est pas le cas ou si vous souhaitez qu'une version spécifique soit utilisée, vous devrez indiquer à PostGIS un fichier confi <filename>xml2-config</filename> spécifique pour permettre aux installations logicielles de localiser le répertoire d'installation de LibXML. Utilisez ce paramètre (<command>&gt;--with-xml2config=/path/to/xml2-config</command>) pour spécifier manuellement une installation LibXML particulière avec laquelle PostGIS sera construit.

note: Tag: para
en: Proj is a reprojection library required by PostGIS. Use this parameter (<command>--with-projdir=/path/to/projdir</command>) to manually specify a particular Proj installation directory that PostGIS will build against.
fr: Proj4 est la bibliothèque de reprojection nécessaire à PostGIS. Utilisez ce paramètre (<command>--with-projdir=/path/to/projdir</command>) pour spécifier le répertoire de Proj qui sera utilisé pour la compilation de PostGIS.

note: Tag: para
en: Directory where iconv is installed.
fr: Répertoire d'installation d'iconv.

note: Tag: para
en: <link xlink:href="http://oss.metaparadigm.com/json-c/">JSON-C</link> is an MIT-licensed JSON library required by PostGIS ST_GeomFromJSON support. Use this parameter (<command>--with-jsondir=/path/to/jsondir</command>) to manually specify a particular JSON-C installation directory that PostGIS will build against.
fr: <link xlink:href="http://oss.metaparadigm.com/json-c/">JSON-C</link> est une bibliothèque sous licence MIT utilisée par PostGIS pour les traitements JSON (ST_GeomFromJSON par exemple). Utiliser ce paramètre (<command>--with-jsondir=/path/to/jsondir</command>) pour spécifier le répertoire de JSON-C qui sera utilisé pour la compilation de PostGIS.

note: Tag: para
en: <link xlink:href="http://www.pcre.org/">PCRE</link> is an BSD-licensed Perl Compatible Regular Expression library required by address_standardizer extension. Use this parameter (<command>--with-pcredir=/path/to/pcredir</command>) to manually specify a particular PCRE installation directory that PostGIS will build against.
fr: <link xlink:href="http://www.pcre.org/">PCRE</link> (Perl Compatible Regular Expression) est une bibliothèque sous licence BSD requise par l'extension address_standardizer. Utilisez ce paramètre (<command>--with-pcredir=/chemin/vers/pcredir</command>) pour spécifier un répertoire contenant PCRE qui sera utilisé par PostGIS.

note: Tag: para
en: Compile the data import GUI (requires GTK+2.0). This will create shp2pgsql-gui graphical interface to shp2pgsql.
fr: Compile l'interface graphique d'import de données (nécessite GTK+2.0). Ceci créé l'interface graphique shp2pgsql-gui à shp2pgsql.

note: Tag: para
en: Compile without raster support.
fr: Compilation sans support des raster.

note: Tag: para
en: Disable topology support. There is no corresponding library as all logic needed for topology is in postgis-&last_release_version; library.
fr: Désactive le support des topologies. Il n'y a pas de bibliothèque correspondante car toute la logique requise pour les topologies est incluse dans postgis-&last_release_version;.

note: Tag: para
en: By default PostGIS will try to detect gettext support and compile with it, however if you run into incompatibility issues that cause breakage of loader, you can disable it entirely with this command. Refer to ticket <link xlink:href="http://trac.osgeo.org/postgis/ticket/748">http://trac.osgeo.org/postgis/ticket/748</link> for an example issue solved by configuring with this. NOTE: that you aren't missing much by turning this off. This is used for international help/label support for the GUI loader which is not yet documented and still experimental.
fr: Par défaut PostGIS tentera de détecter la gestion de gettext et de reposer dessus pour la compilation, cependant si vous tombez sur des problèmes d'incompatibilités qui cause la cassure du chargeur, vous pouvez le désactiver entièrement avec cette commande. Référez vous au ticket <link xlink:href="http://trac.osgeo.org/postgis/ticket/748">http://trac.osgeo.org/postgis/ticket/748</link> pour un exemple de problème résolu par cette configuration. NOTE : que vous perdez beaucoup de chose en le désactivant. Cela est utilisé pour la gestion de l'aide et des labels internationaux dans le chargeur graphique qui n'est pas documenté et encore expérimental.

note: Tag: para
en: By default PostGIS will not install with sfcgal support without this switch. <varname>PATH</varname> is an optional argument that allows to specify an alternate PATH to sfcgal-config.
fr: Par défaut, PostGIS ne contiendra pas le support sfcgal sans cet argument. <varname>PATH</varname> est un argument optionnel permettant de préciser un chemin alternatif vers sfcgal-config.

note: Tag: para
en: Disable updating postgis_revision.h to match current HEAD of the git repository.
fr: Désactive la mise à jour de postgis_revision.h à partir du HEAD courant du dépôt git.

note: Tag: para
en: If you obtained PostGIS from the <link xlink:href="https://trac.osgeo.org/postgis/wiki/CodeRepository"> code repository </link> , the first step is really to run the script
fr: Si vous avez téléchargé PostGIS depuis le <link xlink:href="https://trac.osgeo.org/postgis/wiki/CodeRepository"> dépôt du code </link>, la première étape est d'exécuter le script

note: Tag: para
en: This script will generate the <command>configure</command> script that in turn is used to customize the installation of PostGIS.
fr: Ce script générera le script <command>configure</command> qui est utilisé pour personnaliser votre installation de PostGIS.

note: Tag: para
en: If you instead obtained PostGIS as a tarball, running <command>./autogen.sh</command> is not necessary as <command>configure</command> has already been generated.
fr: Si vous avez obtenu PostGIS comme archive, lancer la commande <command>./autogen.sh</command> n'est pas nécessaire puisque <command>configure</command> a déjà été généré.

note: Tag: title
en: Building
fr: Compiler

note: Tag: para
en: Once the Makefile has been generated, building PostGIS is as simple as running
fr: Une fois le Makefile généré, compiler PostGIS est aussi simple que lancer

note: Tag: para
en: The last line of the output should be "<code>PostGIS was built successfully. Ready to install.</code>"
fr: La dernière ligne de la sortie doit être "<code>PostGIS was built successfully. Ready to install.</code>"

note: Tag: para
en: As of PostGIS v1.4.0, all the functions have comments generated from the documentation. If you wish to install these comments into your spatial databases later, run the command which requires docbook. The postgis_comments.sql and other package comments files raster_comments.sql, topology_comments.sql are also packaged in the tar.gz distribution in the doc folder so no need to make comments if installing from the tar ball. Comments are also included as part of the CREATE EXTENSION install.
fr: À partir de PostGIS v1.4.0, toutes les fonctions ont leur commentaire généré à partir de la documentation. Si vous souhaitez installer ces commentaires dans votre base de données spatiale plus tard, exécutez la commande suivante, qui nécessite docbook. Les fichiers de commentaires pour PostGIS postgis_comments.sql et pour les autres paquets raster_comments.sql, topology_comments.sql sont aussi inclus dans le paquet tar.gz de la distribution, dans le répertoire doc, il est donc inutile d'utiliser cette commande si vous installez depuis l'archive tar. Les commentaires sont aussi inclus par l'installation via CREATE EXTENSION.

note: Tag: para
en: Introduced in PostGIS 2.0. This generates html cheat sheets suitable for quick reference or for student handouts. This requires xsltproc to build and will generate 4 files in doc folder <filename>topology_cheatsheet.html</filename>, <filename>tiger_geocoder_cheatsheet.html</filename>, <filename>raster_cheatsheet.html</filename>, <filename>postgis_cheatsheet.html</filename>
fr: Introduit dans PostGIS 2.0. Cela génère un mémo en html disponible pour une référence rapide ou pour les étudiants. La compilation nécessite xsltproc et génèrera 4 fichiers dans le répertoire doc <filename>topology_cheatsheet.html</filename>, <filename>tiger_geocoder_cheatsheet.html</filename>, <filename>raster_cheatsheet.html</filename>, <filename>postgis_cheatsheet.html</filename>

note: Tag: para
en: You can download some pre-built ones available in html and pdf from <link xlink:href="http://www.postgis.us/study_guides">PostGIS / PostgreSQL Study Guides</link>
fr: Vous pouvez télécharger des pré-compilations disponibles en HTML et PDF à partir de <link xlink:href="http://www.postgis.us/study_guides">PostGIS / PostgreSQL Study Guides</link>

note: Tag: title
en: Building PostGIS Extensions and Deploying them
fr: Compiler les Extensions PostGIS et les déployer

note: Tag: para
en: The PostGIS extensions are built and installed automatically if you are using PostgreSQL 9.1+.
fr: Les extensions PostGIS sont compilées et installées automatiquement si vous utilisez PostgreSQL 9.1+.

note: Tag: para
en: If you are building from source repository, you need to build the function descriptions first. These get built if you have docbook installed. You can also manually build with the statement:
fr: Si vous compilez à partir des dépôts des sources, vous devez compiler les descriptions de fonction d'abord. Ceci est compilé si vous avez docbook installé. Vous pouvez également compiler manuellement avec cette commande :

note: Tag: para
en: Building the comments is not necessary if you are building from a release tar ball since these are packaged pre-built with the tar ball already.
fr: Compiler les commentaires n'est pas nécessaire si vous avez compilé à partir d'une release d'archive puisque ceux-ci sont des pré-compilations packagés avec le tar ball.

note: Tag: para
en: The extensions should automatically build as part of the make install process. You can if needed build from the extensions folders or copy files if you need them on a different server.
fr: Les extensions devraient être automatiquement compilées lors du make install. Vous pouvez, si nécessaire, compiler à partir des répertoires d'extensions ou copier les fichiers si vous en avez besoin sur un serveur différent.

note: Tag: para
en: <code>make check</code> uses psql to run tests and as such can use psql environment variables. Common ones useful to override are <varname>PGUSER</varname>,<varname>PGPORT</varname>, and <varname>PGHOST</varname>. Refer to <link xlink:href="https://www.postgresql.org/docs/current/libpq-envars.html">psql environment variables</link>
fr: <code>make check</code> utilise psql pour faire tourner les tests, et peut donc utiliser les variables d'environnement psql. Les variables classiques utiles à définir sont <varname>PGUSER</varname>,<varname>PGPORT</varname>, and <varname>PGHOST</varname>. Voir <link xlink:href="https://docs.postgresql.fr/current/libpq-envars.html">variables d'environnement psql</link>

note: Tag: para
en: The extension files will always be the same for the same version of PostGIS and PostgreSQL regardless of OS, so it is fine to copy over the extension files from one OS to another as long as you have the PostGIS binaries already installed on your servers.
fr: Les fichiers extensions seront toujours les mêmes pour les mêmes versions de PostGIS et PostgreSQL indépendamment de l'OS, par conséquent il n'y a pas de problème à copier les fichiers extensions d'un OS à un autre du moment que vous avez les binaires PostGIS déjà installés sur vos serveurs.

note: Tag: para
en: If you want to install the extensions manually on a separate server different from your development, You need to copy the following files from the extensions folder into the <filename>PostgreSQL / share / extension</filename> folder of your PostgreSQL install as well as the needed binaries for regular PostGIS if you don't have them already on the server.
fr: Si vous voulez installer les extensions manuellement sur un serveur différent séparé de votre développement, vous devez copier les fichiers suivants à partir du répertoire extension dans le répertoire <filename>PostgreSQL / share / extension</filename> de votre installation PostgreSQL ainsi que les binaires nécessaires pour une version correcte de PostGIS si vous ne les avez pas déjà sur le serveur.

note: Tag: para
en: These are the control files that denote information such as the version of the extension to install if not specified. <filename>postgis.control, postgis_topology.control</filename>.
fr: Ceux-ci sont les fichiers de contrôle qui renvoie les informations telles que la version de l'extension à installer si non spécifié. <filename>postgis.control, postgis_topology.control</filename>.

note: Tag: para
en: All the files in the /sql folder of each extension. Note that these need to be copied to the root of the PostgreSQL share/extension folder <filename>extensions/postgis/sql/*.sql</filename>, <filename>extensions/postgis_topology/sql/*.sql</filename>
fr: Tous les fichiers dans le répertoire /sql de chaque extension. Notez que ceux-ci nécessitent d'être copiées à la racine du répertoire share/extension de PostgreSQL <filename>extensions/postgis/sql/*.sql</filename>, <filename>extensions/postgis_topology/sql/*.sql</filename>

note: Tag: para
en: Once you do that, you should see <varname>postgis</varname>, <varname>postgis_topology</varname> as available extensions in PgAdmin -&gt; extensions.
fr: Une fois que vous avez fait cela, vous devriez voir <varname>postgis</varname>, <varname>postgis_topology</varname> comme extensions disponibles dans PgAdmin -&gt; extensions.

note: Tag: para
en: If you are using psql, you can verify that the extensions are installed by running this query:
fr: Si vous utilisez psql, vous pouvez vérifier que les extensions sont installées en lançant cette requête :

note: Tag: para
en: If you have the extension installed in the database you are querying, you'll see mention in the <varname>installed_version</varname> column. If you get no records back, it means you don't have postgis extensions installed on the server at all. PgAdmin III 1.14+ will also provide this information in the <varname>extensions</varname> section of the database browser tree and will even allow upgrade or uninstall by right-clicking.
fr: Si vous avez l'extension installée dans la base de données que vous interrogez, vous verrez la mention dans la colonne <varname>installed_version</varname>. Si vous n'obtenez aucun enregistrement , cela signifie que vous n'avez pas d'extension postgis installés sur le serveur. PgAdmin III 1.14+ fournira aussi cette information dans la section <varname>extensions</varname> dans l'arbre de l'explorateur de la base de données et autorisera même la mise à jour ou la désinstallation par clic-droit.

note: Tag: para
en: If you have the extensions available, you can install postgis extension in your database of choice by either using pgAdmin extension interface or running these sql commands:
fr: Si vous avez les extensions disponibles, vous pouvez installer les extensions postgis dans votre base de données de votre choix soit en utilisant l'interface d'extension de PgAdmin ou lançant ces commandes SQL :

note: Tag: para
en: In psql you can use to see what versions you have installed and also what schema they are installed.
fr: Avec psql, vous pouvez contrôler les versions installées ainsi que les schémas d'installation.

note: Tag: para
en: Extension tables <varname>spatial_ref_sys</varname>, <varname>layer</varname>, <varname>topology</varname> can not be explicitly backed up. They can only be backed up when the respective <varname>postgis</varname> or <varname>postgis_topology</varname> extension is backed up, which only seems to happen when you backup the whole database. As of PostGIS 2.0.1, only srid records not packaged with PostGIS are backed up when the database is backed up so don't go around changing srids we package and expect your changes to be there. Put in a ticket if you find an issue. The structures of extension tables are never backed up since they are created with <code>CREATE EXTENSION</code> and assumed to be the same for a given version of an extension. These behaviors are built into the current PostgreSQL extension model, so nothing we can do about it.
fr: Les tables d'extension <varname>spatial_ref_sys</varname>, <varname>layer</varname>, <varname>topology</varname> ne peuvent pas être explicitement sauvegardées. Elles peuvent être uniquement sauvegardées quand les extensions respectives <varname>postgis</varname> ou <varname>postgis_topology</varname> sont sauvegardées, ce qui semble seulement arriver quand vous sauvegardez l'ensemble de la base. À partir de PostGIS 2.0.1, seulement les enregistrements des srid non packagés avec PostGIS sont sauvegardés quand la base de données est sauvegardée. Par conséquent, ne vous attendez pas à ce vos modifications persistent si vous changez les srids que nous fournissons. Créez un ticket si vous trouvez un problème. Les structures des tables d'extensions ne sont jamais sauvegardées puisque créées avec <code>CREATE EXTENSION</code> et sont supposées être identiques à version égale d'une extension. Ce comportement fait partie du modèle actuel d'extensions de PostgreSQL, nous ne pouvons donc rien faire à ce sujet.

note: Tag: para
en: If you installed &last_release_version;, without using our wonderful extension system, you can change it to be extension based by running the below commands to package the functions in their respective extension. Installing using `unpackaged` was removed in PostgreSQL 13, so you are advised to switch to an extension build before upgrading to PostgreSQL 13.
fr: Si vous avez installé la version &last_release_version; sans utiliser le système d'extensions, il est possible de l'activer via les commandes suivantes pour packager les fonctions dans leurs extensions respectives. L'installation via `unpackaged` a été supprimé dans PostgreSQL 13, nous vous invitons donc à basculer sur une installation utilisant le système d'extensions avant de migrer à PostgreSQL 13.

note: Tag: title
en: Testing
fr: Tests

note: Tag: para
en: If you wish to test the PostGIS build, run
fr: Si vous désirez tester la compilation de PostGIS, lancez

note: Tag: para
en: The above command will run through various checks and regression tests using the generated library against an actual PostgreSQL database.
fr: La commande ci-dessus fonctionnera pour différentes tests de vérification et de régression en utilisant la bibliothèque générée selon la base de données actuelle.

note: Tag: para
en: If you configured PostGIS using non-standard PostgreSQL, GEOS, or Proj locations, you may need to add their library locations to the <varname>LD_LIBRARY_PATH</varname> environment variable.
fr: Si vous avez configuré PostGIS en utilisant un emplacement non standard de PostgreSQL, GEOS, ou Proj4, vous pourrez avoir besoin d'ajouter l'emplacement des bibliothèques à la variable d'environnement <varname>LD_LIBRARY_PATH</varname>.

note: Tag: para
en: Currently, the <command>make check</command> relies on the <code>PATH</code> and <code>PGPORT</code> environment variables when performing the checks - it does <emphasis>not</emphasis> use the PostgreSQL version that may have been specified using the configuration parameter <command>--with-pgconfig</command>. So make sure to modify your PATH to match the detected PostgreSQL installation during configuration or be prepared to deal with the impending headaches.
fr: Pour le moment, <command>make check</command> repose sur les variables d'environnement <code>PATH</code> et <code>PGPORT</code> lors de la réalisation des vérifications - il n'utilise <emphasis>pas</emphasis> la version de PostgreSQL qui a pu être définie en utilisant la paramètre de configuration <command>--with-pgconfig</command>. Assurez vous donc de modifier votre PATH pour correspondre l'installation de PostgreSQL détectée durant la configuration ou préparez vous à gérer des maux de tête à venir.

note: Tag: para
en: If successful, make check will produce the output of almost 500 tests. The results will look similar to the following (numerous lines omitted below):
fr: Si réussi, make check sortira les résultats de près de 500 tests. Les résultats seront similaires à la sortie ci-dessous (avec de nombreuses lignes omises) :

note: Tag: para
en: The <varname>postgis_tiger_geocoder</varname> and <varname>address_standardizer</varname> extensions, currently only support the standard PostgreSQL installcheck. To test these use the below. Note: the make install is not necessary if you already did make install at root of PostGIS code folder.
fr: Les extensions <varname>postgis_tiger_geocoder</varname> et <varname>address_standardizer</varname> ne supportent actuellement que l'installcheck de PostgreSQL. Pour les tester, cf ci-dessous. Note : Il n'est pas nécessaire de lancer make install si cette commande a déjà été lancée dans le répertoire racine des sources PostGIS.

note: Tag: para
en: For address_standardizer:
fr: Pour l'extension address_standardize :

note: Tag: para
en: Output should look like:
fr: La sortie de la commande devrait ressembler à :

note: Tag: para
en: For tiger geocoder, make sure you have postgis and fuzzystrmatch extensions available in your PostgreSQL instance. The address_standardizer tests will also kick in if you built postgis with address_standardizer support:
fr: Le géocodeur tiger nécessite d'avoir les extensions postgis et fuzzystrmatch installée sur l'instance PostgreSQL. Les tests de l'extension address_standardizer seront lancés si PostGIS est compilé avec le support address_standardizer :

note: Tag: para
en: output should look like:
fr: La sortie de la commande devrait ressembler à :

note: Tag: para
en: To install PostGIS, type
fr: Pour installer PostGIS, entrez

note: Tag: para
en: This will copy the PostGIS installation files into their appropriate subdirectory specified by the <command>--prefix</command> configuration parameter. In particular:
fr: Ceci copiera les fichiers d'installation de PostGIS dans leur sous-répertoires appropriés définis par le paramètre de configuration <command>--prefix</command>. En particulier :

note: Tag: para
en: The loader and dumper binaries are installed in <filename>[prefix]/bin</filename>.
fr: Les binaires du chargeur et du dumper sont installés dans <filename>[prefix]/bin</filename>.

note: Tag: para
en: The SQL files, such as <filename>postgis.sql</filename>, are installed in <filename>[prefix]/share/contrib</filename>.
fr: Les fichiers SQL, tel que <filename>postgis.sql</filename>, sont installé dans <filename>[prefix]/share/contrib</filename>.

note: Tag: para
en: The PostGIS libraries are installed in <filename>[prefix]/lib</filename>.
fr: Les bibliothèques PostGIS sont installées dans <filename>[prefix]/lib</filename>.

note: Tag: para
en: If you previously ran the <command>make comments</command> command to generate the <filename>postgis_comments.sql</filename>, <filename>raster_comments.sql</filename> file, install the sql file by running
fr: Si vous avez déjà lancé la commande <command>make comments</command> pour générer les fichiers <filename>postgis_comments.sql</filename>, <filename>raster_comments.sql</filename>, installer le fichier sql en lançant

note: Tag: para
en: <filename>postgis_comments.sql</filename>, <filename>raster_comments.sql</filename>, <filename>topology_comments.sql</filename> was separated from the typical build and installation targets since with it comes the extra dependency of <command>xsltproc</command>.
fr: <filename>postgis_comments.sql</filename>, <filename>raster_comments.sql</filename>, <filename>topology_comments.sql</filename> ont été séparés de la compilation initiale et des cibles de l'installation depuis qu'ils sont dépendant de <command>xsltproc</command>.

note: Tag: title
en: Installing and Using the address standardizer
fr: Installation et utilisation de l'extension address standardize

note: Tag: para
en: The <code>address_standardizer</code> extension used to be a separate package that required separate download. From PostGIS 2.2 on, it is now bundled in. For more information about the address_standardize, what it does, and how to configure it for your needs, refer to <xref linkend="Address_Standardizer"/>.
fr: L'extension <code>address_standardizer</code> était précédemment livrée sous forme d'un paquet séparé nécessitant son propre téléchargement. Depuis la version 2.2 de PostGIS, cette extension est intégrée. Pour de plus amples informations sur cette extension, sa configuration, son utilisation, se référer à <xref linkend="Address_Standardizer"/>.

note: Tag: para
en: This standardizer can be used in conjunction with the PostGIS packaged tiger geocoder extension as a replacement for the <xref linkend="Normalize_Address"/> discussed. To use as replacement refer to <xref linkend="tiger_pagc_address_standardizing"/>. You can also use it as a building block for your own geocoder or use it to standardize your addresses for easier compare of addresses.
fr: Ce normalisateur d'adresses peut être utilisé avec l'extension PostGIS tiger en remplacement de <xref linkend="Normalize_Address"/>. Se référer à la page <xref linkend="tiger_pagc_address_standardizing"/> pour mettre en place ce remplacement. Il peut également être utilisé pour fabriquer son propre géocodeur ou pour normaliser des adresses pour les comparer plus facilement.

note: Tag: para
en: The address standardizer relies on PCRE which is usually already installed on many Nix systems, but you can download the latest at: <link xlink:href="http://www.pcre.org">http://www.pcre.org</link>. If during <xref linkend="installation_configuration"/>, PCRE is found, then the address standardizer extension will automatically be built. If you have a custom pcre install you want to use instead, pass to configure <code>--with-pcredir=/path/to/pcre</code> where <filename>/path/to/pcre</filename> is the root folder for your pcre include and lib directories.
fr: Le normalisateur d'adresses se base sur PCRE, généralement installé sur les systèmes Nix. Il peut également être téléchargé ici : <link xlink:href="http://www.pcre.org">http://www.pcre.org</link>. Durant la phase <xref linkend="installation_configuration"/>, si PCRE est détecté, le normalisateur d'adresses sera automatiquement compilé. Pour utiliser une installation personnalisée de PCRE, passer le paramètre <code>--with-pcredir=/chemin/vers/pcre</code> dans la commande configure, où <filename>/chemin/vers/pcre</filename> est le répertoire contenant les sous-répertoires pcre include et lib.

note: Tag: para
en: For Windows users, the PostGIS 2.1+ bundle is packaged with the address_standardizer already so no need to compile and can move straight to <code>CREATE EXTENSION</code> step.
fr: Pour les utilisateurs de Windows®, les versions 2.1 et supérieures de PostGIS sont livrées avec l'extension address_standardizer. Il n'est donc pas besoin de compiler cette extension. La commande <code>CREATE EXTENSION</code> suffit.

note: Tag: para
en: Once you have installed, you can connect to your database and run the SQL:
fr: Une fois installée, vous pouvez vous connecter à votre base de données et lancer le SQL :

note: Tag: para
en: The following test requires no rules, gaz, or lex tables
fr: Le test suivant ne nécessite pas de table rules, gas, ou lex

note: Tag: para
en: Output should be
fr: La sortie de la commande devrait ressembler à

note: Tag: title
en: Installing, Upgrading Tiger Geocoder, and loading data
fr: Installation, mise à jour et chargement de données pour le géocodeur Tiger

note: Tag: para
en: Extras like Tiger geocoder may not be packaged in your PostGIS distribution. If you are missing the tiger geocoder extension or want a newer version than what your install comes with, then use the <filename>share/extension/postgis_tiger_geocoder.*</filename> files from the packages in <link xlink:href="http://postgis.net/windows_downloads/">Windows Unreleased Versions</link> section for your version of PostgreSQL. Although these packages are for windows, the postgis_tiger_geocoder extension files will work on any OS since the extension is an SQL/plpgsql only extension.
fr: L'extension géocodeur Tiger peut ne pas être distribué avec votre installation de PostGIS. Si vous n'avez pas l'extension géocodeur Tiger, ou si vous souhaitez utiliser une version plus récente de celle de votre installation, vous pouvez utiliser les fichiers <filename>share/extension/postgis_tiger_geocoder.*</filename> depuis les paquets disponibles à <link xlink:href="http://postgis.net/windows_downloads/">Windows Unreleased Versions</link>, dans la section pour votre version de PostgreSQL. Même si ces paquets sont pour Windows, les fichiers d'extension postgis_tiger_geocoder fonctionneront quel que soit votre système d'exploitation car c'est une extension en SQL/plpgsql.

note: Tag: title
en: Tiger Geocoder Enabling your PostGIS database
fr: Tiger Geocoder Activation de votre base de données PostGIS

note: Tag: para
en: These directions assume your PostgreSQL installation already has the postgis_tiger_geocoder extension installed.
fr: Ces instructions supposent que l'extension postgis_tiger_geocoder soit déjà installée dans votre installation PostgreSQL.

note: Tag: para
en: Connect to your database via psql or pgAdmin or some other tool and run the following SQL commands. Note that if you are installing in a database that already has postgis, you don't need to do the first step. If you have <varname>fuzzystrmatch</varname> extension already installed, you don't need to do the second step either.
fr: Connectez-vous à la base de données avec psql ou PgAdmin (ou tout autre client) et lancez la commande SQL suivante. Note : Si l'installation se déroule sur une base de données contenant déjà PostGIS, la première étape n'est pas nécessaire. Si l'extension <varname>fuzzystrmatch</varname> est déjà installée, la seconde étape n'est pas nécessaire non plus.

note: Tag: para
en: If you already have postgis_tiger_geocoder extension installed, and just want to update to the latest run:
fr: Si l'extension postgis_tiger_geocoder est déjà installée et que vous souhaitez la mettre à jour, lancez :

note: Tag: para
en: If you made custom entries or changes to <varname>tiger.loader_platform</varname> and <varname>tiger.loader_variables</varname> you may need to update these.
fr: Si vous avez modifié <varname>tiger.loader_platform</varname> ou <varname>tiger.loader_variables</varname>, vous devrez peut être les mettre à jour.

note: Tag: para
en: To confirm your install is working correctly, run this sql in your database:
fr: Pour tester l'installation, lancez cette commande SQL sur la base de données :

note: Tag: para
en: Which should output
fr: Qui devrait afficher

note: Tag: para
en: Create a new record in <varname>tiger.loader_platform</varname> table with the paths of your executables and server.
fr: Créez un nouvel enregistrement dans la table <varname>tiger.loader_platform</varname> contenant les chemins vers les exécutables et le serveur.

note: Tag: para
en: So for example to create a profile called debbie that follows <code>sh</code> convention. You would do:
fr: Par exemple, pour créer un profil nommé debbie suivant la convention <code>sh</code>, vous feriez :

note: Tag: para
en: And then edit the paths in the <emphasis>declare_sect</emphasis> column to those that fit Debbie's pg, unzip,shp2pgsql, psql, etc path locations.
fr: Et modifiez les chemins dans la colonne <emphasis>declare_sect</emphasis> pour les faire correspondre aux chemins des programmes pg, unzip, shp2pgsql, psql, etc. sur le serveur Debbie.

note: Tag: para
en: If you don't edit this <varname>loader_platform</varname> table, it will just contain common case locations of items and you'll have to edit the generated script after the script is generated.
fr: Si vous ne modifiez pas la table <varname>loader_platform</varname>, elle contiendra des chemins par défaut pour les programmes, et vous aurez à modifier les scripts après leur génération.

note: Tag: para
en: As of PostGIS 2.4.1 the Zip code-5 digit tabulation area <varname>zcta5</varname> load step was revised to load current zcta5 data and is part of the <xref linkend="Loader_Generate_Nation_Script"/> when enabled. It is turned off by default because it takes quite a bit of time to load (20 to 60 minutes), takes up quite a bit of disk space, and is not used that often.
fr: Depuis PostGIS 2.4.1, le chargement des données de "ZIP Code Tabulation Area" <varname>zcta5</varname> a été modifié pour charger les données actuelles zcta5, celui-ci est inclus dans <xref linkend="Loader_Generate_Nation_Script"/> si activé. Le chargement est désactivé par défaut car cela prend du temps (20 à 60 minutes), occupe de l'espace disque, et n'est pas souvent utile.

note: Tag: para
en: To enable it, do the following:
fr: Pour l'activer, exécutez :

note: Tag: para
en: If present the <xref linkend="Geocode"/> function can use it if a boundary filter is added to limit to just zips in that boundary. The <xref linkend="Reverse_Geocode"/> function uses it if the returned address is missing a zip, which often happens with highway reverse geocoding.
fr: Si disponible, la fonction <xref linkend="Geocode"/> peut l'utiliser lorsqu'un filtre de frontière est utilisé avec des codes zips. La fonction <xref linkend="Reverse_Geocode"/> l'utilise si l'adresse retournée n'a pas de code zip, ce qui arrive souvent avec le géocodage inverse sur des autoroutes.

note: Tag: para
en: Create a folder called <filename>gisdata</filename> on root of server or your local pc if you have a fast network connection to the server. This folder is where the tiger files will be downloaded to and processed. If you are not happy with having the folder on the root of the server, or simply want to change to a different folder for staging, then edit the field <varname>staging_fold</varname> in the <varname>tiger.loader_variables</varname> table.
fr: Créez un répertoire nommé <filename>gisdata</filename> à la racine du serveur ou de la machine locale si le réseau entre les deux est suffisamment rapide. Ce répertoire contiendra les fichiers tiger téléchargés et traités. Pour changer ce répertoire, modifier le champ <varname>staging_fold</varname> dans la table <varname>tiger.loader_variables</varname>.

note: Tag: para
en: Create a folder called temp in the <filename>gisdata</filename> folder or wherever you designated the <varname>staging_fold</varname> to be. This will be the folder where the loader extracts the downloaded tiger data.
fr: Créez un répertoire nommé temp dans le répertoire <filename>gisdata</filename> (ou dans le répertoire que vous avez configuré dans le champ <varname>staging_fold</varname>). Ce répertoire contiendra les données tiger extraites.

note: Tag: para
en: Then run the <xref linkend="Loader_Generate_Nation_Script"/> SQL function make sure to use the name of your custom profile and copy the script to a .sh or .bat file. So for example to build the nation load:
fr: Puis exécutez la fonction SQL <xref linkend="Loader_Generate_Nation_Script"/>, pour vous assurer que votre libellé de profil personnalisé est utilisé, et sauvegardez le script dans un fichier .sh ou .bat. Par exemple pour générer le script de chargement d'une nation :

note: Tag: para
en: Run the generated nation load commandline scripts.
fr: Exécutez en ligne de commande les scripts de chargement précédemment générés.

note: Tag: para
en: After you are done running the nation script, you should have three tables in your <code>tiger_data</code> schema and they should be filled with data. Confirm you do by doing the following queries from psql or pgAdmin
fr: Lorsque vous avez terminé d'exécuter les scripts, vous devriez avoir trois tables dans votre schéma <code>tiger_data</code>, avec des données déjà remplies. Vous pouvez confirmer cela avec les requêtes suivantes, à exécuter dans psql ou pgAdmn

note: Tag: para
en: This will only have data if you marked zcta5 to be loaded
fr: Celle-ci n'aura des données que si vous avez spécifié le chargement de zcta5

note: Tag: para
en: By default the tables corresponding to <varname>bg</varname>, <varname>tract</varname>, <varname>tabblock20</varname> are not loaded. These tables are not used by the geocoder but are used by folks for population statistics. If you wish to load them as part of your state loads, run the following statement to enable them.
fr: Par défaut, les tables correspondant à <varname>bg</varname>, <varname>tract</varname>, <varname>tabblock20</varname> ne sont pas chargées. Ces tables ne sont pas utilisées par le géocodeur, mais sont typiquement utilisées pour les statistiques de population. Si vous souhaitez charger ces données lors du chargement des états, exécutez la requête suivante.

note: Tag: para
en: Alternatively you can load just these tables after loading state data using the <xref linkend="Loader_Generate_Census_Script"/>
fr: Autrement, il est possible de charger juste ces tables après le chargement des données sur les états en utilisant le <xref linkend="Loader_Generate_Census_Script"/>

note: Tag: para
en: DO NOT Generate the state script until you have already loaded the nation data, because the state script utilizes county list loaded by nation script.
fr: NE GÉNÉREZ PAS le script d'état avant d'avoir chargé les données de nation, car le script d'état utilise la liste des comtés chargés par le script de nation.

note: Tag: para
en: For each state you want to load data for, generate a state script <xref linkend="Loader_Generate_Script"/>.
fr: Pour chaque état dont vous voulez charger les données, générez un script d'état <xref linkend="Loader_Generate_Script"/>.

note: Tag: para
en: Run the generated commandline scripts.
fr: Lancez alors les lignes de commande générées.

note: Tag: para
en: After you are done loading all data or at a stopping point, it's a good idea to analyze all the tiger tables to update the stats (include inherited stats)
fr: Après le chargement des données, ou lors d'une pause dans le chargement, il peut être utile de lancer analyze sur toutes les tables tiger pour mettre à jour les statistiques (y compris les statistiques héritées)

note: Tag: title
en: Using Address Standardizer Extension with Tiger geocoder
fr: Utilisation de l'Extension Address Standardizer avec le Geocodeur Tiger

note: Tag: para
en: One of the many complaints of folks is the address normalizer function <xref linkend="Normalize_Address"/> function that normalizes an address for prepping before geocoding. The normalizer is far from perfect and trying to patch its imperfectness takes a vast amount of resources. As such we have integrated with another project that has a much better address standardizer engine. To use this new address_standardizer, you compile the extension as described in <xref linkend="installing_pagc_address_standardizer"/> and install as an extension in your database.
fr: Une des plaintes les plus récurrentes concerne la fonction <xref linkend="Normalize_Address"/>, qui normalise l'adresse avant de la géocoder. La normalisation est loin d'être parfaite, et corriger ces imperfections consomme énormément de ressources. Par conséquent, nous avons intégré un autre projet qui a un moteur de standardisation d'adresses bien meilleur. Pour utiliser ce nouveau address_standardizer, compilez l'extension en suivant <xref linkend="installing_pagc_address_standardizer"/> et installez l'extension dans votre base de données.

note: Tag: para
en: Once you install this extension in the same database as you have installed <code>postgis_tiger_geocoder</code>, then the <xref linkend="Pagc_Normalize_Address"/> can be used instead of <xref linkend="Normalize_Address"/>. This extension is tiger agnostic, so can be used with other data sources such as international addresses. The tiger geocoder extension does come packaged with its own custom versions of <xref linkend="rulestab"/> ( <code>tiger.pagc_rules</code>) , <xref linkend="gaztab"/> (<code>tiger.pagc_gaz</code>), and <xref linkend="lextab"/> (<code>tiger.pagc_lex</code>). These you can add and update to improve your standardizing experience for your own needs.
fr: Une fois que vous avez installé cette extension dans la même base de données où vous avez installé <code>postgis_tiger_geocoder</code>, vous pouvez utiliser <xref linkend="Pagc_Normalize_Address"/> à la place de <xref linkend="Normalize_Address"/>. Cette extension ne dépend pas de Tiger, et peut donc être utilisée avec d'autres sources de données telles que des adresses internationales. L'extension de géocodage Tiger est installée avec ses propres versions spécifiques de <xref linkend="rulestab"/> ( <code>tiger.pagc_rules</code>) , <xref linkend="gaztab"/> (<code>tiger.pagc_gaz</code>), et <xref linkend="lextab"/> (<code>tiger.pagc_lex</code>). Vous pouvez les améliorer et ajouter des règles pour avoir de meilleurs résultats de géocodage pour vos besoins spécifiques.

note: Tag: title
en: Required tools for tiger data loading
fr: Outils nécessaires pour charger des données tiger

note: Tag: para
en: The load process downloads data from the census website for the respective nation files, states requested, extracts the files, and then loads each state into its own separate set of state tables. Each state table inherits from the tables defined in <varname>tiger</varname> schema so that its sufficient to just query those tables to access all the data and drop a set of state tables at any time using the <xref linkend="Drop_State_Tables_Generate_Script"/> if you need to reload a state or just don't need a state anymore.
fr: Le processus de chargement télécharge les données du site web census pour respectivement les fichiers nation, état demandé, extrait les fichiers, puis charge chaque état dans son ensemble de tables état. Chaque table state hérite de la table définie dans le schéma <varname>tiger</varname>, il est suffisant d'interroger ces tables pour accéder à toutes les données et supprimer un ensemble de table state n'importe quand en utilisant <xref linkend="Drop_State_Tables_Generate_Script"/> si vous devez recharger un état ou si vous en avez plus besoin.

note: Tag: para
en: In order to be able to load data you'll need the following tools:
fr: Dans l'objectif de charger des données vous avez besoin des outils suivants :

note: Tag: para
en: A tool to unzip the zip files from census website.
fr: Un outils pour décompresser les fichiers zip du site web census.

note: Tag: para
en: For Unix like systems: <varname>unzip</varname> executable which is usually already installed on most Unix like platforms.
fr: Pour les systèmes Unix-like : un exécutable <varname>unzip</varname> qui est habituellement installé sur la plupart des plateformes Unix-like.

note: Tag: para
en: For Windows, 7-zip which is a free compress/uncompress tool you can download from <link xlink:href="http://www.7-zip.org/">http://www.7-zip.org/</link>
fr: Pour Windows, 7-zip qui est un outils de compression/décompression libre, vous pouvez le récupérer à partir de <link xlink:href="http://www.7-zip.org/">http://www.7-zip.org/</link>

note: Tag: para
en: <filename>shp2pgsql</filename> commandline which is installed by default when you install PostGIS.
fr: La commande <filename>shp2pgsql</filename> qui est installé par défaut quand vous installez PostGIS.

note: Tag: para
en: <filename>wget</filename> which is a web grabber tool usually installed on most Unix/Linux systems.
fr: <filename>wget</filename> qui est un outil de récupération de lien habituellement installé sur les systèmes Unix/Linux.

note: Tag: para
en: If you are on windows, you can get pre-compiled binaries from <link xlink:href="http://gnuwin32.sourceforge.net/packages/wget.htm">http://gnuwin32.sourceforge.net/packages/wget.htm</link>
fr: Si vous êtes sous Windows, vous pouvez obtenir des binaires pré-compilés à partir de <link xlink:href="http://gnuwin32.sourceforge.net/packages/wget.htm">http://gnuwin32.sourceforge.net/packages/wget.htm</link>

note: Tag: para
en: If you are upgrading from tiger_2010, you'll need to first generate and run <xref linkend="Drop_Nation_Tables_Generate_Script"/>. Before you load any state data, you need to load the nation wide data which you do with <xref linkend="Loader_Generate_Nation_Script"/>. Which will generate a loader script for you. <xref linkend="Loader_Generate_Nation_Script"/> is a one-time step that should be done for upgrading (from a prior year tiger census data) and for new installs.
fr: Si vous mettez à jour depuis tiger_2010, vous aurez besoin d'abord de générer et exécuter le <xref linkend="Drop_Nation_Tables_Generate_Script"/>. Avant de charger les données d'états, vous devez charger les données de nation via <xref linkend="Loader_Generate_Nation_Script"/>. Celui-ci va générer un script de chargement pour vous. <xref linkend="Loader_Generate_Nation_Script"/> est une étape à exécuter une seule fois, pour la mises à jour (depuis des données tiger précédentes) ou pour de nouvelles installations.

note: Tag: para
en: To load state data refer to <xref linkend="Loader_Generate_Script"/> to generate a data load script for your platform for the states you desire. Note that you can install these piecemeal. You don't have to load all the states you want all at once. You can load them as you need them.
fr: Pour charger les données d'états, voir <xref linkend="Loader_Generate_Script"/> pour générer un script pour charger les données pour votre plateforme et les états que vous souhaitez. Note : vous pouvez les charger peu à peu, vous n'avez pas besoin de tout charger d'un coup. Vous pouvez les charger lorsque vous en avez besoin.

note: Tag: para
en: After the states you desire have been loaded, make sure to run the: <programlisting>SELECT install_missing_indexes();</programlisting> as described in <xref linkend="Install_Missing_Indexes"/>.
fr: Après que les états que vous désirez aient été chargé, assurez vous de lancer la commande : <programlisting>SELECT install_missing_indexes();</programlisting> comme décrit dans <xref linkend="Install_Missing_Indexes"/>.

note: Tag: para
en: To test that things are working as they should, try to run a geocode on an address in your state using <xref linkend="Geocode"/>
fr: Pour tester que les choses fonctionnent comme elles le devraient, essayez de lancer un géocodage sur une adresse de votre état en utilisant <xref linkend="Geocode"/>

note: Tag: title
en: Upgrading your Tiger Geocoder Install and Data
fr: Mise à jour du géocoder Tiger et de ses données

note: Tag: para
en: First upgrade your postgis_tiger_geocoder extension as follows:
fr: Tout d'abord, mettez à jour l'extension postgis_tiger_geocoder en exécutant :

note: Tag: para
en: Next drop all nation tables and load up the new ones. Generate a drop script with this SQL statement as detailed in <xref linkend="Drop_Nation_Tables_Generate_Script"/>
fr: Puis supprimez toutes les tables nation et chargez les nouvelles. Générez un script de suppression avec la requête SQL comme détaillée dans <xref linkend="Drop_Nation_Tables_Generate_Script"/>

note: Tag: para
en: Run the generated drop SQL statements.
fr: Lancement des requêtes SQL de suppression générées.

note: Tag: para
en: Generate a nation load script with this SELECT statement as detailed in <xref linkend="Loader_Generate_Nation_Script"/>
fr: Générez un script de chargement des pays avec la requête SELECT comme détaillé dans <xref linkend="Loader_Generate_Nation_Script"/>

note: Tag: emphasis
en: For windows
fr: Pour windows

note: Tag: emphasis
en: For unix/linux
fr: Pour unix/linux

note: Tag: para
en: Refer to <xref linkend="install_tiger_geocoder_extension"/> for instructions on how to run the generate script. This only needs to be done once.
fr: Reportez-vous à <xref linkend="install_tiger_geocoder_extension"/> pour savoir comment exécuter le script de génération. Cette opération ne doit être effectuée qu'une seule fois.

note: Tag: para
en: You can have a mix of different year state tables and can upgrade each state separately. Before you upgrade a state you first need to drop the prior year state tables for that state using <xref linkend="Drop_State_Tables_Generate_Script"/>.
fr: Vous pouvez avoir un mix de différentes années dans vos tables d'états et vous pouvez les mettre à jour indépendamment. Avant de mettre à jour un état, vous devez d'abord supprimer l'année précédente dans les tables d'états pour cet état en utilisant <xref linkend="Drop_State_Tables_Generate_Script"/>.

note: Tag: title
en: Common Problems during installation
fr: Problèmes courants pendant l'installation

note: Tag: para
en: There are several things to check when your installation or upgrade doesn't go as you expected.
fr: Il y a plusieurs choses à vérifier quand votre installation ou mise à jour ne va pas dans la direction souhaitée.

note: Tag: para
en: Check that you have installed PostgreSQL &min_postgres_version; or newer, and that you are compiling against the same version of the PostgreSQL source as the version of PostgreSQL that is running. Mix-ups can occur when your (Linux) distribution has already installed PostgreSQL, or you have otherwise installed PostgreSQL before and forgotten about it. PostGIS will only work with PostgreSQL &min_postgres_version; or newer, and strange, unexpected error messages will result if you use an older version. To check the version of PostgreSQL which is running, connect to the database using psql and run this query:
fr: Vérifiez que vous avez installé PostgreSQL &min_postgres_version; ou plus récent et que vous êtes en train de compiler avec la même version du code source de PostgreSQL que la version qui fonctionne. Un mélange peut arriver lorsque votre distribution (Linux) a déjà une version de PostgreSQL installée ou que vous avez oublié que vous avez déjà installée une version. PostGIS fonctionnera uniquement avec PostgreSQL &min_postgres_version; ou plus récent, et des messages d'erreurs étranges et inhabituelles en résultera si vous utilisez une version plus ancienne. Pour vérifier la version de PostgreSQL qui fonctionne, connectez vous à la base en utilisant psql et lancez la requête :

note: Tag: para
en: If you are running an RPM based distribution, you can check for the existence of pre-installed packages using the <command>rpm</command> command as follows: <command>rpm -qa | grep postgresql</command>
fr: Si vous utilisez une distribution basé sur les RPM, vous pouvez vérifier l'existence de paquets pré-installés en utilisant la commande <command>rpm</command> comme suit : <command>rpm -qa | grep postgresql</command>

note: Tag: para
en: If your upgrade fails, make sure you are restoring into a database that already has PostGIS installed.
fr: Si votre mise à jour plante, assurez vous de la présence de PostGIS dans la nouvelle base de données.

note: Tag: para
en: Also check that configure has correctly detected the location and version of PostgreSQL, the Proj library and the GEOS library.
fr: Vérifiez également que le script configure a correctement détecté les chemins et versions de PostgreSQL, de la bibliothèque Proj.4 et de la blibliothèque GEOS.

note: Tag: para
en: The output from configure is used to generate the <filename>postgis_config.h</filename> file. Check that the <varname>POSTGIS_PGSQL_VERSION</varname>, <varname>POSTGIS_PROJ_VERSION</varname> and <varname>POSTGIS_GEOS_VERSION</varname> variables have been set correctly.
fr: La sortie du configure est utilisée pour générer le fichier <filename>postgis_config.h</filename>. Vérifiez que les variables <varname>POSTGIS_PGSQL_VERSION</varname>, <varname>POSTGIS_PROJ_VERSION</varname> et <varname>POSTGIS_GEOS_VERSION</varname> ont été définies correctement.

note: Tag: para
en: PostGIS is a spatial extension for the PostgreSQL relational database that was created by Refractions Research Inc, as a spatial database technology research project. Refractions is a GIS and database consulting company in Victoria, British Columbia, Canada, specializing in data integration and custom software development.
fr: PostGIS est une extension spatiale pour la base de données relationnelle PostgreSQL. Elle a été créée par Refractions Research Inc, sous la forme d'un projet de recherche sur les technologies de base de données spatiales. Refractions est une société de conseil en SIG et base de données basée à Victoria, British Columbia, Canada, et spécialisée en intégration de données et développement logiciel.

note: Tag: para
en: PostGIS is now a project of the OSGeo Foundation and is developed and funded by many FOSS4G developers and organizations all over the world that gain great benefit from its functionality and versatility.
fr: PostGIS est désormais un projet de la OSGeo Foundation. PostGIS est développé et financé par de nombreux développeurs et organismes FOSS4G dans le monde entier, qui bénéficient de manière significative de ses fonctionnalités et de sa polyvalence.

note: Tag: para
en: The PostGIS project development group plans on supporting and enhancing PostGIS to better support a range of important GIS functionality in the areas of OGC and SQL/MM spatial standards, advanced topological constructs (coverages, surfaces, networks), data source for desktop user interface tools for viewing and editing GIS data, and web-based access tools.
fr: Le groupe de développement du projet PostGIS a en charge la maintenance et l'amélioration de PostGIS pour un meilleur support de fonctionnalités importantes en SIG, dans les domaines des standards OGC et SQL/MM, des constructions topologiques avancées (couvertures, surfaces, réseaux), des sources de données pour les outils graphiques de bureautique pour la visualisation et l'édition des donnée SIG, ainsi que dans le domaine des outils web.

note: Tag: title
en: Project Steering Committee
fr: Comité de direction du projet (Project Steering Committee)

note: Tag: para
en: The PostGIS Project Steering Committee (PSC) coordinates the general direction, release cycles, documentation, and outreach efforts for the PostGIS project. In addition the PSC provides general user support, accepts and approves patches from the general PostGIS community and votes on miscellaneous issues involving PostGIS such as developer commit access, new PSC members or significant API changes.
fr: Le comité de direction du projet (PSC) coordonne la direction générale, les cycles de publication, la documentation et les efforts spécifiques pour le projet PostGIS. De plus, le PSC fournit un support général aux utilisateurs, accepte et approuve les patches de la communauté PostGIS et vote sur divers points concernant PostGIS, tels que les accès commit pour les développeurs, les nouveaux membres du PSC ou les changements majeurs d'API.

note: Tag: para
en: MVT support, Bug fixing, Performance and stability improvements, GitHub curation, alignment of PostGIS with PostgreSQL releases
fr: Support MVT, Correction de bugs, Améliorations des performances et de la stabilité, Nettoyage du GitHub, Alignement de PostGIS avec les publications PostgreSQL

note: Tag: para
en: CI and website maintenance, Windows production and experimental builds, documentation, alignment of PostGIS with PostgreSQL releases, X3D support, TIGER geocoder support, management functions.
fr: Maintenance de l'IC (intégration continue) et du site web, production Windows et builds expérimentaux, documentation, alignement de PostGIS sur les versions de PostgreSQL, support X3D, support du géocodeur TIGER, fonctions de gestion.

note: Tag: para
en: Index improvements, bug fixing and geometry/geography function improvements, SFCGAL, raster, GitHub curation, and ci maintenance.
fr: Amélioration de l'index, correction de bugs et amélioration des fonctions de géométrie/géographie, SFCGAL, raster, curation GitHub, et maintenance ci (intégration continue).

note: Tag: term
en: Paul Ramsey (Chair)
fr: Paul Ramsey (Directeur)

note: Tag: para
en: Co-founder of PostGIS project. General bug fixing, geography support, geography and geometry index support (2D, 3D, nD index and anything spatial index), underlying geometry internal structures, GEOS functionality integration and alignment with GEOS releases, alignment of PostGIS with PostgreSQL releases, loader/dumper, and Shapefile GUI loader.
fr: Co-fondateur de PostGIS. Maintenance générale, maintenance des Geography, maintenance des index Geography et Geometry (index 2D, 3D, nD et tout index spatial), structures internes des Geometry, intégration des fonctionnalités GEOS et alignement avec les publications GEOS, alignement de PostGIS avec les publications PostgreSQL, loader/dumper, IHM de chargement Shapefile.

note: Tag: para
en: Bug fixes and maintenance, ci maintenance, git mirror management, management functions, integration of new GEOS functionality and alignment with GEOS releases, topology support, and raster framework and low level API functions.
fr: Corrections de bugs et maintenance, maintenance des CI (intégration continue), gestion des miroirs git, fonctions de gestion, intégration de nouvelles fonctionnalités GEOS et alignement sur les versions GEOS, support topologique, framework raster et fonctions API de bas niveau.

note: Tag: title
en: Core Contributors Present
fr: Contributeurs cœur actuels

note: Tag: para
en: Distance function enhancements (including 3D distance and relationship functions) and additions, Tiny WKB (TWKB) output format and general user support
fr: Améliorations et ajouts de fonctions de distance (notamment fonctions de distance 3D et relations), format de sortie Tiny WKB (TWKB) et support utilisateur

note: Tag: para
en: SFCGAL enhancements and maintenance and ci support
fr: Améliorations et maintenance de SFCGAL et maintien de l'intégration continue

note: Tag: para
en: Geometry clustering function additions, other geometry algorithm enhancements, GEOS enhancements and general user support
fr: Ajout de fonctions sur le clustering de géométries, améliorations sur les algorithmes sur les géométries, améliorations GEOS et support utilisateur

note: Tag: para
en: GEOS enhancements and documentation
fr: Améliorations GEOS et documentation

note: Tag: para
en: MapBox Vector Tile, GeoBuf, and Flatgeobuf functions. Gitea testing and GitLab experimentation.
fr: Fonctions MapBox Vector Tile, GeoBuf et Flatgeobuf. Tests Gitea et expérimentation GitLab.

note: Tag: para
en: Geometry Processing, PostgreSQL gist, general bug fixing
fr: Traitement des géométries, PostgreSQL gist, correction de bugs

note: Tag: title
en: Core Contributors Past
fr: Anciens contributeurs cœur

note: Tag: para
en: Prior PSC Member. Raster development, integration with GDAL, raster loader, user support, general bug fixing, testing on various OS (Slackware, Mac, Windows, and more)
fr: Ancien membre du PSC. Développement raster, intégration avec GDAL, loader raster, support utilisateur, correction de bugs, tests sur divers systèmes d'exploitation (Slackware, Mac, Windows, et autres)

note: Tag: para
en: Prior PSC Member. Coordinated bug fixing and maintenance effort, spatial index selectivity and binding, loader/dumper, and Shapefile GUI Loader, integration of new and new function enhancements.
fr: Ancien membre du PSC. Coordination de l'effort de correction de bugs et de maintenance, sélectivité et liaisons des index spatiaux, loader/dumper, IHM de chargement Shapefile, intégration et amélioration de nouvelles fonctions.

note: Tag: para
en: Raster development, GDAL driver support, loader
fr: Développement Raster, support du driver GDAL, outil de chargement

note: Tag: para
en: (Emeritus) Input/output XML (KML,GML)/GeoJSON functions, 3D support and bug fixes.
fr: (Émérite) Fonctions d'entrée/sortie XML (KML,GML) et fonctions GeoJSON, support 3D et correction de bugs.

note: Tag: para
en: Prior PSC Member. General development, site and buildbot maintenance, OSGeo incubation management
fr: Ancien membre du PSC. Développement général, maintenance du site et du robot de build, gestion de l'incubation OSGeo

note: Tag: para
en: CMake support for PostGIS, built original raster loader in python and low level raster API functions
fr: Support de CMake pour PostGIS, a développé le loader raster original en python et les fonctions d'API bas-niveau raster

note: Tag: para
en: Prior PSC Member. Documentation and documentation support tools, buildbot maintenance, advanced user support on PostGIS newsgroup, and PostGIS maintenance function enhancements.
fr: Ancien membre du PSC. Documentation et outils pour la documentation, maintenance du robot de build, support utilisateur avancé sur le newsgroup PostGIS, et maintenance et améliorations des fonctions PostGIS.

note: Tag: para
en: The original developer/Co-founder of PostGIS. Dave wrote the server side objects, index bindings, and many of the server side analytical functions.
fr: Développeur originel et co-fondateur de PostGIS. Dave a écrit les objets côté serveur, les liaisons des index, et de nombreuses fonctions d'analyse côté serveur.

note: Tag: para
en: Original development of the Shapefile loader/dumper.
fr: Développement originel de l'outil de chargement/export de shapefiles.

note: Tag: para
en: Ongoing maintenance and development of core functions. Enhanced curve support. Shapefile GUI loader.
fr: Maintenance générale et développement de fonctions du noyau PostGIS. Amélioration du support des courbes. Interface graphique de chargement des shapefiles.

note: Tag: para
en: Architect of PostGIS raster implementation. Raster overall architecture, prototyping, programming support
fr: Architecte de l'implémentation raster de PostGIS. Architecture globale raster, prototypage, support au développement

note: Tag: para
en: Raster development (mostly map algebra analytic functions)
fr: Développement raster (principalement fonctions analytiques d'algèbre cartographique)

note: Tag: title
en: Other Contributors
fr: Autres contributeurs

note: Tag: term
en: Individual Contributors
fr: Contributeurs individuels

note: Tag: term
en: Corporate Sponsors
fr: Organisations sponsors

note: Tag: para
en: These are corporate entities that have contributed developer time, hosting, or direct monetary funding to the PostGIS project. In alphabetical order:
fr: Certaines organisations ont contribué du temps de développeur, de l'hébergement, ou du financement direct pour le projet PostGIS. Par ordre alphabétique :

note: Tag: term
en: Crowd Funding Campaigns
fr: Campagnes de financement participatif

note: Tag: para
en: Crowd funding campaigns are campaigns we run to get badly wanted features funded that can service a large number of people. Each campaign is specifically focused on a particular feature or set of features. Each sponsor chips in a small fraction of the needed funding and with enough people/organizations contributing, we have the funds to pay for the work that will help many. If you have an idea for a feature you think many others would be willing to co-fund, please post to the <link xlink:href="https://lists.osgeo.org/mailman/listinfo/postgis-users">PostGIS newsgroup</link> your thoughts and together we can make it happen.
fr: Les campagnes de financement participatif sont des campagnes que nous organisons pour financer des fonctionnalités très demandées qui peuvent servir à une large communauté. Chaque campagne est centrée sur une fonctionnalité, ou un lot de fonctionnalités. Chaque sponsor apporte une petite fraction du financement nécessaire, et avec assez de personnes et d'organisations contribuant, nous obtenons les fonds nécessaires pour payer le travail qui aidera la communauté. Si vous pensez qu'une fonctionnalité pourrait être co-financée par de nombreux acteurs, vous pouvez poster votre idée sur le <link xlink:href="https://lists.osgeo.org/mailman/listinfo/postgis-users">newsgroup PostGIS</link> et ensemble nous pourrons la réaliser.

note: Tag: para
en: PostGIS 2.0.0 was the first release we tried this strategy. We used <link xlink:href="http://www.pledgebank.com">PledgeBank</link> and we got two successful campaigns out of it.
fr: PostGIS 2.0.0 a été la première version où cette stratégie a été testée. Nous avons utilisé <link xlink:href="http://www.pledgebank.com">PledgeBank</link> et avons eu deux campagnes de financement réussies.

note: Tag: para
en: <link xlink:href="http://www.pledgebank.com/postgistopology"><emphasis role="bold">postgistopology</emphasis></link> - 10 plus sponsors each contributed $250 USD to build toTopoGeometry function and beef up topology support in 2.0.0. It happened.
fr: <link xlink:href="http://www.pledgebank.com/postgistopology"><emphasis role="bold">postgistopology</emphasis></link> - Plus de 10 sponsors ont contribué chacun 250USD pour créer la fonction toTopoGeometry et sortir le support de la topologie dans la version 2.0.0. Ce fut une réussite.

note: Tag: para
en: <link xlink:href="http://www.pledgebank.com/postgis64windows"><emphasis role="bold">postgis64windows</emphasis></link> - 20 someodd sponsors each contributed $100 USD to pay for the work needed to work out PostGIS 64-bit issues on windows. It happened.
fr: <link xlink:href="http://www.pledgebank.com/postgis64windows"><emphasis role="bold">postgis64windows</emphasis></link> - Plus de 20 sponsors ont contribué chacun 100USD pour le support PostGIS 64-bit sur Windows. Ce fut une réussite.

note: Tag: term
en: Important Support Libraries
fr: Bibliothèques de base importantes

note: Tag: para
en: The <link xlink:href="https://libgeos.org">GEOS</link> geometry operations library
fr: <link xlink:href="https://libgeos.org">GEOS</link>, la bibliothèque pour les opérations sur les géometries

note: Tag: para
en: The <link xlink:href="https://gdal.org">GDAL</link> Geospatial Data Abstraction Library used to power much of the raster functionality introduced in PostGIS 2. In kind, improvements needed in GDAL to support PostGIS are contributed back to the GDAL project.
fr: <link xlink:href="https://gdal.org">GDAL</link> (Geospatial Data Abstraction Library), la bibliothèque utilisée pour propulser la plupart des fonctionnalités raster introduites dans PostGIS 2. En retour, les améliorations requises dans GDAL pour supporter PostGIS sont reversées dans le projet GDAL.

note: Tag: para
en: The <link xlink:href="https://www.proj4.org">PROJ</link> cartographic projection library
fr: <link xlink:href="https://www.proj4.org">PROJ</link>, la bibliothèque gérant les projections cartographiques

note: Tag: para
en: Last but not least, <link xlink:href="http://www.postgresql.org">PostgreSQL</link>, the giant that PostGIS stands on. Much of the speed and flexibility of PostGIS would not be possible without the extensibility, great query planner, GIST index, and plethora of SQL features provided by PostgreSQL.
fr: Enfin, mais non des moindres, le projet de SGBD <link xlink:href="http://www.postgresql.org">PostgreSQL</link>, géant sur les épaules duquel PostGIS s'appuie. La rapidité et flexibilité de PostGIS serait impossible sans l'extensibilité, le planificateur de requêtes, les index GiST et les nombreuses fonctionnalités SQL que fournit PostgreSQL.

note: Tag: title
en: Performance Tips
fr: Conseils sur les performances

note: Tag: title
en: Small tables of large geometries
fr: Petites tables de grandes géométries

note: Tag: title
en: Problem description
fr: Description du problème

note: Tag: para
en: Current PostgreSQL versions (including 9.6) suffer from a query optimizer weakness regarding TOAST tables. TOAST tables are a kind of "extension room" used to store large (in the sense of data size) values that do not fit into normal data pages (like long texts, images or complex geometries with lots of vertices), see <link xlink:href="http://www.postgresql.org/docs/current/static/storage-toast.html">the PostgreSQL Documentation for TOAST</link> for more information).
fr: Les versions de PostgreSQL actuelles (y compris 8.0) souffrent d'une faiblesse optimiseur de requête relative les tables TOAST. Tables TOAST sont une sorte de «salle de l'extension" utilisé pour stocker de grandes valeurs (dans le sens de la taille des données) qui ne rentrent pas dans les pages de données normales (comme de longs textes, images ou des géométries complexes avec beaucoup de sommets), voir <link xlink:href="http://www.postgresql.org/docs/current/static/storage-toast.html"> Documentation PostgreSQL pour TOAST </link> pour plus d'informations).

note: Tag: para
en: The problem appears if you happen to have a table with rather large geometries, but not too many rows of them (like a table containing the boundaries of all European countries in high resolution). Then the table itself is small, but it uses lots of TOAST space. In our example case, the table itself had about 80 rows and used only 3 data pages, but the TOAST table used 8225 pages.
fr: Le problème apparaît s'il vous arrive d'avoir une table avec d'assez grandes géométries, mais pas beaucoup de lignes d'entre elles (comme un tableau contenant les frontières de tous les pays européens en haute résolution). Ensuite, le tableau lui-même est petit, mais il utilise beaucoup d'espace TOAST. Dans notre exemple, le cas, la table elle-même avait environ 80 lignes et seulement 3 pages de données utilisées, mais la table TOAST 8225 pages utilisé.

note: Tag: para
en: Now issue a query where you use the geometry operator &amp;&amp; to search for a bounding box that matches only very few of those rows. Now the query optimizer sees that the table has only 3 pages and 80 rows. It estimates that a sequential scan on such a small table is much faster than using an index. And so it decides to ignore the GIST index. Usually, this estimation is correct. But in our case, the &amp;&amp; operator has to fetch every geometry from disk to compare the bounding boxes, thus reading all TOAST pages, too.
fr: Maintenant émettre une requête en utilisant l'opérateur de géométrie &amp;&amp; pour rechercher une boîte englobante qui correspond que très peu de ces lignes. Maintenant l'optimiseur de requêtes voit que la table n'a que 3 pages et 80 lignes. Il estime qu'une analyse séquentielle sur une telle petite table est beaucoup plus rapide que d'utiliser un index. Et alors il décide d'ignorer l'index GIST. Habituellement, cette estimation est correcte. Mais dans notre cas, l'opérateur &amp;&amp; doit aller chercher chaque géométrie à partir du disque pour comparer les boîtes englobantes, et par conséquent la lecture de toutes les pages TOAST également.

note: Tag: para
en: To see whether your suffer from this issue, use the "EXPLAIN ANALYZE" postgresql command. For more information and the technical details, you can read the thread on the PostgreSQL performance mailing list: <link xlink:href="http://archives.postgresql.org/pgsql-performance/2005-02/msg00030.php">http://archives.postgresql.org/pgsql-performance/2005-02/msg00030.php</link>
fr: Pour voir si vous souffrez de ce problème, utilisez la commande postgresql "EXPLAIN ANALYZE". Pour plus d'informations et les détails techniques, vous pouvez lire le fil de discussion sur la liste de diffusion sur les performances de PostgreSQL : <link xlink:href="http://archives.postgresql.org/pgsql-performance/2005-02/msg00030.php">http://archives.postgresql.org/pgsql-performance/2005-02/msg00030.php</link>

note: Tag: para
en: and newer thread on PostGIS <link xlink:href="https://lists.osgeo.org/pipermail/postgis-devel/2017-June/026209.html">https://lists.osgeo.org/pipermail/postgis-devel/2017-June/026209.html</link>
fr: et un fil d'actualités plus récent sur PostGIS <link xlink:href="https://lists.osgeo.org/pipermail/postgis-devel/2017-June/026209.html">https://lists.osgeo.org/pipermail/postgis-devel/2017-June/026209.html</link>

note: Tag: title
en: Workarounds
fr: Solutions de contournement

note: Tag: para
en: The PostgreSQL people are trying to solve this issue by making the query estimation TOAST-aware. For now, here are two workarounds:
fr: Les personnes de PostgreSQL essayent de résoudre ce problème en faisant l'estimation de la requête TOAST-courant. Pour l'instant, voici deux solutions :

note: Tag: para
en: The first workaround is to force the query planner to use the index. Send "SET enable_seqscan TO off;" to the server before issuing the query. This basically forces the query planner to avoid sequential scans whenever possible. So it uses the GIST index as usual. But this flag has to be set on every connection, and it causes the query planner to make misestimations in other cases, so you should "SET enable_seqscan TO on;" after the query.
fr: La première solution consiste à forcer le planificateur de requêtes à utiliser l'index. Envoyer "SET enable_seqscan TO off;" au serveur avant d'émettre la requête. Cela force le planificateur de requêtes à éviter balayages séquentiels lorsque cela est possible. Donc, il utilise l'index GIST comme d'habitude. Mais cet indicateur doit être fixé à chaque connexion, et il provoque le planificateur de requêtes à faire des erreurs d'estimation dans les autres cas, vous devrez donc faire "SET POUR enable_seqscan sur;" après la requête.

note: Tag: para
en: The second workaround is to make the sequential scan as fast as the query planner thinks. This can be achieved by creating an additional column that "caches" the bbox, and matching against this. In our example, the commands are like:
fr: La deuxième solution consiste à faire le balayage séquentielle aussi vite que le planificateur de requêtes pense. Ceci peut être réalisé en créant une colonne supplémentaire qui "cache" la bbox, et contre cette correspondance. Dans notre exemple, les commandes sont comme :

note: Tag: para
en: Now change your query to use the &amp;&amp; operator against bbox instead of geom_column, like:
fr: Modifiez maintenant votre requête pour utiliser l'opérateur &amp;&amp; contre bbox au lieu de geom_column, comme suit :

note: Tag: para
en: Of course, if you change or add rows to mytable, you have to keep the bbox "in sync". The most transparent way to do this would be triggers, but you also can modify your application to keep the bbox column current or run the UPDATE query above after every modification.
fr: Bien sûr, si vous changez ou ajoutez des lignes à mytable, vous devez garder la bbox "synchro". La façon la plus transparente pour ce faire serait des déclencheurs, mais vous pouvez également modifier votre application afin de maintenir la colonne bbox courante ou exécuter la requête UPDATE ci-dessus après chaque modification.

note: Tag: title
en: CLUSTERing on geometry indices
fr: CLUSTER d'index géométriques

note: Tag: para
en: For tables that are mostly read-only, and where a single index is used for the majority of queries, PostgreSQL offers the CLUSTER command. This command physically reorders all the data rows in the same order as the index criteria, yielding two performance advantages: First, for index range scans, the number of seeks on the data table is drastically reduced. Second, if your working set concentrates to some small intervals on the indices, you have a more efficient caching because the data rows are spread along fewer data pages. (Feel invited to read the CLUSTER command documentation from the PostgreSQL manual at this point.)
fr: Pour les tables qui sont pour la plupart en lecture seule, et où un seul index est utilisé pour la majorité des requêtes, PostgreSQL offre la commande CLUSTER. Cette commande réorganise physiquement toutes les lignes de données dans le même ordre que les critères de l'index, ce qui donne deux avantages de performance : d'abord, pour des analyses d'intervalle de l'index, le nombre de recherche sur la table de données est considérablement réduit. Deuxièmement, si votre jeu de travail se concentre à quelques petits intervalles sur les index, vous avez une mise en cache plus efficace parce que les lignes de données sont dispersées sur moins de pages de données. (N'hésitez pas à lire la documentation de la commande CLUSTER du manuel PostgreSQL à ce stade)

note: Tag: para
en: However, currently PostgreSQL does not allow clustering on PostGIS GIST indices because GIST indices simply ignores NULL values, you get an error message like:
fr: Cependant, PostgreSQL ne permet actuellement pas le clustering sur les index GIST de PostGIS car les indices GIST ignorent les valeurs NULL, vous obtenez un message d'erreur comme :

note: Tag: para
en: As the HINT message tells you, one can work around this deficiency by adding a "not null" constraint to the table:
fr: Comme le message d'ASTUCES vous le dit, on peut contourner cette lacune en ajoutant une contrainte "not null" à la table :

note: Tag: para
en: Of course, this will not work if you in fact need NULL values in your geometry column. Additionally, you must use the above method to add the constraint, using a CHECK constraint like "ALTER TABLE blubb ADD CHECK (geometry is not null);" will not work.
fr: Bien sûr, cela ne fonctionnera pas si vous avez besoin, dans les faits, de valeurs NULL dans la colonne de géométrie. En outre, vous devez utiliser la méthode ci-dessus pour ajouter la contrainte, en utilisant une contrainte CHECK comme "ALTER TABLE blubb ADD CHECK (geometry is not null)" ne fonctionnera pas.

note: Tag: title
en: Avoiding dimension conversion
fr: Eviter les conversions de dimension

note: Tag: para
en: Sometimes, you happen to have 3D or 4D data in your table, but always access it using OpenGIS compliant ST_AsText() or ST_AsBinary() functions that only output 2D geometries. They do this by internally calling the ST_Force2D() function, which introduces a significant overhead for large geometries. To avoid this overhead, it may be feasible to pre-drop those additional dimensions once and forever:
fr: Il arrive parfois que vous ayez des données 3D ou 4D dans votre table, mais que vous y accédiez toujours à l'aide des fonctions ST_AsText() ou ST_AsBinary() conformes à OpenGIS qui ne produisent que des géométries 2D. Pour ce faire, elles appellent en interne la fonction ST_Force2D(), qui introduit une surcharge importante pour les géométries de grande taille. Pour éviter cette surcharge, il peut être possible de pré-déposer ces dimensions supplémentaires une fois pour toutes :

note: Tag: para
en: Note that if you added your geometry column using AddGeometryColumn() there'll be a constraint on geometry dimension. To bypass it you will need to drop the constraint. Remember to update the entry in the geometry_columns table and recreate the constraint afterwards.
fr: Notez que si vous avez ajouté votre colonne de géométrie à l'aide AddGeometryColumn (), il y aura une contrainte sur la dimension de la géométrie. Pour contourner vous devrez supprimer la contrainte. N'oubliez pas de mettre à jour l'entrée dans la table geometry_columns et recréer la contrainte par la suite.

note: Tag: para
en: In case of large tables, it may be wise to divide this UPDATE into smaller portions by constraining the UPDATE to a part of the table via a WHERE clause and your primary key or another feasible criteria, and running a simple "VACUUM;" between your UPDATEs. This drastically reduces the need for temporary disk space. Additionally, if you have mixed dimension geometries, restricting the UPDATE by "WHERE dimension(geom)&gt;2" skips re-writing of geometries that already are in 2D.
fr: En cas de grandes tables, il peut être judicieux de diviser cette mise à jour en petites portions en restreignant l'UPDATE à une partie de la table via une clause WHERE et votre clé primaire ou d'un autre critère, et exécutant un simple «VACUUM» ; entre votre mises à jour. Cela réduit considérablement le besoin d'espace disque temporaire. En outre, si vous avez des données géométriques de dimension mixte, restreindre la mise à jour en "WHERE dimension(the_geom)&gt;2" saute la ré-écriture des géométries qui sont déjà en 2D.

note: Tag: title
en: PostGIS &last_release_version; Manual
fr: Manuel PostGIS &last_release_version;

note: Tag: orgname
en: The PostGIS Development Group
fr: Le groupe de développement PostGIS

note: Tag: para
en: PostGIS is an extension to the <link xlink:href="https://www.postgresql.org/">PostgreSQL</link> object-relational database system which allows GIS (Geographic Information Systems) objects to be stored in the database. PostGIS includes support for GiST-based R-Tree spatial indexes, and functions for analysis and processing of GIS objects.
fr: PostGIS est une extension du système de base de <link xlink:href="https://www.postgresql.org/">PostgreSQL</link> données relationnel-objet qui permet de stocker des objets SIG (Système d'Information Géographique) dans la base. PostGIS comporte un support des index spatiaux R-Tree basé sur GiST et des fonctions d'analyse et de traitement des objets SIG.

note: Tag: para
en: This is the manual for version &last_release_version;
fr: Manuel de la version &last_release_version;

note: Tag: para
en: This work is licensed under a <link xlink:href="http://creativecommons.org/licenses/by-sa/3.0/">Creative Commons Attribution-Share Alike 3.0 License</link>. Feel free to use this material any way you like, but we ask that you attribute credit to the PostGIS Project and wherever possible, a link back to <link xlink:href="https://postgis.net">https://postgis.net</link>.
fr: Ce travail est soumis à une licence <link xlink:href="http://creativecommons.org/licenses/by-sa/3.0/">Creative Commons Attribution-Share Alike 3.0 License</link>. Vous pouvez utiliser ce matériel comme bon vous semble, mais nous vous demandons de mentionner le projet PostGIS et, dans la mesure du possible, d'ajouter un lien vers <link xlink:href="https://postgis.net">https://postgis.net</link>.

note: Tag: title
en: PostGIS Special Functions Index
fr: Index des fonctions spéciales de PostGIS

note: Tag: title
en: PostGIS Aggregate Functions
fr: Fonctions d'agrégation de PostGIS

note: Tag: para
en: The functions below are spatial aggregate functions that are used in the same way as SQL aggregate function such as <code>sum</code> and <code>average</code>.
fr: Les fonctions ci-dessous sont des fonctions d'agrégation spatiale qui sont utilisées de la même manière que les fonctions d'agrégation SQL telles que <code>sum</code> et <code>average</code>.

note: Tag: title
en: PostGIS Window Functions
fr: Fonctions Window PostGIS

note: Tag: para
en: The functions below are spatial window functions that are used in the same way as SQL window functions such as <code>row_number()</code>, <code>lead()</code>, and <code>lag()</code>. They must be followed by an <code>OVER()</code> clause.
fr: Les fonctions ci-dessous sont des fonctions window spatiale qui sont utilisées de la même manière que les fonctions de fenêtre SQL telles que <code>row_number()</code>, <code>lead()</code>, et <code>lag()</code>. Elles doivent être suivies d'une clause <code>OVER()</code>.

note: Tag: title
en: PostGIS SQL-MM Compliant Functions
fr: Fonctions de PostGIS compatibles avec SQL-MM

note: Tag: para
en: The functions given below are PostGIS functions that conform to the SQL/MM 3 standard
fr: Les fonctions ci-dessous sont des fonctions PostGIS conformes à la norme SQL/MM 3

note: Tag: title
en: PostGIS Geography Support Functions
fr: Fonctions d'aide au type geography de PostGIS

note: Tag: para
en: The functions and operators given below are PostGIS functions/operators that take as input or return as output a <link linkend="PostGIS_Geography">geography</link> data type object.
fr: Les fonctions et opérateurs ci-dessous sont des fonctions/opérateurs PostGIS qui prennent en entrée ou renvoient en sortie un objet de type <link linkend="PostGIS_Geography">geography</link>.

note: Tag: para
en: Functions with a (T) are not native geodetic functions, and use a ST_Transform call to and from geometry to do the operation. As a result, they may not behave as expected when going over dateline, poles, and for large geometries or geometry pairs that cover more than one UTM zone. Basic transform - (favoring UTM, Lambert Azimuthal (North/South), and falling back on mercator in worst case scenario)
fr: Les fonctions avec un (T) ne sont pas des fonctions géodésiques natives, et utilisent un appel ST_Transform vers et depuis la géométrie pour effectuer l'opération. Par conséquent, elles peuvent ne pas se comporter comme prévu lorsque l'on passe au-dessus de la ligne de base, des pôles, et pour les grandes géométries ou les paires de géométries qui couvrent plus d'une zone UTM. Transformation de base - (favorisant l'UTM, l'azimut Lambert (Nord/Sud), et se rabattant sur le mercator dans le pire des cas)

note: Tag: title
en: PostGIS Raster Support Functions
fr: Fonctions de support des données raster de PostGIS

note: Tag: para
en: The functions and operators given below are PostGIS functions/operators that take as input or return as output a <xref linkend="raster"/> data type object. Listed in alphabetical order.
fr: Les fonctions et opérateurs ci-dessous sont des fonctions/opérateurs PostGIS qui prennent en entrée ou renvoient en sortie un objet de type <xref linkend="raster"/>. Ils sont classés par ordre alphabétique.

note: Tag: title
en: PostGIS Geometry / Geography / Raster Dump Functions
fr: Fonctions PostGIS de dump Geometry / Geography / Raster

note: Tag: para
en: The functions given below are PostGIS functions that take as input or return as output a set of or single <link linkend="geometry_dump">geometry_dump</link> or <link linkend="geomval">geomval</link> data type object.
fr: Les fonctions ci-dessous sont des fonctions PostGIS qui prennent en entrée ou renvoient en sortie un ensemble ou un seul objet de type <link linkend="geometry_dump">geometry_dump</link> ou <link linkend="geomval">geomval</link>.

note: Tag: title
en: PostGIS Box Functions
fr: Fonctions Box de PostGIS

note: Tag: para
en: The functions given below are PostGIS functions that take as input or return as output the box* family of PostGIS spatial types. The box family of types consists of <link linkend="box2d_type">box2d</link>, and <link linkend="box3d_type">box3d</link>
fr: Les fonctions ci-dessous sont des fonctions PostGIS qui prennent en entrée ou renvoient en sortie la famille box* des types spatiaux PostGIS. La famille de types box comprend <link linkend="box2d_type">box2d</link>, et <link linkend="box3d_type">box3d</link>

note: Tag: title
en: PostGIS Functions that support 3D
fr: Fonctions PostGIS supportant la 3D

note: Tag: para
en: The functions given below are PostGIS functions that do not throw away the Z-Index.
fr: Les fonctions ci-dessous sont des fonctions PostGIS qui n'éliminent pas l'indice Z.

note: Tag: title
en: PostGIS Curved Geometry Support Functions
fr: Fonctions d'aide aux géométries courbes de PostGIS

note: Tag: para
en: The functions given below are PostGIS functions that can use CIRCULARSTRING, CURVEPOLYGON, and other curved geometry types
fr: Les fonctions ci-dessous sont des fonctions PostGIS qui peuvent utiliser CIRCULARSTRING, CURVEPOLYGON et d'autres types de géométrie courbe

note: Tag: title
en: PostGIS Polyhedral Surface Support Functions
fr: Fonctions de support des surfaces polyédriques de PostGIS

note: Tag: para
en: The functions given below are PostGIS functions that can use POLYHEDRALSURFACE, POLYHEDRALSURFACEM geometries
fr: Les fonctions ci-dessous sont des fonctions PostGIS qui peuvent utiliser les géométries POLYHEDRALSURFACE, POLYHEDRALSURFACEM

note: Tag: title
en: PostGIS Function Support Matrix
fr: Matrice d'aide aux fonctions de PostGIS

note: Tag: para
en: Below is an alphabetical listing of spatial specific functions in PostGIS and the kinds of spatial types they work with or OGC/SQL compliance they try to conform to.
fr: Vous trouverez ci-dessous une liste alphabétique des fonctions spatiales spécifiques de PostGIS et des types de données spatiales qu'elles utilisent ou de la conformité OGC/SQL à laquelle elles tentent de se conformer.

note: Tag: simpara
en: A <inlinemediaobject><imageobject><imagedata fileref="images/matrix_checkmark.png"/></imageobject></inlinemediaobject> means the function works with the type or subtype natively.
fr: Un <inlinemediaobject><imageobject><imagedata fileref="images/matrix_checkmark.png"/></imageobject></inlinemediaobject> signifie que la fonction fonctionne nativement avec le type ou le sous-type.

note: Tag: simpara
en: A <inlinemediaobject><imageobject><imagedata fileref="images/matrix_transform.png"/></imageobject></inlinemediaobject> means it works but with a transform cast built-in using cast to geometry, transform to a "best srid" spatial ref and then cast back. Results may not be as expected for large areas or areas at poles and may accumulate floating point junk.
fr: Un <inlinemediaobject><imageobject><imagedata fileref="images/matrix_transform.png"/></imageobject></inlinemediaobject> signifie qu'il fonctionne mais avec une transformation intégrée utilisant la géométrie, la transformation vers une référence spatiale "meilleur srid", puis la transformation à nouveau. Les résultats peuvent ne pas être conformes aux attentes pour les grandes zones ou les zones aux pôles et peuvent accumuler des erreurs en virgule flottante.

note: Tag: simpara
en: A <inlinemediaobject><imageobject><imagedata fileref="images/matrix_autocast.png"/></imageobject></inlinemediaobject> means the function works with the type because of a auto-cast to another such as to box3d rather than direct type support.
fr: Un <inlinemediaobject><imageobject><imagedata fileref="images/matrix_autocast.png"/></imageobject></inlinemediaobject> signifie que la fonction fonctionne avec le type en raison d'un transfert automatique vers un autre type, tel que box3d, plutôt que d'une prise en charge directe du type.

note: Tag: simpara
en: A <inlinemediaobject><imageobject><imagedata fileref="images/matrix_sfcgal_required.png"/></imageobject></inlinemediaobject> means the function only available if PostGIS compiled with SFCGAL support.
fr: Un <inlinemediaobject><imageobject><imagedata fileref="images/matrix_sfcgal_required.png"/></imageobject></inlinemediaobject> signifie que la fonction n'est disponible que si PostGIS a été compilé avec le support SFCGAL.

note: Tag: simpara
en: geom - Basic 2D geometry support (x,y).
fr: geom - Support géométrique 2D de base (x,y).

note: Tag: simpara
en: geog - Basic 2D geography support (x,y).
fr: geog - Support géographique de base en 2D (x,y).

note: Tag: simpara
en: 2.5D - basic 2D geometries in 3 D/4D space (has Z or M coord).
fr: 2.5D - géométries de base en 2D dans un espace 3 D/4D (avec coordonnée Z ou M).

note: Tag: simpara
en: PS - Polyhedral surfaces
fr: PS - Surfaces polyédriques

note: Tag: simpara
en: T - Triangles and Triangulated Irregular Network surfaces (TIN)
fr: T - Triangles et surfaces irrégulières triangulées (TIN)

note: Tag: entry
en: Function
fr: Fonction

note: Tag: entry
en: Curves
fr: Courbes

note: Tag: title
en: New, Enhanced or changed PostGIS Functions
fr: Fonctions PostGIS nouvelles, améliorées ou modifiées

note: Tag: title
en: PostGIS Reference
fr: Référence PostGIS

note: Tag: para
en: The functions given below are the ones which a user of PostGIS is likely to need. There are other functions which are required support functions to the PostGIS objects which are not of use to a general user.
fr: Les fonctions suivantes sont celles dont un utilisateur normal de PostGIS peut avoir besoin. Il existe d'autres fonctions nécessaires au fonctionnement de PostGIS. Elles ne sont normalement pas destinées à un utilisateur standard.

note: Tag: para
en: PostGIS has begun a transition from the existing naming convention to an SQL-MM-centric convention. As a result, most of the functions that you know and love have been renamed using the standard spatial type (ST) prefix. Previous functions are still available, though are not listed in this document where updated functions are equivalent. The non ST_ functions not listed in this documentation are deprecated and will be removed in a future release so STOP USING THEM.
fr: PostGIS a entamé une phase de transition concernant le nom des fonctions pour les faire correspondre à la norme SQL-MM. La plupart des fonctions ont été renommées en utilisant le préfixe des types spatiaux (ST, pour Spatial Type). Les anciennes fonctions, toujours disponibles, ne sont pas listées ci-après si leur équivalent est disponible. Les fonctions non préfixées par ST, qui ne sont pas listées dans cette documentation, sont dépréciées et seront supprimées des prochaines version de PostGIS. IL NE FAUT PLUS LES UTILISER.

note: Tag: title
en: Geometry Accessors
fr: Fonctions d'accès aux géométries

note: Tag: refpurpose
en: Returns the type of a geometry as text.
fr: Renvoie le type d'une géométrie sous forme de texte.

note: Tag: para
en: Returns the type of the geometry as a string. Eg: 'LINESTRING', 'POLYGON', 'MULTIPOINT', etc.
fr: Retourne le type de la géométrie, par exemple : 'LINESTRING', 'POLYGON', 'MULTIPOINT', etc.

note: Tag: para
en: OGC SPEC s2.1.1.1 - Returns the name of the instantiable subtype of Geometry of which this Geometry instance is a member. The name of the instantiable subtype of Geometry is returned as a string.
fr: OGC SPEC s2.1.1.1 - Retourne le nom du sous type instanciable de la géométrie. Le nom est retourné sous forme de texte.

note: Tag: para
en: This function also indicates if the geometry is measured, by returning a string of the form 'POINTM'.
fr: Cette fonction indique si la géométrie comporte une dimension de type mesure, en retournant un texte de la forme 'POINTM'.

note: Tag: para
en: Enhanced: 2.0.0 support for Polyhedral surfaces, Triangles and TIN was introduced.
fr: Amélioration : 2.0.0 introduction du support TIN, Triangles et surfaces polyédriques.

note: Tag: refpurpose
en: Returns the boundary of a geometry.
fr: Renvoie la limite d'une géométrie.

note: Tag: para
en: Returns the closure of the combinatorial boundary of this Geometry. The combinatorial boundary is defined as described in section 3.12.3.2 of the OGC SPEC. Because the result of this function is a closure, and hence topologically closed, the resulting boundary can be represented using representational geometry primitives as discussed in the OGC SPEC, section 3.12.2.
fr: Renvoie l'ensemble formant la frontière finie de cette géométrie. La notion de frontière est définie dans la section 3.12.3.2 des spécifications OGC. Le résultat de cette fonction est un ensemble topologiquement fermé, représentable avec les types de base, comme décrit dans la section 3.12.2 des spécifications OGC.

note: Tag: para
en: Performed by the GEOS module
fr: Effectué par le module GEOS

note: Tag: para
en: Prior to 2.0.0, this function throws an exception if used with <varname>GEOMETRYCOLLECTION</varname>. From 2.0.0 up it will return NULL instead (unsupported input).
fr: Avant la version 2.0.0, cette fonction renvoie une exception si une <varname>GEOMETRYCOLLECTION</varname> est passée en paramètre. A partir de la 2.0.0, la fonction renvoie null (paramètre non supporté).

note: Tag: para
en: Enhanced: 2.1.0 support for Triangle was introduced
fr: Amélioration : 2.1.0 introduction du support pour Triangle

note: Tag: para
en: Changed: 3.2.0 support for TIN, does not use geos, does not linearize curves
fr: Modifié : 3.2.0 support pour TIN, n'utilise pas geos, ne linéarise pas les courbes

note: Tag: para
en: Linestring with boundary points overlaid
fr: Ligne avec les points de démarcation superposés

note: Tag: para
en: polygon holes with boundary multilinestring
fr: trous de polygone avec une multi-lignes en limite

note: Tag: refpurpose
en: Returns the diagonal of a geometry's bounding box.
fr: Retourne la diagonale de la boîte englobante pour la géométrie en argument.

note: Tag: para
en: Returns the diagonal of the supplied geometry's bounding box as a LineString. The diagonal is a 2-point LineString with the minimum values of each dimension in its start point and the maximum values in its end point. If the input geometry is empty, the diagonal line is a LINESTRING EMPTY.
fr: Renvoie la diagonale de la boîte de délimitation de la géométrie fournie sous la forme d'une LineString. La diagonale est une LineString à 2 points avec les valeurs minimales de chaque dimension dans son point de départ et les valeurs maximales dans son point d'arrivée. Si la géométrie d'entrée est vide, la diagonale est une LINESTRING EMPTY.

note: Tag: para
en: The optional <varname>fits</varname> parameter specifies if the best fit is needed. If false, the diagonal of a somewhat larger bounding box can be accepted (which is faster to compute for geometries with many vertices). In either case, the bounding box of the returned diagonal line always covers the input geometry.
fr: Le paramètre facultatif <varname>fits</varname> spécifie si le meilleur ajustement est nécessaire. S'il est faux, la diagonale d'une boîte de délimitation un peu plus grande peut être acceptée (ce qui est plus rapide à calculer pour les géométries comportant de nombreux sommets). Dans les deux cas, la boîte de délimitation de la ligne diagonale renvoyée couvre toujours la géométrie d'entrée.

note: Tag: para
en: The returned geometry retains the SRID and dimensionality (Z and M presence) of the input geometry.
fr: La géométrie renvoyée conserve le SRID et la dimensionnalité (présence Z et M) de la géométrie en entrée.

note: Tag: para
en: In degenerate cases (i.e. a single vertex in input) the returned linestring will be formally invalid (no interior). The result is still topologically valid.
fr: Dans les cas dégénérés (c'est-à-dire un seul sommet dans l'entrée), la ligne retournée sera formellement invalide (pas d'intérieur). Le résultat est toujours topologiquement valide.

note: Tag: refpurpose
en: Return the coordinate dimension of a geometry.
fr: Renvoie la dimension des coordonnées d'une géométrie.

note: Tag: para
en: Return the coordinate dimension of the ST_Geometry value.
fr: Retourne la dimension des coordonnées d'une valeur ST_Geometry.

note: Tag: para
en: This is the MM compliant alias name for <xref linkend="ST_NDims"/>
fr: Alias SQL/MM pour la fonction <xref linkend="ST_NDims"/>

note: Tag: para
en: &sqlmm_compliant; SQL-MM 3: 5.1.3
fr: &sqlmm_compliant; SQL-MM 3 : 5.1.3

note: Tag: refpurpose
en: Returns the topological dimension of a geometry.
fr: Renvoie la dimension topologique d'une géométrie.

note: Tag: para
en: Return the topological dimension of this Geometry object, which must be less than or equal to the coordinate dimension. OGC SPEC s2.1.1.1 - returns 0 for <varname>POINT</varname>, 1 for <varname>LINESTRING</varname>, 2 for <varname>POLYGON</varname>, and the largest dimension of the components of a <varname>GEOMETRYCOLLECTION</varname>. If the dimension is unknown (e.g. for an empty <varname>GEOMETRYCOLLECTION</varname>) 0 is returned.
fr: Renvoie la dimension topologique de cet objet Geometry, qui doit être inférieure ou égale à la dimension des coordonnées. OGC SPEC s2.1.1.1 - renvoie 0 pour <varname>POINT</varname>, 1 pour <varname>LINESTRING</varname>, 2 pour <varname>POLYGON</varname>, et la plus grande dimension des composants d'une <varname>GEOMETRYCOLLECTION</varname>. Si la dimension est inconnue (par exemple, pour une <varname>GEOMETRYCOLLECTION</varname> vide), 0 est renvoyé.

note: Tag: para
en: &sqlmm_compliant; SQL-MM 3: 5.1.2
fr: &sqlmm_compliant; SQL-MM 3 : 5.1.2

note: Tag: para
en: Enhanced: 2.0.0 support for Polyhedral surfaces and TINs was introduced. No longer throws an exception if given empty geometry.
fr: Amélioration : 2.0.0 introduction du support TIN et surfaces polyédriques. Ne renvoie plus une exception si une GEOMETRY EMPTY est passée.

note: Tag: para
en: Prior to 2.0.0, this function throws an exception if used with empty geometry.
fr: Avant la version 2.0.0, cette fonction lève une exception si elle est utilisée avec une géométrie vide.

note: Tag: refpurpose
en: Returns a set of <varname>geometry_dump</varname> rows for the components of a geometry.
fr: Renvoie un ensemble de lignes <varname>geometry_dump</varname> pour les composants d'une géométrie.

note: Tag: para
en: A set-returning function (SRF) that extracts the components of a geometry. It returns a set of <xref linkend="geometry_dump"/> rows, each containing a geometry (<parameter>geom</parameter> field) and an array of integers (<parameter>path</parameter> field).
fr: Une fonction de retour d'ensemble (SRF) qui extrait les composants d'une géométrie. Elle renvoie un ensemble de <xref linkend="geometry_dump"/> lignes, chacune contenant une géométrie (champ <parameter>geom</parameter>) et un tableau d'entiers (champ <parameter>path</parameter>).

note: Tag: para
en: For an atomic geometry type (POINT,LINESTRING,POLYGON) a single record is returned with an empty <parameter>path</parameter> array and the input geometry as <parameter>geom</parameter>. For a collection or multi-geometry a record is returned for each of the collection components, and the <parameter>path</parameter> denotes the position of the component inside the collection.
fr: Pour un type de géométrie atomique (POINT, LINESTRING, POLYGONE), un seul enregistrement est renvoyé avec un tableau <parameter>path</parameter> vide et la géométrie en entrée en tant que <parameter>geom</parameter>. Pour une collection ou une géométrie multiple, un enregistrement est renvoyé pour chacun des composants de la collection, et le <parameter>path</parameter> indique la position du composant à l'intérieur de la collection.

note: Tag: para
en: ST_Dump is useful for expanding geometries. It is the inverse of a <xref linkend="ST_Collect"/> / GROUP BY, in that it creates new rows. For example it can be use to expand MULTIPOLYGONS into POLYGONS.
fr: ST_Dump est utile pour développer les géométries. C'est l'inverse d'un <xref linkend="ST_Collect"/> / GROUP BY, en ce sens qu'il crée de nouvelles lignes. Par exemple, il peut être utilisé pour développer les MULTIPOLYGONES en POLYGONES.

note: Tag: para
en: Availability: PostGIS 1.0.0RC1. Requires PostgreSQL 7.3 or higher.
fr: Disponibilité : PostGIS 1.0.0RC1. Nécessite PostgreSQL 7.3 ou plus.

note: Tag: para
en: Prior to 1.3.4, this function crashes if used with geometries that contain CURVES. This is fixed in 1.3.4+
fr: Avant la version 1.3.4, cette fonction se bloquait si elle était utilisée avec des géométries contenant des CURVES. Ce problème est corrigé dans la version 1.3.4+

note: Tag: title
en: Standard Examples
fr: Exemples standard

note: Tag: title
en: Polyhedral Surfaces, TIN and Triangle Examples
fr: Exemples TIN, Triangle et Surfaces Polyédriques

note: Tag: refpurpose
en: Returns a set of <varname>geometry_dump</varname> rows for the coordinates in a geometry.
fr: Renvoie un ensemble de lignes <varname>geometry_dump</varname> pour les coordonnées dans une géométrie.

note: Tag: para
en: A set-returning function (SRF) that extracts the coordinates (vertices) of a geometry. It returns a set of <xref linkend="geometry_dump"/> rows, each containing a geometry (<parameter>geom</parameter> field) and an array of integers (<parameter>path</parameter> field).
fr: Une fonction de retour d'ensemble (SRF) qui extrait les coordonnées (sommets) d'une géométrie. Elle renvoie un ensemble de <xref linkend="geometry_dump"/> lignes, chacune contenant une géométrie (champ <parameter>geom</parameter>) et un tableau d'entiers (champ <parameter>path</parameter>).

note: Tag: para
en: the <parameter>geom</parameter> field <varname>POINT</varname>s represent the coordinates of the supplied geometry.
fr: le champ <parameter>geom</parameter> <varname>POINT</varname> représente les coordonnées de la géométrie fournie.

note: Tag: para
en: the <parameter>path</parameter> field (an <varname>integer[]</varname>) is an index enumerating the coordinate positions in the elements of the supplied geometry. The indices are 1-based. For example, for a <varname>LINESTRING</varname> the paths are <varname>{i}</varname> where <varname>i</varname> is the <varname>nth</varname> coordinate in the <varname>LINESTRING</varname>. For a <varname>POLYGON</varname> the paths are <varname>{i,j}</varname> where <varname>i</varname> is the ring number (1 is outer; inner rings follow) and <varname>j</varname> is the coordinate position in the ring.
fr: le champ <parameter>path</parameter> (un <varname>integer[]</varname>) est un index énumérant les positions des coordonnées dans les éléments de la géométrie fournie. Les indices sont basés sur 1. Par exemple, pour un <varname>LINESTRING</varname>, les chemins sont <varname>{i}</varname> où <varname>i</varname> est la <varname>nième</varname> coordonnée dans le <varname>LINESTRING</varname>. Pour un <varname>POLYGONE</varname>, les chemins sont <varname>{i,j}</varname> où <varname>i</varname> est le numéro de l'anneau (1 est l'anneau extérieur ; les anneaux intérieurs suivent) et <varname>j</varname> est la position de la coordonnée dans l'anneau.

note: Tag: para
en: To obtain a single geometry containing the coordinates use <xref linkend="ST_Points"/>.
fr: Pour obtenir une géométrie unique contenant les coordonnées, utilisez <xref linkend="ST_Points"/>.

note: Tag: para
en: Enhanced: 2.1.0 Faster speed. Reimplemented as native-C.
fr: Amélioré : 2.1.0 Vitesse plus rapide. Réimplémentation en C natif.

note: Tag: title
en: Classic Explode a Table of LineStrings into nodes
fr: Classique Éclater un tableau de lignes en nœuds

note: Tag: title
en: Standard Geometry Examples
fr: Exemples de géométrie standard

note: Tag: refpurpose
en: Returns a set of <varname>geometry_dump</varname> rows for the segments in a geometry.
fr: Renvoie un ensemble de lignes <varname>geometry_dump</varname> pour les segments d'une géométrie.

note: Tag: para
en: A set-returning function (SRF) that extracts the segments of a geometry. It returns a set of <xref linkend="geometry_dump"/> rows, each containing a geometry (<parameter>geom</parameter> field) and an array of integers (<parameter>path</parameter> field).
fr: Une fonction de retour d'ensemble (SRF) qui extrait les segments d'une géométrie. Elle renvoie un ensemble de <xref linkend="geometry_dump"/> lignes, chacune contenant une géométrie (champ <parameter>geom</parameter>) et un tableau d'entiers (champ <parameter>path</parameter>).

note: Tag: para
en: the <parameter>geom</parameter> field <varname>LINESTRING</varname>s represent the linear segments of the supplied geometry, while the <varname>CIRCULARSTRING</varname>s represent the arc segments.
fr: le champ <parameter>geom</parameter> <varname> LINESTRING</varname>s représente les segments linéaires de la géométrie fournie, tandis que <varname>CIRCULARSTRING</varname>s représente les segments d'arc.

note: Tag: para
en: the <parameter>path</parameter> field (an <varname>integer[]</varname>) is an index enumerating the segment start point positions in the elements of the supplied geometry. The indices are 1-based. For example, for a <varname>LINESTRING</varname> the paths are <varname>{i}</varname> where <varname>i</varname> is the <varname>nth</varname> segment start point in the <varname>LINESTRING</varname>. For a <varname>POLYGON</varname> the paths are <varname>{i,j}</varname> where <varname>i</varname> is the ring number (1 is outer; inner rings follow) and <varname>j</varname> is the segment start point position in the ring.
fr: le champ <parameter>path</parameter> (un <varname>integer[]</varname>) est un index énumérant les positions des points de départ des segments dans les éléments de la géométrie fournie. Les indices sont basés sur 1. Par exemple, pour un <varname>LINESTRING</varname>, les chemins sont <varname>{i}</varname> où <varname>i</varname> est le <varname>nième</varname> point de départ du segment dans le <varname>LINESTRING</varname>. Pour un <varname>POLYGONE</varname>, les chemins sont <varname>{i,j}</varname> où <varname>i</varname> est le numéro de l'anneau (1 est l'anneau extérieur ; les anneaux intérieurs suivent) et <varname>j</varname> est la position du point de départ du segment dans l'anneau.

note: Tag: title
en: TIN and Triangle Examples
fr: Exemples de TIN et de triangles

note: Tag: refpurpose
en: Returns a set of <varname>geometry_dump</varname> rows for the exterior and interior rings of a Polygon.
fr: Renvoie un ensemble de lignes <varname>geometry_dump</varname> pour les anneaux extérieurs et intérieurs d'un polygone.

note: Tag: para
en: A set-returning function (SRF) that extracts the rings of a polygon. It returns a set of <xref linkend="geometry_dump"/> rows, each containing a geometry (<parameter>geom</parameter> field) and an array of integers (<parameter>path</parameter> field).
fr: Une fonction de retour d'ensemble (SRF) qui extrait les anneaux d'un polygone. Elle renvoie un ensemble de <xref linkend="geometry_dump"/> lignes, chacune contenant une géométrie (champ <parameter>geom</parameter>) et un tableau d'entiers (champ <parameter>path</parameter>).

note: Tag: para
en: The <parameter>geom</parameter> field contains each ring as a POLYGON. The <parameter>path</parameter> field is an integer array of length 1 containing the polygon ring index. The exterior ring (shell) has index 0. The interior rings (holes) have indices of 1 and higher.
fr: Le champ <parameter>geom</parameter> contient chaque anneau sous forme de POLYGONE. Le champ <parameter>path</parameter> est un tableau d'entiers de longueur 1 contenant l'indice de l'anneau du polygone. L'anneau extérieur (coquille) a l'indice 0. Les anneaux intérieurs (trous) ont des indices de 1 et plus.

note: Tag: para
en: This only works for POLYGON geometries. It does not work for MULTIPOLYGONS
fr: Cela ne fonctionne que pour les géométries POLYGON. Il ne fonctionne pas pour les MULTIPOLYGONS

note: Tag: para
en: Availability: PostGIS 1.1.3. Requires PostgreSQL 7.3 or higher.
fr: Disponibilité : PostGIS 1.1.3. Nécessite PostgreSQL 7.3 ou plus.

note: Tag: para
en: General form of query.
fr: Forme générale de la requête.

note: Tag: para
en: A polygon with a single hole.
fr: Un polygone avec un seul trou.

note: Tag: refpurpose
en: Returns the last point of a LineString or CircularLineString.
fr: Renvoie le dernier point d'une LineString ou CircularLineString.

note: Tag: para
en: Returns the last point of a <varname>LINESTRING</varname> or <varname>CIRCULARLINESTRING</varname> geometry as a <varname>POINT</varname>. Returns <varname>NULL</varname> if the input is not a <varname>LINESTRING</varname> or <varname>CIRCULARLINESTRING</varname>.
fr: Renvoie le dernier point d'une géométrie <varname>LINESTRING</varname> ou <varname>CIRCULARLINESTRING</varname> comme un <varname>POINT</varname>. Renvoie <varname>NULL</varname> si l'entrée n'est pas une <varname>LINESTRING</varname> ou <varname>CIRCULARLINESTRING</varname>.

note: Tag: para
en: &sqlmm_compliant; SQL-MM 3: 7.1.4
fr: &sqlmm_compliant; SQL-MM 3 : 7.1.4

note: Tag: para
en: Changed: 2.0.0 no longer works with single geometry MultiLineStrings. In older versions of PostGIS a single-line MultiLineString would work with this function and return the end point. In 2.0.0 it returns NULL like any other MultiLineString. The old behavior was an undocumented feature, but people who assumed they had their data stored as LINESTRING may experience these returning NULL in 2.0.0.
fr: Modifié : 2.0.0 ne fonctionne plus avec les MultiLineStrings à géométrie unique. Dans les anciennes versions de PostGIS, une MultiLineString à géométrie unique fonctionnait avec cette fonction et renvoyait le point final. Dans la version 2.0.0, elle renvoie NULL comme toute autre MultiLineString. L'ancien comportement était une fonctionnalité non documentée, mais les personnes qui supposaient que leurs données étaient stockées en tant que LINESTRING peuvent voir ces dernières retourner NULL dans la version 2.0.0.

note: Tag: para
en: End point of a LineString
fr: Point final d'une ligne

note: Tag: para
en: End point of a non-LineString is NULL
fr: Le point final d'une ligne qui n'en est pas une est NULL

note: Tag: para
en: End point of a 3D LineString
fr: Point final d'une ligne 3D

note: Tag: para
en: End point of a CircularString
fr: Point d'arrivée d'une CircularString

note: Tag: refpurpose
en: Returns a geometry representing the bounding box of a geometry.
fr: Renvoie une géométrie représentant la boîte de délimitation d'une géométrie.

note: Tag: para
en: Returns the double-precision (float8) minimum bounding box for the supplied geometry, as a geometry. The polygon is defined by the corner points of the bounding box ((<varname>MINX</varname>, <varname>MINY</varname>), (<varname>MINX</varname>, <varname>MAXY</varname>), (<varname>MAXX</varname>, <varname>MAXY</varname>), (<varname>MAXX</varname>, <varname>MINY</varname>), (<varname>MINX</varname>, <varname>MINY</varname>)). (PostGIS will add a <varname>ZMIN</varname>/<varname>ZMAX</varname> coordinate as well).
fr: Renvoie la boîte de délimitation minimale en double précision (float8) pour la géométrie fournie, en tant que géométrie. Le polygone est défini par les points d'angle de la boîte de délimitation ((<varname>MINX</varname>, <varname>MINY</varname>), (<varname>MINX</varname>, <varname>MAXY</varname>), (<varname>MAXX</varname>, <varname>MAXY</varname>), (<varname>MAXX</varname>, <varname>MINY</varname>), (<varname>MINX</varname>, <varname>MINY</varname>)). (PostGIS ajoutera également une coordonnée <varname>ZMIN</varname>/<varname>ZMAX</varname>).

note: Tag: para
en: Degenerate cases (vertical lines, points) will return a geometry of lower dimension than <varname>POLYGON</varname>, ie. <varname>POINT</varname> or <varname>LINESTRING</varname>.
fr: D'autres cas (lignes verticales, points) retourneront une géométrie de dimension inférieure à <varname>POLYGON</varname>, c'est-à-dire <varname>POINT</varname> ou <varname>LINESTRING</varname>.

note: Tag: para
en: Availability: 1.5.0 behavior changed to output double precision instead of float4
fr: Disponibilité : 1.5.0 changement pour renvoyer un type double précision à la place de float4

note: Tag: para
en: &sqlmm_compliant; SQL-MM 3: 5.1.19
fr: &sqlmm_compliant; SQL-MM 3 : 5.1.19

note: Tag: para
en: Envelope of a point and linestring.
fr: Enveloppe d'un point et d'une ligne.

note: Tag: refpurpose
en: Returns a LineString representing the exterior ring of a Polygon.
fr: Renvoie une ligne représentant l'anneau extérieur d'un polygone.

note: Tag: para
en: Returns a LINESTRING representing the exterior ring (shell) of a POLYGON. Returns NULL if the geometry is not a polygon.
fr: Renvoie une LINESTRING représentant l'anneau extérieur (coquille) d'un POLYGONE. Renvoie NULL si la géométrie n'est pas un polygone.

note: Tag: para
en: This function does not support MULTIPOLYGONs. For MULTIPOLYGONs use in conjunction with <xref linkend="ST_GeometryN"/> or <xref linkend="ST_Dump"/>
fr: Cette fonction ne prend pas en charge les MULTIPOLYGONES. Pour les MULTIPOLYGONs, utilisez conjointement avec <xref linkend="ST_GeometryN"/> ou <xref linkend="ST_Dump"/>

note: Tag: para
en: &sqlmm_compliant; SQL-MM 3: 8.2.3, 8.3.3
fr: &sqlmm_compliant; SQL-MM 3 : 8.2.3, 8.3.3

note: Tag: refpurpose
en: Return an element of a geometry collection.
fr: Renvoie un élément d'une collection de géométries.

note: Tag: para
en: Return the 1-based Nth element geometry of an input geometry which is a GEOMETRYCOLLECTION, MULTIPOINT, MULTILINESTRING, MULTICURVE, MULTI)POLYGON, or POLYHEDRALSURFACE. Otherwise, returns NULL.
fr: Renvoie la géométrie du Nième élément basé sur 1 d'une géométrie d'entrée qui est une GEOMETRYCOLLECTION, MULTIPOINT, MULTILINESTRING, MULTICURVE, MULTI)POLYGON ou POLYHEDRALSURFACE. Sinon, renvoie NULL.

note: Tag: para
en: Index is 1-based as for OGC specs since version 0.8.0. Previous versions implemented this as 0-based instead.
fr: L'index commence à 1 pour respecter les spécificarions OGC depuis la version 0.8.0. Dans les versions antérieures, l'index commençait à 0.

note: Tag: para
en: To extract all elements of a geometry, <xref linkend="ST_Dump"/> is more efficient and works for atomic geometries.
fr: Pour extraire tous les éléments d'une géométrie, <xref linkend="ST_Dump"/> est plus efficace et fonctionne pour les géométries atomiques.

note: Tag: para
en: Changed: 2.0.0 Prior versions would return NULL for singular geometries. This was changed to return the geometry for ST_GeometryN(..,1) case.
fr: Changement : 2.0.0. Les versions antérieures renvoient NULL pour les géometries simples (un seul objet). Renvoie désormais la géométrie pour le cas ST_GeometryN(..,1).

note: Tag: para
en: &sqlmm_compliant; SQL-MM 3: 9.1.5
fr: &sqlmm_compliant; SQL-MM 3 : 9.1.5

note: Tag: refpurpose
en: Returns the SQL-MM type of a geometry as text.
fr: Renvoie le type SQL-MM d'une géométrie sous forme de texte.

note: Tag: para
en: Returns the type of the geometry as a string. EG: 'ST_LineString', 'ST_Polygon','ST_MultiPolygon' etc. This function differs from GeometryType(geometry) in the case of the string and ST in front that is returned, as well as the fact that it will not indicate whether the geometry is measured.
fr: Renvoie le type de la géométrie sous forme de texte, par exemple : 'ST_LineString', 'ST_Polygon','ST_MultiPolygon' etc. Cette fonction diffère de GeometryType(geometry) par la casse du texte renvoyé et par le préfixe ST_ en début de texte. N'indique pas si la géométrie comporte une dimension MESURE.

note: Tag: para
en: Enhanced: 2.0.0 support for Polyhedral surfaces was introduced.
fr: Amélioration : 2.0.0 introduction du support des surfaces polyédriques.

note: Tag: para
en: &sqlmm_compliant; SQL-MM 3: 5.1.4
fr: &sqlmm_compliant; SQL-MM 3 : 5.1.4

note: Tag: refpurpose
en: Tests if a geometry contains a circular arc
fr: Teste si une géométrie contient un arc de cercle

note: Tag: para
en: Returns true if a geometry or geometry collection contains a circular string
fr: Renvoie true si une géométrie ou une collection de géométries contient une circular string

note: Tag: para
en: Availability: 1.2.3?
fr: Disponibilité : 1.2.3 ?

note: Tag: refpurpose
en: Returns the Nth interior ring (hole) of a Polygon.
fr: Renvoie le Nième anneau intérieur (trou) d'un polygone.

note: Tag: para
en: Returns the Nth interior ring (hole) of a POLYGON geometry as a LINESTRING. The index starts at 1. Returns NULL if the geometry is not a polygon or the index is out of range.
fr: Renvoie le Nième anneau intérieur (trou) d'une géométrie POLYGONE sous forme de LINESTRING. L'indice commence à 1. Renvoie NULL si la géométrie n'est pas un polygone ou si l'indice est hors de la plage.

note: Tag: para
en: &sqlmm_compliant; SQL-MM 3: 8.2.6, 8.3.5
fr: &sqlmm_compliant; SQL-MM 3 : 8.2.6, 8.3.5

note: Tag: refpurpose
en: Return the number of component curves in a CompoundCurve.
fr: Renvoie le nombre de courbes composantes d'une CompoundCurve.

note: Tag: para
en: Return the number of component curves in a CompoundCurve, zero for an empty CompoundCurve, or NULL for a non-CompoundCurve input.
fr: Renvoie le nombre de courbes composantes d'une CompoundCurve, zéro pour une CompoundCurve vide, ou NULL pour une entrée qui n'est pas une CompoundCurve.

note: Tag: refpurpose
en: Returns the Nth component curve geometry of a CompoundCurve.
fr: Renvoie la Nième courbe composante d'une CompoundCurve.

note: Tag: para
en: Returns the Nth component curve geometry of a CompoundCurve. The index starts at 1. Returns NULL if the geometry is not a CompoundCurve or the index is out of range.
fr: Renvoie la Nièmecourbe composante d'une CompoundCurve. L'index commence à 1. Renvoie NULL si la géométrie n'est pas une CompoundCurve ou si l'index est hors de la plage.

note: Tag: refpurpose
en: Tests if a LineStrings's start and end points are coincident. For a PolyhedralSurface tests if it is closed (volumetric).
fr: Teste si les points de départ et d'arrivée d'une LineString coïncident. Pour une PolyhedralSurface, teste si elle est fermée (volumétrique).

note: Tag: para
en: Returns <varname>TRUE</varname> if the <varname>LINESTRING</varname>'s start and end points are coincident. For Polyhedral Surfaces, reports if the surface is areal (open) or volumetric (closed).
fr: Renvoie <varname>TRUE</varname> si les premier et dernier points de la <varname>LINESTRING</varname> sont identiques. Pour les surface polyhédriques, indique si la surface est surfacique (ouverte) ou volumétrique (fermée).

note: Tag: para
en: &sqlmm_compliant; SQL-MM 3: 7.1.5, 9.3.3
fr: &sqlmm_compliant; SQL-MM 3 : 7.1.5, 9.3.3

note: Tag: para
en: SQL-MM defines the result of <code>ST_IsClosed(NULL)</code> to be 0, while PostGIS returns <varname>NULL</varname>.
fr: SQL-MM définit le résultat de <code>ST_IsClosed(NULL)</code> comme étant 0, alors que PostGIS renvoie <varname>NULL</varname>.

note: Tag: title
en: Line String and Point Examples
fr: Exemples de lignes et de points

note: Tag: title
en: Polyhedral Surface Examples
fr: Exemples : surfaces polyédriques

note: Tag: refpurpose
en: Tests if a geometry is a geometry collection type.
fr: Teste si une géométrie est un type de collection de géométrie.

note: Tag: para
en: Returns <varname>TRUE</varname> if the geometry type of the argument a geometry collection type. Collection types are the following:
fr: Renvoie <varname>TRUE</varname> si le type de géométrie de l'argument est un type de collection de géométrie. Les types de collection sont les suivants :

note: Tag: para
en: This function analyzes the type of the geometry. This means that it will return <varname>TRUE</varname> on collections that are empty or that contain a single element.
fr: Cette fonction analyse le type de la géométrie. Renvoie <varname>TRUE</varname> pour les collections vides ou ne contenant qu'un seul élément.

note: Tag: refpurpose
en: Tests if a geometry is empty.
fr: Teste si une géométrie est vide.

note: Tag: para
en: Returns true if this Geometry is an empty geometry. If true, then this Geometry represents an empty geometry collection, polygon, point etc.
fr: Renvoie true si cette géométrie est une géométrie vide. Si vrai, alors cette géométrie représente une collection de géométrie vide, un polygone, un point, etc.

note: Tag: para
en: SQL-MM defines the result of ST_IsEmpty(NULL) to be 0, while PostGIS returns NULL.
fr: La norme SQL-MM stipule que ST_IsEmpty(NULL) doit renvoyer 0. PostGIS renvoie NULL.

note: Tag: para
en: &sqlmm_compliant; SQL-MM 3: 5.1.7
fr: &sqlmm_compliant; SQL-MM 3 : 5.1.7

note: Tag: para
en: Changed: 2.0.0 In prior versions of PostGIS ST_GeomFromText('GEOMETRYCOLLECTION(EMPTY)') was allowed. This is now illegal in PostGIS 2.0.0 to better conform with SQL/MM standards
fr: Modifié : 2.0.0 Dans les versions précédentes de PostGIS, ST_GeomFromText('GEOMETRYCOLLECTION(EMPTY)') était autorisé. Ceci est maintenant illégal dans PostGIS 2.0.0 pour mieux se conformer aux normes SQL/MM

note: Tag: refpurpose
en: Tests if Polygons have exterior rings oriented counter-clockwise and interior rings oriented clockwise.
fr: Teste si les polygones ont des anneaux extérieurs orientés dans le sens inverse des aiguilles d'une montre et des anneaux intérieurs orientés dans le sens des aiguilles d'une montre.

note: Tag: para
en: Returns true if all polygonal components of the input geometry use a counter-clockwise orientation for their exterior ring, and a clockwise direction for all interior rings.
fr: Renvoie un résultat positif si tous les composants polygonaux de la géométrie en entrée utilisent une orientation anti-horaire pour leur anneau extérieur et une orientation horaire pour tous les anneaux intérieurs.

note: Tag: para
en: Returns true if the geometry has no polygonal components.
fr: Retourne vrai si la géométrie n'a pas de composants polygonaux.

note: Tag: para
en: Closed linestrings are not considered polygonal components, so you would still get a true return by passing a single closed linestring no matter its orientation.
fr: Les lignes fermées ne sont pas considérées comme des composants polygonaux, de sorte que vous obtiendrez toujours un retour vrai en passant une seule ligne fermée, quelle que soit son orientation.

note: Tag: para
en: If a polygonal geometry does not use reversed orientation for interior rings (i.e., if one or more interior rings are oriented in the same direction as an exterior ring) then both ST_IsPolygonCW and ST_IsPolygonCCW will return false.
fr: Si une géométrie polygonale n'utilise pas l'orientation inversée pour les anneaux intérieurs (c'est-à-dire si un ou plusieurs anneaux intérieurs sont orientés dans la même direction qu'un anneau extérieur), ST_IsPolygonCW et ST_IsPolygonCCW renvoient tous deux la valeur false.

note: Tag: para
en: Availability: 2.4.0
fr: Disponibilité : 2.4.0

note: Tag: refpurpose
en: Tests if Polygons have exterior rings oriented clockwise and interior rings oriented counter-clockwise.
fr: Teste si les polygones ont des anneaux extérieurs orientés dans le sens des aiguilles d'une montre et des anneaux intérieurs orientés dans le sens inverse des aiguilles d'une montre.

note: Tag: para
en: Returns true if all polygonal components of the input geometry use a clockwise orientation for their exterior ring, and a counter-clockwise direction for all interior rings.
fr: Renvoie un résultat positif si tous les composants polygonaux de la géométrie d'entrée utilisent une orientation dans le sens des aiguilles d'une montre pour leur anneau extérieur, et dans le sens inverse des aiguilles d'une montre pour tous les anneaux intérieurs.

note: Tag: refpurpose
en: Tests if a LineString is closed and simple.
fr: Teste si une ligne est fermée et simple.

note: Tag: para
en: Returns <varname>TRUE</varname> if this <varname>LINESTRING</varname> is both <xref linkend="ST_IsClosed"/> (<code>ST_StartPoint(g) ~= ST_Endpoint(g)</code>) and <xref linkend="ST_IsSimple"/> (does not self intersect).
fr: Renvoie <varname>TRUE</varname> si cette <varname>LINESTRING</varname> est à la fois <xref linkend="ST_IsClosed"/> (<code>ST_StartPoint(g) ~= ST_Endpoint(g)</code>) et <xref linkend="ST_IsSimple"/> (ne s'intersecte pas).

note: Tag: para
en: &sqlmm_compliant; SQL-MM 3: 7.1.6
fr: &sqlmm_compliant; SQL-MM 3 : 7.1.6

note: Tag: para
en: SQL-MM defines the result of <code>ST_IsRing(NULL)</code> to be 0, while PostGIS returns <varname>NULL</varname>.
fr: SQL-MM définit le résultat de <code>ST_IsRing(NULL)</code> comme étant 0, alors que PostGIS renvoie <varname>NULL</varname>.

note: Tag: refpurpose
en: Tests if a geometry has no points of self-intersection or self-tangency.
fr: Teste si une géométrie n'a pas de points d'auto-intersection ou d'auto-tangente.

note: Tag: para
en: Returns true if this Geometry has no anomalous geometric points, such as self-intersection or self-tangency. For more information on the OGC's definition of geometry simplicity and validity, refer to <link linkend="OGC_Validity">"Ensuring OpenGIS compliance of geometries"</link>
fr: Renvoie TRUE si cette géométrie ne présente pas d'anomalie comme une auto intersection ou des segments tangentiels. Pour plus d'information sur les notions OGC de simplicité et de validité, se référer à <link linkend="OGC_Validity">"Ensuring OpenGIS compliance of geometries"</link>

note: Tag: para
en: SQL-MM defines the result of ST_IsSimple(NULL) to be 0, while PostGIS returns NULL.
fr: La norme SQL-MM indique que le résultat de la fonction ST_IsSimple(NULL) doit être 0 ; PostGIS renvoie NULL.

note: Tag: para
en: &sqlmm_compliant; SQL-MM 3: 5.1.8
fr: &sqlmm_compliant; SQL-MM 3 : 5.1.8

note: Tag: refpurpose
en: Returns the M coordinate of a Point.
fr: Renvoie la coordonnée M d'un point.

note: Tag: para
en: Return the M coordinate of a Point, or NULL if not available. Input must be a Point.
fr: Retourne les coordonnées M d'un point, ou NULL si non disponible. L'entrée doit être un point.

note: Tag: para
en: This is not (yet) part of the OGC spec, but is listed here to complete the point coordinate extractor function list.
fr: Cette fonction ne fait pas (encore) partie de la spécification de l'OGC, mais elle est mentionnée ici pour compléter la liste des fonctions de l'extracteur de coordonnées de points.

note: Tag: refpurpose
en: Returns the amount of memory space a geometry takes.
fr: Renvoie la quantité d'espace mémoire que prend une géométrie.

note: Tag: para
en: Returns the amount of memory space (in bytes) the geometry takes.
fr: Renvoie la quantité d'espace mémoire (en octets) que prend la géométrie.

note: Tag: para
en: This complements the PostgreSQL built-in <link xlink:href="https://www.postgresql.org/docs/current/functions-admin.html#FUNCTIONS-ADMIN-DBOBJECT">database object functions</link> pg_column_size, pg_size_pretty, pg_relation_size, pg_total_relation_size.
fr: Ceci complète les fonctions intégrées de PostgreSQL <link xlink:href="https://www.postgresql.org/docs/current/functions-admin.html#FUNCTIONS-ADMIN-DBOBJECT">fonctions d'objet de base de données</link> pg_column_size, pg_size_pretty, pg_relation_size, pg_total_relation_size.

note: Tag: para
en: pg_relation_size which gives the byte size of a table may return byte size lower than ST_MemSize. This is because pg_relation_size does not add toasted table contribution and large geometries are stored in TOAST tables.
fr: pg_relation_size qui donne la taille en octets d'une table peut renvoyer une taille en octets inférieure à ST_MemSize. Cela est dû au fait que pg_relation_size n'ajoute pas la contribution des tables toasted et que les grandes géométries sont stockées dans les tables TOAST.

note: Tag: para
en: pg_total_relation_size - includes, the table, the toasted tables, and the indexes.
fr: pg_total_relation_size - comprend la table, les tables toasted et les index.

note: Tag: para
en: pg_column_size returns how much space a geometry would take in a column considering compression, so may be lower than ST_MemSize
fr: pg_column_size indique l'espace que prendrait une géométrie dans une colonne en tenant compte de la compression, et peut donc être inférieur à ST_MemSize

note: Tag: para
en: Changed: 2.2.0 name changed to ST_MemSize to follow naming convention.
fr: Modifié : 2.2.0 nom modifié en ST_MemSize pour respecter la convention de nommage.

note: Tag: refpurpose
en: Returns the coordinate dimension of a geometry.
fr: Renvoie la dimension des coordonnées d'une géométrie.

note: Tag: para
en: Returns the coordinate dimension of the geometry. PostGIS supports 2 - (x,y) , 3 - (x,y,z) or 2D with measure - x,y,m, and 4 - 3D with measure space x,y,z,m
fr: Renvoie la dimension des coordonnées de la géométrie. PostGIS supporte 2 - (x,y) , 3 - (x,y,z) ou 2D avec mesure - x,y,m, et 4 - 3D avec espace de mesure x,y,z,m

note: Tag: refpurpose
en: Returns the number of points (vertices) in a geometry.
fr: Retourne le nombre de points (vertex) d'un objet géométrique.

note: Tag: para
en: Return the number of points in a geometry. Works for all geometries.
fr: Retourne le nombre de points d'un objet géométrique. Cela fonctionne pour tous les types de géométrie.

note: Tag: refpurpose
en: Returns the number of rings in a polygonal geometry.
fr: Renvoie le nombre d'anneaux dans une géométrie polygonale.

note: Tag: para
en: If the geometry is a polygon or multi-polygon returns the number of rings. Unlike NumInteriorRings, it counts the outer rings as well.
fr: Si la géométrie est un polygone ou un multi-polygone, renvoie le nombre d'anneaux. Contrairement à NumInteriorRings, il compte également les anneaux extérieurs.

note: Tag: refpurpose
en: Returns the number of elements in a geometry collection.
fr: Renvoie le nombre d'éléments dans une collection de géométrie.

note: Tag: para
en: Returns the number of elements in a geometry collection (GEOMETRYCOLLECTION or MULTI*). For non-empty atomic geometries returns 1. For empty geometries returns 0.
fr: Renvoie le nombre d'éléments d'une collection de géométries (GEOMETRYCOLLECTION ou MULTI*). Pour les géométries atomiques non vides, le résultat est 1. Pour les géométries vides, le résultat est 0.

note: Tag: para
en: Changed: 2.0.0 In prior versions this would return NULL if the geometry was not a collection/MULTI type. 2.0.0+ now returns 1 for single geometries e.g POLYGON, LINESTRING, POINT.
fr: Modifié : 2.0.0 Dans les versions précédentes, cette fonction renvoyait NULL si la géométrie n'était pas de type collection/MULTI. 2.0.0+ renvoie maintenant 1 pour les géométries simples, par exemple POLYGONE, LINESTRING, POINT.

note: Tag: para
en: &sqlmm_compliant; SQL-MM 3: 9.1.4
fr: &sqlmm_compliant; SQL-MM 3 : 9.1.4

note: Tag: refpurpose
en: Returns the number of interior rings (holes) of a Polygon.
fr: Renvoie le nombre d'anneaux intérieurs (trous) d'un polygone.

note: Tag: para
en: Return the number of interior rings of a polygon geometry. Return NULL if the geometry is not a polygon.
fr: Renvoie le nombre d'anneaux intérieurs d'une géométrie polygonale. Retourne NULL si la géométrie n'est pas un polygone.

note: Tag: para
en: &sqlmm_compliant; SQL-MM 3: 8.2.5
fr: &sqlmm_compliant; SQL-MM 3 : 8.2.5

note: Tag: para
en: Changed: 2.0.0 - in prior versions it would allow passing a MULTIPOLYGON, returning the number of interior rings of first POLYGON.
fr: Modifié : 2.0.0 - dans les versions antérieures, il permettait de passer un MULTIPOLYGONE, renvoyant le nombre d'anneaux intérieurs du premier POLYGONE.

note: Tag: refpurpose
en: Returns the number of interior rings (holes) of a Polygon. Aias for ST_NumInteriorRings
fr: Renvoie le nombre d'anneaux intérieurs (trous) d'un polygone. Alias pour ST_NumInteriorRings

note: Tag: refpurpose
en: Return the number of faces on a Polyhedral Surface. Will return null for non-polyhedral geometries.
fr: Renvoie le nombre de faces d'une surface polyédrique. Retourne null pour les géométries non polyédriques.

note: Tag: para
en: Return the number of faces on a Polyhedral Surface. Will return null for non-polyhedral geometries. This is an alias for ST_NumGeometries to support MM naming. Faster to use ST_NumGeometries if you don't care about MM convention.
fr: Renvoie le nombre de faces d'une surface polyédrique. Retourne null pour les géométries non polyédriques. C'est un alias de ST_NumGeometries pour supporter le nommage MM. Il est plus rapide d'utiliser ST_NumGeometries si vous ne vous souciez pas de la convention MM.

note: Tag: para
en: &sqlmm_compliant; SQL-MM ISO/IEC 13249-3: 8.5
fr: &sqlmm_compliant; SQL-MM ISO/IEC 13249-3 : 8.5

note: Tag: refpurpose
en: Returns the number of points in a LineString or CircularString.
fr: Renvoie le nombre de points dans une LineString ou une CircularString.

note: Tag: para
en: Return the number of points in an ST_LineString or ST_CircularString value. Prior to 1.4 only works with linestrings as the specs state. From 1.4 forward this is an alias for ST_NPoints which returns number of vertices for not just linestrings. Consider using ST_NPoints instead which is multi-purpose and works with many geometry types.
fr: Retourne le nombre de points dans une ST_LineString ou ST_CircularString. Avant la version 1.4, cette fonction ne fonctionnait qu'avec les lignes, comme l'indiquent les spécifications. A partir de la version 1.4, il s'agit d'un alias de ST_NPoints qui renvoie le nombre de sommets, et pas seulement pour les lignes. Envisagez d'utiliser ST_NPoints à la place, qui est polyvalent et fonctionne avec de nombreux types de géométrie.

note: Tag: para
en: &sqlmm_compliant; SQL-MM 3: 7.2.4
fr: &sqlmm_compliant; SQL-MM 3 : 7.2.4

note: Tag: refpurpose
en: Returns the Nth geometry (face) of a PolyhedralSurface.
fr: Renvoie la Nième géométrie (face) d'une PolyhedralSurface.

note: Tag: para
en: Returns the 1-based Nth geometry (face) if the geometry is a POLYHEDRALSURFACE or POLYHEDRALSURFACEM. Otherwise, returns NULL. This returns the same answer as ST_GeometryN for PolyhedralSurfaces. Using ST_GeometryN is faster.
fr: Renvoie la Nième géométrie (face) basée sur 1 si la géométrie est une POLYHEDRALSURFACE ou une POLYHEDRALSURFACEM. Sinon, elle renvoie NULL. Cette fonction renvoie la même réponse que ST_GeometryN pour PolyhedralSurfaces. L'utilisation de ST_GeometryN est plus rapide.

note: Tag: para
en: Index is 1-based.
fr: L'indice est basé sur 1.

note: Tag: para
en: If you want to extract all elements of a geometry <xref linkend="ST_Dump"/> is more efficient.
fr: Si vous voulez extraire tous les éléments d'une géométrie, <xref linkend="ST_Dump"/> est plus efficace.

note: Tag: refpurpose
en: Returns the Nth point in the first LineString or circular LineString in a geometry.
fr: Renvoie le Nième point de la première LineString ou LineString circulaire d'une géométrie.

note: Tag: para
en: Return the Nth point in a single linestring or circular linestring in the geometry. Negative values are counted backwards from the end of the LineString, so that -1 is the last point. Returns NULL if there is no linestring in the geometry.
fr: Renvoie le Nième point d'une ligne ou d'une ligne circulaire dans la géométrie. Les valeurs négatives sont comptées à rebours à partir de la fin de la LineString, de sorte que -1 est le dernier point. Renvoie NULL s'il n'y a pas de ligne dans la géométrie.

note: Tag: para
en: Index is 1-based as for OGC specs since version 0.8.0. Backward indexing (negative index) is not in OGC Previous versions implemented this as 0-based instead.
fr: L'index est basé sur 1 comme pour les spécifications de l'OGC depuis la version 0.8.0. L'indexation à rebours (index négatif) n'est pas prévue dans les spécifications de l'OGC. Les versions précédentes l'ont implémentée en la basant sur 0.

note: Tag: para
en: If you want to get the Nth point of each LineString in a MultiLineString, use in conjunction with ST_Dump
fr: Si vous souhaitez obtenir le Nième point de chaque ligne dans une multiligne, utilisez ST_Dump en conjonction avec ST_Dump

note: Tag: para
en: &sqlmm_compliant; SQL-MM 3: 7.2.5, 7.3.5
fr: &sqlmm_compliant; SQL-MM 3 : 7.2.5, 7.3.5

note: Tag: para
en: Changed: 2.0.0 no longer works with single geometry multilinestrings. In older versions of PostGIS -- a single line multilinestring would work happily with this function and return the start point. In 2.0.0 it just returns NULL like any other multilinestring.
fr: Modifié : la version 2.0.0 ne fonctionne plus avec les multi-lignes à géométrie unique. Dans les anciennes versions de PostGIS, une multi-ligne d'une seule ligne fonctionnait parfaitement avec cette fonction et renvoyait le point de départ. Dans la version 2.0.0, elle renvoie simplement NULL comme n'importe quelle autre multi-ligne.

note: Tag: para
en: Changed: 2.3.0 : negative indexing available (-1 is last point)
fr: Modifié : 2.3.0 : indexation négative disponible (-1 est le dernier point)

note: Tag: refpurpose
en: Returns a MultiPoint containing the coordinates of a geometry.
fr: Renvoie un MultiPoint contenant les coordonnées d'une géométrie.

note: Tag: para
en: Returns a MultiPoint containing all the coordinates of a geometry. Duplicate points are preserved, including the start and end points of ring geometries. (If desired, duplicate points can be removed by calling <xref linkend="ST_RemoveRepeatedPoints"/> on the result).
fr: Renvoie un MultiPoint contenant toutes les coordonnées d'une géométrie. Les points en double sont conservés, y compris les points de départ et d'arrivée des géométries en anneau. (Si vous le souhaitez, les points en double peuvent être supprimés en appelant <xref linkend="ST_RemoveRepeatedPoints"/> sur le résultat).

note: Tag: para
en: To obtain information about the position of each coordinate in the parent geometry use <xref linkend="ST_DumpPoints"/>.
fr: Pour obtenir des informations sur la position de chaque coordonnée dans la géométrie parente, utilisez <xref linkend="ST_DumpPoints"/>.

note: Tag: para
en: M and Z coordinates are preserved if present.
fr: Les coordonnées M et Z sont conservées si elles sont présentes.

note: Tag: refpurpose
en: Returns the first point of a LineString.
fr: Renvoie le premier point d'une LineString.

note: Tag: para
en: Returns the first point of a <varname>LINESTRING</varname> or <varname>CIRCULARLINESTRING</varname> geometry as a <varname>POINT</varname>. Returns <varname>NULL</varname> if the input is not a <varname>LINESTRING</varname> or <varname>CIRCULARLINESTRING</varname>.
fr: Renvoie le premier point d'une géométrie <varname>LINESTRING</varname> ou <varname>CIRCULARLINESTRING</varname> comme un <varname>POINT</varname>. Renvoie <varname>NULL</varname> si l'entrée n'est pas une <varname>LINESTRING</varname> ou <varname>CIRCULARLINESTRING</varname>.

note: Tag: para
en: &sqlmm_compliant; SQL-MM 3: 7.1.3
fr: &sqlmm_compliant; SQL-MM 3 : 7.1.3

note: Tag: para
en: Enhanced: 3.2.0 returns a point for all geometries. Prior behavior returns NULLs if input was not a LineString.
fr: Amélioré : 3.2.0 renvoie un point pour toutes les géométries. Le comportement précédent renvoyait NULL si l'entrée n'était pas une LineString.

note: Tag: para
en: Changed: 2.0.0 no longer works with single geometry MultiLineStrings. In older versions of PostGIS a single-line MultiLineString would work happily with this function and return the start point. In 2.0.0 it just returns NULL like any other MultiLineString. The old behavior was an undocumented feature, but people who assumed they had their data stored as LINESTRING may experience these returning NULL in 2.0.0.
fr: Modifié : 2.0.0 ne fonctionne plus avec les MultiLineStrings à géométrie unique. Dans les anciennes versions de PostGIS, une MultiLineString à géométrie unique fonctionnait sans problème avec cette fonction et renvoyait le point de départ. Dans la version 2.0.0, elle renvoie simplement NULL comme toute autre MultiLineString. L'ancien comportement était une fonctionnalité non documentée, mais les personnes qui supposaient que leurs données étaient stockées en tant que LINESTRING peuvent voir ces données retourner NULL dans la version 2.0.0.

note: Tag: para
en: Start point of a LineString
fr: Point de départ d'une LineString

note: Tag: para
en: Start point of a non-LineString is NULL
fr: Le point de départ d'une géométrie qui n'est pas une LineString est NULL

note: Tag: para
en: Start point of a 3D LineString
fr: Point de départ d'une LineString 3D

note: Tag: para
en: Start point of a CircularString
fr: Point de départ d'une CircularString

note: Tag: refpurpose
en: Returns a text summary of the contents of a geometry.
fr: Renvoie un résumé textuel du contenu d'une géométrie.

note: Tag: para
en: Returns a text summary of the contents of the geometry.
fr: Renvoie un résumé textuel du contenu de la géométrie.

note: Tag: para
en: Flags shown square brackets after the geometry type have the following meaning:
fr: Les indicateurs indiqués entre crochets après le type de géométrie ont la signification suivante :

note: Tag: para
en: M: has M coordinate
fr: M : possède une coordonnée M

note: Tag: para
en: Z: has Z coordinate
fr: Z : possède une coordonnée Z

note: Tag: para
en: B: has a cached bounding box
fr: B : possède une bounding box en cache

note: Tag: para
en: G: is geodetic (geography)
fr: G : est géodésique (geography)

note: Tag: para
en: S: has spatial reference system
fr: S : possède un système de référence spatiale

note: Tag: para
en: Availability: 1.2.2
fr: Disponibilité : 1.2.2

note: Tag: para
en: Enhanced: 2.0.0 added support for geography
fr: Amélioré : la version 2.0.0 a ajouté la prise en charge du type geography

note: Tag: para
en: Enhanced: 2.1.0 S flag to denote if has a known spatial reference system
fr: Amélioré : 2.1.0 Indicateur S pour indiquer si le système de référence spatiale est connu

note: Tag: para
en: Enhanced: 2.2.0 Added support for TIN and Curves
fr: Amélioré : 2.2.0 Ajout de la prise en charge des TIN et des courbes

note: Tag: refpurpose
en: Returns the X coordinate of a Point.
fr: Renvoie la coordonnée X d'un point.

note: Tag: para
en: Return the X coordinate of the point, or NULL if not available. Input must be a point.
fr: Renvoie la coordonnée X du point, ou NULL si elle n'est pas disponible. L'entrée doit être un point.

note: Tag: para
en: To get the minimum and maximum X value of geometry coordinates use the functions <xref linkend="ST_XMin"/> and <xref linkend="ST_XMax"/>.
fr: Pour obtenir les valeurs X minimale et maximale des coordonnées géométriques, utilisez les fonctions <xref linkend="ST_XMin"/> et <xref linkend="ST_XMax"/>.

note: Tag: para
en: &sqlmm_compliant; SQL-MM 3: 6.1.3
fr: &sqlmm_compliant; SQL-MM 3 : 6.1.3

note: Tag: refpurpose
en: Returns the Y coordinate of a Point.
fr: Renvoie la coordonnée Y d'un point.

note: Tag: para
en: Return the Y coordinate of the point, or NULL if not available. Input must be a point.
fr: Renvoie la coordonnée Y du point, ou NULL si elle n'est pas disponible. L'entrée doit être un point.

note: Tag: para
en: To get the minimum and maximum Y value of geometry coordinates use the functions <xref linkend="ST_YMin"/> and <xref linkend="ST_YMax"/>.
fr: Pour obtenir les valeurs minimale et maximale en Y des coordonnées géométriques, utilisez les fonctions <xref linkend="ST_YMin"/> et <xref linkend="ST_YMax"/>.

note: Tag: para
en: &sqlmm_compliant; SQL-MM 3: 6.1.4
fr: &sqlmm_compliant; SQL-MM 3 : 6.1.4

note: Tag: refpurpose
en: Returns the Z coordinate of a Point.
fr: Renvoie la coordonnée Z d'un point.

note: Tag: para
en: Return the Z coordinate of the point, or NULL if not available. Input must be a point.
fr: Renvoie la coordonnée Z du point, ou NULL si elle n'est pas disponible. L'entrée doit être un point.

note: Tag: para
en: To get the minimum and maximum Z value of geometry coordinates use the functions <xref linkend="ST_ZMin"/> and <xref linkend="ST_ZMax"/>.
fr: Pour obtenir les valeurs minimale et maximale de Z des coordonnées géométriques, utilisez les fonctions <xref linkend="ST_ZMin"/> et <xref linkend="ST_ZMax"/>.

note: Tag: refpurpose
en: <refpurpose>Returns a code indicating the ZM coordinate dimension of a geometry.</refpurpose>
fr: <refpurpose>Retourne un code indiquant la dimension des coordonnées ZM d'une géométrie.</refpurpose>

note: Tag: para
en: <para>Returns a code indicating the ZM coordinate dimension of a geometry.</para>
fr: <para>Retourne un code indiquant la dimension des coordonnées ZM d'une géométrie.</para>

note: Tag: para
en: Values are: 0 = 2D, 1 = 3D-M, 2 = 3D-Z, 3 = 4D.
fr: Les valeurs sont les suivantes : 0 = 2D, 1 = 3D-M, 2 = 3D-Z, 3 = 4D.

note: Tag: refpurpose
en: Checks if a geometry has a Z dimension.
fr: Vérifie si une géométrie possède une dimension Z.

note: Tag: para
en: Checks if the input geometry has a Z dimension and returns a boolean value. If the geometry has a Z dimension, it returns true; otherwise, it returns false.
fr: Vérifie si la géométrie d'entrée a une dimension Z et renvoie une valeur booléenne. Si la géométrie a une dimension Z, le résultat est vrai ; sinon, il est faux.

note: Tag: para
en: Geometry objects with a Z dimension typically represent three-dimensional (3D) geometries, while those without it are two-dimensional (2D) geometries.
fr: Les objets géométriques dotés d'une dimension Z représentent généralement des géométries tridimensionnelles (3D), tandis que ceux qui en sont dépourvus sont des géométries bidimensionnelles (2D).

note: Tag: para
en: This function is useful for determining if a geometry has elevation or height information.
fr: Cette fonction est utile pour déterminer si une géométrie contient des informations sur l'altitude ou la hauteur.

note: Tag: refpurpose
en: Checks if a geometry has an M (measure) dimension.
fr: Vérifie si une géométrie a une dimension M (mesure).

note: Tag: para
en: Checks if the input geometry has an M (measure) dimension and returns a boolean value. If the geometry has an M dimension, it returns true; otherwise, it returns false.
fr: Vérifie si la géométrie d'entrée a une dimension M (mesure) et renvoie une valeur booléenne. Si la géométrie a une dimension M, il renvoie vrai ; sinon, il renvoie faux.

note: Tag: para
en: Geometry objects with an M dimension typically represent measurements or additional data associated with spatial features.
fr: Les objets géométriques de dimension M représentent généralement des mesures ou des données supplémentaires associées à des entités spatiales.

note: Tag: para
en: This function is useful for determining if a geometry includes measure information.
fr: Cette fonction est utile pour déterminer si une géométrie contient des informations de mesure.

note: Tag: title
en: Bounding Box Functions
fr: Fonctions des boîtes de délimitation

note: Tag: para
en: These functions produce or operate on bounding boxes. They can also provide and accept geometry values, by using automatic or explicit casts.
fr: Ces fonctions produisent ou utilisent des boîtes de délimitation. Elles peuvent également fournir et accepter des valeurs géométriques, en utilisant des transformations automatiques ou explicites.

note: Tag: para
en: See also <xref linkend="PostGIS_BoxFunctions"/>.
fr: Voir aussi <xref linkend="PostGIS_BoxFunctions"/>.

note: Tag: refpurpose
en: Returns a BOX2D representing the 2D extent of a geometry.
fr: Renvoie une BOX2D représentant l'étendue 2D d'une géométrie.

note: Tag: para
en: Returns a <xref linkend="box2d_type"/> representing the 2D extent of the geometry.
fr: Renvoie une <xref linkend="box2d_type"/> représentant l'étendue 2D de la géométrie.

note: Tag: refpurpose
en: Returns a BOX3D representing the 3D extent of a geometry.
fr: Renvoie une BOX3D représentant l'étendue 3D d'une géométrie.

note: Tag: para
en: Returns a <xref linkend="box3d_type"/> representing the 3D extent of the geometry.
fr: Renvoie une <xref linkend="box3d_type"/> représentant l'étendue 3D de la géométrie.

note: Tag: refpurpose
en: Returns the estimated extent of a spatial table.
fr: Renvoie l'étendue estimée d'une table spatiale.

note: Tag: para
en: Returns the estimated extent of a spatial table as a <xref linkend="box2d_type"/>. The current schema is used if not specified. The estimated extent is taken from the geometry column's statistics. This is usually much faster than computing the exact extent of the table using <xref linkend="ST_Extent"/> or <xref linkend="ST_3DExtent"/>.
fr: Renvoie l'étendue estimée d'une table spatiale sous la forme d'une <xref linkend="box2d_type"/>. Le schéma actuel est utilisé s'il n'est pas spécifié. L'étendue estimée est tirée des statistiques de la colonne géométrique. Cette méthode est généralement plus rapide que le calcul de l'étendue exacte de la table à l'aide de <xref linkend="ST_Extent"/> ou <xref linkend="ST_3DExtent"/>.

note: Tag: para
en: The default behavior is to also use statistics collected from child tables (tables with INHERITS) if available. If <varname>parent_only</varname> is set to TRUE, only statistics for the given table are used and child tables are ignored.
fr: Le comportement par défaut est d'utiliser également les statistiques collectées à partir des tables enfants (tables avec INHERITS) si elles sont disponibles. Si <varname>parent_only</varname> est défini à VRAI, seules les statistiques de la table donnée sont utilisées et les tables enfants sont ignorées.

note: Tag: para
en: For PostgreSQL &gt;= 8.0.0 statistics are gathered by VACUUM ANALYZE and the result extent will be about 95% of the actual one. For PostgreSQL &lt; 8.0.0 statistics are gathered by running <code>update_geometry_stats()</code> and the result extent is exact.
fr: Pour PostgreSQL &gt;= 8.0.0 les statistiques sont collectées par VACUUM ANALYZE et l'étendue du résultat sera d'environ 95% de l'étendue réelle. Pour PostgreSQL &lt; 8.0.0 les statistiques sont collectées en exécutant <code>update_geometry_stats()</code> et l'étendue du résultat sera exacte.

note: Tag: para
en: In the absence of statistics (empty table or no ANALYZE called) this function returns NULL. Prior to version 1.5.4 an exception was thrown instead.
fr: En l'absence de statistiques (table vide ou pas d'ANALYZE), cette fonction renvoie NULL. Avant la version 1.5.4, une exception était levée.

note: Tag: para
en: Changed: 2.1.0. Up to 2.0.x this was called ST_Estimated_Extent.
fr: Modifié : 2.1.0. Jusqu'à la version 2.0.x, cette fonction était appelée ST_Estimated_Extent.

note: Tag: refpurpose
en: Returns a bounding box expanded from another bounding box or a geometry.
fr: Renvoie une boîte de délimitation développée à partir d'une autre boîte de délimitation ou d'une géométrie.

note: Tag: para
en: Returns a bounding box expanded from the bounding box of the input, either by specifying a single distance with which the box should be expanded on both axes, or by specifying an expansion distance for each axis. Uses double-precision. Can be used for distance queries, or to add a bounding box filter to a query to take advantage of a spatial index.
fr: Renvoie une boîte de délimitation développée à partir de la boîte de délimitation de l'entrée, soit en spécifiant une distance unique avec laquelle la boîte doit être développée sur les deux axes, soit en spécifiant une distance de développement pour chaque axe. Utilise la double précision. Peut être utilisé pour les requêtes de distance, ou pour ajouter un filtre de boîte de délimitation à une requête afin de tirer parti d'un index spatial.

note: Tag: para
en: In addition to the version of ST_Expand accepting and returning a geometry, variants are provided that accept and return <xref linkend="box2d_type"/> and <xref linkend="box3d_type"/> data types.
fr: Outre la version de ST_Expand acceptant et renvoyant une géométrie, des variantes sont fournies qui acceptent et renvoient des types de données <xref linkend="box2d_type"/> et <xref linkend="box3d_type"/>.

note: Tag: para
en: Distances are in the units of the spatial reference system of the input.
fr: Les distances sont exprimées dans les unités du système de référence spatiale de l'entrée.

note: Tag: para
en: ST_Expand is similar to <xref linkend="ST_Buffer"/>, except while buffering expands a geometry in all directions, ST_Expand expands the bounding box along each axis.
fr: ST_Expand est similaire à <xref linkend="ST_Buffer"/>, mais alors que la mise en mémoire tampon étend une géométrie dans toutes les directions, ST_Expand étend la boîte de délimitation le long de chaque axe.

note: Tag: para
en: Pre version 1.3, ST_Expand was used in conjunction with <xref linkend="ST_Distance"/> to do indexable distance queries. For example, <code>geom &amp;&amp; ST_Expand('POINT(10 20)', 10) AND ST_Distance(geom, 'POINT(10 20)') &lt; 10</code>. This has been replaced by the simpler and more efficient <xref linkend="ST_DWithin"/> function.
fr: Avant la version 1.3, ST_Expand était utilisé en conjonction avec <xref linkend="ST_Distance"/> pour effectuer des requêtes de distance indexables. Par exemple, <code>geom &amp;&amp; ST_Expand('POINT(10 20)', 10) AND ST_Distance(geom, 'POINT(10 20)') &lt; 10</code>. Cette fonction a été remplacée par la fonction <xref linkend="ST_DWithin"/>, plus simple et plus efficace.

note: Tag: para
en: Availability: 1.5.0 behavior changed to output double precision instead of float4 coordinates.
fr: Disponibilité : 1.5.0 comportement modifié pour afficher les coordonnées en double précision au lieu des coordonnées float4.

note: Tag: para
en: Enhanced: 2.3.0 support was added to expand a box by different amounts in different dimensions.
fr: Amélioration : 2.3.0 : prise en charge de l'expansion d'une boîte par différentes quantités dans différentes dimensions.

note: Tag: para
en: Examples below use US National Atlas Equal Area (SRID=2163) which is a meter projection
fr: Les exemples ci-dessous utilisent l'Atlas national américain Equal Area (SRID=2163) qui est une projection en mètres

note: Tag: refpurpose
en: Aggregate function that returns the bounding box of geometries.
fr: Fonction agrégée qui renvoie la boîte de délimitation des géométries.

note: Tag: para
en: An aggregate function that returns a <xref linkend="box2d_type"/> bounding box that bounds a set of geometries.
fr: Une fonction agrégée qui renvoie une <xref linkend="box2d_type"/> boîte de délimitation qui délimite un ensemble de géométries.

note: Tag: para
en: The bounding box coordinates are in the spatial reference system of the input geometries.
fr: Les coordonnées de la boîte de délimitation sont dans le système de référence spatiale des géométries d'entrée.

note: Tag: para
en: ST_Extent is similar in concept to Oracle Spatial/Locator's SDO_AGGR_MBR.
fr: Le concept de ST_Extent est similaire à celui de SDO_AGGR_MBR d'Oracle Spatial/Locator.

note: Tag: para
en: ST_Extent returns boxes with only X and Y ordinates even with 3D geometries. To return XYZ ordinates use <xref linkend="ST_3DExtent"/>.
fr: ST_Extent renvoie des boîtes avec seulement les coordonnées X et Y, même avec des géométries 3D. Pour renvoyer les coordonnées XYZ, utilisez <xref linkend="ST_3DExtent"/>.

note: Tag: para
en: The returned <code>box3d</code> value does not include a SRID. Use <xref linkend="ST_SetSRID"/> to convert it into a geometry with SRID metadata. The SRID is the same as the input geometries.
fr: La valeur <code>box3d</code> renvoyée ne contient pas de SRID. Utilisez <xref linkend="ST_SetSRID"/> pour la convertir en une géométrie avec des métadonnées SRID. Le SRID est le même que celui des géométries d'entrée.

note: Tag: para
en: Examples below use Massachusetts State Plane ft (SRID=2249)
fr: Les exemples ci-dessous utilisent le plan de l'État du Massachusetts (SRID=2249)

note: Tag: refpurpose
en: Aggregate function that returns the 3D bounding box of geometries.
fr: Fonction d'agrégation qui renvoie la boîte de délimitation 3D des géométries.

note: Tag: para
en: An aggregate function that returns a <xref linkend="box3d_type"/> (includes Z ordinate) bounding box that bounds a set of geometries.
fr: Une fonction d'agrégation qui renvoie une <xref linkend="box3d_type"/> (y compris l'ordonnée Z) qui délimite un ensemble de géométries.

note: Tag: para
en: Changed: 2.0.0 In prior versions this used to be called ST_Extent3D
fr: Modifié : 2.0.0 Dans les versions précédentes, cette fonction était appelée ST_Extent3D

note: Tag: refpurpose
en: Creates a BOX2D defined by two 2D point geometries.
fr: Crée un BOX2D défini par deux géométries de points 2D.

note: Tag: para
en: Creates a <xref linkend="box2d_type"/> defined by two Point geometries. This is useful for doing range queries.
fr: Crée une <xref linkend="box2d_type"/> définie par deux géométries de points. Ceci est utile pour effectuer des requêtes sur des intervalles.

note: Tag: refpurpose
en: Creates a BOX3D defined by two 3D point geometries.
fr: Crée un BOX3D défini par deux géométries de points 3D.

note: Tag: para
en: Creates a <xref linkend="box3d_type"/> defined by two 3D Point geometries.
fr: Crée une <xref linkend="box3d_type"/> définie par deux géométries de points 3D.

note: Tag: para
en: This function supports 3D and will not drop the z-index.
fr: Cette fonction prend en charge la 3D et ne supprime pas l'indice z.

note: Tag: para
en: Changed: 2.0.0 In prior versions this used to be called ST_MakeBox3D
fr: Modifié : 2.0.0 Dans les versions précédentes, cette fonction s'appelait ST_MakeBox3D

note: Tag: refpurpose
en: <refpurpose>Returns the X maxima of a 2D or 3D bounding box or a geometry.</refpurpose>
fr: <refpurpose>Retourne les maxima X d'une boîte de délimitation 2D ou 3D ou d'une géométrie.</refpurpose>

note: Tag: para
en: <para>Returns the X maxima of a 2D or 3D bounding box or a geometry.</para>
fr: <para>Retourne les maxima X d'une boîte de délimitation 2D ou 3D ou d'une géométrie.</para>

note: Tag: para
en: Although this function is only defined for box3d, it also works for box2d and geometry values due to automatic casting. However, it will not accept a geometry or box2d text representation, since those do not auto-cast.
fr: Bien que cette fonction ne soit définie que pour box3d, elle fonctionne également pour box2d et les valeurs géométriques en raison du moulage automatique. Cependant, elle n'acceptera pas de représentation textuelle de la géométrie ou de la box2d, car ces dernières ne sont pas soumises à la conversion automatique.

note: Tag: refpurpose
en: <refpurpose>Returns the X minima of a 2D or 3D bounding box or a geometry.</refpurpose>
fr: <refpurpose>Retourne les minima X d'une boîte de délimitation 2D ou 3D ou d'une géométrie.</refpurpose>

note: Tag: para
en: <para>Returns the X minima of a 2D or 3D bounding box or a geometry.</para>
fr: <para>Retourne les minima X d'une boîte de délimitation 2D ou 3D ou d'une géométrie.</para>

note: Tag: para
en: Although this function is only defined for box3d, it also works for box2d and geometry values due to automatic casting. However it will not accept a geometry or box2d text representation, since those do not auto-cast.
fr: Bien que cette fonction ne soit définie que pour box3d, elle fonctionne également pour box2d et les valeurs géométriques en raison du moulage automatique. Cependant, elle n'acceptera pas de représentation textuelle de la géométrie ou de la box2d, car celles-ci ne sont pas coulées automatiquement.

note: Tag: refpurpose
en: <refpurpose>Returns the Y maxima of a 2D or 3D bounding box or a geometry.</refpurpose>
fr: <refpurpose>Retourne les maxima Y d'une boîte de délimitation 2D ou 3D ou d'une géométrie.</refpurpose>

note: Tag: para
en: <para>Returns the Y maxima of a 2D or 3D bounding box or a geometry.</para>
fr: <para>Retourne les maxima Y d'une boîte de délimitation 2D ou 3D ou d'une géométrie.</para>

note: Tag: refpurpose
en: <refpurpose>Returns the Y minima of a 2D or 3D bounding box or a geometry.</refpurpose>
fr: <refpurpose>Retourne les minima Y d'une boîte de délimitation 2D ou 3D ou d'une géométrie.</refpurpose>

note: Tag: para
en: <para>Returns the Y minima of a 2D or 3D bounding box or a geometry.</para>
fr: <para>Retourne les minima Y d'une boîte englobante 2D ou 3D ou d'une géométrie.</para>

note: Tag: refpurpose
en: <refpurpose>Returns the Z maxima of a 2D or 3D bounding box or a geometry.</refpurpose>
fr: <refpurpose>Retourne les maxima Z d'une boîte de délimitation 2D ou 3D ou d'une géométrie.</refpurpose>

note: Tag: para
en: <para>Returns the Z maxima of a 2D or 3D bounding box or a geometry.</para>
fr: <para>Retourne les maxima Z d'une boîte de délimitation 2D ou 3D ou d'une géométrie.</para>

note: Tag: refpurpose
en: <refpurpose>Returns the Z minima of a 2D or 3D bounding box or a geometry.</refpurpose>
fr: <refpurpose>Retourne les minima Z d'une boîte de délimitation 2D ou 3D ou d'une géométrie.</refpurpose>

note: Tag: para
en: <para>Returns the Z minima of a 2D or 3D bounding box or a geometry.</para>
fr: <para>Retourne les minima Z d'une boîte de délimitation 2D ou 3D ou d'une géométrie.</para>

note: Tag: title
en: Clustering Functions
fr: Fonctions de clustering

note: Tag: para
en: These functions implement clustering algorithms for sets of geometries.
fr: Ces fonctions mettent en œuvre des algorithmes de regroupement pour des ensembles de géométries.

note: Tag: refpurpose
en: Window function that returns a cluster id for each input geometry using the DBSCAN algorithm.
fr: Fonction Window qui renvoie un identifiant de cluster pour chaque géométrie d'entrée en utilisant l'algorithme DBSCAN.

note: Tag: para
en: A window function that returns a cluster number for each input geometry, using the 2D <link xlink:href="https://en.wikipedia.org/wiki/DBSCAN">Density-based spatial clustering of applications with noise (DBSCAN)</link> algorithm. Unlike <xref linkend="ST_ClusterKMeans"/>, it does not require the number of clusters to be specified, but instead uses the desired <link linkend="ST_Distance">distance</link> (<varname>eps</varname>) and density (<varname>minpoints</varname>) parameters to determine each cluster.
fr: Une fonction window qui renvoie un numéro de cluster pour chaque géométrie d'entrée, en utilisant l'algorithme 2D <link xlink:href="https://en.wikipedia.org/wiki/DBSCAN">Density-based spatial clustering of applications with noise (DBSCAN)</link>. Contrairement à <xref linkend="ST_ClusterKMeans"/>, elle ne nécessite pas la spécification du nombre de clusters, mais utilise les paramètres de <link linkend="ST_Distance">distance</link> (<varname>eps</varname>) et de densité (<varname>minpoints</varname>) pour déterminer chaque cluster.

note: Tag: para
en: An input geometry is added to a cluster if it is either:
fr: Une géométrie d'entrée est ajoutée à un cluster si elle est l'une ou l'autre :

note: Tag: para
en: A "core" geometry, that is within <varname>eps</varname> <link linkend="ST_Distance">distance</link> of at least <varname>minpoints</varname> input geometries (including itself); or
fr: Une géométrie "core", qui se trouve à <varname>eps</varname> <link linkend="ST_Distance">distance</link> d'au moins <varname>minpoints</varname> géométries d'entrée (y compris la sienne) ; ou

note: Tag: para
en: A "border" geometry, that is within <varname>eps</varname> <link linkend="ST_Distance">distance</link> of a core geometry.
fr: Une géométrie "en bordure", qui se trouve dans <varname>eps</varname> <link linkend="ST_Distance">distance</link> d'une géométrie centrale.

note: Tag: para
en: Note that border geometries may be within <varname>eps</varname> distance of core geometries in more than one cluster. Either assignment would be correct, so the border geometry will be arbitrarily asssigned to one of the available clusters. In this situation it is possible for a correct cluster to be generated with fewer than <varname>minpoints</varname> geometries. To ensure deterministic assignment of border geometries (so that repeated calls to ST_ClusterDBSCAN will produce identical results) use an <code>ORDER BY</code> clause in the window definition. Ambiguous cluster assignments may differ from other DBSCAN implementations.
fr: Notez que les géométries situés en bordure peuvent se trouver à <varname>eps</varname> distance des géométries centrales dans plus d'un cluster. L'une ou l'autre assignation serait correcte, de sorte que la géométrie de bordure sera arbitrairement assignée à l'un des clusters disponibles. Dans cette situation, il est possible qu'un cluster correct soit généré avec moins de géométries <varname>minpoints</varname>. Pour garantir une affectation déterministe des géométries de bordure (de sorte que des appels répétés à ST_ClusterDBSCAN produisent des résultats identiques), utilisez une clause <code>ORDER BY</code> dans la définition de la fonction window. Les affectations de clusters ambigus peuvent différer d'autres implémentations DBSCAN.

note: Tag: para
en: Geometries that do not meet the criteria to join any cluster are assigned a cluster number of NULL.
fr: Les géométries qui ne répondent pas aux critères d'appartenance à un cluster se voient attribuer un numéro de cluster NULL.

note: Tag: para
en: Clustering polygon within 50 meters of each other, and requiring at least 2 polygons per cluster.
fr: Regroupement des polygones à moins de 50 mètres les uns des autres, et nécessité d'avoir au moins 2 polygones par cluster.

note: Tag: para
en: Clusters within 50 meters with at least 2 items per cluster. Singletons have NULL for cid
fr: Clusters dans un rayon de 50 mètres avec au moins 2 éléments par cluster. Les singletons ont NULL pour cid

note: Tag: para
en: A example showing combining parcels with the same cluster number into geometry collections.
fr: Un exemple montrant la combinaison de parcelles ayant le même numéro de cluster dans des collections géométriques.

note: Tag: refpurpose
en: Aggregate function that clusters input geometries into connected sets.
fr: Fonction d'agrégation qui regroupe les géométries en entrée en ensembles connectés.

note: Tag: para
en: An aggregate function that returns an array of GeometryCollections partitioning the input geometries into connected clusters that are disjoint. Each geometry in a cluster intersects at least one other geometry in the cluster, and does not intersect any geometry in other clusters.
fr: Une fonction agrégée qui renvoie un tableau de GeometryCollections partitionnant les géométries d'entrée en clusters connectés et disjoints. Chaque géométrie d'un cluster intersecte au moins une autre géométrie du cluster et n'intersecte aucune géométrie d'autre cluster.

note: Tag: refpurpose
en: Window function that returns a cluster id for each input geometry, clustering input geometries into connected sets.
fr: Fonction Window qui renvoie un identifiant de cluster pour chaque géométrie en entrée, en regroupant les géométries en entrée en ensembles connectés.

note: Tag: para
en: A window function that builds connected clusters of geometries that intersect. It is possible to traverse all geometries in a cluster without leaving the cluster. The return value is the cluster number that the geometry argument participates in, or null for null inputs.
fr: Une fonction window qui construit des clusters connectés de géométries qui se croisent. Il est possible de parcourir toutes les géométries d'un cluster sans quitter le cluster. La valeur de retour est le numéro du cluster à laquelle participe l'argument géométrie, ou null pour les entrées nulles.

note: Tag: refpurpose
en: Window function that returns a cluster id for each input geometry using the K-means algorithm.
fr: Fonction Window qui renvoie un identifiant de cluster pour chaque géométrie en entrée en utilisant l'algorithme K-means.

note: Tag: para
en: Returns <link xlink:href="https://en.wikipedia.org/wiki/K-means_clustering">K-means</link> cluster number for each input geometry. The distance used for clustering is the distance between the centroids for 2D geometries, and distance between bounding box centers for 3D geometries. For POINT inputs, M coordinate will be treated as weight of input and has to be larger than 0.
fr: Renvoie le numéro de cluster <link xlink:href="https://en.wikipedia.org/wiki/K-means_clustering">K-means</link> pour chaque géométrie en entrée. La distance utilisée pour le clustering est la distance entre les centroïdes pour les géométries 2D, et la distance entre les centres des boîtes de délimitation pour les géométries 3D. Pour les entrées POINT, la coordonnée M sera traitée comme le poids de l'entrée et doit être supérieure à 0.

note: Tag: para
en: <varname>max_radius</varname>, if set, will cause ST_ClusterKMeans to generate more clusters than <varname>k</varname> ensuring that no cluster in output has radius larger than <varname>max_radius</varname>. This is useful in reachability analysis.
fr: <varname>max_radius</varname>, si elle est définie, fera en sorte que ST_ClusterKMeans génère plus de clusters que <varname>k</varname> en s'assurant qu'aucun cluster en sortie n'a un rayon plus grand que <varname>max_radius</varname>. Ceci est utile dans l'analyse d'accessibilité.

note: Tag: para
en: Enhanced: 3.2.0 Support for <varname>max_radius</varname>
fr: Amélioré : 3.2.0 Support pour <varname>max_radius</varname>

note: Tag: para
en: Enhanced: 3.1.0 Support for 3D geometries and weights
fr: Amélioration : 3.1.0 Prise en charge des géométries et des poids en 3D

note: Tag: para
en: Generate dummy set of parcels for examples:
fr: Générer un ensemble de parcelles fictives pour les exemples :

note: Tag: para
en: Parcels color-coded by cluster number (cid)
fr: Parcelles codées en couleur par numéro de cluster (cid)

note: Tag: para
en: Partitioning parcel clusters by type:
fr: Partitionnement des clusters de parcelles par type :

note: Tag: para
en: Example: Clustering a preaggregated planetary-scale data population dataset using 3D clusering and weighting. Identify at least 20 regions based on <link xlink:href="https://data.humdata.org/dataset/kontur-population-dataset">Kontur Population Data</link> that do not span more than 3000 km from their center:
fr: Exemple : Regroupement d'un ensemble de données de population préagrégées à l'échelle planétaire en utilisant le clusering 3D et la pondération. Identifiez au moins 20 régions basées sur <link xlink:href="https://data.humdata.org/dataset/kontur-population-dataset">Kontur Population Data</link> qui ne s'étendent pas à plus de 3000 km de leur centre :

note: Tag: para
en: World population clustered to above specs produces 46 clusters. Clusters are centered at well-populated regions (New York, Moscow). Greenland is one cluster. There are island clusters that span across the antimeridian. Cluster edges follow Earth's curvature.
fr: La population mondiale regroupée selon les spécifications ci-dessus produit 46 clusters. Les clusters sont centrés sur des régions bien peuplées (New York, Moscou). Le Groenland est un cluster. Il y a des groupes d'îles qui s'étendent sur l'antiméridien. Les bords des clusters suivent la courbure de la Terre.

note: Tag: refpurpose
en: Aggregate function that clusters geometries by separation distance.
fr: Fonction agrégée qui regroupe les géométries en fonction de la distance de séparation.

note: Tag: para
en: An aggregate function that returns an array of GeometryCollections, where each collection is a cluster containing some input geometries. Clustering partitions the input geometries into sets in which each geometry is within the specified <parameter>distance</parameter> of at least one other geometry in the same cluster. Distances are Cartesian distances in the units of the SRID.
fr: Une fonction agrégée qui renvoie un tableau de GeometryCollections, où chaque collection est un cluster contenant certaines géométries d'entrée. Le regroupement partitionne les géométries d'entrée en ensembles dans lesquels chaque géométrie se trouve dans la <parameter>distance</parameter> spécifiée d'au moins une autre géométrie dans le même cluster. Les distances sont des distances cartésiennes dans les unités de l'ISDR.

note: Tag: para
en: ST_ClusterWithin is equivalent to running <xref linkend="ST_ClusterDBSCAN"/> with <code>minpoints =&gt; 0</code>.
fr: ST_ClusterWithin est équivalent à l'exécution de <xref linkend="ST_ClusterDBSCAN"/> avec <code>minpoints =&gt; 0</code>.

note: Tag: refpurpose
en: Window function that returns a cluster id for each input geometry, clustering using separation distance.
fr: Fonction Window qui renvoie un identifiant de cluster pour chaque géométrie en entrée, regroupement en utilisant la distance de séparation.

note: Tag: para
en: A window function that returns a cluster number for each input geometry. Clustering partitions the geometries into sets in which each geometry is within the specified <varname>distance</varname> of at least one other geometry in the same cluster. Distances are Cartesian distances in the units of the SRID.
fr: Une fonction window qui renvoie un numéro de cluster pour chaque géométrie d'entrée. Le regroupement partitionne les géométries en ensembles dans lesquels chaque géométrie se trouve dans la <varname>distance</varname> spécifiée d'au moins une autre géométrie dans le même groupe. Les distances sont des distances cartésiennes dans les unités du SRID.

note: Tag: para
en: ST_ClusterWithinWin is equivalent to running <xref linkend="ST_ClusterDBSCAN"/> with <code>minpoints =&gt; 0</code>.
fr: ST_ClusterWithinWin est équivalent à l'exécution de <xref linkend="ST_ClusterDBSCAN"/> avec <code>minpoints =&gt; 0</code>.

note: Tag: title
en: Geometry Constructors
fr: Constructeurs de géométries

note: Tag: refpurpose
en: Creates a GeometryCollection or Multi* geometry from a set of geometries.
fr: Crée une géométrie GeometryCollection ou Multi à partir d'un ensemble de géométries.

note: Tag: para
en: Collects geometries into a geometry collection. The result is either a Multi* or a GeometryCollection, depending on whether the input geometries have the same or different types (homogeneous or heterogeneous). The input geometries are left unchanged within the collection.
fr: Rassemble les géométries dans une collection de géométries. Le résultat est soit un Multi*, soit une GeometryCollection, selon que les géométries d'entrée ont des types identiques ou différents (homogènes ou hétérogènes). Les géométries d'entrée restent inchangées dans la collection.

note: Tag: para
en: <emphasis role="bold">Variant 1:</emphasis> accepts two input geometries
fr: <emphasis role="bold">Variante 1:</emphasis> accepte géométries en entrée

note: Tag: para
en: <emphasis role="bold">Variant 2:</emphasis> accepts an array of geometries
fr: <emphasis role="bold">Variante 2:</emphasis> accepte un tableau de géométries

note: Tag: para
en: <emphasis role="bold">Variant 3:</emphasis> aggregate function accepting a rowset of geometries.
fr: <emphasis role="bold">Variante 3:</emphasis> fonction agrégée acceptant un ensemble de géométries.

note: Tag: para
en: If any of the input geometries are collections (Multi* or GeometryCollection) ST_Collect returns a GeometryCollection (since that is the only type which can contain nested collections). To prevent this, use <xref linkend="ST_Dump"/> in a subquery to expand the input collections to their atomic elements (see example below).
fr: Si l'une des géométries en entrée est une collection (Multi* ou GeometryCollection), ST_Collect renvoie une GeometryCollection (puisque c'est le seul type qui peut contenir des collections imbriquées). Pour éviter cela, utilisez <xref linkend="ST_Dump"/> dans une sous-requête pour développer les collections d'entrée en leurs éléments atomiques (voir l'exemple ci-dessous).

note: Tag: para
en: ST_Collect and <xref linkend="ST_Union"/> appear similar, but in fact operate quite differently. ST_Collect aggregates geometries into a collection without changing them in any way. ST_Union geometrically merges geometries where they overlap, and splits linestrings at intersections. It may return single geometries when it dissolves boundaries.
fr: ST_Collect et <xref linkend="ST_Union"/> semblent similaires, mais fonctionnent en fait assez différemment. ST_Collect agrège les géométries dans une collection sans les modifier en aucune façon. ST_Union fusionne géométriquement les géométries lorsqu'elles se chevauchent, et divise les lignes aux intersections. Elle peut retourner des géométries uniques lorsqu'elle dissout les frontières.

note: Tag: para
en: Availability: 1.4.0 - ST_Collect(geomarray) was introduced. ST_Collect was enhanced to handle more geometries faster.
fr: Disponibilité : 1.4.0 - ST_Collect(geomarray) a été introduit. ST_Collect a été amélioré pour gérer plus de géométries plus rapidement.

note: Tag: title
en: Examples - Two-input variant
fr: Exemples - Variante à deux entrées

note: Tag: para
en: Collect 2D points.
fr: Collectez les points 2D.

note: Tag: para
en: Collect 3D points.
fr: Collectez les points 3D.

note: Tag: para
en: Collect curves.
fr: Collectez les courbes.

note: Tag: title
en: Examples - Array variant
fr: Exemples - Variante avec un tableau

note: Tag: para
en: Using an array constructor for a subquery.
fr: Utilisation d'un constructeur de tableau pour une sous-requête.

note: Tag: para
en: Using an array constructor for values.
fr: Utilisation d'un constructeur de tableau pour les valeurs.

note: Tag: title
en: Examples - Aggregate variant
fr: Exemples - Variante avec un agrégat

note: Tag: para
en: Creating multiple collections by grouping geometries in a table.
fr: Création de collections multiples en regroupant les géométries dans une table.

note: Tag: refpurpose
en: <refpurpose>Creates a LineString from a MultiPoint geometry.</refpurpose>
fr: <refpurpose>Crée une LineString à partir d'une géométrie MultiPoint.</refpurpose>

note: Tag: para
en: <para>Creates a LineString from a MultiPoint geometry.</para>
fr: <para>Crée une LineString à partir d'une géométrie MultiPoint.</para>

note: Tag: para
en: Use <xref linkend="ST_MakeLine"/> to create lines from Point or LineString inputs.
fr: Utilisez <xref linkend="ST_MakeLine"/> pour créer des lignes à partir des entrées Point ou LineString.

note: Tag: para
en: Create a 3D line string from a 3D MultiPoint
fr: Créer une LineString 3D à partir d'un MultiPoint 3D

note: Tag: refpurpose
en: Creates a rectangular Polygon from minimum and maximum coordinates.
fr: Crée un polygone rectangulaire à partir des coordonnées minimales et maximales.

note: Tag: para
en: Creates a rectangular Polygon from the minimum and maximum values for X and Y. Input values must be in the spatial reference system specified by the SRID. If no SRID is specified the unknown spatial reference system (SRID 0) is used.
fr: Crée un polygone rectangulaire à partir des valeurs minimales et maximales de X et Y. Les valeurs entrées doivent être dans le système de référence spatiale spécifié par le SRID. Si aucun SRID n'est spécifié, le système de référence spatiale inconnu (SRID 0) est utilisé.

note: Tag: para
en: Availability: 1.5
fr: Disponibilité : 1.5

note: Tag: para
en: Enhanced: 2.0: Ability to specify an envelope without specifying an SRID was introduced.
fr: Amélioré : 2.0 : La possibilité de spécifier une enveloppe sans spécifier un SRID a été introduite.

note: Tag: title
en: Example: Building a bounding box polygon
fr: Exemple : Construction d'un polygone de la l'enveloppe englobante

note: Tag: refpurpose
en: Creates a LineString from Point, MultiPoint, or LineString geometries.
fr: Crée une LineString à partir de géométries Point, MultiPoint ou LineString.

note: Tag: para
en: Creates a LineString containing the points of Point, MultiPoint, or LineString geometries. Other geometry types cause an error.
fr: Crée une LineString contenant les points des géométries Point, MultiPoint ou LineString. Les autres types de géométrie provoquent une erreur.

note: Tag: para
en: <emphasis role="bold">Variant 3:</emphasis> aggregate function accepting a rowset of geometries. To ensure the order of the input geometries use <varname>ORDER BY</varname> in the function call, or a subquery with an <varname>ORDER BY</varname> clause.
fr: <emphasis role="bold">Variante 3:</emphasis> fonction agrégée acceptant un ensemble de géométries. Pour garantir l'ordre des géométries d'entrée, utilisez <varname>ORDER BY</varname> dans l'appel de fonction, ou une sous-requête avec une clause <varname>ORDER BY</varname>.

note: Tag: para
en: Repeated nodes at the beginning of input LineStrings are collapsed to a single point. Repeated points in Point and MultiPoint inputs are not collapsed. <xref linkend="ST_RemoveRepeatedPoints"/> can be used to collapse repeated points from the output LineString.
fr: Les nœuds répétés au début des LineStrings d'entrée sont réduits à un seul point. Les points répétés dans les entrées Point et MultiPoint ne sont pas réduits. <xref linkend="ST_RemoveRepeatedPoints"/> peut être utilisé pour réduire les points répétés de la LineString de sortie.

note: Tag: para
en: Availability: 2.3.0 - Support for MultiPoint input elements was introduced
fr: Disponibilité : 2.3.0 - La prise en charge des éléments d'entrée MultiPoint a été introduite

note: Tag: para
en: Availability: 2.0.0 - Support for LineString input elements was introduced
fr: Disponibilité : 2.0.0 - La prise en charge des éléments d'entrée LineString a été introduite

note: Tag: para
en: Availability: 1.4.0 - ST_MakeLine(geomarray) was introduced. ST_MakeLine aggregate functions was enhanced to handle more points faster.
fr: Disponibilité : 1.4.0 - création de ST_MakeLine(geomarray). L'agrégat spatial ST_MakeLine amélioré pour supporter plus de points plus rapidement.

note: Tag: title
en: Examples: Two-input variant
fr: Exemples : Variante à deux entrées

note: Tag: para
en: Create a line composed of two points.
fr: Créez une ligne composée de deux points.

note: Tag: para
en: Create a 3D line from two 3D points.
fr: Créer une ligne 3D à partir de deux points 3D.

note: Tag: para
en: Create a line from two disjoint LineStrings.
fr: Crée une ligne à partir de deux LineStrings disjointes.

note: Tag: title
en: Examples: Array variant
fr: Exemples : Variante avec un tableau

note: Tag: para
en: Create a line from an array formed by a subquery with ordering.
fr: Créer une ligne à partir d'un tableau formé par une sous-requête avec ordonnancement.

note: Tag: para
en: Create a 3D line from an array of 3D points
fr: Créer une ligne 3D à partir d'un tableau de points 3D

note: Tag: title
en: Examples: Aggregate variant
fr: Exemples : Variante avec un agrégat

note: Tag: para
en: This example queries time-based sequences of GPS points from a set of tracks and creates one record for each track. The result geometries are LineStrings composed of the GPS track points in the order of travel.
fr: Cet exemple interroge des séquences temporelles de points GPS à partir d'un ensemble de pistes et crée un enregistrement pour chaque piste. Les géométries résultantes sont des LineStrings composées des points GPS dans l'ordre de leur déplacement.

note: Tag: para
en: Using aggregate <varname>ORDER BY</varname> provides a correctly-ordered LineString.
fr: L'utilisation de l'agrégat <varname>ORDER BY</varname> fournit une LineString correctement ordonnée.

note: Tag: para
en: Prior to PostgreSQL 9, ordering in a subquery can be used. However, sometimes the query plan may not respect the order of the subquery.
fr: Avant PostgreSQL 9, l'ordre dans une sous-requête peut être utilisé. Cependant, il arrive que le plan de requête ne respecte pas l'ordre de la sous-requête.

note: Tag: refpurpose
en: Creates a 2D, 3DZ or 4D Point.
fr: Crée un point 2D, 3DZ ou 4D.

note: Tag: para
en: Creates a 2D XY, 3D XYZ or 4D XYZM Point geometry. Use <xref linkend="ST_MakePointM"/> to make points with XYM coordinates.
fr: Crée une géométrie de point 2D XY, 3D XYZ ou 4D XYZM. Utilisez <xref linkend="ST_MakePointM"/> pour créer des points avec des coordonnées XYM.

note: Tag: para
en: Use <xref linkend="ST_SetSRID"/> to specify a SRID for the created point.
fr: Utilisez <xref linkend="ST_SetSRID"/> pour spécifier un SRID pour le point créé.

note: Tag: para
en: While not OGC-compliant, <varname>ST_MakePoint</varname> is faster and more precise than <xref linkend="ST_GeomFromText"/> and <xref linkend="ST_PointFromText"/>. It is also easier to use for numeric coordinate values.
fr: Bien que non conforme à l'OGC, <varname>ST_MakePoint</varname> est plus rapide et plus précis que <xref linkend="ST_GeomFromText"/> et <xref linkend="ST_PointFromText"/>. Elle est également plus facile à utiliser pour les valeurs de coordonnées numériques.

note: Tag: para
en: For geodetic coordinates, <varname>X</varname> is longitude and <varname>Y</varname> is latitude
fr: Pour les coordonnées géodésiques, <varname>X</varname> est la longitude et <varname>Y</varname> la latitude

note: Tag: para
en: The functions <xref linkend="ST_Point"/>, <xref linkend="ST_PointZ"/>, <xref linkend="ST_PointM"/>, and <xref linkend="ST_PointZM"/> can be used to create points with a given SRID.
fr: Les fonctions <xref linkend="ST_Point"/>, <xref linkend="ST_PointZ"/>, <xref linkend="ST_PointM"/> et <xref linkend="ST_PointZM"/> peuvent être utilisées pour créer des points avec un SRID donné.

note: Tag: refpurpose
en: Creates a Point from X, Y and M values.
fr: Crée un point à partir des valeurs X, Y et M.

note: Tag: para
en: Creates a point with X, Y and M (measure) ordinates. Use <xref linkend="ST_MakePoint"/> to make points with XY, XYZ, or XYZM coordinates.
fr: Crée un point avec des coordonnées X, Y et M (mesure). Utilisez <xref linkend="ST_MakePoint"/> pour créer des points avec des coordonnées XY, XYZ ou XYZM.

note: Tag: para
en: The functions <xref linkend="ST_PointM"/>, and <xref linkend="ST_PointZM"/> can be used to create points with an M value and a given SRID.
fr: Les fonctions <xref linkend="ST_PointM"/> et <xref linkend="ST_PointZM"/> peuvent être utilisées pour créer des points avec une valeur M et un SRID donné.

note: Tag: para
en: is used for text output because <xref linkend="ST_AsText"/> does not support M values.
fr: est utilisé pour la sortie texte car <xref linkend="ST_AsText"/> ne prend pas en charge les valeurs M.

note: Tag: para
en: Create point with unknown SRID.
fr: Créer un point avec un SRID inconnu.

note: Tag: para
en: Create point with a measure in the WGS 84 geodetic coordinate system.
fr: Créer un point avec une mesure dans le système de coordonnées géodésiques WGS 84.

note: Tag: para
en: Get measure of created point.
fr: Obtenir la mesure du point créé.

note: Tag: refpurpose
en: Creates a Polygon from a shell and optional list of holes.
fr: Crée un polygone à partir d'une collection et d'une liste facultative de trous.

note: Tag: para
en: Creates a Polygon formed by the given shell and optional array of holes. Input geometries must be closed LineStrings (rings).
fr: Crée un polygone formé par la collection donnée et un tableau optionnel de trous. Les géométries d'entrée doivent être des LineStrings (anneaux) fermés.

note: Tag: para
en: <emphasis role="bold">Variant 1:</emphasis> Accepts one shell LineString.
fr: <emphasis role="bold">Variante 1:</emphasis> Accepte une collection de LineString.

note: Tag: para
en: <emphasis role="bold">Variant 2:</emphasis> Accepts a shell LineString and an array of inner (hole) LineStrings. A geometry array can be constructed using the PostgreSQL array_agg(), ARRAY[] or ARRAY() constructs.
fr: <emphasis role="bold">Variante 2:</emphasis> Accepte une collection de LineString et un tableau de LineStrings internes (trous). Un tableau de géométrie peut être construit en utilisant les constructions PostgreSQL array_agg(), ARRAY[] ou ARRAY().

note: Tag: para
en: This function does not accept MultiLineStrings. Use <xref linkend="ST_LineMerge"/> to generate a LineString, or <xref linkend="ST_Dump"/> to extract LineStrings.
fr: Cette fonction n'accepte pas les MultiLineStrings. Utilisez <xref linkend="ST_LineMerge"/> pour générer une LineString, ou <xref linkend="ST_Dump"/> pour extraire les LineStrings.

note: Tag: title
en: Examples: Single input variant
fr: Exemples : variante avec une entrée unique

note: Tag: para
en: Create a Polygon from a 2D LineString.
fr: Créez un polygone à partir d'une LineString 2D.

note: Tag: para
en: Create a Polygon from an open LineString, using <xref linkend="ST_StartPoint"/> and <xref linkend="ST_AddPoint"/> to close it.
fr: Créez un polygone à partir d'une LineString ouverte, en utilisant <xref linkend="ST_StartPoint"/> et <xref linkend="ST_AddPoint"/> pour la fermer.

note: Tag: para
en: Create a Polygon from a 3D LineString
fr: Créer un polygone à partir d'une LineString 3D

note: Tag: para
en: Create a Polygon from a LineString with measures
fr: Créer un polygone à partir d'une LineString avec des mesures

note: Tag: title
en: Examples: Outer shell with inner holes variant
fr: Exemples : Enveloppe extérieure avec variante de trous intérieurs

note: Tag: para
en: Create a donut Polygon with an extra hole
fr: Créer un polygone en forme de donut avec un trou supplémentaire

note: Tag: para
en: Create a set of province boundaries with holes representing lakes. The input is a table of province Polygons/MultiPolygons and a table of water linestrings. Lines forming lakes are determined by using <xref linkend="ST_IsClosed"/>. The province linework is extracted by using <xref linkend="ST_Boundary"/>. As required by <code>ST_MakePolygon</code>, the boundary is forced to be a single LineString by using <xref linkend="ST_LineMerge"/>. (However, note that if a province has more than one region or has islands this will produce an invalid polygon.) Using a LEFT JOIN ensures all provinces are included even if they have no lakes.
fr: Créez un ensemble de frontières de province avec des trous représentant des lacs. L'entrée est un tableau de polygones/multipolygones de province et un tableau de lignes d'eau. Les lignes formant des lacs sont déterminées en utilisant <xref linkend="ST_IsClosed"/>. Le réseau de la province est extrait en utilisant <xref linkend="ST_Boundary"/>. Comme requis par <code>ST_MakePolygon</code>, la frontière est forcée à être une seule LineString en utilisant <xref linkend="ST_LineMerge"/>. (Cependant, notez que si une province a plus d'une région ou a des îles, cela produira un polygone invalide). L'utilisation d'un LEFT JOIN garantit que toutes les provinces sont incluses, même si elles n'ont pas de lacs.

note: Tag: para
en: The CASE construct is used because passing a null array into ST_MakePolygon results in a NULL return value.
fr: La construction CASE est utilisée car le passage d'un tableau nul dans ST_MakePolygon entraîne une valeur de retour NULL.

note: Tag: para
en: Another technique is to utilize a correlated subquery and the ARRAY() constructor that converts a row set to an array.
fr: Une autre technique consiste à utiliser une sous-requête corrélée et le constructeur ARRAY() qui convertit un ensemble de lignes en un tableau.

note: Tag: refpurpose
en: Creates a Point with X, Y and SRID values.
fr: Crée un point avec des valeurs X, Y et SRID.

note: Tag: para
en: Returns a Point with the given X and Y coordinate values. This is the SQL-MM equivalent for <xref linkend="ST_MakePoint"/> that takes just X and Y.
fr: Renvoie un point avec les valeurs de coordonnées X et Y données. C'est l'équivalent SQL-MM de <xref linkend="ST_MakePoint"/> qui ne prend que X et Y.

note: Tag: para
en: Enhanced: 3.2.0 srid as an extra optional argument was added. Older installs require combining with ST_SetSRID to mark the srid on the geometry.
fr: Amélioration : 3.2.0 srid a été ajouté comme argument optionnel supplémentaire. Les anciennes installations nécessitent une combinaison avec ST_SetSRID pour marquer le srid sur la géométrie.

note: Tag: para
en: &sqlmm_compliant; SQL-MM 3: 6.1.2
fr: &sqlmm_compliant; SQL-MM 3 : 6.1.2

note: Tag: title
en: Examples: Geometry
fr: Exemple : Géométrie

note: Tag: para
en: Creating a point with SRID specified:
fr: Création d'un point avec le SRID spécifié :

note: Tag: para
en: Alternative way of specifying SRID:
fr: Autre façon de spécifier le SRID :

note: Tag: title
en: Examples: Geography
fr: Exemples : Géographie

note: Tag: para
en: Create <link linkend="PostGIS_Geography">geography</link> points using the <varname>::</varname> cast syntax:
fr: Créez des points <link linkend="PostGIS_Geography">geography</link> en utilisant la syntaxe <varname>::</varname> :

note: Tag: para
en: Pre-PostGIS 3.2 code, using <varname>CAST</varname>:
fr: Code Pre-PostGIS 3.2, utilisant <varname>CAST</varname> :

note: Tag: para
en: If the point coordinates are not in a geodetic coordinate system (such as WGS84), then they must be reprojected before casting to a geography. In this example a point in Pennsylvania State Plane feet (SRID 2273) is projected to WGS84 (SRID 4326).
fr: Si les coordonnées du point ne sont pas dans un système de coordonnées géodésiques (tel que WGS84), elles doivent être reprojetées avant d'être projetées dans une géographie. Dans cet exemple, un point en pieds du plan de l'État de Pennsylvanie (SRID 2273) est projeté en WGS84 (SRID 4326).

note: Tag: refpurpose
en: Creates a Point with X, Y, Z and SRID values.
fr: Crée un point avec des valeurs X, Y, Z et SRID.

note: Tag: para
en: Returns an Point with the given X, Y and Z coordinate values, and optionally an SRID number.
fr: Renvoie un point avec les valeurs de coordonnées X, Y et Z données, et éventuellement un numéro SRID.

note: Tag: refpurpose
en: Creates a Point with X, Y, M and SRID values.
fr: Crée un point avec des valeurs X, Y, M et SRID.

note: Tag: para
en: Returns an Point with the given X, Y and M coordinate values, and optionally an SRID number.
fr: Renvoie un point avec les valeurs de coordonnées X, Y et M données, et éventuellement un numéro SRID.

note: Tag: refpurpose
en: Creates a Point with X, Y, Z, M and SRID values.
fr: Crée un point avec des valeurs X, Y, Z, M et SRID.

note: Tag: para
en: Returns an Point with the given X, Y, Z and M coordinate values, and optionally an SRID number.
fr: Renvoie un point avec les valeurs de coordonnées X, Y, Z et M données, et éventuellement un numéro SRID.

note: Tag: refpurpose
en: Creates a Polygon from a LineString with a specified SRID.
fr: Crée un polygone à partir d'une LineString avec un SRID spécifié.

note: Tag: para
en: Returns a polygon built from the given LineString and sets the spatial reference system from the <varname>srid</varname>.
fr: Renvoie un polygone construit à partir de la LineString donnée et définit le système de référence spatiale à partir du <varname>srid</varname>.

note: Tag: para
en: ST_Polygon is similar to <xref linkend="ST_MakePolygon"/> Variant 1 with the addition of setting the SRID.
fr: ST_Polygon est similaire à la variante 1 de <xref linkend="ST_MakePolygon"/> avec l'ajout de la définition du SRID.

note: Tag: para
en: To create polygons with holes use <xref linkend="ST_MakePolygon"/> Variant 2 and then <xref linkend="ST_SetSRID"/>.
fr: Pour créer des polygones avec des trous, utilisez <xref linkend="ST_MakePolygon"/> la variante 2 et ensuite <xref linkend="ST_SetSRID"/>.

note: Tag: para
en: &sqlmm_compliant; SQL-MM 3: 8.3.2
fr: &sqlmm_compliant; SQL-MM 3 : 8.3.2

note: Tag: para
en: Create a 2D polygon.
fr: Créer un polygone 2D.

note: Tag: para
en: Create a 3D polygon.
fr: Créer un polygone 3D.

note: Tag: refpurpose
en: Creates a rectangular Polygon in <link xlink:href="https://en.wikipedia.org/wiki/Web_Mercator_projection">Web Mercator</link> (SRID:3857) using the <link xlink:href="https://en.wikipedia.org/wiki/Tiled_web_map">XYZ tile system</link>.
fr: Crée un polygone rectangulaire dans <link xlink:href="https://en.wikipedia.org/wiki/Web_Mercator_projection">Web Mercator</link> (SRID:3857) en utilisant le <link xlink:href="https://en.wikipedia.org/wiki/Tiled_web_map">système de tuiles XYZ</link>.

note: Tag: para
en: Creates a rectangular Polygon giving the extent of a tile in the <link xlink:href="https://en.wikipedia.org/wiki/Tiled_web_map">XYZ tile system</link>. The tile is specified by the zoom level Z and the XY index of the tile in the grid at that level. Can be used to define the tile bounds required by <xref linkend="ST_AsMVTGeom"/> to convert geometry into the MVT tile coordinate space.
fr: Crée un polygone rectangulaire donnant l'étendue d'une tuile dans le <link xlink:href="https://en.wikipedia.org/wiki/Tiled_web_map">système de tuiles XYZ</link>. La tuile est spécifiée par le niveau de zoom Z et l'indice XY de la tuile dans la grille à ce niveau. Peut être utilisé pour définir les limites de la tuile requises par <xref linkend="ST_AsMVTGeom"/> pour convertir la géométrie dans l'espace de coordonnées de la tuile MVT.

note: Tag: para
en: By default, the tile envelope is in the <link xlink:href="https://en.wikipedia.org/wiki/Web_Mercator_projection">Web Mercator</link> coordinate system (SRID:3857) using the standard range of the Web Mercator system (-20037508.342789, 20037508.342789). This is the most common coordinate system used for MVT tiles. The optional <varname>bounds</varname> parameter can be used to generate tiles in any coordinate system. It is a geometry that has the SRID and extent of the "Zoom Level zero" square within which the XYZ tile system is inscribed.
fr: Par défaut, l'enveloppe de la tuile est dans le système de coordonnées <link xlink:href="https://en.wikipedia.org/wiki/Web_Mercator_projection">Web Mercator</link> (SRID:3857) utilisant la plage standard du système Web Mercator (-20037508.342789, 20037508.342789). Il s'agit du système de coordonnées le plus couramment utilisé pour les tuiles MVT. Le paramètre facultatif <varname>bounds</varname> peut être utilisé pour générer des tuiles dans n'importe quel système de coordonnées. Il s'agit d'une géométrie qui possède le SRID et l'étendue du carré "Niveau de zoom zéro" dans lequel le système de tuiles XYZ est inscrit.

note: Tag: para
en: The optional <varname>margin</varname> parameter can be used to expand a tile by the given percentage. E.g. <varname>margin=0.125</varname> expands the tile by 12.5%, which is equivalent to buffer=512 when the tile extent size is 4096, as used in <xref linkend="ST_AsMVTGeom"/>. This is useful to create a tile buffer to include data lying outside of the tile's visible area, but whose existence affects the tile rendering. For example, a city name (a point) could be near an edge of a tile, so its label should be rendered on two tiles, even though the point is located in the visible area of just one tile. Using expanded tiles in a query will include the city point in both tiles. Use a negative value to shrink the tile instead. Values less than -0.5 are prohibited because that would eliminate the tile completely. Do not specify a margin when using with <varname>ST_AsMVTGeom</varname>. See the example for <xref linkend="ST_AsMVT"/>.
fr: Le paramètre facultatif <varname>margin</varname> peut être utilisé pour étendre une tuile du pourcentage donné. Par exemple, <varname>margin=0.125</varname> étend la tuile de 12,5%, ce qui équivaut à buffer=512 lorsque la taille de l'étendue de la tuile est de 4096, comme utilisé dans <xref linkend="ST_AsMVTGeom"/>. Ceci est utile pour créer un tampon de tuile afin d'inclure des données situées en dehors de la zone visible de la tuile, mais dont l'existence affecte le rendu de la tuile. Par exemple, le nom d'une ville (un point) peut se trouver près du bord d'une tuile, son étiquette doit donc être rendue sur deux tuiles, même si le point se trouve dans la zone visible d'une seule tuile. L'utilisation de tuiles étendues dans une requête inclura le point de la ville dans les deux tuiles. Utilisez une valeur négative pour réduire la tuile à la place. Les valeurs inférieures à -0,5 sont interdites, car cela éliminerait complètement la tuile. Ne spécifiez pas de marge lors de l'utilisation avec <varname>ST_AsMVTGeom</varname>. Voir l'exemple pour <xref linkend="ST_AsMVT"/>.

note: Tag: para
en: Enhanced: 3.1.0 Added margin parameter.
fr: Amélioré : 3.1.0 Ajout d'un paramètre de marge.

note: Tag: para
en: Availability: 3.0.0
fr: Disponibilité : 3.0.0

note: Tag: title
en: Example: Building a tile envelope
fr: Exemple : Construction d'une enveloppe de tuiles

note: Tag: refpurpose
en: Returns a set of hexagons and cell indices that completely cover the bounds of the geometry argument.
fr: Renvoie un ensemble d'hexagones et d'indices de cellules qui couvrent complètement les limites de l'argument géométrie.

note: Tag: para
en: Starts with the concept of a hexagon tiling of the plane. (Not a hexagon tiling of the globe, this is not the <link xlink:href="https://github.com/uber/h3">H3</link> tiling scheme.) For a given planar SRS, and a given edge size, starting at the origin of the SRS, there is one unique hexagonal tiling of the plane, Tiling(SRS, Size). This function answers the question: what hexagons in a given Tiling(SRS, Size) overlap with a given bounds.
fr: Commence par le concept d'un tuilage hexagonal du plan. (Pas un pavage hexagonal du globe, ce n'est pas le schéma de pavage <link xlink:href="https://github.com/uber/h3">H3</link>). Pour un SRS plan donné, et une taille d'arête donnée, en commençant à l'origine du SRS, il existe un unique tuilage hexagonal du plan, Tiling(SRS, Size). Cette fonction répond à la question : quels hexagones dans un Tiling(SRS, Size) donné se chevauchent avec une limite donnée.

note: Tag: para
en: The SRS for the output hexagons is the SRS provided by the bounds geometry.
fr: Le SRS pour les hexagones de sortie est le SRS fourni par la géométrie des limites.

note: Tag: para
en: Doubling or tripling the edge size of the hexagon generates a new parent tiling that fits with the origin tiling. Unfortunately, it is not possible to generate parent hexagon tilings that the child tiles perfectly fit inside.
fr: Doubler ou tripler la taille des bords de l'hexagone génère un nouveau pavage parent qui s'adapte au pavage d'origine. Malheureusement, il n'est pas possible de générer des tuiles d'hexagones parents dans lesquelles les tuiles enfants s'insèrent parfaitement.

note: Tag: para
en: Availability: 3.1.0
fr: Disponibilité : 3.1.0

note: Tag: title
en: Example: Counting points in hexagons
fr: Exemple : Compter les points dans les hexagones

note: Tag: para
en: To do a point summary against a hexagonal tiling, generate a hexagon grid using the extent of the points as the bounds, then spatially join to that grid.
fr: Pour faire un résumé des points par rapport à un pavage hexagonal, générez une grille hexagonale en utilisant l'étendue des points comme limites, puis joignez spatialement cette grille.

note: Tag: title
en: Example: Generating hex coverage of polygons
fr: Exemple : Génération de la couverture hexagonale des polygones

note: Tag: para
en: If we generate a set of hexagons for each polygon boundary and filter out those that do not intersect their hexagons, we end up with a tiling for each polygon.
fr: Si nous générons un ensemble d'hexagones pour chaque limite de polygone et que nous éliminons par filtrage ceux qui n'intersectent pas leurs hexagones, nous obtenons un pavage pour chaque polygone.

note: Tag: para
en: Tiling states results in a hexagon coverage of each state, and multiple hexagons overlapping at the borders between states.
fr: La mise en mosaïque des états donne lieu à une couverture hexagonale de chaque état, et à des hexagones multiples se chevauchant aux frontières entre les états.

note: Tag: para
en: The LATERAL keyword is implied for set-returning functions when referring to a prior table in the FROM list. So CROSS JOIN LATERAL, CROSS JOIN, or just plain , are equivalent constructs for this example.
fr: Le mot-clé LATERAL est implicite pour les fonctions de retour d'ensemble lorsqu'elles font référence à une table antérieure dans la liste FROM. Ainsi, CROSS JOIN LATERAL, CROSS JOIN, ou tout simplement , sont des constructions équivalentes pour cet exemple.

note: Tag: refpurpose
en: Returns a single hexagon, using the provided edge size and cell coordinate within the hexagon grid space.
fr: Renvoie un seul hexagone, en utilisant la taille du bord et les coordonnées de la cellule fournies dans l'espace de la grille de l'hexagone.

note: Tag: para
en: Uses the same hexagon tiling concept as <xref linkend="ST_HexagonGrid"/>, but generates just one hexagon at the desired cell coordinate. Optionally, can adjust origin coordinate of the tiling, the default origin is at 0,0.
fr: Utilise le même concept de tuilage d'hexagones que <xref linkend="ST_HexagonGrid"/>, mais génère un seul hexagone à la coordonnée de cellule souhaitée. En option, peut ajuster la coordonnée d'origine du tuilage, l'origine par défaut est à 0,0.

note: Tag: para
en: Hexagons are generated with no SRID set, so use <xref linkend="ST_SetSRID"/> to set the SRID to the one you expect.
fr: Les hexagones sont générés sans SRID défini, utilisez donc <xref linkend="ST_SetSRID"/> pour définir le SRID à celui que vous attendez.

note: Tag: title
en: Example: Creating a hexagon at the origin
fr: Exemple : Création d'un hexagone à l'origine

note: Tag: refpurpose
en: Returns a set of grid squares and cell indices that completely cover the bounds of the geometry argument.
fr: Renvoie un ensemble de carrés de grille et d'indices de cellules qui couvrent complètement les limites de l'argument géométrie.

note: Tag: para
en: Starts with the concept of a square tiling of the plane. For a given planar SRS, and a given edge size, starting at the origin of the SRS, there is one unique square tiling of the plane, Tiling(SRS, Size). This function answers the question: what grids in a given Tiling(SRS, Size) overlap with a given bounds.
fr: Commence par le concept de tuilage carré du plan. Pour un SRS plan donné, et une taille d'arête donnée, en commençant à l'origine du SRS, il existe un unique pavage carré du plan, Tiling(SRS, Size). Cette fonction répond à la question : quelles grilles dans un Tiling(SRS, Size) donné se chevauchent avec une limite donnée.

note: Tag: para
en: The SRS for the output squares is the SRS provided by the bounds geometry.
fr: Le SRS des carrés de sortie est le SRS fourni par la géométrie des limites.

note: Tag: para
en: Doubling or edge size of the square generates a new parent tiling that perfectly fits with the original tiling. Standard web map tilings in mercator are just powers-of-two square grids in the mercator plane.
fr: Le doublement de la taille du carré ou de son bord génère un nouveau pavage parent qui s'adapte parfaitement au pavage d'origine. Les carrelages standard des cartes Web dans mercator ne sont que des puissances de deux grilles carrées dans le plan mercator.

note: Tag: title
en: Example: Generating a 1 degree grid for a country
fr: Exemple : Générer une grille de 1 degré pour un pays

note: Tag: para
en: The grid will fill the whole bounds of the country, so if you want just squares that touch the country you will have to filter afterwards with ST_Intersects.
fr: La grille remplira toutes les limites du pays, donc si vous voulez seulement des carrés qui touchent le pays, vous devrez filtrer ensuite avec ST_Intersects.

note: Tag: title
en: Example: Counting points in squares (using single chopped grid)
fr: Exemple : Compter les points dans les carrés (en utilisant une seule grille découpée)

note: Tag: para
en: To do a point summary against a square tiling, generate a square grid using the extent of the points as the bounds, then spatially join to that grid. Note the estimated extent might be off from actual extent, so be cautious and at very least make sure you've analyzed your table.
fr: Pour faire un résumé des points par rapport à un tuilage carré, générez une grille carrée en utilisant l'étendue des points comme limites, puis joignez spatialement à cette grille. Notez que l'étendue estimée peut être différente de l'étendue réelle, soyez donc prudent et assurez-vous au moins d'avoir analysé votre tableau.

note: Tag: title
en: Example: Counting points in squares using set of grid per point
fr: Exemple : Compter des points dans des carrés en utilisant un jeu de grille par point

note: Tag: para
en: This yields the same result as the first example but will be slower for a large number of points
fr: Cette méthode donne le même résultat que le premier exemple mais sera plus lente pour un grand nombre de points

note: Tag: refpurpose
en: Returns a single square, using the provided edge size and cell coordinate within the square grid space.
fr: Renvoie un seul carré, en utilisant la taille du bord et la coordonnée de la cellule fournies dans l'espace de la grille du carré.

note: Tag: para
en: Uses the same square tiling concept as <xref linkend="ST_SquareGrid"/>, but generates just one square at the desired cell coordinate. Optionally, can adjust origin coordinate of the tiling, the default origin is at 0,0.
fr: Utilise le même concept de tuilage carré que <xref linkend="ST_SquareGrid"/>, mais génère un seul carré à la coordonnée de cellule souhaitée. En option, peut ajuster la coordonnée d'origine du tuilage, l'origine par défaut est à 0,0.

note: Tag: para
en: Squares are generated with no SRID set, so use <xref linkend="ST_SetSRID"/> to set the SRID to the one you expect.
fr: Les carrés sont générés sans SRID défini, utilisez donc <xref linkend="ST_SetSRID"/> pour définir le SRID à celui que vous attendez.

note: Tag: title
en: Example: Creating a square at the origin
fr: Exemple : Création d'un carré à l'origine

note: Tag: refpurpose
en: Returns the input letters rendered as geometry with a default start position at the origin and default text height of 100.
fr: Renvoie les lettres d'entrée rendues sous forme de géométrie avec une position de départ par défaut à l'origine et une hauteur de texte par défaut de 100.

note: Tag: para
en: Uses a built-in font to render out a string as a multipolygon geometry. The default text height is 100.0, the distance from the bottom of a descender to the top of a capital. The default start position places the start of the baseline at the origin. Over-riding the font involves passing in a json map, with a character as the key, and base64 encoded TWKB for the font shape, with the fonts having a height of 1000 units from the bottom of the descenders to the tops of the capitals.
fr: Utilise une police intégrée pour rendre une chaîne de caractères sous forme de géométrie multipolygonale. La hauteur de texte par défaut est de 100,0, soit la distance entre le bas d'une descendante et le haut d'une capitale. La position de départ par défaut place le début de la ligne de base à l'origine. Pour remplacer la police, il faut passer une carte json, avec un caractère comme clé, et des TWKB encodés en base64 pour la forme de la police, les polices ayant une hauteur de 1000 unités du bas des descendantes au haut des capitales.

note: Tag: para
en: The text is generated at the origin by default, so to reposition and resize the text, first apply the <code>ST_Scale</code> function and then apply the <code>ST_Translate</code> function.
fr: Le texte est généré à l'origine par défaut, donc pour repositionner et redimensionner le texte, appliquez d'abord la fonction <code>ST_Scale</code> et ensuite appliquez la fonction <code>ST_Translate</code>.

note: Tag: title
en: Example: Generating the word 'Yo'
fr: Exemple : Génération du mot 'Yo'

note: Tag: para
en: Letters generated by ST_Letters
fr: Lettres générées par ST_Letters

note: Tag: title
en: Example: Scaling and moving words
fr: Exemple : Mise à l'échelle et déplacement des mots

note: Tag: title
en: Coverages
fr: Couvertures

note: Tag: para
en: These functions operate on sets of polygonal geometry that form "implicit coverages". To form a valid coverage polygons must not overlap, and the vertices of adjacent edges must match exactly. Coverages are fast to process, and can be operated on with window functions, which retain the coverage topology inside the window partition while altering the edges.
fr: Ces fonctions opèrent sur des ensembles de géométries polygonales qui forment des "couvertures implicites". Pour former une couverture valide, les polygones ne doivent pas se chevaucher et les sommets des arêtes adjacentes doivent correspondre exactement. Les couvertures sont rapides à traiter et peuvent être exploitées avec des fonctions window, qui conservent la topologie de la couverture à l'intérieur de la partition de la fenêtre tout en modifiant les arêtes.

note: Tag: refpurpose
en: Window function that finds locations where polygons fail to form a valid coverage.
fr: Fonction window qui trouve les endroits où les polygones ne forment pas une couverture valide.

note: Tag: para
en: A window function which checks if the polygons in the window partition form a valid polygonal coverage. It returns linear indicators showing the location of invalid edges (if any) in each polygon.
fr: Une fonction window qui vérifie si les polygones de la partition window forment une couverture polygonale valide. Elle renvoie des indicateurs linéaires indiquant l'emplacement des arêtes non valides (le cas échéant) dans chaque polygone.

note: Tag: para
en: A set of valid polygons is a valid coverage if the following conditions hold:
fr: Un ensemble de polygones valides est une couverture valide si les conditions suivantes sont remplies :

note: Tag: para
en: <emphasis role="bold">Non-overlapping</emphasis> - polygons do not overlap (their interiors do not intersect)
fr: <emphasis role="bold">Non-overlapping</emphasis> - les polygones ne se chevauchent pas (leurs intérieurs ne s'intersectent pas)

note: Tag: para
en: <emphasis role="bold">Edge-Matched</emphasis> - vertices along shared edges are identical
fr: <emphasis role="bold">Edge-Matched</emphasis> - les sommets situés le long d'arêtes communes sont identiques

note: Tag: para
en: As a window function a value is returned for every input polygon. For polygons which violate one or more of the validity conditions the return value is a MULTILINESTRING containing the problematic edges. Coverage-valid polygons return the value NULL. Non-polygonal or empty geometries also produce NULL values.
fr: En tant que fonction window, une valeur est renvoyée pour chaque polygone d'entrée. Pour les polygones qui ne respectent pas une ou plusieurs des conditions de validité, la valeur renvoyée est un MULTILINESTRING contenant les arêtes problématiques. Les polygones valides du point de vue de la couverture renvoient la valeur NULL. Les géométries non polygonales ou vides produisent également des valeurs NULL.

note: Tag: para
en: The conditions allow a valid coverage to contain holes (gaps between polygons), as long as the surrounding polygons are edge-matched. However, very narrow gaps are often undesirable. If the <parameter>tolerance</parameter> parameter is specified with a non-zero distance, edges forming narrower gaps will also be returned as invalid.
fr: Les conditions permettent à une couverture valide de contenir des trous (espaces entre les polygones), pour autant que les polygones environnants soient adaptés aux bords. Toutefois, des espaces très étroits ne sont souvent pas souhaitables. Si le paramètre <parameter>tolérance</parameter> est spécifié avec une distance non nulle, les arêtes formant des espaces plus étroits seront également renvoyées comme non valides.

note: Tag: para
en: The polygons being checked for coverage validity must also be valid geometries. This can be checked with <xref linkend="ST_IsValid"/>.
fr: Les polygones dont la validité de la couverture est vérifiée doivent également être des géométries valides. Ceci peut être vérifié avec <xref linkend="ST_IsValid"/>.

note: Tag: para
en: Requires GEOS &gt;= 3.12.0
fr: Nécessite GEOS &gt;= 3.12.0

note: Tag: para
en: Invalid edges caused by overlap and non-matching vertices
fr: Arêtes non valides dues au chevauchement et à la non-concordance des sommets

note: Tag: refpurpose
en: Window function that simplifies the edges of a polygonal coverage.
fr: Fonction window qui simplifie les bords d'une couverture polygonale.

note: Tag: para
en: A window function which simplifies the edges of polygons in a polygonal coverage. The simplification preserves the coverage topology. This means the simplified output polygons are consistent along shared edges, and still form a valid coverage.
fr: Une fonction window qui simplifie les bords des polygones dans une couverture polygonale. La simplification préserve la topologie de la couverture. Cela signifie que les polygones de sortie simplifiés sont cohérents le long des arêtes communes et forment toujours une couverture valide.

note: Tag: para
en: The simplification uses a variant of the <link xlink:href="https://en.wikipedia.org/wiki/Visvalingam%E2%80%93Whyatt_algorithm">Visvalingam–Whyatt algorithm</link>. The <parameter>tolerance</parameter> parameter has units of distance, and is roughly equal to the square root of triangular areas to be simplified.
fr: La simplification utilise une variante de l'algorithme <link xlink:href="https://en.wikipedia.org/wiki/Visvalingam%E2%80%93Whyatt_algorithm">Visvalingam-Whyatt</link>. Le paramètre <parameter>tolérance</parameter> a des unités de distance et est approximativement égal à la racine carrée des zones triangulaires à simplifier.

note: Tag: para
en: To simplify only the "internal" edges of the coverage (those that are shared by two polygons) set the <parameter>simplifyBoundary</parameter> parameter to false.
fr: Pour simplifier uniquement les bords "internes" de la couverture (ceux qui sont partagés par deux polygones), définissez le paramètre <parameter>simplifyBoundary</parameter> à false.

note: Tag: para
en: If the input is not a valid coverage there may be unexpected artifacts in the output (such as boundary intersections, or separated boundaries which appeared to be shared). Use <xref linkend="ST_CoverageInvalidEdges"/> to determine if a coverage is valid.
fr: Si l'entrée n'est pas une couverture valide, il peut y avoir des artefacts inattendus dans la sortie (tels que des intersections de frontières, ou des frontières séparées qui semblaient être partagées). Utilisez <xref linkend="ST_CoverageInvalidEdges"/> pour déterminer si une couverture est valide.

note: Tag: para
en: Input coverage
fr: Couverture d'entrée

note: Tag: para
en: Simplified coverage
fr: Couverture simplifiée

note: Tag: refpurpose
en: Computes the union of a set of polygons forming a coverage by removing shared edges.
fr: Calcule l'union d'un ensemble de polygones formant une couverture en supprimant les arêtes communes.

note: Tag: para
en: An aggregate function which unions a set of polygons forming a polygonal coverage. The result is a polygonal geometry covering the same area as the coverage. This function produces the same result as <xref linkend="ST_Union"/>, but uses the coverage structure to compute the union much faster.
fr: Une fonction agrégée qui réunit un ensemble de polygones formant une couverture polygonale. Le résultat est une géométrie polygonale couvrant la même zone que la couverture. Cette fonction produit le même résultat que <xref linkend="ST_Union"/>, mais utilise la structure de la couverture pour calculer l'union beaucoup plus rapidement.

note: Tag: para
en: If the input is not a valid coverage there may be unexpected artifacts in the output (such as unmerged or overlapping polygons). Use <xref linkend="ST_CoverageInvalidEdges"/> to determine if a coverage is valid.
fr: Si l'entrée n'est pas une couverture valide, il peut y avoir des artefacts inattendus dans la sortie (tels que des polygones non fusionnés ou se chevauchant). Utilisez <xref linkend="ST_CoverageInvalidEdges"/> pour déterminer si une couverture est valide.

note: Tag: para
en: Availability: 3.4.0 - requires GEOS &gt;= 3.8.0
fr: Disponibilité : 3.4.0 - nécessite GEOS &gt;= 3.8.0

note: Tag: para
en: Union result
fr: Résultat de l'union

note: Tag: title
en: Geometry Editors
fr: Éditeurs de géométrie

note: Tag: para
en: These functions create modified geometries by changing type, structure or vertices.
fr: Ces fonctions créent des géométries modifiées en changeant le type, la structure ou les sommets.

note: Tag: refpurpose
en: Add a point to a LineString.
fr: Ajoute un point à une LineString.

note: Tag: para
en: Adds a point to a LineString before the index <parameter>position</parameter> (using a 0-based index). If the <parameter>position</parameter> parameter is omitted or is -1 the point is appended to the end of the LineString.
fr: Ajoute un point à une LineString avant l'index <parameter>position</parameter> (en utilisant un index basé sur 0). Si le paramètre <parameter>position</parameter> est omis ou vaut -1, le point est ajouté à la fin de la LineString.

note: Tag: para
en: Add a point to the end of a 3D line
fr: Ajouter un point à la fin d'une ligne 3D

note: Tag: para
en: Guarantee all lines in a table are closed by adding the start point of each line to the end of the line only for those that are not closed.
fr: Garantir que toutes les lignes d'une table sont fermées en ajoutant le point de départ de chaque ligne à la fin de la ligne uniquement pour celles qui ne sont pas fermées.

note: Tag: refpurpose
en: Given a geometry collection, returns a multi-geometry containing only elements of a specified type.
fr: Pour une collection de géométries spécifiée, renvoie une multi-géométrie contenant uniquement des éléments d'un type spécifié.

note: Tag: para
en: Given a geometry collection, returns a homogeneous multi-geometry.
fr: Pour une collection de géométries spécifiée, renvoie une multi-géométrie homogène.

note: Tag: para
en: If the <parameter>type</parameter> is not specified, returns a multi-geometry containing only geometries of the highest dimension. So polygons are preferred over lines, which are preferred over points.
fr: Si le <parameter>type</parameter> n'est pas spécifié, il renvoie une multi-géométrie contenant uniquement des géométries de la dimension la plus élevée. Les polygones sont donc préférés aux lignes, qui sont préférées aux points.

note: Tag: para
en: If the <parameter>type</parameter> is specified, returns a multi-geometry containing only that type. If there are no sub-geometries of the right type, an EMPTY geometry is returned. Only points, lines and polygons are supported. The type numbers are:
fr: Si le <parameter>type</parameter> est spécifié, renvoie une multi-géométrie contenant uniquement ce type. S'il n'y a pas de sous-géométrie du bon type, une géométrie VIDE est renvoyée. Seuls les points, les lignes et les polygones sont pris en charge. Les numéros de type sont les suivants :

note: Tag: para
en: For atomic geometry inputs, the geometry is returned unchanged if the input type matches the requested type. Otherwise, the result is an EMPTY geometry of the specified type. If required, these can be converted to multi-geometries using <xref linkend="ST_Multi"/>.
fr: Pour les entrées de géométrie atomique, la géométrie est restituée inchangée si le type d'entrée correspond au type demandé. Sinon, le résultat est une géométrie VIDE du type spécifié. Si nécessaire, ces géométries peuvent être converties en géométries multiples en utilisant <xref linkend="ST_Multi"/>.

note: Tag: para
en: MultiPolygon results are not checked for validity. If the polygon components are adjacent or overlapping the result will be invalid. (For example, this can occur when applying this function to an <xref linkend="ST_Split"/> result.) This situation can be checked with <xref linkend="ST_IsValid"/> and repaired with <xref linkend="ST_MakeValid"/>.
fr: La validité des résultats MultiPolygon n'est pas vérifiée. Si les composants du polygone sont adjacents ou se chevauchent, le résultat ne sera pas valide. (Par exemple, cela peut se produire lorsque cette fonction est appliquée à un résultat <xref linkend="ST_Split"/>). Cette situation peut être vérifiée avec <xref linkend="ST_IsValid"/> et réparée avec <xref linkend="ST_MakeValid"/>.

note: Tag: para
en: Prior to 1.5.3 this function returned atomic inputs unchanged, no matter type. In 1.5.3 non-matching single geometries returned a NULL result. In 2.0.0 non-matching single geometries return an EMPTY result of the requested type.
fr: Avant la version 1.5.3, cette fonction renvoyait les entrées atomiques inchangées, quel que soit leur type. Dans la version 1.5.3, les géométries simples non correspondantes renvoyaient un résultat NULL. Dans la version 2.0.0, les géométries simples non correspondantes renvoient un résultat VIDE du type demandé.

note: Tag: para
en: Extract highest-dimension type:
fr: Extraire le type de dimension le plus élevé :

note: Tag: para
en: Extract points (type 1 == POINT):
fr: Extraire des points (type 1 == POINT) :

note: Tag: para
en: Extract lines (type 2 == LINESTRING):
fr: Extraire des lignes (type 2 == LINESTRING) :

note: Tag: refpurpose
en: Returns the simplest representation of a geometry collection.
fr: Renvoie la représentation la plus simple d'une collection de géométries.

note: Tag: para
en: Given a geometry collection, returns the "simplest" representation of the contents.
fr: Pour une collection de géométries spécifiée, renvoie la représentation la plus simple du contenu.

note: Tag: para
en: Homogeneous (uniform) collections are returned as the appropriate multi-geometry.
fr: Les collections homogènes (uniformes) sont renvoyées sous la forme de la multi-géométrie appropriée.

note: Tag: para
en: Heterogeneous (mixed) collections are flattened into a single GeometryCollection.
fr: Les collections hétérogènes (mixtes) sont écrasées en une seule GeometryCollection.

note: Tag: para
en: Collections containing a single atomic element are returned as that element.
fr: Les collections contenant un seul élément atomique sont renvoyées sous la forme de cet élément.

note: Tag: para
en: Atomic geometries are returned unchanged. If required, these can be converted to a multi-geometry using <xref linkend="ST_Multi"/>.
fr: Les géométries atomiques sont renvoyées telles quelles. Si nécessaire, elles peuvent être converties en une géométrie multiple en utilisant <xref linkend="ST_Multi"/>.

note: Tag: para
en: This function does not ensure that the result is valid. In particular, a collection containing adjacent or overlapping Polygons will create an invalid MultiPolygon. This situation can be checked with <xref linkend="ST_IsValid"/> and repaired with <xref linkend="ST_MakeValid"/>.
fr: Cette fonction ne garantit pas la validité du résultat. En particulier, une collection contenant des polygones adjacents ou se chevauchant créera un MultiPolygon invalide. Cette situation peut être vérifiée avec <xref linkend="ST_IsValid"/> et réparée avec <xref linkend="ST_MakeValid"/>.

note: Tag: para
en: Single-element collection converted to an atomic geometry
fr: Collection d'un seul élément convertie en géométrie atomique

note: Tag: para
en: Nested single-element collection converted to an atomic geometry:
fr: Collection imbriquée d'éléments simples convertie en géométrie atomique :

note: Tag: para
en: Collection converted to a multi-geometry:
fr: Collection convertie en une géométrie multiple :

note: Tag: para
en: Nested heterogeneous collection flattened to a GeometryCollection:
fr: Collection hétérogène imbriquée écrasée en une GeometryCollection :

note: Tag: para
en: Collection of Polygons converted to an (invalid) MultiPolygon:
fr: Collection de polygones convertis en un MultiPolygon (non valide) :

note: Tag: refpurpose
en: Converts a geometry containing curves to a linear geometry.
fr: Convertit une géométrie contenant des courbes en une géométrie linéaire.

note: Tag: para
en: Converts a CIRCULAR STRING to regular LINESTRING or CURVEPOLYGON to POLYGON or MULTISURFACE to MULTIPOLYGON. Useful for outputting to devices that can't support CIRCULARSTRING geometry types
fr: Convertit une CIRCULAR STRING en LINESTRING régulière ou CURVEPOLYGON en POLYGON ou MULTISURFACE en MULTIPOLYGON. Utile pour les sorties vers des appareils qui ne supportent pas les types de géométrie CIRCULARSTRING

note: Tag: para
en: Converts a given geometry to a linear geometry. Each curved geometry or segment is converted into a linear approximation using the given `tolerance` and options (32 segments per quadrant and no options by default).
fr: Convertit une géométrie donnée en une géométrie linéaire. Chaque géométrie ou segment courbe est converti en une approximation linéaire en utilisant la `tolérance` et les options données (32 segments par quadrant et aucune option par défaut).

note: Tag: para
en: The 'tolerance_type' argument determines interpretation of the `tolerance` argument. It can take the following values:
fr: L'argument 'tolerance_type' détermine l'interprétation de l'argument `tolerance`. Il peut prendre les valeurs suivantes :

note: Tag: para
en: 0 (default): Tolerance is max segments per quadrant.
fr: 0 (par défaut) : La tolérance est le nombre maximum de segments par quadrant.

note: Tag: para
en: 1: Tolerance is max-deviation of line from curve, in source units.
fr: 1 : La tolérance est l'écart maximal de la ligne par rapport à la courbe, en unités de source.

note: Tag: para
en: 2: Tolerance is max-angle, in radians, between generating radii.
fr: 2 : La tolérance est l'angle maximal, en radians, entre les rayons générateurs.

note: Tag: para
en: The 'flags' argument is a bitfield. 0 by default. Supported bits are:
fr: L'argument 'flags' est un champ de bits. 0 par défaut. Les bits supportés sont :

note: Tag: para
en: 1: Symmetric (orientation idependent) output.
fr: 1 : Sortie symétrique (indépendante de l'orientation).

note: Tag: para
en: 2: Retain angle, avoids reducing angles (segment lengths) when producing symmetric output. Has no effect when Symmetric flag is off.
fr: 2 : Conserver l'angle, évite de réduire les angles (longueur des segments) lors de la production d'une sortie symétrique. N'a aucun effet lorsque l'indicateur de symétrie est désactivé.

note: Tag: para
en: Availability: 1.3.0
fr: Disponibilité : 1.3.0

note: Tag: para
en: Enhanced: 2.4.0 added support for max-deviation and max-angle tolerance, and for symmetric output.
fr: Amélioration : 2.4.0 a ajouté la prise en charge de la tolérance de l'écart maximal et de l'angle maximal, ainsi que de la sortie symétrique.

note: Tag: para
en: Enhanced: 3.0.0 implemented a minimum number of segments per linearized arc to prevent topological collapse.
fr: Amélioration : la version 3.0.0 a mis en place un nombre minimum de segments par arc linéarisé afin d'éviter une rupture topologique.

note: Tag: refpurpose
en: Change start point of a closed LineString.
fr: Modifier le point de départ d'une LineString fermée.

note: Tag: para
en: Changes the start/end point of a closed LineString to the given vertex <parameter>point</parameter>.
fr: Modifie le point de départ/fin d'une LineString fermée en fonction du sommet <parameter>point</parameter> donné.

note: Tag: para
en: Make e closed line start at its 3rd vertex
fr: Faire partir une ligne fermée de son 3ème sommet

note: Tag: refpurpose
en: Returns a version of a geometry with X and Y axis flipped.
fr: Renvoie une version d'une géométrie dont les axes X et Y sont inversés.

note: Tag: para
en: Returns a version of the given geometry with X and Y axis flipped. Useful for fixing geometries which contain coordinates expressed as latitude/longitude (Y,X).
fr: Renvoie une version de la géométrie donnée avec les axes X et Y inversés. Utile pour fixer les géométries qui contiennent des coordonnées exprimées en latitude/longitude (Y,X).

note: Tag: title
en: Example
fr: Exemple

note: Tag: refpurpose
en: Force the geometries into a "2-dimensional mode".
fr: Forcer les géométries à passer en "mode bidimensionnel".

note: Tag: para
en: Forces the geometries into a "2-dimensional mode" so that all output representations will only have the X and Y coordinates. This is useful for force OGC-compliant output (since OGC only specifies 2-D geometries).
fr: Force les géométries à passer en "mode bidimensionnel", de sorte que toutes les représentations de sortie n'auront que les coordonnées X et Y. Ceci est utile pour forcer une sortie conforme à l'OGC (puisque l'OGC ne spécifie que des géométries à 2 dimensions).

note: Tag: para
en: Changed: 2.1.0. Up to 2.0.x this was called ST_Force_2D.
fr: Modifié : 2.1.0. Jusqu'à la version 2.0.x, elle s'appelait ST_Force_2D.

note: Tag: refpurpose
en: Force the geometries into XYZ mode. This is an alias for ST_Force3DZ.
fr: Force les géométries en mode XYZ. Il s'agit d'un alias de ST_Force3DZ.

note: Tag: para
en: Forces the geometries into XYZ mode. This is an alias for ST_Force3DZ. If a geometry has no Z component, then a <parameter>Zvalue</parameter> Z coordinate is tacked on.
fr: Force les géométries en mode XYZ. Il s'agit d'un alias de ST_Force3DZ. Si une géométrie n'a pas de composante Z, une <parameter>Zvalue</parameter> coordonnée Z est ajoutée.

note: Tag: para
en: Changed: 2.1.0. Up to 2.0.x this was called ST_Force_3D.
fr: Modifié : 2.1.0. Jusqu'à la version 2.0.x, elle s'appelait ST_Force_3D.

note: Tag: para
en: Changed: 3.1.0. Added support for supplying a non-zero Z value.
fr: Modifié : 3.1.0. Ajout de la prise en charge pour pouvoir passer une valeur Z non nulle.

note: Tag: refpurpose
en: Force the geometries into XYZ mode.
fr: Forcer les géométries en mode XYZ.

note: Tag: para
en: Forces the geometries into XYZ mode. If a geometry has no Z component, then a <parameter>Zvalue</parameter> Z coordinate is tacked on.
fr: Force les géométries à passer en mode XYZ. Si une géométrie n'a pas de composante Z, une <parameter>Zvalue</parameter> coordonnée Z est ajoutée.

note: Tag: para
en: Changed: 2.1.0. Up to 2.0.x this was called ST_Force_3DZ.
fr: Modifié : 2.1.0. Jusqu'à la version 2.0.x, elle s'appelait ST_Force_3DZ.

note: Tag: refpurpose
en: Force the geometries into XYM mode.
fr: Forcer les géométries en mode XYM.

note: Tag: para
en: Forces the geometries into XYM mode. If a geometry has no M component, then a <parameter>Mvalue</parameter> M coordinate is tacked on. If it has a Z component, then Z is removed
fr: Force les géométries à passer en mode XYM. Si une géométrie n'a pas de composante M, une <parameter>Mvalue</parameter> coordonnée M est ajoutée. Si la géométrie a une composante Z, la coordonnée Z est supprimée

note: Tag: para
en: Changed: 2.1.0. Up to 2.0.x this was called ST_Force_3DM.
fr: Modifié : 2.1.0. Jusqu'à la version 2.0.x, elle s'appelait ST_Force_3DM.

note: Tag: para
en: Changed: 3.1.0. Added support for supplying a non-zero M value.
fr: Modifié : 3.1.0. Ajout de la prise en charge de pouvoir passer une valeur M non nulle.

note: Tag: refpurpose
en: Force the geometries into XYZM mode.
fr: Forcer les géométries en mode XYZM.

note: Tag: para
en: Forces the geometries into XYZM mode. <parameter>Zvalue</parameter> and <parameter>Mvalue</parameter> is tacked on for missing Z and M dimensions, respectively.
fr: Force les géométries en mode XYZM. <parameter>Zvalue</parameter> et <parameter>Mvalue</parameter> sont ajoutés pour les dimensions Z et M manquantes, respectivement.

note: Tag: para
en: Changed: 2.1.0. Up to 2.0.x this was called ST_Force_4D.
fr: Modifié : 2.1.0. Jusqu'à la version 2.0.x, elle s'appelait ST_Force_4D.

note: Tag: para
en: Changed: 3.1.0. Added support for supplying non-zero Z and M values.
fr: Modifié : 3.1.0. Ajout de la prise en charge de pouvoir passer des valeurs Z et M non nulles.

note: Tag: refpurpose
en: Convert the geometry into a GEOMETRYCOLLECTION.
fr: Convertir la géométrie en une GEOMETRYCOLLECTION.

note: Tag: para
en: Converts the geometry into a GEOMETRYCOLLECTION. This is useful for simplifying the WKB representation.
fr: Convertit la géométrie en une GEOMETRYCOLLECTION. Ceci est utile pour simplifier la représentation WKB.

note: Tag: para
en: Availability: 1.2.2, prior to 1.3.4 this function will crash with Curves. This is fixed in 1.3.4+
fr: Disponibilité : 1.2.2, avant la version 1.3.4 cette fonction plante avec les courbes. Ceci est corrigé dans la version 1.3.4+

note: Tag: para
en: Changed: 2.1.0. Up to 2.0.x this was called ST_Force_Collection.
fr: Modifié : 2.1.0. Jusqu'à la version 2.0.x, cette fonction était appelée ST_Force_Collection.

note: Tag: refpurpose
en: Upcast a geometry into its curved type, if applicable.
fr: Retransformation d'une géométrie dans son type de courbure, le cas échéant.

note: Tag: para
en: Turns a geometry into its curved representation, if applicable: lines become compoundcurves, multilines become multicurves polygons become curvepolygons multipolygons become multisurfaces. If the geometry input is already a curved representation returns back same as input.
fr: Transforme une géométrie en sa représentation courbe, le cas échéant : les lignes deviennent des courbes composées, les multilignes deviennent des multicourbes, les polygones deviennent des polygones courbes, les multipolygones deviennent des multisurfaces. Si la géométrie en entrée est déjà une représentation courbe, le résultat est identique à celui de l'entrée.

note: Tag: refpurpose
en: Orients all exterior rings counter-clockwise and all interior rings clockwise.
fr: Oriente tous les anneaux extérieurs dans le sens inverse des aiguilles d'une montre et tous les anneaux intérieurs dans le sens des aiguilles d'une montre.

note: Tag: para
en: Forces (Multi)Polygons to use a counter-clockwise orientation for their exterior ring, and a clockwise orientation for their interior rings. Non-polygonal geometries are returned unchanged.
fr: Force les (Multi)Polygones à utiliser une orientation dans le sens inverse des aiguilles d'une montre pour leur anneau extérieur, et une orientation dans le sens des aiguilles d'une montre pour leurs anneaux intérieurs. Les géométries non polygonales sont renvoyées inchangées.

note: Tag: refpurpose
en: Orients all exterior rings clockwise and all interior rings counter-clockwise.
fr: Oriente tous les anneaux extérieurs dans le sens des aiguilles d'une montre et tous les anneaux intérieurs dans le sens inverse des aiguilles d'une montre.

note: Tag: para
en: Forces (Multi)Polygons to use a clockwise orientation for their exterior ring, and a counter-clockwise orientation for their interior rings. Non-polygonal geometries are returned unchanged.
fr: Force les (Multi)Polygones à utiliser une orientation dans le sens des aiguilles d'une montre pour leur anneau extérieur, et une orientation dans le sens inverse des aiguilles d'une montre pour leurs anneaux intérieurs. Les géométries non polygonales sont renvoyées inchangées.

note: Tag: refpurpose
en: Force the geometries to use SFS 1.1 geometry types only.
fr: Forcer les géométries à utiliser uniquement les types de géométrie SFS 1.1.

note: Tag: refpurpose
en: Force the orientation of the vertices in a polygon to follow the Right-Hand-Rule.
fr: Force l'orientation des sommets d'un polygone à suivre la règle de la main droite.

note: Tag: para
en: Forces the orientation of the vertices in a polygon to follow a Right-Hand-Rule, in which the area that is bounded by the polygon is to the right of the boundary. In particular, the exterior ring is orientated in a clockwise direction and the interior rings in a counter-clockwise direction. This function is a synonym for <xref linkend="ST_ForcePolygonCW"/>
fr: Force l'orientation des sommets d'un polygone à suivre la règle de la main droite, dans laquelle la zone délimitée par le polygone se trouve à droite de la limite. En particulier, l'anneau extérieur est orienté dans le sens des aiguilles d'une montre et les anneaux intérieurs dans le sens inverse. Cette fonction est synonyme de <xref linkend="ST_ForcePolygonCW"/>

note: Tag: para
en: The above definition of the Right-Hand-Rule conflicts with definitions used in other contexts. To avoid confusion, it is recommended to use ST_ForcePolygonCW.
fr: La définition ci-dessus de la règle de la main droite est en conflit avec des définitions utilisées dans d'autres contextes. Pour éviter toute confusion, il est recommandé d'utiliser ST_ForcePolygonCW.

note: Tag: refpurpose
en: Returns a line extended forwards and backwards by specified distances.
fr: Renvoie une ligne prolongée vers l'avant et vers l'arrière selon les distances spécifiées.

note: Tag: para
en: Returns a line extended forwards and backwards by adding new start (and end) points at the given distance(s). A distance of zero does not add a point. Only non-negative distances are allowed. The direction(s) of the added point(s) is determined by the first (and last) two distinct points of the line. Duplicate points are ignored.
fr: Renvoie une ligne prolongée vers l'avant et vers l'arrière en ajoutant de nouveaux points de départ (et d'arrivée) à la (aux) distance(s) donnée(s). Une distance de zéro n'ajoute pas de point. Seules les distances non négatives sont autorisées. La direction du ou des points ajoutés est déterminée par les deux premiers (et derniers) points distincts de la ligne. Les points en double sont ignorés.

note: Tag: title
en: Example: Extends a line 5 units forward and 6 units backward
fr: Exemple : Prolonge une ligne de 5 unités vers l'avant et de 6 unités vers l'arrière

note: Tag: refpurpose
en: Converts a linear geometry to a curved geometry.
fr: Convertit une géométrie linéaire en une géométrie courbe.

note: Tag: para
en: Converts plain LINESTRING/POLYGON to CIRCULAR STRINGs and Curved Polygons. Note much fewer points are needed to describe the curved equivalent.
fr: Convertit les lignes et polygones simples en lignes circulaires et polygones courbes. Notez qu'il faut beaucoup moins de points pour décrire l'équivalent courbe.

note: Tag: para
en: If the input LINESTRING/POLYGON is not curved enough to clearly represent a curve, the function will return the same input geometry.
fr: Si l'entrée LINESTRING/POLYGON n'est pas suffisamment courbée pour représenter clairement une courbe, la fonction renverra la même géométrie d'entrée.

note: Tag: refpurpose
en: Return the geometry as a MULTI* geometry.
fr: Renvoie la géométrie sous la forme d'une géométrie MULTI*.

note: Tag: para
en: Returns the geometry as a MULTI* geometry collection. If the geometry is already a collection, it is returned unchanged.
fr: Renvoie la géométrie sous la forme d'une collection de géométries MULTI*. Si la géométrie est déjà une collection, elle est renvoyée inchangée.

note: Tag: refpurpose
en: Return the geometry in its canonical form.
fr: Renvoie la géométrie sous sa forme canonique.

note: Tag: para
en: Returns the geometry in its normalized/canonical form. May reorder vertices in polygon rings, rings in a polygon, elements in a multi-geometry complex.
fr: Renvoie la géométrie sous sa forme normalisée/canonique. Peut réorganiser les sommets dans les anneaux de polygones, les anneaux dans un polygone, les éléments dans un complexe multi-géométrique.

note: Tag: para
en: Mostly only useful for testing purposes (comparing expected and obtained results).
fr: La plupart du temps, il n'est utile qu'à des fins de test (comparaison des résultats attendus et obtenus).

note: Tag: refpurpose
en: Returns a point projected from a start point by a distance and bearing (azimuth).
fr: Renvoie un point projeté à partir d'un point de départ en fonction d'une distance et d'un azimut.

note: Tag: para
en: Returns a point projected from a point along a geodesic using a given distance and azimuth (bearing). This is known as the direct geodesic problem.
fr: Renvoie un point projeté à partir d'un point le long d'une géodésique en utilisant une distance et un azimut donnés. C'est ce qu'on appelle le problème de la géodésique directe.

note: Tag: para
en: The two-point version uses the path from the first to the second point to implicitly define the azimuth and uses the distance as before.
fr: La version à deux points utilise la trajectoire entre le premier et le deuxième point pour définir implicitement l'azimut et utilise la distance comme précédemment.

note: Tag: para
en: The distance is given in meters. Negative values are supported.
fr: La distance est indiquée en mètres. Les valeurs négatives sont prises en charge.

note: Tag: para
en: The azimuth (also known as heading or bearing) is given in radians. It is measured clockwise from true north.
fr: L'azimut (également appelé cap ou relèvement) est indiqué en radians. Il est mesuré dans le sens des aiguilles d'une montre à partir du vrai nord.

note: Tag: para
en: North is azimuth zero (0 degrees)
fr: Le nord est l'azimut zéro (0 degré)

note: Tag: para
en: East is azimuth &#x03C0;/2 (90 degrees)
fr: L'est est l'azimut &#x03C0;/2 (90 degrés)

note: Tag: para
en: South is azimuth &#x03C0; (180 degrees)
fr: Le sud est l'azimut &#x03C0; (180 degrés)

note: Tag: para
en: West is azimuth 3&#x03C0;/2 (270 degrees)
fr: Ouest est l'azimut 3&#x03C0;/2 (270 degrés)

note: Tag: para
en: Negative azimuth values and values greater than 2&#x03C0; (360 degrees) are supported.
fr: Les valeurs d'azimut négatives et les valeurs supérieures à 2&#x03C0; (360 degrés) sont prises en charge.

note: Tag: para
en: Enhanced: 2.4.0 Allow negative distance and non-normalized azimuth.
fr: Amélioration : 2.4.0 Autorise les distances négatives et les azimuts non normalisés.

note: Tag: para
en: Enhanced: 3.4.0 Allow geometry arguments and two-point form omitting azimuth.
fr: Amélioration : 3.4.0 Autorise les arguments géométriques et la forme en deux points omettant l'azimut.

note: Tag: title
en: Example: Projected point at 100,000 meters and bearing 45 degrees
fr: Exemple : Point projeté à 100,000 mètres et relèvement de 45 degrés

note: Tag: para
en: , <xref linkend="ST_Distance"/>, <link xlink:href="http://www.postgresql.org/docs/current/interactive/functions-math.html">PostgreSQL function radians()</link>
fr: , <xref linkend="ST_Distance"/>, <link xlink:href="http://www.postgresql.org/docs/current/interactive/functions-math.html">Fonction PostgreSQL radians()</link>

note: Tag: refpurpose
en: Sets least significant bits of coordinates to zero
fr: Met à zéro les bits de poids faible des coordonnées

note: Tag: para
en: <code>ST_QuantizeCoordinates</code> determines the number of bits (<code>N</code>) required to represent a coordinate value with a specified number of digits after the decimal point, and then sets all but the <code>N</code> most significant bits to zero. The resulting coordinate value will still round to the original value, but will have improved compressiblity. This can result in a significant disk usage reduction provided that the geometry column is using a <link xlink:href="https://www.postgresql.org/docs/current/static/storage-toast.html#STORAGE-TOAST-ONDISK"> compressible storage type</link>. The function allows specification of a different number of digits after the decimal point in each dimension; unspecified dimensions are assumed to have the precision of the <code>x</code> dimension. Negative digits are interpreted to refer digits to the left of the decimal point, (i.e., <code>prec_x=-2</code> will preserve coordinate values to the nearest 100.
fr: <code>ST_QuantizeCoordinates</code> détermine le nombre de bits (<code>N</code>) requis pour représenter une valeur de coordonnées avec un nombre spécifié de chiffres après la virgule, puis met à zéro tous les bits sauf les <code>N</code> les plus significatifs. La valeur de coordonnées résultante sera toujours arrondie à la valeur d'origine, mais sa compressibilité sera améliorée. Il peut en résulter une réduction significative de l'utilisation du disque, à condition que la colonne géométrique utilise un <link xlink:href="https://www.postgresql.org/docs/current/static/storage-toast.html#STORAGE-TOAST-ONDISK"> type de stockage compressible</link>. La fonction permet de spécifier un nombre différent de chiffres après la virgule dans chaque dimension ; les dimensions non spécifiées sont supposées avoir la précision de la dimension <code>x</code>. Les chiffres négatifs sont interprétés comme des chiffres à gauche de la virgule (c'est-à-dire que <code>prec_x=-2</code> conservera les valeurs des coordonnées à la centaine la plus proche).

note: Tag: para
en: The coordinates produced by <code>ST_QuantizeCoordinates</code> are independent of the geometry that contains those coordinates and the relative position of those coordinates within the geometry. As a result, existing topological relationships between geometries are unaffected by use of this function. The function may produce invalid geometry when it is called with a number of digits lower than the intrinsic precision of the geometry.
fr: Les coordonnées produites par <code>ST_QuantizeCoordinates</code> sont indépendantes de la géométrie qui contient ces coordonnées et de la position relative de ces coordonnées dans la géométrie. Par conséquent, les relations topologiques existantes entre les géométries ne sont pas affectées par l'utilisation de cette fonction. La fonction peut produire une géométrie non valide lorsqu'elle est appelée avec un nombre de chiffres inférieur à la précision intrinsèque de la géométrie.

note: Tag: para
en: Availability: 2.5.0
fr: Disponibilité : 2.5.0

note: Tag: title
en: Technical Background
fr: Informations techniques

note: Tag: para
en: PostGIS stores all coordinate values as double-precision floating point integers, which can reliably represent 15 significant digits. However, PostGIS may be used to manage data that intrinsically has fewer than 15 significant digits. An example is TIGER data, which is provided as geographic coordinates with six digits of precision after the decimal point (thus requiring only nine significant digits of longitude and eight significant digits of latitude.)
fr: PostGIS stocke toutes les valeurs de coordonnées sous forme d'entiers à virgule flottante en double précision, qui peuvent représenter de manière fiable 15 chiffres significatifs. Cependant, PostGIS peut être utilisé pour gérer des données qui ont intrinsèquement moins de 15 chiffres significatifs. C'est le cas des données TIGER, qui sont fournies sous forme de coordonnées géographiques avec six chiffres de précision après la virgule (ce qui ne nécessite que neuf chiffres significatifs pour la longitude et huit chiffres significatifs pour la latitude)

note: Tag: para
en: When 15 significant digits are available, there are many possible representations of a number with 9 significant digits. A double precision floating point number uses 52 explicit bits to represent the significand (mantissa) of the coordinate. Only 30 bits are needed to represent a mantissa with 9 significant digits, leaving 22 insignificant bits; we can set their value to anything we like and still end up with a number that rounds to our input value. For example, the value 100.123456 can be represented by the floating point numbers closest to 100.123456000000, 100.123456000001, and 100.123456432199. All are equally valid, in that <code>ST_AsText(geom, 6)</code> will return the same result with any of these inputs. As we can set these bits to any value, <code>ST_QuantizeCoordinates</code> sets the 22 insignificant bits to zero. For a long coordinate sequence this creates a pattern of blocks of consecutive zeros that is compressed by PostgreSQL more efficiently.
fr: Lorsque 15 chiffres significatifs sont disponibles, il existe de nombreuses représentations possibles d'un nombre à 9 chiffres significatifs. Un nombre à virgule flottante en double précision utilise 52 bits explicites pour représenter le significand (mantissa) de la coordonnée. Seuls 30 bits sont nécessaires pour représenter un mantissa de 9 chiffres significatifs, ce qui laisse 22 bits non significatifs ; nous pouvons leur donner la valeur que nous voulons et obtenir un nombre qui s'arrondit à notre valeur d'entrée. Par exemple, la valeur 100,123456 peut être représentée par les nombres à virgule flottante les plus proches de 100,123456000000, 100,123456000001 et 100,123456432199. Tous sont également valables, en ce sens que <code>ST_AsText(geom, 6)</code> renverra le même résultat avec n'importe laquelle de ces entrées. Comme nous pouvons fixer ces bits à n'importe quelle valeur, <code>ST_QuantizeCoordinates</code> fixe les 22 bits non significatifs à zéro. Pour une longue séquence de coordonnées, cela crée un motif de blocs de zéros consécutifs qui est compressé par PostgreSQL de manière plus efficace.

note: Tag: para
en: Only the on-disk size of the geometry is potentially affected by <code>ST_QuantizeCoordinates</code>. <xref linkend="ST_MemSize"/>, which reports the in-memory usage of the geometry, will return the the same value regardless of the disk space used by a geometry.
fr: Seule la taille sur disque de la géométrie est potentiellement affectée par <code>ST_QuantizeCoordinates</code>. <xref linkend="ST_MemSize"/>, qui indique l'utilisation en mémoire de la géométrie, renverra la même valeur quel que soit l'espace disque utilisé par une géométrie.

note: Tag: refpurpose
en: Remove a point from a linestring.
fr: Supprime un point d'une ligne.

note: Tag: para
en: Removes a point from a LineString, given its index (0-based). Useful for turning a closed line (ring) into an open linestring.
fr: Supprime un point d'une LineString, en fonction de son index (basé sur 0). Utile pour transformer une ligne fermée (anneau) en une ligne ouverte.

note: Tag: para
en: Enhanced: 3.2.0
fr: Amélioration : 3.2.0

note: Tag: para
en: Guarantees no lines are closed by removing the end point of closed lines (rings). Assumes geom is of type LINESTRING
fr: Garantit qu'aucune ligne n'est fermée en supprimant le point final des lignes fermées (anneaux). Suppose que geom est de type LINESTRING

note: Tag: refpurpose
en: Returns a version of a geometry with duplicate points removed.
fr: Renvoie une version d'une géométrie dont les points en double ont été supprimés.

note: Tag: para
en: Returns a version of the given geometry with duplicate consecutive points removed. The function processes only (Multi)LineStrings, (Multi)Polygons and MultiPoints but it can be called with any kind of geometry. Elements of GeometryCollections are processed individually. The endpoints of LineStrings are preserved.
fr: Renvoie une version de la géométrie donnée dont les points consécutifs en double ont été supprimés. La fonction ne traite que les (Multi)LineStrings, les (Multi)Polygons et les MultiPoints, mais elle peut être appelée avec n'importe quel type de géométrie. Les éléments des collections de géométries sont traités individuellement. Les extrémités des lignes sont préservées.

note: Tag: para
en: If the <parameter>tolerance</parameter> parameter is provided, vertices within the tolerance distance of one another are considered to be duplicates.
fr: Si le paramètre <parameter>tolérance</parameter> est fourni, les sommets situés dans la distance de tolérance les uns des autres sont considérés comme des doublons.

note: Tag: para
en: <emphasis role="bold">Example:</emphasis> Collection elements are processed individually.
fr: <emphasis role="bold">Exemple:</emphasis> Les éléments de la collection sont traités individuellement.

note: Tag: para
en: <emphasis role="bold">Example:</emphasis> Repeated point removal with a distance tolerance.
fr: <emphasis role="bold">Exemple:</emphasis> Suppression répété de points avec une tolérance de distance.

note: Tag: refpurpose
en: Return the geometry with vertex order reversed.
fr: Retourne la géométrie avec l'ordre des sommets inversé.

note: Tag: para
en: Can be used on any geometry and reverses the order of the vertices.
fr: Peut être utilisé sur n'importe quelle géométrie et inverse l'ordre des sommets.

note: Tag: para
en: Enhanced: 2.4.0 support for curves was introduced.
fr: Amélioration : la prise en charge des courbes a été introduite dans la version 2.4.0.

note: Tag: refpurpose
en: Returns a modified geometry/geography having no segment longer than a given distance.
fr: Renvoie une geometry/geography modifiée dont aucun segment ne dépasse une distance donnée.

note: Tag: para
en: Returns a modified geometry/geography having no segment longer than <varname>max_segment_length</varname>. Length is computed in 2D. Segments are always split into equal-length subsegments.
fr: Renvoie une geometry/geography modifiée dont aucun segment n'est plus long que <varname>max_segment_length</varname>. La longueur est calculée en 2D. Les segments sont toujours divisés en sous-segments de même longueur.

note: Tag: para
en: For geometry, the maximum length is in the units of the spatial reference system.
fr: Pour la géométrie, la longueur maximale est exprimée dans les unités du système de référence spatiale.

note: Tag: para
en: For geography, the maximum length is in meters. Distances are computed on the sphere. Added vertices are created along the spherical great-circle arcs defined by segment endpoints.
fr: En géographie, la longueur maximale est exprimée en mètres. Les distances sont calculées sur la sphère. Les sommets ajoutés sont créés le long des arcs de grands cercles sphériques définis par les extrémités des segments.

note: Tag: para
en: This only shortens long segments. It does not lengthen segments shorter than the maximum length.
fr: Cette opération ne fait que raccourcir les segments longs. Elle n'allonge pas les segments plus courts que la longueur maximale.

note: Tag: para
en: For inputs containing long segments, specifying a relatively short <varname>max_segment_length</varname> can cause a very large number of vertices to be added. This can happen unintentionally if the argument is specified accidentally as a number of segments, rather than a maximum length.
fr: Pour les entrées contenant de longs segments, la spécification d'un <varname>max_segment_length</varname> relativement court peut entraîner l'ajout d'un très grand nombre de sommets. Cela peut se produire involontairement si l'argument est spécifié accidentellement comme un nombre de segments, plutôt que comme une longueur maximale.

note: Tag: para
en: Enhanced: 3.0.0 Segmentize geometry now produces equal-length subsegments
fr: Amélioration : 3.0.0 La segmentation de géométrie produit désormais des sous-segments de longueur égale

note: Tag: para
en: Enhanced: 2.3.0 Segmentize geography now produces equal-length subsegments
fr: Amélioration : 2.3.0 La segmentation d'objets geography produit désormais des sous-segments de longueur égale

note: Tag: para
en: Enhanced: 2.1.0 support for geography was introduced.
fr: Amélioration : la prise en charge des objets de type geography a été introduite dans la version 2.1.0.

note: Tag: para
en: Changed: 2.1.0 As a result of the introduction of geography support, the usage <code>ST_Segmentize('LINESTRING(1 2, 3 4)', 0.5)</code> causes an ambiguous function error. The input needs to be properly typed as a geometry or geography. Use ST_GeomFromText, ST_GeogFromText or a cast to the required type (e.g. <code>ST_Segmentize('LINESTRING(1 2, 3 4)'::geometry, 0.5) )</code>
fr: Modifié : 2.1.0 Suite à l'introduction de la prise en charge du type geography, l'utilisation <code>ST_Segmentize('LINESTRING(1 2, 3 4)', 0.5)</code> provoque une erreur de fonction ambiguë. L'entrée doit être correctement typée en tant que geometry ou geography. Utilisez ST_GeomFromText, ST_GeogFromText ou un cast vers le type requis (par exemple, <code>ST_Segmentize('LINESTRING(1 2, 3 4)'::geometry, 0.5) )</code>

note: Tag: para
en: Segmentizing a line. Long segments are split evenly, and short segments are not split.
fr: La segmentation d'une ligne. Les segments longs sont divisés de manière égale et les segments courts ne sont pas divisés.

note: Tag: para
en: Segmentizing a polygon:
fr: Segmentation d'un polygone :

note: Tag: para
en: Segmentizing a geographic line, using a maximum segment length of 2000 kilometers. Vertices are added along the great-circle arc connecting the endpoints.
fr: Segmentation d'une ligne géographique, en utilisant une longueur de segment maximale de 2000 kilomètres. Les sommets sont ajoutés le long de l'arc de grand cercle reliant les points d'extrémité.

note: Tag: para
en: A geographic line segmentized along a great circle arc
fr: Une ligne géographique segmentée le long d'un arc de grand cercle

note: Tag: refpurpose
en: Replace point of a linestring with a given point.
fr: Remplacer le point d'une ligne par un point donné.

note: Tag: para
en: Replace point N of linestring with given point. Index is 0-based.Negative index are counted backwards, so that -1 is last point. This is especially useful in triggers when trying to maintain relationship of joints when one vertex moves.
fr: Remplace le point N de la ligne par le point donné. L'index est basé sur 0. Les index négatifs sont comptés à rebours, de sorte que -1 est le dernier point. Cette fonction est particulièrement utile dans les triggers lorsqu'il s'agit de maintenir la relation entre les articulations lorsqu'un sommet se déplace.

note: Tag: para
en: Updated 2.3.0 : negative indexing
fr: Mise à jour 2.3.0 : indexation négative

note: Tag: refpurpose
en: Shifts the longitude coordinates of a geometry between -180..180 and 0..360.
fr: Décale les coordonnées de longitude d'une géométrie entre -180..180 et 0..360.

note: Tag: para
en: Reads every point/vertex in a geometry, and shifts its longitude coordinate from -180..0 to 180..360 and vice versa if between these ranges. This function is symmetrical so the result is a 0..360 representation of a -180..180 data and a -180..180 representation of a 0..360 data.
fr: Lit chaque point/vertex d'une géométrie et déplace sa coordonnée de longitude de -180..0 à 180..360 et vice versa si elle se trouve entre ces plages. Cette fonction est symétrique, de sorte que le résultat est une représentation 0..360 d'une donnée -180..180 et une représentation -180..180 d'une donnée 0..360.

note: Tag: para
en: This is only useful for data with coordinates in longitude/latitude; e.g. SRID 4326 (WGS 84 geographic)
fr: Ceci n'est utile que pour les données dont les coordonnées sont exprimées en longitude/latitude ; par exemple, SRID 4326 (WGS 84 géographique)

note: Tag: para
en: Pre-1.3.4 bug prevented this from working for MULTIPOINT. 1.3.4+ works with MULTIPOINT as well.
fr: Un bug antérieur à la version 1.3.4 empêchait le fonctionnement pour MULTIPOINT. La version 1.3.4+ fonctionne également avec MULTIPOINT.

note: Tag: para
en: Enhanced: 2.0.0 support for Polyhedral surfaces and TIN was introduced.
fr: Amélioration : 2.0.0 introduction du support TIN et surfaces polyédriques.

note: Tag: para
en: NOTE: this function was renamed from "ST_Shift_Longitude" in 2.2.0
fr: NOTE : cette fonction a été renommée "ST_Shift_Longitude" dans la version 2.2.0

note: Tag: refpurpose
en: Wrap a geometry around an X value.
fr: Enveloppe une géométrie autour d'une valeur X.

note: Tag: para
en: This function splits the input geometries and then moves every resulting component falling on the right (for negative 'move') or on the left (for positive 'move') of given 'wrap' line in the direction specified by the 'move' parameter, finally re-unioning the pieces together.
fr: Cette fonction divise les géométries d'entrée et déplace ensuite chaque composant résultant tombant à droite (pour un "move" négatif) ou à gauche (pour un "move" positif) de la ligne "wrap" donnée dans la direction spécifiée par le paramètre "move", pour finalement réassembler les morceaux.

note: Tag: para
en: This is useful to "recenter" long-lat input to have features of interest not spawned from one side to the other.
fr: Cette fonction est utile pour "recentrer" les données à long terme afin que les caractéristiques intéressantes ne soient pas produites d'un côté à l'autre.

note: Tag: para
en: Availability: 2.3.0 requires GEOS
fr: Disponibilité : 2.3.0 nécessite GEOS

note: Tag: refpurpose
en: Snap all points of the input geometry to a regular grid.
fr: Accrocher tous les points de la géométrie d'entrée à une grille régulière.

note: Tag: para
en: Variant 1,2,3: Snap all points of the input geometry to the grid defined by its origin and cell size. Remove consecutive points falling on the same cell, eventually returning NULL if output points are not enough to define a geometry of the given type. Collapsed geometries in a collection are stripped from it. Useful for reducing precision.
fr: Variante 1,2,3 : Accrocher tous les points de la géométrie d'entrée à la grille définie par l'origine et la taille des cellules. Supprime les points consécutifs tombant sur la même cellule, et renvoie éventuellement NULL si les points de sortie ne sont pas suffisants pour définir une géométrie du type donné. Les géométries écrasées d'une collection sont supprimées de celle-ci. Utile pour réduire la précision.

note: Tag: para
en: Variant 4: Introduced 1.1.0 - Snap all points of the input geometry to the grid defined by its origin (the second argument, must be a point) and cell sizes. Specify 0 as size for any dimension you don't want to snap to a grid.
fr: Variante 4 : Introduite dans la version 1.1.0 - Accroche tous les points de la géométrie d'entrée à la grille définie par son origine (le deuxième argument doit être un point) et la taille des cellules. Spécifiez 0 comme taille pour toute dimension que vous ne voulez pas accrocher à une grille.

note: Tag: para
en: The returned geometry might lose its simplicity (see <xref linkend="ST_IsSimple"/>).
fr: La géométrie renvoyée peut perdre sa simplicité (voir <xref linkend="ST_IsSimple"/>).

note: Tag: para
en: Before release 1.1.0 this function always returned a 2d geometry. Starting at 1.1.0 the returned geometry will have same dimensionality as the input one with higher dimension values untouched. Use the version taking a second geometry argument to define all grid dimensions.
fr: Avant la version 1.1.0, cette fonction renvoyait toujours une géométrie 2D. A partir de la version 1.1.0, la géométrie renvoyée aura la même dimensionnalité que la géométrie d'entrée, les valeurs de dimensions supérieures n'étant pas modifiées. Utilisez la version prenant un second argument géométrique pour définir toutes les dimensions de la grille.

note: Tag: para
en: Availability: 1.0.0RC1
fr: Disponibilité : 1.0.0RC1

note: Tag: para
en: Availability: 1.1.0 - Z and M support
fr: Disponibilité : 1.1.0 - Prise en charge des Z et M

note: Tag: refpurpose
en: Snap segments and vertices of input geometry to vertices of a reference geometry.
fr: Accrocher les segments et les sommets de la géométrie d'entrée aux sommets d'une géométrie de référence.

note: Tag: para
en: Snaps the vertices and segments of a geometry to another Geometry's vertices. A snap distance tolerance is used to control where snapping is performed. The result geometry is the input geometry with the vertices snapped. If no snapping occurs then the input geometry is returned unchanged.
fr: Accroche les sommets et les segments d'une géométrie aux sommets d'une autre géométrie. Une tolérance de distance d'accrochage est utilisée pour contrôler l'endroit où l'accrochage est effectué. La géométrie résultante est la géométrie d'entrée avec les sommets accrochés. Si aucun accrochage n'a lieu, la géométrie d'entrée est renvoyée inchangée.

note: Tag: para
en: Snapping one geometry to another can improve robustness for overlay operations by eliminating nearly-coincident edges (which cause problems during noding and intersection calculation).
fr: L'accrochage d'une géométrie à une autre peut améliorer la robustesse des opérations de superposition en éliminant les arêtes presque coïncidentes (qui posent des problèmes lors du noding et du calcul de l'intersection).

note: Tag: para
en: Too much snapping can result in invalid topology being created, so the number and location of snapped vertices is decided using heuristics to determine when it is safe to snap. This can result in some potential snaps being omitted, however.
fr: Un accrochage trop important peut entraîner la création d'une topologie non valide, c'est pourquoi le nombre et l'emplacement des sommets accrochés sont décidés à l'aide d'une heuristique pour déterminer quand il est sûr d'accrocher. Cela peut toutefois entraîner l'omission de certains accrochages potentiels.

note: Tag: para
en: The returned geometry might lose its simplicity (see <xref linkend="ST_IsSimple"/>) and validity (see <xref linkend="ST_IsValid"/>).
fr: La géométrie renvoyée peut perdre sa simplicité (voir <xref linkend="ST_IsSimple"/>) et sa validité (voir <xref linkend="ST_IsValid"/>).

note: Tag: para
en: A multipolygon shown with a linestring (before any snapping)
fr: Un multipolygone représenté par une ligne (avant tout accrochage)

note: Tag: para
en: A multipolygon snapped to linestring to tolerance: 1.01 of distance. The new multipolygon is shown with reference linestring
fr: Un multipolygone est accroché à une ligne de référence avec une tolérance de 1,01 de la distance. Le nouveau multipolygone est représenté avec la ligne de référence

note: Tag: para
en: A multipolygon snapped to linestring to tolerance: 1.25 of distance. The new multipolygon is shown with reference linestring
fr: Un multipolygone est accroché à une ligne de référence avec une tolérance de 1,25 de la distance. Le nouveau multipolygone est représenté avec la ligne de référence

note: Tag: para
en: The linestring snapped to the original multipolygon at tolerance 1.01 of distance. The new linestring is shown with reference multipolygon
fr: La ligne s'est accrochée au multipolygone d'origine avec une tolérance de 1,01 de la distance. La nouvelle ligne est représentée avec le multipolygone de référence

note: Tag: para
en: The linestring snapped to the original multipolygon at tolerance 1.25 of distance. The new linestring is shown with reference multipolygon
fr: La ligne s'est accrochée au multipolygone d'origine avec une tolérance de 1,25 de la distance. La nouvelle ligne est représentée avec le multipolygone de référence

note: Tag: refpurpose
en: Returns a version of the given geometry with given ordinate values swapped.
fr: Renvoie une version de la géométrie donnée avec les valeurs d'ordonnées permutées.

note: Tag: para
en: Returns a version of the given geometry with given ordinates swapped.
fr: Renvoie une version de la géométrie donnée dont les ordonnées ont été interverties.

note: Tag: para
en: The <varname>ords</varname> parameter is a 2-characters string naming the ordinates to swap. Valid names are: x,y,z and m.
fr: Le paramètre <varname>ords</varname> est une chaîne de 2 caractères désignant les ordonnées à permuter. Les noms valides sont : x, y, z et m.

note: Tag: title
en: Exceptional Functions
fr: Fonctions particulières

note: Tag: para
en: These functions are rarely used functions that should only be used if your data is corrupted in someway. They are used for troubleshooting corruption and also fixing things that should under normal circumstances, never happen.
fr: Ces fonctions sont rarement utilisées et ne devraient être employées que si vos données sont corrompues d'une manière ou d'une autre. Elles sont utilisées pour vérifier les corruptions de données et réparer des choses qui ne devraient jamais arriver dans des circonstances normales.

note: Tag: refpurpose
en: Add bounding box to the geometry.
fr: Ajoute une bounding box à la géométrie.

note: Tag: para
en: Add bounding box to the geometry. This would make bounding box based queries faster, but will increase the size of the geometry.
fr: Ajouter une boîte de délimitation à la géométrie. Cela rendrait les requêtes basées sur la boîte de délimitation plus rapides, mais augmenterait la taille de la géométrie.

note: Tag: para
en: Bounding boxes are automatically added to geometries so in general this is not needed unless the generated bounding box somehow becomes corrupted or you have an old install that is lacking bounding boxes. Then you need to drop the old and re-add.
fr: Les boîtes de délimitation sont automatiquement ajoutées aux géométries, de sorte qu'en général, cela n'est pas nécessaire, à moins que la boîte de délimitation générée ne soit corrompue d'une manière ou d'une autre ou que vous ayez une ancienne installation qui ne contient pas les boîtes de délimitation. Dans ce cas, vous devez supprimer l'ancienne et ajouter la nouvelle.

note: Tag: refpurpose
en: Drop the bounding box cache from the geometry.
fr: Supprime le cache de la boîte de délimitation de la géométrie.

note: Tag: para
en: Drop the bounding box cache from the geometry. This reduces geometry size, but makes bounding-box based queries slower. It is also used to drop a corrupt bounding box. A tale-tell sign of a corrupt cached bounding box is when your ST_Intersects and other relation queries leave out geometries that rightfully should return true.
fr: Supprime le cache de la boîte de délimitation de la géométrie. Cela réduit la taille de la géométrie, mais rend les requêtes basées sur les boîtes de délimitation plus lentes. Elle est également utilisée pour supprimer une boîte de délimitation corrompue. Un signe révélateur d'une boîte de délimitation corrompue dans le cache est lorsque vos ST_Intersects et autres requêtes de relations laissent de côté des géométries qui devraient légitimement renvoyer un résultat vrai.

note: Tag: para
en: Bounding boxes are automatically added to geometries and improve speed of queries so in general this is not needed unless the generated bounding box somehow becomes corrupted or you have an old install that is lacking bounding boxes. Then you need to drop the old and re-add. This kind of corruption has been observed in 8.3-8.3.6 series whereby cached bboxes were not always recalculated when a geometry changed and upgrading to a newer version without a dump reload will not correct already corrupted boxes. So one can manually correct using below and re-add the bbox or do a dump reload.
fr: Les boîtes de délimitation sont automatiquement ajoutées aux géométries et améliorent la vitesse des requêtes. En général, cela n'est donc pas nécessaire, sauf si le boîte de délimitation générée est corrompue d'une manière ou d'une autre ou si vous avez une ancienne installation qui ne contient pas de boîtes de délimitation. Dans ce cas, il est nécessaire de supprimer l'ancienne installation et de la remplacer par une nouvelle. Ce type de corruption a été observé dans les séries 8.3-8.3.6 où les bboxes mises en cache n'étaient pas toujours recalculées lorsqu'une géométrie changeait et lors des mises à jour vers une version plus récente où le dump non rechargé ne corrigeait pas les bboxes déjà corrompues. La mise à jour vers une version plus récente sans rechargement du dump ne corrigera pas les boîtes déjà corrompues. Il est donc possible de corriger manuellement en utilisant la méthode ci-dessous et de lire la bbox ou de recharger le dump.

note: Tag: refpurpose
en: Returns TRUE if the bbox of this geometry is cached, FALSE otherwise.
fr: Renvoie TRUE si la bbox de cette géométrie est en cache, sinon FALSE.

note: Tag: para
en: Returns TRUE if the bbox of this geometry is cached, FALSE otherwise. Use <xref linkend="PostGIS_AddBBox"/> and <xref linkend="PostGIS_DropBBox"/> to control caching.
fr: Renvoie TRUE si la boîte de délimitation de cette géométrie est mise en cache, FALSE dans le cas contraire. Utilisez <xref linkend="PostGIS_AddBBox"/> et <xref linkend="PostGIS_DropBBox"/> pour contrôler la mise en cache.

note: Tag: title
en: Grand Unified Custom Variables (GUCs)
fr: Variables PostGIS GUC (Grand Unified Custom Variables)

note: Tag: para
en: This section lists custom PostGIS Grand Unified Custom Variables (GUC). These can be set globally, by database, by session or by transaction. Best set at global or database level.
fr: Cette section liste les variables globales spécifiques de PostGIS appelées GUC : Grand Unified Custom Variables. Elles peuvent être réglées globalement, par base de données, par session ou par transaction. Il est préférable de les régler au niveau global ou au niveau de la base de donnée.

note: Tag: refpurpose
en: The backend to service a function where GEOS and SFCGAL overlap. Options: geos or sfcgal. Defaults to geos.
fr: Le backend qui sera utilisé par les fonctions lorsque GEOS et SFCGAL se recouvrent. Options : geos ou sfcgal. Valeur par défaut geos.

note: Tag: para
en: This GUC is only relevant if you compiled PostGIS with sfcgal support. By default <varname>geos</varname> backend is used for functions where both GEOS and SFCGAL have the same named function. This variable allows you to override and make sfcgal the backend to service the request.
fr: Cette GUC n'a de sens que si vous avez compilé PostGIS avec le support SFCGAL. Par défaut le backend <varname>geos</varname> est utilisé pour les fonctions proposées à la fois par GEOS et SFCGAL (même nom). Cette variable permet de surcharger la valeur par défaut et d'utiliser sfcgal comme backend pour effectuer la requête.

note: Tag: para
en: Sets backend just for life of connection
fr: Régler le backend juste pour le temps de la connexion

note: Tag: para
en: Sets backend for new connections to database
fr: Régler le backend pour les nouvelles connexions à une base de données

note: Tag: refpurpose
en: A configuration option to assign the value of GDAL's GDAL_DATA option. If not set, the environmentally set GDAL_DATA variable is used.
fr: Une option de configuration pour régler la valeur de l'option GDAL_DATA de GDAL. Si elle n'est pas assignée, la valeur de la variable d'environnement GDAL_DATA est utilisée.

note: Tag: para
en: A PostgreSQL GUC variable for setting the value of GDAL's GDAL_DATA option. The <varname>postgis.gdal_datapath</varname> value should be the complete physical path to GDAL's data files.
fr: Une variable GUC PostgreSQL pour régler la valeur de l'option GDAL_DATA de GDAL. La valeur <varname>postgis.gdal_datapath</varname> devrait être le chemin physique complet vers les fichiers de données de GDAL.

note: Tag: para
en: This configuration option is of most use for Windows platforms where GDAL's data files path is not hard-coded. This option should also be set when GDAL's data files are not located in GDAL's expected path.
fr: Cette option de configuration est principalement destinée aux plateformes Windows où le chemin des fichiers de données de GDAL n'est pas codé en dur. Cette option devrait aussi être réglée lorsque les fichiers de données GDAL ne sont pas situés dans le chemin attendu par GDAL.

note: Tag: para
en: This option can be set in PostgreSQL's configuration file postgresql.conf. It can also be set by connection or transaction.
fr: Cette option peut être réglée dans le fichier de configuration postgresql.conf de PostgreSQL. Elle peut aussi être réglée par connexion ou par transaction.

note: Tag: para
en: Additional information about GDAL_DATA is available at GDAL's <link xlink:href="http://trac.osgeo.org/gdal/wiki/ConfigOptions">Configuration Options</link>.
fr: Des informations complémentaires sur GDAL_DATA sont disponibles dans la description des <link xlink:href="http://trac.osgeo.org/gdal/wiki/ConfigOptions">Options de configuration</link>.

note: Tag: para
en: Set and reset <varname>postgis.gdal_datapath</varname>
fr: Régler et remettre à la valeur par défaut <varname>postgis.gdal_datapath</varname>

note: Tag: para
en: Setting on windows for a particular database
fr: Réglage pour une base de données spécifique, sous Windows

note: Tag: refpurpose
en: A configuration option to set the enabled GDAL drivers in the PostGIS environment. Affects the GDAL configuration variable GDAL_SKIP.
fr: Option de configuration permettant de définir les drivers GDAL activés dans l'environnement PostGIS. Affecte la variable de configuration GDAL GDAL_SKIP.

note: Tag: para
en: A configuration option to set the enabled GDAL drivers in the PostGIS environment. Affects the GDAL configuration variable GDAL_SKIP. This option can be set in PostgreSQL's configuration file: postgresql.conf. It can also be set by connection or transaction.
fr: Option de configuration permettant de définir les drivers GDAL activés dans l'environnement PostGIS. Affecte la variable de configuration GDAL GDAL_SKIP. Cette option peut être définie dans le fichier de configuration de PostgreSQL : postgresql.conf. Elle peut également être définie par connexion ou transaction.

note: Tag: para
en: The initial value of <varname>postgis.gdal_enabled_drivers</varname> may also be set by passing the environment variable <varname>POSTGIS_GDAL_ENABLED_DRIVERS</varname> with the list of enabled drivers to the process starting PostgreSQL.
fr: La valeur initiale de <varname>postgis.gdal_enabled_drivers</varname> peut aussi être définie en passant la variable d'environnement <varname>POSTGIS_GDAL_ENABLED_DRIVERS</varname> avec la liste des drivers activés au processus de démarrage de PostgreSQL.

note: Tag: para
en: Enabled GDAL specified drivers can be specified by the driver's short-name or code. Driver short-names or codes can be found at <link xlink:href="http://www.gdal.org/formats_list.html">GDAL Raster Formats</link>. Multiple drivers can be specified by putting a space between each driver.
fr: Les drivers GDAL activés peuvent être spécifiés par leur nom abrégé ou leur code. Les noms courts ou les codes des drivers sont disponibles sur <link xlink:href="http://www.gdal.org/formats_list.html">GDAL Raster Formats</link>. Il est possible de spécifier plusieurs drivers en insérant un espace entre chacun d'eux.

note: Tag: para
en: There are three special codes available for <varname>postgis.gdal_enabled_drivers</varname>. The codes are case-sensitive.
fr: Trois codes spéciaux sont disponibles pour <varname>postgis.gdal_enabled_drivers</varname>. Les codes sont sensibles à la casse.

note: Tag: para
en: <varname>DISABLE_ALL</varname> disables all GDAL drivers. If present, <varname>DISABLE_ALL</varname> overrides all other values in <varname>postgis.gdal_enabled_drivers</varname>.
fr: <varname>DISABLE_ALL</varname> désactive tous les drivers GDAL. S'il est présent, <varname>DISABLE_ALL</varname> remplace toutes les autres valeurs de <varname>postgis.gdal_enabled_drivers</varname>.

note: Tag: para
en: <varname>ENABLE_ALL</varname> enables all GDAL drivers.
fr: <varname>ENABLE_ALL</varname> active tous les drivers GDAL.

note: Tag: para
en: <varname>VSICURL</varname> enables GDAL's <varname>/vsicurl/</varname> virtual file system.
fr: <varname>VSICURL</varname> active le système de fichiers virtuels <varname>/vsicurl/</varname> de GDAL.

note: Tag: para
en: When <varname>postgis.gdal_enabled_drivers</varname> is set to DISABLE_ALL, attempts to use out-db rasters, ST_FromGDALRaster(), ST_AsGDALRaster(), ST_AsTIFF(), ST_AsJPEG() and ST_AsPNG() will result in error messages.
fr: Lorsque <varname>postgis.gdal_enabled_drivers</varname> est défini sur DISABLE_ALL, les tentatives d'utilisation des rasters out-db, ST_FromGDALRaster(), ST_AsGDALRaster(), ST_AsTIFF(), ST_AsJPEG() et ST_AsPNG() se traduisent par des messages d'erreur.

note: Tag: para
en: In the standard PostGIS installation, <varname>postgis.gdal_enabled_drivers</varname> is set to DISABLE_ALL.
fr: Dans l'installation standard de PostGIS, <varname>postgis.gdal_enabled_drivers</varname> est défini sur DISABLE_ALL.

note: Tag: para
en: Additional information about GDAL_SKIP is available at GDAL's <link xlink:href="http://trac.osgeo.org/gdal/wiki/ConfigOptions">Configuration Options</link>.
fr: Des informations supplémentaires sur GDAL_SKIP sont disponibles sur le site GDAL <link xlink:href="http://trac.osgeo.org/gdal/wiki/ConfigOptions">Configuration Options</link>.

note: Tag: para
en: Set and reset <varname>postgis.gdal_enabled_drivers</varname>
fr: Définir et réinitialiser <varname>postgis.gdal_enabled_drivers</varname>

note: Tag: para
en: Sets backend for all new connections to database
fr: Définit le backend pour toutes les nouvelles connexions à la base de données

note: Tag: para
en: Sets default enabled drivers for all new connections to server. Requires super user access and PostgreSQL 9.4+. Also note that database, session, and user settings override this.
fr: Définit les drivers activés par défaut pour toutes les nouvelles connexions au serveur. Nécessite un accès super utilisateur et PostgreSQL 9.4+. Notez également que les paramètres de la base de données, de la session et de l'utilisateur sont prioritaires.

note: Tag: para
en: Enable all GDAL Drivers
fr: Activer tous les drivers GDAL

note: Tag: para
en: Disable all GDAL Drivers
fr: Désactiver tous les drivers GDAL

note: Tag: refpurpose
en: A boolean configuration option to enable access to out-db raster bands.
fr: Une option de configuration booléenne pour permettre l'accès aux bandes matricielles de out-db.

note: Tag: para
en: A boolean configuration option to enable access to out-db raster bands. This option can be set in PostgreSQL's configuration file: postgresql.conf. It can also be set by connection or transaction.
fr: Une option de configuration booléenne pour permettre l'accès aux bandes matricielles de out-db. Cette option peut être définie dans le fichier de configuration de PostgreSQL : postgresql.conf. Elle peut également être définie par connexion ou transaction.

note: Tag: para
en: The initial value of <varname>postgis.enable_outdb_rasters</varname> may also be set by passing the environment variable <varname>POSTGIS_ENABLE_OUTDB_RASTERS</varname> with a non-zero value to the process starting PostgreSQL.
fr: La valeur initiale de <varname>postgis.enable_outdb_rasters</varname> peut également être définie en passant la variable d'environnement <varname>POSTGIS_ENABLE_OUTDB_RASTERS</varname> avec une valeur non nulle au processus de démarrage de PostgreSQL.

note: Tag: para
en: Even if <varname>postgis.enable_outdb_rasters</varname> is True, the GUC <varname>postgis.gdal_enabled_drivers</varname> determines the accessible raster formats.
fr: Même si <varname>postgis.enable_outdb_rasters</varname> est True, le GUC <varname>postgis.gdal_enabled_drivers</varname> détermine les formats raster accessibles.

note: Tag: para
en: In the standard PostGIS installation, <varname>postgis.enable_outdb_rasters</varname> is set to False.
fr: Dans l'installation standard de PostGIS, <varname>postgis.enable_outdb_rasters</varname> est défini sur False.

note: Tag: para
en: Set and reset <varname>postgis.enable_outdb_rasters</varname> for current session
fr: Définir et réinitialiser <varname>postgis.enable_outdb_rasters</varname> pour la session actuelle

note: Tag: para
en: Set for specific database
fr: Défini pour une base de données spécifique

note: Tag: para
en: Setting for whole database cluster. You need to reconnect to the database for changes to take effect.
fr: Paramètres pour l'ensemble du cluster de bases de données. Vous devez vous reconnecter à la base de données pour que les modifications soient prises en compte.

note: Tag: refpurpose
en: A string configuration to set options used when working with an out-db raster.
fr: Une chaîne de configuration pour définir les options utilisées lors de l'utilisation d'un raster out-db.

note: Tag: para
en: A string configuration to set options used when working with an out-db raster. <link xlink:href="http://trac.osgeo.org/gdal/wiki/ConfigOptions">Configuration options</link> control things like how much space GDAL allocates to local data cache, whether to read overviews, and what access keys to use for remote out-db data sources.
fr: Une chaîne de configuration pour définir les options utilisées lors de l'utilisation d'un raster out-db. <link xlink:href="http://trac.osgeo.org/gdal/wiki/ConfigOptions">Les options de configuration</link> contrôlent des éléments tels que l'espace alloué par GDAL au cache des données locales, la lecture ou non des aperçus et les clés d'accès à utiliser pour les sources de données out-db distantes.

note: Tag: para
en: Set <varname>postgis.gdal_vsi_options</varname> for current session:
fr: Définit <varname>postgis.gdal_vsi_options</varname> pour la session actuelle :

note: Tag: para
en: Set <varname>postgis.gdal_vsi_options</varname> just for the <emphasis>current transaction</emphasis> using the <varname>LOCAL</varname> keyword:
fr: Définissez <varname>postgis.gdal_vsi_options</varname> uniquement pour la <emphasis>transaction courante</emphasis> en utilisant le mot clé <varname>LOCAL</varname> :

note: Tag: title
en: Geometry Input
fr: Import de géométrie

note: Tag: para
en: These functions create geometry objects from various textual or binary formats.
fr: Ces fonctions créent des objets géométriques à partir de divers formats textuels ou binaires.

note: Tag: refpurpose
en: <refpurpose>Construct a Polygon given an arbitrary collection of closed linestrings as a MultiLineString Well-Known text representation.</refpurpose>
fr: <refpurpose>Construit un Polygon à partir d'une collection de lignes fermées, exprimées sous forme de MultiLineString en représentation Well-Known text.</refpurpose>

note: Tag: para
en: <para>Construct a Polygon given an arbitrary collection of closed linestrings as a MultiLineString Well-Known text representation.</para>
fr: <para>Construit un Polygon à partir d'une collection de lignes fermées, exprimées sous forme de MultiLineString en représentation Well-Known text.</para>

note: Tag: para
en: Throws an error if WKT is not a MULTILINESTRING. Throws an error if output is a MULTIPOLYGON; use ST_BdMPolyFromText in that case, or see ST_BuildArea() for a postgis-specific approach.
fr: Renvoie une erreur si le WKT n'est pas une MULTILINESTRING. Renvoie une erreur si le résultat est un MULTIPOLYGON. Utiliser ST_BdMPolyFromText dans ce cas, ou voir ST_BuildArea() pour une approche basée sur une fonction spécifique.

note: Tag: refpurpose
en: Construct a MultiPolygon given an arbitrary collection of closed linestrings as a MultiLineString text representation Well-Known text representation.
fr: Construit un MultiPolygon à partir d'une collection de lignes fermées, exprimées sous forme de MultiLineString en représentation Well-Known text.

note: Tag: para
en: Construct a Polygon given an arbitrary collection of closed linestrings, polygons, MultiLineStrings as Well-Known text representation.
fr: Construit un Polygon à partir d'une collection de lignes fermées, de polygones ou de MultiLineStrings exprimés en représentation Well-Known text.

note: Tag: para
en: Throws an error if WKT is not a MULTILINESTRING. Forces MULTIPOLYGON output even when result is really only composed by a single POLYGON; use <link linkend="ST_BdPolyFromText">ST_BdPolyFromText</link> if you're sure a single POLYGON will result from operation, or see <link linkend="ST_BuildArea">ST_BuildArea()</link> for a postgis-specific approach.
fr: Renvoie une erreur si le WKT n'est pas une MULTILINESTRING. Force le type de retour en MULTIPOLYGON même si le résultat est en fait composé d'un seul POLYGON. Utiliser <link linkend="ST_BdPolyFromText">ST_BdPolyFromText</link> si l'on est sûr que le résultat produit des Polygon, ou voir la fonction spécifique PostGIS <link linkend="ST_BuildArea">ST_BuildArea()</link>.

note: Tag: refpurpose
en: Return a specified geography value from Well-Known Text representation or extended (WKT).
fr: Retourne un objet de type geography à partir de sa représentation Well-Know Text (WKT ou EWKT).

note: Tag: para
en: Returns a geography object from the well-known text or extended well-known representation. SRID 4326 is assumed if unspecified. This is an alias for ST_GeographyFromText. Points are always expressed in long lat form.
fr: Retourne un objet de type geography à partir de sa représentation Well-Know Text (WKT ou EWKT). Le SRID 4326 est pris par défaut. Ceci est un alias pour ST_GeographyFromText. Les coordonnées des points sont exprimées en longitude latitude.

note: Tag: para
en: Returns a geography object from the well-known text representation. SRID 4326 is assumed if unspecified.
fr: Retourne un objet de type geography à partir de sa représentation Well-Know Text (WKT ou EWKT). SRID 4326 par défaut.

note: Tag: refpurpose
en: Makes a collection Geometry from collection WKT with the given SRID. If SRID is not given, it defaults to 0.
fr: Crée une collection Geometry à partir de la collection WKT avec le SRID donné. Si le SRID n'est pas donné, la valeur par défaut est 0.

note: Tag: para
en: Makes a collection Geometry from the Well-Known-Text (WKT) representation with the given SRID. If SRID is not given, it defaults to 0.
fr: Crée une géométrie de collection à partir de la représentation Well-Known-Text (WKT) avec le SRID donné. Si le SRID n'est pas donné, la valeur par défaut est 0.

note: Tag: para
en: OGC SPEC 3.2.6.2 - option SRID is from the conformance suite
fr: OGC SPEC 3.2.6.2 - l'option SRID est issue des tests de conformité

note: Tag: para
en: Returns null if the WKT is not a GEOMETRYCOLLECTION
fr: Retourne null si le WKT n'est pas une GEOMETRYCOLLECTION

note: Tag: para
en: If you are absolutely sure all your WKT geometries are collections, don't use this function. It is slower than ST_GeomFromText since it adds an additional validation step.
fr: Si vous êtes absolument sûrs que toutes les géométries WKT sont des collections, ne pas utiliser cette fonction. Elle est plus lente que ST_GeomFromText à cause d'une étape de validation supplémentaire.

note: Tag: refpurpose
en: Return a specified ST_Geometry value from Extended Well-Known Text representation (EWKT).
fr: Retourne un objet ST_Geometry à partir de sa représentation textuelle étendue (Extended Well-Known Text representation, EWKT).

note: Tag: para
en: Constructs a PostGIS ST_Geometry object from the OGC Extended Well-Known text (EWKT) representation.
fr: Retourne un objet ST_Geometry à partir de sa représentation textuelle étendue OGC (Extended Well-Known Text representation, EWKT).

note: Tag: para
en: The EWKT format is not an OGC standard, but an PostGIS specific format that includes the spatial reference system (SRID) identifier
fr: Le format EWKT n'est pas une norme OGC, mais un format spécifique à PostGIS incluant l'identifiant du système de référence des coordonnées (SRID)

note: Tag: refpurpose
en: Takes MARC21/XML geographic data as input and returns a PostGIS geometry object.
fr: Prend les données géographiques MARC21/XML en entrée et renvoie un objet géométrique PostGIS.

note: Tag: para
en: This function creates a PostGIS geometry from a MARC21/XML record, which can contain a <varname>POINT</varname> or a <varname>POLYGON</varname>. In case of multiple geographic data entries in the same MARC21/XML record, a <varname>MULTIPOINT</varname> or <varname>MULTIPOLYGON</varname> will be returned. If the record contains mixed geometry types, a <varname>GEOMETRYCOLLECTION</varname> will be returned. It returns NULL if the MARC21/XML record does not contain any geographic data (datafield:034).
fr: Cette fonction crée une géométrie PostGIS à partir d'un enregistrement MARC21/XML, qui peut contenir un <varname>POINT</varname> ou un <varname>POLYGON</varname>. En cas d'entrées de données géographiques multiples dans le même enregistrement MARC21/XML, un <varname>MULTIPOINT</varname> ou <varname>MULTIPOLYGON</varname> sera renvoyé. Si la notice contient des types de géométrie mixtes, une <varname>GEOMETRYCOLLECTION</varname> sera retournée. Il renvoie NULL si l'enregistrement MARC21/XML ne contient pas de données géographiques (datafield :034).

note: Tag: para
en: LOC MARC21/XML versions supported:
fr: Prise en charge des versions LOC MARC21/XML :

note: Tag: para
en: Availability: 3.3.0, requires libxml2 2.6+
fr: Disponibilité : 3.3.0, nécessite libxml2 2.6+

note: Tag: para
en: The MARC21/XML Coded Cartographic Mathematical Data currently does not provide any means to describe the Spatial Reference System of the encoded coordinates, so this function will always return a geometry with <varname>SRID 0</varname>.
fr: Les données mathématiques cartographiques codées MARC21/XML ne fournissent actuellement aucun moyen de décrire le système de référence spatiale des coordonnées codées, de sorte que cette fonction retournera toujours une géométrie avec <varname>SRID 0</varname>.

note: Tag: para
en: Returned <varname>POLYGON</varname> geometries will always be clockwise oriented.
fr: Les géométries <varname>POLYGON</varname> retournées seront toujours orientées dans le sens des aiguilles d'une montre.

note: Tag: para
en: Converting MARC21/XML geographic data containing a single <varname>POINT</varname> encoded as <varname>hddd.dddddd</varname>
fr: Conversion de données géographiques MARC21/XML contenant un seul <varname>POINT</varname> encodé en <varname>hddd.dddddd</varname>

note: Tag: para
en: Converting MARC21/XML geographic data containing a single <varname>POLYGON</varname> encoded as <varname>hdddmmss</varname>
fr: Conversion de données géographiques MARC21/XML contenant un seul <varname>POLYGON</varname> encodé en <varname>hdddmmss</varname>

note: Tag: para
en: Converting MARC21/XML geographic data containing a <varname>POLYGON</varname> and a <varname>POINT</varname>:
fr: Conversion de données géographiques MARC21/XML contenant un <varname>POLYGON</varname> et un <varname>POINT</varname> :

note: Tag: refpurpose
en: Return a specified ST_Geometry value from Well-Known Text representation (WKT). This is an alias name for ST_GeomFromText
fr: Retourne un objet ST_Geometry à partir de sa représentation textuelle Well-Known Text (WKT). Alias pour ST_GeomFromText

note: Tag: para
en: &sqlmm_compliant; SQL-MM 3: 5.1.40
fr: &sqlmm_compliant; SQL-MM 3 : 5.1.40

note: Tag: refpurpose
en: Return a specified ST_Geometry value from Well-Known Text representation (WKT).
fr: Retourne un objet ST_Geometry à partir de sa représentation textuelle Well-Known Text (WKT).

note: Tag: para
en: Constructs a PostGIS ST_Geometry object from the OGC Well-Known text representation.
fr: Construit un objet Postgis de type geometry à partir d'une représentation OGC Well-Known Text WKT.

note: Tag: para
en: There are two variants of ST_GeomFromText function. The first takes no SRID and returns a geometry with no defined spatial reference system (SRID=0). The second takes a SRID as the second argument and returns a geometry that includes this SRID as part of its metadata.
fr: Il existe deux variantes de la fonction ST_GeomFromText. La première ne prend pas de SRID et renvoie une géométrie sans système de référence spatiale défini (SRID=0). La seconde prend un SRID comme deuxième argument et renvoie une géométrie qui inclut ce SRID comme partie de ses métadonnées.

note: Tag: para
en: &sfs_compliant; s3.2.6.2 - option SRID is from the conformance suite.
fr: &sfs_compliant; s3.2.6.2 - l'option SRID est issue des tests de conformité.

note: Tag: para
en: While not OGC-compliant, <xref linkend="ST_MakePoint"/> is faster than ST_GeomFromText and ST_PointFromText. It is also easier to use for numeric coordinate values. <xref linkend="ST_Point"/> is another option similar in speed to <xref linkend="ST_MakePoint"/> and is OGC-compliant, but doesn't support anything but 2D points.
fr: Bien que non conforme à l'OGC, <xref linkend="ST_MakePoint"/> est plus rapide que ST_GeomFromText et ST_PointFromText. Il est également plus facile à utiliser pour les valeurs de coordonnées numériques. <xref linkend="ST_Point"/> est une autre option similaire en vitesse à <xref linkend="ST_MakePoint"/> et est conforme à l'OGC, mais ne prend pas en charge autre chose que les points 2D.

note: Tag: para
en: Changed: 2.0.0 In prior versions of PostGIS ST_GeomFromText('GEOMETRYCOLLECTION(EMPTY)') was allowed. This is now illegal in PostGIS 2.0.0 to better conform with SQL/MM standards. This should now be written as ST_GeomFromText('GEOMETRYCOLLECTION EMPTY')
fr: Changement : 2.0.0 dans les version précédentes de PostGIS ST_GeomFromText('GEOMETRYCOLLECTION(EMPTY)') etait autorisé. C'est désormais interdit dans PostGIS 2.0.0 pour respecter la norme SQL/MM. La forme privilégiée désormais est : ST_GeomFromText('GEOMETRYCOLLECTION EMPTY')

note: Tag: refpurpose
en: Makes a Geometry from WKT representation with the given SRID. If SRID is not given, it defaults to 0.
fr: Construit une géométrie à partir d'une représentation WKT avec le SRID donné. Si aucun SRID n'est donné, la valeur par défaut est 0.

note: Tag: para
en: Makes a Geometry from WKT with the given SRID. If SRID is not given, it defaults to 0. If WKT passed in is not a LINESTRING, then null is returned.
fr: Crée une géométrie à partir de WKT avec le SRID donné. Si le SRID n'est pas donné, la valeur par défaut est 0. Si le WKT passé n'est pas un LINESTRING, null est retourné.

note: Tag: para
en: OGC SPEC 3.2.6.2 - option SRID is from the conformance suite.
fr: OGC SPEC 3.2.6.2 - option SRID issue des tests de conformité.

note: Tag: para
en: If you know all your geometries are LINESTRINGS, its more efficient to just use ST_GeomFromText. This just calls ST_GeomFromText and adds additional validation that it returns a linestring.
fr: Si vous êtes sûrs que toutes les géométries WKT sont des LINESTRINGS, la fonction ST_GeomFromText est plus efficace car elle ne contrôle pas le type de la géométrie renvoyée.

note: Tag: para
en: &sqlmm_compliant; SQL-MM 3: 7.2.8
fr: &sqlmm_compliant; SQL-MM 3 : 7.2.8

note: Tag: refpurpose
en: Return a specified ST_MultiLineString value from WKT representation.
fr: Retourne un objet de type ST_MultiLineString à partir de sa représentation WKT.

note: Tag: para
en: Makes a Geometry from Well-Known-Text (WKT) with the given SRID. If SRID is not given, it defaults to 0.
fr: Crée une géométrie à partir du texte connu (WKT) avec le SRID donné. Si le SRID n'est pas donné, la valeur par défaut est 0.

note: Tag: para
en: Returns null if the WKT is not a MULTILINESTRING
fr: Retourne NULL si le WKT n'est pas une MULTILINESTRING

note: Tag: para
en: If you are absolutely sure all your WKT geometries are points, don't use this function. It is slower than ST_GeomFromText since it adds an additional validation step.
fr: Si vous êtes absolument sûrs que toutes les géométries WKT sont des points, ne pas utiliser cette fonction. Elle est plus lente que ST_GeomFromText à cause d'une étape de validation supplémentaire.

note: Tag: para
en: &sqlmm_compliant;SQL-MM 3: 9.4.4
fr: &sqlmm_compliant;SQL-MM 3 : 9.4.4

note: Tag: refpurpose
en: <refpurpose>Makes a Geometry from WKT with the given SRID. If SRID is not given, it defaults to 0.</refpurpose>
fr: <refpurpose>Créé une Geometry depuis un WKT avec le SRID donné. Si le SRID n'est pas fourni, il sera défini par défaut à 0.</refpurpose>

note: Tag: para
en: <para>Makes a Geometry from WKT with the given SRID. If SRID is not given, it defaults to 0.</para>
fr: <para>Créé une Geometry depuis un WKT avec le SRID donné. Si le SRID n'est pas fourni, il sera défini par défaut à 0. </para>

note: Tag: para
en: Returns null if the WKT is not a MULTIPOINT
fr: Retourne NULL si le WKT n'est pas une MULTIPOINT

note: Tag: para
en: &sqlmm_compliant; SQL-MM 3: 9.2.4
fr: &sqlmm_compliant; SQL-MM 3 : 9.2.4

note: Tag: refpurpose
en: Makes a MultiPolygon Geometry from WKT with the given SRID. If SRID is not given, it defaults to 0.
fr: Crée une géométrie multi-polygone à partir de WKT avec le SRID donné. Si le SRID n'est pas donné, la valeur par défaut est 0.

note: Tag: para
en: Makes a MultiPolygon from WKT with the given SRID. If SRID is not given, it defaults to 0.
fr: Crée un MultiPolygone à partir de WKT avec le SRID donné. Si le SRID n'est pas donné, la valeur par défaut est 0.

note: Tag: para
en: Throws an error if the WKT is not a MULTIPOLYGON
fr: Retourne une erreur si le WKT n'est pas un MULTIPOLYGON

note: Tag: para
en: If you are absolutely sure all your WKT geometries are multipolygons, don't use this function. It is slower than ST_GeomFromText since it adds an additional validation step.
fr: Si vous êtes absolument sûrs que toutes les géométries WKT sont des multipolygones, ne pas utiliser cette fonction. Elle est plus lente que ST_GeomFromText à cause d'une étape de validation supplémentaire.

note: Tag: para
en: &sqlmm_compliant; SQL-MM 3: 9.6.4
fr: &sqlmm_compliant; SQL-MM 3 : 9.6.4

note: Tag: refpurpose
en: Makes a point Geometry from WKT with the given SRID. If SRID is not given, it defaults to unknown.
fr: Construit une géométrie point à partir d'une représentation WKT et le SRID donné. Si aucun SRID n'est donné, la valeur par défaut est 0.

note: Tag: para
en: Constructs a PostGIS ST_Geometry point object from the OGC Well-Known text representation. If SRID is not given, it defaults to unknown (currently 0). If geometry is not a WKT point representation, returns null. If completely invalid WKT, then throws an error.
fr: Construit un objet point ST_Geometry de PostGIS à partir de la représentation textuelle Well-Known de l'OGC. Si le SRID n'est pas donné, il prend par défaut la valeur inconnue (actuellement 0). Si la géométrie n'est pas une représentation de point WKT, retourne null. Si la représentation WKT n'est pas du tout valide, une erreur est générée.

note: Tag: para
en: There are 2 variants of ST_PointFromText function, the first takes no SRID and returns a geometry with no defined spatial reference system. The second takes a spatial reference id as the second argument and returns an ST_Geometry that includes this srid as part of its meta-data. The srid must be defined in the spatial_ref_sys table.
fr: Il existe 2 versions de la fonction ST_PointFromText : la première ne prend pas de SRID en paramètre et retourne une geometry sans système de coordonnées. La seconde prend un SRID en second paramètre et retourne une ST_Geometry incluant un SRID dans ses métadonnées. Ce SRID doit obligatoirement exister dans la table spatial_ref_sys.

note: Tag: para
en: If you are absolutely sure all your WKT geometries are points, don't use this function. It is slower than ST_GeomFromText since it adds an additional validation step. If you are building points from long lat coordinates and care more about performance and accuracy than OGC compliance, use <xref linkend="ST_MakePoint"/> or OGC compliant alias <xref linkend="ST_Point"/>.
fr: Si vous êtes absolument sûrs que toutes les géométries WKT sont des points, ne pas utiliser cette fonction. Elle est plus lente que ST_GeomFromText à cause d'une étape de validation supplémentaire. Si le point doit être construit à partir de coordonnées latitude longitude et que la performance est recherchée, utiliser la fonction <xref linkend="ST_MakePoint"/> ou son équivalent OGC <xref linkend="ST_Point"/>.

note: Tag: para
en: &sqlmm_compliant; SQL-MM 3: 6.1.8
fr: &sqlmm_compliant; SQL-MM 3 : 6.1.8

note: Tag: para
en: Makes a Geometry from WKT with the given SRID. If SRID is not given, it defaults to 0. Returns null if WKT is not a polygon.
fr: Crée une géométrie à partir de WKT avec le SRID donné. Si le SRID n'est pas donné, la valeur par défaut est 0. Retourne null si WKT n'est pas un polygone.

note: Tag: para
en: If you are absolutely sure all your WKT geometries are polygons, don't use this function. It is slower than ST_GeomFromText since it adds an additional validation step.
fr: Si vous êtes absolument sûrs que toutes les géométries WKT sont des polygones, ne pas utiliser cette fonction. Elle est plus lente que ST_GeomFromText à cause d'une étape de validation supplémentaire.

note: Tag: para
en: &sqlmm_compliant; SQL-MM 3: 8.3.6
fr: &sqlmm_compliant; SQL-MM 3 : 8.3.6

note: Tag: para
en: &sqlmm_compliant; SQL-MM 3: 5.1.34
fr: &sqlmm_compliant; SQL-MM 3 : 5.1.34

note: Tag: refpurpose
en: Creates a geography instance from a Well-Known Binary geometry representation (WKB) or extended Well Known Binary (EWKB).
fr: Retourne un objet de type geography à partir de sa représentation binaire Well-Know Binary (WKB ou EWKB).

note: Tag: para
en: The <varname>ST_GeogFromWKB</varname> function, takes a well-known binary representation (WKB) of a geometry or PostGIS Extended WKB and creates an instance of the appropriate geography type. This function plays the role of the Geometry Factory in SQL.
fr: <varname>ST_GeogFromWKB</varname> prend en paramètre une représentation binaire d'une géométrie (WKB ou EWKB) et crée une instance de type geography. Cette fonction assure le rôle de Geometry Factory en SQL.

note: Tag: para
en: If SRID is not specified, it defaults to 4326 (WGS 84 long lat).
fr: Si le SRID n'est pas spécifié, la valeur 4326 est prise (WGS 84 long lat).

note: Tag: refpurpose
en: Return a specified ST_Geometry value from Extended Well-Known Binary representation (EWKB).
fr: Retourne un objet ST_Geometry à partir de sa représentation binaire étendue (Extended Well-Known Binary representation, EWKB).

note: Tag: para
en: Constructs a PostGIS ST_Geometry object from the OGC Extended Well-Known binary (EWKT) representation.
fr: Retourne un objet ST_Geometry à partir de sa représentation textuelle étendue OGC (Extended Well-Known Text representation, EWKT).

note: Tag: para
en: The EWKB format is not an OGC standard, but a PostGIS specific format that includes the spatial reference system (SRID) identifier
fr: Le format EWKB n'est pas une norme OGC, mais un format spécifique à PostGIS incluant l'identifiant du système de référence des coordonnées (SRID)

note: Tag: para
en: NOTE: Even though byte arrays are delimited with \ and may have ', we need to escape both out with \ and '' if standard_conforming_strings is off. So it does not look exactly like its AsEWKB representation.
fr: NOTE : Si le paramètre standard_conforming_strings est à la valeur off, il est nécessaire d'échapper les caractères \ et ' avec \ et ". Ceci diffère de la représentation AsEWKB.

note: Tag: para
en: In PostgreSQL 9.1+ - standard_conforming_strings is set to on by default, where as in past versions it was set to off. You can change defaults as needed for a single query or at the database or server level. Below is how you would do it with standard_conforming_strings = on. In this case we escape the ' with standard ansi ', but slashes are not escaped
fr: Dans PostgreSQL 9.1+ - standard_conforming_strings est activé par défaut, alors que dans les versions précédentes il était désactivé. Vous pouvez modifier les valeurs par défaut selon vos besoins pour une seule requête ou au niveau de la base de données ou du serveur. Voici comment procéder avec standard_conforming_strings = on. Dans ce cas, nous échappons le ' avec le standard ansi ', mais les barres obliques ne sont pas échappées

note: Tag: refpurpose
en: Creates a geometry instance from a Well-Known Binary geometry representation (WKB) and optional SRID.
fr: Retourne un objet de type geometry à partir de sa représentation binaire Well-Know Binary (WKB) et d'un SRID optionnel.

note: Tag: para
en: The <varname>ST_GeomFromWKB</varname> function, takes a well-known binary representation of a geometry and a Spatial Reference System ID (<varname>SRID</varname>) and creates an instance of the appropriate geometry type. This function plays the role of the Geometry Factory in SQL. This is an alternate name for ST_WKBToSQL.
fr: <varname> ST_GeomFromWKB </varname> prend en paramètre une représentation binaire d'une géométrie (WKB ou EWKB) et un SRID optionnel (<varname>SRID</varname>) et crée une instance de type geometry. Cette fonction assure le rôle de Geometry Factory en SQL. Alias pour ST_WKBToSQL.

note: Tag: para
en: If SRID is not specified, it defaults to 0 (Unknown).
fr: Si le SRID n'est pas précisé, la valeur 0 (indéfini) est prise par défaut.

note: Tag: para
en: &sfs_compliant; s3.2.7.2 - the optional SRID is from the conformance suite
fr: &sfs_compliant; s3.2.7.2 - le paramètre optionnel est issu des tests de conformité

note: Tag: para
en: &sqlmm_compliant; SQL-MM 3: 5.1.41
fr: &sqlmm_compliant; SQL-MM 3 : 5.1.41

note: Tag: refpurpose
en: Makes a <varname>LINESTRING</varname> from WKB with the given SRID
fr: Construit une <varname>LINESTRING</varname> depuis la représentation binaire WKB et le srid donné

note: Tag: para
en: The <varname>ST_LineFromWKB</varname> function, takes a well-known binary representation of geometry and a Spatial Reference System ID (<varname>SRID</varname>) and creates an instance of the appropriate geometry type - in this case, a <varname>LINESTRING</varname> geometry. This function plays the role of the Geometry Factory in SQL.
fr: <varname> ST_LineFromWKB </varname> prend en paramètre une représentation binaire d'une géométrie (WKB ou EWKB) et un SRID (<varname>SRID</varname>) et crée une instance du bon type géométrique, en l'occurence une <varname>LINESTRING</varname>. Cette fonction assure le rôle de Geometry Factory en SQL.

note: Tag: para
en: If an SRID is not specified, it defaults to 0. <varname>NULL</varname> is returned if the input <varname>bytea</varname> does not represent a <varname>LINESTRING</varname>.
fr: Si le SRID n'est pas précisé, la valeur 0 est prise par défaut. <varname>NULL</varname> est retourné si le paramètre <varname>bytea</varname> donné ne représente pas une <varname>LINESTRING</varname>.

note: Tag: para
en: If you know all your geometries are <varname>LINESTRING</varname>s, its more efficient to just use <xref linkend="ST_GeomFromWKB"/>. This function just calls <xref linkend="ST_GeomFromWKB"/> and adds additional validation that it returns a linestring.
fr: Si vous savez que toutes vos géométries sont des <varname>LINESTRING</varname>, il est plus efficace d'utiliser <xref linkend="ST_GeomFromWKB"/>. Cette fonction appelle simplement <xref linkend="ST_GeomFromWKB"/> et ajoute une validation supplémentaire indiquant qu'elle renvoie une linestring.

note: Tag: para
en: &sqlmm_compliant; SQL-MM 3: 7.2.9
fr: &sqlmm_compliant; SQL-MM 3 : 7.2.9

note: Tag: refpurpose
en: Makes a geometry from WKB with the given SRID.
fr: Construit une géométrie depuis la représentation binaire WKB et le SRID donné.

note: Tag: para
en: The <varname>ST_LinestringFromWKB</varname> function, takes a well-known binary representation of geometry and a Spatial Reference System ID (<varname>SRID</varname>) and creates an instance of the appropriate geometry type - in this case, a <varname>LINESTRING</varname> geometry. This function plays the role of the Geometry Factory in SQL.
fr: La fonction <varname> ST_LinestringFromWKB </varname> prend en paramètre une représentation binaire d'une géométrie (WKB ou EWKB) et un SRID (<varname>SRID</varname>) et crée une instance du bon type géométrique, en l'occurence une <varname>LINESTRING</varname>. Cette fonction assure le rôle de Geometry Factory en SQL.

note: Tag: para
en: If an SRID is not specified, it defaults to 0. <varname>NULL</varname> is returned if the input <varname>bytea</varname> does not represent a <varname>LINESTRING</varname> geometry. This an alias for <xref linkend="ST_LineFromWKB"/>.
fr: Si le SRID n'est pas précisé, la valeur 0 est prise par défaut. <varname>NULL</varname> est retourné si le paramètre <varname>bytea</varname> donné ne représente pas une <varname>LINESTRING</varname>. Alias pour <xref linkend="ST_LineFromWKB"/>.

note: Tag: para
en: OGC SPEC 3.2.6.2 - optional SRID is from the conformance suite.
fr: OGC SPEC 3.2.6.2 - SRID optionnel issu des tests de conformité.

note: Tag: para
en: If you know all your geometries are <varname>LINESTRING</varname>s, it's more efficient to just use <xref linkend="ST_GeomFromWKB"/>. This function just calls <xref linkend="ST_GeomFromWKB"/> and adds additional validation that it returns a <varname>LINESTRING</varname>.
fr: Si vous savez que toutes vos géométries sont des <varname>LINESTRING</varname>, il est plus efficace d'utiliser <xref linkend="ST_GeomFromWKB"/>. Cette fonction appelle simplement <xref linkend="ST_GeomFromWKB"/> et ajoute une validation supplémentaire indiquant qu'elle renvoie une <varname>LINESTRING</varname>.

note: Tag: refpurpose
en: Makes a geometry from WKB with the given SRID
fr: Construit une géométrie depuis la représentation binaire WKB et le SRID donné

note: Tag: para
en: The <varname>ST_PointFromWKB</varname> function, takes a well-known binary representation of geometry and a Spatial Reference System ID (<varname>SRID</varname>) and creates an instance of the appropriate geometry type - in this case, a <varname>POINT</varname> geometry. This function plays the role of the Geometry Factory in SQL.
fr: <varname> ST_PointFromWKB </varname> prend en paramètre une représentation binaire d'une géométrie et un SRID (<varname>SRID</varname>) et crée une instance du bon type géométrique, en l'occurence une <varname> POINT </varname>. Cette fonction assure le rôle de Geometry Factory en SQL.

note: Tag: para
en: If an SRID is not specified, it defaults to 0. <varname>NULL</varname> is returned if the input <varname>bytea</varname> does not represent a <varname>POINT</varname> geometry.
fr: Si le SRID n'est pas précisé, la valeur 0 est prise par défaut. <varname>NULL</varname> est retourné si le paramètre <varname>bytea</varname> donné ne représente pas une géométrie <varname>POINT</varname>.

note: Tag: para
en: &sqlmm_compliant; SQL-MM 3: 6.1.9
fr: &sqlmm_compliant; SQL-MM 3 : 6.1.9

note: Tag: refpurpose
en: Return a specified ST_Geometry value from Well-Known Binary representation (WKB). This is an alias name for ST_GeomFromWKB that takes no srid
fr: Retourne un objet ST_Geometry à partir de sa représentation textuelle Well-Known Binary (WKB). Alias pour ST_GeomFromWKB sans SRID

note: Tag: para
en: &sqlmm_compliant; SQL-MM 3: 5.1.36
fr: &sqlmm_compliant; SQL-MM 3 : 5.1.36

note: Tag: title
en: Other Formats
fr: Autres formats

note: Tag: refpurpose
en: <refpurpose>Return a BOX2D from a GeoHash string.</refpurpose>
fr: <refpurpose>Retourne une BOX2D à partir d'une chaîne GeoHash.</refpurpose>

note: Tag: para
en: <para>Return a BOX2D from a GeoHash string.</para>
fr: <para>Retourne une BOX2D à partir d'une chaîne GeoHash.</para>

note: Tag: para
en: If no <varname>precision</varname> is specified ST_Box2dFromGeoHash returns a BOX2D based on full precision of the input GeoHash string.
fr: Si aucune <varname>precision</varname> n'est spécifiée, ST_Box2dFromGeoHash retourne un BOX2D basé sur la précision complète de la chaîne GeoHash d'entrée.

note: Tag: para
en: If <varname>precision</varname> is specified ST_Box2dFromGeoHash will use that many characters from the GeoHash to create the BOX2D. Lower precision values results in larger BOX2Ds and larger values increase the precision.
fr: Si <varname>precision</varname> est spécifié, ST_Box2dFromGeoHash utilise autant de caractère du GeoHash pour créer la BOX2D. Une précision plus basse retourne des BOXD2 plus grandes, et une valeur plus haute améliore la précision.

note: Tag: refpurpose
en: Return a geometry from a GeoHash string.
fr: Retourne une geometry depuis une chaîne GeoHash.

note: Tag: para
en: Return a geometry from a GeoHash string. The geometry will be a polygon representing the GeoHash bounds.
fr: Retourne une Geometry à partir d'une chaîne GeoHash. La géométrie sera un polygone représentant les limites du GeoHash.

note: Tag: para
en: If no <varname>precision</varname> is specified ST_GeomFromGeoHash returns a polygon based on full precision of the input GeoHash string.
fr: Si aucune <varname>precision</varname> n'est spécifiée, ST_GeomFromGeoHash retourne un polygone basé sur la précision complète de la chaîne GeoHash en entrée.

note: Tag: para
en: If <varname>precision</varname> is specified ST_GeomFromGeoHash will use that many characters from the GeoHash to create the polygon.
fr: Si <varname>precision</varname> est spécifié, ST_GeomFromGeoHash utilise autant de caractère du GeoHash pour créer le polygone.

note: Tag: refpurpose
en: Takes as input GML representation of geometry and outputs a PostGIS geometry object
fr: Prend en paramètre une représentation GML d'une géométrie et renvoie un objet PostGIS de type geometry

note: Tag: para
en: Constructs a PostGIS ST_Geometry object from the OGC GML representation.
fr: Construit un objet PostGIS ST_Geometry à partir d'une représentation GML OGC.

note: Tag: para
en: ST_GeomFromGML works only for GML Geometry fragments. It throws an error if you try to use it on a whole GML document.
fr: La fonction ST_GeomFromGML fonctionne uniquement avec le fragment GML représentant la géométrie. Elle renvoie une error si un document GML complet est utilisé.

note: Tag: para
en: OGC GML versions supported: <itemizedlist> <listitem> <para>GML 3.2.1 Namespace</para> </listitem> <listitem> <para>GML 3.1.1 Simple Features profile SF-2 (with GML 3.1.0 and 3.0.0 backward compatibility)</para> </listitem> <listitem> <para>GML 2.1.2</para> </listitem> </itemizedlist> OGC GML standards, cf: <link xlink:href="http://www.opengeospatial.org/standards/gml">http://www.opengeospatial.org/standards/gml</link>:
fr: version OGC GML supportée : <itemizedlist> <listitem> <para>GML 3.2.1 Namespace</para> </listitem> <listitem> <para>GML 3.1.1 Simple Features profile SF-2 (with GML 3.1.0 and 3.0.0 backward compatibility)</para> </listitem> <listitem> <para>GML 2.1.2</para> </listitem> </itemizedlist> OGC GML standards, cf : <link xlink:href="http://www.opengeospatial.org/standards/gml">http://www.opengeospatial.org/standards/gml</link> :

note: Tag: para
en: Availability: 1.5, requires libxml2 1.6+
fr: Disponibilité : 1.5, nécessite libxml2 1.6+

note: Tag: para
en: Enhanced: 2.0.0 default srid optional parameter added.
fr: Amélioration : 2.0.0 paramètre optionnel de srid par défaut ajouté.

note: Tag: para
en: GML allow mixed dimensions (2D and 3D inside the same MultiGeometry for instance). As PostGIS geometries don't, ST_GeomFromGML convert the whole geometry to 2D if a missing Z dimension is found once.
fr: Le format GML supporte des objets de dimensions différentes (2D et 3D dans la même MultiGeometry par exemple). PostGIS ne supportant pas cela, la fonction convertit toute la géometrie en 2D si une seule coordonnée Z manque.

note: Tag: para
en: GML support mixed SRS inside the same MultiGeometry. As PostGIS geometries don't, ST_GeomFromGML, in this case, reproject all subgeometries to the SRS root node. If no srsName attribute available for the GML root node, the function throw an error.
fr: Le format GML supporte des objets ayant des SRID différents dans la même MultiGeometry. PostGIS ne supportant pas cela, ST_GeomFromGML reprojète toutes les sous géométries dans le SRS du noeud racine. Si aucun attribut srsName n'est disponible pour le noeud racine GML, la fonction renvoie une erreur.

note: Tag: para
en: ST_GeomFromGML function is not pedantic about an explicit GML namespace. You could avoid to mention it explicitly for common usages. But you need it if you want to use XLink feature inside GML.
fr: La fonction ST_GeomFromGML n'impose pas d'utiliser un espace de noms GML explicite. Pour les usages courants, il peut être ignoré. Il est en revanche nécessaire en cas d'utilisation de la fonctionnalité XLink dans le GML.

note: Tag: para
en: ST_GeomFromGML function not support SQL/MM curves geometries.
fr: La fonction ST_GeomFromGML ne supporte pas les géométries de type SQL/MM courbes.

note: Tag: title
en: Examples - A single geometry with srsName
fr: Exemple : une géométrie unique avec srsName

note: Tag: title
en: Examples - XLink usage
fr: Exemple - utilisation de XLink

note: Tag: title
en: Examples - Polyhedral Surface
fr: Exemple - Surface Polyédrique

note: Tag: refpurpose
en: Takes as input a geojson representation of a geometry and outputs a PostGIS geometry object
fr: Prend en entrée une géométrie au format geojson et renvoie un objet Postgis de type geometry

note: Tag: para
en: Constructs a PostGIS geometry object from the GeoJSON representation.
fr: Construit un objet Postgis de type geometry à partir d'une représentation GeoJSON.

note: Tag: para
en: ST_GeomFromGeoJSON works only for JSON Geometry fragments. It throws an error if you try to use it on a whole JSON document.
fr: La fonction ST_GeomFromGeoJSON fonctionne uniquement avec le fragment JSON représentant la géométrie. Elle renvoie une erreur si un document JSON complet est utilisé.

note: Tag: para
en: Enhanced: 3.0.0 parsed geometry defaults to SRID=4326 if not specified otherwise.
fr: Amélioré : 3.0.0 La géométrie parsée prend par défaut la valeur SRID=4326 si elle n'est pas spécifiée autrement.

note: Tag: para
en: Enhanced: 2.5.0 can now accept json and jsonb as inputs.
fr: Amélioration : 2.5.0 peut maintenant accepter json et jsonb comme entrées.

note: Tag: para
en: Availability: 2.0.0 requires - JSON-C &gt;= 0.9
fr: Disponibilité : 2.0.0 nécessite JSON-C &gt;= 0.9

note: Tag: para
en: If you do not have JSON-C enabled, support you will get an error notice instead of seeing an output. To enable JSON-C, run configure --with-jsondir=/path/to/json-c. See <xref linkend="installation_configuration"/> for details.
fr: Si JSON-C n'est pas disponible sur le système, une erreur est renvoyée. Pour activer JSON-C, lancer configure --with-jsondir=/path/to/json-c. Cf. <xref linkend="installation_configuration"/> pour plus de détails.

note: Tag: refpurpose
en: Takes as input KML representation of geometry and outputs a PostGIS geometry object
fr: Prend en entrée une géométrie au format KML et renvoie un objet Postgis de type geometry

note: Tag: para
en: Constructs a PostGIS ST_Geometry object from the OGC KML representation.
fr: Construit un objet Postgis de type geometry à partir d'une représentation OGC KML.

note: Tag: para
en: ST_GeomFromKML works only for KML Geometry fragments. It throws an error if you try to use it on a whole KML document.
fr: La fonction ST_GeomFromKML fonctionne uniquement avec le fragment KML représentant la géométrie. Elle renvoie une erreur si un document KML complet est utilisé.

note: Tag: para
en: OGC KML versions supported: <itemizedlist> <listitem> <para>KML 2.2.0 Namespace</para> </listitem> </itemizedlist> OGC KML standards, cf: <link xlink:href="http://www.opengeospatial.org/standards/kml">http://www.opengeospatial.org/standards/kml</link>:
fr: versions OGC KML supportées : <itemizedlist> <listitem> <para>KML 2.2.0 Namespace</para> </listitem> </itemizedlist> OGC KML standards, cf : <link xlink:href="http://www.opengeospatial.org/standards/kml">http://www.opengeospatial.org/standards/kml</link> :

note: Tag: para
en: Availability: 1.5, requires libxml2 2.6+
fr: Disponibilité : 1.5, nécessite libxml2 2.6+

note: Tag: para
en: ST_GeomFromKML function not support SQL/MM curves geometries.
fr: La fonction ST_GeomFromGML ne supporte pas les géométries de type SQL/MM courbes.

note: Tag: refpurpose
en: Creates a geometry instance from a TWKB ("<link xlink:href="https://github.com/TWKB/Specification/blob/master/twkb.md">Tiny Well-Known Binary</link>") geometry representation.
fr: Crée une instance de geometry depuis une représentation de géométrie en TWKB ("<link xlink:href="https://github.com/TWKB/Specification/blob/master/twkb.md">Tiny Well-Known Binary</link>").

note: Tag: para
en: The <varname>ST_GeomFromTWKB</varname> function, takes a a TWKB ("<link xlink:href="https://github.com/TWKB/Specification/blob/master/twkb.md">Tiny Well-Known Binary</link>") geometry representation (WKB) and creates an instance of the appropriate geometry type.
fr: La fonction <varname>ST_GeomFromTWKB</varname> prend une représentation de géométrie TWKB ("<link xlink:href="https://github.com/TWKB/Specification/blob/master/twkb.md">Tiny Well-Known Binary</link>") et crée une instance du type de géométrie approprié.

note: Tag: refpurpose
en: Return a specified ST_Geometry value from GML representation. This is an alias name for ST_GeomFromGML
fr: Retourne un objet de type ST_Geometry à partir de sa représentation GML. Alias pour ST_GeomFromGML

note: Tag: para
en: &sqlmm_compliant; SQL-MM 3: 5.1.50 (except for curves support).
fr: &sqlmm_compliant; SQL-MM 3 : 5.1.50 (sauf pour le support des courbes).

note: Tag: refpurpose
en: Creates a LineString from an Encoded Polyline.
fr: Crée une LineString depuis une polyligne encodée ( "Encoded Polyline" ).

note: Tag: para
en: Creates a LineString from an Encoded Polyline string.
fr: Crée une LineString à partir d'une chaîne de polyligne encodée ( "Encoded Polyline").

note: Tag: para
en: Optional <varname>precision</varname> specifies how many decimal places will be preserved in Encoded Polyline. Value should be the same on encoding and decoding, or coordinates will be incorrect.
fr: L'option <varname>precision</varname> spécifie le nombre de décimales qui seront préservées dans la polyligne encodée. La valeur doit être la même à l'encodage et au décodage, sinon les coordonnées seront incorrectes.

note: Tag: para
en: See http://developers.google.com/maps/documentation/utilities/polylinealgorithm
fr: Voir http://developers.google.com/maps/documentation/utilities/polylinealgorithm

note: Tag: refpurpose
en: Return a point from a GeoHash string.
fr: Retourne un point à partir d'une chaîne GeoHash.

note: Tag: para
en: Return a point from a GeoHash string. The point represents the center point of the GeoHash.
fr: Retourne une point à partir d'une chaîne GeoHash. Le point représente le centre du GeoHash.

note: Tag: para
en: If no <varname>precision</varname> is specified ST_PointFromGeoHash returns a point based on full precision of the input GeoHash string.
fr: Si aucune <varname>precision</varname> n'est spécifiée, ST_PointFromGeoHash retourne une un point basé sur la précision complète de la chaîne GeoHash en entrée.

note: Tag: para
en: If <varname>precision</varname> is specified ST_PointFromGeoHash will use that many characters from the GeoHash to create the point.
fr: Si <varname>precision</varname> est spécifié, ST_PointFromGeoHash utilise autant de caractère du GeoHash pour créer le point.

note: Tag: refpurpose
en: Creates a table based on the structure of FlatGeobuf data.
fr: Crée une table basée sur la structure des données FlatGeobuf.

note: Tag: para
en: Creates a table based on the structure of FlatGeobuf data. (<link xlink:href="http://flatgeobuf.org">http://flatgeobuf.org</link>).
fr: Crée une table basée sur la structure des données FlatGeobuf. (<link xlink:href="http://flatgeobuf.org">http://flatgeobuf.org</link>).

note: Tag: para
en: <varname>schema</varname> Schema name.
fr: <varname>schema</varname> Nom du schéma.

note: Tag: para
en: <varname>table</varname> Table name.
fr: <varname>table</varname> Nom de la table.

note: Tag: para
en: <varname>data</varname> Input FlatGeobuf data.
fr: <varname>data</varname> Données FlatGeobuf en entrée.

note: Tag: refpurpose
en: Reads FlatGeobuf data.
fr: Lit les données FlatGeobuf.

note: Tag: para
en: Reads FlatGeobuf data (<link xlink:href="http://flatgeobuf.org">http://flatgeobuf.org</link>). NOTE: PostgreSQL bytea cannot exceed 1GB.
fr: Lit les données FlatGeobuf (<link xlink:href="http://flatgeobuf.org">http://flatgeobuf.org</link>). REMARQUE : les chaînes binaires de PostgreSQL ne peuvent pas dépasser 1 Go.

note: Tag: para
en: <varname>tabletype</varname> reference to a table type.
fr: <varname>tabletype</varname> référence à un type de table.

note: Tag: para
en: <varname>data</varname> input FlatGeobuf data.
fr: <varname>data</varname> données d'entrée FlatGeobuf.

note: Tag: title
en: Linear Referencing
fr: Référencement linéaire

note: Tag: refpurpose
en: Returns a point interpolated along a line at a fractional location.
fr: Renvoie un point interpolé le long d'une ligne à un emplacement fractionnaire.

note: Tag: para
en: Returns a point interpolated along a line at a fractional location. First argument must be a LINESTRING. Second argument is a float between 0 and 1 representing the fraction of line length where the point is to be located. The Z and M values are interpolated if present.
fr: Retourne un point interpolé sur une ligne. Le premier argument doit être une LINESTRING. Le second argument est un float8 entre 0 et 1 représentant la fraction de la longueur totale de la ligne où le point doit être situé.

note: Tag: para
en: See <xref linkend="ST_LineLocatePoint"/> for computing the line location nearest to a Point.
fr: Voir <xref linkend="ST_LineLocatePoint"/> pour calculer l'emplacement de la ligne la plus proche d'un point.

note: Tag: para
en: This function computes points in 2D and then interpolates values for Z and M, while <xref linkend="ST_3DLineInterpolatePoint"/> computes points in 3D and only interpolates the M value.
fr: Cette fonction calcule des points en 2D et interpole ensuite les valeurs de Z et M, tandis que <xref linkend="ST_3DLineInterpolatePoint"/> calcule des points en 3D et n'interpole que la valeur M.

note: Tag: para
en: Since release 1.1.1 this function also interpolates M and Z values (when present), while prior releases set them to 0.0.
fr: Depuis la version 1.1.1 cette fonction interpole aussi les valeurs M et Z (lorsqu'elles sont présentes), les versions précédentes renvoient des valeurs M et Z à 0.0.

note: Tag: para
en: Availability: 0.8.2, Z and M supported added in 1.1.1
fr: Disponibilité : 0.8.2, support de Z et M ajouté en 1.1.1

note: Tag: para
en: Changed: 2.1.0. Up to 2.0.x this was called ST_Line_Interpolate_Point.
fr: Modifié : 2.1.0. Jusqu'à la version 2.0.x, cette fonction était appelée ST_Line_Interpolate_Point.

note: Tag: para
en: A LineString with the interpolated point at 20% position (0.20)
fr: Une ligne avec le point interpolé à la position 20% (0.20)

note: Tag: para
en: The mid-point of a 3D line:
fr: Le point central d'une ligne 3D :

note: Tag: para
en: The closest point on a line to a point:
fr: Le point le plus proche d'un point sur une ligne :

note: Tag: refpurpose
en: Returns a point interpolated along a 3D line at a fractional location.
fr: Renvoie un point interpolé le long d'une ligne 3D à un emplacement fractionnaire.

note: Tag: para
en: Returns a point interpolated along a 3D line at a fractional location. First argument must be a LINESTRING. Second argument is a float between 0 and 1 representing the point location as a fraction of line length. The M value is interpolated if present.
fr: Retourne un point interpolé sur une ligne. Le premier argument doit être une LINESTRING. Le second argument est un float8 entre 0 et 1 représentant la fraction de la longueur totale de la ligne où le point doit être situé.

note: Tag: para
en: computes points in 2D and then interpolates the values for Z and M, while this function computes points in 3D and only interpolates the M value.
fr: calcule des points en 2D et interpole ensuite les valeurs de Z et M, alors que cette fonction calcule des points en 3D et n'interpole que la valeur M.

note: Tag: para
en: Return point 20% along 3D line
fr: Point de retour 20% le long de la ligne 3D

note: Tag: refpurpose
en: Returns points interpolated along a line at a fractional interval.
fr: Renvoie des points interpolés le long d'une ligne à un intervalle fractionnaire.

note: Tag: para
en: Returns one or more points interpolated along a line at a fractional interval. The first argument must be a LINESTRING. The second argument is a float8 between 0 and 1 representing the spacing between the points as a fraction of line length. If the third argument is false, at most one point will be constructed (which is equivalent to <xref linkend="ST_LineInterpolatePoint"/>.)
fr: Renvoie un ou plusieurs points interpolés le long d'une ligne à un intervalle fractionnaire. Le premier argument doit être une LINESTRING. Le second argument est un float8 entre 0 et 1 représentant l'espacement entre les points en tant que fraction de la longueur de la ligne. Si le troisième argument est faux, un seul point sera construit (ce qui est équivalent à <xref linkend="ST_LineInterpolatePoint"/>.)

note: Tag: para
en: If the result has zero or one points, it is returned as a POINT. If it has two or more points, it is returned as a MULTIPOINT.
fr: Si le résultat a zéro ou un point, il est retourné sous forme de POINT. S'il a deux points ou plus, il est retourné sous la forme d'un MULTIPOINT.

note: Tag: para
en: A LineString with points interpolated every 20%
fr: Une ligne avec des points interpolés tous les 20 %

note: Tag: refpurpose
en: Returns the fractional location of the closest point on a line to a point.
fr: Renvoie l'emplacement fractionnaire du point le plus proche d'un point sur une ligne.

note: Tag: para
en: Returns a float between 0 and 1 representing the location of the closest point on a LineString to the given Point, as a fraction of <link linkend="ST_Length2D">2d line</link> length.
fr: Renvoie un flottant compris entre 0 et 1 représentant l'emplacement du point le plus proche du point donné sur une LineString, en tant que fraction de la <link linkend="ST_Length2D">ligne 2D</link> longueur.

note: Tag: para
en: You can use the returned location to extract a Point (<xref linkend="ST_LineInterpolatePoint"/>) or a substring (<xref linkend="ST_LineSubstring"/>).
fr: Vous pouvez utiliser l'emplacement renvoyé pour extraire un point (<xref linkend="ST_LineInterpolatePoint"/>) ou une sous-ligne (<xref linkend="ST_LineSubstring"/>).

note: Tag: para
en: This is useful for approximating numbers of addresses
fr: Cette méthode est utile pour calculer approximativement le nombre d'adresses

note: Tag: para
en: Changed: 2.1.0. Up to 2.0.x this was called ST_Line_Locate_Point.
fr: Modifié : 2.1.0. Jusqu'à la version 2.0.x, cette fonction était appelée ST_Line_Locate_Point.

note: Tag: refpurpose
en: Returns the part of a line between two fractional locations.
fr: Renvoie la partie d'une ligne située entre deux emplacements fractionnaires.

note: Tag: para
en: Computes the line which is the section of the input line starting and ending at the given fractional locations. The first argument must be a LINESTRING. The second and third arguments are values in the range [0, 1] representing the start and end locations as fractions of line length. The Z and M values are interpolated for added endpoints if present.
fr: Calcule la ligne qui est la section de la ligne d'entrée commençant et se terminant aux emplacements fractionnaires donnés. Le premier argument doit être un LINESTRING. Les deuxième et troisième arguments sont des valeurs dans l'intervalle [0, 1] représentant les emplacements de début et de fin en tant que fractions de la longueur de la ligne. Les valeurs Z et M sont interpolées pour les points d'extrémité ajoutés, le cas échéant.

note: Tag: para
en: If <varname>startfraction</varname> and <varname>endfraction</varname> have the same value this is equivalent to <xref linkend="ST_LineInterpolatePoint"/>.
fr: Si <varname>startfraction</varname> et <varname>endfraction</varname> ont la même valeur, cela équivaut à <xref linkend="ST_LineInterpolatePoint"/>.

note: Tag: para
en: This only works with LINESTRINGs. To use on contiguous MULTILINESTRINGs first join them with <xref linkend="ST_LineMerge"/>.
fr: Cette méthode ne fonctionne qu'avec les LINESTRING. Pour l'utiliser sur des MULTILINESTRINGs contigues, il faut d'abord les joindre avec <xref linkend="ST_LineMerge"/>.

note: Tag: para
en: Since release 1.1.1 this function interpolates M and Z values. Prior releases set Z and M to unspecified values.
fr: Depuis la version 1.1.1, cette fonction interpole les valeurs de M et Z. Les versions précédentes fixent Z et M à des valeurs non spécifiées.

note: Tag: para
en: Enhanced: 3.4.0 - Support for geography was introduced.
fr: Amélioration : 3.4.0 - La prise en charge de la géographie a été introduite.

note: Tag: para
en: Changed: 2.1.0. Up to 2.0.x this was called ST_Line_Substring.
fr: Modifié : 2.1.0. Jusqu'à la version 2.0.x, cette fonction était appelée ST_Line_Substring.

note: Tag: para
en: Availability: 1.1.0, Z and M supported added in 1.1.1
fr: Disponibilité : 1.1.0, prise en charge des Z et M ajoutée dans la 1.1.1

note: Tag: para
en: A LineString seen with 1/3 midrange overlaid (0.333, 0.666)
fr: Une LineString vue avec un intervalle tous les 1/3 (0.333, 0.666)

note: Tag: para
en: If start and end locations are the same, the result is a POINT.
fr: Si les points de départ et d'arrivée sont identiques, le résultat est un POINT.

note: Tag: para
en: A query to cut a LineString into sections of length 100 or shorter. It uses <varname>generate_series()</varname> with a CROSS JOIN LATERAL to produce the equivalent of a FOR loop.
fr: Une requête pour découper une LineString en sections de longueur 100 ou moins. Elle utilise <varname>generate_series()</varname> avec un CROSS JOIN LATERAL pour produire l'équivalent d'une boucle FOR.

note: Tag: para
en: Geography implementation measures along a spheroid, geometry along a line
fr: Mesures de mise en œuvre de la geography le long d'un sphéroïde, geometry le long d'une ligne

note: Tag: refpurpose
en: Returns the point(s) on a geometry that match a measure value.
fr: Renvoie le(s) point(s) d'une géométrie qui correspond(ent) à une valeur de mesure.

note: Tag: para
en: Returns the location(s) along a measured geometry that have the given measure values. The result is a Point or MultiPoint. Polygonal inputs are not supported.
fr: Renvoie le(s) emplacement(s) le long d'une géométrie mesurée qui possède(nt) les valeurs de mesure données. Le résultat est un point ou un multipoint. Les entrées polygonales ne sont pas prises en charge.

note: Tag: para
en: If <varname>offset</varname> is provided, the result is offset to the left or right of the input line by the specified distance. A positive offset will be to the left, and a negative one to the right.
fr: Si <varname>offset</varname> est fourni, le résultat est décalé à gauche ou à droite de la ligne d'entrée de la distance spécifiée. Un décalage positif se fera vers la gauche, et un décalage négatif vers la droite.

note: Tag: para
en: Use this function only for linear geometries with an M component
fr: Cette fonction n'est utilisée que pour les géométries linéaires avec une composante M

note: Tag: para
en: The semantic is specified by the <emphasis>ISO/IEC 13249-3 SQL/MM Spatial</emphasis> standard.
fr: La sémantique est spécifiée par la norme <emphasis>ISO/IEC 13249-3 SQL/MM Spatial</emphasis>.

note: Tag: para
en: Availability: 1.1.0 by old name ST_Locate_Along_Measure.
fr: Disponibilité : 1.1.0 sous l'ancien nom ST_Locate_Along_Measure.

note: Tag: para
en: Changed: 2.0.0 in prior versions this used to be called ST_Locate_Along_Measure.
fr: Modifié : 2.0.0 dans les versions précédentes, cette fonction était appelée ST_Locate_Along_Measure.

note: Tag: refpurpose
en: Returns the portions of a geometry that match a measure range.
fr: Renvoie les parties d'une géométrie qui correspondent à un intervalle de mesure.

note: Tag: para
en: Return a geometry (collection) with the portions of the input measured geometry that match the specified measure range (inclusively).
fr: Renvoie une géométrie (collection) contenant les parties de la géométrie mesurée en entrée qui correspondent à l'intervalle de mesure spécifié (inclusivement).

note: Tag: para
en: If the <varname>offset</varname> is provided, the result is offset to the left or right of the input line by the specified distance. A positive offset will be to the left, and a negative one to the right.
fr: Si le <varname>offset</varname> est fourni, le résultat est décalé à gauche ou à droite de la ligne d'entrée de la distance spécifiée. Un décalage positif se fera vers la gauche, et un décalage négatif vers la droite.

note: Tag: para
en: Clipping a non-convex POLYGON may produce invalid geometry.
fr: Couper un POLYGONE non convexe peut produire une géométrie non valide.

note: Tag: para
en: Availability: 1.1.0 by old name ST_Locate_Between_Measures.
fr: Disponibilité : 1.1.0 sous l'ancien nom ST_Locate_Between_Measures.

note: Tag: para
en: Changed: 2.0.0 - in prior versions this used to be called ST_Locate_Between_Measures.
fr: Modifié : 2.0.0 - dans les versions précédentes, cette fonction s'appelait ST_Locate_Between_Measures.

note: Tag: para
en: Enhanced: 3.0.0 - added support for POLYGON, TIN, TRIANGLE.
fr: Amélioration : 3.0.0 - ajout de la prise en charge du POLYGONE, du TIN et du TRIANGLE.

note: Tag: para
en: A LineString with the section between measures 2 and 8, offset to the left
fr: Une LineString avec la section entre les mesures 2 et 8, décalée vers la gauche

note: Tag: refpurpose
en: Returns the portions of a geometry that lie in an elevation (Z) range.
fr: Renvoie les parties d'une géométrie qui se trouvent dans un intervalle d'élévation (Z).

note: Tag: para
en: Returns a geometry (collection) with the portions of a geometry that lie in an elevation (Z) range.
fr: Renvoie une géométrie (collection) contenant les parties d'une géométrie qui se trouvent dans une plage d'élévation (Z).

note: Tag: para
en: Availability: 1.4.0
fr: Disponibilité : 1.4.0

note: Tag: refpurpose
en: Returns the interpolated measure of a geometry closest to a point.
fr: Renvoie la mesure interpolée d'une géométrie la plus proche d'un point.

note: Tag: para
en: Returns an interpolated measure value of a linear measured geometry at the location closest to the given point.
fr: Renvoie une valeur de mesure interpolée d'une géométrie linéaire mesurée à l'emplacement le plus proche du point donné.

note: Tag: refpurpose
en: Interpolates measures along a linear geometry.
fr: Interpole les mesures le long d'une géométrie linéaire.

note: Tag: para
en: Return a derived geometry with measure values linearly interpolated between the start and end points. If the geometry has no measure dimension, one is added. If the geometry has a measure dimension, it is over-written with new values. Only LINESTRINGS and MULTILINESTRINGS are supported.
fr: Renvoie une géométrie dérivée avec des valeurs de mesure interpolées linéairement entre les points de départ et d'arrivée. Si la géométrie n'a pas de dimension de mesure, une dimension est ajoutée. Si la géométrie a une dimension de mesure, elle est remplacée par de nouvelles valeurs. Seuls les LINESTRINGS et MULTILINESTRINGS sont pris en charge.

note: Tag: title
en: Table Management Functions
fr: Fonctions de gestion des tables

note: Tag: para
en: These functions assist in defining tables containing geometry columns.
fr: Ces fonctions permettent de définir des tables contenant des colonnes géométriques.

note: Tag: refpurpose
en: Adds a geometry column to an existing table.
fr: Ajoute une colonne de géométrie à une table existante.

note: Tag: para
en: Adds a geometry column to an existing table of attributes. The <varname>schema_name</varname> is the name of the table schema. The <varname>srid</varname> must be an integer value reference to an entry in the SPATIAL_REF_SYS table. The <varname>type</varname> must be a string corresponding to the geometry type, eg, 'POLYGON' or 'MULTILINESTRING' . An error is thrown if the schemaname doesn't exist (or not visible in the current search_path) or the specified SRID, geometry type, or dimension is invalid.
fr: Ajoute une colonne géométrique à une table attributaire existante. <varname>schema_name</varname> est le nom du schéma de la table. <varname>srid</varname> est un entier positif présent dans la table SPATIAL_REF_SYS. <varname>type</varname> est le type de géométrie en texte, par exemple 'POLYGON' ou 'MULTILINESTRING'. Une erreur est renvoyée si le schéma n'existe pas (ou n'est pas visible dans le search_path courant) ou si le SRID, type de géométrie ou dimension est invalide.

note: Tag: para
en: Changed: 2.0.0 This function no longer updates geometry_columns since geometry_columns is a view that reads from system catalogs. It by default also does not create constraints, but instead uses the built in type modifier behavior of PostgreSQL. So for example building a wgs84 POINT column with this function is now equivalent to: <code>ALTER TABLE some_table ADD COLUMN geom geometry(Point,4326);</code>
fr: Changement : 2.0.0 Cette fonction ne met plus à jour geometry_columns maintenant que geometry_columns est une vue basée sur le catalogue système. Par défaut, elle ne créée plus de contraintes mais utilise le modificateur de type de PostgreSQL. Ainsi, par exemple, créer une colonne de type POINT WGS84 est désormais équivalent à : <code>ALTER TABLE some_table ADD COLUMN geom geometry(Point,4326) ;</code>

note: Tag: para
en: Changed: 2.0.0 If you require the old behavior of constraints use the default <varname>use_typmod</varname>, but set it to false.
fr: Changement : 2.0.0 Si l'ancien mécanisme basé sur les contraintes est nécessaire, utiliser le paramètre <varname>use_typmod</varname> avec la valeur false.

note: Tag: para
en: Changed: 2.0.0 Views can no longer be manually registered in geometry_columns, however views built against geometry typmod tables geometries and used without wrapper functions will register themselves correctly because they inherit the typmod behavior of their parent table column. Views that use geometry functions that output other geometries will need to be cast to typmod geometries for these view geometry columns to be registered correctly in geometry_columns. Refer to <xref linkend="Manual_Register_Spatial_Column"/>.
fr: Changement : 2.0.0 Les vues ne peuvent plus être enregistrées dans geometry_columns. Cependant, les vues construites à partir de tables contenant des géométries définies avec le modificateur de type et n'utilisant pas de fonctions d'encapsulation seront enregistrées dans la vue geometry_columns car elles héritent du mécanisme des tables dont elles sont issues. Les vues utilisant des fonctions renvoyant d'autres géométries doivent être transtypées vers des géométries avec modificateur de type pour pouvoir être correctement référencées dans la vue geometry_columns. Cf. <xref linkend="Manual_Register_Spatial_Column"/>.

note: Tag: para
en: Enhanced: 2.0.0 use_typmod argument introduced. Defaults to creating typmod geometry column instead of constraint-based.
fr: Amélioration : 2.0.0 introduction du paramètre use_typmod. Le comportement par défaut est de créer une colonne géométrique avec modificateur de type au lieu de contraintes sur la colonne.

note: Tag: refpurpose
en: Removes a geometry column from a spatial table.
fr: Supprime une colonne géométrique d'une table spatiale.

note: Tag: para
en: Removes a geometry column from a spatial table. Note that schema_name will need to match the f_table_schema field of the table's row in the geometry_columns table.
fr: Supprime une colonne géométrique d'une table spatiale. Note : schema_name doit correspondre au champ f_table_schema de la table geometry_columns.

note: Tag: para
en: Changed: 2.0.0 This function is provided for backward compatibility. Now that since geometry_columns is now a view against the system catalogs, you can drop a geometry column like any other table column using <code>ALTER TABLE</code>
fr: Changement : 2.0.0 Fonction assurant la rétro compatibilité. Maintenant que geometry_columns est une vue basée sur les catalogues du système, la colonne géométrique peut être supprimée d'une table comme tout autre colonne en utilisant <code>ALTER TABLE</code>

note: Tag: refpurpose
en: Drops a table and all its references in geometry_columns.
fr: Supprime une table et toutes ces références dans geometry_columns.

note: Tag: para
en: Drops a table and all its references in geometry_columns. Note: uses current_schema() on schema-aware pgsql installations if schema is not provided.
fr: Supprime une table et toutes ces références dans geometry_columns. Note : utilise la fonction current_schema() sur les installations PostgreSQL le supportant, si le schéma n'est pas fourni.

note: Tag: para
en: Changed: 2.0.0 This function is provided for backward compatibility. Now that since geometry_columns is now a view against the system catalogs, you can drop a table with geometry columns like any other table using <code>DROP TABLE</code>
fr: Changement : 2.0.0 Function assurant la rétro compatibilité. Maintenant que geometry_columns est une vue basée sur les catalogues du système, une table spatiale peut etre supprimée comme tout autre table en utilisant <code>ALTER TABLE</code>

note: Tag: refpurpose
en: Returns the SRID defined for a geometry column.
fr: Renvoie le SRID défini pour une colonne géométrique.

note: Tag: para
en: Returns the integer SRID of the specified geometry column by searching through the GEOMETRY_COLUMNS table. If the geometry column has not been properly added (e.g. with the <xref linkend="AddGeometryColumn"/> function), this function will not work.
fr: Renvoie le SRID entier de la colonne géométrique spécifiée en effectuant une recherche dans la table GEOMETRY_COLUMNS. Si la colonne géométrique n'a pas été correctement ajoutée (par exemple avec la fonction <xref linkend="AddGeometryColumn"/>), cette fonction ne fonctionnera pas.

note: Tag: refpurpose
en: Ensures geometry columns are defined with type modifiers or have appropriate spatial constraints.
fr: Assure que les colonnes géométriques sont définies avec des modificateurs de type ou qu'elles sont soumises à des contraintes spatiales appropriées.

note: Tag: para
en: Ensures geometry columns have appropriate type modifiers or spatial constraints to ensure they are registered correctly in the <varname>geometry_columns</varname> view. By default will convert all geometry columns with no type modifier to ones with type modifiers.
fr: S'assure que les colonnes géométriques ont des modificateurs de type ou des contraintes spatiales appropriés pour garantir qu'elles sont enregistrées correctement dans la vue <varname>geometry_columns</varname>. Par défaut, convertira toutes les colonnes géométriques sans modificateur de type en colonnes avec modificateur de type.

note: Tag: para
en: For backwards compatibility and for spatial needs such as table inheritance where each child table may have different geometry type, the old check constraint behavior is still supported. If you need the old behavior, you need to pass in the new optional argument as false <varname>use_typmod=false</varname>. When this is done geometry columns will be created with no type modifiers but will have 3 constraints defined. In particular, this means that every geometry column belonging to a table has at least three constraints:
fr: Pour conserver la rétro compatibilité et pour des besoins particuliers comme par exemple des tables héritées ayant des types géométriques différents, l'ancien mécanisme est toujours supporté. Si ce mécanisme est nécessaire, le nouveau paramètre optionnel doit être mis à false : <varname>use_typmod=false</varname>. Avec cette valeur, la colonne géométrique sera créée sans modificateur de type mais 3 contraintes seront définies. Cela signifie concrètement que chaque colonne géométrique de la table aura au moins 3 contraintes :

note: Tag: para
en: <varname>enforce_dims_geom</varname> - ensures every geometry has the same dimension (see <xref linkend="ST_NDims"/>)
fr: <varname>enforce_dims_geom</varname> - garantit que chaque géométrie a la même dimension (voir <xref linkend="ST_NDims"/>)

note: Tag: para
en: <varname>enforce_geotype_geom</varname> - ensures every geometry is of the same type (see <xref linkend="GeometryType"/>)
fr: <varname>enforce_geotype_geom</varname> - garantit que chaque géométrie est du même type (voir <xref linkend="GeometryType"/>)

note: Tag: para
en: <varname>enforce_srid_geom</varname> - ensures every geometry is in the same projection (see <xref linkend="ST_SRID"/>)
fr: <varname>enforce_srid_the_geom</varname> - s'assure que toutes les géométries sont dans la même projection (see <xref linkend="ST_SRID"/>)

note: Tag: para
en: If a table <varname>oid</varname> is provided, this function tries to determine the srid, dimension, and geometry type of all geometry columns in the table, adding constraints as necessary. If successful, an appropriate row is inserted into the geometry_columns table, otherwise, the exception is caught and an error notice is raised describing the problem.
fr: Si un identifiant de table <varname>oid</varname> est fourni, cette fonction tente de déterminer le SRID, la dimension et le type géométrique de toutes les colonnes géométriques de la table, ajoutant des contraintes si nécessaire. En cas de succès, une ligne est insérée dans la table geometry_columns, sinon, une erreur est affichée indiquant le problème.

note: Tag: para
en: If the <varname>oid</varname> of a view is provided, as with a table oid, this function tries to determine the srid, dimension, and type of all the geometries in the view, inserting appropriate entries into the <varname>geometry_columns</varname> table, but nothing is done to enforce constraints.
fr: Si le <varname>oid</varname> d'une vue est fourni, comme avec un oid de table, cette fonction essaie de déterminer le srid, la dimension et le type de toutes les géométries de la vue, en insérant les entrées appropriées dans la table <varname>geometry_columns</varname>, mais rien n'est fait pour appliquer les contraintes.

note: Tag: para
en: The parameterless variant is a simple wrapper for the parameterized variant that first truncates and repopulates the geometry_columns table for every spatial table and view in the database, adding spatial constraints to tables where appropriate. It returns a summary of the number of geometry columns detected in the database and the number that were inserted into the <varname>geometry_columns</varname> table. The parameterized version simply returns the number of rows inserted into the <varname>geometry_columns</varname> table.
fr: La version sans paramètre est un raccourci pour la version avec paramètres. Elle vide puis remplit la table geometry_columns pour chaque table ou vue spatiale de la base, ajoutant les contraintes aux tables si besoin. Retourne un résumé montrant le nombre de colonnes géométriques identifiées dans la base et le nombre inséré dans la table <varname>geometry_columns</varname>. La version avec paramètres renvoie juste le nombre de lignes insérées dans la table <varname>geometry_columns</varname> .

note: Tag: para
en: Changed: 2.0.0 By default, now uses type modifiers instead of check constraints to constrain geometry types. You can still use check constraint behavior instead by using the new <varname>use_typmod</varname> and setting it to false.
fr: Changement : 2.0.0 Par défaut, utilise les modificateurs de type au lieu de contraintes de vérification pour contraindre les types géométriques. Le comportement basé sur les contraintes peut être activé en mettant le nouveau paramètre <varname>use_typmod</varname> à false.

note: Tag: para
en: Enhanced: 2.0.0 <varname>use_typmod</varname> optional argument was introduced that allows controlling if columns are created with typmodifiers or with check constraints.
fr: Amélioration : 2.0.0 L'argument optionnel <varname>use_typmod</varname> a été introduit pour controler si les colonnes sont créés avec des modificateurs de type ou des contraintes de vérification.

note: Tag: refpurpose
en: Updates the SRID of all features in a geometry column, and the table metadata.
fr: Met à jour le SRID de tous les éléments d'une colonne géométrique et les métadonnées de la table.

note: Tag: para
en: Updates the SRID of all features in a geometry column, updating constraints and reference in geometry_columns. If the column was enforced by a type definition, the type definition will be changed. Note: uses current_schema() on schema-aware pgsql installations if schema is not provided.
fr: Met à jour le SRID de tous les objets d'une colonne géométrique et met à jour les métadonnées de geometry_columns et la contrainte sur le SRID. Note : utilise la fonction current_schema() sur les installations PostgreSQL le supportant, si le schéma n'est pas fourni.

note: Tag: para
en: Insert geometries into roads table with a SRID set already using <link linkend="ST_GeomFromEWKT">EWKT format</link>:
fr: Insérer des géométries dans une table roads avec un jeu de SRID utilisant déjà le format <link linkend="ST_GeomFromEWKT">EWKT</link> :

note: Tag: para
en: This will change the srid of the roads table to 4326 from whatever it was before:
fr: Cela va changer le srid de la table roads à 4326 quelle que soit sa valeur avant :

note: Tag: para
en: The prior example is equivalent to this DDL statement:
fr: L'exemple précédent est équivalent à cette requête DDL :

note: Tag: para
en: If you got the projection wrong (or brought it in as unknown) in load and you wanted to transform to web mercator all in one shot you can do this with DDL but there is no equivalent PostGIS management function to do so in one go.
fr: Si vous vous êtes trompé de projection (ou si vous l'avez introduite en tant qu'inconnue) dans le chargement et que vous voulez transformer en mercator web en une seule fois, vous pouvez le faire avec DDL mais il n'y a pas de fonction de gestion PostGIS équivalente pour le faire en une seule fois.

note: Tag: title
en: Measurement Functions
fr: Fonctions de mesure

note: Tag: para
en: These functions compute measurements of distance, area and angles. There are also functions to compute geometry values determined by measurements.
fr: Ces fonctions permettent de calculer des mesures de distance, de surface et d'angle. Il existe également des fonctions permettant de calculer les valeurs géométriques déterminées par les mesures.

note: Tag: refpurpose
en: Returns the area of a polygonal geometry.
fr: Renvoie l'aire d'une géométrie polygonale.

note: Tag: para
en: Returns the area of a polygonal geometry. For geometry types a 2D Cartesian (planar) area is computed, with units specified by the SRID. For geography types by default area is determined on a spheroid with units in square meters. To compute the area using the faster but less accurate spherical model use <varname>ST_Area(geog,false)</varname>.
fr: Renvoie l'aire d'une géométrie polygonale. Pour les types geometry, une surface cartésienne 2D (planaire) est calculée, avec des unités spécifiées par le SRID. Pour les types geography, la surface est déterminée par défaut sur un sphéroïde avec des unités en mètres carrés. Pour calculer la surface en utilisant le modèle sphérique, plus rapide mais moins précis, utilisez <varname>ST_Area(geog,false)</varname>.

note: Tag: para
en: Enhanced: 2.0.0 - support for 2D polyhedral surfaces was introduced.
fr: Amélioration : 2.0.0 - la prise en charge des surfaces polyédriques 2D a été introduite.

note: Tag: para
en: Enhanced: 2.2.0 - measurement on spheroid performed with GeographicLib for improved accuracy and robustness. Requires PROJ &gt;= 4.9.0 to take advantage of the new feature.
fr: Amélioration : 2.2.0 - mesure sur sphéroïde effectuée avec GeographicLib pour une meilleure précision et robustesse. Nécessite PROJ &gt;= 4.9.0 pour profiter de la nouvelle fonctionnalité.

note: Tag: para
en: Changed: 3.0.0 - does not depend on SFCGAL anymore.
fr: Modifié : 3.0.0 - ne dépend plus de SFCGAL.

note: Tag: para
en: For polyhedral surfaces, only supports 2D polyhedral surfaces (not 2.5D). For 2.5D, may give a non-zero answer, but only for the faces that sit completely in XY plane.
fr: Pour les surfaces polyédriques, ne prend en charge que les surfaces polyédriques 2D (pas 2.5D). Pour les surfaces 2.5D, la réponse peut être différente de zéro, mais uniquement pour les faces qui se trouvent entièrement dans le plan XY.

note: Tag: para
en: Return area in square feet for a plot of Massachusetts land and multiply by conversion to get square meters. Note this is in square feet because EPSG:2249 is Massachusetts State Plane Feet
fr: Retourne la superficie en pieds carrés d'un terrain du Massachusetts et multipliez par la conversion pour obtenir des mètres carrés. Notez que la surface est exprimée en pieds carrés, car EPSG:2249 correspond aux pieds de plan de l'État du Massachusetts

note: Tag: para
en: Return area square feet and transform to Massachusetts state plane meters (EPSG:26986) to get square meters. Note this is in square feet because 2249 is Massachusetts State Plane Feet and transformed area is in square meters since EPSG:26986 is state plane Massachusetts meters
fr: Retourne la surface en pieds carrés et transformez-la en mètres du plan de l'État du Massachusetts (EPSG:26986) pour obtenir des mètres carrés. Notez qu'il s'agit de pieds carrés car 2249 est le plan de l'État du Massachusetts en pieds et que la surface transformée est en mètres carrés car EPSG:26986 est le plan de l'État du Massachusetts en mètres

note: Tag: para
en: Return area square feet and square meters using geography data type. Note that we transform to our geometry to geography (before you can do that make sure your geometry is in WGS 84 long lat 4326). Geography always measures in meters. This is just for demonstration to compare. Normally your table will be stored in geography data type already.
fr: Retourne la surface en pieds carrés et en mètres carrés en utilisant le type de données geography. Notez que nous transformons notre geometry en geography (avant de pouvoir le faire, assurez-vous que votre géométrie est en WGS 84 long lat 4326). La geography se mesure toujours en mètres. Il s'agit d'une démonstration à des fins de comparaison. Normalement, votre table sera déjà stockée dans le type de données geography.

note: Tag: para
en: If your data is in geography already:
fr: Si vos données sont déjà dans le type geography :

note: Tag: refpurpose
en: Returns the north-based azimuth of a line between two points.
fr: Renvoie l'azimut basé sur le nord d'une ligne entre deux points.

note: Tag: para
en: Returns the azimuth in radians of the target point from the origin point, or NULL if the two points are coincident. The azimuth angle is a positive clockwise angle referenced from the positive Y axis (geometry) or the North meridian (geography): North = 0; Northeast = &#x03C0;/4; East = &#x03C0;/2; Southeast = 3&#x03C0;/4; South = &#x03C0;; Southwest 5&#x03C0;/4; West = 3&#x03C0;/2; Northwest = 7&#x03C0;/4.
fr: Renvoie l'azimut en radians du point cible par rapport au point d'origine, ou NULL si les deux points coïncident. L'angle d'azimut est un angle positif dans le sens des aiguilles d'une montre, référencé à partir de l'axe Y positif (geometry) ou du méridien Nord (geography) : North = 0; Northeast = &#x03C0;/4; East = &#x03C0;/2; Southeast = 3&#x03C0;/4; South = &#x03C0;; Southwest 5&#x03C0;/4; West = 3&#x03C0;/2; Northwest = 7&#x03C0;/4.

note: Tag: para
en: For the geography type, the azimuth solution is known as the <link xlink:href="https://en.wikipedia.org/wiki/Geodesics_on_an_ellipsoid">inverse geodesic problem</link>.
fr: Pour le type geography, la solution azimutale est connue sous le nom de <link xlink:href="https://en.wikipedia.org/wiki/Geodesics_on_an_ellipsoid">inverse geodesic problem</link>.

note: Tag: para
en: The azimuth is a mathematical concept defined as the angle between a reference vector and a point, with angular units in radians. The result value in radians can be converted to degrees using the PostgreSQL function <varname>degrees()</varname>.
fr: L'azimut est un concept mathématique défini comme l'angle entre un vecteur de référence et un point, avec des unités angulaires en radians. La valeur du résultat en radians peut être convertie en degrés à l'aide de la fonction PostgreSQL <varname>degrees()</varname>.

note: Tag: para
en: Azimuth can be used in conjunction with <xref linkend="ST_Translate"/> to shift an object along its perpendicular axis. See the <varname>upgis_lineshift()</varname> function in the <link xlink:href="http://trac.osgeo.org/postgis/wiki/UsersWikiplpgsqlfunctions">PostGIS wiki</link> for an implementation of this.
fr: L'azimut peut être utilisé conjointement avec <xref linkend="ST_Translate"/> pour déplacer un objet le long de son axe perpendiculaire. Voir la fonction <varname>upgis_lineshift()</varname> dans le <link xlink:href="http://trac.osgeo.org/postgis/wiki/UsersWikiplpgsqlfunctions">PostGIS wiki</link> pour une implémentation de ceci.

note: Tag: para
en: Enhanced: 2.0.0 support for geography was introduced.
fr: Amélioration : la prise en charge du type geography a été introduite dans la version 2.0.0.

note: Tag: para
en: Enhanced: 2.2.0 measurement on spheroid performed with GeographicLib for improved accuracy and robustness. Requires PROJ &gt;= 4.9.0 to take advantage of the new feature.
fr: Amélioration : 2.2.0 mesure sur sphéroïde effectuée avec GeographicLib pour améliorer la précision et la robustesse. Nécessite PROJ &gt;= 4.9.0 pour profiter de la nouvelle fonctionnalité.

note: Tag: para
en: Geometry Azimuth in degrees
fr: Geometry Azimut en degrés

note: Tag: para
en: Blue: origin Point(25,45); Green: target Point(75, 100); Yellow: Y axis or North; Red: azimuth angle.
fr: Bleu : origine Point(25,45) ; Vert : cible Point(75, 100) ; Jaune : axe Y ou Nord ; Rouge : angle d'azimut.

note: Tag: para
en: Blue: origin Point(75, 100); Green: target Point(25, 45); Yellow: Y axis or North; Red: azimuth angle.
fr: Bleu : origine Point(75, 100) ; Vert : cible Point(25, 45) ; Jaune : axe Y ou Nord ; Rouge : angle d'azimut.

note: Tag: refpurpose
en: Returns the angle between two vectors defined by 3 or 4 points, or 2 lines.
fr: Renvoie l'angle entre deux vecteurs définis par 3 ou 4 points, ou 2 lignes.

note: Tag: para
en: Computes the clockwise angle between two vectors.
fr: Calcule l'angle dans le sens des aiguilles d'une montre entre deux vecteurs.

note: Tag: para
en: <emphasis role="bold">Variant 1:</emphasis> computes the angle enclosed by the points P1-P2-P3. If a 4th point provided computes the angle points P1-P2 and P3-P4
fr: <emphasis role="bold">Variante 1:</emphasis> calcule l'angle formé par les points P1-P2-P3. Si un quatrième point est fourni, elle calcule l'angle formé par les points P1-P2 et P3-P4

note: Tag: para
en: <emphasis role="bold">Variant 2:</emphasis> computes the angle between two vectors S1-E1 and S2-E2, defined by the start and end points of the input lines
fr: <emphasis role="bold">Variante 2:</emphasis> calcule l'angle entre deux vecteurs S1-E1 et S2-E2, définis par les points de départ et d'arrivée des lignes d'entrée

note: Tag: para
en: The result is a positive angle between 0 and 2&#x03C0; radians. The radian result can be converted to degrees using the PostgreSQL function <varname>degrees()</varname>.
fr: Le résultat est un angle positif compris entre 0 et 2&#x03C0; radians. Le résultat en radians peut être converti en degrés à l'aide de la fonction PostgreSQL <varname>degrees()</varname>.

note: Tag: para
en: Note that <varname>ST_Angle(P1,P2,P3) = ST_Angle(P2,P1,P2,P3)</varname>.
fr: Notez que <varname>ST_Angle(P1,P2,P3) = ST_Angle(P2,P1,P2,P3)</varname>.

note: Tag: para
en: Angle between three points
fr: Angle entre trois points

note: Tag: para
en: Angle between vectors defined by four points
fr: Angle entre les vecteurs définis par quatre points

note: Tag: para
en: Angle between vectors defined by the start and end points of lines
fr: Angle entre les vecteurs définis par les points de départ et d'arrivée des lignes

note: Tag: refpurpose
en: Returns the 2D point on g1 that is closest to g2. This is the first point of the shortest line from one geometry to the other.
fr: Renvoie le point 2D sur g1 qui est le plus proche de g2. Il s'agit du premier point de la ligne la plus courte d'une géométrie à l'autre.

note: Tag: para
en: Returns the 2-dimensional point on <varname>geom1</varname> that is closest to <varname>geom2</varname>. This is the first point of the shortest line between the geometries (as computed by <xref linkend="ST_ShortestLine"/>).
fr: Renvoie le point bidimensionnel sur <varname>geom1</varname> qui est le plus proche de <varname>geom2</varname>. Il s'agit du premier point de la ligne la plus courte entre les géométries (telle que calculée par <xref linkend="ST_ShortestLine"/>).

note: Tag: para
en: If you have a 3D Geometry, you may prefer to use <xref linkend="ST_3DClosestPoint"/>.
fr: Si vous avez une géométrie 3D, vous préférerez peut-être utiliser <xref linkend="ST_3DClosestPoint"/>.

note: Tag: para
en: Enhanced: 3.4.0 - Support for geography.
fr: Amélioré : 3.4.0 - Prise en charge de la geography.

note: Tag: para
en: The closest point for a Point and a LineString is the point itself. The closest point for a LineString and a Point is a point on the line.
fr: Le point le plus proche d'un point et d'une LineString est le point lui-même. Le point le plus proche d'une LineString et d'un Point est un point de la ligne.

note: Tag: para
en: The closest point on polygon A to polygon B
fr: Le point du polygone A le plus proche du polygone B

note: Tag: refpurpose
en: Returns the 3D point on g1 that is closest to g2. This is the first point of the 3D shortest line.
fr: Renvoie le point 3D sur g1 qui est le plus proche de g2. Il s'agit du premier point de la ligne 3D la plus courte.

note: Tag: para
en: Returns the 3-dimensional point on g1 that is closest to g2. This is the first point of the 3D shortest line. The 3D length of the 3D shortest line is the 3D distance.
fr: Renvoie le point tridimensionnel de g1 le plus proche de g2. Il s'agit du premier point de la ligne 3D la plus courte. La longueur 3D de la ligne 3D la plus courte est la distance 3D.

note: Tag: para
en: Changed: 2.2.0 - if 2 2D geometries are input, a 2D point is returned (instead of old behavior assuming 0 for missing Z). In case of 2D and 3D, Z is no longer assumed to be 0 for missing Z.
fr: Modifié : 2.2.0 - si 2 géométries 2D sont saisies, un point 2D est renvoyé (au lieu de l'ancien comportement supposant 0 pour Z manquant). Dans le cas de 2D et 3D, Z n'est plus supposé être 0 pour Z manquant.

note: Tag: para
en: linestring and point -- both 3d and 2d closest point
fr: ligne et point -- point le plus proche en 3d et 2d

note: Tag: para
en: linestring and multipoint -- both 3d and 2d closest point
fr: ligne et multipoint - point le plus proche en 3d et en 2d

note: Tag: para
en: Multilinestring and polygon both 3d and 2d closest point
fr: Multilignes et polygones en 3d et 2d point le plus proche

note: Tag: refpurpose
en: Returns the distance between two geometry or geography values.
fr: Renvoie la distance entre deux valeurs de geometry ou geography.

note: Tag: para
en: For <xref linkend="geometry"/> types returns the minimum 2D Cartesian (planar) distance between two geometries, in projected units (spatial ref units).
fr: Pour les types <xref linkend="geometry"/>, renvoie la distance cartésienne (planaire) minimale en 2D entre deux géométries, en unités projetées (unités de référence spatiales).

note: Tag: para
en: For <xref linkend="geography"/> types defaults to return the minimum geodesic distance between two geographies in meters, compute on the spheroid determined by the SRID. If <varname>use_spheroid</varname> is false, a faster spherical calculation is used.
fr: Pour les types <xref linkend="geography"/>, la valeur par défaut est la distance géodésique minimale entre deux géographies en mètres, calculée sur le sphéroïde déterminé par le SRID. Si <varname>use_spheroid</varname> est faux, un calcul sphérique plus rapide est utilisé.

note: Tag: para
en: Availability: 1.5.0 geography support was introduced in 1.5. Speed improvements for planar to better handle large or many vertex geometries
fr: Disponibilité : 1.5.0 La prise en charge du type geography a été introduite dans la version 1.5. Amélioration de la vitesse pour les géométries planaires afin de mieux gérer les géométries de grande taille ou à nombreux sommets

note: Tag: para
en: Enhanced: 2.1.0 improved speed for geography. See <link xlink:href="http://boundlessgeo.com/2012/07/making-geography-faster/">Making Geography faster</link> for details.
fr: Amélioration : la version 2.1.0 a amélioré la vitesse pour le type geography. Voir <link xlink:href="http://boundlessgeo.com/2012/07/making-geography-faster/">Making Geography faster</link> pour plus de détails.

note: Tag: para
en: Enhanced: 2.1.0 - support for curved geometries was introduced.
fr: Amélioration : 2.1.0 - la prise en charge des géométries courbes a été introduite.

note: Tag: title
en: Geometry Examples
fr: Exemples de géométrie

note: Tag: para
en: Geometry example - units in planar degrees 4326 is WGS 84 long lat, units are degrees.
fr: Exemple de géométrie - unités en degrés planaires 4326 est le long lat WGS 84, les unités sont des degrés.

note: Tag: para
en: Geometry example - units in meters (SRID: 3857, proportional to pixels on popular web maps). Although the value is off, nearby ones can be compared correctly, which makes it a good choice for algorithms like KNN or KMeans.
fr: Exemple de géométrie - unités en mètres (SRID : 3857, proportionnel aux pixels sur les cartes web populaires). Bien que la valeur soit erronée, les valeurs proches peuvent être comparées correctement, ce qui en fait un bon choix pour des algorithmes tels que KNN ou KMeans.

note: Tag: para
en: Geometry example - units in meters (SRID: 3857 as above, but corrected by cos(lat) to account for distortion)
fr: Exemple de géométrie - unités en mètres (SRID : 3857 comme ci-dessus, mais corrigé par cos(lat) pour tenir compte de la distorsion)

note: Tag: para
en: Geometry example - units in meters (SRID: 26986 Massachusetts state plane meters) (most accurate for Massachusetts)
fr: Exemple de géométrie - unités en mètres (SRID : 26986 Massachusetts state plane meters) (plus précis pour le Massachusetts)

note: Tag: para
en: Geometry example - units in meters (SRID: 2163 US National Atlas Equal area) (least accurate)
fr: Exemple de géométrie - unités en mètres (SRID : 2163 US National Atlas Equal area) (moins précis)

note: Tag: title
en: Geography Examples
fr: Exemples géographiques

note: Tag: para
en: Same as geometry example but note units in meters - use sphere for slightly faster and less accurate computation.
fr: Identique à l'exemple du type geometry, mais avec des unités en mètres - utiliser la sphère pour un calcul légèrement plus rapide et moins précis.

note: Tag: refpurpose
en: Returns the 3D cartesian minimum distance (based on spatial ref) between two geometries in projected units.
fr: Renvoie la distance cartésienne minimale en 3D (basée sur la référence spatiale) entre deux géométries en unités projetées.

note: Tag: para
en: Returns the 3-dimensional minimum cartesian distance between two geometries in projected units (spatial ref units).
fr: Renvoie la distance cartésienne minimale tridimensionnelle entre deux géométries en unités projetées (unités de référence spatiales).

note: Tag: para
en: Changed: 2.2.0 - In case of 2D and 3D, Z is no longer assumed to be 0 for missing Z.
fr: Modifié : 2.2.0 - Dans le cas de la 2D et de la 3D, Z n'est plus considéré comme égal à 0 en cas de Z manquant.

note: Tag: para
en: Changed: 3.0.0 - SFCGAL version removed
fr: Modifié : 3.0.0 - Version SFCGAL supprimée

note: Tag: refpurpose
en: Returns minimum distance in meters between two lon/lat geometries using a spherical earth model.
fr: Renvoie la distance minimale en mètres entre deux géométries lon/lat en utilisant un modèle de terre sphérique.

note: Tag: para
en: Returns minimum distance in meters between two lon/lat points. Uses a spherical earth and radius derived from the spheroid defined by the SRID. Faster than <xref linkend="ST_Distance_Spheroid"/>, but less accurate. PostGIS Versions prior to 1.5 only implemented for points.
fr: Renvoie la distance minimale en mètres entre deux points lon/lat. Utilise une terre sphérique et un rayon dérivé du sphéroïde défini par le SRID. Plus rapide que <xref linkend="ST_Distance_Spheroid"/>, mais moins précis. PostGIS Versions antérieures à la version 1.5 uniquement pour les points.

note: Tag: para
en: Availability: 1.5 - support for other geometry types besides points was introduced. Prior versions only work with points.
fr: Disponibilité : 1.5 - la prise en charge d'autres types de géométrie que les points a été introduite. Les versions précédentes ne fonctionnaient qu'avec des points.

note: Tag: para
en: Changed: 2.2.0 In prior versions this used to be called ST_Distance_Sphere
fr: Modifié : 2.2.0 Dans les versions antérieures, cette fonction s'appelait ST_Distance_Sphere

note: Tag: refpurpose
en: Returns the minimum distance between two lon/lat geometries using a spheroidal earth model.
fr: Renvoie la distance minimale entre deux géométries lon/lat en utilisant un modèle de terre sphéroïdale.

note: Tag: para
en: Returns minimum distance in meters between two lon/lat geometries given a particular spheroid. See the explanation of spheroids given for <xref linkend="ST_Length_Spheroid"/>.
fr: Renvoie la distance minimale en mètres entre deux géométries lon/lat pour un sphéroïde donné. Voir l'explication des sphéroïdes donnée pour <xref linkend="ST_Length_Spheroid"/>.

note: Tag: para
en: This function does not look at the SRID of the geometry. It assumes the geometry coordinates are based on the provided spheroid.
fr: Cette fonction ne prend pas en compte le SRID de la géométrie. Elle suppose que les coordonnées de la géométrie sont basées sur le sphéroïde fourni.

note: Tag: para
en: Changed: 2.2.0 In prior versions this was called ST_Distance_Spheroid
fr: Modifié : 2.2.0 Dans les versions précédentes, cette fonction était appelée ST_Distance_Sphéroïde

note: Tag: refpurpose
en: Returns the Fréchet distance between two geometries.
fr: Renvoie la distance de Fréchet entre deux géométries.

note: Tag: para
en: Implements algorithm for computing the Fréchet distance restricted to discrete points for both geometries, based on <link xlink:href="http://www.kr.tuwien.ac.at/staff/eiter/et-archive/cdtr9464.pdf">Computing Discrete Fréchet Distance</link>. The Fréchet distance is a measure of similarity between curves that takes into account the location and ordering of the points along the curves. Therefore it is often better than the Hausdorff distance.
fr: Implémente l'algorithme de calcul de la distance de Fréchet limitée aux points discrets pour les deux géométries, basé sur <link xlink:href="http://www.kr.tuwien.ac.at/staff/eiter/et-archive/cdtr9464.pdf">Computing Discrete Fréchet Distance</link>. La distance de Fréchet est une mesure de similarité entre les courbes qui tient compte de l'emplacement et de l'ordre des points le long des courbes. Elle est donc souvent meilleure que la distance de Hausdorff.

note: Tag: para
en: When the optional densifyFrac is specified, this function performs a segment densification before computing the discrete Fréchet distance. The densifyFrac parameter sets the fraction by which to densify each segment. Each segment will be split into a number of equal-length subsegments, whose fraction of the total length is closest to the given fraction.
fr: Lorsque le paramètre optionnel densifyFrac est spécifié, cette fonction effectue une densification des segments avant de calculer la distance de Fréchet discrète. Le paramètre densifyFrac définit la fraction par laquelle chaque segment doit être densifié. Chaque segment sera divisé en un certain nombre de sous-segments de longueur égale, dont la fraction de la longueur totale est la plus proche de la fraction donnée.

note: Tag: para
en: Units are in the units of the spatial reference system of the geometries.
fr: Les unités sont celles du système de référence spatiale des géométries.

note: Tag: para
en: The current implementation supports only vertices as the discrete locations. This could be extended to allow an arbitrary density of points to be used.
fr: L'implémentation actuelle ne prend en charge que les sommets en tant qu'emplacements discrets. Elle pourrait être étendue pour permettre l'utilisation d'une densité arbitraire de points.

note: Tag: para
en: The smaller densifyFrac we specify, the more accurate Fréchet distance we get. But, the computation time and the memory usage increase with the square of the number of subsegments.
fr: Plus la valeur de densifyFrac spécifiée est petite, plus la distance de Fréchet est précise. Mais le temps de calcul et l'utilisation de la mémoire augmentent avec le carré du nombre de sous-segments.

note: Tag: para
en: Availability: 2.4.0 - requires GEOS &gt;= 3.7.0
fr: Disponibilité : 2.4.0 - nécessite GEOS &gt;= 3.7.0

note: Tag: refpurpose
en: Returns the Hausdorff distance between two geometries.
fr: Renvoie la distance de Hausdorff entre deux géométries.

note: Tag: para
en: Returns the <link xlink:href="http://en.wikipedia.org/wiki/Hausdorff_distance">Hausdorff distance</link> between two geometries. The Hausdorff distance is a measure of how similar or dissimilar 2 geometries are.
fr: Renvoie la <link xlink:href="http://en.wikipedia.org/wiki/Hausdorff_distance">distance de Hausdorff</link> entre deux géométries. La distance de Hausdorff est une mesure de la similarité ou de la dissemblance de deux géométries.

note: Tag: para
en: The function actually computes the "Discrete Hausdorff Distance". This is the Hausdorff distance computed at discrete points on the geometries. The <parameter>densifyFrac</parameter> parameter can be specified, to provide a more accurate answer by densifying segments before computing the discrete Hausdorff distance. Each segment is split into a number of equal-length subsegments whose fraction of the segment length is closest to the given fraction.
fr: La fonction calcule en fait la "Discrete Hausdorff Distance". Il s'agit de la distance de Hausdorff calculée en des points discrets des géométries. Le paramètre <parameter>densifyFrac</parameter> peut être spécifié pour fournir une réponse plus précise en densifiant les segments avant de calculer la distance discrète de Hausdorff. Chaque segment est divisé en un certain nombre de sous-segments de longueur égale dont la fraction de la longueur du segment est la plus proche de la fraction donnée.

note: Tag: para
en: This algorithm is NOT equivalent to the standard Hausdorff distance. However, it computes an approximation that is correct for a large subset of useful cases. One important case is Linestrings that are roughly parallel to each other, and roughly equal in length. This is a useful metric for line matching.
fr: Cet algorithme n'est PAS équivalent à la distance standard de Hausdorff. Cependant, il calcule une approximation qui est correcte pour un large sous-ensemble de cas utiles. Un cas important est celui des lignes qui sont à peu près parallèles les unes aux autres et dont la longueur est à peu près égale. Il s'agit d'une métrique utile pour l'appariement des lignes.

note: Tag: para
en: Hausdorff distance (red) and distance (yellow) between two lines
fr: Distance de Hausdorff (rouge) et distance (jaune) entre deux lignes

note: Tag: para
en: <emphasis role="bold">Example:</emphasis> Hausdorff distance with densification.
fr: <emphasis role="bold">Exemple:</emphasis> Distance de Hausdorff avec densification.

note: Tag: para
en: <emphasis role="bold">Example:</emphasis> For each building, find the parcel that best represents it. First we require that the parcel intersect with the building geometry. <code>DISTINCT ON</code> guarantees we get each building listed only once. <code>ORDER BY .. ST_HausdorffDistance</code> selects the parcel that is most similar to the building.
fr: <emphasis role="bold">Exemple:</emphasis> Pour chaque bâtiment, trouvez la parcelle qui le représente le mieux. Tout d'abord, nous exigeons que la parcelle intersecte la géométrie du bâtiment. <code>DISTINCT ON</code> garantit que chaque bâtiment ne sera listé qu'une seule fois. <code>ORDER BY .. ST_HausdorffDistance</code> sélectionne la parcelle qui est la plus similaire au bâtiment.

note: Tag: refpurpose
en: Returns the 2D length of a linear geometry.
fr: Renvoie la longueur 2D d'une géométrie linéaire.

note: Tag: para
en: For geometry types: returns the 2D Cartesian length of the geometry if it is a LineString, MultiLineString, ST_Curve, ST_MultiCurve. For areal geometries 0 is returned; use <xref linkend="ST_Perimeter"/> instead. The units of length is determined by the spatial reference system of the geometry.
fr: Pour les types geometry : renvoie la longueur cartésienne 2D de la géométrie s'il s'agit d'une LineString, MultiLineString, ST_Curve, ST_MultiCurve. Pour les géométries aréolaires, 0 est renvoyé ; utilisez <xref linkend="ST_Perimeter"/> à la place. Les unités de longueur sont déterminées par le système de référence spatial de la géométrie.

note: Tag: para
en: For geography types: computation is performed using the inverse geodesic calculation. Units of length are in meters. If PostGIS is compiled with PROJ version 4.8.0 or later, the spheroid is specified by the SRID, otherwise it is exclusive to WGS84. If <varname>use_spheroid = false</varname>, then the calculation is based on a sphere instead of a spheroid.
fr: Pour les types geography : le calcul est effectué en utilisant le calcul géodésique inverse. Les unités de longueur sont exprimées en mètres. Si PostGIS est compilé avec PROJ version 4.8.0 ou ultérieure, le sphéroïde est spécifié par le SRID, sinon il est exclusif à WGS84. Si <varname>use_spheroid = false</varname>, le calcul est basé sur une sphère au lieu d'un sphéroïde.

note: Tag: para
en: Currently for geometry this is an alias for ST_Length2D, but this may change to support higher dimensions.
fr: Actuellement, pour la géométrie, il s'agit d'un alias de ST_Length2D, mais cela pourrait changer pour prendre en charge des dimensions plus élevées.

note: Tag: para
en: Changed: 2.0.0 Breaking change -- in prior versions applying this to a MULTI/POLYGON of type geography would give you the perimeter of the POLYGON/MULTIPOLYGON. In 2.0.0 this was changed to return 0 to be in line with geometry behavior. Please use ST_Perimeter if you want the perimeter of a polygon
fr: Modifié : 2.0.0 Rupture -- dans les versions précédentes, appliquer ceci à un MULTI/POLYGONE de type geography donnait le périmètre du POLYGONE/MULTIPOLYGONE. Dans la version 2.0.0, cette fonction a été modifiée pour retourner 0 afin d'être en ligne avec le comportement de la géométrie. Veuillez utiliser ST_Perimeter si vous souhaitez obtenir le périmètre d'un polygone

note: Tag: para
en: For geography the calculation defaults to using a spheroidal model. To use the faster but less accurate spherical calculation use ST_Length(gg,false);
fr: Pour geography, le calcul utilise par défaut un modèle sphéroïdal. Pour utiliser le calcul sphérique, plus rapide mais moins précis, utilisez ST_Length(gg,false) ;

note: Tag: para
en: Availability: 1.5.0 geography support was introduced in 1.5.
fr: Disponibilité : 1.5.0 La prise en charge du type geography a été introduite dans la version 1.5.

note: Tag: para
en: Return length in feet for line string. Note this is in feet because EPSG:2249 is Massachusetts State Plane Feet
fr: Renvoie la longueur en pieds de la ligne. Notez que cette longueur est exprimée en pieds car EPSG:2249 correspond aux pieds du plan de l'État du Massachusetts

note: Tag: para
en: Return length of WGS 84 geography line
fr: Retourne la longueur d'une ligne de type geography avec le SRID WGS 84

note: Tag: refpurpose
en: Returns the 2D length of a linear geometry. Alias for <varname>ST_Length</varname>
fr: Renvoie la longueur 2D d'une géométrie linéaire. Alias de <varname>ST_Length</varname>

note: Tag: para
en: Returns the 2D length of the geometry if it is a linestring or multi-linestring. This is an alias for <varname>ST_Length</varname>
fr: Renvoie la longueur 2D de la géométrie s'il s'agit d'une ligne ou d'une multiligne. C'est un alias de <varname>ST_Length</varname>

note: Tag: refpurpose
en: Returns the 3D length of a linear geometry.
fr: Renvoie la longueur 3D d'une géométrie linéaire.

note: Tag: para
en: Returns the 3-dimensional or 2-dimensional length of the geometry if it is a LineString or MultiLineString. For 2-d lines it will just return the 2-d length (same as ST_Length and ST_Length2D)
fr: Renvoie la longueur tridimensionnelle ou bidimensionnelle de la géométrie s'il s'agit d'une LineString ou d'une MultiLineString. Pour les lignes à 2 dimensions, la longueur à 2 dimensions est renvoyée (comme ST_Length et ST_Length2D)

note: Tag: para
en: Changed: 2.0.0 In prior versions this used to be called ST_Length3D
fr: Modifié : 2.0.0 Dans les versions précédentes, cette fonction était appelée ST_Length3D

note: Tag: para
en: Return length in feet for a 3D cable. Note this is in feet because EPSG:2249 is Massachusetts State Plane Feet
fr: Longueur de retour en pieds pour un câble 3D. Notez que cette longueur est exprimée en pieds car EPSG:2249 correspond aux pieds du plan de l'État du Massachusetts

note: Tag: refpurpose
en: Returns the 2D or 3D length/perimeter of a lon/lat geometry on a spheroid.
fr: Renvoie la longueur/périmètre 2D ou 3D d'une géométrie lon/lat sur un sphéroïde.

note: Tag: para
en: Calculates the length or perimeter of a geometry on an ellipsoid. This is useful if the coordinates of the geometry are in longitude/latitude and a length is desired without reprojection. The spheroid is specified by a text value as follows:
fr: Calcule la longueur ou le périmètre d'une géométrie sur un ellipsoïde. Ceci est utile si les coordonnées de la géométrie sont en longitude/latitude et qu'une longueur est souhaitée sans reprojection. Le sphéroïde est spécifié par une valeur textuelle comme suit :

note: Tag: para
en: For example:
fr: Par exemple :

note: Tag: para
en: Changed: 2.2.0 In prior versions this was called ST_Length_Spheroid and had the alias ST_3DLength_Spheroid
fr: Modifié : 2.2.0 Dans les versions précédentes, cette fonction s'appelait ST_Length_Spheroid et avait l'alias ST_3DLength_Spheroid

note: Tag: refpurpose
en: Returns the 2D longest line between two geometries.
fr: Renvoie la ligne 2D la plus longue entre deux géométries.

note: Tag: para
en: Returns the 2-dimensional longest line between the points of two geometries. The line returned starts on <varname>g1</varname> and ends on <varname>g2</varname>.
fr: Renvoie la plus longue ligne bidimensionnelle entre les points de deux géométries. La ligne renvoyée commence sur <varname>g1</varname> et se termine sur <varname>g2</varname>.

note: Tag: para
en: The longest line always occurs between two vertices. The function returns the first longest line if more than one is found. The length of the line is equal to the distance returned by <xref linkend="ST_MaxDistance"/>.
fr: La ligne la plus longue se trouve toujours entre deux sommets. La fonction renvoie la première ligne la plus longue si plusieurs sont trouvées. La longueur de la ligne est égale à la distance renvoyée par <xref linkend="ST_MaxDistance"/>.

note: Tag: para
en: If g1 and g2 are the same geometry, returns the line between the two vertices farthest apart in the geometry. The endpoints of the line lie on the circle computed by <xref linkend="ST_MinimumBoundingCircle"/>.
fr: Si g1 et g2 sont la même géométrie, renvoie la ligne entre les deux sommets les plus éloignés l'un de l'autre dans la géométrie. Les extrémités de la ligne se trouvent sur le cercle calculé par <xref linkend="ST_MinimumBoundingCircle"/>.

note: Tag: para
en: Longest line between a point and a line
fr: Ligne la plus longue entre un point et une ligne

note: Tag: para
en: Longest line between two polygons
fr: Ligne la plus longue entre deux polygones

note: Tag: para
en: Longest line across a single geometry. The length of the line is equal to the Maximum Distance. The endpoints of the line lie on the Minimum Bounding Circle.
fr: Ligne la plus longue traversant une seule géométrie. La longueur de la ligne est égale à la distance maximale. Les extrémités de la ligne sont situées sur le cercle de délimitation minimal.

note: Tag: refpurpose
en: Returns the 3D longest line between two geometries
fr: Renvoie la ligne 3D la plus longue entre deux géométries

note: Tag: para
en: Returns the 3-dimensional longest line between two geometries. The function returns the first longest line if more than one. The line returned starts in g1 and ends in g2. The 3D length of the line is equal to the distance returned by <xref linkend="ST_3DMaxDistance"/>.
fr: Renvoie la ligne tridimensionnelle la plus longue entre deux géométries. La fonction renvoie la première ligne la plus longue s'il y en a plusieurs. La ligne retournée commence en g1 et se termine en g2. La longueur 3D de la ligne est égale à la distance renvoyée par <xref linkend="ST_3DMaxDistance"/>.

note: Tag: para
en: linestring and point -- both 3d and 2d longest line
fr: linestring et point -- ligne la plus longue 3d et 2d

note: Tag: para
en: linestring and multipoint -- both 3d and 2d longest line
fr: ligne et multipoint - ligne la plus longue en 3d et 2d

note: Tag: para
en: MultiLineString and Polygon both 3d and 2d longest line
fr: MultiLineString et Polygon ligne la plus longue 3d et 2d

note: Tag: refpurpose
en: Returns the 2D largest distance between two geometries in projected units.
fr: Renvoie la plus grande distance 2D entre deux géométries en unités projetées.

note: Tag: para
en: Returns the 2-dimensional maximum distance between two geometries, in projected units. The maximum distance always occurs between two vertices. This is the length of the line returned by <xref linkend="ST_LongestLine"/>.
fr: Renvoie la distance maximale en 2D entre deux géométries, en unités projetées. La distance maximale se situe toujours entre deux sommets. C'est la longueur de la ligne renvoyée par <xref linkend="ST_LongestLine"/>.

note: Tag: para
en: If g1 and g2 are the same geometry, returns the distance between the two vertices farthest apart in that geometry.
fr: Si g1 et g2 sont la même géométrie, renvoie la distance entre les deux sommets les plus éloignés dans cette géométrie.

note: Tag: para
en: Maximum distance between a point and lines.
fr: Distance maximale entre un point et des lignes.

note: Tag: para
en: Maximum distance between vertices of a single geometry.
fr: Distance maximale entre les sommets d'une même géométrie.

note: Tag: refpurpose
en: Returns the 3D cartesian maximum distance (based on spatial ref) between two geometries in projected units.
fr: Renvoie la distance maximale cartésienne 3D (basée sur la référence spatiale) entre deux géométries en unités projetées.

note: Tag: para
en: Returns the 3-dimensional maximum cartesian distance between two geometries in projected units (spatial ref units).
fr: Renvoie la distance cartésienne maximale tridimensionnelle entre deux géométries en unités projetées (unités de référence spatiales).

note: Tag: refpurpose
en: Returns the minimum clearance of a geometry, a measure of a geometry's robustness.
fr: Renvoie la clearance (le dégagement) d'une géométrie, une mesure de la robustesse d'une géométrie.

note: Tag: para
en: It is possible for a geometry to meet the criteria for validity according to <xref linkend="ST_IsValid"/> (polygons) or <xref linkend="ST_IsSimple"/> (lines), but to become invalid if one of its vertices is moved by a small distance. This can happen due to loss of precision during conversion to text formats (such as WKT, KML, GML, GeoJSON), or binary formats that do not use double-precision floating point coordinates (e.g. MapInfo TAB).
fr: Il est possible qu'une géométrie réponde aux critères de validité selon <xref linkend="ST_IsValid"/> (polygones) ou <xref linkend="ST_IsSimple"/> (lignes), mais qu'elle devienne invalide si l'un de ses sommets est déplacé d'une petite distance. Cela peut se produire en raison d'une perte de précision lors de la conversion vers des formats texte (tels que WKT, KML, GML, GeoJSON) ou des formats binaires qui n'utilisent pas de coordonnées en virgule flottante à double précision (par exemple, MapInfo TAB).

note: Tag: para
en: The minimum clearance is a quantitative measure of a geometry's robustness to change in coordinate precision. It is the largest distance by which vertices of the geometry can be moved without creating an invalid geometry. Larger values of minimum clearance indicate greater robustness.
fr: La clearance (le dégagement) minimum est une mesure quantitative de la résistance d'une géométrie aux changements de précision des coordonnées. Il s'agit de la plus grande distance à laquelle les sommets de la géométrie peuvent être déplacés sans créer une géométrie invalide. Des valeurs plus élevées de l'espace libre minimum indiquent une plus grande robustesse.

note: Tag: para
en: If a geometry has a minimum clearance of <varname>e</varname>, then:
fr: Si une géométrie a un dégagement minimal de <varname>e</varname>, alors.. :

note: Tag: para
en: No two distinct vertices in the geometry are closer than the distance <varname>e</varname>.
fr: Aucun des deux sommets distincts de la géométrie n'est plus proche que la distance <varname>e</varname>.

note: Tag: para
en: No vertex is closer than <varname>e</varname> to a line segment of which it is not an endpoint.
fr: Aucun sommet n'est plus proche que <varname>e</varname> d'un segment de ligne dont il n'est pas l'extrémité.

note: Tag: para
en: If no minimum clearance exists for a geometry (e.g. a single point, or a MultiPoint whose points are identical), the return value is <varname>Infinity</varname>.
fr: S'il n'existe pas de dégagement minimum pour une géométrie (par exemple un point unique ou un MultiPoint dont les points sont identiques), la valeur de retour est <varname>Infinity</varname>.

note: Tag: para
en: To avoid validity issues caused by precision loss, <xref linkend="ST_ReducePrecision"/> can reduce coordinate precision while ensuring that polygonal geometry remains valid.
fr: Pour éviter les problèmes de validité causés par la perte de précision, <xref linkend="ST_ReducePrecision"/> peut réduire la précision des coordonnées tout en s'assurant que la géométrie polygonale reste valide.

note: Tag: refpurpose
en: Returns the two-point LineString spanning a geometry's minimum clearance.
fr: Renvoie la chaîne de lignes à deux points couvrant le dégagement (clearance) minimum d'une géométrie.

note: Tag: para
en: Returns the two-point LineString spanning a geometry's minimum clearance. If the geometry does not have a minimum clearance, <varname>LINESTRING EMPTY</varname> is returned.
fr: Renvoie les 2 points d'une LineString couvrant le dégagement (clearance) minimum d'une géométrie. Si la géométrie n'a pas de dégagement (clearance) minimum, <varname>LINESTRING EMPTY</varname> est retourné.

note: Tag: para
en: Availability: 2.3.0 - requires GEOS &gt;= 3.6.0
fr: Disponibilité : 2.3.0 - nécessite GEOS &gt;= 3.6.0

note: Tag: refpurpose
en: Returns the length of the boundary of a polygonal geometry or geography.
fr: Renvoie la longueur de la limite d'une géométrie polygonale ou d'une géographie.

note: Tag: para
en: Returns the 2D perimeter of the geometry/geography if it is a ST_Surface, ST_MultiSurface (Polygon, MultiPolygon). 0 is returned for non-areal geometries. For linear geometries use <xref linkend="ST_Length"/>. For geometry types, units for perimeter measures are specified by the spatial reference system of the geometry.
fr: Renvoie le périmètre 2D d'une geometry/geography s'il s'agit d'une ST_Surface, ST_MultiSurface (Polygone, MultiPolygone). 0 est retourné pour les géométries non réelles. Pour les géométries linéaires, utiliser <xref linkend="ST_Length"/>. Pour les types geometry, les unités de mesure du périmètre sont spécifiées par le système de référence spatiale de la géométrie.

note: Tag: para
en: For geography types, the calculations are performed using the inverse geodesic problem, where perimeter units are in meters. If PostGIS is compiled with PROJ version 4.8.0 or later, the spheroid is specified by the SRID, otherwise it is exclusive to WGS84. If <varname>use_spheroid = false</varname>, then calculations will approximate a sphere instead of a spheroid.
fr: Pour les types geography, les calculs sont effectués en utilisant le problème géodésique inverse, où les unités de périmètre sont en mètres. Si PostGIS est compilé avec PROJ version 4.8.0 ou ultérieure, le sphéroïde est spécifié par le SRID, sinon il est exclusif à WGS84. Si <varname>use_spheroid = false</varname>, les calculs approcheront une sphère au lieu d'un sphéroïde.

note: Tag: para
en: Currently this is an alias for ST_Perimeter2D, but this may change to support higher dimensions.
fr: Il s'agit actuellement d'un alias de ST_Perimeter2D, mais cela pourrait changer pour prendre en charge des dimensions plus élevées.

note: Tag: para
en: Availability 2.0.0: Support for geography was introduced
fr: Disponibilité 2.0.0 : La prise en charge du type geography a été introduite

note: Tag: para
en: Return perimeter in feet for Polygon and MultiPolygon. Note this is in feet because EPSG:2249 is Massachusetts State Plane Feet
fr: Retourne le périmètre en pieds pour les polygones et les multi-polygones. Notez que ce périmètre est en pieds car EPSG:2249 est le plan de l'État du Massachusetts en pieds

note: Tag: para
en: Return perimeter in meters and feet for Polygon and MultiPolygon. Note this is geography (WGS 84 long lat)
fr: Renvoie le périmètre en mètres et en pieds pour les polygones et les multi-polygones. Notez qu'il s'agit de geography (WGS 84 long lat)

note: Tag: refpurpose
en: Returns the 2D perimeter of a polygonal geometry. Alias for <varname>ST_Perimeter</varname>.
fr: Renvoie le périmètre 2D d'une géométrie polygonale. Alias de <varname>ST_Perimeter</varname>.

note: Tag: para
en: Returns the 2-dimensional perimeter of a polygonal geometry.
fr: Renvoie le périmètre bidimensionnel d'une géométrie polygonale.

note: Tag: para
en: This is currently an alias for ST_Perimeter. In future versions ST_Perimeter may return the highest dimension perimeter for a geometry. This is still under consideration
fr: Il s'agit actuellement d'un alias de ST_Perimeter. Dans les versions futures, ST_Perimeter pourrait renvoyer le périmètre de la dimension la plus élevée pour une géométrie. Cette possibilité est encore à l'étude

note: Tag: refpurpose
en: Returns the 3D perimeter of a polygonal geometry.
fr: Renvoie le périmètre 3D d'une géométrie polygonale.

note: Tag: para
en: Returns the 3-dimensional perimeter of the geometry, if it is a polygon or multi-polygon. If the geometry is 2-dimensional, then the 2-dimensional perimeter is returned.
fr: Renvoie le périmètre tridimensionnel de la géométrie, s'il s'agit d'un polygone ou d'un multi-polygone. Si la géométrie est bidimensionnelle, le périmètre bidimensionnel est renvoyé.

note: Tag: para
en: Changed: 2.0.0 In prior versions this used to be called ST_Perimeter3D
fr: Modifié : 2.0.0 Dans les versions antérieures, il s'appelait ST_Perimeter3D

note: Tag: para
en: Perimeter of a slightly elevated polygon in the air in Massachusetts state plane feet
fr: Périmètre d'un polygone légèrement surélevé en l'air dans l'état du Massachusetts, en pieds de plan

note: Tag: refpurpose
en: Returns the 2D shortest line between two geometries
fr: Renvoie la ligne 2D la plus courte entre deux géométries

note: Tag: para
en: Returns the 2-dimensional shortest line between two geometries. The line returned starts in <varname>geom1</varname> and ends in <varname>geom2</varname>. If <varname>geom1</varname> and <varname>geom2</varname> intersect the result is a line with start and end at an intersection point. The length of the line is the same as <xref linkend="ST_Distance"/> returns for g1 and g2.
fr: Renvoie la ligne bidimensionnelle la plus courte entre deux géométries. La ligne renvoyée commence dans <varname>geom1</varname> et se termine dans <varname>geom2</varname>. Si <varname>geom1</varname> et <varname>geom2</varname> se croisent, le résultat est une ligne dont le début et la fin se situent à un point d'intersection. La longueur de la ligne est la même que celle que <xref linkend="ST_Distance"/> renvoie pour g1 et g2.

note: Tag: para
en: Enhanced: 3.4.0 - support for geography.
fr: Amélioré : 3.4.0 - Prise en charge de la geography.

note: Tag: para
en: Shortest line between Point and LineString
fr: Ligne la plus courte entre un point et une ligne

note: Tag: para
en: Shortest line between Polygons
fr: Ligne la plus courte entre les polygones

note: Tag: refpurpose
en: Returns the 3D shortest line between two geometries
fr: Renvoie la ligne 3D la plus courte entre deux géométries

note: Tag: para
en: Returns the 3-dimensional shortest line between two geometries. The function will only return the first shortest line if more than one, that the function finds. If g1 and g2 intersects in just one point the function will return a line with both start and end in that intersection-point. If g1 and g2 are intersecting with more than one point the function will return a line with start and end in the same point but it can be any of the intersecting points. The line returned will always start in g1 and end in g2. The 3D length of the line this function returns will always be the same as <xref linkend="ST_3DDistance"/> returns for g1 and g2.
fr: Renvoie la ligne tridimensionnelle la plus courte entre deux géométries. La fonction ne renvoie que la première ligne la plus courte, si la fonction en trouve plusieurs. Si g1 et g2 se croisent en un seul point, la fonction renvoie une ligne dont le début et la fin se trouvent à ce point d'intersection. Si g1 et g2 se croisent en plus d'un point, la fonction renvoie une ligne dont le début et la fin se situent au même point, mais qui peut être n'importe lequel des points d'intersection. La ligne renvoyée commencera toujours en g1 et se terminera en g2. La longueur 3D de la ligne renvoyée par cette fonction sera toujours la même que <xref linkend="ST_3DDistance"/> renvoie pour g1 et g2.

note: Tag: para
en: linestring and point -- both 3d and 2d shortest line
fr: ligne et point -- ligne la plus courte 3d et 2d

note: Tag: para
en: linestring and multipoint -- both 3d and 2d shortest line
fr: ligne et multipoint -- ligne la plus courte en 3d et 2d

note: Tag: para
en: MultiLineString and polygon both 3d and 2d shortest line
fr: MultiLineString et polygone -- ligne la plus courte 3d et 2d

note: Tag: title
en: Operators
fr: Opérateurs

note: Tag: title
en: Bounding Box Operators
fr: Opérateurs de Bounding Box

note: Tag: refpurpose
en: Returns <varname>TRUE</varname> if A's 2D bounding box intersects B's 2D bounding box.
fr: Renvoi <varname>VRAI</varname> si la boite englobante 2D de A intersecte la boite englobante 2D de B.

note: Tag: para
en: The <varname>&amp;&amp;</varname> operator returns <varname>TRUE</varname> if the 2D bounding box of geometry A intersects the 2D bounding box of geometry B.
fr: L'opérateur <varname>&amp;&amp;</varname> renvoi <varname>VRAI</varname> si la boite englobante 2D de la géométrie A intersecte la boite englobante 2D de la géométrie B.

note: Tag: para
en: This operand will make use of any indexes that may be available on the geometries.
fr: Cette opérande utilisera tous les index qui peuvent être disponibles sur les géométries.

note: Tag: para
en: Availability: 1.5.0 support for geography was introduced.
fr: Disponibilité : 1.5.0 le support de la géographie a été introduit.

note: Tag: refpurpose
en: Returns <varname>TRUE</varname> if a geometry's (cached) 2D bounding box intersects a 2D float precision bounding box (BOX2DF).
fr: Renvoie <varname>TRUE</varname> si la boîte de délimitation 2D (en cache) d'une géométrie intersecte une boîte de délimitation 2D de précision flottante (BOX2DF).

note: Tag: para
en: The <varname>&amp;&amp;</varname> operator returns <varname>TRUE</varname> if the cached 2D bounding box of geometry A intersects the 2D bounding box B, using float precision. This means that if B is a (double precision) box2d, it will be internally converted to a float precision 2D bounding box (BOX2DF)
fr: L'opérateur <varname>&amp;&amp;</varname> renvoie <varname>TRUE</varname> si la boîte de délimitation 2D mise en cache de la géométrie A intersecte la boîte de délimitation 2D B, en utilisant la précision float. Cela signifie que si B est un box2d (double précision), il sera converti en interne en une boîte de délimitation 2D à précision flottante (BOX2DF)

note: Tag: para
en: This operand is intended to be used internally by BRIN indexes, more than by users.
fr: Cet opérande est destiné à être utilisé en interne par les index BRIN, plus que par les utilisateurs.

note: Tag: para
en: Availability: 2.3.0 support for Block Range INdexes (BRIN) was introduced. Requires PostgreSQL 9.5+.
fr: Disponibilité : 2.3.0 le support des Block Range INdexes (BRIN) a été introduit. Nécessite PostgreSQL 9.5+.

note: Tag: refpurpose
en: Returns <varname>TRUE</varname> if a 2D float precision bounding box (BOX2DF) intersects a geometry's (cached) 2D bounding box.
fr: Renvoie <varname>TRUE</varname> si une boîte de délimitation 2D de précision flottante (BOX2DF) intersecte la boîte de délimitation 2D (mise en cache) d'une géométrie.

note: Tag: para
en: The <varname>&amp;&amp;</varname> operator returns <varname>TRUE</varname> if the 2D bounding box A intersects the cached 2D bounding box of geometry B, using float precision. This means that if A is a (double precision) box2d, it will be internally converted to a float precision 2D bounding box (BOX2DF)
fr: L'opérateur <varname>&amp;&amp;</varname> renvoie <varname>TRUE</varname> si la boîte de délimitation 2D A intersecte la boîte de délimitation 2D mise en cache de la géométrie B, en utilisant la précision float. Cela signifie que si A est un box2d (double précision), il sera converti en interne en une boîte de délimitation 2D à précision flottante (BOX2DF)

note: Tag: refpurpose
en: Returns <varname>TRUE</varname> if two 2D float precision bounding boxes (BOX2DF) intersect each other.
fr: Renvoie <varname>TRUE</varname> si deux boîtes de délimitation 2D à précision flottante (BOX2DF) se croisent.

note: Tag: para
en: The <varname>&amp;&amp;</varname> operator returns <varname>TRUE</varname> if two 2D bounding boxes A and B intersect each other, using float precision. This means that if A (or B) is a (double precision) box2d, it will be internally converted to a float precision 2D bounding box (BOX2DF)
fr: L'opérateur <varname>&amp;&amp;</varname> renvoie <varname>TRUE</varname> si deux boîtes de délimitation 2D A et B se croisent, en utilisant la précision float. Cela signifie que si A (ou B) est un box2d (double précision), il sera converti en interne en une boîte de délimitation 2D de précision flottante (BOX2DF)

note: Tag: para
en: This operator is intended to be used internally by BRIN indexes, more than by users.
fr: Cet opérateur est destiné à être utilisé en interne par les index BRIN, plus que par les utilisateurs.

note: Tag: refpurpose
en: Returns <varname>TRUE</varname> if A's n-D bounding box intersects B's n-D bounding box.
fr: Renvoie <varname>TRUE</varname> si la boîte de délimitation n-D de A intersecte la boîte de délimitation n-D de B.

note: Tag: para
en: The <varname>&amp;&amp;&amp;</varname> operator returns <varname>TRUE</varname> if the n-D bounding box of geometry A intersects the n-D bounding box of geometry B.
fr: L'opérateur <varname>&amp;&amp;&amp;</varname> renvoie <varname>TRUE</varname> si la boîte de délimitation n-D de la géométrie A intersecte la boîte de délimitation n-D de la géométrie B.

note: Tag: title
en: Examples: 3D LineStrings
fr: Exemples : LineStrings 3D

note: Tag: title
en: Examples: 3M LineStrings
fr: Exemples : LineStrings 3M

note: Tag: refpurpose
en: Returns <varname>TRUE</varname> if a geometry's (cached) n-D bounding box intersects a n-D float precision bounding box (GIDX).
fr: Renvoie <varname>TRUE</varname> si la boîte de délimitation n-D (en cache) d'une géométrie intersecte une boîte de délimitation de précision flottante n-D (GIDX).

note: Tag: para
en: The <varname>&amp;&amp;&amp;</varname> operator returns <varname>TRUE</varname> if the cached n-D bounding box of geometry A intersects the n-D bounding box B, using float precision. This means that if B is a (double precision) box3d, it will be internally converted to a float precision 3D bounding box (GIDX)
fr: L'opérateur <varname>&amp;&amp;&amp;</varname> renvoie <varname>TRUE</varname> si la boîte de délimitation n-D mise en cache de la géométrie A intersecte la boîte de délimitation n-D B, en utilisant la précision float. Cela signifie que si B est un box3d (double précision), il sera converti en interne en une boîte de délimitation 3D de précision flottante (GIDX)

note: Tag: refpurpose
en: Returns <varname>TRUE</varname> if a n-D float precision bounding box (GIDX) intersects a geometry's (cached) n-D bounding box.
fr: Renvoie <varname>TRUE</varname> si une boîte de délimitation de précision flottante n-D (GIDX) intersecte la boîte de délimitation n-D (mise en cache) d'une géométrie.

note: Tag: para
en: The <varname>&amp;&amp;&amp;</varname> operator returns <varname>TRUE</varname> if the n-D bounding box A intersects the cached n-D bounding box of geometry B, using float precision. This means that if A is a (double precision) box3d, it will be internally converted to a float precision 3D bounding box (GIDX)
fr: L'opérateur <varname>&amp;&amp;&amp;</varname> renvoie <varname>TRUE</varname> si la boîte de délimitation n-D A intersecte la boîte de délimitation n-D mise en cache de la géométrie B, en utilisant la précision float. Cela signifie que si A est un box3d (à double précision), il sera converti en interne en une boîte de délimitation 3D à précision flottante (GIDX)

note: Tag: refpurpose
en: Returns <varname>TRUE</varname> if two n-D float precision bounding boxes (GIDX) intersect each other.
fr: Renvoie <varname>TRUE</varname> si deux boîtes de délimitation (GIDX) de précision flottante n-D se croisent.

note: Tag: para
en: The <varname>&amp;&amp;&amp;</varname> operator returns <varname>TRUE</varname> if two n-D bounding boxes A and B intersect each other, using float precision. This means that if A (or B) is a (double precision) box3d, it will be internally converted to a float precision 3D bounding box (GIDX)
fr: L'opérateur <varname>&amp;&amp;&amp;</varname> renvoie <varname>TRUE</varname> si deux boîtes de délimitation n-D A et B se croisent, en utilisant la précision float. Cela signifie que si A (ou B) est un box3d (double précision), il sera converti en interne en une boîte de délimitation 3D de précision flottante (GIDX)

note: Tag: refpurpose
en: Returns <varname>TRUE</varname> if A's bounding box overlaps or is to the left of B's.
fr: Renvoie <varname>TRUE</varname> si la boîte englobante de A chevauche ou est à gauche de celle de B.

note: Tag: para
en: The <varname>&amp;&lt;</varname> operator returns <varname>TRUE</varname> if the bounding box of geometry A overlaps or is to the left of the bounding box of geometry B, or more accurately, overlaps or is NOT to the right of the bounding box of geometry B.
fr: L'opérateur <varname>&amp;&lt;</varname> renvoie <varname>TRUE</varname> si la boîte de délimitation de la géométrie A chevauche ou est à gauche de la boîte de délimitation de la géométrie B, ou plus exactement, chevauche ou n'est PAS à droite de la boîte de délimitation de la géométrie B.

note: Tag: refpurpose
en: Returns <varname>TRUE</varname> if A's bounding box overlaps or is below B's.
fr: Renvoie <varname>TRUE</varname> si la boîte englobante de A chevauche ou est inférieure à celle de B.

note: Tag: para
en: The <varname>&amp;&lt;|</varname> operator returns <varname>TRUE</varname> if the bounding box of geometry A overlaps or is below of the bounding box of geometry B, or more accurately, overlaps or is NOT above the bounding box of geometry B.
fr: L'opérateur <varname>&amp;&lt;|</varname> renvoie <varname>TRUE</varname> si la boîte de délimitation de la géométrie A chevauche ou est en dessous de la boîte de délimitation de la géométrie B, ou plus exactement, chevauche ou n'est PAS au-dessus de la boîte de délimitation de la géométrie B.

note: Tag: refpurpose
en: Returns <varname>TRUE</varname> if A' bounding box overlaps or is to the right of B's.
fr: Renvoie <varname>TRUE</varname> si la boîte de délimitation de A chevauche ou est à droite de celle de B.

note: Tag: para
en: The <varname>&amp;&gt;</varname> operator returns <varname>TRUE</varname> if the bounding box of geometry A overlaps or is to the right of the bounding box of geometry B, or more accurately, overlaps or is NOT to the left of the bounding box of geometry B.
fr: L'opérateur <varname>&amp;&gt;</varname> renvoie <varname>TRUE</varname> si la boîte de délimitation de la géométrie A chevauche ou est à droite de la boîte de délimitation de la géométrie B, ou plus exactement, chevauche ou n'est PAS à gauche de la boîte de délimitation de la géométrie B.

note: Tag: refpurpose
en: Returns <varname>TRUE</varname> if A's bounding box is strictly to the left of B's.
fr: Renvoie <varname>TRUE</varname> si la boîte de délimitation de A est strictement à gauche de celle de B.

note: Tag: para
en: The <varname>&lt;&lt;</varname> operator returns <varname>TRUE</varname> if the bounding box of geometry A is strictly to the left of the bounding box of geometry B.
fr: L'opérateur <varname>&lt;&lt;</varname> renvoie <varname>TRUE</varname> si la boîte de délimitation de la géométrie A est strictement à gauche de la boîte de délimitation de la géométrie B.

note: Tag: refpurpose
en: Returns <varname>TRUE</varname> if A's bounding box is strictly below B's.
fr: Renvoie <varname>TRUE</varname> si la boîte de délimitation de A est strictement inférieure à celle de B.

note: Tag: para
en: The <varname>&lt;&lt;|</varname> operator returns <varname>TRUE</varname> if the bounding box of geometry A is strictly below the bounding box of geometry B.
fr: L'opérateur <varname>&lt;&lt;|</varname> renvoie <varname>TRUE</varname> si la boîte de délimitation de la géométrie A est strictement inférieure à la boîte de délimitation de la géométrie B.

note: Tag: refpurpose
en: Returns <varname>TRUE</varname> if the coordinates and coordinate order geometry/geography A are the same as the coordinates and coordinate order of geometry/geography B.
fr: Renvoie <varname>TRUE</varname> si les coordonnées et l'ordre des coordonnées de la géométrie/géographie A sont les mêmes que les coordonnées et l'ordre des coordonnées de la géométrie/géographie B.

note: Tag: para
en: The <varname>&#61;</varname> operator returns <varname>TRUE</varname> if the coordinates and coordinate order geometry/geography A are the same as the coordinates and coordinate order of geometry/geography B. PostgreSQL uses the =, &lt;, and &gt; operators defined for geometries to perform internal orderings and comparison of geometries (ie. in a GROUP BY or ORDER BY clause).
fr: L'opérateur <varname>&#61;</varname> renvoie <varname>TRUE</varname> si les coordonnées et l'ordre des coordonnées de la géométrie/géographie A sont les mêmes que les coordonnées et l'ordre des coordonnées de la géométrie/géographie B. PostgreSQL utilise les opérateurs =, &lt;, et &gt; définis pour les géométries pour effectuer des classements internes et des comparaisons de géométries (c'est-à-dire dans une clause GROUP BY ou ORDER BY).

note: Tag: para
en: Only geometry/geography that are exactly equal in all respects, with the same coordinates, in the same order, are considered equal by this operator. For "spatial equality", that ignores things like coordinate order, and can detect features that cover the same spatial area with different representations, use <xref linkend="ST_OrderingEquals"/> or <xref linkend="ST_Equals"/>
fr: Seules les géométries/géographies qui sont exactement égales à tous égards, avec les mêmes coordonnées, dans le même ordre, sont considérées comme égales par cet opérateur. Pour une "égalité spatiale", qui ignore des choses comme l'ordre des coordonnées, et peut détecter des caractéristiques qui couvrent la même zone spatiale avec des représentations différentes, utilisez <xref linkend="ST_OrderingEquals"/> ou <xref linkend="ST_Equals"/>

note: Tag: para
en: This operand will NOT make use of any indexes that may be available on the geometries. For an index assisted exact equality test, combine &#61; with &amp;&amp;.
fr: Cet opérande n'utilisera PAS les index qui peuvent être disponibles sur les géométries. Pour un test d'égalité exact assisté par index, combinez &#61; avec &amp;&amp;.

note: Tag: para
en: Changed: 2.4.0, in prior versions this was bounding box equality not a geometric equality. If you need bounding box equality, use <xref linkend="ST_Geometry_Same"/> instead.
fr: Modifié : 2.4.0, dans les versions précédentes, il s'agissait d'une égalité de boîte de délimitation et non d'une égalité géométrique. Si vous avez besoin d'une égalité de boîte de délimitation, utilisez <xref linkend="ST_Geometry_Same"/> à la place.

note: Tag: refpurpose
en: Returns <varname>TRUE</varname> if A's bounding box is strictly to the right of B's.
fr: Renvoie <varname>TRUE</varname> si la boîte de délimitation de A est strictement à droite de celle de B.

note: Tag: para
en: The <varname>&gt;&gt;</varname> operator returns <varname>TRUE</varname> if the bounding box of geometry A is strictly to the right of the bounding box of geometry B.
fr: L'opérateur <varname>&gt;&gt;</varname> renvoie <varname>TRUE</varname> si la boîte de délimitation de la géométrie A est strictement à droite de la boîte de délimitation de la géométrie B.

note: Tag: refpurpose
en: Returns <varname>TRUE</varname> if A's bounding box is contained by B's.
fr: Renvoie <varname>TRUE</varname> si la boîte de délimitation de A est contenue par celle de B.

note: Tag: para
en: The <varname>@</varname> operator returns <varname>TRUE</varname> if the bounding box of geometry A is completely contained by the bounding box of geometry B.
fr: L'opérateur <varname>@</varname> renvoie <varname>TRUE</varname> si la boîte de délimitation de la géométrie A est complètement contenue par la boîte de délimitation de la géométrie B.

note: Tag: refpurpose
en: Returns <varname>TRUE</varname> if a geometry's 2D bounding box is contained into a 2D float precision bounding box (BOX2DF).
fr: Renvoie <varname>TRUE</varname> si la boîte de délimitation 2D d'une géométrie est contenue dans une boîte de délimitation 2D à précision flottante (BOX2DF).

note: Tag: para
en: The <varname>@</varname> operator returns <varname>TRUE</varname> if the A geometry's 2D bounding box is contained the 2D bounding box B, using float precision. This means that if B is a (double precision) box2d, it will be internally converted to a float precision 2D bounding box (BOX2DF)
fr: L'opérateur <varname>@</varname> renvoie <varname>TRUE</varname> si la boîte de délimitation 2D de la géométrie A est contenue dans la boîte de délimitation 2D B, en utilisant la précision float. Cela signifie que si B est un box2d (double précision), il sera converti en interne en une boîte de délimitation 2D de précision flottante (BOX2DF)

note: Tag: refpurpose
en: Returns <varname>TRUE</varname> if a 2D float precision bounding box (BOX2DF) is contained into a geometry's 2D bounding box.
fr: Renvoie <varname>TRUE</varname> si une boîte de délimitation de précision flottante 2D (BOX2DF) est contenue dans la boîte de délimitation 2D d'une géométrie.

note: Tag: para
en: The <varname>@</varname> operator returns <varname>TRUE</varname> if the 2D bounding box A is contained into the B geometry's 2D bounding box, using float precision. This means that if B is a (double precision) box2d, it will be internally converted to a float precision 2D bounding box (BOX2DF)
fr: L'opérateur <varname>@</varname> renvoie <varname>TRUE</varname> si la boîte de délimitation 2D A est contenue dans la boîte de délimitation 2D de la géométrie B, en utilisant la précision float. Cela signifie que si B est un box2d (double précision), il sera converti en interne en une boîte de délimitation 2D de précision flottante (BOX2DF)

note: Tag: refpurpose
en: Returns <varname>TRUE</varname> if a 2D float precision bounding box (BOX2DF) is contained into another 2D float precision bounding box.
fr: Renvoie <varname>TRUE</varname> si une boîte de délimitation de précision flottante 2D (BOX2DF) est contenue dans une autre boîte de délimitation de précision flottante 2D.

note: Tag: para
en: The <varname>@</varname> operator returns <varname>TRUE</varname> if the 2D bounding box A is contained into the 2D bounding box B, using float precision. This means that if A (or B) is a (double precision) box2d, it will be internally converted to a float precision 2D bounding box (BOX2DF)
fr: L'opérateur <varname>@</varname> renvoie <varname>TRUE</varname> si la boîte de délimitation 2D A est contenue dans la boîte de délimitation 2D B, en utilisant la précision float. Cela signifie que si A (ou B) est un box2d (double précision), il sera converti en interne en une boîte de délimitation 2D à précision flottante (BOX2DF)

note: Tag: refpurpose
en: Returns <varname>TRUE</varname> if A's bounding box overlaps or is above B's.
fr: Renvoie <varname>TRUE</varname> si la boîte de délimitation de A chevauche ou est au-dessus de celle de B.

note: Tag: para
en: The <varname>|&amp;&gt;</varname> operator returns <varname>TRUE</varname> if the bounding box of geometry A overlaps or is above the bounding box of geometry B, or more accurately, overlaps or is NOT below the bounding box of geometry B.
fr: L'opérateur <varname>|&amp;&gt;</varname> renvoie <varname>TRUE</varname> si la boîte de délimitation de la géométrie A chevauche ou est au-dessus de la boîte de délimitation de la géométrie B, ou plus exactement, chevauche ou n'est PAS au-dessous de la boîte de délimitation de la géométrie B.

note: Tag: refpurpose
en: Returns <varname>TRUE</varname> if A's bounding box is strictly above B's.
fr: Renvoie <varname>TRUE</varname> si la boîte de délimitation de A est strictement au-dessus de celle de B.

note: Tag: para
en: The <varname>|&gt;&gt;</varname> operator returns <varname>TRUE</varname> if the bounding box of geometry A is strictly above the bounding box of geometry B.
fr: L'opérateur <varname>|&gt;&gt;</varname> renvoie <varname>TRUE</varname> si la boîte de délimitation de la géométrie A est strictement au-dessus de la boîte de délimitation de la géométrie B.

note: Tag: refpurpose
en: Returns <varname>TRUE</varname> if A's bounding box contains B's.
fr: Renvoie <varname>TRUE</varname> si la boîte de délimitation de A contient celle de B.

note: Tag: para
en: The <varname>~</varname> operator returns <varname>TRUE</varname> if the bounding box of geometry A completely contains the bounding box of geometry B.
fr: L'opérateur <varname>~</varname> renvoie <varname>TRUE</varname> si la boîte de délimitation de la géométrie A contient complètement la boîte de délimitation de la géométrie B.

note: Tag: refpurpose
en: Returns <varname>TRUE</varname> if a geometry's 2D bonding box contains a 2D float precision bounding box (GIDX).
fr: Renvoie <varname>TRUE</varname> si la boîte de délimitation 2D d'une géométrie contient une boîte de délimitation de précision flottante 2D (GIDX).

note: Tag: para
en: The <varname>~</varname> operator returns <varname>TRUE</varname> if the 2D bounding box of a geometry A contains the 2D bounding box B, using float precision. This means that if B is a (double precision) box2d, it will be internally converted to a float precision 2D bounding box (BOX2DF)
fr: L'opérateur <varname>~</varname> renvoie <varname>TRUE</varname> si la boîte de délimitation 2D d'une géométrie A contient la boîte de délimitation 2D B, en utilisant la précision float. Cela signifie que si B est un box2d (double précision), il sera converti en interne en une boîte de délimitation 2D de précision flottante (BOX2DF)

note: Tag: refpurpose
en: Returns <varname>TRUE</varname> if a 2D float precision bounding box (BOX2DF) contains a geometry's 2D bonding box.
fr: Renvoie <varname>TRUE</varname> si une boîte de délimitation de précision flottante 2D (BOX2DF) contient la boîte de délimitation 2D d'une géométrie.

note: Tag: para
en: The <varname>~</varname> operator returns <varname>TRUE</varname> if the 2D bounding box A contains the B geometry's bounding box, using float precision. This means that if A is a (double precision) box2d, it will be internally converted to a float precision 2D bounding box (BOX2DF)
fr: L'opérateur <varname>~</varname> renvoie <varname>TRUE</varname> si la boîte de délimitation 2D A contient la boîte de délimitation de la géométrie B, en utilisant la précision float. Cela signifie que si A est un box2d (double précision), il sera converti en interne en une boîte de délimitation 2D de précision flottante (BOX2DF)

note: Tag: refpurpose
en: Returns <varname>TRUE</varname> if a 2D float precision bounding box (BOX2DF) contains another 2D float precision bounding box (BOX2DF).
fr: Renvoie <varname>TRUE</varname> si une boîte de délimitation de précision flottante 2D (BOX2DF) contient une autre boîte de délimitation de précision flottante 2D (BOX2DF).

note: Tag: para
en: The <varname>~</varname> operator returns <varname>TRUE</varname> if the 2D bounding box A contains the 2D bounding box B, using float precision. This means that if A is a (double precision) box2d, it will be internally converted to a float precision 2D bounding box (BOX2DF)
fr: L'opérateur <varname>~</varname> renvoie <varname>TRUE</varname> si la boîte de délimitation 2D A contient la boîte de délimitation 2D B, en utilisant la précision float. Cela signifie que si A est un box2d (double précision), il sera converti en interne en une boîte de délimitation 2D de précision flottante (BOX2DF)

note: Tag: refpurpose
en: Returns <varname>TRUE</varname> if A's bounding box is the same as B's.
fr: Renvoie <varname>TRUE</varname> si la boîte de délimitation de A est la même que celle de B.

note: Tag: para
en: The <varname>~=</varname> operator returns <varname>TRUE</varname> if the bounding box of geometry/geography A is the same as the bounding box of geometry/geography B.
fr: L'opérateur <varname>~=</varname> renvoie <varname>TRUE</varname> si la boîte de délimitation de la géométrie/géographie A est la même que la boîte de délimitation de la géométrie/géographie B.

note: Tag: para
en: Availability: 1.5.0 changed behavior
fr: Disponibilité : 1.5.0 comportement changé

note: Tag: para
en: This operator has changed behavior in PostGIS 1.5 from testing for actual geometric equality to only checking for bounding box equality. To complicate things it also depends on if you have done a hard or soft upgrade which behavior your database has. To find out which behavior your database has you can run the query below. To check for true equality use <xref linkend="ST_OrderingEquals"/> or <xref linkend="ST_Equals"/>.
fr: Cet opérateur a changé de comportement dans PostGIS 1.5, passant de la vérification de l'égalité géométrique réelle à la vérification de l'égalité du rectangle de délimitation. Pour compliquer les choses, le comportement de votre base de données dépend également du type de mise à niveau (hard ou soft) que vous avez effectué. Pour savoir quel est le comportement de votre base de données, vous pouvez exécuter la requête ci-dessous. Pour vérifier l'égalité réelle, utilisez <xref linkend="ST_OrderingEquals"/> ou <xref linkend="ST_Equals"/>.

note: Tag: title
en: Distance Operators
fr: Opérateurs de distance

note: Tag: refpurpose
en: Returns the 2D distance between A and B.
fr: Renvoie la distance en 2D entre A et B.

note: Tag: para
en: The <varname>&lt;-&gt;</varname> operator returns the 2D distance between two geometries. Used in the "ORDER BY" clause provides index-assisted nearest-neighbor result sets. For PostgreSQL below 9.5 only gives centroid distance of bounding boxes and for PostgreSQL 9.5+, does true KNN distance search giving true distance between geometries, and distance sphere for geographies.
fr: L'opérateur <varname>&lt;-&gt;</varname> renvoie la distance 2D entre deux géométries. Utilisé dans la clause "ORDER BY" fournit des ensembles de résultats de plus proches voisins assistés par index. Pour PostgreSQL inférieur à 9.5, donne uniquement la distance centroïde des boîtes englobantes et pour PostgreSQL 9.5+, fait une vraie recherche de distance KNN donnant la vraie distance entre les géométries, et la sphère de distance pour les géographies.

note: Tag: para
en: This operand will make use of 2D GiST indexes that may be available on the geometries. It is different from other operators that use spatial indexes in that the spatial index is only used when the operator is in the ORDER BY clause.
fr: Cet opérande utilise les index 2D GiST qui peuvent être disponibles sur les géométries. Il est différent des autres opérateurs qui utilisent des index spatiaux en ce sens que l'index spatial n'est utilisé que lorsque l'opérateur est dans la clause ORDER BY.

note: Tag: para
en: Index only kicks in if one of the geometries is a constant (not in a subquery/cte). e.g. 'SRID=3005;POINT(1011102 450541)'::geometry instead of a.geom
fr: L'index n'intervient que si l'une des géométries est une constante (pas dans une sous-requête/cte). Par exemple, 'SRID=3005;POINT(1011102 450541)'::geometry au lieu de a.geom

note: Tag: para
en: Refer to <link xlink:href="https://postgis.net/workshops/postgis-intro/knn.html">PostGIS workshop: Nearest-Neighbor Searching</link> for a detailed example.
fr: Reportez-vous à <link xlink:href="https://postgis.net/workshops/postgis-intro/knn.html">l'atelier PostGIS : La recherche du plus proche voisin</link> pour un exemple détaillé.

note: Tag: para
en: Enhanced: 2.2.0 -- True KNN ("K nearest neighbor") behavior for geometry and geography for PostgreSQL 9.5+. Note for geography KNN is based on sphere rather than spheroid. For PostgreSQL 9.4 and below, geography support is new but only supports centroid box.
fr: Amélioré : 2.2.0 -- Comportement KNN ("K nearest neighbor") réel pour la géométrie et la géographie pour PostgreSQL 9.5+. Note : pour la géographie, KNN est basé sur la sphère plutôt que sur le sphéroïde. Pour PostgreSQL 9.4 et moins, le support de la géographie est nouveau mais ne supporte que le centroïde de la boîte de délimitation.

note: Tag: para
en: Changed: 2.2.0 -- For PostgreSQL 9.5 users, old Hybrid syntax may be slower, so you'll want to get rid of that hack if you are running your code only on PostGIS 2.2+ 9.5+. See examples below.
fr: Modifié : 2.2.0 -- Pour les utilisateurs de PostgreSQL 9.5, l'ancienne syntaxe Hybrid peut être plus lente, donc vous voudrez vous débarrasser de ce hack si vous exécutez votre code uniquement sur PostGIS 2.2+ 9.5+. Voir les exemples ci-dessous.

note: Tag: para
en: Availability: 2.0.0 -- Weak KNN provides nearest neighbors based on geometry centroid distances instead of true distances. Exact results for points, inexact for all other types. Available for PostgreSQL 9.1+
fr: Disponibilité : 2.0.0 -- Le KNN fournit des voisins les plus proches basés sur les distances entre les centroïdes géométriques au lieu des distances réelles. Résultats exacts pour les points, inexacts pour tous les autres types. Disponible pour PostgreSQL 9.1+

note: Tag: para
en: Then the KNN raw answer:
fr: Puis la réponse brute KNN :

note: Tag: para
en: If you run "EXPLAIN ANALYZE" on the two queries you would see a performance improvement for the second.
fr: Si vous exécutez "EXPLAIN ANALYZE" sur les deux requêtes, vous constaterez une amélioration des performances pour la seconde.

note: Tag: para
en: For users running with PostgreSQL &lt; 9.5, use a hybrid query to find the true nearest neighbors. First a CTE query using the index-assisted KNN, then an exact query to get correct ordering:
fr: Pour les utilisateurs utilisant PostgreSQL &lt; 9.5, utilisez une requête hybride pour trouver les vrais plus proches voisins. D'abord une requête CTE utilisant le KNN assisté par index, puis une requête exacte pour obtenir l'ordre correct :

note: Tag: refpurpose
en: Returns the distance between A and B trajectories at their closest point of approach.
fr: Renvoie la distance entre les trajectoires A et B à leur point d'approche le plus proche.

note: Tag: para
en: The <varname>|=|</varname> operator returns the 3D distance between two trajectories (See <xref linkend="ST_IsValidTrajectory"/>). This is the same as <xref linkend="ST_DistanceCPA"/> but as an operator it can be used for doing nearest neighbor searches using an N-dimensional index (requires PostgreSQL 9.5.0 or higher).
fr: L'opérateur <varname>|=|</varname> renvoie la distance 3D entre deux trajectoires (Voir <xref linkend="ST_IsValidTrajectory"/>). C'est la même chose que <xref linkend="ST_DistanceCPA"/> mais en tant qu'opérateur, il peut être utilisé pour effectuer des recherches du plus proche voisin en utilisant un index à N dimensions (nécessite PostgreSQL 9.5.0 ou plus).

note: Tag: para
en: This operand will make use of ND GiST indexes that may be available on the geometries. It is different from other operators that use spatial indexes in that the spatial index is only used when the operator is in the ORDER BY clause.
fr: Cet opérande utilisera les index ND GiST qui peuvent être disponibles sur les géométries. Il est différent des autres opérateurs qui utilisent des index spatiaux en ce sens que l'index spatial n'est utilisé que lorsque l'opérateur est dans la clause ORDER BY.

note: Tag: para
en: Index only kicks in if one of the geometries is a constant (not in a subquery/cte). e.g. 'SRID=3005;LINESTRINGM(0 0 0,0 0 1)'::geometry instead of a.geom
fr: L'index n'intervient que si l'une des géométries est une constante (pas dans une sous-requête/cte). Par exemple, 'SRID=3005;LINESTRINGM(0 0 0,0 0 1)'::geometry au lieu de a.geom

note: Tag: para
en: Availability: 2.2.0. Index-supported only available for PostgreSQL 9.5+
fr: Disponibilité : 2.2.0. La prise en charge des index est disponible uniquement pour PostgreSQL 9.5+

note: Tag: refpurpose
en: Returns the 2D distance between A and B bounding boxes.
fr: Renvoie la distance 2D entre les boîtes de délimitation A et B.

note: Tag: para
en: The <varname>&lt;#&gt;</varname> operator returns distance between two floating point bounding boxes, possibly reading them from a spatial index (PostgreSQL 9.1+ required). Useful for doing nearest neighbor <emphasis role="strong">approximate</emphasis> distance ordering.
fr: L'opérateur <varname>&lt;#&gt;</varname> renvoie la distance entre deux boîtes de délimitation en virgule flottante, en les lisant éventuellement à partir d'un index spatial (PostgreSQL 9.1+ requis). Utile pour effectuer un ordonnancement par distance du plus proche voisin <emphasis role="strong">approximate</emphasis>.

note: Tag: para
en: This operand will make use of any indexes that may be available on the geometries. It is different from other operators that use spatial indexes in that the spatial index is only used when the operator is in the ORDER BY clause.
fr: Cet opérande utilisera tous les index qui peuvent être disponibles sur les géométries. Il est différent des autres opérateurs qui utilisent des index spatiaux en ce sens que l'index spatial n'est utilisé que lorsque l'opérateur est dans la clause ORDER BY.

note: Tag: para
en: Index only kicks in if one of the geometries is a constant e.g. ORDER BY (ST_GeomFromText('POINT(1 2)') &lt;#&gt; geom) instead of g1.geom &lt;#&gt;.
fr: L'index n'intervient que si l'une des géométries est une constante, par exemple ORDER BY (ST_GeomFromText('POINT(1 2)') &lt;#&gt; geom) au lieu de g1.geom &lt;#&gt;.

note: Tag: para
en: Availability: 2.0.0 -- KNN only available for PostgreSQL 9.1+
fr: Disponibilité : 2.0.0 -- KNN disponible uniquement pour PostgreSQL 9.1+

note: Tag: refpurpose
en: Returns the n-D distance between the A and B geometries or bounding boxes
fr: Renvoie la distance n-D entre les géométries A et B ou les boîtes englobantes

note: Tag: para
en: The <varname>&lt;&lt;-&gt;&gt;</varname> operator returns the n-D (euclidean) distance between the centroids of the bounding boxes of two geometries. Useful for doing nearest neighbor <emphasis role="strong">approximate</emphasis> distance ordering.
fr: L'opérateur <varname>&lt;&lt;-&gt;&gt;</varname> renvoie la distance n-D (euclidienne) entre les centroïdes des boîtes englobantes de deux géométries. Utile pour effectuer le classement par distance du plus proche voisin <emphasis role="strong">approximate</emphasis>.

note: Tag: para
en: This operand will make use of n-D GiST indexes that may be available on the geometries. It is different from other operators that use spatial indexes in that the spatial index is only used when the operator is in the ORDER BY clause.
fr: Cet opérande utilise les index GiST n-D qui peuvent être disponibles sur les géométries. Il est différent des autres opérateurs qui utilisent des index spatiaux en ce sens que l'index spatial n'est utilisé que lorsque l'opérateur est dans la clause ORDER BY.

note: Tag: para
en: Availability: 2.2.0 -- KNN only available for PostgreSQL 9.1+
fr: Disponibilité : 2.2.0 -- KNN disponible uniquement pour PostgreSQL 9.1+

note: Tag: title
en: Geometry Output
fr: Export de géométrie

note: Tag: para
en: These functions convert geometry objects into various textual or binary formats.
fr: Ces fonctions convertissent les objets géométriques en divers formats textuels ou binaires.

note: Tag: refpurpose
en: Return the Well-Known Text (WKT) representation of the geometry with SRID meta data.
fr: Renvoie la représentation Well-Known Text (WKT) de la géométrie avec les métadonnées SRID.

note: Tag: para
en: Returns the Well-Known Text representation of the geometry prefixed with the SRID. The optional <parameter>maxdecimaldigits</parameter> argument may be used to reduce the maximum number of decimal digits after floating point used in output (defaults to 15).
fr: Renvoie la représentation Well-Known Text de la géométrie préfixée par le SRID. L'argument facultatif <parameter>maxdecimaldigits</parameter> peut être utilisé pour réduire le nombre maximal de chiffres décimaux après la virgule flottante utilisés dans la sortie (valeur par défaut : 15).

note: Tag: para
en: To perform the inverse conversion of EWKT representation to PostGIS geometry use <xref linkend="ST_GeomFromEWKT"/>.
fr: Pour effectuer la conversion inverse de la représentation EWKT en géométrie PostGIS, utilisez <xref linkend="ST_GeomFromEWKT"/>.

note: Tag: para
en: Using the <parameter>maxdecimaldigits</parameter> parameter can cause output geometry to become invalid. To avoid this use <xref linkend="ST_ReducePrecision"/> with a suitable gridsize first.
fr: L'utilisation du paramètre <parameter>maxdecimaldigits</parameter> peut rendre la géométrie de sortie invalide. Pour éviter cela, utilisez d'abord <xref linkend="ST_ReducePrecision"/> avec une taille de grille appropriée.

note: Tag: para
en: The WKT spec does not include the SRID. To get the OGC WKT format use <xref linkend="ST_AsText"/>.
fr: La spécification WKT ne comprend pas le SRID. Pour obtenir le format WKT de l'OGC, utilisez <xref linkend="ST_AsText"/>.

note: Tag: para
en: WKT format does not maintain precision so to prevent floating truncation, use <xref linkend="ST_AsBinary"/> or <xref linkend="ST_AsEWKB"/> format for transport.
fr: Le format WKT ne maintient pas la précision. Pour éviter la troncature flottante, utilisez le format <xref linkend="ST_AsBinary"/> ou <xref linkend="ST_AsEWKB"/> pour le transport.

note: Tag: para
en: Enhanced: 3.1.0 support for optional precision parameter.
fr: Amélioré : support du paramètre optionnel de précision dans la version 3.1.0.

note: Tag: para
en: Enhanced: 2.0.0 support for Geography, Polyhedral surfaces, Triangles and TIN was introduced.
fr: Amélioration : la version 2.0.0 a introduit la prise en charge de la geography, des surfaces polyédriques, des triangles et des TIN.

note: Tag: refpurpose
en: Return the Well-Known Text (WKT) representation of the geometry/geography without SRID metadata.
fr: Renvoie la représentation Well-Known Text (WKT) de la géométrie/geography sans métadonnées SRID.

note: Tag: para
en: Returns the OGC <link linkend="OpenGISWKBWKT">Well-Known Text</link> (WKT) representation of the geometry/geography. The optional <parameter>maxdecimaldigits</parameter> argument may be used to limit the number of digits after the decimal point in output ordinates (defaults to 15).
fr: Renvoie la représentation OGC <link linkend="OpenGISWKBWKT">Well-Known Text</link> (WKT) de la géométrie/geography. L'argument facultatif <parameter>maxdecimaldigits</parameter> peut être utilisé pour limiter le nombre de chiffres après la virgule dans les ordonnées de sortie (valeur par défaut : 15).

note: Tag: para
en: To perform the inverse conversion of WKT representation to PostGIS geometry use <xref linkend="ST_GeomFromText"/>.
fr: Pour effectuer la conversion inverse de la représentation WKT en géométrie PostGIS, utilisez <xref linkend="ST_GeomFromText"/>.

note: Tag: para
en: The standard OGC WKT representation does not include the SRID. To include the SRID as part of the output representation, use the non-standard PostGIS function <xref linkend="ST_AsEWKT"/>
fr: La représentation WKT standard de l'OGC n'inclut pas le SRID. Pour inclure le SRID dans la représentation de sortie, utilisez la fonction PostGIS non standard <xref linkend="ST_AsEWKT"/>

note: Tag: para
en: The textual representation of numbers in WKT may not maintain full floating-point precision. To ensure full accuracy for data storage or transport it is best to use <link linkend="OpenGISWKBWKT">Well-Known Binary</link> (WKB) format (see <xref linkend="ST_AsBinary"/> and <parameter>maxdecimaldigits</parameter>).
fr: La représentation textuelle des nombres en WKT peut ne pas maintenir une précision totale en virgule flottante. Pour garantir une précision totale pour le stockage ou le transport des données, il est préférable d'utiliser le format <link linkend="OpenGISWKBWKT">Well-Known Binary</link> (WKB) (voir <xref linkend="ST_AsBinary"/> et <parameter>maxdecimaldigits</parameter>).

note: Tag: para
en: Availability: 1.5 - support for geography was introduced.
fr: Disponibilité : 1.5 - le support de la geography a été introduit.

note: Tag: para
en: Enhanced: 2.5 - optional parameter precision introduced.
fr: Amélioration : 2.5 - introduction de la précision des paramètres optionnels.

note: Tag: para
en: &sqlmm_compliant; SQL-MM 3: 5.1.25
fr: &sqlmm_compliant; SQL-MM 3 : 5.1.25

note: Tag: para
en: Full precision output is the default.
fr: La sortie de précision complète est la valeur par défaut.

note: Tag: para
en: The <parameter>maxdecimaldigits</parameter> argument can be used to limit output precision.
fr: L'argument <parameter>maxdecimaldigits</parameter> peut être utilisé pour limiter la précision de la sortie.

note: Tag: refpurpose
en: Return the OGC/ISO Well-Known Binary (WKB) representation of the geometry/geography without SRID meta data.
fr: Renvoie la représentation OGC/ISO Well-Known Binary (WKB) de la géométrie/geography sans les métadonnées SRID.

note: Tag: para
en: Returns the OGC/ISO <link linkend="OpenGISWKBWKT">Well-Known Binary</link> (WKB) representation of the geometry. The first function variant defaults to encoding using server machine endian. The second function variant takes a text argument specifying the endian encoding, either little-endian ('NDR') or big-endian ('XDR').
fr: Renvoie la représentation OGC/ISO <link linkend="OpenGISWKBWKT">Well-Known Binary</link> (WKB) de la géométrie. La première variante de fonction propose par défaut un encodage utilisant l'endian de la machine serveur. La deuxième variante de la fonction prend un argument texte spécifiant l'encodage endian, soit little-endian ('NDR') ou big-endian ('XDR').

note: Tag: para
en: WKB format is useful to read geometry data from the database and maintaining full numeric precision. This avoids the precision rounding that can happen with text formats such as WKT.
fr: Le format WKB est utile pour lire les données géométriques de la base de données et maintenir une précision numérique totale. Cela permet d'éviter les arrondis de précision qui peuvent se produire avec les formats texte tels que WKT.

note: Tag: para
en: To perform the inverse conversion of WKB to PostGIS geometry use <xref linkend="ST_GeomFromWKB"/>.
fr: Pour effectuer la conversion inverse de la géométrie WKB en géométrie PostGIS, utilisez <xref linkend="ST_GeomFromWKB"/>.

note: Tag: para
en: The OGC/ISO WKB format does not include the SRID. To get the EWKB format which does include the SRID use <xref linkend="ST_AsEWKB"/>
fr: Le format WKB de l'OGC/ISO ne comprend pas le SRID. Pour obtenir le format EWKB qui inclut le SRID, utilisez <xref linkend="ST_AsEWKB"/>

note: Tag: para
en: The default behavior in PostgreSQL 9.0 has been changed to output bytea in hex encoding. If your GUI tools require the old behavior, then SET bytea_output='escape' in your database.
fr: Le comportement par défaut dans PostgreSQL 9.0 a été modifié pour sortir bytea en encodage hexagonal. Si vos outils GUI nécessitent l'ancien comportement, alors SET bytea_output='escape' dans votre base de données.

note: Tag: para
en: Enhanced: 2.0.0 support for higher coordinate dimensions was introduced.
fr: Amélioration : 2.0.0 le support pour des dimensions de coordonnées plus élevées a été introduit.

note: Tag: para
en: Enhanced: 2.0.0 support for specifying endian with geography was introduced.
fr: Amélioration : 2.0.0 le support pour spécifier endian avec geography a été introduit.

note: Tag: para
en: Availability: 1.5.0 geography support was introduced.
fr: Disponibilité : 1.5.0 Le support de la géographie a été introduit.

note: Tag: para
en: Changed: 2.0.0 Inputs to this function can not be unknown -- must be geometry. Constructs such as <code>ST_AsBinary('POINT(1 2)')</code> are no longer valid and you will get an <code>n st_asbinary(unknown) is not unique error</code>. Code like that needs to be changed to <code>ST_AsBinary('POINT(1 2)'::geometry);</code>. If that is not possible, then install <filename>legacy.sql</filename>.
fr: Modifié : 2.0.0 Les entrées de cette fonction ne peuvent pas être inconnues, elles doivent être des géométries. Des constructions telles que <code>ST_AsBinary('POINT(1 2)')</code> ne sont plus valides et vous obtiendrez une erreur de type <code>n st_asbinary(unknown) is not unique</code>. Un code comme celui-là doit être changé en <code>ST_AsBinary('POINT(1 2)'::geometry);</code>. Si cela n'est pas possible, alors installez <filename>legacy.sql</filename>.

note: Tag: para
en: &sqlmm_compliant; SQL-MM 3: 5.1.37
fr: &sqlmm_compliant; SQL-MM 3 : 5.1.37

note: Tag: refpurpose
en: Return the Extended Well-Known Binary (EWKB) representation of the geometry with SRID meta data.
fr: Renvoie la représentation Extended Well-Known Binary (EWKB) de la géométrie avec les métadonnées SRID.

note: Tag: para
en: Returns the <link linkend="EWKB_EWKT">Extended Well-Known Binary</link> (EWKB) representation of the geometry with SRID metadata. The first function variant defaults to encoding using server machine endian. The second function variant takes a text argument specifying the endian encoding, either little-endian ('NDR') or big-endian ('XDR').
fr: Renvoie la représentation <link linkend="EWKB_EWKT">Extended Well-Known Binary</link> (EWKB) de la géométrie avec les métadonnées SRID. La première variante de la fonction utilise par défaut l'encodage endian de la machine du serveur. La deuxième variante de la fonction prend un argument texte spécifiant l'encodage endian, soit little-endian ('NDR') ou big-endian ('XDR').

note: Tag: para
en: To perform the inverse conversion of EWKB to PostGIS geometry use <xref linkend="ST_GeomFromEWKB"/>.
fr: Pour effectuer la conversion inverse de la géométrie EWKB en géométrie PostGIS, utilisez <xref linkend="ST_GeomFromEWKB"/>.

note: Tag: para
en: To get the OGC/ISO WKB format use <xref linkend="ST_AsBinary"/>. Note that OGC/ISO WKB format does not include the SRID.
fr: Pour obtenir le format OGC/ISO WKB, utilisez <xref linkend="ST_AsBinary"/>. Notez que le format OGC/ISO WKB ne comprend pas le SRID.

note: Tag: refpurpose
en: Returns a Geometry in HEXEWKB format (as text) using either little-endian (NDR) or big-endian (XDR) encoding.
fr: Renvoie une géométrie au format HEXEWKB (en tant que texte) en utilisant l'encodage little-endian (NDR) ou big-endian (XDR).

note: Tag: para
en: Returns a Geometry in HEXEWKB format (as text) using either little-endian (NDR) or big-endian (XDR) encoding. If no encoding is specified, then NDR is used.
fr: Renvoie une géométrie au format HEXEWKB (en tant que texte) en utilisant l'encodage little-endian (NDR) ou big-endian (XDR). Si aucun encodage n'est spécifié, NDR est utilisé.

note: Tag: refpurpose
en: Returns an Encoded Polyline from a LineString geometry.
fr: Renvoie une polyligne encodée à partir d'une géométrie LineString.

note: Tag: para
en: Returns the geometry as an Encoded Polyline. This format is used by Google Maps with precision=5 and by Open Source Routing Machine with precision=5 and 6.
fr: Renvoie la géométrie sous forme de polyligne encodée. Ce format est utilisé par Google Maps avec précision=5 et par Open Source Routing Machine avec précision=5 et 6.

note: Tag: para
en: Basic
fr: Base

note: Tag: para
en: Use in conjunction with geography linestring and geography segmentize, and put on google maps
fr: Utiliser en conjonction avec geography linestring et geography segmentize, et mettre sur google maps

note: Tag: para
en: javascript will look something like this where $ variable you replace with query result
fr: Le javascript ressemblera à quelque chose comme ceci où la variable $ est remplacée par le résultat de la requête

note: Tag: refpurpose
en: Return a FlatGeobuf representation of a set of rows.
fr: Renvoie une représentation FlatGeobuf d'un ensemble de lignes.

note: Tag: para
en: Return a FlatGeobuf representation (<link xlink:href="http://flatgeobuf.org">http://flatgeobuf.org</link>) of a set of rows corresponding to a FeatureCollection. NOTE: PostgreSQL bytea cannot exceed 1GB.
fr: Renvoie une représentation FlatGeobuf (<link xlink:href="http://flatgeobuf.org">http://flatgeobuf.org</link>) d'un ensemble de lignes correspondant à une FeatureCollection. REMARQUE : les octets PostgreSQL ne peuvent pas dépasser 1 Go.

note: Tag: para
en: <varname>row</varname> row data with at least a geometry column.
fr: <varname>row</varname> données de ligne avec au moins une colonne de géométrie.

note: Tag: para
en: <varname>index</varname> toggle spatial index creation. Default is false.
fr: <varname>index</varname> basculer la création d'un index spatial. La valeur par défaut est false.

note: Tag: para
en: <varname>geom_name</varname> is the name of the geometry column in the row data. If NULL it will default to the first found geometry column.
fr: <varname>geom_name</varname> est le nom de la colonne de géométrie dans les données de la ligne. Si elle est NULL, elle prendra par défaut la première colonne de géométrie trouvée.

note: Tag: refpurpose
en: Return a Geobuf representation of a set of rows.
fr: Retourne une représentation Geobuf d'un ensemble de lignes.

note: Tag: para
en: Return a Geobuf representation (<link xlink:href="https://github.com/mapbox/geobuf">https://github.com/mapbox/geobuf</link>) of a set of rows corresponding to a FeatureCollection. Every input geometry is analyzed to determine maximum precision for optimal storage. Note that Geobuf in its current form cannot be streamed so the full output will be assembled in memory.
fr: Renvoie une représentation Geobuf (<link xlink:href="https://github.com/mapbox/geobuf">https://github.com/mapbox/geobuf</link>) d'un ensemble de lignes correspondant à une FeatureCollection. Chaque géométrie en entrée est analysée afin de déterminer la précision maximale pour un stockage optimal. Notez que Geobuf dans sa forme actuelle ne peut pas être streamé, donc la sortie complète sera assemblée en mémoire.

note: Tag: refpurpose
en: Return a geometry or feature in GeoJSON format.
fr: Renvoyer une géométrie ou un élément au format GeoJSON.

note: Tag: para
en: Returns a geometry as a GeoJSON "geometry" object, or a row as a GeoJSON "feature" object.
fr: Renvoie une géométrie sous forme d'objet GeoJSON "geometry", ou une ligne sous forme d'objet GeoJSON "feature".

note: Tag: para
en: The resulting GeoJSON geometry and feature representations conform with the <link xlink:href="https://tools.ietf.org/html/rfc7946">GeoJSON specifications RFC 7946</link>, except when the parsed geometries are referenced with a CRS other than WGS84 longitude and latitude (<link xlink:href="https://epsg.io/4326">EPSG:4326</link>, <link xlink:href="http://epsg.io/4326.gml">urn:ogc:def:crs:OGC::CRS84</link>); the GeoJSON geometry object will then have a short CRS SRID identifier attached by default. 2D and 3D Geometries are both supported. GeoJSON only supports SFS 1.1 geometry types (no curve support for example).
fr: Les représentations de géométrie et d'entités GeoJSON résultantes sont conformes aux <link xlink:href="https://tools.ietf.org/html/rfc7946">spécifications GeoJSON RFC 7946</link>, sauf lorsque les géométries analysées sont référencées avec un CRS autre que la longitude et la latitude WGS84 (<link xlink:href="https://epsg. io/4326">EPSG:4326</link>, <link xlink:href="http://epsg.io/4326.gml">urn:ogc:def:crs:OGC::CRS84</link>) ; l'objet géométrique GeoJSON aura alors un identifiant SRID CRS court attaché par défaut. Les géométries 2D et 3D sont toutes deux supportées. GeoJSON ne supporte que les types de géométrie SFS 1.1 (pas de support pour les courbes par exemple).

note: Tag: para
en: The <varname>geom_column</varname> parameter is used to distinguish between multiple geometry columns. If omitted, the first geometry column in the record will be determined. Conversely, passing the parameter will save column type lookups.
fr: Le paramètre <varname>geom_column</varname> est utilisé pour faire la distinction entre plusieurs colonnes géométriques. S'il est omis, la première colonne géométrique de l'enregistrement sera déterminée. Inversement, l'utilisation de ce paramètre permet d'économiser les recherches sur le type de colonne.

note: Tag: para
en: The <varname>maxdecimaldigits</varname> argument may be used to reduce the maximum number of decimal places used in output (defaults to 9). If you are using EPSG:4326 and are outputting the geometry only for display, <varname>maxdecimaldigits</varname>=6 can be a good choice for many maps.
fr: L'argument <varname>maxdecimaldigits</varname> peut être utilisé pour réduire le nombre maximum de décimales utilisées dans la sortie (par défaut 9). Si vous utilisez EPSG:4326 et que vous sortez la géométrie uniquement pour l'affichage, <varname>maxdecimaldigits</varname>=6 peut être un bon choix pour de nombreuses cartes.

note: Tag: para
en: The <varname>options</varname> argument can be used to add BBOX or CRS in GeoJSON output:
fr: L'argument <varname>options</varname> peut être utilisé pour ajouter BBOX ou CRS dans la sortie GeoJSON :

note: Tag: para
en: 0: means no option
fr: 0 : signifie aucune option

note: Tag: para
en: 1: GeoJSON BBOX
fr: 1 : GeoJSON BBOX

note: Tag: para
en: 2: GeoJSON Short CRS (e.g EPSG:4326)
fr: 2 : GeoJSON Short CRS (e.g. EPSG:4326)

note: Tag: para
en: 4: GeoJSON Long CRS (e.g urn:ogc:def:crs:EPSG::4326)
fr: 4 : GeoJSON Long CRS (e.g. urn:ogc:def:crs:EPSG::4326)

note: Tag: para
en: 8: GeoJSON Short CRS if not EPSG:4326 (default)
fr: 8 : GeoJSON Short CRS si pas EPSG:4326 (par défaut)

note: Tag: para
en: The <varname>id_column</varname> parameter is used to set the "id" member of the returned GeoJSON features. As per GeoJSON RFC, this SHOULD be used whenever a feature has a commonly used identifier, such as a primary key. When not specified, the produced features will not get an "id" member and any columns other than the geometry, including any potential keys, will just end up inside the feature’s "properties" member.
fr: Le paramètre <varname>id_column</varname> est utilisé pour définir le membre "id" des caractéristiques GeoJSON renvoyées. Conformément à la RFC GeoJSON, ce paramètre DEVRAIT être utilisé chaque fois qu'un élément a un identifiant couramment utilisé, tel qu'une clé primaire. Si elle n'est pas spécifiée, les entités produites n'auront pas de membre "id" et toutes les colonnes autres que la géométrie, y compris les clés potentielles, se retrouveront dans le membre "properties" de l'entité.

note: Tag: para
en: The GeoJSON specification states that polygons are oriented using the Right-Hand Rule, and some clients require this orientation. This can be ensured by using <xref linkend="ST_ForcePolygonCCW"/>. The specification also requires that geometry be in the WGS84 coordinate system (SRID = 4326). If necessary geometry can be projected into WGS84 using <xref linkend="ST_Transform"/>: <code>ST_Transform( geom, 4326 )</code>.
fr: La spécification GeoJSON indique que les polygones sont orientés selon la règle de la main droite, et certains clients exigent cette orientation. Ceci peut être assuré en utilisant <xref linkend="ST_ForcePolygonCCW"/>. La spécification exige également que la géométrie soit dans le système de coordonnées WGS84 (SRID = 4326). Si nécessaire, la géométrie peut être projetée en WGS84 en utilisant <xref linkend="ST_Transform"/> : <code>ST_Transform( geom, 4326 )</code>.

note: Tag: para
en: GeoJSON can be tested and viewed online at <link xlink:href="http://geojson.io/">geojson.io</link> and <link xlink:href="http://geojson.io/">geojsonlint.com</link>. It is widely supported by web mapping frameworks:
fr: GeoJSON peut être testé et visualisé en ligne sur <link xlink:href="http://geojson.io/">geojson.io</link> et <link xlink:href="http://geojson.io/">geojsonlint.com</link>. Il est largement pris en charge par les frameworks de cartographie web :

note: Tag: link
en: OpenLayers GeoJSON Example
fr: Exemple OpenLayers GeoJSON

note: Tag: link
en: Leaflet GeoJSON Example
fr: Exemple Leaflet GeoJSON

note: Tag: link
en: Mapbox GL GeoJSON Example
fr: Exemple Mapbox GL GeoJSON

note: Tag: para
en: Availability: 1.3.4
fr: Disponibilité : 1.3.4

note: Tag: para
en: Changed: 2.0.0 support default args and named args.
fr: Modifié : 2.0.0 supporte les args par défaut et les args nommés.

note: Tag: para
en: Changed: 3.0.0 support records as input
fr: Modifié : la version 3.0.0 prend en charge les enregistrements en tant que données d'entrée

note: Tag: para
en: Changed: 3.0.0 output SRID if not EPSG:4326.
fr: Modifié : 3.0.0 SRID de sortie si ce n'est pas EPSG:4326.

note: Tag: para
en: Changed: 3.5.0 allow specifying the column containing the feature id
fr: Modifié : la version 3.5.0 permet de spécifier la colonne contenant l'identifiant de l'élément

note: Tag: para
en: Generate a FeatureCollection:
fr: Générer une FeatureCollection :

note: Tag: para
en: Generate a Feature:
fr: Génère une Feature :

note: Tag: para
en: Don't forget to transform your data to WGS84 longitude, latitude to conform with the GeoJSON specification:
fr: N'oubliez pas de transformer vos données en longitude et latitude WGS84 pour vous conformer à la spécification GeoJSON :

note: Tag: para
en: 3D geometries are supported:
fr: Les géométries 3D sont prises en charge :

note: Tag: refpurpose
en: Return the geometry as a GML version 2 or 3 element.
fr: Renvoyer la géométrie en tant qu'élément GML version 2 ou 3.

note: Tag: para
en: Return the geometry as a Geography Markup Language (GML) element. The version parameter, if specified, may be either 2 or 3. If no version parameter is specified then the default is assumed to be 2. The <varname>maxdecimaldigits</varname> argument may be used to reduce the maximum number of decimal places used in output (defaults to 15).
fr: Renvoie la géométrie sous la forme d'un élément GML (Geography Markup Language). Le paramètre de version, s'il est spécifié, peut être 2 ou 3. Si aucun paramètre de version n'est spécifié, la valeur par défaut est 2. L'argument <varname>maxdecimaldigits</varname> peut être utilisé pour réduire le nombre maximum de décimales utilisées dans la sortie (15 par défaut).

note: Tag: para
en: GML 2 refer to 2.1.2 version, GML 3 to 3.1.1 version
fr: GML 2 fait référence à la version 2.1.2, GML 3 à la version 3.1.1

note: Tag: para
en: The 'options' argument is a bitfield. It could be used to define CRS output type in GML output, and to declare data as lat/lon:
fr: L'argument "options" est un champ de bits. Il peut être utilisé pour définir le type de sortie CRS dans la sortie GML, et pour déclarer les données comme lat/lon :

note: Tag: para
en: 0: GML Short CRS (e.g EPSG:4326), default value
fr: 0 : GML Short CRS (e.g. EPSG:4326), valeur par défaut

note: Tag: para
en: 2: For GML 3 only, remove srsDimension attribute from output.
fr: 2 : Pour GML 3 uniquement, supprimer l'attribut srsDimension de la sortie.

note: Tag: para
en: 4: For GML 3 only, use &lt;LineString&gt; rather than &lt;Curve&gt; tag for lines.
fr: 4 : Pour GML 3 uniquement, utilisez la balise &lt;LineString&gt; plutôt que la balise &lt;Curve&gt; pour les lignes.

note: Tag: para
en: 16: Declare that data are lat/lon (e.g srid=4326). Default is to assume that data are planars. This option is useful for GML 3.1.1 output only, related to axis order. So if you set it, it will swap the coordinates so order is lat lon instead of database lon lat.
fr: 16 : Déclare que les données sont des lat/lon (par exemple srid=4326). Par défaut, on suppose que les données sont planaires. Cette option n'est utile que pour la sortie GML 3.1.1, en ce qui concerne l'ordre des axes. Ainsi, si vous la définissez, les coordonnées seront échangées pour que l'ordre soit lat lon au lieu de lon lat dans la base de données.

note: Tag: para
en: 32: Output the box of the geometry (envelope).
fr: 32 : Sortie de la boîte de la géométrie (enveloppe).

note: Tag: para
en: The 'namespace prefix' argument may be used to specify a custom namespace prefix or no prefix (if empty). If null or omitted 'gml' prefix is used
fr: L'argument 'namespace prefix' peut être utilisé pour spécifier un préfixe d'espace de noms personnalisé ou aucun préfixe (s'il est vide). Si l'argument est nul ou omis, le préfixe 'gml' est utilisé

note: Tag: para
en: Availability: 1.3.2
fr: Disponibilité : 1.3.2

note: Tag: para
en: Enhanced: 2.0.0 prefix support was introduced. Option 4 for GML3 was introduced to allow using LineString instead of Curve tag for lines. GML3 Support for Polyhedral surfaces and TINS was introduced. Option 32 was introduced to output the box.
fr: Amélioration : la prise en charge du préfixe 2.0.0 a été introduite. L'option 4 pour GML3 a été introduite pour permettre l'utilisation de LineString au lieu de Curve tag pour les lignes. La prise en charge GML3 des surfaces polyédriques et des TINS a été introduite. L'option 32 a été introduite pour produire la boîte.

note: Tag: para
en: Changed: 2.0.0 use default named args
fr: Modifié : 2.0.0 utiliser les args nommés par défaut

note: Tag: para
en: Enhanced: 2.1.0 id support was introduced, for GML 3.
fr: Amélioration : 2.1.0 La prise en charge des identifiants a été introduite pour GML 3.

note: Tag: para
en: Only version 3+ of ST_AsGML supports Polyhedral Surfaces and TINS.
fr: Seule la version 3+ de ST_AsGML prend en charge les surfaces polyédriques et les TINS.

note: Tag: title
en: Examples: Version 2
fr: Exemples : Version 2

note: Tag: title
en: Examples: Version 3
fr: Exemples : Version 3

note: Tag: refpurpose
en: Return the geometry as a KML element.
fr: Renvoyer la géométrie sous forme d'élément KML.

note: Tag: para
en: Return the geometry as a Keyhole Markup Language (KML) element. default maximum number of decimal places is 15, default namespace is no prefix.
fr: Renvoie la géométrie sous la forme d'un élément KML (Keyhole Markup Language). Le nombre maximal de décimales par défaut est de 15, la valeur par défaut du namespace est sans préfixe.

note: Tag: para
en: Requires PostGIS be compiled with Proj support. Use <xref linkend="PostGIS_Full_Version"/> to confirm you have proj support compiled in.
fr: Exige que PostGIS soit compilé avec le support Proj. Utilisez <xref linkend="PostGIS_Full_Version"/> pour confirmer que vous avez compilé le support Proj.

note: Tag: para
en: Availability: 1.2.2 - later variants that include version param came in 1.3.2
fr: Disponibilité : 1.2.2 - les variantes ultérieures qui incluent le paramétrage de la version sont disponibles dans la version 1.3.2

note: Tag: para
en: Enhanced: 2.0.0 - Add prefix namespace, use default and named args
fr: Amélioré : 2.0.0 - Ajout d'un préfixe namespace, utilisation d'arguments par défaut et d'arguments nommés

note: Tag: para
en: Changed: 3.0.0 - Removed the "versioned" variant signature
fr: Modifié : 3.0.0 - Suppression de la signature de la variante "versioned"

note: Tag: para
en: AsKML output will not work with geometries that do not have an SRID
fr: La sortie AsKML ne fonctionnera pas avec les géométries qui n'ont pas de SRID

note: Tag: refpurpose
en: Return the Degrees, Minutes, Seconds representation of the given point.
fr: Renvoie la représentation en degrés, minutes et secondes du point donné.

note: Tag: para
en: Returns the Degrees, Minutes, Seconds representation of the point.
fr: Renvoie la représentation en degrés, minutes et secondes du point.

note: Tag: para
en: It is assumed the point is in a lat/lon projection. The X (lon) and Y (lat) coordinates are normalized in the output to the "normal" range (-180 to +180 for lon, -90 to +90 for lat).
fr: On suppose que le point se trouve dans une projection lat/lon. Les coordonnées X (lon) et Y (lat) sont normalisées dans la sortie à la plage "normale" (-180 à +180 pour lon, -90 à +90 pour lat).

note: Tag: para
en: The text parameter is a format string containing the format for the resulting text, similar to a date format string. Valid tokens are "D" for degrees, "M" for minutes, "S" for seconds, and "C" for cardinal direction (NSEW). DMS tokens may be repeated to indicate desired width and precision ("SSS.SSSS" means " 1.0023").
fr: Le paramètre text est une chaîne de caractères contenant le format du texte résultant, similaire à une chaîne de caractères de date. Les symboles autorisés sont "D" pour les degrés, "M" pour les minutes, "S" pour les secondes et "C" pour la direction cardinale (NSEW). Les jetons DMS peuvent être répétés pour indiquer la largeur et la précision souhaitées ("SSS.SSSS" signifie "1,0023").

note: Tag: para
en: "M", "S", and "C" are optional. If "C" is omitted, degrees are shown with a "-" sign if south or west. If "S" is omitted, minutes will be shown as decimal with as many digits of precision as you specify. If "M" is also omitted, degrees are shown as decimal with as many digits precision as you specify.
fr: Les lettres "M", "S" et "C" sont facultatives. Si "C" est omis, les degrés sont indiqués avec un signe "-" s'il s'agit du sud ou de l'ouest. Si "S" est omis, les minutes sont affichées sous forme décimale avec autant de chiffres de précision que vous le spécifiez. Si "M" est également omis, les degrés sont affichés sous forme décimale avec autant de chiffres de précision que vous le spécifiez.

note: Tag: para
en: If the format string is omitted (or zero-length) a default format will be used.
fr: Si la chaîne de caractères format est omise (ou de longueur nulle), un format par défaut sera utilisé.

note: Tag: para
en: Default format.
fr: Format par défaut.

note: Tag: para
en: Providing a format (same as the default).
fr: Fournir un format (identique au format par défaut).

note: Tag: para
en: Characters other than D, M, S, C and . are just passed through.
fr: Les caractères autres que D, M, S, C et . ne sont pas pris en compte.

note: Tag: para
en: Signed degrees instead of cardinal directions.
fr: Les degrés signés au lieu des directions cardinales.

note: Tag: para
en: Decimal degrees.
fr: Degrés décimaux.

note: Tag: para
en: Excessively large values are normalized.
fr: Les valeurs trop importantes sont normalisées.

note: Tag: refpurpose
en: Returns geometry as a MARC21/XML record with a geographic datafield (034).
fr: Renvoie la géométrie sous forme d'enregistrement MARC21/XML avec un champ de données géographiques (034).

note: Tag: para
en: This function returns a MARC21/XML record with <link xlink:href="https://www.loc.gov/marc/bibliographic/bd034.html">Coded Cartographic Mathematical Data</link> representing the bounding box of a given geometry. The <varname>format</varname> parameter allows to encode the coordinates in subfields <varname>$d</varname>,<varname>$e</varname>,<varname>$f</varname> and <varname>$g</varname> in all formats supported by the MARC21/XML standard. Valid formats are:
fr: Cette fonction renvoie un enregistrement MARC21/XML avec <link xlink:href="https://www.loc.gov/marc/bibliographic/bd034.html">Coded Cartographic Mathematical Data</link> représentant la boîte de délimitation d'une géométrie donnée. Le paramètre <varname>format</varname> permet de coder les coordonnées dans les sous-champs <varname>$d</varname>,<varname>$e</varname>,<varname>$f</varname> et <varname>$g</varname> dans tous les formats pris en charge par la norme MARC21/XML. Les formats valides sont les suivants :

note: Tag: para
en: cardinal direction, degrees, minutes and seconds (default): <varname>hdddmmss</varname>
fr: la direction cardinale, en degrés, minutes et secondes (par défaut) : <varname>hdddmmss</varname>

note: Tag: para
en: decimal degrees with cardinal direction: <varname>hddd.dddddd</varname>
fr: degrés décimaux avec la direction cardinale : <varname>hddd.dddddd</varname>

note: Tag: para
en: decimal degrees without cardinal direction: <varname>ddd.dddddd</varname>
fr: degrés décimaux sans direction cardinale : <varname>ddd.dddddd</varname>

note: Tag: para
en: decimal minutes with cardinal direction: <varname>hdddmm.mmmm</varname>
fr: minutes décimales avec la direction cardinale : <varname>hdddmm.mmmm</varname>

note: Tag: para
en: decimal minutes without cardinal direction: <varname>dddmm.mmmm</varname>
fr: minutes décimales sans direction cardinale : <varname>dddmm.mmmm</varname>

note: Tag: para
en: decimal seconds with cardinal direction: <varname>hdddmmss.sss</varname>
fr: secondes décimales avec la direction cardinale : <varname>hdddmmss.sss</varname>

note: Tag: para
en: The decimal sign may be also a comma, e.g. <varname>hdddmm,mmmm</varname>.
fr: Le signe décimal peut également être une virgule, par exemple <varname>hdddmm,mmmm</varname>.

note: Tag: para
en: The precision of decimal formats can be limited by the number of characters after the decimal sign, e.g. <varname>hdddmm.mm</varname> for decimal minutes with a precision of two decimals.
fr: La précision des formats décimaux peut être limitée par le nombre de caractères après le signe décimal, par exemple <varname>hdddmm.mm</varname> pour des minutes décimales avec une précision de deux décimales.

note: Tag: para
en: This function ignores the Z and M dimensions.
fr: Cette fonction ignore les dimensions Z et M.

note: Tag: para
en: This function does not support non lon/lat geometries, as they are not supported by the MARC21/XML standard (Coded Cartographic Mathematical Data).
fr: Cette fonction ne prend pas en charge les géométries non lon/lat, car elles ne sont pas prises en charge par la norme MARC21/XML (Coded Cartographic Mathematical Data).

note: Tag: para
en: The MARC21/XML Standard does not provide any means to annotate the spatial reference system for Coded Cartographic Mathematical Data, which means that this information will be lost after conversion to MARC21/XML.
fr: La norme MARC21/XML ne prévoit aucun moyen d'annoter le système de référence spatiale pour les données mathématiques cartographiques codées, ce qui signifie que cette information sera perdue après la conversion au format MARC21/XML.

note: Tag: para
en: Converting a <varname>POINT</varname> to MARC21/XML formatted as hdddmmss (default)
fr: Conversion d'un <varname>POINT</varname> en MARC21/XML au format hdddmmss (par défaut)

note: Tag: para
en: Converting a <varname>POLYGON</varname> to MARC21/XML formatted in decimal degrees
fr: Conversion d'un <varname>POLYGON</varname> en MARC21/XML formaté en degrés décimaux

note: Tag: para
en: Converting a <varname>GEOMETRYCOLLECTION</varname> to MARC21/XML formatted in decimal minutes. The geometries order in the MARC21/XML output correspond to their order in the collection.
fr: Conversion d'une <varname>GEOMETRYCOLLECTION</varname> en MARC21/XML en minutes décimales. L'ordre des géométries dans la sortie MARC21/XML correspond à leur ordre dans la collection.

note: Tag: refpurpose
en: Transforms a geometry into the coordinate space of a MVT tile.
fr: Transforme une géométrie dans l'espace de coordonnées d'une tuile MVT.

note: Tag: para
en: Transforms a geometry into the coordinate space of a MVT (<link xlink:href="https://www.mapbox.com/vector-tiles/">Mapbox Vector Tile</link>) tile, clipping it to the tile bounds if required. The geometry must be in the coordinate system of the target map (using <xref linkend="ST_Transform"/> if needed). Commonly this is <link xlink:href="https://en.wikipedia.org/wiki/Web_Mercator_projection">Web Mercator</link> (SRID:3857).
fr: Transforme une géométrie dans l'espace de coordonnées d'une tuile MVT (<link xlink:href="https://www.mapbox.com/vector-tiles/">Mapbox Vector Tile</link>), en l'ajustant aux limites de la tuile si nécessaire. La géométrie doit être dans le système de coordonnées de la carte cible (en utilisant <xref linkend="ST_Transform"/> si nécessaire). Il s'agit généralement de <link xlink:href="https://en.wikipedia.org/wiki/Web_Mercator_projection">Web Mercator</link> (SRID:3857).

note: Tag: para
en: The function attempts to preserve geometry validity, and corrects it if needed. This may cause the result geometry to collapse to a lower dimension.
fr: La fonction tente de préserver la validité de la géométrie et la corrige si nécessaire. Cela peut entraîner l'effondrement de la géométrie résultante à une dimension inférieure.

note: Tag: para
en: The rectangular bounds of the tile in the target map coordinate space must be provided, so the geometry can be transformed, and clipped if required. The bounds can be generated using <xref linkend="ST_TileEnvelope"/>.
fr: Les limites rectangulaires de la tuile dans l'espace de coordonnées de la carte cible doivent être fournies, afin que la géométrie puisse être transformée et coupée si nécessaire. Les limites peuvent être générées à l'aide de <xref linkend="ST_TileEnvelope"/>.

note: Tag: para
en: This function is used to convert geometry into the tile coordinate space required by <xref linkend="ST_AsMVT"/>.
fr: Cette fonction est utilisée pour convertir la géométrie dans l'espace de coordonnées de la tuile requis par <xref linkend="ST_AsMVT"/>.

note: Tag: para
en: <varname>geom</varname> is the geometry to transform, in the coordinate system of the target map.
fr: <varname>geom</varname> est la géométrie à transformer, dans le système de coordonnées de la carte cible.

note: Tag: para
en: <varname>bounds</varname> is the rectangular bounds of the tile in map coordinate space, with no buffer.
fr: <varname>bounds</varname> est la limite rectangulaire de la tuile dans l'espace de coordonnées de la carte, sans tampon.

note: Tag: para
en: <varname>extent</varname> is the tile extent size in tile coordinate space as defined by the <link xlink:href="https://www.mapbox.com/vector-tiles/specification/">MVT specification</link>. Defaults to 4096.
fr: <varname>extent</varname> est la taille de l'étendue de la tuile dans l'espace de coordonnées de la tuile tel que défini par la <link xlink:href="https://www.mapbox.com/vector-tiles/specification/">spécification MVT</link>. La valeur par défaut est 4096.

note: Tag: para
en: <varname>buffer</varname> is the buffer size in tile coordinate space for geometry clippig. Defaults to 256.
fr: <varname>buffer</varname> est la taille du tampon dans l'espace de coordonnées de la tuile pour le découpage de la géométrie. La valeur par défaut est 256.

note: Tag: para
en: <varname>clip_geom</varname> is a boolean to control if geometries are clipped or encoded as-is. Defaults to true.
fr: <varname>clip_geom</varname> est un booléen qui contrôle si les géométries sont découpées ou encodées telles quelles. La valeur par défaut est true.

note: Tag: para
en: From 3.0, Wagyu can be chosen at configure time to clip and validate MVT polygons. This library is faster and produces more correct results than the GEOS default, but it might drop small polygons.
fr: A partir de la version 3.0, Wagyu peut être choisi au moment de la configuration pour découper et valider les polygones MVT. Cette bibliothèque est plus rapide et produit des résultats plus corrects que la bibliothèque par défaut de GEOS, mais elle peut mettre de côté de petits polygones.

note: Tag: para
en: Canonical example for a Web Mercator tile using a computed tile bounds to query and clip geometry.
fr: Exemple canonique d'une tuile Web Mercator utilisant les limites calculées d'une tuile pour interroger et découper la géométrie.

note: Tag: refpurpose
en: Aggregate function returning a MVT representation of a set of rows.
fr: Fonction d'agrégation renvoyant une représentation MVT d'un ensemble de lignes.

note: Tag: para
en: An aggregate function which returns a binary <link xlink:href="https://www.mapbox.com/vector-tiles/">Mapbox Vector Tile</link> representation of a set of rows corresponding to a tile layer. The rows must contain a geometry column which will be encoded as a feature geometry. The geometry must be in tile coordinate space and valid as per the <link xlink:href="https://www.mapbox.com/vector-tiles/specification/">MVT specification</link>. <xref linkend="ST_AsMVTGeom"/> can be used to transform geometry into tile coordinate space. Other row columns are encoded as feature attributes.
fr: Une fonction agrégée qui renvoie une représentation binaire <link xlink:href="https://www.mapbox.com/vector-tiles/">Mapbox Vector Tile</link> d'un ensemble de lignes correspondant à une couche de tuiles. Les lignes doivent contenir une colonne de géométrie qui sera encodée comme une géométrie d'élément. La géométrie doit être dans l'espace de coordonnées de la tuile et valide conformément à la <link xlink:href="https://www.mapbox.com/vector-tiles/specification/">spécification MVT</link>. <xref linkend="ST_AsMVTGeom"/> peut être utilisé pour transformer la géométrie dans l'espace de coordonnées des tuiles. Les autres colonnes de la ligne sont encodées en tant qu'attributs de caractéristiques.

note: Tag: para
en: The <link xlink:href="https://www.mapbox.com/vector-tiles/">Mapbox Vector Tile</link> format can store features with varying sets of attributes. To use this capability supply a JSONB column in the row data containing Json objects one level deep. The keys and values in the JSONB values will be encoded as feature attributes.
fr: Le format <link xlink:href="https://www.mapbox.com/vector-tiles/">Mapbox Vector Tile</link> peut stocker des éléments avec différents ensembles d'attributs. Pour utiliser cette fonctionnalité, il convient de fournir une colonne JSONB dans les données de la ligne contenant des objets Json à un niveau de profondeur. Les clés et les valeurs des valeurs JSONB seront encodées en tant qu'attributs d'entités.

note: Tag: para
en: Tiles with multiple layers can be created by concatenating multiple calls to this function using <varname>||</varname> or <varname>STRING_AGG</varname>.
fr: Les tuiles à couches multiples peuvent être créées en concaténant plusieurs appels à cette fonction en utilisant <varname>||</varname> ou <varname>STRING_AGG</varname>.

note: Tag: para
en: Do not call with a <varname>GEOMETRYCOLLECTION</varname> as an element in the row. However you can use <xref linkend="ST_AsMVTGeom"/> to prepare a geometry collection for inclusion.
fr: Ne pas appeler avec un <varname>GEOMETRYCOLLECTION</varname> comme élément de la ligne. Cependant, vous pouvez utiliser <xref linkend="ST_AsMVTGeom"/> pour préparer une collection de géométrie à inclure.

note: Tag: para
en: <varname>name</varname> is the name of the layer. Default is the string "default".
fr: <varname>name</varname> est le nom de la couche. La valeur par défaut est la chaîne de caractères "default".

note: Tag: para
en: <varname>extent</varname> is the tile extent in screen space as defined by the specification. Default is 4096.
fr: <varname>extent</varname> est l'étendue de la tuile dans l'espace de l'écran tel que défini par la spécification. La valeur par défaut est 4096.

note: Tag: para
en: <varname>geom_name</varname> is the name of the geometry column in the row data. Default is the first geometry column. Note that PostgreSQL by default automatically <link xlink:href="https://www.postgresql.org/docs/current/sql-syntax-lexical.html#SQL-SYNTAX-IDENTIFIERS">folds unquoted identifiers to lower case</link>, which means that unless the geometry column is quoted, e.g. <varname>"MyMVTGeom"</varname>, this parameter must be provided as lowercase.
fr: <varname>geom_name</varname> est le nom de la colonne géométrique dans les données de la ligne. La valeur par défaut est la première colonne géométrique. Notez que PostgreSQL, par défaut, <link xlink:href="https://www.postgresql.org/docs/current/sql-syntax-lexical.html#SQL-SYNTAX-IDENTIFIERS">plie automatiquement les identifiants non cités en minuscules</link>, ce qui signifie qu'à moins que la colonne géométrique ne soit citée, par exemple <varname>"MyMVTGeom"</varname>, ce paramètre doit être fourni en minuscules.

note: Tag: para
en: <varname>feature_id_name</varname> is the name of the Feature ID column in the row data. If NULL or negative the Feature ID is not set. The first column matching name and valid type (smallint, integer, bigint) will be used as Feature ID, and any subsequent column will be added as a property. JSON properties are not supported.
fr: <varname>feature_id_name</varname> est le nom de la colonne Feature ID dans les données de la ligne. S'il est NULL ou négatif, l'identifiant de la caractéristique n'est pas défini. La première colonne correspondant au nom et au type valide (smallint, integer, bigint) sera utilisée comme Feature ID, et toute colonne suivante sera ajoutée en tant que propriété. Les propriétés JSON ne sont pas prises en charge.

note: Tag: para
en: Enhanced: 3.0 - added support for Feature ID.
fr: Amélioration : 3.0 - ajout de la prise en charge du Feature ID.

note: Tag: para
en: Enhanced: 2.5.0 - added support parallel query.
fr: Amélioration : 2.5.0 - ajout de la prise en charge des requêtes parallèles.

note: Tag: refpurpose
en: Returns SVG path data for a geometry.
fr: Renvoie les données de chemin SVG pour une géométrie.

note: Tag: para
en: Return the geometry as Scalar Vector Graphics (SVG) path data. Use 1 as second argument to have the path data implemented in terms of relative moves, the default (or 0) uses absolute moves. Third argument may be used to reduce the maximum number of decimal digits used in output (defaults to 15). Point geometries will be rendered as cx/cy when 'rel' arg is 0, x/y when 'rel' is 1. Multipoint geometries are delimited by commas (","), GeometryCollection geometries are delimited by semicolons (";").
fr: Renvoie la géométrie sous forme de données de chemin SVG (Scalar Vector Graphics). Utilisez 1 comme deuxième argument pour que les données de chemin soient implémentées en termes de déplacements relatifs, la valeur par défaut (ou 0) utilise des déplacements absolus. Le troisième argument peut être utilisé pour réduire le nombre maximal de chiffres décimaux utilisés dans la sortie (15 par défaut). Les géométries ponctuelles seront rendues sous la forme cx/cy lorsque l'argument 'rel' est 0, x/y lorsque 'rel' est 1. Les géométries multipoints sont délimitées par des virgules (","), les géométries GeometryCollection sont délimitées par des points-virgules (" ;").

note: Tag: para
en: For working with PostGIS SVG graphics, checkout <link xlink:href="https://github.com/dr-jts/pg_svg">pg_svg</link> library which provides plpgsql functions for working with outputs from ST_AsSVG.
fr: Pour travailler avec les graphiques PostGIS SVG, consultez la bibliothèque <link xlink:href="https://github.com/dr-jts/pg_svg">pg_svg</link> qui fournit des fonctions plpgsql pour travailler avec les résultats de ST_AsSVG.

note: Tag: para
en: Enhanced: 3.4.0 to support all curve types
fr: Amélioration : 3.4.0 pour prendre en charge tous les types de courbes

note: Tag: para
en: Changed: 2.0.0 to use default args and support named args
fr: Modifié : 2.0.0 pour utiliser les args par défaut et supporter les args nommés

note: Tag: para
en: Availability: 1.2.2. Availability: 1.4.0 Changed in PostGIS 1.4.0 to include L command in absolute path to conform to <link xlink:href="http://www.w3.org/TR/SVG/paths.html#PathDataBNF">http://www.w3.org/TR/SVG/paths.html#PathDataBNF</link>
fr: Disponibilité : 1.2.2. Disponibilité : 1.4.0 Modifié dans PostGIS 1.4.0 pour inclure la commande L dans le chemin absolu afin de se conformer à <link xlink:href="http://www.w3.org/TR/SVG/paths.html#PathDataBNF">http://www.w3.org/TR/SVG/paths.html#PathDataBNF</link>

note: Tag: refpurpose
en: Returns the geometry as TWKB, aka "Tiny Well-Known Binary"
fr: Renvoie la géométrie sous forme de TWKB, diminutif de "Tiny Well-Known Binary"

note: Tag: para
en: Returns the geometry in TWKB (Tiny Well-Known Binary) format. TWKB is a <link xlink:href="https://github.com/TWKB/Specification/blob/master/twkb.md">compressed binary format</link> with a focus on minimizing the size of the output.
fr: Renvoie la géométrie au format TWKB (Tiny Well-Known Binary). TWKB est un <link xlink:href="https://github.com/TWKB/Specification/blob/master/twkb.md">format binaire compressé</link> dont l'objectif est de minimiser la taille de la sortie.

note: Tag: para
en: The decimal digits parameters control how much precision is stored in the output. By default, values are rounded to the nearest unit before encoding. If you want to transfer more precision, increase the number. For example, a value of 1 implies that the first digit to the right of the decimal point will be preserved.
fr: Les paramètres relatifs aux chiffres décimaux déterminent le degré de précision stocké dans la sortie. Par défaut, les valeurs sont arrondies à l'unité la plus proche avant l'encodage. Si vous souhaitez transférer plus de précision, augmentez le nombre. Par exemple, une valeur de 1 implique que le premier chiffre à droite du point décimal sera préservé.

note: Tag: para
en: The sizes and bounding boxes parameters control whether optional information about the encoded length of the object and the bounds of the object are included in the output. By default they are not. Do not turn them on unless your client software has a use for them, as they just use up space (and saving space is the point of TWKB).
fr: Les paramètres "sizes" et "bounding boxes" déterminent si les informations optionnelles concernant la longueur encodée de l'objet et les limites de l'objet sont incluses dans la sortie. Par défaut, elles ne le sont pas. Ne les activez pas à moins que votre logiciel client n'en ait l'utilité, car ils ne font qu'utiliser de l'espace (et économiser de l'espace est l'objectif de TWKB).

note: Tag: para
en: The array-input form of the function is used to convert a collection of geometries and unique identifiers into a TWKB collection that preserves the identifiers. This is useful for clients that expect to unpack a collection and then access further information about the objects inside. You can create the arrays using the <link xlink:href="https://www.postgresql.org/docs/current/functions-aggregate.html">array_agg</link> function. The other parameters operate the same as for the simple form of the function.
fr: La forme tableau de la fonction est utilisée pour convertir une collection de géométries et d'identifiants uniques en une collection TWKB qui préserve les identifiants. Cette fonction est utile pour les clients qui souhaitent décompresser une collection et accéder ensuite à d'autres informations sur les objets qu'elle contient. Vous pouvez créer les tableaux à l'aide de la fonction <link xlink:href="https://www.postgresql.org/docs/current/functions-aggregate.html">array_agg</link>. Les autres paramètres sont les mêmes que pour la forme simple de la fonction.

note: Tag: para
en: The format specification is available online at <link xlink:href="https://github.com/TWKB/Specification">https://github.com/TWKB/Specification</link>, and code for building a JavaScript client can be found at <link xlink:href="https://github.com/TWKB/twkb.js">https://github.com/TWKB/twkb.js</link>.
fr: La spécification du format est disponible en ligne à l'adresse <link xlink:href="https://github.com/TWKB/Specification">https://github.com/TWKB/Specification</link>, et le code permettant de créer un client JavaScript est disponible à l'adresse <link xlink:href="https://github.com/TWKB/twkb.js">https://github.com/TWKB/twkb.js</link>.

note: Tag: para
en: Enhanced: 2.4.0 memory and speed improvements.
fr: Amélioration : 2.4.0 amélioration de la mémoire et de la vitesse.

note: Tag: para
en: To create an aggregate TWKB object including identifiers aggregate the desired geometries and objects first, using "array_agg()", then call the appropriate TWKB function.
fr: Pour créer un objet TWKB agrégé comprenant des identifiants, il faut d'abord agréger les géométries et les objets souhaités en utilisant "array_agg()", puis appeler la fonction TWKB appropriée.

note: Tag: refpurpose
en: Returns a Geometry in X3D xml node element format: ISO-IEC-19776-1.2-X3DEncodings-XML
fr: Renvoie une géométrie au format X3D xml node element : ISO-IEC-19776-1.2-X3DEncodings-XML

note: Tag: para
en: Returns a geometry as an X3D xml formatted node element <link xlink:href="http://www.web3d.org/standards/number/19776-1">http://www.web3d.org/standards/number/19776-1</link>. If <varname>maxdecimaldigits</varname> (precision) is not specified then defaults to 15.
fr: Renvoie une géométrie sous la forme d'un élément de nœud X3D xml formaté <link xlink:href="http://www.web3d.org/standards/number/19776-1">http://www.web3d.org/standards/number/19776-1</link>. Si <varname>maxdecimaldigits</varname> (précision) n'est pas spécifié, la valeur par défaut est 15.

note: Tag: para
en: There are various options for translating PostGIS geometries to X3D since X3D geometry types don't map directly to PostGIS geometry types and some newer X3D types that might be better mappings we have avoided since most rendering tools don't currently support them. These are the mappings we have settled on. Feel free to post a bug ticket if you have thoughts on the idea or ways we can allow people to denote their preferred mappings.
fr: Il existe plusieurs options pour traduire les géométries PostGIS en X3D, car les types de géométrie X3D ne correspondent pas directement aux types de géométrie PostGIS, et nous avons évité certains types X3D plus récents qui pourraient constituer de meilleures correspondances, car la plupart des outils de rendu ne les prennent pas en charge actuellement. Ce sont les correspondances que nous avons choisies. N'hésitez pas à poster un ticket de bug si vous avez des idées sur l'idée ou sur la façon dont nous pouvons permettre aux gens de dénoter leurs correspondances préférées.

note: Tag: para
en: Below is how we currently map PostGIS 2D/3D types to X3D types
fr: Voici comment nous faisons actuellement correspondre les types 2D/3D de PostGIS aux types X3D

note: Tag: para
en: The 'options' argument is a bitfield. For PostGIS 2.2+, this is used to denote whether to represent coordinates with X3D GeoCoordinates Geospatial node and also whether to flip the x/y axis. By default, <code>ST_AsX3D</code> outputs in database form (long,lat or X,Y), but X3D default of lat/lon, y/x may be preferred.
fr: L'argument 'options' est un champ de bits. Pour PostGIS 2.2+, il est utilisé pour indiquer si les coordonnées doivent être représentées avec le nœud géospatial X3D GeoCoordinates et si l'axe x/y doit être inversé. Par défaut, <code>ST_AsX3D</code> produit les données sous forme de base de données (long,lat ou X,Y), mais la valeur par défaut de lat/lon, y/x de X3D peut être préférée.

note: Tag: para
en: 0: X/Y in database order (e.g. long/lat = X,Y is standard database order), default value, and non-spatial coordinates (just regular old Coordinate tag).
fr: 0 : X/Y dans l'ordre de la base de données (par exemple long/lat = X,Y est l'ordre standard de la base de données), valeur par défaut, et coordonnées non spatiales (juste un bon vieux Coordinate tag).

note: Tag: para
en: 1: Flip X and Y. If used in conjunction with the GeoCoordinate option switch, then output will be default "latitude_first" and coordinates will be flipped as well.
fr: 1 : Inverser X et Y. Si cette option est utilisée en conjonction avec l'option GeoCoordinate, la sortie sera par défaut "latitude_first" et les coordonnées seront également inversées.

note: Tag: para
en: 2: Output coordinates in GeoSpatial GeoCoordinates. This option will throw an error if geometries are not in WGS 84 long lat (srid: 4326). This is currently the only GeoCoordinate type supported. <link xlink:href="http://www.web3d.org/documents/specifications/19775-1/V3.2/Part01/components/geodata.html#Specifyingaspatialreference">Refer to X3D specs specifying a spatial reference system.</link>. Default output will be <code>GeoCoordinate geoSystem='"GD" "WE" "longitude_first"'</code>. If you prefer the X3D default of <code>GeoCoordinate geoSystem='"GD" "WE" "latitude_first"'</code> use <code>(2 + 1)</code> = <code>3</code>
fr: 2 : Sortie des coordonnées enGeoSpatial GeoCoordinates. Cette option génère une erreur si les géométries ne sont pas en WGS 84 long lat (srid : 4326). C'est actuellement le seul type de GeoCoordinate pris en charge. <link xlink:href="http://www.web3d.org/documents/specifications/19775-1/V3.2/Part01/components/geodata.html#Specifyingaspatialreference">Référence aux spécifications X3D spécifiant un système de référence spatiale.</link>. La sortie par défaut sera <code>GeoCoordinate geoSystem='"GD" "WE" "longitude_first"'</code>. Si vous préférez la sortie par défaut X3D de <code>GeoCoordinate geoSystem='"GD" "WE" "latitude_first"'</code>, utilisez <code>(2 + 1)</code> = <code>3</code>

note: Tag: entry
en: PostGIS Type
fr: Type PostGIS

note: Tag: entry
en: 2D X3D Type
fr: Type 2D X3D

note: Tag: entry
en: 3D X3D Type
fr: Type 3D X3D

note: Tag: entry
en: not yet implemented - will be PolyLine2D
fr: pas encore implémenté - sera PolyLine2D

note: Tag: entry
en: outputs the space delimited coordinates
fr: produit les coordonnées délimitées par l'espace

note: Tag: entry
en: Invalid X3D markup
fr: Balises X3D non valides

note: Tag: entry
en: IndexedFaceSet (inner rings currently output as another faceset)
fr: IndexedFaceSet (les anneaux intérieurs sont actuellement édités sous la forme d'un autre jeu de faces)

note: Tag: entry
en: TriangleSet2D (Not Yet Implemented)
fr: TriangleSet2D (Pas encore implémenté)

note: Tag: para
en: 2D geometry support not yet complete. Inner rings currently just drawn as separate polygons. We are working on these.
fr: La prise en charge de la géométrie 2D n'est pas encore terminée. Les anneaux intérieurs sont actuellement dessinés comme des polygones séparés. Nous y travaillons.

note: Tag: para
en: Lots of advancements happening in 3D space particularly with <link xlink:href="https://www.web3d.org/wiki/index.php/X3D_and_HTML5">X3D Integration with HTML5</link>
fr: De nombreuses avancées ont lieu dans l'espace 3D, en particulier avec <link xlink:href="https://www.web3d.org/wiki/index.php/X3D_and_HTML5">X3D Integration with HTML5</link>

note: Tag: para
en: There is also a nice open source X3D viewer you can use to view rendered geometries. Free Wrl <link xlink:href="http://freewrl.sourceforge.net/">http://freewrl.sourceforge.net/</link> binaries available for Mac, Linux, and Windows. Use the FreeWRL_Launcher packaged to view the geometries.
fr: Il existe également une visionneuse X3D open source que vous pouvez utiliser pour visualiser les géométries rendues. Des binaires Wrl <link xlink:href="http://freewrl.sourceforge.net/">http://freewrl.sourceforge.net/</link> gratuits sont disponibles pour Mac, Linux et Windows. Utilisez le FreeWRL_Launcher pour visualiser les géométries.

note: Tag: para
en: Also check out <link xlink:href="https://git.osgeo.org/gitea/robe/postgis_x3d_viewer">PostGIS minimalist X3D viewer</link> that utilizes this function and <link xlink:href="http://www.x3dom.org/">x3dDom html/js open source toolkit</link>.
fr: Consultez également <link xlink:href="https://git.osgeo.org/gitea/robe/postgis_x3d_viewer">PostGIS minimalist X3D viewer</link> qui utilise cette fonction et <link xlink:href="http://www.x3dom.org/">x3dDom html/js open source toolkit</link>.

note: Tag: para
en: Availability: 2.0.0: ISO-IEC-19776-1.2-X3DEncodings-XML
fr: Disponibilité : 2.0.0: ISO-IEC-19776-1.2-X3DEncodings-XML

note: Tag: para
en: Enhanced: 2.2.0: Support for GeoCoordinates and axis (x/y, long/lat) flipping. Look at options for details.
fr: Amélioration : 2.2.0 : Prise en charge des coordonnées géographiques et de l'inversion des axes (x/y, long/lat). Voir les options pour plus de détails.

note: Tag: title
en: Example: Create a fully functional X3D document - This will generate a cube that is viewable in FreeWrl and other X3D viewers.
fr: Exemple : Créer un document X3D entièrement fonctionnel - Cela permet de générer un cube qui peut être visualisé dans FreeWrl et d'autres visionneuses X3D.

note: Tag: title
en: PostGIS buildings
fr: Bâtiments PostGIS

note: Tag: para
en: Copy and paste the output of this query to <link xlink:href="http://postgis.net/docs/support/viewers/x3d_viewer.htm">x3d scene viewer</link> and click Show
fr: Copiez et collez le résultat de cette requête dans <link xlink:href="http://postgis.net/docs/support/viewers/x3d_viewer.htm">x3d scene viewer</link> et cliquez sur Show

note: Tag: para
en: Buildings formed by subdividing PostGIS and extrusion
fr: Bâtiments formés par subdivision PostGIS et extrusion

note: Tag: title
en: Example: An Octagon elevated 3 Units and decimal precision of 6
fr: Exemple : Un octogone élevé à 3 unités et une précision décimale de 6

note: Tag: title
en: Example: TIN
fr: Exemple : TIN

note: Tag: title
en: Example: Closed multilinestring (the boundary of a polygon with holes)
fr: Exemple : multiligne fermée (la limite d'un polygone avec des trous)

note: Tag: refpurpose
en: Return a GeoHash representation of the geometry.
fr: Retourne une représentation GeoHash de la géométrie.

note: Tag: para
en: Computes a <link xlink:href="http://en.wikipedia.org/wiki/Geohash">GeoHash</link> representation of a geometry. A GeoHash encodes a geographic Point into a text form that is sortable and searchable based on prefixing. A shorter GeoHash is a less precise representation of a point. It can be thought of as a box that contains the point.
fr: Calcule une représentation <link xlink:href="http://en.wikipedia.org/wiki/Geohash">GeoHash</link> d'une géométrie. Un GeoHash encode un point géographique sous forme de texte qui peut être trié et recherché en fonction du préfixe. Un GeoHash plus court est une représentation moins précise d'un point. Il peut être considéré comme une boîte qui contient le point.

note: Tag: para
en: Non-point geometry values with non-zero extent can also be mapped to GeoHash codes. The precision of the code depends on the geographic extent of the geometry.
fr: Les valeurs géométriques non ponctuelles dont l'étendue n'est pas nulle peuvent également être mises en correspondance avec des codes GeoHash. La précision du code dépend de l'étendue géographique de la géométrie.

note: Tag: para
en: If <varname>maxchars</varname> is not specified, the returned GeoHash code is for the smallest cell containing the input geometry. Points return a GeoHash with 20 characters of precision (about enough to hold the full double precision of the input). Other geometric types may return a GeoHash with less precision, depending on the extent of the geometry. Larger geometries are represented with less precision, smaller ones with more precision. The box determined by the GeoHash code always contains the input feature.
fr: Si <varname>maxchars</varname> n'est pas spécifié, le code GeoHash renvoyé correspond à la plus petite cellule contenant la géométrie d'entrée. Les points renvoient un GeoHash avec 20 caractères de précision (ce qui est suffisant pour contenir la double précision de l'entrée). D'autres types géométriques peuvent renvoyer un GeoHash avec moins de précision, en fonction de l'étendue de la géométrie. Les géométries plus grandes sont représentées avec moins de précision, les plus petites avec plus de précision. La boîte déterminée par le code GeoHash contient toujours l'élément d'entrée.

note: Tag: para
en: If <varname>maxchars</varname> is specified the returned GeoHash code has at most that many characters. It maps to a (possibly) lower precision representation of the input geometry. For non-points, the starting point of the calculation is the center of the bounding box of the geometry.
fr: Si <varname>maxchars</varname> est spécifié, le code GeoHash renvoyé comporte au maximum ce nombre de caractères. Il correspond à une représentation (éventuellement) de moindre précision de la géométrie d'entrée. Pour les non-points, le point de départ du calcul est le centre de la boîte de délimitation de la géométrie.

note: Tag: para
en: ST_GeoHash requires input geometry to be in geographic (lon/lat) coordinates.
fr: ST_GeoHash exige que la géométrie d'entrée soit en coordonnées géographiques (lon/lat).

note: Tag: title
en: Overlay Functions
fr: Fonctions de superposition

note: Tag: para
en: These functions compute results arising from the overlay of two geometries. These are also known as point-set theoretic boolean operations. Some related functions are also provided.
fr: Ces fonctions calculent les résultats découlant de la superposition de deux géométries. Elles sont également connues sous le nom d'opérations booléennes de la théorie des ensembles de points. Certaines fonctions connexes sont également fournies.

note: Tag: refpurpose
en: Computes the portion of a geometry falling within a rectangle.
fr: Calcule la partie d'une géométrie située à l'intérieur d'un rectangle.

note: Tag: para
en: Clips a geometry by a 2D box in a fast and tolerant but possibly invalid way. Topologically invalid input geometries do not result in exceptions being thrown. The output geometry is not guaranteed to be valid (in particular, self-intersections for a polygon may be introduced).
fr: Coupe une géométrie par une boîte 2D d'une manière rapide et tolérante, mais qui peut être invalide. Les géométries d'entrée topologiquement invalides n'entraînent pas la levée d'exceptions. La géométrie de sortie n'est pas garantie valide (en particulier, des auto-intersections pour un polygone peuvent être introduites).

note: Tag: refpurpose
en: Computes a geometry representing the part of geometry A that does not intersect geometry B.
fr: Calcule une géométrie représentant la partie de la géométrie A qui n'intersecte pas la géométrie B.

note: Tag: para
en: Returns a geometry representing the part of geometry A that does not intersect geometry B. This is equivalent to <code>A - ST_Intersection(A,B)</code>. If A is completely contained in B then an empty atomic geometry of appropriate type is returned.
fr: Renvoie une géométrie représentant la partie de la géométrie A qui n'intersecte pas la géométrie B. Ceci est équivalent à <code>A - ST_Intersection(A,B)</code>. Si A est entièrement contenue dans B, une géométrie atomique vide du type approprié est renvoyée.

note: Tag: para
en: This is the only overlay function where input order matters. ST_Difference(A, B) always returns a portion of A.
fr: Il s'agit de la seule fonction de superposition pour laquelle l'ordre d'entrée est important. ST_Difference(A, B) renvoie toujours une partie de A.

note: Tag: para
en: If the optional <code>gridSize</code> argument is provided, the inputs are snapped to a grid of the given size, and the result vertices are computed on that same grid. (Requires GEOS-3.9.0 or higher)
fr: Si l'argument optionnel <code>gridSize</code> est fourni, les entrées sont placées sur une grille de la taille donnée, et les sommets du résultat sont calculés sur cette même grille. (Nécessite GEOS-3.9.0 ou plus)

note: Tag: para
en: Enhanced: 3.1.0 accept a gridSize parameter.
fr: Amélioration : 3.1.0 accepte un paramètre gridSize.

note: Tag: para
en: Requires GEOS &gt;= 3.9.0 to use the gridSize parameter.
fr: Nécessite GEOS &gt;= 3.9.0 pour utiliser le paramètre gridSize.

note: Tag: para
en: &Z_support; However, the result is computed using XY only. The result Z values are copied, averaged or interpolated.
fr: &Z_support; Cependant, le résultat est calculé en utilisant uniquement XY. Les valeurs Z résultantes sont copiées, moyennées ou interpolées.

note: Tag: para
en: The input linestrings
fr: Les lignes en entrée

note: Tag: para
en: The difference of the two linestrings
fr: La différence entre les deux lignes

note: Tag: para
en: The difference of 2D linestrings.
fr: La différence entre les lignes 2D.

note: Tag: para
en: The difference of 3D points.
fr: La différence entre les points 3D.

note: Tag: refpurpose
en: Computes a geometry representing the shared portion of geometries A and B.
fr: Calcule une géométrie représentant la partie partagée des géométries A et B.

note: Tag: para
en: Returns a geometry representing the point-set intersection of two geometries. In other words, that portion of geometry A and geometry B that is shared between the two geometries.
fr: Renvoie une géométrie représentant l'intersection des points de deux géométries. En d'autres termes, la partie de la géométrie A et de la géométrie B qui est partagée entre les deux géométries.

note: Tag: para
en: If the geometries have no points in common (i.e. are disjoint) then an empty atomic geometry of appropriate type is returned.
fr: Si les géométries n'ont aucun point commun (c'est-à-dire qu'elles sont disjointes), une géométrie atomique vide du type approprié est renvoyée.

note: Tag: para
en: ST_Intersection in conjunction with <xref linkend="ST_Intersects"/> is useful for clipping geometries such as in bounding box, buffer, or region queries where you only require the portion of a geometry that is inside a country or region of interest.
fr: ST_Intersection en conjonction avec <xref linkend="ST_Intersects"/> est utile pour découper les géométries, comme dans les requêtes sur les boîtes de délimitation, les tampons ou les régions, lorsque vous n'avez besoin que de la partie d'une géométrie qui se trouve à l'intérieur d'un pays ou d'une région d'intérêt.

note: Tag: para
en: &geography_transform; It first determines the best SRID that fits the bounding box of the 2 geography objects (if geography objects are within one half zone UTM but not same UTM will pick one of those) (favoring UTM or Lambert Azimuthal Equal Area (LAEA) north/south pole, and falling back on mercator in worst case scenario) and then intersection in that best fit planar spatial ref and retransforms back to WGS84 geography.
fr: &geography_transform; Il détermine d'abord le meilleur SRID qui correspond à la boîte de délimitation des 2 objets géographiques (si les objets géographiques sont dans une demi-zone UTM mais pas le même UTM choisira l'un d'eux) (en favorisant UTM ou Lambert Azimuthal Equal Area (LAEA) pôle nord/sud, et en se rabattant sur mercator dans le pire des cas) et ensuite l'intersection dans ce ref spatial planaire le mieux adapté et retransforme à nouveau à la géographie WGS84.

note: Tag: para
en: This function will drop the M coordinate values if present.
fr: Cette fonction abandonne les valeurs de coordonnées M si elles sont présentes.

note: Tag: para
en: If working with 3D geometries, you may want to use SFGCAL based <xref linkend="ST_3DIntersection"/> which does a proper 3D intersection for 3D geometries. Although this function works with Z-coordinate, it does an averaging of Z-Coordinate.
fr: Si vous travaillez avec des géométries 3D, vous pouvez utiliser la fonction <xref linkend="ST_3DIntersection"/> basée sur SFGCAL qui réalise une intersection 3D correcte pour les géométries 3D. Bien que cette fonction fonctionne avec la coordonnée Z, elle effectue une moyenne de la coordonnée Z.

note: Tag: para
en: Enhanced: 3.1.0 accept a gridSize parameter
fr: Amélioration : 3.1.0 accepte un paramètre gridSize

note: Tag: para
en: Requires GEOS &gt;= 3.9.0 to use the gridSize parameter
fr: Nécessite GEOS &gt;= 3.9.0 pour utiliser le paramètre gridSize

note: Tag: para
en: Changed: 3.0.0 does not depend on SFCGAL.
fr: Modifié : 3.0.0 ne dépend pas de SFCGAL.

note: Tag: para
en: Availability: 1.5 support for geography data type was introduced.
fr: Disponibilité : La version 1.5 a introduit la prise en charge du type de données geography.

note: Tag: para
en: Clip all lines (trails) by country. Here we assume country geom are POLYGON or MULTIPOLYGONS. NOTE: we are only keeping intersections that result in a LINESTRING or MULTILINESTRING because we don't care about trails that just share a point. The dump is needed to expand a geometry collection into individual single MULT* parts. The below is fairly generic and will work for polys, etc. by just changing the where clause.
fr: Découper toutes les lignes (pistes) par pays. Nous supposons ici que les géométries des pays sont des POLYGONES ou des MULTIPOLYGONES. NOTE : nous ne gardons que les intersections qui résultent en un LINESTRING ou MULTILINESTRING car nous ne nous soucions pas des tracés qui partagent juste un point. Le dump est nécessaire pour étendre une collection géométrique en parties individuelles MULT*. La méthode ci-dessous est assez générique et fonctionnera pour les polys, etc. en changeant simplement la clause where.

note: Tag: para
en: For polys e.g. polygon landmarks, you can also use the sometimes faster hack that buffering anything by 0.0 except a polygon results in an empty geometry collection. (So a geometry collection containing polys, lines and points buffered by 0.0 would only leave the polygons and dissolve the collection shell.)
fr: Pour les polys, par exemple les repères polygonaux, vous pouvez également utiliser la méthode parfois plus rapide qui consiste à mettre en mémoire tampon tout ce qui a une valeur de 0,0, à l'exception d'un polygone, afin d'obtenir une collection géométrique vide. (Ainsi, une collection géométrique contenant des polygones, des lignes et des points mis en mémoire tampon par 0.0 ne laisserait que les polygones et dissoudrait l'enveloppe de la collection.)

note: Tag: title
en: Examples: 2.5Dish
fr: Exemples : 2.5Dish

note: Tag: para
en: Note this is not a true intersection, compare to the same example using <xref linkend="ST_3DIntersection"/>.
fr: Notez qu'il ne s'agit pas d'une véritable intersection, comparez avec le même exemple en utilisant <xref linkend="ST_3DIntersection"/>.

note: Tag: refpurpose
en: Aggregate function which unions geometries in a memory-efficent but slower way
fr: Fonction d'agrégation qui fusionne les géométries d'une manière efficace sur le plan de la mémoire mais plus lente

note: Tag: para
en: An aggregate function that unions the input geometries, merging them to produce a result geometry with no overlaps. The output may be a single geometry, a MultiGeometry, or a Geometry Collection.
fr: Une fonction d'agrégation qui fusionne les géométries en entrée, en les fusionnant pour produire une géométrie de résultat sans chevauchement. Le résultat peut être une géométrie unique, une MultiGéométrie ou une Collection de Géométries.

note: Tag: para
en: Produces the same result as <xref linkend="ST_Union"/>, but uses less memory and more processor time. This aggregate function works by unioning the geometries incrementally, as opposed to the ST_Union aggregate which first accumulates an array and then unions the contents using a fast algorithm.
fr: Produit le même résultat que <xref linkend="ST_Union"/>, mais utilise moins de mémoire et plus de temps processeur. Cette fonction d'agrégation fonctionne par l'union des géométries de manière incrémentale, contrairement à l'agrégation ST_Union qui accumule d'abord un tableau et en unit ensuite le contenu à l'aide d'un algorithme rapide.

note: Tag: refpurpose
en: Nodes a collection of lines.
fr: Nœuds d'une collection de lignes.

note: Tag: para
en: Returns a (Multi)LineString representing the fully noded version of a collection of linestrings. The noding preserves all of the input nodes, and introduces the least possible number of new nodes. The resulting linework is dissolved (duplicate lines are removed).
fr: Renvoie une (Multi)LineString représentant la version entièrement "nodée" d'une collection de lignes. Le "noding" préserve tous les nœuds d'entrée et introduit le plus petit nombre possible de nouveaux nœuds. La ligne résultante est dissoute (les lignes en double sont supprimées).

note: Tag: para
en: This is a good way to create fully-noded linework suitable for use as input to <xref linkend="ST_Polygonize"/>.
fr: Il s'agit d'un bon moyen de créer des lignes entièrement "nodées" pouvant être utilisées dans <xref linkend="ST_Polygonize"/>.

note: Tag: para
en: can also be used to node and dissolve linework. It provides an option to specify a gridSize, which can provide simpler and more robust output. See also <xref linkend="ST_Union"/> for an aggregate variant.
fr: peut également être utilisé pour créer des nœuds et dissoudre des lignes. Il est possible de spécifier une taille de grille, ce qui permet d'obtenir des résultats plus simples et plus robustes. Voir aussi <xref linkend="ST_Union"/> pour une variante agrégée.

note: Tag: para
en: Changed: 2.4.0 this function uses GEOSNode internally instead of GEOSUnaryUnion. This may cause the resulting linestrings to have a different order and direction compared to PostGIS &lt; 2.4.
fr: Modifié : 2.4.0 cette fonction utilise GEOSNode en interne au lieu de GEOSUnaryUnion. Cela peut entraîner un ordre et une direction différents des lignes résultantes par rapport à PostGIS &lt; 2.4.

note: Tag: para
en: Noding a 3D LineString which self-intersects
fr: "Noding" d'une LineString 3D qui s'auto-intersecte

note: Tag: para
en: Noding two LineStrings which share common linework. Note that the result linework is dissolved.
fr: "Noding" de deux lignes qui partagent une structure linéaire commune. Notez que la ligne de résultat est dissoute.

note: Tag: refpurpose
en: Returns a collection of geometries created by splitting a geometry by another geometry.
fr: Renvoie une collection de géométries créées en divisant une géométrie par une autre géométrie.

note: Tag: para
en: The function supports splitting a LineString by a (Multi)Point, (Multi)LineString or (Multi)Polygon boundary, or a (Multi)Polygon by a LineString. When a (Multi)Polygon is used as as the blade, its linear components (the boundary) are used for splitting the input. The result geometry is always a collection.
fr: Cette fonction permet de diviser une ligne par un (Multi)Point, une (Multi)Ligne ou un (Multi)Polygone, ou un (Multi)Polygone par une ligne. Lorsqu'un (Multi)Polygone est utilisé, ses composantes linéaires (la frontière) sont utilisées pour diviser l'entrée. La géométrie résultante est toujours une collection.

note: Tag: para
en: This function is in a sense the opposite of <xref linkend="ST_Union"/>. Applying ST_Union to the returned collection should theoretically yield the original geometry (although due to numerical rounding this may not be exactly the case).
fr: Cette fonction est en quelque sorte l'inverse de <xref linkend="ST_Union"/>. L'application de ST_Union à la collection retournée devrait théoriquement donner la géométrie originale (bien qu'en raison de l'arrondi numérique, cela puisse ne pas être exactement le cas).

note: Tag: para
en: If the the input and blade do not intersect due to numerical precision issues, the input may not be split as expected. To avoid this situation it may be necessary to snap the input to the blade first, using <xref linkend="ST_Snap"/> with a small tolerance.
fr: Si l'entrée et la "lame" ne se croisent pas en raison de problèmes de précision numérique, l'entrée peut ne pas être divisée comme prévu. Pour éviter cette situation, il peut être nécessaire d'accrocher d'abord l'entrée à la "lame", en utilisant <xref linkend="ST_Snap"/> avec une petite tolérance.

note: Tag: para
en: Availability: 2.0.0 requires GEOS
fr: Disponibilité : 2.0.0 nécessite GEOS

note: Tag: para
en: Enhanced: 2.2.0 support for splitting a line by a multiline, a multipoint or (multi)polygon boundary was introduced.
fr: Amélioration : la version 2.2.0 prend en charge la division d'une ligne par une limite multiligne, multipoint ou (multi)polygone.

note: Tag: para
en: Enhanced: 2.5.0 support for splitting a polygon by a multiline was introduced.
fr: Amélioration : la prise en charge de la division d'un polygone par une ligne multiple a été introduite dans la version 2.5.0.

note: Tag: para
en: Split a Polygon by a Line.
fr: Diviser un polygone par une ligne.

note: Tag: para
en: Before Split
fr: Avant la division

note: Tag: para
en: After split
fr: Après la division

note: Tag: para
en: Split a MultiLineString by a Point, where the point lies exactly on both LineStrings elements.
fr: Divise une MultiLineString par un point, où le point se trouve exactement sur les deux éléments de la LineString.

note: Tag: para
en: Split a LineString by a Point, where the point does not lie exactly on the line. Shows using <xref linkend="ST_Snap"/> to snap the line to the point to allow it to be split.
fr: Diviser une ligne par un point, lorsque le point ne se trouve pas exactement sur la ligne. Montre l'utilisation de <xref linkend="ST_Snap"/> pour accrocher la ligne au point afin de permettre son découpage.

note: Tag: refpurpose
en: Computes a rectilinear subdivision of a geometry.
fr: Calcule une subdivision rectiligne d'une géométrie.

note: Tag: para
en: Returns a set of geometries that are the result of dividing <varname>geom</varname> into parts using rectilinear lines, with each part containing no more than <code>max_vertices</code>.
fr: Renvoie un ensemble de géométries résultant de la division de <varname>geom</varname> en parties à l'aide de lignes rectilignes, chaque partie ne contenant pas plus de <code>max_vertices</code>.

note: Tag: para
en: <code>max_vertices</code> must be 5 or more, as 5 points are needed to represent a closed box. <code>gridSize</code> can be specified to have clipping work in fixed-precision space (requires GEOS-3.9.0+).
fr: <code>max_vertices</code> doit être égal ou supérieur à 5, car 5 points sont nécessaires pour représenter une boîte fermée. <code>gridSize</code> peut être spécifié pour que la subdivision fonctionne dans un espace de précision fixe (nécessite GEOS-3.9.0+).

note: Tag: para
en: Point-in-polygon and other spatial operations are normally faster for indexed subdivided datasets. Since the bounding boxes for the parts usually cover a smaller area than the original geometry bbox, index queries produce fewer "hit" cases. The "hit" cases are faster because the spatial operations executed by the index recheck process fewer points.
fr: Les opérations "point dans polygone" et autres opérations spatiales sont normalement plus rapides pour les ensembles de données subdivisés et indexés. Étant donné que les boîtes de délimitation des parties couvrent généralement une zone plus petite que la boîte b de la géométrie d'origine, les requêtes d'index produisent moins de cas "hit". Les cas "hit" sont plus rapides car les opérations spatiales exécutées par la revérification de l'index traitent moins de points.

note: Tag: para
en: This is a <link xlink:href="https://www.postgresql.org/docs/current/queries-table-expressions.html#QUERIES-TABLEFUNCTIONS">set-returning function</link> (SRF) that return a set of rows containing single geometry values. It can be used in a SELECT list or a FROM clause to produce a result set with one record for each result geometry.
fr: Il s'agit d'une <link xlink:href="https://www.postgresql.org/docs/current/queries-table-expressions.html#QUERIES-TABLEFUNCTIONS">fonction de retour d'ensemble</link> (SRF) qui renvoie un ensemble de lignes contenant des valeurs de géométrie uniques. Elle peut être utilisée dans une liste SELECT ou une clause FROM pour produire un ensemble de résultats avec un enregistrement pour chaque géométrie de résultat.

note: Tag: para
en: Enhanced: 2.5.0 reuses existing points on polygon split, vertex count is lowered from 8 to 5.
fr: Amélioration : 2.5.0 réutilise les points existants lors de la division d'un polygone, le nombre de vertex est réduit de 8 à 5.

note: Tag: para
en: <emphasis role="bold">Example:</emphasis> Subdivide a polygon into parts with no more than 10 vertices, and assign each part a unique id.
fr: <emphasis role="bold">Exemple:</emphasis> Subdivisez un polygone en parties ne comportant pas plus de 10 sommets et attribuez à chaque partie un identifiant unique.

note: Tag: para
en: Subdivided to maximum 10 vertices
fr: Subdivisé en un maximum de 10 sommets

note: Tag: para
en: <emphasis role="bold">Example:</emphasis> Densify a long geography line using ST_Segmentize(geography, distance), and use ST_Subdivide to split the resulting line into sublines of 8 vertices.
fr: <emphasis role="bold">Exemple:</emphasis> Densifier une longue ligne de type geography en utilisant ST_Segmentize(geography, distance), et utiliser ST_Subdivide pour diviser la ligne résultante en sous-lignes de 8 sommets.

note: Tag: para
en: The densified and split lines.
fr: Les lignes densifiées et divisées.

note: Tag: para
en: <emphasis role="bold">Example:</emphasis> Subdivide the complex geometries of a table in-place. The original geometry records are deleted from the source table, and new records for each subdivided result geometry are inserted.
fr: <emphasis role="bold">Exemple:</emphasis> Subdiviser les géométries complexes d'une table existante. Les enregistrements de la géométrie d'origine sont supprimés de la table source et de nouveaux enregistrements sont insérés pour chaque géométrie de résultat subdivisée.

note: Tag: para
en: <emphasis role="bold">Example:</emphasis> Create a new table containing subdivided geometries, retaining the key of the original geometry so that the new table can be joined to the source table. Since ST_Subdivide is a set-returning (table) function that returns a set of single-value rows, this syntax automatically produces a table with one row for each result part.
fr: <emphasis role="bold">Exemple:</emphasis> Créer une nouvelle table contenant les géométries subdivisées, en conservant la clé de la géométrie d'origine afin que la nouvelle table puisse être jointe à la table source. Étant donné que ST_Subdivide est une fonction (tableau) qui renvoie un ensemble de lignes à valeur unique, cette syntaxe produit automatiquement un tableau avec une ligne pour chaque partie du résultat.

note: Tag: refpurpose
en: Computes a geometry representing the portions of geometries A and B that do not intersect.
fr: Calcule une géométrie représentant les parties des géométries A et B qui ne s'intersectent pas.

note: Tag: para
en: Returns a geometry representing the portions of geonetries A and B that do not intersect. This is equivalent to <code>ST_Union(A,B) - ST_Intersection(A,B)</code>. It is called a symmetric difference because <code>ST_SymDifference(A,B) = ST_SymDifference(B,A)</code>.
fr: Renvoie une géométrie représentant les parties des géométries A et B qui ne s'intersectent pas. Ceci est équivalent à <code>ST_Union(A,B) - ST_Intersection(A,B)</code>. On parle de différence symétrique car <code>ST_SymDifférence(A,B) = ST_SymDifférence(B,A)</code>.

note: Tag: para
en: The original linestrings shown together
fr: Les lignes originales présentées ensemble

note: Tag: para
en: The symmetric difference of the two linestrings
fr: La différence symétrique des deux lignes

note: Tag: refpurpose
en: Computes the union of the components of a single geometry.
fr: Calcule l'union des composantes d'une seule géométrie.

note: Tag: para
en: A single-input variant of <xref linkend="ST_Union"/>. The input may be a single geometry, a MultiGeometry, or a GeometryCollection. The union is applied to the individual elements of the input.
fr: Variante à entrée unique de <xref linkend="ST_Union"/>. L'entrée peut être une géométrie unique, une MultiGeometry ou une GeometryCollection. L'union est appliquée aux éléments individuels de l'entrée.

note: Tag: para
en: This function can be used to fix MultiPolygons which are invalid due to overlapping components. However, the input components must each be valid. An invalid input component such as a bow-tie polygon may cause an error. For this reason it may be better to use <xref linkend="ST_MakeValid"/>.
fr: Cette fonction peut être utilisée pour corriger les MultiPolygones qui ne sont pas valides en raison du chevauchement de leurs composants. Toutefois, les composants d'entrée doivent tous être valides. Un composant d'entrée non valide, tel qu'un polygone en nœud papillon, peut provoquer une erreur. Pour cette raison, il peut être préférable d'utiliser <xref linkend="ST_MakeValid"/>.

note: Tag: para
en: Another use of this function is to node and dissolve a collection of linestrings which cross or overlap to make them <link linkend="Simple_Geometry">simple</link>. (<xref linkend="ST_Node"/> also does this, but it does not provide the <code>gridSize</code> option.)
fr: Une autre utilisation de cette fonction est de nouer et de dissoudre une collection de lignes qui se croisent ou se chevauchent pour les rendre <link linkend="Simple_Geometry">simple</link>. (<xref linkend="ST_Node"/> fait également cela, mais ne fournit pas l'option <code>gridSize</code>.)

note: Tag: para
en: It is possible to combine ST_UnaryUnion with <xref linkend="ST_Collect"/> to fine-tune how many geometries are be unioned at once. This allows trading off between memory usage and compute time, striking a balance between ST_Union and <xref linkend="ST_MemUnion"/>.
fr: Il est possible de combiner ST_UnaryUnion avec <xref linkend="ST_Collect"/> pour affiner le nombre de géométries à unir en une seule fois. Cela permet de faire un compromis entre l'utilisation de la mémoire et le temps de calcul, en trouvant un équilibre entre ST_Union et <xref linkend="ST_MemUnion"/>.

note: Tag: refpurpose
en: Computes a geometry representing the point-set union of the input geometries.
fr: Calcule une géométrie représentant l'union des ensembles de points des géométries d'entrée.

note: Tag: para
en: Unions the input geometries, merging geometry to produce a result geometry with no overlaps. The output may be an atomic geometry, a MultiGeometry, or a Geometry Collection. Comes in several variants:
fr: Unifie les géométries d'entrée, fusionne les géométries pour produire une géométrie de résultat sans chevauchement. Le résultat peut être une géométrie atomique, une MultiGeometry ou une Geometry Collection. Il existe plusieurs variantes :

note: Tag: para
en: <emphasis role="bold">Two-input variant:</emphasis> returns a geometry that is the union of two input geometries. If either input is NULL, then NULL is returned.
fr: <emphasis role="bold">Variante à deux entrées:</emphasis> renvoie une géométrie qui est l'union de deux géométries d'entrée. Si l'une des entrées est NULL, NULL est renvoyé.

note: Tag: para
en: <emphasis role="bold">Array variant:</emphasis> returns a geometry that is the union of an array of geometries.
fr: <emphasis role="bold">Variante tableau:</emphasis> renvoie une géométrie qui est l'union d'un tableau de géométries.

note: Tag: para
en: <emphasis role="bold">Aggregate variant:</emphasis> returns a geometry that is the union of a rowset of geometries. The ST_Union() function is an "aggregate" function in the terminology of PostgreSQL. That means that it operates on rows of data, in the same way the SUM() and AVG() functions do and like most aggregates, it also ignores NULL geometries.
fr: <emphasis role="bold">Variante agrégée:</emphasis> renvoie une géométrie qui est l'union d'un ensemble de géométries. La fonction ST_Union() est une fonction "agrégée" dans la terminologie de PostgreSQL. Cela signifie qu'elle opère sur des lignes de données, de la même manière que les fonctions SUM() et AVG() et, comme la plupart des agrégats, elle ignore les géométries NULL.

note: Tag: para
en: See <xref linkend="ST_UnaryUnion"/> for a non-aggregate, single-input variant.
fr: Voir <xref linkend="ST_UnaryUnion"/> pour une variante non agrégée, à entrée unique.

note: Tag: para
en: The ST_Union array and set variants use the fast Cascaded Union algorithm described in <link xlink:href="http://blog.cleverelephant.ca/2009/01/must-faster-unions-in-postgis-14.html">http://blog.cleverelephant.ca/2009/01/must-faster-unions-in-postgis-14.html</link>
fr: Le tableau ST_Union et ses variantes utilisent l'algorithme rapide d'union en cascade décrit dans <link xlink:href="http://blog.cleverelephant.ca/2009/01/must-faster-unions-in-postgis-14.html">http://blog.cleverelephant.ca/2009/01/must-faster-unions-in-postgis-14.html</link>

note: Tag: para
en: A <code>gridSize</code> can be specified to work in fixed-precision space. The inputs are snapped to a grid of the given size, and the result vertices are computed on that same grid. (Requires GEOS-3.9.0 or higher)
fr: Un <code>gridSize</code> peut être spécifiée pour travailler dans un espace de précision fixe. Les entrées sont placées sur une grille de la taille donnée, et les sommets du résultat sont calculés sur cette même grille. (Nécessite GEOS-3.9.0 ou plus)

note: Tag: para
en: may sometimes be used in place of ST_Union, if the result is not required to be non-overlapping. ST_Collect is usually faster than ST_Union because it performs no processing on the collected geometries.
fr: peut parfois être utilisé à la place de ST_Union, si le résultat n'a pas besoin d'être non chevauchant. ST_Collect est généralement plus rapide que ST_Union car il n'effectue aucun traitement sur les géométries collectées.

note: Tag: para
en: ST_Union creates MultiLineString and does not sew LineStrings into a single LineString. Use <xref linkend="ST_LineMerge"/> to sew LineStrings.
fr: ST_Union crée une MultiLineString et ne fusionne pas les LineStrings en une seule LineString. Utilisez <xref linkend="ST_LineMerge"/> pour fusionner les LineStrings.

note: Tag: para
en: NOTE: this function was formerly called GeomUnion(), which was renamed from "Union" because UNION is an SQL reserved word.
fr: NOTE : cette fonction s'appelait auparavant GeomUnion(), qui a été renommée "Union" car UNION est un mot réservé de SQL.

note: Tag: para
en: Availability: 1.4.0 - ST_Union was enhanced. ST_Union(geomarray) was introduced and also faster aggregate collection in PostgreSQL.
fr: Disponibilité : 1.4.0 - ST_Union a été amélioré. ST_Union(geomarray) a été introduit ainsi qu'une collecte d'agrégats plus rapide dans PostgreSQL.

note: Tag: para
en: Aggregate version is not explicitly defined in OGC SPEC.
fr: La version agrégée n'est pas explicitement définie dans l'OGC SPEC.

note: Tag: para
en: &sqlmm_compliant; SQL-MM 3: 5.1.19 the z-index (elevation) when polygons are involved.
fr: &sqlmm_compliant; SQL-MM 3 : 5.1.19 l'indice z (élévation) lorsque des polygones sont impliqués.

note: Tag: para
en: Aggregate example
fr: Exemple d'agrégat

note: Tag: para
en: Non-Aggregate example
fr: Exemple non agrégé

note: Tag: para
en: 3D example - sort of supports 3D (and with mixed dimensions!)
fr: Exemple 3D - en quelque sorte des supports 3D (et avec des dimensions mixtes !)

note: Tag: para
en: 3d example not mixing dimensions
fr: Exemple en 3D ne mélangeant pas les dimensions

note: Tag: title
en: Geometry Processing
fr: Traitement des géométries

note: Tag: para
en: These functions compute geometric constructions, or alter geometry size or shape.
fr: Ces fonctions permettent de calculer des constructions géométriques ou de modifier la taille ou la forme d'une géométrie.

note: Tag: refpurpose
en: Computes a geometry covering all points within a given distance from a geometry.
fr: Calcule une géométrie couvrant tous les points situés à une distance donnée d'une géométrie.

note: Tag: para
en: Computes a POLYGON or MULTIPOLYGON that represents all points whose distance from a geometry/geography is less than or equal to a given distance. A negative distance shrinks the geometry rather than expanding it. A negative distance may shrink a polygon completely, in which case POLYGON EMPTY is returned. For points and lines negative distances always return empty results.
fr: Calcule un POLYGONE ou un MULTIPOLYGONE représentant tous les points dont la distance par rapport à une geometry/geography est inférieure ou égale à une distance donnée. Une distance négative rétrécit la géométrie au lieu de l'étendre. Une distance négative peut réduire complètement un polygone, auquel cas POLYGON EMPTY est renvoyé. Pour les points et les lignes, les distances négatives renvoient toujours des résultats vides.

note: Tag: para
en: For geometry, the distance is specified in the units of the Spatial Reference System of the geometry. For geography, the distance is specified in meters.
fr: Pour les types geometry, la distance est spécifiée dans les unités du système de référence spatiale de la géométrie. Pour les types geography, la distance est spécifiée en mètres.

note: Tag: para
en: The optional third parameter controls the buffer accuracy and style. The accuracy of circular arcs in the buffer is specified as the number of line segments used to approximate a quarter circle (default is 8). The buffer style can be specified by providing a list of blank-separated key=value pairs as follows:
fr: Le troisième paramètre facultatif contrôle la précision et le style du tampon. La précision des arcs de cercle dans le tampon est spécifiée en tant que nombre de segments de ligne utilisés pour approximer un quart de cercle (la valeur par défaut est de 8). Le style du tampon peut être spécifié en fournissant une liste de paires clé=valeur séparées par des blancs, comme suit :

note: Tag: para
en: 'quad_segs=#' : number of line segments used to approximate a quarter circle (default is 8).
fr: 'quad_segs=#' : nombre de segments de ligne utilisés pour approximer un quart de cercle (8 par défaut).

note: Tag: para
en: 'endcap=round|flat|square' : endcap style (defaults to "round"). 'butt' is accepted as a synonym for 'flat'.
fr: 'endcap=round|flat|square' : style d'endcap (la valeur par défaut est "round"). 'butt' est accepté comme synonyme de 'flat'.

note: Tag: para
en: 'join=round|mitre|bevel' : join style (defaults to "round"). 'miter' is accepted as a synonym for 'mitre'.
fr: 'join=round|mitre|bevel' : style de jointure (la valeur par défaut est "round"). 'miter' est accepté comme synonyme de 'mitre'.

note: Tag: para
en: 'mitre_limit=#.#' : mitre ratio limit (only affects mitered join style). 'miter_limit' is accepted as a synonym for 'mitre_limit'.
fr: 'mitre_limit=#.#' : limite du rapport d'angle (n'affecte que le style d'assemblage en angle). 'miter_limit' est accepté comme synonyme de 'mitre_limit'.

note: Tag: para
en: 'side=both|left|right' : 'left' or 'right' performs a single-sided buffer on the geometry, with the buffered side relative to the direction of the line. This is only applicable to LINESTRING geometry and does not affect POINT or POLYGON geometries. By default end caps are square.
fr: side=both|left|right' : 'left' ou 'right' effectue une mise en mémoire tampon unilatérale sur la géométrie, le côté mis en mémoire tampon étant relatif à la direction de la ligne. Ceci ne s'applique qu'à la géométrie LINESTRING et n'affecte pas les géométries POINT ou POLYGONE. Par défaut, les embouts sont carrés.

note: Tag: para
en: &geography_transform; It determines a planar spatial reference system that best fits the bounding box of the geography object (trying UTM, Lambert Azimuthal Equal Area (LAEA) North/South pole, and finally Mercator ). The buffer is computed in the planar space, and then transformed back to WGS84. This may not produce the desired behavior if the input object is much larger than a UTM zone or crosses the dateline
fr: &geography_transform; Il détermine un système de référence spatiale planaire qui correspond le mieux à la boîte de délimitation de l'objet géographique (en essayant UTM, le pôle Nord/Sud de Lambert Azimuthal Equal Area (LAEA), et enfin Mercator). Le tampon est calculé dans l'espace planaire, puis retransformé en WGS84. Cela peut ne pas produire le comportement souhaité si l'objet d'entrée est beaucoup plus grand qu'une zone UTM ou s'il traverse la ligne de changement de date

note: Tag: para
en: Buffer output is always a valid polygonal geometry. Buffer can handle invalid inputs, so buffering by distance 0 is sometimes used as a way of repairing invalid polygons. <xref linkend="ST_MakeValid"/> can also be used for this purpose.
fr: La sortie du tampon est toujours une géométrie polygonale valide. La mémoire tampon peut gérer des entrées non valides, de sorte que la mise en mémoire tampon par la distance 0 est parfois utilisée comme moyen de réparer les polygones non valides. <xref linkend="ST_MakeValid"/> peut également être utilisé à cette fin.

note: Tag: para
en: Buffering is sometimes used to perform a within-distance search. For this use case it is more efficient to use <xref linkend="ST_DWithin"/>.
fr: La mise en mémoire tampon est parfois utilisée pour effectuer une recherche à l'intérieur de la distance. Dans ce cas, il est plus efficace d'utiliser <xref linkend="ST_DWithin"/>.

note: Tag: para
en: This function ignores the Z dimension. It always gives a 2D result even when used on a 3D geometry.
fr: Cette fonction ignore la dimension Z. Elle donne toujours un résultat en 2D, même lorsqu'elle est utilisée sur une géométrie en 3D.

note: Tag: para
en: Enhanced: 2.5.0 - ST_Buffer geometry support was enhanced to allow for side buffering specification <code>side=both|left|right</code>.
fr: Amélioration : 2.5.0 - La prise en charge de la géométrie ST_Buffer a été améliorée pour permettre la spécification de la mise en mémoire tampon latérale <code>side=both|left|right</code>.

note: Tag: para
en: Availability: 1.5 - ST_Buffer was enhanced to support different endcaps and join types. These are useful for example to convert road linestrings into polygon roads with flat or square edges instead of rounded edges. Thin wrapper for geography was added.
fr: Disponibilité : 1.5 - ST_Buffer a été amélioré pour prendre en charge différents types de terminaisons et de jointures. Ceux-ci sont utiles, par exemple, pour convertir les lignes de route en routes polygonales avec des bords plats ou carrés au lieu de bords arrondis. Un petit wrapper pour la geography a été ajouté.

note: Tag: para
en: quad_segs=8 (default)
fr: quad_segs=8 (par défaut)

note: Tag: para
en: quad_segs=2 (lame)
fr: quad_segs=2 (faible)

note: Tag: para
en: endcap=round join=round (default)
fr: endcap=round join=round (par défaut)

note: Tag: para
en: join=mitre mitre_limit=5.0 (default mitre limit)
fr: join=mitre mitre_limit=5.0 (limite de mitre par défaut)

note: Tag: para
en: right-hand-winding, polygon boundary side=left
fr: enroulement à droite, limite du polygone side=left

note: Tag: para
en: right-hand-winding, polygon boundary side=right
fr: enroulement à droite, limite du polygone side=right

note: Tag: refpurpose
en: Creates a polygonal geometry formed by the linework of a geometry.
fr: Crée une géométrie polygonale formée par le tracé d'une géométrie.

note: Tag: para
en: Creates an areal geometry formed by the constituent linework of the input geometry. The input can be a LineString, MultiLineString, Polygon, MultiPolygon or a GeometryCollection. The result is a Polygon or MultiPolygon, depending on input. If the input linework does not form polygons, NULL is returned.
fr: Crée une géométrie aréolaire formée par les lignes constitutives de la géométrie d'entrée. L'entrée peut être une LineString, MultiLineString, Polygon, MultiPolygon ou une GeometryCollection. Le résultat est un Polygone ou un MultiPolygone, en fonction de l'entrée. Si la ligne d'entrée ne forme pas de polygone, NULL est renvoyé.

note: Tag: para
en: Unlike <xref linkend="ST_MakePolygon"/>, this function accepts rings formed by multiple lines, and can form any number of polygons.
fr: Contrairement à <xref linkend="ST_MakePolygon"/>, cette fonction accepte les anneaux formés par plusieurs lignes et peut former un nombre quelconque de polygones.

note: Tag: para
en: This function converts inner rings into holes. To turn inner rings into polygons as well, use <xref linkend="ST_Polygonize"/>.
fr: Cette fonction convertit les anneaux intérieurs en trous. Pour transformer les anneaux intérieurs en polygones, utilisez <xref linkend="ST_Polygonize"/>.

note: Tag: para
en: Input linework must be correctly noded for this function to work properly. <xref linkend="ST_Node"/> can be used to node lines.
fr: Les lignes d'entrée doivent être correctement nouées pour que cette fonction fonctionne correctement. <xref linkend="ST_Node"/> peut être utilisé pour nouer des lignes.

note: Tag: para
en: If the input linework crosses, this function will produce invalid polygons. <xref linkend="ST_MakeValid"/> can be used to ensure the output is valid.
fr: Si le réseau de lignes d'entrée est croisé, cette fonction produira des polygones non valides. <xref linkend="ST_MakeValid"/> peut être utilisé pour s'assurer que la sortie est valide.

note: Tag: para
en: Input lines
fr: Lignes en entrée

note: Tag: para
en: Area result
fr: Résultat de la zone

note: Tag: para
en: Create a donut from two circular polygons
fr: Créer un donut à partir de deux polygones circulaires

note: Tag: para
en: , <xref linkend="ST_MakePolygon"/>, <xref linkend="ST_MakeValid"/>, <xref linkend="ST_Node"/>, <xref linkend="ST_Polygonize"/>, <xref linkend="ST_BdPolyFromText"/>, <xref linkend="ST_BdMPolyFromText"/> (wrappers to this function with standard OGC interface)
fr: , <xref linkend="ST_MakePolygon"/>, <xref linkend="ST_MakeValid"/>, <xref linkend="ST_Node"/>, <xref linkend="ST_Polygonize"/>, <xref linkend="ST_BdPolyFromText"/>, <xref linkend="ST_BdMPolyFromText"/> (wrappers de cette fonction avec l'interface standard de l'OGC)

note: Tag: refpurpose
en: Returns the geometric center of a geometry.
fr: Renvoie le centre géométrique d'une géométrie.

note: Tag: para
en: Computes a point which is the geometric center of mass of a geometry. For [<varname>MULTI</varname>]<varname>POINT</varname>s, the centroid is the arithmetic mean of the input coordinates. For [<varname>MULTI</varname>]<varname>LINESTRING</varname>s, the centroid is computed using the weighted length of each line segment. For [<varname>MULTI</varname>]<varname>POLYGON</varname>s, the centroid is computed in terms of area. If an empty geometry is supplied, an empty <varname>GEOMETRYCOLLECTION</varname> is returned. If <varname>NULL</varname> is supplied, <varname>NULL</varname> is returned. If <varname>CIRCULARSTRING</varname> or <varname>COMPOUNDCURVE</varname> are supplied, they are converted to linestring with CurveToLine first, then same than for <varname>LINESTRING</varname>
fr: Calcule un point qui est le centre de masse géométrique d'une géométrie. Pour [<varname>MULTI</varname>]<varname>POINT</varname>s, le centroïde est la moyenne arithmétique des coordonnées entrées. Pour les [<varname>MULTI</varname>]<varname>LINESTRING</varname>s, le centroïde est calculé en utilisant la longueur pondérée de chaque segment de ligne. Pour les [<varname>MULTI</varname>]<varname>POLYGON</varname>s, le centroïde est calculé en termes de surface. Si une géométrie vide est fournie, une <varname>GEOMETRYCOLLECTION</varname> vide est renvoyée. Si <varname>NULL</varname> est fourni, <varname>NULL</varname> est renvoyé. Si <varname>CIRCULARSTRING</varname> ou <varname>COMPOUNDCURVE</varname> sont fournis, ils sont convertis en linestring avec CurveToLine d'abord, puis de la même manière que pour <varname>LINESTRING</varname>

note: Tag: para
en: For mixed-dimension input, the result is equal to the centroid of the component Geometries of highest dimension (since the lower-dimension geometries contribute zero "weight" to the centroid).
fr: Pour les entrées de dimensions mixtes, le résultat est égal au centroïde de la composante Géométries de la dimension la plus élevée (puisque les géométries de dimension inférieure n'apportent aucun "poids" au centroïde).

note: Tag: para
en: Note that for polygonal geometries the centroid does not necessarily lie in the interior of the polygon. For example, see the diagram below of the centroid of a C-shaped polygon. To construct a point guaranteed to lie in the interior of a polygon use <xref linkend="ST_PointOnSurface"/>.
fr: Notez que pour les géométries polygonales, le centroïde n'est pas nécessairement situé à l'intérieur du polygone. Par exemple, voir le diagramme ci-dessous du centroïde d'un polygone en forme de C. Pour construire un point garanti à l'intérieur d'un polygone, utilisez <xref linkend="ST_PointOnSurface"/>.

note: Tag: para
en: New in 2.3.0 : supports <varname>CIRCULARSTRING</varname> and <varname>COMPOUNDCURVE</varname> (using CurveToLine)
fr: Nouveau dans la version 2.3.0 : prend en charge <varname>CIRCULARSTRING</varname> et <varname>COMPOUNDCURVE</varname> (en utilisant CurveToLine)

note: Tag: para
en: Availability: 2.4.0 support for geography was introduced.
fr: Disponibilité : la prise en charge du type geography a été introduite dans la version 2.4.0.

note: Tag: para
en: In the following illustrations the red dot is the centroid of the source geometry.
fr: Dans les illustrations suivantes, le point rouge est le centroïde de la géométrie de la source.

note: Tag: para
en: Centroid of a <varname>MULTIPOINT</varname>
fr: Centroïde d'un <varname>MULTIPOINT</varname>

note: Tag: para
en: Centroid of a <varname>LINESTRING</varname>
fr: Centroïde d'une <varname>LINESTRING</varname>

note: Tag: para
en: Centroid of a <varname>POLYGON</varname>
fr: Centroïde d'un <varname>POLYGON</varname>

note: Tag: para
en: Centroid of a <varname>GEOMETRYCOLLECTION</varname>
fr: Centroïde d'une <varname>GEOMETRYCOLLECTION</varname>

note: Tag: refpurpose
en: Returns a smoothed version of a geometry, using the Chaikin algorithm
fr: Renvoie une version lissée d'une géométrie, en utilisant l'algorithme Chaikin

note: Tag: para
en: Smoothes a linear or polygonal geometry using <link xlink:href="http://www.idav.ucdavis.edu/education/CAGDNotes/Chaikins-Algorithm/Chaikins-Algorithm.html">Chaikin's algorithm</link>. The degree of smoothing is controlled by the <varname>nIterations</varname> parameter. On each iteration, each interior vertex is replaced by two vertices located at 1/4 of the length of the line segments before and after the vertex. A reasonable degree of smoothing is provided by 3 iterations; the maximum is limited to 5.
fr: Lisse une géométrie linéaire ou polygonale en utilisant <link xlink:href="http://www.idav.ucdavis.edu/education/CAGDNotes/Chaikins-Algorithm/Chaikins-Algorithm.html">Chaikin's algorithm</link>. Le degré de lissage est contrôlé par le paramètre <varname>nIterations</varname>. À chaque itération, chaque sommet intérieur est remplacé par deux sommets situés à 1/4 de la longueur des segments de ligne précédant et suivant le sommet. Un degré raisonnable de lissage est fourni par 3 itérations ; le maximum est limité à 5.

note: Tag: para
en: If <varname>preserveEndPoints</varname> is true, the endpoints of Polygon rings are not smoothed. The endpoints of LineStrings are always preserved.
fr: Si <varname>preserveEndPoints</varname> est égal à true, les extrémités des anneaux de polygone ne sont pas lissées. Les extrémités des lignes sont toujours préservées.

note: Tag: para
en: The number of vertices doubles with each iteration, so the result geometry may have many more points than the input. To reduce the number of points use a simplification function on the result (see <xref linkend="ST_Simplify"/>, <xref linkend="ST_SimplifyPreserveTopology"/> and <xref linkend="ST_SimplifyVW"/>).
fr: Le nombre de sommets double à chaque itération, de sorte que la géométrie résultante peut comporter beaucoup plus de points que la géométrie d'entrée. Pour réduire le nombre de points, utilisez une fonction de simplification sur le résultat (voir <xref linkend="ST_Simplify"/>, <xref linkend="ST_SimplifyPreserveTopology"/> et <xref linkend="ST_SimplifyVW"/>).

note: Tag: para
en: The result has interpolated values for the Z and M dimensions when present.
fr: Le résultat comporte des valeurs interpolées pour les dimensions Z et M lorsqu'elles sont présentes.

note: Tag: para
en: Smoothing a triangle:
fr: Lissage d'un triangle :

note: Tag: para
en: Smoothing a Polygon using 1, 2 and 3 iterations:
fr: Lissage d'un polygone en utilisant 1, 2 et 3 itérations :

note: Tag: para
en: Smoothing a LineString using 1, 2 and 3 iterations:
fr: Lissage d'une LineString en utilisant 1, 2 et 3 itérations :

note: Tag: refpurpose
en: Computes a possibly concave geometry that contains all input geometry vertices
fr: Calcule une géométrie éventuellement concave qui contient tous les sommets de la géométrie d'entrée

note: Tag: para
en: A concave hull is a (usually) concave geometry which contains the input, and whose vertices are a subset of the input vertices. In the general case the concave hull is a Polygon. The concave hull of two or more collinear points is a two-point LineString. The concave hull of one or more identical points is a Point. The polygon will not contain holes unless the optional <varname>param_allow_holes</varname> argument is specified as true.
fr: Une enveloppe concave est une géométrie (généralement) concave qui contient l'entrée et dont les sommets sont un sous-ensemble des sommets de l'entrée. Dans le cas général, l'enveloppe concave est un polygone. L'enveloppe concave de deux ou plusieurs points colinéaires est une ligne à deux points. L'enveloppe concave d'un ou plusieurs points identiques est un Point. Le polygone ne contiendra pas de trous à moins que l'argument facultatif <varname>param_allow_holes</varname> ne soit spécifié comme vrai.

note: Tag: para
en: One can think of a concave hull as "shrink-wrapping" a set of points. This is different to the <link linkend="ST_ConvexHull">convex hull</link>, which is more like wrapping a rubber band around the points. A concave hull generally has a smaller area and represents a more natural boundary for the input points.
fr: On peut considérer qu'une enveloppe concave "rétrécit" un ensemble de points. Cela diffère de la <link linkend="ST_ConvexHull">convex hull</link>, qui revient à enrouler un élastique autour des points. Une enveloppe concave a généralement une surface plus petite et représente une limite plus naturelle pour les points d'entrée.

note: Tag: para
en: The <varname>param_pctconvex</varname> controls the concaveness of the computed hull. A value of 1 produces the convex hull. Values between 1 and 0 produce hulls of increasing concaveness. A value of 0 produces a hull with maximum concaveness (but still a single polygon). Choosing a suitable value depends on the nature of the input data, but often values between 0.3 and 0.1 produce reasonable results.
fr: La <varname>param_pctconvex</varname> contrôle la concavité de l'enveloppe calculée. Une valeur de 1 produit une enveloppe convexe. Les valeurs comprises entre 1 et 0 produisent des enveloppes de concavité croissante. Une valeur de 0 produit une enveloppe avec une concavité maximale (mais toujours un polygone unique). Le choix d'une valeur appropriée dépend de la nature des données d'entrée, mais des valeurs comprises entre 0,3 et 0,1 produisent souvent des résultats raisonnables.

note: Tag: para
en: Technically, the <varname>param_pctconvex</varname> determines a length as a fraction of the difference between the longest and shortest edges in the Delaunay Triangulation of the input points. Edges longer than this length are "eroded" from the triangulation. The triangles remaining form the concave hull.
fr: Techniquement, la <varname>param_pctconvex</varname> détermine une longueur comme une fraction de la différence entre les arêtes les plus longues et les plus courtes dans la triangulation de Delaunay des points d'entrée. Les arêtes plus longues que cette longueur sont "érodées" de la triangulation. Les triangles restants forment l'enveloppe concave.

note: Tag: para
en: For point and linear inputs, the hull will enclose all the points of the inputs. For polygonal inputs, the hull will enclose all the points of the input <emphasis>and also</emphasis> all the areas covered by the input. If you want a point-wise hull of a polygonal input, convert it to points first using <xref linkend="ST_Points"/>.
fr: Pour les entrées ponctuelles et linéaires, l'enveloppe englobe tous les points de l'entrée. Pour les entrées polygonales, l'enveloppe englobera tous les points de l'entrée <emphasis>et aussi</emphasis> toutes les zones couvertes par l'entrée. Si vous souhaitez obtenir une enveloppe ponctuelle d'une entrée polygonale, convertissez-la d'abord en points à l'aide de <xref linkend="ST_Points"/>.

note: Tag: para
en: This is not an aggregate function. To compute the concave hull of a set of geometries use <xref linkend="ST_Collect"/> (e.g. <code>ST_ConcaveHull( ST_Collect( geom ), 0.80)</code>.
fr: Il ne s'agit pas d'une fonction d'agrégation. Pour calculer l'enveloppe concave d'un ensemble de géométries, utilisez <xref linkend="ST_Collect"/> (par exemple <code>ST_ConcaveHull( ST_Collect( geom ), 0.80)</code>.

note: Tag: para
en: Enhanced: 3.3.0, GEOS native implementation enabled for GEOS 3.11+
fr: Amélioré : 3.3.0, implémentation native de GEOS activée pour GEOS 3.11+

note: Tag: para
en: Concave Hull of a MultiPoint
fr: Enveloppe concave d'un MultiPoint

note: Tag: para
en: Concave Hull of a MultiPoint, allowing holes
fr: Enveloppe concave d'un MultiPoint, autorisant des trous

note: Tag: para
en: Comparing a concave hull of a Polygon to the concave hull of the constituent points. The hull respects the boundary of the polygon, whereas the points-based hull does not.
fr: Comparaison entre l'enveloppe concave d'un polygone et l'enveloppe concave des points qui le composent. L'enveloppe respecte les limites du polygone, ce qui n'est pas le cas de l'enveloppe basée sur les points.

note: Tag: para
en: Using with ST_Collect to compute the concave hull of a geometry set.
fr: Utilisation avec ST_Collect pour calculer l'enveloppe concave d'un ensemble géométrique.

note: Tag: refpurpose
en: Computes the convex hull of a geometry.
fr: Calcule l'enveloppe convexe d'une géométrie.

note: Tag: para
en: Computes the convex hull of a geometry. The convex hull is the smallest convex geometry that encloses all geometries in the input.
fr: Calcule l'enveloppe convexe d'une géométrie. L'enveloppe convexe est la plus petite géométrie convexe qui englobe toutes les géométries de l'entrée.

note: Tag: para
en: One can think of the convex hull as the geometry obtained by wrapping an rubber band around a set of geometries. This is different from a <link linkend="ST_ConcaveHull">concave hull</link> which is analogous to "shrink-wrapping" the geometries. A convex hull is often used to determine an affected area based on a set of point observations.
fr: On peut considérer l'enveloppe convexe comme la géométrie obtenue en enroulant un élastique autour d'un ensemble de géométries. Ceci est différent d'une <link linkend="ST_ConcaveHull">concave hull</link> qui est analogue à un "rétrécissement" des géométries. Une enveloppe convexe est souvent utilisée pour déterminer une zone affectée sur la base d'un ensemble d'observations ponctuelles.

note: Tag: para
en: In the general case the convex hull is a Polygon. The convex hull of two or more collinear points is a two-point LineString. The convex hull of one or more identical points is a Point.
fr: Dans le cas général, l'enveloppe convexe est un polygone. L'enveloppe convexe de deux ou plusieurs points colinéaires est une LineString à deux points. L'enveloppe convexe d'un ou plusieurs points identiques est un Point.

note: Tag: para
en: This is not an aggregate function. To compute the convex hull of a set of geometries, use <xref linkend="ST_Collect"/> to aggregate them into a geometry collection (e.g. <code>ST_ConvexHull(ST_Collect(geom))</code>.
fr: Il ne s'agit pas d'une fonction d'agrégation. Pour calculer l'enveloppe convexe d'un ensemble de géométries, utilisez <xref linkend="ST_Collect"/> pour les agréger dans une collection de géométries (par exemple <code>ST_ConvexHull(ST_Collect(geom))</code>.

note: Tag: para
en: Convex Hull of a MultiLinestring and a MultiPoint
fr: Enveloppe convexe d'une MultiLinestring et d'un MultiPoint

note: Tag: para
en: Using with ST_Collect to compute the convex hulls of geometry sets.
fr: Utilisation avec ST_Collect pour calculer les enveloppes convexes des ensembles géométriques.

note: Tag: refpurpose
en: Returns the Delaunay triangulation of the vertices of a geometry.
fr: Renvoie la triangulation de Delaunay des sommets d'une géométrie.

note: Tag: para
en: Computes the <link xlink:href="http://en.wikipedia.org/wiki/Delaunay_triangulation">Delaunay triangulation</link> of the vertices of the input geometry. The optional <varname>tolerance</varname> can be used to snap nearby input vertices together, which improves robustness in some situations. The result geometry is bounded by the convex hull of the input vertices. The result geometry representation is determined by the <varname>flags</varname> code:
fr: Calcule la <link xlink:href="http://en.wikipedia.org/wiki/Delaunay_triangulation"> Delaunay triangulation</link> des sommets de la géométrie d'entrée. La <varname>tolerance</varname> optionnelle peut être utilisée pour regrouper les sommets proches, ce qui améliore la robustesse dans certaines situations. La géométrie résultante est délimitée par l'enveloppe convexe des sommets de la géométrie d'entrée. La représentation de la géométrie résultante est déterminée par le code <varname>flags</varname> :

note: Tag: para
en: <code>0</code> - a GEOMETRYCOLLECTION of triangular POLYGONs (default)
fr: <code>0</code> - une collection de géométries de POLYGONES triangulaires (par défaut)

note: Tag: para
en: <code>1</code> - a MULTILINESTRING of the edges of the triangulation
fr: <code>1</code> - une MULTILINESTRING des arêtes de la triangulation

note: Tag: para
en: <code>2</code> - A TIN of the triangulation
fr: <code>2</code> - Un TIN de la triangulation

note: Tag: para
en: Original polygons
fr: Polygones d'origine

note: Tag: para
en: ST_DelaunayTriangles of 2 polygons: delaunay triangle polygons each triangle themed in different color
fr: ST_DelaunayTriangles de 2 polygones : polygones de triangle delaunay, chaque triangle est thématisé dans une couleur différente

note: Tag: para
en: -- delaunay triangles as multilinestring
fr: -- triangles de delaunay en tant que multilignes

note: Tag: para
en: -- delaunay triangles of 45 points as 55 triangle polygons
fr: -- triangles de delaunay de 45 points sous forme de 55 polygones triangulaires

note: Tag: para
en: Example using vertices with Z values.
fr: Exemple utilisant des sommets avec des valeurs Z.

note: Tag: refpurpose
en: Removes vertices based on their M value
fr: Supprime les vertices en fonction de leur valeur M

note: Tag: para
en: Filters out vertex points based on their M-value. Returns a geometry with only vertex points that have a M-value larger or equal to the min value and smaller or equal to the max value. If max-value argument is left out only min value is considered. If fourth argument is left out the m-value will not be in the resulting geometry. If resulting geometry have too few vertex points left for its geometry type an empty geometry will be returned. In a geometry collection geometries without enough points will just be left out silently.
fr: Filtre les points de sommet en fonction de leur valeur M. Renvoie une géométrie contenant uniquement les points de sommet dont la valeur M est supérieure ou égale à la valeur min et inférieure ou égale à la valeur max. Si l'argument max-value est omis, seule la valeur min est prise en compte. Si le quatrième argument est omis, la valeur m ne figurera pas dans la géométrie résultante. Si la géométrie résultante a trop peu de points de vertex pour son type de géométrie, une géométrie vide sera renvoyée. Dans une collection de géométries, les géométries qui n'ont pas assez de points seront simplement éliminées silencieusement.

note: Tag: para
en: This function is mainly intended to be used in conjunction with ST_SetEffectiveArea. ST_EffectiveArea sets the effective area of a vertex in its m-value. With ST_FilterByM it then is possible to get a simplified version of the geometry without any calculations, just by filtering
fr: Cette fonction est principalement destinée à être utilisée en conjonction avec ST_SetEffectiveArea. ST_EffectiveArea définit la surface effective d'un sommet dans sa valeur m. Avec ST_FilterByM, il est possible d'obtenir une version simplifiée de la géométrie sans aucun calcul, simplement en filtrant

note: Tag: para
en: There is a difference in what ST_SimplifyVW returns when not enough points meet the criteria compared to ST_FilterByM. ST_SimplifyVW returns the geometry with enough points while ST_FilterByM returns an empty geometry
fr: Il existe une différence entre ST_SimplifyVW et ST_FilterByM en ce qui concerne la géométrie renvoyée lorsque le nombre de points répondant aux critères n'est pas suffisant. ST_SimplifyVW renvoie la géométrie avec suffisamment de points alors que ST_FilterByM renvoie une géométrie vide

note: Tag: para
en: Note that the returned geometry might be invalid
fr: Notez que la géométrie renvoyée peut être invalide

note: Tag: para
en: This function returns all dimensions, including the Z and M values
fr: Cette fonction renvoie toutes les dimensions, y compris les valeurs Z et M

note: Tag: para
en: A linestring is filtered
fr: Une ligne est filtrée

note: Tag: refpurpose
en: Generates a multipoint of random points contained in a Polygon or MultiPolygon.
fr: Génère un multipoint de points aléatoires contenus dans un polygone ou un multipolygone.

note: Tag: para
en: ST_GeneratePoints generates a multipoint consisting of a given number of pseudo-random points which lie within the input area. The optional <varname>seed</varname> is used to regenerate a deterministic sequence of points, and must be greater than zero.
fr: ST_GeneratePoints génère un multipoint composé d'un nombre donné de points pseudo-aléatoires situés dans la zone d'entrée. Le paramètre facultatif <varname>seed</varname> est utilisé pour régénérer une séquence déterministe de points et doit être supérieur à zéro.

note: Tag: para
en: Enhanced: 3.0.0, added seed parameter
fr: Amélioration : 3.0.0, ajout du paramètre seed

note: Tag: para
en: Generated a multipoint consisting of 12 Points overlaid on top of original polygon using a random seed value 1996
fr: Génération d'un multipoint composé de 12 points superposés au polygone d'origine en utilisant une valeur de départ aléatoire 1996

note: Tag: para
en: Given a table of polygons s, return 12 individual points per polygon. Results will be different each time you run.
fr: Etant donné un tableau de polygones s, retourner 12 points individuels par polygone. Les résultats seront différents à chaque exécution.

note: Tag: refpurpose
en: Returns the geometric median of a MultiPoint.
fr: Renvoie la médiane géométrique d'un MultiPoint.

note: Tag: para
en: Computes the approximate geometric median of a MultiPoint geometry using the Weiszfeld algorithm. The geometric median is the point minimizing the sum of distances to the input points. It provides a centrality measure that is less sensitive to outlier points than the centroid (center of mass).
fr: Calcule la médiane géométrique approximative d'une géométrie MultiPoint à l'aide de l'algorithme de Weiszfeld. La médiane géométrique est le point qui minimise la somme des distances aux points d'entrée. Elle fournit une mesure de centralité moins sensible aux points aberrants que le centroïde (centre de masse).

note: Tag: para
en: The algorithm iterates until the distance change between successive iterations is less than the supplied <varname>tolerance</varname> parameter. If this condition has not been met after <varname>max_iterations</varname> iterations, the function produces an error and exits, unless <varname>fail_if_not_converged</varname> is set to <code>false</code> (the default).
fr: L'algorithme itère jusqu'à ce que la variation de la distance entre les itérations successives soit inférieure au paramètre <varname>tolerance</varname> fourni. Si cette condition n'est pas remplie après <varname>max_iterations</varname> itérations, la fonction produit une erreur et se termine, à moins que <varname>fail_fif_not_converged</varname> ne soit fixé à <code>false</code> (par défaut).

note: Tag: para
en: If a <varname>tolerance</varname> argument is not provided, the tolerance value is calculated based on the extent of the input geometry.
fr: Si l'argument <varname>tolerance</varname> n'est pas fourni, la valeur de la tolérance est calculée sur la base de l'étendue de la géométrie d'entrée.

note: Tag: para
en: If present, the input point M values are interpreted as their relative weights.
fr: Si elle est présente, les valeurs M des points d'entrée sont interprétées comme leurs poids relatifs.

note: Tag: para
en: Enhanced: 2.5.0 Added support for M as weight of points.
fr: Amélioré : 2.5.0 Ajout de la prise en charge de M comme poids des points.

note: Tag: para
en: Comparison of the geometric median (red) and centroid (turquoise) of a MultiPoint.
fr: Comparaison de la médiane géométrique (rouge) et du centroïde (turquoise) d'un MultiPoint.

note: Tag: refpurpose
en: Return the lines formed by sewing together a MultiLineString.
fr: Renvoie les lignes formées par la couture d'une MultiLineString.

note: Tag: para
en: Returns a LineString or MultiLineString formed by joining together the line elements of a MultiLineString. Lines are joined at their endpoints at 2-way intersections. Lines are not joined across intersections of 3-way or greater degree.
fr: Renvoie une LineString ou une MultiLineString formée par l'assemblage des éléments de ligne d'une MultiLineString. Les lignes sont jointes à leurs extrémités aux intersections à 2 voies. Les lignes ne sont pas jointes aux intersections à 3 voies ou plus.

note: Tag: para
en: If <emphasis role="bold">directed</emphasis> is TRUE, then ST_LineMerge will not change point order within LineStrings, so lines with opposite directions will not be merged
fr: Si <emphasis role="bold">directed</emphasis> est TRUE, ST_LineMerge ne modifiera pas l'ordre des points dans les LineStrings, de sorte que les lignes ayant des directions opposées ne seront pas fusionnées

note: Tag: para
en: Only use with MultiLineString/LineStrings. Other geometry types return an empty GeometryCollection
fr: A n'utiliser qu'avec les MultiLineString/LineStrings. Les autres types de géométrie renvoient une GeometryCollection vide

note: Tag: para
en: Enhanced: 3.3.0 accept a directed parameter.
fr: Amélioration : 3.3.0 accepte un paramètre direct.

note: Tag: para
en: Requires GEOS &gt;= 3.11.0 to use the directed parameter.
fr: GEOS &gt;= 3.11.0 est nécessaire pour utiliser le paramètre direct.

note: Tag: para
en: This function strips the M dimension.
fr: Cette fonction supprime la dimension M.

note: Tag: para
en: Merging lines with different orientation.
fr: Fusionner des lignes d'orientation différente.

note: Tag: para
en: Lines are not merged across intersections with degree &gt; 2.
fr: Les lignes ne sont pas fusionnées aux intersections de degré &gt; 2.

note: Tag: para
en: If merging is not possible due to non-touching lines, the original MultiLineString is returned.
fr: Si la fusion n'est pas possible en raison de lignes qui ne se touchent pas, la MultiLineString d'origine est renvoyée.

note: Tag: para
en: Lines with opposite directions are not merged if directed = TRUE.
fr: Les lignes de directions opposées ne sont pas fusionnées si directed = TRUE.

note: Tag: para
en: Example showing Z-dimension handling.
fr: Exemple de traitement de la dimension Z.

note: Tag: refpurpose
en: Computes the largest circle contained within a geometry.
fr: Calcule le plus grand cercle contenu dans une géométrie.

note: Tag: para
en: Finds the largest circle that is contained within a (multi)polygon, or which does not overlap any lines and points. Returns a record with fields:
fr: Trouve le plus grand cercle contenu dans un (multi)polygone, ou qui ne chevauche aucune ligne ni aucun point. Renvoie un enregistrement avec des champs :

note: Tag: para
en: <varname>center</varname> - center point of the circle
fr: <varname>center</varname> - point central du cercle

note: Tag: para
en: <varname>nearest</varname> - a point on the geometry nearest to the center
fr: <varname>nearest</varname> - un point de la géométrie le plus proche du centre

note: Tag: para
en: <varname>radius</varname> - radius of the circle
fr: <varname>radius</varname> - rayon du cercle

note: Tag: para
en: For polygonal inputs, the circle is inscribed within the boundary rings, using the internal rings as boundaries. For linear and point inputs, the circle is inscribed within the convex hull of the input, using the input lines and points as further boundaries.
fr: Pour les entrées polygonales, le cercle est inscrit dans les anneaux de délimitation, en utilisant les anneaux internes comme limites. Pour les entrées linéaires et ponctuelles, le cercle est inscrit dans l'enveloppe convexe de l'entrée, en utilisant les lignes et les points de l'entrée comme autres limites.

note: Tag: para
en: Availability: 3.1.0.
fr: Disponibilité : 3.1.0.

note: Tag: para
en: Requires GEOS &gt;= 3.9.0.
fr: Nécessite GEOS &gt;= 3.9.0.

note: Tag: para
en: Maximum inscribed circle of a polygon. Center, nearest point, and radius are returned.
fr: Cercle inscrit maximal d'un polygone. Le centre, le point le plus proche et le rayon sont renvoyés.

note: Tag: para
en: Maximum inscribed circle of a multi-linestring. Center, nearest point, and radius are returned.
fr: Cercle inscrit maximal d'une multiligne. Le centre, le point le plus proche et le rayon sont renvoyés.

note: Tag: refpurpose
en: Computes the largest circle not overlapping a geometry.
fr: Calcule le plus grand cercle ne recouvrant pas une géométrie.

note: Tag: para
en: Finds the largest circle which does not overlap a set of point and line obstacles. (Polygonal geometries may be included as obstacles, but only their boundary lines are used.) The center of the circle is constrained to lie inside a polygonal boundary, which by default is the convex hull of the input geometry. The circle center is the point in the interior of the boundary which has the farthest distance from the obstacles. The circle itself is provided by the center point and a nearest point lying on an obstacle determining the circle radius.
fr: Trouve le plus grand cercle qui ne chevauche pas un ensemble d'obstacles de points et de lignes. (Les géométries polygonales peuvent être incluses en tant qu'obstacles, mais seules leurs lignes de démarcation sont utilisées). Le centre du cercle est contraint de se situer à l'intérieur d'une limite polygonale, qui par défaut est l'enveloppe convexe de la géométrie d'entrée. Le centre du cercle est le point à l'intérieur de la frontière qui est le plus éloigné des obstacles. Le cercle lui-même est fourni par le point central et un point le plus proche situé sur un obstacle déterminant le rayon du cercle.

note: Tag: para
en: The circle center is determined to a given accuracy specified by a distance tolerance, using an iterative algorithm. If the accuracy distance is not specified a reasonable default is used.
fr: Le centre du cercle est déterminé avec une précision donnée, spécifiée par une tolérance de distance, à l'aide d'un algorithme itératif. Si la distance de précision n'est pas spécifiée, une valeur par défaut raisonnable est utilisée.

note: Tag: para
en: Returns a record with fields:
fr: Renvoie un enregistrement avec des champs :

note: Tag: para
en: To find the largest empty circle in the interior of a polygon, see <xref linkend="ST_MaximumInscribedCircle"/>.
fr: Pour trouver le plus grand cercle vide à l'intérieur d'un polygone, voir <xref linkend="ST_MaximumInscribedCircle"/>.

note: Tag: para
en: Availability: 3.4.0.
fr: Disponibilité : 3.4.0.

note: Tag: para
en: Largest Empty Circle within a set of lines.
fr: Le plus grand cercle vide à l'intérieur d'un ensemble de lignes.

note: Tag: para
en: Largest Empty Circle within a set of points, constrained to lie in a polygon. The constraint polygon boundary must be included as an obstacle, as well as specified as the constraint for the circle center.
fr: Le plus grand cercle vide à l'intérieur d'un ensemble de points, contraint à se situer dans un polygone. La limite du polygone de contrainte doit être incluse en tant qu'obstacle et spécifiée en tant que contrainte pour le centre du cercle.

note: Tag: refpurpose
en: <refpurpose>Returns the smallest circle polygon that contains a geometry.</refpurpose>
fr: <refpurpose>Retourne le plus petit cercle polygonal qui contient une géométrie.</refpurpose>

note: Tag: para
en: <para>Returns the smallest circle polygon that contains a geometry.</para>
fr: <para>Retourne le plus petit cercle polygonal qui contient une géométrie.</para>

note: Tag: para
en: The bounding circle is approximated by a polygon with a default of 48 segments per quarter circle. Because the polygon is an approximation of the minimum bounding circle, some points in the input geometry may not be contained within the polygon. The approximation can be improved by increasing the number of segments. For applications where an approximation is not suitable <xref linkend="ST_MinimumBoundingRadius"/> may be used.
fr: Le cercle de délimitation est approximé par un polygone avec une valeur par défaut de 48 segments par quart de cercle. Le polygone étant une approximation du cercle de délimitation minimal, certains points de la géométrie d'entrée peuvent ne pas être contenus dans le polygone. L'approximation peut être améliorée en augmentant le nombre de segments. Pour les applications où une approximation ne convient pas, on peut utiliser <xref linkend="ST_MinimumBoundingRadius"/>.

note: Tag: para
en: Use with <xref linkend="ST_Collect"/> to get the minimum bounding circle of a set of geometries.
fr: A utiliser avec <xref linkend="ST_Collect"/> pour obtenir le cercle minimal de délimitation d'un ensemble de géométries.

note: Tag: para
en: To compute two points lying on the minimum circle (the "maximum diameter") use <xref linkend="ST_LongestLine"/>.
fr: Pour calculer deux points situés sur le cercle minimum (le "diamètre maximum"), utilisez <xref linkend="ST_LongestLine"/>.

note: Tag: para
en: The ratio of the area of a polygon divided by the area of its Minimum Bounding Circle is referred to as the <emphasis>Reock compactness score</emphasis>.
fr: Le rapport de la surface d'un polygone divisée par la surface de son cercle circonscrit minimal est appelé <emphasis>Score de compacité de Reock</emphasis>.

note: Tag: para
en: Minimum bounding circle of a point and linestring. Using 8 segs to approximate a quarter circle
fr: Cercle minimal de délimitation d'un point et d'une ligne de démarcation. Utilisation de 8 segments pour approximer un quart de cercle

note: Tag: refpurpose
en: Returns the center point and radius of the smallest circle that contains a geometry.
fr: Renvoie le point central et le rayon du plus petit cercle contenant une géométrie.

note: Tag: para
en: Computes the center point and radius of the smallest circle that contains a geometry. Returns a record with fields:
fr: Calcule le point central et le rayon du plus petit cercle contenant une géométrie. Retourne un enregistrement avec des champs :

note: Tag: para
en: Availability - 2.3.0
fr: Disponibilité - 2.3.0

note: Tag: refpurpose
en: Returns a minimum-area rectangle containing a geometry.
fr: Renvoie un rectangle de surface minimale contenant une géométrie.

note: Tag: para
en: Returns the minimum-area rotated rectangle enclosing a geometry. Note that more than one such rectangle may exist. May return a Point or LineString in the case of degenerate inputs.
fr: Renvoie le rectangle rotatif de surface minimale entourant une géométrie. Notez qu'il peut exister plus d'un rectangle de ce type. Peut renvoyer un point ou une ligne dans le cas d'entrées dégénérées.

note: Tag: para
en: Availability: 2.5.0.
fr: Disponibilité : 2.5.0.

note: Tag: para
en: Requires GEOS &gt;= 3.6.0.
fr: Nécessite GEOS &gt;= 3.6.0.

note: Tag: para
en: Oriented envelope of a point and linestring.
fr: Enveloppe orientée d'un point et d'une ligne.

note: Tag: refpurpose
en: Returns an offset line at a given distance and side from an input line.
fr: Renvoie une ligne décalée par rapport à une distance et un côté donnés à partir d'une ligne en entrée.

note: Tag: para
en: Return an offset line at a given distance and side from an input line. All points of the returned geometries are not further than the given distance from the input geometry. Useful for computing parallel lines about a center line.
fr: Renvoie une ligne décalée par rapport à une distance et un côté donnés à partir d'une ligne en entrée. Tous les points des géométries renvoyées ne sont pas plus éloignés que la distance donnée de la géométrie d'entrée. Utile pour calculer des lignes parallèles autour d'une ligne centrale.

note: Tag: para
en: For positive distance the offset is on the left side of the input line and retains the same direction. For a negative distance it is on the right side and in the opposite direction.
fr: Pour une distance positive, le décalage se situe à gauche de la ligne d'entrée et conserve la même direction. Pour une distance négative, il se trouve sur le côté droit et dans la direction opposée.

note: Tag: para
en: Units of distance are measured in units of the spatial reference system.
fr: Les unités de distance sont mesurées en unités du système de référence spatiale.

note: Tag: para
en: Note that output may be a MULTILINESTRING or EMPTY for some jigsaw-shaped input geometries.
fr: Notez que la sortie peut être un MULTILINESTRING ou un EMPTY pour certaines géométries d'entrée en forme de puzzle.

note: Tag: para
en: The optional third parameter allows specifying a list of blank-separated key=value pairs to tweak operations as follows:
fr: Le troisième paramètre facultatif permet de spécifier une liste de paires clé/valeur séparées par des blancs afin de modifier les opérations comme suit :

note: Tag: para
en: 'quad_segs=#' : number of segments used to approximate a quarter circle (defaults to 8).
fr: 'quad_segs=#' : nombre de segments utilisés pour approximer un quart de cercle (8 par défaut).

note: Tag: para
en: 'join=round|mitre|bevel' : join style (defaults to "round"). 'miter' is also accepted as a synonym for 'mitre'.
fr: 'join=round|mitre|bevel' : style de jointure (la valeur par défaut est "round"). 'miter' est également accepté comme synonyme de 'mitre'.

note: Tag: para
en: 'mitre_limit=#.#' : mitre ratio limit (only affects mitred join style). 'miter_limit' is also accepted as a synonym for 'mitre_limit'.
fr: 'mitre_limit=#.#' : limite du rapport de "mitre" (n'affecte que le style d'assemblage "mitred"). 'miter_limit' est également accepté comme synonyme de 'mitre_limit'.

note: Tag: para
en: Enhanced: 2.5 - added support for GEOMETRYCOLLECTION and MULTILINESTRING
fr: Amélioration : 2.5 - ajout de la prise en charge de GEOMETRYCOLLECTION et MULTILINESTRING

note: Tag: para
en: Compute an open buffer around roads
fr: Calculer une zone tampon ouverte autour des routes

note: Tag: para
en: 15, 'quad_segs=4 join=round' original line and its offset 15 units.
fr: 15, 'quad_segs=4 join=round' ligne originale et son décalage de 15 unités.

note: Tag: para
en: -15, 'quad_segs=4 join=round' original line and its offset -15 units
fr: -15, 'quad_segs=4 join=round' ligne originale et son décalage de -15 unités

note: Tag: para
en: double-offset to get more curvy, note the first reverses direction, so -30 + 15 = -15
fr: double décalage pour obtenir plus de courbes, notez que le premier inverse la direction, donc -30 + 15 = -15

note: Tag: para
en: double-offset to get more curvy,combined with regular offset 15 to get parallel lines. Overlaid with original.
fr: Double décalage pour obtenir des courbes plus prononcées, combiné avec le décalage régulier 15 pour obtenir des lignes parallèles. Superposition avec l'original.

note: Tag: para
en: 15, 'quad_segs=4 join=bevel' shown with original line
fr: 15, "quad_segs=4 join=bevel" montré avec la ligne originale

note: Tag: para
en: 15,-15 collected, join=mitre mitre_limit=2.1
fr: 15,-15 collecté, join=mitre mitre_limit=2.1

note: Tag: refpurpose
en: Computes a point guaranteed to lie in a polygon, or on a geometry.
fr: Calcule un point dont on garantit qu'il se trouve dans un polygone ou sur une géométrie.

note: Tag: para
en: Returns a <varname>POINT</varname> which is guaranteed to lie in the interior of a surface (<varname>POLYGON</varname>, <varname>MULTIPOLYGON</varname>, and <varname>CURVEPOLYGON</varname>). In PostGIS this function also works on line and point geometries.
fr: Renvoie un <varname>POINT</varname> qui est garanti de se trouver à l'intérieur d'une surface (<varname>POLYGON</varname>, <varname>MULTIPOLYGON</varname>, et <varname>CURVEPOLYGON</varname>). Dans PostGIS, cette fonction fonctionne également pour les géométries de lignes et de points.

note: Tag: para
en: &sqlmm_compliant; SQL-MM 3: 8.1.5, 9.5.6. The specifications define ST_PointOnSurface for surface geometries only. PostGIS extends the function to support all common geometry types. Other databases (Oracle, DB2, ArcSDE) seem to support this function only for surfaces. SQL Server 2008 supports all common geometry types.
fr: &sqlmm_compliant; SQL-MM 3: 8.1.5, 9.5.6. Les spécifications définissent ST_PointOnSurface pour les géométries de surface uniquement. PostGIS étend la fonction pour prendre en charge tous les types de géométrie courants. D'autres bases de données (Oracle, DB2, ArcSDE) semblent ne prendre en charge cette fonction que pour les surfaces. SQL Server 2008 prend en charge tous les types de géométrie courants.

note: Tag: para
en: Point on surface of a <varname>MULTIPOINT</varname>
fr: Point sur la surface d'un <varname>MULTIPOINT</varname>

note: Tag: para
en: Point on surface of a <varname>LINESTRING</varname>
fr: Point sur la surface d'une <varname>LINESTRING</varname>

note: Tag: para
en: Point on surface of a <varname>POLYGON</varname>
fr: Point sur la surface d'un <varname>POLYGON</varname>

note: Tag: para
en: Point on surface of a <varname>GEOMETRYCOLLECTION</varname>
fr: Point sur la surface d'une <varname>GEOMETRYCOLLECTION</varname>

note: Tag: para
en: <emphasis role="bold">Example:</emphasis> The result of ST_PointOnSurface is guaranteed to lie within polygons, whereas the point computed by <xref linkend="ST_Centroid"/> may be outside.
fr: <emphasis role="bold">Exemple:</emphasis> Le résultat de ST_PointOnSurface est garanti à l'intérieur des polygones, alors que le point calculé par <xref linkend="ST_Centroid"/> peut se trouver à l'extérieur.

note: Tag: para
en: Red: point on surface; Green: centroid
fr: Rouge : point sur la surface ; Vert : centroïde

note: Tag: refpurpose
en: Computes a collection of polygons formed from the linework of a set of geometries.
fr: Calcule une collection de polygones formés à partir du tracé d'un ensemble de géométries.

note: Tag: para
en: Creates a GeometryCollection containing the polygons formed by the linework of a set of geometries. If the input linework does not form any polygons, an empty GeometryCollection is returned.
fr: Crée une GeometryCollection contenant les polygones formés par le tracé d'un ensemble de géométries. Si le tracé en entrée ne forme aucun polygone, une GeometryCollection vide est renvoyée.

note: Tag: para
en: This function creates polygons covering all delimited areas. If the result is intended to form a valid polygonal geometry, use <xref linkend="ST_BuildArea"/> to prevent holes being filled.
fr: Cette fonction crée des polygones couvrant toutes les zones délimitées. Si le résultat est destiné à former une géométrie polygonale valide, utilisez <xref linkend="ST_BuildArea"/> pour éviter que des trous ne soient remplis.

note: Tag: para
en: The input linework must be correctly noded for this function to work properly. To ensure input is noded use <xref linkend="ST_Node"/> on the input geometry before polygonizing.
fr: La géométrie d'entrée doit être correctement nouée pour que cette fonction fonctionne correctement. Pour s'assurer que l'entrée est nouée, utilisez <xref linkend="ST_Node"/> sur la géométrie d'entrée avant de la polygoniser.

note: Tag: para
en: GeometryCollections can be difficult to handle with external tools. Use <xref linkend="ST_Dump"/> to convert the polygonized result into separate polygons.
fr: Les collections de géométries peuvent être difficiles à manipuler avec des outils externes. Utilisez <xref linkend="ST_Dump"/> pour convertir le résultat polygonisé en polygones séparés.

note: Tag: para
en: Polygonized result
fr: Résultat polygonisé

note: Tag: para
en: Polygonizing a table of linestrings:
fr: Polygonisation d'une table de lignes :

note: Tag: refpurpose
en: Returns a valid geometry with points rounded to a grid tolerance.
fr: Renvoie une géométrie valide dont les points sont arrondis en fonction de la tolérance de la grille.

note: Tag: para
en: Returns a valid geometry with all points rounded to the provided grid tolerance, and features below the tolerance removed.
fr: Renvoie une géométrie valide dont tous les points sont arrondis à la tolérance de grille fournie, et dont les caractéristiques inférieures à la tolérance sont supprimées.

note: Tag: para
en: Unlike <xref linkend="ST_SnapToGrid"/> the returned geometry will be valid, with no ring self-intersections or collapsed components.
fr: Contrairement à <xref linkend="ST_SnapToGrid"/>, la géométrie renvoyée sera valide, sans auto-intersections d'anneaux ni composants réduits.

note: Tag: para
en: Precision reduction can be used to:
fr: La réduction de précision peut être utilisée pour :

note: Tag: para
en: match coordinate precision to the data accuracy
fr: faire correspondre la précision des coordonnées à la précision des données

note: Tag: para
en: reduce the number of coordinates needed to represent a geometry
fr: réduire le nombre de coordonnées nécessaires pour représenter une géométrie

note: Tag: para
en: ensure valid geometry output to formats which use lower precision (e.g. text formats such as WKT, GeoJSON or KML when the number of output decimal places is limited).
fr: garantir une sortie géométrique valide vers des formats qui utilisent une précision moindre (par exemple, des formats de texte tels que WKT, GeoJSON ou KML lorsque le nombre de décimales de sortie est limité).

note: Tag: para
en: export valid geometry to systems which use lower or limited precision (e.g. SDE, Oracle tolerance value)
fr: exporter une géométrie valide vers des systèmes qui utilisent une précision plus faible ou limitée (par exemple, SDE, valeur de tolérance Oracle)

note: Tag: para
en: Precision reduction can reduce number of vertices
fr: La réduction de la précision permet de réduire le nombre de sommets

note: Tag: para
en: Precision reduction splits polygons if needed to ensure validity
fr: La réduction de la précision divise les polygones si nécessaire pour garantir la validité

note: Tag: refpurpose
en: Returns a collection containing paths shared by the two input linestrings/multilinestrings.
fr: Renvoie une collection contenant les chemins partagés par les deux lignes/multilignes en entrée.

note: Tag: para
en: Returns a collection containing paths shared by the two input geometries. Those going in the same direction are in the first element of the collection, those going in the opposite direction are in the second element. The paths themselves are given in the direction of the first geometry.
fr: Renvoie une collection contenant les chemins partagés par les deux géométries d'entrée. Ceux qui vont dans la même direction sont dans le premier élément de la collection, ceux qui vont dans la direction opposée sont dans le deuxième élément. Les chemins eux-mêmes sont donnés dans la direction de la première géométrie.

note: Tag: title
en: Examples: Finding shared paths
fr: Exemples : Trouver des chemins communs

note: Tag: para
en: A multilinestring and a linestring
fr: Une multiligne et une ligne

note: Tag: para
en: The shared path of multilinestring and linestring overlaid with original geometries.
fr: Le chemin partagé de la multiligne et de la ligne superposé aux géométries originales.

note: Tag: refpurpose
en: Returns a simplified representation of a geometry, using the Douglas-Peucker algorithm.
fr: Renvoie une représentation simplifiée d'une géométrie, en utilisant l'algorithme de Douglas-Peucker.

note: Tag: para
en: Computes a simplified representation of a geometry using the <link xlink:href="https://en.wikipedia.org/wiki/Ramer%E2%80%93Douglas%E2%80%93Peucker_algorithm">Douglas-Peucker algorithm</link>. The simplification <varname>tolerance</varname> is a distance value, in the units of the input SRS. Simplification removes vertices which are within the tolerance distance of the simplified linework. The result may not be valid even if the input is.
fr: Calcule une représentation simplifiée d'une géométrie en utilisant l'algorithme <link xlink:href="https://fr.wikipedia.org/wiki/Algorithme_de_Douglas-Peucker">Douglas-Peucker</link>. La variable <varname>tolerance</varname> de simplification est une valeur de distance, dans les unités du SRS d'entrée. La simplification supprime les sommets dont la distance au réseau simplifié est inférieure à la distance de tolérance. Le résultat peut ne pas être valide même si l'entrée l'est.

note: Tag: para
en: The function can be called with any kind of geometry (including GeometryCollections), but only line and polygon elements are simplified. Endpoints of linear geometry are preserved.
fr: La fonction peut être appelée avec n'importe quel type de géométrie (y compris les GeometryCollections), mais seuls les lignes et polygones sont simplifiés. Les extrémités des lignes sont préservées.

note: Tag: para
en: The <varname>preserveCollapsed</varname> flag retains small geometries that would otherwise be removed at the given tolerance. For example, if a 1m long line is simplified with a 10m tolerance, when <varname>preserveCollapsed</varname> is true the line will not disappear. This flag is useful for rendering purposes, to prevent very small features disappearing from a map.
fr: L'indicateur <varname>preserveCollapsed</varname> permet de conserver les petites géométries qui seraient autrement supprimées à la tolérance donnée. Par exemple, si une ligne de 1 m de long est simplifiée avec une tolérance de 10 m, lorsque <varname>preserveCollapsed</varname> est vrai, la ligne ne disparaîtra pas. Cette option est utile pour le rendu, afin d'éviter que de très petits éléments ne disparaissent de la carte.

note: Tag: para
en: The returned geometry may lose its simplicity (see <xref linkend="ST_IsSimple"/>), topology may not be preserved, and polygonal results may be invalid (see <xref linkend="ST_IsValid"/>). Use <xref linkend="ST_SimplifyPreserveTopology"/> to preserve topology and ensure validity.
fr: La géométrie renvoyée peut perdre sa simplicité (voir <xref linkend="ST_IsSimple"/>), la topologie peut ne pas être préservée et les résultats polygonaux peuvent être invalides (voir <xref linkend="ST_IsValid"/>). Utilisez <xref linkend="ST_SimplifyPreserveTopology"/> pour préserver la topologie et garantir la validité.

note: Tag: para
en: This function does not preserve boundaries shared between polygons. Use <xref linkend="ST_CoverageSimplify"/> if this is required.
fr: Cette fonction ne préserve pas les limites partagées entre les polygones. Utilisez <xref linkend="ST_CoverageSimplify"/> si cela est nécessaire.

note: Tag: para
en: A circle simplified too much becomes a triangle, medium an octagon,
fr: Un cercle trop simplifié devient un triangle, moyennement un octogone,

note: Tag: para
en: Simplifying a set of lines. Lines may intersect after simplification.
fr: Simplification d'un ensemble de lignes. Les lignes peuvent s'intersecter après simplification.

note: Tag: para
en: Simplifying a MultiPolygon. Polygonal results may be invalid.
fr: Simplification d'un polygone multiple. Les résultats polygonaux peuvent être invalides.

note: Tag: para
en: , <xref linkend="ST_SimplifyPreserveTopology"/>, <xref linkend="ST_SimplifyVW"/>, <xref linkend="ST_CoverageSimplify"/>, Topology <xref linkend="TP_ST_Simplify"/>
fr: , <xref linkend="ST_SimplifyPreserveTopology"/>, <xref linkend="ST_SimplifyVW"/>, <xref linkend="ST_CoverageSimplify"/>, Topologie <xref linkend="TP_ST_Simplify"/>

note: Tag: refpurpose
en: Returns a simplified and valid representation of a geometry, using the Douglas-Peucker algorithm.
fr: Renvoie une représentation simplifiée et valide d'une géométrie, en utilisant l'algorithme de Douglas-Peucker.

note: Tag: para
en: Computes a simplified representation of a geometry using a variant of the <link xlink:href="https://en.wikipedia.org/wiki/Ramer%E2%80%93Douglas%E2%80%93Peucker_algorithm">Douglas-Peucker algorithm</link> which limits simplification to ensure the result has the same topology as the input. The simplification <varname>tolerance</varname> is a distance value, in the units of the input SRS. Simplification removes vertices which are within the tolerance distance of the simplified linework, as long as topology is preserved. The result will be valid and simple if the input is.
fr: Calcule une représentation simplifiée d'une géométrie en utilisant une variante de l'algorithme <link xlink:href="https://fr.wikipedia.org/wiki/Algorithme_de_Douglas-Peucker">Douglas-Peucker</link> qui limite la simplification pour garantir que le résultat a la même topologie que l'entrée. Le paramètre de <varname>tolerance</varname> de simplification est une valeur de distance, dans les unités du SRS d'entrée. La simplification supprime les sommets dont la distance au réseau simplifiée est inférieure à la distance de tolérance, tant que la topologie est préservée. Le résultat sera valide et simple si l'entrée est.

note: Tag: para
en: The function can be called with any kind of geometry (including GeometryCollections), but only line and polygon elements are simplified. For polygonal inputs, the result will have the same number of rings (shells and holes), and the rings will not cross. Ring endpoints may be simplified. For linear inputs, the result will have the same number of lines, and lines will not intersect if they did not do so in the original geometry. Endpoints of linear geometry are preserved.
fr: La fonction peut être appelée avec n'importe quel type de géométrie (y compris les GeometryCollections), mais seuls les éléments linéaires et polygonaux sont simplifiés. Pour les éléments polygonaux, le résultat aura le même nombre d'anneaux (coquilles et trous), et les anneaux ne se croiseront pas. Les extrémités des anneaux peuvent être simplifiées. Pour les entrées linéaires, le résultat aura le même nombre de lignes et les lignes ne se croiseront pas si elles ne le faisaient pas dans la géométrie d'origine. Les extrémités de la géométrie linéaire sont préservées.

note: Tag: para
en: Availability: 1.3.3
fr: Disponibilité : 1.3.3

note: Tag: para
en: For the same example as <xref linkend="ST_Simplify"/>, ST_SimplifyPreserveTopology prevents oversimplification. The circle can at most become a square.
fr: Pour le même exemple que <xref linkend="ST_Simplify"/>, ST_SimplifyPreserveTopology empêche toute simplification excessive. Le cercle peut au maximum devenir un carré.

note: Tag: para
en: Simplifying a set of lines, preserving topology of non-intersecting lines.
fr: Simplification d'un ensemble de lignes, en préservant la topologie des lignes qui ne se croisent pas.

note: Tag: para
en: Simplifying a MultiPolygon, preserving topology of shells and holes.
fr: Simplification d'un multipolygone, en préservant la topologie des coquilles et des trous.

note: Tag: refpurpose
en: Computes a simplifed topology-preserving outer or inner hull of a polygonal geometry.
fr: Calcule une enveloppe extérieure ou intérieure simplifiée préservant la topologie d'une géométrie polygonale.

note: Tag: para
en: Computes a simplified topology-preserving outer or inner hull of a polygonal geometry. An outer hull completely covers the input geometry. An inner hull is completely covered by the input geometry. The result is a polygonal geometry formed by a subset of the input vertices. MultiPolygons and holes are handled and produce a result with the same structure as the input.
fr: Calcule une enveloppe extérieure ou intérieure simplifiée préservant la topologie d'une géométrie polygonale. Une enveloppe extérieure couvre complètement la géométrie d'entrée. Une enveloppe intérieure est entièrement couverte par la géométrie d'entrée. Le résultat est une géométrie polygonale formée par un sous-ensemble de sommets d'entrée. Les multipolygones et les trous sont gérés et produisent un résultat ayant la même structure que la géométrie d'entrée.

note: Tag: para
en: The reduction in vertex count is controlled by the <varname>vertex_fraction</varname> parameter, which is a number in the range 0 to 1. Lower values produce simpler results, with smaller vertex count and less concaveness. For both outer and inner hulls a vertex fraction of 1.0 produces the original geometry. For outer hulls a value of 0.0 produces the convex hull (for a single polygon); for inner hulls it produces a triangle.
fr: La réduction du nombre de sommets est contrôlée par le paramètre <varname>vertex_fraction</varname>, qui est un nombre compris entre 0 et 1. Les valeurs inférieures produisent des résultats plus simples, avec un nombre de vertex plus faible et une concavité moindre. Pour les enveloppes extérieures et intérieures, une fraction de sommet de 1,0 produit la géométrie originale. Pour les enveloppes extérieures, une valeur de 0,0 produit l'enveloppe convexe (pour un polygone unique) ; pour les enveloppes intérieures, elle produit un triangle.

note: Tag: para
en: The simplification process operates by progressively removing concave corners that contain the least amount of area, until the vertex count target is reached. It prevents edges from crossing, so the result is always a valid polygonal geometry.
fr: Le processus de simplification consiste à supprimer progressivement les angles concaves qui contiennent le moins de surface, jusqu'à ce que l'objectif de nombre de vertex soit atteint. Il empêche les arêtes de se croiser, de sorte que le résultat est toujours une géométrie polygonale valide.

note: Tag: para
en: To get better results with geometries that contain relatively long line segments, it might be necessary to "segmentize" the input, as shown below.
fr: Pour obtenir de meilleurs résultats avec des géométries contenant des segments de ligne relativement longs, il peut être nécessaire de "segmenter" l'entrée, comme indiqué ci-dessous.

note: Tag: para
en: Availability: 3.3.0.
fr: Disponibilité : 3.3.0.

note: Tag: para
en: Requires GEOS &gt;= 3.11.0.
fr: Nécessite GEOS &gt;= 3.11.0.

note: Tag: para
en: Outer hull of a Polygon
fr: Enveloppe extérieure d'un polygone

note: Tag: para
en: Inner hull of a Polygon
fr: Enveloppe intérieure d'un polygone

note: Tag: para
en: Outer hull simplification of a MultiPolygon, with segmentization
fr: Simplification de l'enveloppe extérieure d'un MultiPolygone, avec segmentation

note: Tag: refpurpose
en: Returns a simplified representation of a geometry, using the Visvalingam-Whyatt algorithm
fr: Renvoie une représentation simplifiée d'une géométrie, en utilisant l'algorithme de Visvalingam-Whyatt

note: Tag: para
en: Returns a simplified representation of a geometry using the <link xlink:href="https://en.wikipedia.org/wiki/Visvalingam%E2%80%93Whyatt_algorithm">Visvalingam-Whyatt algorithm</link>. The simplification <varname>tolerance</varname> is an area value, in the units of the input SRS. Simplification removes vertices which form "corners" with area less than the tolerance. The result may not be valid even if the input is.
fr: Renvoie une représentation simplifiée d'une géométrie à l'aide de l'algorithme <link xlink:href="https://en.wikipedia.org/wiki/Visvalingam%E2%80%93Whyatt_algorithm">Visvalingam-Whyatt</link>. La <varname>tolérance</varname> de simplification est une valeur de surface, dans les unités du SRS d'entrée. La simplification supprime les sommets qui forment des "coins" dont la surface est inférieure à la tolérance. Le résultat peut ne pas être valide même si l'entrée l'est.

note: Tag: para
en: The returned geometry may lose its simplicity (see <xref linkend="ST_IsSimple"/>), topology may not be preserved, and polygonal results may be invalid (see <xref linkend="ST_IsValid"/>). Use <xref linkend="ST_SimplifyPreserveTopology"/> to preserve topology and ensure validity. <xref linkend="ST_CoverageSimplify"/> also preserves topology and validity.
fr: La géométrie renvoyée peut perdre sa simplicité (voir <xref linkend="ST_IsSimple"/>), la topologie peut ne pas être préservée et les résultats polygonaux peuvent être invalides (voir <xref linkend="ST_IsValid"/>). Utilisez <xref linkend="ST_SimplifyPreserveTopology"/> pour préserver la topologie et garantir la validité. <xref linkend="ST_CoverageSimplify"/> préserve également la topologie et la validité.

note: Tag: para
en: This function handles 3D and the third dimension will affect the result.
fr: Cette fonction gère la 3D et la troisième dimension affectera le résultat.

note: Tag: para
en: A LineString is simplified with a minimum-area tolerance of 30.
fr: Une LineString est simplifiée avec une tolérance de surface minimale de 30.

note: Tag: para
en: Simplifying a line.
fr: Simplification d'une ligne.

note: Tag: para
en: Simplifying a polygon.
fr: Simplification d'un polygone.

note: Tag: para
en: , <xref linkend="ST_Simplify"/>, <xref linkend="ST_SimplifyPreserveTopology"/>, <xref linkend="ST_CoverageSimplify"/>, Topology <xref linkend="TP_ST_Simplify"/>
fr: , <xref linkend="ST_Simplify"/>, <xref linkend="ST_SimplifyPreserveTopology"/>, <xref linkend="ST_CoverageSimplify"/>, Topologie <xref linkend="TP_ST_Simplify"/>

note: Tag: refpurpose
en: Sets the effective area for each vertex, using the Visvalingam-Whyatt algorithm.
fr: Définit la surface effective de chaque sommet, en utilisant l'algorithme Visvalingam-Whyatt.

note: Tag: para
en: Sets the effective area for each vertex, using the Visvalingam-Whyatt algorithm. The effective area is stored as the M-value of the vertex. If the optional "threshold" parameter is used, a simplified geometry will be returned, containing only vertices with an effective area greater than or equal to the threshold value.
fr: Définit la surface effective de chaque sommet, en utilisant l'algorithme Visvalingam-Whyatt. La surface effective est stockée comme la valeur M du sommet. Si le paramètre optionnel "threshold" est utilisé, une géométrie simplifiée sera renvoyée, contenant uniquement les sommets dont la surface effective est supérieure ou égale à la valeur seuil.

note: Tag: para
en: This function can be used for server-side simplification when a threshold is specified. Another option is to use a threshold value of zero. In this case, the full geometry will be returned with effective areas as M-values, which can be used by the client to simplify very quickly.
fr: Cette fonction peut être utilisée pour la simplification côté serveur lorsqu'un seuil est spécifié. Une autre option consiste à utiliser une valeur seuil de zéro. Dans ce cas, la géométrie complète sera renvoyée avec les surfaces effectives sous forme de valeurs M, qui peuvent être utilisées par le client pour simplifier très rapidement.

note: Tag: para
en: Will actually do something only with (multi)lines and (multi)polygons but you can safely call it with any kind of geometry. Since simplification occurs on a object-by-object basis you can also feed a GeometryCollection to this function.
fr: Cette fonction n'agit qu'avec des (multi)lignes et des (multi)polygones, mais vous pouvez l'appeler en toute sécurité avec n'importe quel type de géométrie. Comme la simplification se produit objet par objet, vous pouvez également utiliser une collection de géométries dans cette fonction.

note: Tag: para
en: Note that returned geometry might lose its simplicity (see <xref linkend="ST_IsSimple"/>)
fr: Notez que la géométrie retournée peut perdre sa simplicité (voir <xref linkend="ST_IsSimple"/>)

note: Tag: para
en: Note topology may not be preserved and may result in invalid geometries. Use (see <xref linkend="ST_SimplifyPreserveTopology"/>) to preserve topology.
fr: Notez que la topologie peut ne pas être préservée et donner lieu à des géométries non valides. Utilisez (voir <xref linkend="ST_SimplifyPreserveTopology"/>) pour préserver la topologie.

note: Tag: para
en: The output geometry will lose all previous information in the M-values
fr: La géométrie de sortie perdra toutes les informations précédentes concernant les valeurs M

note: Tag: para
en: This function handles 3D and the third dimension will affect the effective area
fr: Cette fonction gère la 3D et la troisième dimension affecte la surface effective

note: Tag: para
en: Calculating the effective area of a LineString. Because we use a threshold value of zero, all vertices in the input geometry are returned.
fr: Calcul de la surface effective d'une LineString. Comme nous utilisons une valeur seuil de zéro, tous les sommets de la géométrie d'entrée sont renvoyés.

note: Tag: refpurpose
en: Computes the constrained Delaunay triangulation of polygons
fr: Calcule la triangulation de Delaunay contrainte des polygones

note: Tag: para
en: Computes the constrained Delaunay triangulation of polygons. Holes and Multipolygons are supported.
fr: Calcule la triangulation de Delaunay contrainte des polygones. Les trous et les multipolygones sont pris en charge.

note: Tag: para
en: The "constrained Delaunay triangulation" of a polygon is a set of triangles formed from the vertices of the polygon, and covering it exactly, with the maximum total interior angle over all possible triangulations. It provides the "best quality" triangulation of the polygon.
fr: La "constrained Delaunay triangulation" d'un polygone est un ensemble de triangles formés à partir des sommets du polygone et le couvrant exactement, avec l'angle intérieur total maximal parmi toutes les triangulations possibles. Elle constitue la triangulation de "meilleure qualité" du polygone.

note: Tag: para
en: Triangulation of a square.
fr: Triangulation d'un carré.

note: Tag: para
en: Triangulation of the letter P.
fr: Triangulation de la lettre P.

note: Tag: para
en: Polygon Triangulation
fr: Triangulation de polygone

note: Tag: title
en: Same example as ST_Tesselate
fr: Même exemple que ST_Tesselate

note: Tag: para
en: ST_AsText output
fr: Sortie ST_AsText

note: Tag: para
en: Original polygon
fr: Polygone d'origine

note: Tag: para
en: Triangulated Polygon
fr: Polygone triangulé

note: Tag: refpurpose
en: Returns the boundaries of the Voronoi diagram of the vertices of a geometry.
fr: Renvoie les limites des polygones de Voronoï des sommets d'une géométrie.

note: Tag: para
en: Computes a two-dimensional <link xlink:href="https://en.wikipedia.org/wiki/Voronoi_diagram">Voronoi diagram</link> from the vertices of the supplied geometry and returns the boundaries between cells in the diagram as a MultiLineString. Returns null if input geometry is null. Returns an empty geometry collection if the input geometry contains only one vertex. Returns an empty geometry collection if the <varname>extend_to</varname> envelope has zero area.
fr: Calcule un <link xlink:href="https://en.wikipedia.org/wiki/Voronoi_diagram">Voronoi diagram</link> bidimensionnel à partir des sommets de la géométrie fournie et renvoie les limites entre les cellules de la représentation sous la forme d'une MultiLineString. Renvoie null si la géométrie d'entrée est null. Renvoie une collection de géométries vide si la géométrie d'entrée ne contient qu'un seul sommet. Renvoie une collection de géométries vide si l'enveloppe <varname>extend_to</varname> a une surface nulle.

note: Tag: para
en: Optional parameters:
fr: Paramètres optionnels :

note: Tag: para
en: <varname>tolerance</varname>: The distance within which vertices will be considered equivalent. Robustness of the algorithm can be improved by supplying a nonzero tolerance distance. (default = 0.0)
fr: <varname>tolerance</varname> : distance à laquelle les sommets seront considérés comme équivalents. La robustesse de l'algorithme peut être améliorée en fournissant une distance de tolérance non nulle. (par défaut = 0.0)

note: Tag: para
en: <varname>extend_to</varname>: If present, the diagram is extended to cover the envelope of the supplied geometry, unless smaller than the default envelope (default = NULL, default envelope is the bounding box of the input expanded by about 50%).
fr: <varname>extend_to</varname> : S'il est présent, la représentation est étendue pour couvrir l'enveloppe de la géométrie fournie, à moins qu'elle ne soit plus petite que l'enveloppe par défaut (default = NULL, l'enveloppe par défaut est la boîte de délimitation de l'entrée élargie d'environ 50 %).

note: Tag: para
en: Voronoi diagram lines, with tolerance of 30 units
fr: Lignes de la représentation de Voronoï, avec une tolérance de 30 unités

note: Tag: refpurpose
en: Returns the cells of the Voronoi diagram of the vertices of a geometry.
fr: Renvoie les cellules de la représentation de Voronoï des sommets d'une géométrie.

note: Tag: para
en: Computes a two-dimensional <link xlink:href="https://en.wikipedia.org/wiki/Voronoi_diagram">Voronoi diagram</link> from the vertices of the supplied geometry. The result is a GEOMETRYCOLLECTION of POLYGONs that covers an envelope larger than the extent of the input vertices. Returns null if input geometry is null. Returns an empty geometry collection if the input geometry contains only one vertex. Returns an empty geometry collection if the <varname>extend_to</varname> envelope has zero area.
fr: Calcule un <link xlink:href="https://en.wikipedia.org/wiki/Voronoi_diagram">diagramme de Voronoï</link> bidimensionnel à partir des sommets de la géométrie fournie. Le résultat est une GEOMETRYCOLLECTION de POLYGONES qui couvre une enveloppe plus grande que l'étendue des sommets d'entrée. Renvoie null si la géométrie d'entrée est null. Renvoie une collection de géométries vide si la géométrie d'entrée ne contient qu'un seul sommet. Renvoie une collection de géométries vide si l'enveloppe <varname>extend_to</varname> a une surface nulle.

note: Tag: para
en: Points overlaid on top of Voronoi diagram
fr: Points superposés à la représentation de Voronoï

note: Tag: para
en: Voronoi diagram, with tolerance of 30 units
fr: Représentation de Voronoï, avec une tolérance de 30 unités

note: Tag: title
en: Raster Reference
fr: Référence Raster

note: Tag: para
en: The functions given below are the ones which a user of PostGIS Raster is likely to need and which are currently available in PostGIS Raster. There are other functions which are required support functions to the raster objects which are not of use to a general user.
fr: Les fonctions mentionnées ci-dessous sont celles qu'un utilisateur typique de PostGIS Raster sera amené à utiliser et qui sont disponibles dans PostGIS Raster. D'autres fonctions sont également définies, requises en interne pour le support des objets rasters, mais ne sont pas destinées à être utilisées par le grand public.

note: Tag: para
en: <varname>raster</varname> is a new PostGIS type for storing and analyzing raster data.
fr: <varname>raster</varname> est un nouveau type PostGIS pour stocker et analyser les données raster.

note: Tag: para
en: For loading rasters from raster files please refer to <xref linkend="RT_Loading_Rasters"/>
fr: Pour charger des rasters depuis des fichiers, voir <xref linkend="RT_Loading_Rasters"/>

note: Tag: para
en: For the examples in this reference we will be using a raster table of dummy rasters - Formed with the following code
fr: Pour les exemples dans cette section, nous utiliserons une table de rasters fictifs, créée via la requête suivante

note: Tag: title
en: Raster Support Data types
fr: Types de données pour la prise en charge raster

note: Tag: para
en: This section lists the PostgreSQL data types specifically created to support raster functionality.
fr: Cette section liste les types de données PostgreSQL créés pour supporter les fonctionnalités raster.

note: Tag: refpurpose
en: A spatial datatype with two fields - geom (holding a geometry object) and val (holding a double precision pixel value from a raster band).
fr: Un type spatial comportant deux champs : geom (stockant un objet géométrique) et val (stockant la valeur du pixel en double précision depuis une bande du raster).

note: Tag: para
en: geomval is a compound data type consisting of a geometry object referenced by the .geom field and val, a double precision value that represents the pixel value at a particular geometric location in a raster band. It is used by the ST_DumpAsPolygon and Raster intersection family of functions as an output type to explode a raster band into geometry polygons.
fr: geomval est un type composite, comprenant un objet géométrique dans le champ .geom et val, une valeur en double précision qui représente la valeur du pixel à un emplacement spécifique d'une bande raster. Ce type est utilisé par la fonction ST_DumpAsPolygon et la famille de fonctions d'intersection Raster, en tant que type de sortie pour éclater une bande raster en polygones.

note: Tag: refpurpose
en: <refpurpose>A composite type used as input into the ST_AddBand function defining the attributes and initial value of the new band.</refpurpose>
fr: <refpurpose>Un type composite utilisé comme entrée pour la fonction ST_AddBand pour définir les attributs et la valeur initiale d'une nouvelle bande.</refpurpose>

note: Tag: para
en: <para>A composite type used as input into the ST_AddBand function defining the attributes and initial value of the new band.</para>
fr: <para>Un type composite utilisé comme entrée pour la fonction ST_AddBand pour définir les attributs et la valeur initiale d'une nouvelle bande.</para>

note: Tag: para
en: 1-based value indicating the position where the new band will be added amongst the raster's bands. If NULL, the new band will be added at the end of the raster's bands.
fr: Indice (basé sur 1) où insérer la nouvelle bande dans la liste des bandes du raster. Si NULL, la nouvelle bande sera ajoutée en dernière position.

note: Tag: para
en: Pixel type of the new band. One of defined pixel types as described in <xref linkend="RT_ST_BandPixelType"/>.
fr: Type de pixel pour la nouvelle bande. Doit être un des types de pixels définis, tels que décrits dans <xref linkend="RT_ST_BandPixelType"/>.

note: Tag: para
en: Initial value that all pixels of new band will be set to.
fr: Valeur initiale pour tous les pixels de la nouvelle bande.

note: Tag: para
en: NODATA value of the new band. If NULL, the new band will not have a NODATA value assigned.
fr: Valeur NODATA pour la nouvelle bande. Si NULL, la nouvelle bande n'aura pas de valeur NODATA attribuée.

note: Tag: refpurpose
en: <refpurpose>A composite type for use when needing to express a raster and a band index of that raster.</refpurpose>
fr: <refpurpose>Un type composite pour représenter à la fois un raster et un indice d'une bande de ce raster.</refpurpose>

note: Tag: para
en: <para>A composite type for use when needing to express a raster and a band index of that raster.</para>
fr: <para>Un type composite pour représenter à la fois un raster et un indice d'une bande de ce raster.</para>

note: Tag: para
en: The raster in question/
fr: Le raster en question

note: Tag: para
en: 1-based value indicating the band of raster
fr: Indice (basé sur 1) de la bande du raster

note: Tag: refpurpose
en: raster spatial data type.
fr: Type de données raster spatial.

note: Tag: para
en: raster is a spatial data type used to represent raster data such as those imported from JPEGs, TIFFs, PNGs, digital elevation models. Each raster has 1 or more bands each having a set of pixel values. Rasters can be georeferenced.
fr: raster est le type de données spatial pour représenter les données rasters, telles qu'importées depuis des fichiers JPEGs, TIFFs, PNGs, modèles d'élévation numérique. Chaque raster a une ou plusieurs bandes, chacune correspondant à un ensemble de valeurs de pixels. Les rasters peuvent être géo-référencés.

note: Tag: para
en: Requires PostGIS be compiled with GDAL support. Currently rasters can be implicitly converted to geometry type, but the conversion returns the <xref linkend="RT_ST_ConvexHull"/> of the raster. This auto casting may be removed in the near future so don't rely on it.
fr: PostGIS doit être compilé avec le support GDAL. Actuellement, les rasters peuvent être implicitement convertis en type geometry, mais la conversion retourne un <xref linkend="RT_ST_ConvexHull"/> du raster. Ce transtypage implicite peut être supprimé dans le futur proche et ne devrait pas être utilisé.

note: Tag: refpurpose
en: <refpurpose>A composite type used as input into the ST_Reclass function defining the behavior of reclassification.</refpurpose>
fr: <refpurpose>Un type composite utilisé comme entrée pour la fonction ST_Reclass pour définir le comportement de la reclassification.</refpurpose>

note: Tag: para
en: <para>A composite type used as input into the ST_Reclass function defining the behavior of reclassification.</para>
fr: <para>Un type composite utilisé comme entrée pour la fonction ST_Reclass pour définir le comportement de la reclassification.</para>

note: Tag: para
en: The band number of band to reclassify.
fr: L'indice de bande à reclassifier.

note: Tag: para
en: range expression consisting of comma delimited range:map_range mappings. : to define mapping that defines how to map old band values to new band values. ( means &gt;, ) means less than, ] &lt; or equal, [ means &gt; or equal
fr: Expression des classes, sous forme de correspondance range:map_range séparés par des virgules pour définir les correspondances entre les anciennes valeurs de la bande et la nouvelle valeur. ( signifie plus grand que, ) signifie plus petit que, ] signifie inférieur ou égal, [ signifie supérieur ou égal

note: Tag: para
en: ( notation is optional so a-b means the same as (a-b)
fr: La notation ( est facultative : a-b est équivalent à (a-b)

note: Tag: para
en: One of defined pixel types as described in <xref linkend="RT_ST_BandPixelType"/>
fr: Un des types de pixels définis, tels que décrits dans <xref linkend="RT_ST_BandPixelType"/>

note: Tag: para
en: Value to treat as no data. For image outputs that support transparency, these will be blank.
fr: Valeur à utiliser comme NODATA. Pour les formats d'images supportant la transparence, ces pixels seront transparents.

note: Tag: title
en: Example: Reclassify band 2 as an 8BUI where 255 is nodata value
fr: Exemple : Reclassifier la bande 2 en 8BUI avec 255 comme valeur NODATA

note: Tag: title
en: Example: Reclassify band 1 as an 1BB and no nodata value defined
fr: Exemple : Reclassifier la bande 1 en 1BB sans valeur NODATA

note: Tag: refpurpose
en: A composite type returned by the ST_SummaryStats and ST_SummaryStatsAgg functions.
fr: Un type composite retournée par les fonctions ST_SummaryStats et ST_SummaryStatsAgg.

note: Tag: para
en: A composite type returned by the <xref linkend="RT_ST_SummaryStats"/> and <xref linkend="RT_ST_SummaryStatsAgg"/> functions.
fr: Un type composite retournée par les fonctions <xref linkend="RT_ST_SummaryStats"/> et <xref linkend="RT_ST_SummaryStatsAgg"/>.

note: Tag: para
en: Number of pixels counted for the summary statistics.
fr: Nombre de pixels comptabilisés pour les résumés statistiques.

note: Tag: para
en: Sum of all counted pixel values.
fr: Somme des valeurs de tous les pixels comptabilisés.

note: Tag: para
en: Arithmetic mean of all counted pixel values.
fr: Moyenne arithmétique des valeurs de tous les pixels comptabilisés.

note: Tag: para
en: Standard deviation of all counted pixel values.
fr: Écart type des valeurs de tous les pixels comptabilisés.

note: Tag: para
en: Minimum value of counted pixel values.
fr: Minimum des valeurs de tous les pixels comptabilisés.

note: Tag: para
en: Maximum value of counted pixel values.
fr: Maximum des valeurs de tous les pixels comptabilisés.

note: Tag: refpurpose
en: <refpurpose>A composite type used as input into the ST_Union function defining the bands to be processed and behavior of the UNION operation.</refpurpose>
fr: <refpurpose>Un type composite utilisé comme entrée de la fonction ST_Union pour définir les bandes à traiter et le comportement de l'opération d'union.</refpurpose>

note: Tag: para
en: <para>A composite type used as input into the ST_Union function defining the bands to be processed and behavior of the UNION operation.</para>
fr: <para>Un type composite utilisé comme entrée de la fonction ST_Union pour définir les bandes à traiter et le comportement de l'opération d'union.</para>

note: Tag: para
en: 1-based value indicating the band of each input raster to be processed.
fr: Indice (basé sur 1) indiquant la bande de chaque raster d'entrée à traiter.

note: Tag: para
en: Type of UNION operation. One of defined types as described in <xref linkend="RT_ST_Union"/>.
fr: Type de l'opération d'union. Doit être un des types définis, tels que décrits dans <xref linkend="RT_ST_Union"/>.

note: Tag: title
en: Raster Management
fr: Gestion raster

note: Tag: refpurpose
en: Adds raster constraints to a loaded raster table for a specific column that constrains spatial ref, scaling, blocksize, alignment, bands, band type and a flag to denote if raster column is regularly blocked. The table must be loaded with data for the constraints to be inferred. Returns true if the constraint setting was accomplished and issues a notice otherwise.
fr: Ajoute des contraintes raster à une table pour une colonne spécifique pour contraindre le système de référence spatial, l'échelle, la taille des blocs, l'alignement, le nombre de bandes, le type de pixels, la contrainte d'unicité spatiale. La table doit être chargée avec des données pour que les contraintes puissent être inférées. Retourne true si les contraintes ont été ajoutées, ou émet une notice sinon.

note: Tag: para
en: Generates constraints on a raster column that are used to display information in the <varname>raster_columns</varname> raster catalog. The <varname>rastschema</varname> is the name of the table schema the table resides in. The <varname>srid</varname> must be an integer value reference to an entry in the SPATIAL_REF_SYS table.
fr: Génère des contraintes pour une colonne raster, qui peuvent être utilisées pour afficher des informations depuis le catalogue raster <varname>raster_columns</varname>. <varname>rastschema</varname> est le nom du schéma de la table. <varname>srid</varname> doit être un entier défini dans la table SPATIAL_REF_SYS.

note: Tag: para
en: <varname>raster2pgsql</varname> loader uses this function to register raster tables
fr: Le chargeur de rasters <varname>raster2pgsql</varname> utilise cette fonction pour enregistrer les tables raster

note: Tag: para
en: Valid constraint names to pass in: refer to <xref linkend="RT_Raster_Columns"/> for more details.
fr: Noms de contraintes à passer en arguments : se référer à <xref linkend="RT_Raster_Columns"/> pour plus de détails.

note: Tag: para
en: <varname>blocksize</varname> sets both X and Y blocksize
fr: <varname>blocksize</varname> défini la largeur en X et en Y

note: Tag: para
en: <varname>blocksize_x</varname> sets X tile (width in pixels of each tile)
fr: <varname>blocksize_x</varname> défini la largeur (nombre de pixels) de chaque tuile raster

note: Tag: para
en: <varname>blocksize_y</varname> sets Y tile (height in pixels of each tile)
fr: <varname>blocksize_y</varname> défini la hauteur (nombre de pixels vers le bas) de chaque tuile raster

note: Tag: para
en: <varname>extent</varname> computes extent of whole table and applies constraint all rasters must be within that extent
fr: <varname>extent</varname> calcule l'étendue de l'ensemble de la table et contraint tous les rasters à être inclus dans cette étendue

note: Tag: para
en: <varname>num_bands</varname> number of bands
fr: <varname>num_bands</varname> nombre de bandes

note: Tag: para
en: <varname>pixel_types</varname> reads array of pixel types for each band ensure all band n have same pixel type
fr: <varname>pixel_types</varname> tableau de types de pixels pour chaque bande - contraint chaque bande n au même type de pixels

note: Tag: para
en: <varname>regular_blocking</varname> sets spatially unique (no two rasters can be spatially the same) and coverage tile (raster is aligned to a coverage) constraints
fr: <varname>regular_blocking</varname> défini les contraintes d'unité spatiale (deux rasters ne peuvent pas être spatialement identiques) et de couverture de tuiles (raster est aligné sur une couverture)

note: Tag: para
en: <varname>same_alignment</varname> ensures they all have same alignment meaning any two tiles you compare will return true for. Refer to <xref linkend="RT_ST_SameAlignment"/>.
fr: <varname>same_alignment</varname> garantie que toutes les tuiles ont le même alignement. Comparer n'importe quel couple de tuiles retournera true. Voir <xref linkend="RT_ST_SameAlignment"/> pour plus de détails.

note: Tag: para
en: <varname>srid</varname> ensures all have same srid
fr: <varname>srid</varname> garantie que tous les rasters ont le même srid

note: Tag: para
en: More -- any listed as inputs into the above functions
fr: Plus -- n'importe quelle contrainte listée parmi les arguments des fonctions décrites ci-dessus

note: Tag: para
en: This function infers the constraints from the data already present in the table. As such for it to work, you must create the raster column first and then load it with data.
fr: Cette fonction infère les contraintes depuis les données déjà présentes dans la table. Ainsi, vous devez d'abord créer la colonne raster et charger des données dedans avant de pouvoir utiliser cette fonction.

note: Tag: para
en: If you need to load more data in your tables after you have already applied constraints, you may want to run the DropRasterConstraints if the extent of your data has changed.
fr: Si vous avez besoin de charger plus de données dans la table après avoir défini les contraintes, vous pourrez avoir besoin d'exécuter la fonction DropRasterConstraints avant le chargement, en particulier si l'étendue des données est modifiée.

note: Tag: title
en: Examples: Apply all possible constraints on column based on data
fr: Exemples : Appliquer toutes les contraintes possibles à partir des données présentes

note: Tag: title
en: Examples: Apply single constraint
fr: Exemples : Appliquer une seule contrainte

note: Tag: refpurpose
en: Drops PostGIS raster constraints that refer to a raster table column. Useful if you need to reload data or update your raster column data.
fr: Supprime des contraintes raster PostGIS raster sur une colonne raster d'une table. Utile pour recharger des données ou mettre à jour les données d'une colonne raster.

note: Tag: para
en: Drops PostGIS raster constraints that refer to a raster table column that were added by <xref linkend="RT_AddRasterConstraints"/>. Useful if you need to load more data or update your raster column data. You do not need to do this if you want to get rid of a raster table or a raster column.
fr: Supprime des contraintes raster PostGIS ajoutées via <xref linkend="RT_AddRasterConstraints"/> sur une colonne raster d'une table. Utile pour recharger des données ou mettre à jour les données d'une colonne raster. Vous n'avez pas besoin d'appeler cette fonction si vous voulez supprimer une table raster ou une colonne raster.

note: Tag: para
en: To drop a raster table use the standard
fr: Pour supprimer une table raster, utilisez la requête classique

note: Tag: para
en: To drop just a raster column and leave the rest of the table, use standard SQL
fr: Pour supprimer une colonne raster et garder le reste de la table intacte, utilisez la requête classique

note: Tag: para
en: the table will disappear from the <varname>raster_columns</varname> catalog if the column or table is dropped. However if only the constraints are dropped, the raster column will still be listed in the <varname>raster_columns</varname> catalog, but there will be no other information about it aside from the column name and table.
fr: La table disparaîtra du catalogue <varname>raster_columns</varname> si la colonne ou la table est supprimée. Si seulement les contraintes ont été supprimées, la colonne raster sera toujours listée dans le catalogue <varname>raster_columns</varname>, mais il n'y aura pas d'autre information que les noms de la colonne et de la table.

note: Tag: refpurpose
en: Tag a raster column as being an overview of another.
fr: Marque une colonne raster comme étant un aperçu d'une autre colonne.

note: Tag: para
en: Adds constraints on a raster column that are used to display information in the <varname>raster_overviews</varname> raster catalog.
fr: Ajoute des contraintes sur une colonne raster, qui peuvent être utilisées pour afficher des informations depuis le catalogue raster <varname>raster_overviews</varname>.

note: Tag: para
en: The <varname>ovfactor</varname> parameter represents the scale multiplier in the overview column: higher overview factors have lower resolution.
fr: La paramètre <varname>ovfactor</varname> représente le facture de multiplication d'échelle pour la colonne d'aperçu : plus le facteur d'aperçu est élevé, plus résolution est basse.

note: Tag: para
en: When the <varname>ovschema</varname> and <varname>refschema</varname> parameters are omitted, the first table found scanning the <varname>search_path</varname> will be used.
fr: Si les paramètres <varname>ovschema</varname> et <varname>refschema</varname> sont omis, la première table trouvée lors du scan de <varname>search_path</varname> sera utilisée.

note: Tag: refpurpose
en: Untag a raster column from being an overview of another.
fr: Supprime les contraintes d'aperçu de la colonne.

note: Tag: para
en: Remove from a raster column the constraints used to show it as being an overview of another in the <varname>raster_overviews</varname> raster catalog.
fr: Supprime dans le catalogue raster <varname>raster_overviews</varname> les contraintes raster de la colonne indiquant que c'est un aperçu une autre colonne.

note: Tag: para
en: When the <varname>ovschema</varname> parameter is omitted, the first table found scanning the <varname>search_path</varname> will be used.
fr: Si le paramètre <varname>ovschema</varname> est omis, la première table trouvée lors du scan de <varname>search_path</varname> sera utilisée.

note: Tag: refpurpose
en: Reports the version of the GDAL library in use by PostGIS.
fr: Retourne la version de la bibliothèque GDAL utilisée par PostGIS.

note: Tag: para
en: Reports the version of the GDAL library in use by PostGIS. Will also check and report if GDAL can find its data files.
fr: Retourne la version de la bibliothèque GDAL utilisée par PostGIS. Vérifie également si GDAL peut accéder à ses fichiers de données et reportera une erreur si ce n'est pas le cas.

note: Tag: refpurpose
en: Reports full raster library build date.
fr: Retourne la date de compilation de la bibliothèque raster.

note: Tag: para
en: Reports raster build date
fr: Retourne la date de compilation de la bibliothèque raster

note: Tag: refpurpose
en: <refpurpose>Reports full raster version and build configuration infos.</refpurpose>
fr: <refpurpose>Retourne la version complète de la bibliothèque raster et les informations sur la configuration de la compilation.</refpurpose>

note: Tag: para
en: <para>Reports full raster version and build configuration infos.</para>
fr: <para>Retourne la version complète de la bibliothèque raster et les informations sur la configuration de la compilation.</para>

note: Tag: refpurpose
en: Returns a list of raster formats supported by PostGIS through GDAL. Only those formats with can_write=True can be used by ST_AsGDALRaster
fr: Retourne la liste des formats raster supportés par PostGIS via GDAL. Seuls les formats avec can_write=True peuvent être utilisés par ST_AsGDALRaster

note: Tag: para
en: Returns a list of raster formats short_name,long_name and creator options of each format supported by GDAL. Use the short_name as input in the <varname>format</varname> parameter of <xref linkend="RT_ST_AsGDALRaster"/>. Options vary depending on what drivers your libgdal was compiled with. <varname>create_options</varname> returns an xml formatted set of CreationOptionList/Option consisting of name and optional <varname>type</varname>, <varname>description</varname> and set of <varname>VALUE</varname> for each creator option for the specific driver.
fr: Retourne la liste des formats raster supportés par GDAL, sous forme short_name, long_name et creator. Vous pouvez utiliser short_name comme paramètre <varname>format</varname> pour <xref linkend="RT_ST_AsGDALRaster"/>. Les options peuvent varier selon les drivers compilés dans votre bibliothèque libgdal. <varname>create_options</varname> retourne un XML contenant un ensemble de CreationOptionList/Option avec comme attribut name et comme attributs optionnels <varname>type</varname> et <varname>description</varname>, ainsi qu'un ensemble de <varname>VALUE</varname> pour chaque option de création pour ce driver.

note: Tag: para
en: Changed: 2.5.0 - add can_read and can_write columns.
fr: Changement : 2.5.0 - ajout des colonnes can_read et can_write.

note: Tag: para
en: Changed: 2.0.6, 2.1.3 - by default no drivers are enabled, unless GUC or Environment variable gdal_enabled_drivers is set.
fr: Changement : 2.0.6, 2.1.3 - aucun driver n'est activé par défaut, sauf si la variable GUC ou d'environnement gdal_enabled_drivers est définie.

note: Tag: para
en: Availability: 2.0.0 - requires GDAL &gt;= 1.6.0.
fr: Disponibilité : 2.0.0 - nécessite GDAL &gt;= 1.6.0.

note: Tag: title
en: Examples: List of Drivers
fr: Exemples : Liste des drivers

note: Tag: title
en: Example: List of options for each driver
fr: Exemple : Liste des options pour chaque driver

note: Tag: refpurpose
en: <refpurpose>Generates a set of vector contours from the provided raster band, using the <link xlink:href="https://gdal.org/api/gdal_alg.html?highlight=contour#_CPPv421GDALContourGenerateEx15GDALRasterBandHPv12CSLConstList16GDALProgressFuncPv">GDAL contouring algorithm</link>.</refpurpose>
fr: <refpurpose>Génère un ensemble de courbes de niveau vectorielles depuis la bande raster spécifiée, en utilisant <link xlink:href="https://gdal.org/api/gdal_alg.html?highlight=contour#_CPPv421GDALContourGenerateEx15GDALRasterBandHPv12CSLConstList16GDALProgressFuncPv">l'algorithme de contour GDAL</link>.</refpurpose>

note: Tag: para
en: <para>Generates a set of vector contours from the provided raster band, using the <link xlink:href="https://gdal.org/api/gdal_alg.html?highlight=contour#_CPPv421GDALContourGenerateEx15GDALRasterBandHPv12CSLConstList16GDALProgressFuncPv">GDAL contouring algorithm</link>.</para>
fr: <para>Génère un ensemble de courbes de niveau vectorielles depuis la bande raster spécifiée, en utilisant <link xlink:href="https://gdal.org/api/gdal_alg.html?highlight=contour#_CPPv421GDALContourGenerateEx15GDALRasterBandHPv12CSLConstList16GDALProgressFuncPv">l'algorithme de contour GDAL</link>.</para>

note: Tag: para
en: When the <varname>fixed_levels</varname> parameter is a non-empty array, the <varname>level_interval</varname> and <varname>level_base</varname> parameters are ignored.
fr: Si le paramètre <varname>fixed_levels</varname> est un tableau non vide, les paramètres <varname>level_interval</varname> et <varname>level_base</varname> sont ignorés.

note: Tag: para
en: Input parameters are:
fr: Les paramètres d'entrée sont :

note: Tag: para
en: The raster to generate the contour of
fr: Le raster pour générer le contour de

note: Tag: para
en: The band to generate the contour of
fr: La bande pour générer le contour de

note: Tag: para
en: The elevation interval between contours generated
fr: Intervalle d'élévation entre les courbes de niveau générées

note: Tag: para
en: The "base" relative to which contour intervals are applied, this is normally zero, but could be different. To generate 10m contours at 5, 15, 25, ... the LEVEL_BASE would be 5.
fr: La "base" par rapport à laquelle les intervalles de contour sont appliqués ; elle est normalement égale à zéro, mais peut être différente. Pour générer des courbes de niveau de 10 m à 5, 15, 25, ... le LEVEL_BASE serait de 5.

note: Tag: para
en: If <literal>true</literal>, contour polygons will be created, rather than polygon lines.
fr: Si <literal>true</literal>, des polygones de contour seront créés, plutôt que des lignes de polygone.

note: Tag: para
en: Return values are a set of records with the following attributes:
fr: La valeur de retour est un ensemble de résultats avec les attributs suivants :

note: Tag: para
en: The geometry of the contour line.
fr: La géométrie de la ligne de contour.

note: Tag: para
en: A unique identifier given to the contour line by GDAL.
fr: Un identifiant unique de la ligne de contour, déterminée par GDAL.

note: Tag: para
en: The raster value the line represents. For an elevation DEM input, this would be the elevation of the output contour.
fr: La valeur raster représentée par la ligne. Pour un modèle numérique de terrain, la valeur correspond à l'élévation du contour.

note: Tag: refpurpose
en: Interpolates a gridded surface based on an input set of 3-d points, using the X- and Y-values to position the points on the grid and the Z-value of the points as the surface elevation.
fr: Interpole une surface quadrillée à partir d'un ensemble de points 3-d, en utilisant les coordonnées X et Y des points sur la grille et la coordonnée Z des points pour l'élévation des points.

note: Tag: para
en: Interpolates a gridded surface based on an input set of 3-d points, using the X- and Y-values to position the points on the grid and the Z-value of the points as the surface elevation. There are five interpolation algorithms available: inverse distance, inverse distance nearest-neighbor, moving average, nearest neighbor, and linear interpolation. See the <link xlink:href="https://gdal.org/programs/gdal_grid.html#interpolation-algorithms">gdal_grid documentation</link> for more details on the algorithms and their parameters. For more information on how interpolations are calculated, see the <link xlink:href="https://gdal.org/tutorials/gdal_grid_tut.html">GDAL grid tutorial</link>.
fr: Interpole une surface quadrillée à partir d'un ensemble de points 3-d, en utilisant les coordonnées X et Y des points sur la grille et la coordonnée Z des points pour l'élévation des points. 5 algorithmes d'interpolations sont disponibles : inverse de la distance, inverse de la distance avec plus proche voisin, moyenne mobile, plus proche voisin, et interpolation linéaire. Voir <link xlink:href="https://gdal.org/programs/gdal_grid.html#interpolation-algorithms">gdal_grid documentation</link> pour plus de détails sur ces algorithmes et leurs paramètres. Pour plus d'informations sur le calcul des interpolations, voir le <link xlink:href="https://gdal.org/tutorials/gdal_grid_tut.html">tutorial GDAL grid</link>.

note: Tag: para
en: The points to drive the interpolation. Any geometry with Z-values is acceptable, all points in the input will be used.
fr: Les points pour effectuer l'interpolation. Toute géometrie avec une dimension Z est acceptée ; tous les points de la géométrie seront utilisés.

note: Tag: para
en: A string defining the algorithm and algorithm options, in the format used by <link xlink:href="https://gdal.org/programs/gdal_grid.html#interpolation-algorithms">gdal_grid</link>. For example, for an inverse-distance interpolation with a smoothing of 2, you would use "invdist:smoothing=2.0"
fr: Une chaîne définissant l'algorithme et ses options, au format utilisable par <link xlink:href="https://gdal.org/programs/gdal_grid.html#interpolation-algorithms">gdal_grid</link>. Par exemple, pour une interpolation en inverse de la distance avec un lissage de 2, la valeur sera "invdist:smoothing=2.0"

note: Tag: para
en: A raster template to drive the geometry of the output raster. The width, height, pixel size, spatial extent and pixel type will be read from this template.
fr: Un gabarit raster pour la création du raster de sortie. Les largeur, hauteur, taille des pixels, étendue spatiale et type des pixels seront définis à partir de ce gabarit.

note: Tag: para
en: By default the first band in the template raster is used to drive the output raster, but that can be adjusted with this parameter.
fr: Indice de la bande raster du gabarit raster à utiliser ; par défaut, la première bande sera utilisée.

note: Tag: refpurpose
en: Change the SRID of all rasters in the user-specified column and table.
fr: Change le SRID de tous les rasters dans la table et colonne en paramètres.

note: Tag: para
en: Change the SRID of all rasters in the user-specified column and table. The function will drop all appropriate column constraints (extent, alignment and SRID) before changing the SRID of the specified column's rasters.
fr: Change le SRID de tous les rasters dans la table et colonne en paramètres. Cette fonction supprimera toutes les contraintes nécessaires (étendue, alignement et SRID) avant de changer le SRID de la colonne raster.

note: Tag: para
en: The data (band pixel values) of the rasters are not touched by this function. Only the raster's metadata is changed.
fr: Les données (les valeurs des pixels) des rasters ne sont pas changées par cette fonction. Seules les métadonnées du rasters sont modifiées.

note: Tag: refpurpose
en: Create an reduced resolution version of a given raster coverage.
fr: Créé une version à plus faible résolution d'une colonne raster.

note: Tag: para
en: Create an overview table with resampled tiles from the source table. Output tiles will have the same size of input tiles and cover the same spatial extent with a lower resolution (pixel size will be 1/<varname>factor</varname> of the original in both directions).
fr: Créé une table d'aperçu avec les tuiles rééchantillonnées depuis la table source. Les tuiles de sortie auront la même taille que les tuiles d'entrées et couvriront la même étendue, mais avec une résolution plus faible (la taille d'un pixel sera 1/<varname>factor</varname> dans les deux directions).

note: Tag: para
en: The overview table will be made available in the <varname>raster_overviews</varname> catalog and will have raster constraints enforced.
fr: La table d'aperçu sera disponible dans le catalogue <varname>raster_overviews</varname> avec les contraintes rasters ajoutées.

note: Tag: para
en: Algorithm options are: 'NearestNeighbor', 'Bilinear', 'Cubic', 'CubicSpline', and 'Lanczos'. Refer to: <link xlink:href="http://www.gdal.org/gdalwarp.html">GDAL Warp resampling methods</link> for more details.
fr: Les algorithmes disponibles sont : 'NearestNeighbor' (plus proche voisin), 'Bilinear' (Bilinéaire), 'Cubic' (Cubique), 'CubicSpline' (Cubique Spline) et 'Lanczos'. Voir <link xlink:href="http://www.gdal.org/gdalwarp.html">GDAL Warp resampling methods</link> pour plus de détails.

note: Tag: para
en: Output to generally better quality but slower to product format
fr: Sortie de meilleure qualité en général, mais plus lent à générer

note: Tag: para
en: Output to faster to process default nearest neighbor
fr: Sortie plus rapide, via la méthode de plus proche voisin

note: Tag: title
en: Raster Constructors
fr: Constructeurs de raster

note: Tag: refpurpose
en: Returns a raster with the new band(s) of given type added with given initial value in the given index location. If no index is specified, the band is added to the end.
fr: Retourne un raster avec la/les nouvelle(s) bande(s) ajouté(s) à un index donné, de type et valeur initiale donnés. Si aucun index n'est spécifié, la bande est ajoutée à la fin.

note: Tag: para
en: Returns a raster with a new band added in given position (index), of given type, of given initial value, and of given nodata value. If no index is specified, the band is added to the end. If no <varname>fromband</varname> is specified, band 1 is assumed. Pixel type is a string representation of one of the pixel types specified in <xref linkend="RT_ST_BandPixelType"/>. If an existing index is specified all subsequent bands &gt;= that index are incremented by 1. If an initial value greater than the max of the pixel type is specified, then the initial value is set to the highest value allowed by the pixel type.
fr: Renvoie un raster avec une nouvelle bande ajoutée à la position donnée (index), du type donné, de la valeur initiale donnée et de la valeur de nodata donnée. Si aucun index n'est spécifié, la bande est ajoutée à la fin. Si aucun <varname>fromband</varname> n'est spécifié, la bande 1 est supposée. Le type de pixel est une représentation sous forme de chaîne de l'un des types de pixels spécifiés dans <xref linkend="RT_ST_BandPixelType"/>. Si un index existant est spécifié, toutes les bandes suivantes &gt;= cet index sont incrémentées de 1. Si une valeur initiale supérieure à la valeur maximale du type de pixel est spécifiée, la valeur initiale est fixée à la valeur la plus élevée autorisée par le type de pixel.

note: Tag: para
en: For the variant that takes an array of <xref linkend="addbandarg"/> (Variant 1), a specific addbandarg's index value is relative to the raster at the time when the band described by that addbandarg is being added to the raster. See the Multiple New Bands example below.
fr: Pour la variante acceptant un tableau de <xref linkend="addbandarg"/> en paramètre (Variante 1), un index spécifique au paramètre addbandarg est relative au raster au moment où la bande décrite par ce paramètre addbandarg est ajoutée au raster. Voir l'exemple Multiples nouvelles bandes ci-dessous.

note: Tag: para
en: For the variant that takes an array of rasters (Variant 5), if <varname>torast</varname> is NULL then the <varname>fromband</varname> band of each raster in the array is accumulated into a new raster.
fr: Pour la variante acceptant un tableau de rasters (Variante 5), si <varname>torast</varname> est NULL, alors la bande <varname>fromband</varname> de chaque raster est accumulée dans le nouveau raster.

note: Tag: para
en: For the variants that take <varname>outdbfile</varname> (Variants 6 and 7), the value must include the full path to the raster file. The file must also be accessible to the postgres server process.
fr: Pour les variantes acceptant un paramètre <varname>outdbfile</varname> (Variantes 6 et 7), la valeur doit correspondre au chemin complet vers le fichier raster. Ce fichier doit être accessible par le processus du serveur postgres.

note: Tag: para
en: Enhanced: 2.1.0 support for addbandarg added.
fr: Amélioration : 2.1.0 ajout du paramètre addbandarg.

note: Tag: para
en: Enhanced: 2.1.0 support for new out-db bands added.
fr: Amélioration : 2.1.0 introduction du support des bandes out-db.

note: Tag: title
en: Examples: Single New Band
fr: Exemples : Nouvelle bande

note: Tag: title
en: Examples: Multiple New Bands
fr: Exemples : Multiples nouvelles bandes

note: Tag: title
en: Examples: New Out-db band
fr: Exemples : Nouvelle bande Out-db

note: Tag: refpurpose
en: Converts a PostGIS geometry to a PostGIS raster.
fr: Convertit une géométrie PostGIS en un raster PostGIS.

note: Tag: para
en: Converts a PostGIS geometry to a PostGIS raster. The many variants offers three groups of possibilities for setting the alignment and pixelsize of the resulting raster.
fr: Convertit une géométrie PostGIS en un raster PostGIS. Les nombreuses variantes permettent trois groupes de possibilités pour définir l'alignement et la taille des pixels du raster en sortie.

note: Tag: para
en: The first group, composed of the two first variants, produce a raster having the same alignment (<varname>scalex</varname>, <varname>scaley</varname>, <varname>gridx</varname> and <varname>gridy</varname>), pixel type and nodata value as the provided reference raster. You generally pass this reference raster by joining the table containing the geometry with the table containing the reference raster.
fr: Le premier groupe, constitué des deux premières variantes, produit un raster avec le même alignement (<varname>scalex</varname>, <varname>scaley</varname>, <varname>gridx</varname> et <varname>gridy</varname>), le même type de pixels et la même valeur nodata que le raster donné en référence. En général, vous passerez cette référence en faisant une jointure entre la table contenant la géométrie avec la table contenant le raster de référence.

note: Tag: para
en: The second group, composed of four variants, let you set the dimensions of the raster by providing the parameters of a pixel size (<varname>scalex</varname> &amp; <varname>scaley</varname> and <varname>skewx</varname> &amp; <varname>skewy</varname>). The <varname>width</varname> &amp; <varname>height</varname> of the resulting raster will be adjusted to fit the extent of the geometry. In most cases, you must cast integer <varname>scalex</varname> &amp; <varname>scaley</varname> arguments to double precision so that PostgreSQL choose the right variant.
fr: Le second groupe, composé de quatre variantes, vous permettent de spécifier les dimensions du raster via les paramètres de taille de pixel (<varname>scalex</varname> &amp; <varname>scaley</varname> et <varname>skewx</varname> &amp; <varname>skewy</varname>). Les dimensions <varname>width</varname> &amp; <varname>height</varname> du raster résultant seront ajustés pour s'adapter à l'étendu de la géométrie. Dans la plupart des cas, vous devrez transtyper les paramètres <varname>scalex</varname> &amp; <varname>scaley</varname> de integer à double precision pour que PostgreSQL choisisse la variante correcte.

note: Tag: para
en: The third group, composed of four variants, let you fix the dimensions of the raster by providing the dimensions of the raster (<varname>width</varname> &amp; <varname>height</varname>). The parameters of the pixel size (<varname>scalex</varname> &amp; <varname>scaley</varname> and <varname>skewx</varname> &amp; <varname>skewy</varname>) of the resulting raster will be adjusted to fit the extent of the geometry.
fr: Le troisième groupe, composé de quatre variantes, vous permettent de spécifier les dimensions du raster directement (<varname>width</varname> &amp; <varname>height</varname>). Les paramètres de taille de pixel (<varname>scalex</varname> &amp; <varname>scaley</varname> et <varname>skewx</varname> &amp; <varname>skewy</varname>) du raster résultant seront ajustés pour s'adapter à l'étendue de la géométrie.

note: Tag: para
en: The two first variants of each of those two last groups let you specify the alignment with an arbitrary corner of the alignment grid (<varname>gridx</varname> &amp; <varname>gridy</varname>) and the two last variants takes the upper left corner (<varname>upperleftx</varname> &amp; <varname>upperlefty</varname>).
fr: Les deux premières variantes des deux derniers groupes vous permettent de spécifier l'alignement avec un coin arbitraire de la grille d'alignement (<varname>gridx</varname> &amp; <varname>gridy</varname>) et les deux dernières variantes via le coin haut-gauche (<varname>upperleftx</varname> &amp; <varname>upperlefty</varname>).

note: Tag: para
en: Each group of variant allows producing a one band raster or a multiple bands raster. To produce a multiple bands raster, you must provide an array of pixel types (<varname>pixeltype[]</varname>), an array of initial values (<varname>value</varname>) and an array of nodata values (<varname>nodataval</varname>). If not provided pixeltyped defaults to 8BUI, values to 1 and nodataval to 0.
fr: Chaque groupe de variantes permet de produire un raster à une ou plusieurs bandes. Pour plusieurs bandes, vous devez fournir un tableau de types de pixels (<varname>pixeltype[]</varname>), un tableau de valeurs initiales (<varname>value</varname>) et un tableau de valeurs nodata (<varname>nodataval</varname>). Si non fournis, pixeltype est par défaut à 8BUI, value à 1 et nodataval à 0.

note: Tag: para
en: The output raster will be in the same spatial reference as the source geometry. The only exception is for variants with a reference raster. In this case the resulting raster will get the same SRID as the reference raster.
fr: Le raster en sortie aura le même système de référence spatial que la géométrie source, sauf pour les variantes utilisant un raster de référence. Dans ce cas, le raster en sortie aura le même SRID que le raster de référence.

note: Tag: para
en: The optional <varname>touched</varname> parameter defaults to false and maps to the GDAL ALL_TOUCHED rasterization option, which determines if pixels touched by lines or polygons will be burned. Not just those on the line render path, or whose center point is within the polygon.
fr: Le paramètre optionnel <varname>touched</varname> est par défaut à false et correspond à l'option GDAL ALL_TOUCHED, qui détermine si les pixels touchés par des lignes ou polygones seront mis à jour, et pas seulement ceux sur le chemin de la ligne ou dont le point central est dans le polygone.

note: Tag: para
en: This is particularly useful for rendering jpegs and pngs of geometries directly from the database when using in combination with <xref linkend="RT_ST_AsPNG"/> and other <xref linkend="RT_ST_AsGDALRaster"/> family of functions.
fr: Ceci est particulièrement utile pour le rendu de JPEGs et de PNGs directement depuis la base de données en utilisant une combinaison de <xref linkend="RT_ST_AsPNG"/> et des fonctions de la famille de <xref linkend="RT_ST_AsGDALRaster"/>.

note: Tag: para
en: Not yet capable of rendering complex geometry types such as curves, TINS, and PolyhedralSurfaces, but should be able too once GDAL can.
fr: Pas encore en mesure de faire le rendu de géométries complexes comme les CURVES, TIN et PolyhedralSurfaces, mais cela devrait être le cas lorsque GDAL le supportera.

note: Tag: title
en: Examples: Output geometries as PNG files
fr: Exemples : Rendu de géométries en fichiers PNG

note: Tag: para
en: black circle
fr: cercle noir

note: Tag: para
en: example from buffer rendered with just PostGIS
fr: exemple d'un buffer rendu via PostGIS

note: Tag: refpurpose
en: Returns one or more bands of an existing raster as a new raster. Useful for building new rasters from existing rasters.
fr: Retourne une ou plusieurs bandes d'un raster existant en tant que nouveau raster. Utile pour construire de nouveaux rasters à partir de rasters existants.

note: Tag: para
en: Returns one or more bands of an existing raster as a new raster. Useful for building new rasters from existing rasters or export of only selected bands of a raster or rearranging the order of bands in a raster. If no band is specified or any of specified bands does not exist in the raster, then all bands are returned. Used as a helper function in various functions such as for deleting a band.
fr: Retourne une ou plusieurs bandes d'un raster existant en tant que nouveau raster. Utile pour construire de nouveaux rasters à partir de rasters existants ou pour exporter certaines bandes d'un raster, ou pour réarranger l'ordre des bandes d'un raster. Si aucune bande n'est spécifiée, ou si aucune des bandes spécifiées n'existent dans le raster, alors toutes les bandes sont retournées. Cette fonction est utilisée en interne par diverses fonctions, comme pour supprimer une bande.

note: Tag: para
en: For the <code>nbands</code> as text variant of function, the default delimiter is <code>,</code> which means you can ask for <code>'1,2,3'</code> and if you wanted to use a different delimiter you would do <code>ST_Band(rast, '1@2@3', '@')</code>. For asking for multiple bands, we strongly suggest you use the array form of this function e.g. <code>ST_Band(rast, '{1,2,3}'::int[]);</code> since the <code>text</code> list of bands form may be removed in future versions of PostGIS.
fr: Pour les variantes avec le paramètre <code>nbands</code> en texte, le délimiteur par défaut est <code>,</code>, il faut donc passer par exemple <code>'1,2,3'</code>. Pour utiliser un autre délimiteur, utilisez le paramètre delimiter : <code>ST_Band(rast, '1@2@3', '@')</code>. Néanmoins, pour utiliser plusieurs bandes, nous encourageons fortement d'utiliser la variante avec le paramètre de type tableau (e.g. <code>ST_Band(rast, '{1,2,3}'::int[]);</code>); la variante avec la liste de bandes en <code>text</code> peut être supprimée des prochaines versions de PostGIS.

note: Tag: para
en: original (column rast)
fr: originale (colonne rast)

note: Tag: refpurpose
en: Cover georeferenced area with a grid of empty raster tiles.
fr: Couvre une zone géo-référencée avec une grille raster de tuiles vides.

note: Tag: para
en: Create a set of raster tiles with <xref linkend="RT_ST_MakeEmptyRaster"/>. Grid dimension is <varname>width</varname> &amp; <varname>height</varname>. Tile dimension is <varname>tilewidth</varname> &amp; <varname>tileheight</varname>. The covered georeferenced area is from upper left corner (<varname>upperleftx</varname>, <varname>upperlefty</varname>) to lower right corner (<varname>upperleftx</varname> + <varname>width</varname> * <varname>scalex</varname>, <varname>upperlefty</varname> + <varname>height</varname> * <varname>scaley</varname>).
fr: Créé un ensemble de tuiles rasters via <xref linkend="RT_ST_MakeEmptyRaster"/>. La dimension de la grille est définie par <varname>width</varname> &amp; <varname>height</varname>. La dimension des tuiles est définie par <varname>tilewidth</varname> &amp; <varname>tileheight</varname>. La zone géo-référencée couverte démarre au coin supérieur gauche (<varname>upperleftx</varname>, <varname>upperlefty</varname>) jusqu'au coin inférieur droit (<varname>upperleftx</varname> + <varname>width</varname> * <varname>scalex</varname>, <varname>upperlefty</varname> + <varname>height</varname> * <varname>scaley</varname>).

note: Tag: para
en: Note that scaley is generally negative for rasters and scalex is generally positive. So lower right corner will have a lower y value and higher x value than the upper left corner.
fr: A noter que scaley est généralement négatif pour les rasters, alors que scalex est généralement positif. Le coin inférieur droit aura une valeur Y inférieure et une valeur X supérieure au coin supérieur gauche.

note: Tag: title
en: Examples Basic
fr: Exemples de base

note: Tag: para
en: Create 16 tiles in a 4x4 grid to cover the WGS84 area from upper left corner (22, 77) to lower right corner (55, 33).
fr: Créer 16 tuiles de 1x1px dans une grille 4x4 pour couvrir une zone WGS84 du coin supérieur gauche (22, 77) jusqu'au coin inférieur droit (55, 33).

note: Tag: refpurpose
en: Returns an empty raster (having no bands) of given dimensions (width &amp; height), upperleft X and Y, pixel size and rotation (scalex, scaley, skewx &amp; skewy) and reference system (srid). If a raster is passed in, returns a new raster with the same size, alignment and SRID. If srid is left out, the spatial ref is set to unknown (0).
fr: Retourne un raster vide (sans aucune bande) de dimension donnée (width &amp; height), de coin supérieur gauche à X et Y, de paramètres de taille de pixel données (scalex, scaley, skewx &amp; skewy) et de système de référence spatial (srid) donné. Si un raster est spécifié, retourne un nouveau raster de même taille, alignement et SRID. Si srid n'est pas spécifié, le système de référence spatial est défini à inconnu (0).

note: Tag: para
en: Returns an empty raster (having no band) of given dimensions (width &amp; height) and georeferenced in spatial (or world) coordinates with upper left X (upperleftx), upper left Y (upperlefty), pixel size and rotation (scalex, scaley, skewx &amp; skewy) and reference system (srid).
fr: Retourne un raster vide (sans aucune bande) de dimension donnée (width &amp; height), géo-référencé via le coin supérieur gauche (upperleftx &amp; upperlefty), via les paramètres de taille de pixel données (scalex, scaley, skewx &amp; skewy) et via le système de référence spatial (srid) donné.

note: Tag: para
en: The last version use a single parameter to specify the pixel size (pixelsize). scalex is set to this argument and scaley is set to the negative value of this argument. skewx and skewy are set to 0.
fr: La dernière variante utilise un seul paramètre pour spécifier la taille des pixels (pixelsize). scalex est défini à la valeur de ce paramètre et scaley est défini à la valeur négative de ce paramètre. skewx et skewy sont définis à 0.

note: Tag: para
en: If an existing raster is passed in, it returns a new raster with the same meta data settings (without the bands).
fr: Si un raster existant est spécifié, retourne un nouveau raster avec les mêmes métadonnées (sans aucune bande).

note: Tag: para
en: If no srid is specified it defaults to 0. After you create an empty raster you probably want to add bands to it and maybe edit it. Refer to <xref linkend="RT_ST_AddBand"/> to define bands and <xref linkend="RT_ST_SetValue"/> to set initial pixel values.
fr: Si aucun srid n'est spécifié, la valeur 0 est utilisée. Après avoir créé un raster vide, vous voudrez probablement ajouter des bandes ou l'éditer. Voir <xref linkend="RT_ST_AddBand"/> pour définir des bandes et <xref linkend="RT_ST_SetValue"/> pour initialiser des valeurs.

note: Tag: refpurpose
en: <refpurpose>Returns a set of rasters resulting from the split of the input raster based upon the desired dimensions of the output rasters.</refpurpose>
fr: <refpurpose>Retourne un ensemble de rasters issus de la division d'un raster d'entrée selon les dimensions spécifiées pour les rasters de sortie.</refpurpose>

note: Tag: para
en: <para>Returns a set of rasters resulting from the split of the input raster based upon the desired dimensions of the output rasters.</para>
fr: <para>Retourne un ensemble de rasters issus de la division d'un raster d'entrée selon les dimensions spécifiées pour les rasters de sortie.</para>

note: Tag: para
en: If <varname>padwithnodata</varname> = FALSE, edge tiles on the right and bottom sides of the raster may have different dimensions than the rest of the tiles. If <varname>padwithnodata</varname> = TRUE, all tiles will have the same dimensions with the possibility that edge tiles being padded with NODATA values. If raster band(s) do not have NODATA value(s) specified, one can be specified by setting <varname>nodataval</varname>.
fr: Si <varname>padwithnodata</varname> est FALSE, les tuiles des bords droits et bas peuvent avoir des dimensions différentes du reste des tuiles. Si <varname>padwithnodata</varname> est TRUE, toutes les tuiles auront les mêmes dimensions, potentiellement avec les tuiles des bords complétées par la valeur NODATA. Si la bande raster n'a pas de valeur NODATA définie, cette valeur peut être spécifiée via le paramètre <varname>nodataval</varname>.

note: Tag: para
en: If a specified band of the input raster is out-of-db, the corresponding band in the output rasters will also be out-of-db.
fr: Si une bande spécifiée du raster d'entrée est out-of-db, la bande correspondant dans les rasters de sortie sera aussi out-of-db.

note: Tag: refpurpose
en: Return a set of configured tiles from an arbitrarily tiled raster coverage.
fr: Retourne un ensemble de tuiles configurées à partir d'une couverture raster composée de tuiles arbitraires.

note: Tag: para
en: Return a set of tiles having the specified scale (<varname>sfx</varname>, <varname>sfy</varname>) and max size (<varname>tw</varname>, <varname>th</varname>) and covering the specified extent (<varname>ext</varname>) with data coming from the specified raster coverage (<varname>tab</varname>, <varname>col</varname>).
fr: Retourne un ensemble de tuiles ayant l'échelle spécifiée (<varname>sfx</varname>, <varname>sfy</varname>), de taille maximale (<varname>tw</varname>, <varname>th</varname>) et couvrant l'étendue spécifiée (<varname>ext</varname>), et avec les données provenant de la couverture raster spécifiée (<varname>tab</varname>, <varname>col</varname>).

note: Tag: refpurpose
en: Returns a raster from a supported GDAL raster file.
fr: Retourne un raster depuis un fichier raster supporté par GDAL.

note: Tag: para
en: Returns a raster from a supported GDAL raster file. <varname>gdaldata</varname> is of type bytea and should be the contents of the GDAL raster file.
fr: Retourne un raster depuis un fichier raster supporté par GDAL. Le paramètre <varname>gdaldata</varname> de type bytea est le contenu du fichier raster GDAL.

note: Tag: para
en: If <varname>srid</varname> is NULL, the function will try to automatically assign the SRID from the GDAL raster. If <varname>srid</varname> is provided, the value provided will override any automatically assigned SRID.
fr: Si <varname>srid</varname> est NULL, la fonction essaye de déterminer le SRID depuis le raster GDAL. Si <varname>srid</varname> est spécifié, la valeur spécifiée écrase tout SRID déterminé automatiquement.

note: Tag: title
en: Raster Accessors
fr: Fonctions d'accès aux rasters

note: Tag: refpurpose
en: Returns the georeference meta data in GDAL or ESRI format as commonly seen in a world file. Default is GDAL.
fr: Retourne les méta-données de géo-référencement au format GDAL (par défaut) ou ESRI, tel qu'utilisé généralement dans les fichiers world file.

note: Tag: para
en: Returns the georeference meta data including carriage return in GDAL or ESRI format as commonly seen in a <link xlink:href="http://en.wikipedia.org/wiki/World_file">world file</link>. Default is GDAL if no type specified. type is string 'GDAL' or 'ESRI'.
fr: Retourne les méta-données de géo-référencement au format GDAL ou ESRI, tel qu'utilisé généralement dans les fichiers <link xlink:href="https://fr.wikipedia.org/wiki/World_file">world file</link>. Si aucun type n'est spécifié, utilise le format GDAL par défaut. type est une chaîne 'GDAL' ou 'ESRI'.

note: Tag: para
en: Difference between format representations is as follows:
fr: La différence entre les représentations de format est la suivante :

note: Tag: para
en: <varname>GDAL</varname>:
fr: <varname>GDAL</varname> :

note: Tag: para
en: <varname>ESRI</varname>:
fr: <varname>ESRI</varname> :

note: Tag: refpurpose
en: Returns the height of the raster in pixels.
fr: Retourne la hauteur du raster en pixels.

note: Tag: para
en: Returns the height of the raster.
fr: Retourne la hauteur du raster en pixels.

note: Tag: refpurpose
en: <refpurpose>Returns true if the raster is empty (width = 0 and height = 0). Otherwise, returns false.</refpurpose>
fr: <refpurpose>Retourne true si le raster est vide (largeur = 0 et hauteur = 0). Sinon, retourne false.</refpurpose>

note: Tag: para
en: <para>Returns true if the raster is empty (width = 0 and height = 0). Otherwise, returns false.</para>
fr: <para>Retourne true si le raster est vide (largeur = 0 et hauteur = 0). Sinon, retourne false.</para>

note: Tag: refpurpose
en: <refpurpose>Returns the amount of space (in bytes) the raster takes.</refpurpose>
fr: <refpurpose>Retourne l'espace utilisé par le raster (en octets).</refpurpose>

note: Tag: para
en: <para>Returns the amount of space (in bytes) the raster takes.</para>
fr: <para>Retourne l'espace utilisé par le raster (en octets).</para>

note: Tag: para
en: This is a nice compliment to PostgreSQL built in functions pg_column_size, pg_size_pretty, pg_relation_size, pg_total_relation_size.
fr: Cette fonction est un bon complément aux fonctions PostgreSQL natives pg_column_size, pg_size_pretty, pg_relation_size, pg_total_relation_size.

note: Tag: para
en: pg_relation_size which gives the byte size of a table may return byte size lower than ST_MemSize. This is because pg_relation_size does not add toasted table contribution and large geometries are stored in TOAST tables. pg_column_size might return lower because it returns the compressed size.
fr: pg_relation_size qui donne la taille en octets d'une table peut renvoyer une taille en octets inférieure à ST_MemSize. Cela est dû au fait que pg_relation_size n'ajoute pas la contribution des tables toasted et que les grandes géométries sont stockées dans les tables TOAST. pg_column_size peut retourner une valeur inférieure parce qu'elle retourne la taille compressée.

note: Tag: refpurpose
en: Returns basic meta data about a raster object such as pixel size, rotation (skew), upper, lower left, etc.
fr: Retourne les méta-données de base de l'objet raster : taille des pixels, rotation, coin haut/bas gauche, etc.

note: Tag: para
en: Returns basic meta data about a raster object such as pixel size, rotation (skew), upper, lower left, etc. Columns returned: upperleftx | upperlefty | width | height | scalex | scaley | skewx | skewy | srid | numbands
fr: Retourne les méta-données de base de l'objet raster : taille des pixels, rotation, coin haut/bas gauche, etc. Les colonnes retournées sont : upperleftx | upperlefty | width | height | scalex | scaley | skewx | skewy | srid | numbands

note: Tag: refpurpose
en: <refpurpose>Returns the number of bands in the raster object.</refpurpose>
fr: <refpurpose>Retourne le nombre de bandes de l'objet raster.</refpurpose>

note: Tag: para
en: <para>Returns the number of bands in the raster object.</para>
fr: <para>Retourne le nombre de bandes de l'objet raster.</para>

note: Tag: refpurpose
en: Returns the pixel height in geometric units of the spatial reference system.
fr: Retourne la hauteur d'un pixel, dans l'unité du système de référence spatial.

note: Tag: para
en: Returns the height of a pixel in geometric units of the spatial reference system. In the common case where there is no skew, the pixel height is just the scale ratio between geometric coordinates and raster pixels.
fr: Retourne la hauteur d'un pixel, dans l'unité du système de référence spatial. Dans le cas général où il n'y a pas d'obliquité (skew), la hauteur d'un pixel est simplement l'échelle entre les coordonnées géométriques et les pixels rasters.

note: Tag: para
en: Refer to <xref linkend="RT_ST_PixelWidth"/> for a diagrammatic visualization of the relationship.
fr: Voir <xref linkend="RT_ST_PixelWidth"/> pour une représentation schématique de la relation.

note: Tag: title
en: Examples: Rasters with no skew
fr: Exemples : Rasters sans obliquité (skew)

note: Tag: title
en: Examples: Rasters with skew different than 0
fr: Exemples : Rasters avec obliquité (skew) différent de 0

note: Tag: refpurpose
en: Returns the pixel width in geometric units of the spatial reference system.
fr: Retourne la largeur d'un pixel, dans l'unité du système de référence spatial.

note: Tag: para
en: Returns the width of a pixel in geometric units of the spatial reference system. In the common case where there is no skew, the pixel width is just the scale ratio between geometric coordinates and raster pixels.
fr: Retourne la largeur d'un pixel, dans l'unité du système de référence spatial. Dans le cas général où il n'y a pas d'obliquité (skew), la largeur d'un pixel est simplement l'échelle entre les coordonnées géométriques et les pixels rasters.

note: Tag: para
en: The following diagram demonstrates the relationship:
fr: Le diagramme suivant illustre cette relation :

note: Tag: para
en: Pixel Height: Pixel size in the j direction
fr: Hauteur du pixel : taille du pixel dans la direction j

note: Tag: para
en: Pixel Width: Pixel size in the i direction
fr: Largeur du pixel : taille du pixel dans la direction i

note: Tag: refpurpose
en: Returns the X component of the pixel width in units of coordinate reference system.
fr: Renvoie la composante X de la largeur du pixel dans l'unité du système de référence spatial.

note: Tag: para
en: Returns the X component of the pixel width in units of coordinate reference system. Refer to <link xlink:href="http://en.wikipedia.org/wiki/World_file">World File</link> for more details.
fr: Renvoie la composante X de la largeur du pixel dans l'unité du système de référence spatial. Voir <link xlink:href="https://fr.wikipedia.org/wiki/World_file">World File</link> pour plus de détails.

note: Tag: para
en: Changed: 2.0.0. In WKTRaster versions this was called ST_PixelSizeX.
fr: Changement : 2.0.0. Dans les versions WKTRaster, cette fonction était appelée ST_PixelSizeX.

note: Tag: refpurpose
en: Returns the Y component of the pixel height in units of coordinate reference system.
fr: Renvoie la composante Y de la hauteur du pixel dans l'unité du système de référence spatial.

note: Tag: para
en: Returns the Y component of the pixel height in units of coordinate reference system. May be negative. Refer to <link xlink:href="http://en.wikipedia.org/wiki/World_file">World File</link> for more details.
fr: Renvoie la composante Y de la hauteur du pixel dans l'unité du système de référence spatial. Peut être négative. Voir <link xlink:href="https://fr.wikipedia.org/wiki/World_file">World File</link> pour plus de détails.

note: Tag: para
en: Changed: 2.0.0. In WKTRaster versions this was called ST_PixelSizeY.
fr: Changement : 2.0.0. Dans les versions WKTRaster, cette fonction était appelée ST_PixelSizeY.

note: Tag: refpurpose
en: Returns the raster's upper left corner as geometric X and Y (longitude and latitude) given a column and row. Column and row starts at 1.
fr: Retourne le coin supérieur gauche du raster, sous forme de coordonnées X et Y (longitude et latitude) d'un colonne et d'une ligne. Les numéros de colonne et de ligne commencent à 1.

note: Tag: para
en: Returns the upper left corner as geometric X and Y (longitude and latitude) given a column and row. Returned X and Y are in geometric units of the georeferenced raster. Numbering of column and row starts at 1 but if either parameter is passed a zero, a negative number or a number greater than the respective dimension of the raster, it will return coordinates outside of the raster assuming the raster's grid is applicable outside the raster's bounds.
fr: Retourne le coin supérieur gauche du raster, sous forme de coordonnées X et Y (longitude et latitude) d'un colonne et d'une ligne. Les valeurs X et Y retournées sont dans l'unité du système de référence spatial du raster géo-référencé. Les numéros de colonne et de ligne commencent à 1, mais si l'un des deux paramètres est 0, un nombre négatif ou supérieur à la dimension du raster, la fonction retourne des coordonnées en dehors du raster, en supposant que la grille du raster est applicable en dehors de son étendue.

note: Tag: refpurpose
en: Returns the geometric X coordinate upper left of a raster, column and row. Numbering of columns and rows starts at 1.
fr: Retourne la coordonnée X du coin supérieur gauche du raster à column et row. Les numéros de colonne et de ligne commencent à 1.

note: Tag: para
en: Returns the upper left X coordinate of a raster column row in geometric units of the georeferenced raster. Numbering of columns and rows starts at 1 but if you pass in a negative number or number higher than number of columns in raster, it will give you coordinates outside of the raster file to left or right with the assumption that the skew and pixel sizes are same as selected raster.
fr: Retourne la coordonnée X du coin supérieur gauche du raster à column et row dans l'unité du système de référence spatial du raster géo-référencé. Les numéros de colonne et de ligne commencent à 1, mais si l'un des deux paramètres est 0, un nombre négatif ou supérieur à la dimension du raster, la fonction retourne des coordonnées en dehors du raster, en supposant que la grille du raster est applicable en dehors de son étendue (même taille de pixel et skew).

note: Tag: para
en: For non-skewed rasters, providing the X column is sufficient. For skewed rasters, the georeferenced coordinate is a function of the ST_ScaleX and ST_SkewX and row and column. An error will be raised if you give just the X column for a skewed raster.
fr: Pour des rasters sans obliquité (skew), fournir le numéro de colonne X est suffisant. Pour des rasters avec obliquité, les coordonnées géo-référencées sont fonction de ST_ScaleX et ST_SkewX et de la ligne et colonne. Une erreur sera émise si seulement la colonne X est fournie pour une raster avec obliquité.

note: Tag: para
en: Changed: 2.1.0 In prior versions, this was called ST_Raster2WorldCoordX
fr: Changement : 2.1.0 Jusqu'à la version 2.0.x, cette fonction était appelée ST_Raster2WorldCoordX

note: Tag: refpurpose
en: Returns the geometric Y coordinate upper left corner of a raster, column and row. Numbering of columns and rows starts at 1.
fr: Retourne la coordonnée Y du coin supérieur gauche du raster à column et row. Les numéros de colonne et de ligne commencent à 1.

note: Tag: para
en: Returns the upper left Y coordinate of a raster column row in geometric units of the georeferenced raster. Numbering of columns and rows starts at 1 but if you pass in a negative number or number higher than number of columns/rows in raster, it will give you coordinates outside of the raster file to left or right with the assumption that the skew and pixel sizes are same as selected raster tile.
fr: Retourne la coordonnée Y du coin supérieur gauche du raster à column et row dans l'unité du système de référence spatial du raster géo-référencé. Les numéros de colonne et de ligne commencent à 1, mais si l'un des deux paramètres est 0, un nombre négatif ou supérieur à la dimension du raster, la fonction retourne des coordonnées en dehors du raster, en supposant que la grille du raster est applicable en dehors de son étendue (même taille de pixel et skew).

note: Tag: para
en: For non-skewed rasters, providing the Y column is sufficient. For skewed rasters, the georeferenced coordinate is a function of the ST_ScaleY and ST_SkewY and row and column. An error will be raised if you give just the Y row for a skewed raster.
fr: Pour des rasters sans obliquité (skew), fournir le numéro de ligne Y est suffisant. Pour des rasters avec obliquité, les coordonnées géo-référencées sont fonction de ST_ScaleY et ST_SkewY et de la ligne et colonne. Une erreur sera émise si seulement la ligne Y est fournie pour une raster avec obliquité.

note: Tag: para
en: Changed: 2.1.0 In prior versions, this was called ST_Raster2WorldCoordY
fr: Changement : 2.1.0 Jusqu'à la version 2.0.x, cette fonction était appelée ST_Raster2WorldCoordY

note: Tag: refpurpose
en: Returns the rotation of the raster in radian.
fr: Retourne l'angle de rotation du raster en radians.

note: Tag: para
en: Returns the uniform rotation of the raster in radian. If a raster does not have uniform rotation, NaN is returned. Refer to <link xlink:href="http://en.wikipedia.org/wiki/World_file">World File</link> for more details.
fr: Retourne la rotation uniforme du raster en radians. Si le raster n'a pas de rotation uniforme, retourne NaN. Voir <link xlink:href="https://fr.wikipedia.org/wiki/World_file">World File</link> pour plus de détails.

note: Tag: refpurpose
en: Returns the georeference X skew (or rotation parameter).
fr: Retourne l'obliquité géo-référencée X (paramètre de rotation).

note: Tag: para
en: Returns the georeference X skew (or rotation parameter). Refer to <link xlink:href="http://en.wikipedia.org/wiki/World_file">World File</link> for more details.
fr: Retourne l'obliquité géo-référencée X (paramètre de rotation). Voir <link xlink:href="https://fr.wikipedia.org/wiki/World_file">World File</link> pour plus de détails.

note: Tag: refpurpose
en: Returns the georeference Y skew (or rotation parameter).
fr: Retourne l'obliquité géo-référencée Y (paramètre de rotation).

note: Tag: para
en: Returns the georeference Y skew (or rotation parameter). Refer to <link xlink:href="http://en.wikipedia.org/wiki/World_file">World File</link> for more details.
fr: Retourne l'obliquité géo-référencée Y (paramètre de rotation). Voir <link xlink:href="https://fr.wikipedia.org/wiki/World_file">World File</link> pour plus de détails.

note: Tag: refpurpose
en: Returns the spatial reference identifier of the raster as defined in spatial_ref_sys table.
fr: Retourne l'identifiant du système de référence spatial du raster, tel que défini dans la table spatial_ref_sys.

note: Tag: para
en: Returns the spatial reference identifier of the raster object as defined in the spatial_ref_sys table.
fr: Retourne l'identifiant du système de référence spatial du raster, tel que défini dans la table spatial_ref_sys.

note: Tag: para
en: From PostGIS 2.0+ the srid of a non-georeferenced raster/geometry is 0 instead of the prior -1.
fr: À partir de PostGIS 2.0+, le SRID d'un raster ou d'une géométrie non-géo-référencée est 0 au lieu de -1 précédemment.

note: Tag: refpurpose
en: <refpurpose>Returns a text summary of the contents of the raster.</refpurpose>
fr: <refpurpose>Retourne un résumé du contenu du raster sous forme de texte.</refpurpose>

note: Tag: para
en: <para>Returns a text summary of the contents of the raster.</para>
fr: <para>Retourne un résumé du contenu du raster sous forme de texte.</para>

note: Tag: refpurpose
en: <refpurpose>Returns the upper left X coordinate of raster in projected spatial ref.</refpurpose>
fr: <refpurpose>Retourne la coordonnée X du coin supérieur gauche du raster projeté dans le système de référence spatial.</refpurpose>

note: Tag: para
en: <para>Returns the upper left X coordinate of raster in projected spatial ref.</para>
fr: <para>Retourne la coordonnée X du coin supérieur gauche du raster projeté dans le système de référence spatial.</para>

note: Tag: refpurpose
en: <refpurpose>Returns the upper left Y coordinate of raster in projected spatial ref.</refpurpose>
fr: <refpurpose>Retourne la coordonnée Y du coin supérieur gauche du raster projeté dans le système de référence spatial.</refpurpose>

note: Tag: para
en: <para>Returns the upper left Y coordinate of raster in projected spatial ref.</para>
fr: <para>Retourne la coordonnée Y du coin supérieur gauche du raster projeté dans le système de référence spatial.</para>

note: Tag: refpurpose
en: <refpurpose>Returns the width of the raster in pixels.</refpurpose>
fr: <refpurpose>Retourne la largeur du raster en pixels.</refpurpose>

note: Tag: para
en: <para>Returns the width of the raster in pixels.</para>
fr: <para>Retourne la largeur du raster en pixels.</para>

note: Tag: refpurpose
en: Returns the upper left corner as column and row given geometric X and Y (longitude and latitude) or a point geometry expressed in the spatial reference coordinate system of the raster.
fr: Retourne le coin supérieur gauche comme colonne et ligne, en fonction de coordonnées géométriques X et Y (longitude et latitude) ou un point géométrique dans le système de référence spatial du raster.

note: Tag: para
en: Returns the upper left corner as column and row given geometric X and Y (longitude and latitude) or a point geometry. This function works regardless of whether or not the geometric X and Y or point geometry is outside the extent of the raster. Geometric X and Y must be expressed in the spatial reference coordinate system of the raster.
fr: Retourne le coin supérieur gauche comme colonne et ligne, en fonction de coordonnées géométriques X et Y (longitude et latitude) ou un point géométrique. Cette fonction fonctionne aussi bien si X et Y ou le point sont dans l'étendue du raster ou non. Les coordonnées géométriques X et Y ou les coordonnées du point doivent être dans le système de référence spatial du raster.

note: Tag: refpurpose
en: Returns the column in the raster of the point geometry (pt) or a X and Y world coordinate (xw, yw) represented in world spatial reference system of raster.
fr: Retourne la colonne dans le raster du point géométrique (pt) ou des coordonnées X et Y (xw, yw) exprimés dans le système de référence spatial du raster.

note: Tag: para
en: Returns the column in the raster of the point geometry (pt) or a X and Y world coordinate (xw, yw). A point, or (both xw and yw world coordinates are required if a raster is skewed). If a raster is not skewed then xw is sufficient. World coordinates are in the spatial reference coordinate system of the raster.
fr: Retourne la colonne dans le raster du point géométrique (pt) ou des coordonnées X et Y (xw, yw). Un point, ou le couple (xw, yw) sont requis pour un raster avec obliquité (skew). Sinon, xw est suffisant. Les coordonnées sont exprimées dans le système de référence spatial du raster.

note: Tag: para
en: Changed: 2.1.0 In prior versions, this was called ST_World2RasterCoordX
fr: Changement : 2.1.0 Dans les versions précédentes, cette fonctionne était appelée ST_World2RasterCoordX

note: Tag: refpurpose
en: Returns the row in the raster of the point geometry (pt) or a X and Y world coordinate (xw, yw) represented in world spatial reference system of raster.
fr: Retourne la ligne dans le raster du point géométrique (pt) ou des coordonnées X et Y (xw, yw) exprimés dans le système de référence spatial du raster.

note: Tag: para
en: Returns the row in the raster of the point geometry (pt) or a X and Y world coordinate (xw, yw). A point, or (both xw and yw world coordinates are required if a raster is skewed). If a raster is not skewed then xw is sufficient. World coordinates are in the spatial reference coordinate system of the raster.
fr: Retourne la ligne dans le raster du point géométrique (pt) ou des coordonnées X et Y (xw, yw). Un point, ou le couple (xw, yw) sont requis pour un raster avec obliquité (skew). Sinon, xw est suffisant. Les coordonnées sont exprimées dans le système de référence spatial du raster.

note: Tag: para
en: Changed: 2.1.0 In prior versions, this was called ST_World2RasterCoordY
fr: Changement : 2.1.0 Dans les versions précédentes, cette fonctionne était appelée ST_World2RasterCoordY

note: Tag: title
en: Raster Band Accessors
fr: Fonctions d'accès aux bandes raster

note: Tag: refpurpose
en: Returns basic meta data for a specific raster band. band num 1 is assumed if none-specified.
fr: Retourne les méta-données de base d'une bande raster spécifique. Si aucune bande n'est spécifiée, la bande 1 est utilisée.

note: Tag: para
en: Returns basic meta data about a raster band. Columns returned: pixeltype, nodatavalue, isoutdb, path, outdbbandnum, filesize, filetimestamp.
fr: Retourne les méta-données de base d'une bande raster spécifique. Les colonnes retournées sont : pixeltype, nodatavalue, isoutdb, path, outdbbandnum, filesize, filetimestamp.

note: Tag: para
en: If raster contains no bands then an error is thrown.
fr: Si le raster ne contient aucune bande, une erreur est émise.

note: Tag: para
en: If band has no NODATA value, nodatavalue are NULL.
fr: Si la bande n'a pas de valeur NODATA, nodatavalue est NULL.

note: Tag: para
en: If isoutdb is False, path, outdbbandnum, filesize and filetimestamp are NULL. If outdb access is disabled, filesize and filetimestamp will also be NULL.
fr: Si isoutdb est False, alors path, outdbbandnum, filesize et filetimestamp sont NULL. Si l'accès outdb est désactivé, filesize et filetimestamp sont également NULL.

note: Tag: para
en: Enhanced: 2.5.0 to include <emphasis>outdbbandnum</emphasis>, <emphasis>filesize</emphasis> and <emphasis>filetimestamp</emphasis> for outdb rasters.
fr: Amélioration : 2.5.0 ajout de <emphasis>outdbbandnum</emphasis>, <emphasis>filesize</emphasis> et <emphasis>filetimestamp</emphasis> pour les rasters outdb.

note: Tag: title
en: Examples: Variant 1
fr: Exemples : Variante 1

note: Tag: title
en: Examples: Variant 2
fr: Exemples : Variante 2

note: Tag: refpurpose
en: Returns the value in a given band that represents no data. If no band num 1 is assumed.
fr: Retourne la valeur qui représente l'absence de valeur (nodata) pour cette bande. Si aucune bande n'est spécifiée, la bande 1 est utilisée.

note: Tag: para
en: Returns the value that represents no data for the band
fr: Retourne la valeur qui représente l'absence de valeur (nodata) pour cette bande

note: Tag: refpurpose
en: Returns true if the band is filled with only nodata values.
fr: Retourne true si la bande ne contient que des valeurs nodata.

note: Tag: para
en: Returns true if the band is filled with only nodata values. Band 1 is assumed if not specified. If the last argument is TRUE, the entire band is checked pixel by pixel. Otherwise, the function simply returns the value of the isnodata flag for the band. The default value for this parameter is FALSE, if not specified.
fr: Retourne true si la bande ne contient que des valeurs nodata. Si aucune bande n'est spécifiée, la bande 1 est utilisée. Si le dernier paramètre est TRUE, la bande entière est vérifiée pixel par pixel. Sinon, la fonction retourne simplement la valeur du flag isnodata pour cette bande. La valeur par défaut pour ce paramètre est FALSE.

note: Tag: para
en: If the flag is dirty (this is, the result is different using TRUE as last parameter and not using it) you should update the raster to set this flag to true, by using ST_SetBandIsNodata(), or ST_SetBandNodataValue() with TRUE as last argument. See <xref linkend="RT_ST_SetBandIsNoData"/>.
fr: Si le flag est obsolète (c'est à dire si le résultat est différent selon qu'on utilise TRUE ou non comme dernier paramètre), vous devriez mettre à jour le raster pour mettre à jour ce flag, en utilisant ST_SetBandIsNodata(), ou ST_SetBandNodataValue() avec TRUE en dernier paramètre. Voir <xref linkend="RT_ST_SetBandIsNoData"/>.

note: Tag: refpurpose
en: Returns system file path to a band stored in file system. If no bandnum specified, 1 is assumed.
fr: Retourne le chemin système du fichier d'une bande stockée sur le système de fichier. Si aucune bande n'est spécifiée, la bande 1 est utilisée.

note: Tag: para
en: Returns system file path to a band. Throws an error if called with an in db band.
fr: Retourne le chemin système du fichier d'une bande. Renvoie une erreur si la bande n'est pas outofdb.

note: Tag: refpurpose
en: Returns the file size of a band stored in file system. If no bandnum specified, 1 is assumed.
fr: Retourne la taille du fichier d'une bande stockée sur le système de fichier. Si aucune bande n'est spécifiée, la bande 1 est utilisée.

note: Tag: para
en: Returns the file size of a band stored in file system. Throws an error if called with an in db band, or if outdb access is not enabled.
fr: Retourne la taille du fichier d'une bande stockée sur le système de fichier. Renvoie une erreur si la bande n'est pas outofdb, ou si l'accès outdb est désactivé.

note: Tag: para
en: This function is typically used in conjunction with ST_BandPath() and ST_BandFileTimestamp() so a client can determine if the filename of a outdb raster as seen by it is the same as the one seen by the server.
fr: Cette fonction est généralement utilisée conjointement à ST_BandPath() et ST_BandFileTimestamp(), pour qu'un client puisse déterminer le nom du fichier d'un raster outdb, tel que vu par le serveur.

note: Tag: refpurpose
en: Returns the file timestamp of a band stored in file system. If no bandnum specified, 1 is assumed.
fr: Retourne le timestamp du fichier d'une bande stockée sur le système de fichier. Si aucune bande n'est spécifiée, la bande 1 est utilisée.

note: Tag: para
en: Returns the file timestamp (number of seconds since Jan 1st 1970 00:00:00 UTC) of a band stored in file system. Throws an error if called with an in db band, or if outdb access is not enabled.
fr: Retourne le timestamp (nombre de secondes depuis Jan 1st 1970 00:00:00 UTC) du fichier d'une bande stockée sur le système de fichier. Renvoie une erreur si la bande n'est pas outofdb, ou si l'accès outdb est désactivé.

note: Tag: para
en: This function is typically used in conjunction with ST_BandPath() and ST_BandFileSize() so a client can determine if the filename of a outdb raster as seen by it is the same as the one seen by the server.
fr: Cette fonction est généralement utilisée conjointement à ST_BandPath() et ST_BandFileSize(), pour qu'un client puisse déterminer le nom du fichier d'un raster outdb, tel que vu par le serveur.

note: Tag: refpurpose
en: Returns the type of pixel for given band. If no bandnum specified, 1 is assumed.
fr: Retourne le type de pixel d'une bande. Si aucune bande n'est spécifiée, la bande 1 est utilisée.

note: Tag: para
en: Returns name describing data type and size of values stored in each cell of given band.
fr: Retourne le nom décrivant le type de données et la taille des valeurs stockées pour chaque pixel de la bande spécifiée.

note: Tag: para
en: There are 11 pixel types. Pixel Types supported are as follows:
fr: Il existe 11 types de pixels. Les types de pixels supportés sont :

note: Tag: para
en: 1BB - 1-bit boolean
fr: 1BB - booléen 1-bit

note: Tag: para
en: 2BUI - 2-bit unsigned integer
fr: 2BUI - entier non signé 2-bits

note: Tag: para
en: 4BUI - 4-bit unsigned integer
fr: 4BUI - entier non signé 4-bits

note: Tag: para
en: 8BSI - 8-bit signed integer
fr: 8BSI - entier signé 8-bits

note: Tag: para
en: 8BUI - 8-bit unsigned integer
fr: 8BUI - entier non signé 8-bits

note: Tag: para
en: 16BSI - 16-bit signed integer
fr: 16BSI - entier signé 16-bits

note: Tag: para
en: 16BUI - 16-bit unsigned integer
fr: 16BUI - entier non signé 16-bits

note: Tag: para
en: 32BSI - 32-bit signed integer
fr: 32BSI - entier signé 32-bits

note: Tag: para
en: 32BUI - 32-bit unsigned integer
fr: 32BUI - entier non signé 32-bits

note: Tag: para
en: 32BF - 32-bit float
fr: 32BF - flottant 32-bits

note: Tag: para
en: 64BF - 64-bit float
fr: 64BF - flottant 64-bits

note: Tag: refpurpose
en: <refpurpose>Returns the minimum value this pixeltype can store.</refpurpose>
fr: <refpurpose>Retourne la valeur minimale supportée par le type de pixel pixeltype.</refpurpose>

note: Tag: para
en: <para>Returns the minimum value this pixeltype can store.</para>
fr: <para>Retourne la valeur minimale supportée par le type de pixel pixeltype.</para>

note: Tag: refpurpose
en: <refpurpose>Returns true if there is no band with given band number. If no band number is specified, then band number 1 is assumed.</refpurpose>
fr: <refpurpose>Retourne true si le raster n'a pas la bande spécifiée. Si aucune bande n'est spécifiée, la bande 1 est utilisée.</refpurpose>

note: Tag: para
en: <para>Returns true if there is no band with given band number. If no band number is specified, then band number 1 is assumed.</para>
fr: <para>Retourne true si le raster n'a pas la bande spécifiée. Si aucune bande n'est spécifiée, la bande 1 est utilisée.</para>

note: Tag: title
en: Raster Pixel Accessors and Setters
fr: Fonctions d'accès et de modifications des pixels raster

note: Tag: refpurpose
en: <refpurpose>Returns the polygon geometry that bounds the pixel for a particular row and column.</refpurpose>
fr: <refpurpose>Retourne la géométrie polygonale qui délimite le pixel pour une ligne et colonne spécifiées.</refpurpose>

note: Tag: para
en: <para>Returns the polygon geometry that bounds the pixel for a particular row and column.</para>
fr: <para>Retourne la géométrie polygonale qui délimite le pixel pour une ligne et colonne spécifiées.</para>

note: Tag: refpurpose
en: Returns the polygon geometry that bounds every pixel of a raster band along with the value, the X and the Y raster coordinates of each pixel.
fr: Retourne la géométrie polygonale qui délimite chaque pixel de la bande raster, avec la valeur et les coordonnées raster X et Y de chaque pixel.

note: Tag: para
en: Returns the polygon geometry that bounds every pixel of a raster band along with the value (double precision), the X and the Y raster coordinates (integers) of each pixel.
fr: Retourne la géométrie polygonale qui délimite chaque pixel de la bande raster, avec la valeur (double précision) et les coordonnées raster X et Y (entiers) de chaque pixel.

note: Tag: para
en: Return record format: <parameter>geom</parameter> <xref linkend="geometry"/>, <parameter>val</parameter> double precision, <parameter>x</parameter> integer, <parameter>y</parameter> integers.
fr: Format de l'enregistrement de retour : <parameter>geom</parameter> <xref linkend="geometry"/>, <parameter>val</parameter> double precision, <parameter>x</parameter> entier, <parameter>y</parameter> entier.

note: Tag: para
en: When <parameter>exclude_nodata_value</parameter> = TRUE, only those pixels whose values are not NODATA are returned as points.
fr: Si <parameter>exclude_nodata_value</parameter> = TRUE, seuls les pixels qui ne sont pas NODATA sont retournés.

note: Tag: para
en: ST_PixelAsPolygons returns one polygon geometry for every pixel. This is different than ST_DumpAsPolygons where each geometry represents one or more pixels with the same pixel value.
fr: ST_PixelAsPolygons retourne un polygone pour chaque pixel. Ce comportement est différent de ST_DumpAsPolygons, où chaque géométrie représente un ou plusieurs pixels de même valeur.

note: Tag: para
en: Enhanced: 2.1.0 exclude_nodata_value optional argument was added.
fr: Amélioration : 2.1.0 ajout du paramètre optionnel exclude_nodata_value.

note: Tag: para
en: Changed: 2.1.1 Changed behavior of exclude_nodata_value.
fr: Changement : 2.1.1 Changement du comportement de behavior of exclude_nodata_value.

note: Tag: refpurpose
en: <refpurpose>Returns a point geometry of the pixel's upper-left corner.</refpurpose>
fr: <refpurpose>Retourne le point géométrique du coin supérieur gauche du pixel.</refpurpose>

note: Tag: para
en: <para>Returns a point geometry of the pixel's upper-left corner.</para>
fr: <para>Retourne le point géométrique du coin supérieur gauche du pixel.</para>

note: Tag: refpurpose
en: <refpurpose>Returns a point geometry for each pixel of a raster band along with the value, the X and the Y raster coordinates of each pixel. The coordinates of the point geometry are of the pixel's upper-left corner.</refpurpose>
fr: <refpurpose>Retourne un point géométrique pour chaque pixel de la bande raster, avec sa valeur et ses coordonnées raster X et Y. Les coordonnées du points sont ceux du coin supérieur gauche du pixel.</refpurpose>

note: Tag: para
en: <para>Returns a point geometry for each pixel of a raster band along with the value, the X and the Y raster coordinates of each pixel. The coordinates of the point geometry are of the pixel's upper-left corner.</para>
fr: <para>Retourne un point géométrique pour chaque pixel de la bande raster, avec sa valeur et ses coordonnées raster X et Y. Les coordonnées du points sont ceux du coin supérieur gauche du pixel.</para>

note: Tag: refpurpose
en: <refpurpose>Returns the centroid (point geometry) of the area represented by a pixel.</refpurpose>
fr: <refpurpose>Retourne le centroïde (point géométrique) de la zone représentée par un pixel.</refpurpose>

note: Tag: para
en: <para>Returns the centroid (point geometry) of the area represented by a pixel.</para>
fr: <para>Retourne le centroïde (point géométrique) de la zone représentée par un pixel.</para>

note: Tag: para
en: Enhanced: 3.2.0 Faster now implemented in C.
fr: Amélioration : 3.2.0 Plus rapide, désormais implémenté en C.

note: Tag: refpurpose
en: <refpurpose>Returns the centroid (point geometry) for each pixel of a raster band along with the value, the X and the Y raster coordinates of each pixel. The point geometry is the centroid of the area represented by a pixel.</refpurpose>
fr: <refpurpose>Retourne le centroïde (point géométrique) pour chaque pixel de la bande raster, avec sa valeur et les coordonnées raster X et Y. Le point géométrique est le centroïde de la zone représentée par un pixel.</refpurpose>

note: Tag: para
en: <para>Returns the centroid (point geometry) for each pixel of a raster band along with the value, the X and the Y raster coordinates of each pixel. The point geometry is the centroid of the area represented by a pixel.</para>
fr: <para>Retourne le centroïde (point géométrique) pour chaque pixel de la bande raster, avec sa valeur et les coordonnées raster X et Y. Le point géométrique est le centroïde de la zone représentée par un pixel.</para>

note: Tag: refpurpose
en: Returns the value of a given band in a given columnx, rowy pixel or at a particular geometric point. Band numbers start at 1 and assumed to be 1 if not specified. If <varname>exclude_nodata_value</varname> is set to false, then all pixels include <varname>nodata</varname> pixels are considered to intersect and return value. If <varname>exclude_nodata_value</varname> is not passed in then reads it from metadata of raster.
fr: Retourne la valeur d'une bande raster spécifiée au pixel donné par columnx, rowy, ou à un point géométrique spécifié. Le numéro de bande démarre à 1, et la bande 1 est utilisée si non spécifié. Si <varname>exclude_nodata_value</varname> vaut false, tous les pixels y compris ceux ayant la valeur <varname>nodata</varname> sont considérés comme intersectés et leur valeur sera retournée. Si <varname>exclude_nodata_value</varname> n'est pas spécifié, la valeur est lue depuis les méta-données du raster.

note: Tag: para
en: Returns the value of a given band in a given columnx, rowy pixel or at a given geometry point. Band numbers start at 1 and band is assumed to be 1 if not specified.
fr: Retourne la valeur d'une bande raster spécifiée au pixel donné par columnx, rowy, ou à un point géométrique spécifié. Le numéro de bande démarre à 1, et la bande 1 est utilisée si non spécifié.

note: Tag: para
en: If <varname>exclude_nodata_value</varname> is set to true, then only non <varname>nodata</varname> pixels are considered. If <varname>exclude_nodata_value</varname> is set to false, then all pixels are considered.
fr: Si <varname>exclude_nodata_value</varname> vaut true, seulement les pixels différents de la valeur <varname>nodata</varname> seront utilisés. Si <varname>exclude_nodata_value</varname> vaut false, tous les pixels seront utilisés.

note: Tag: para
en: The allowed values of the <varname>resample</varname> parameter are "nearest" which performs the default nearest-neighbor resampling, and "bilinear" which performs a <link xlink:href="https://en.wikipedia.org/wiki/Bilinear_interpolation">bilinear interpolation</link> to estimate the value between pixel centers.
fr: Les valeurs possibles pour le paramètre <varname>resample</varname> sont : "nearest" (interpolation par plus proche voisin) et "bilinear" (<link xlink:href="https://fr.wikipedia.org/wiki/Interpolation_bilin%C3%A9aire">interpolation bilinéaire</link>). Ce paramètre est utilisé pour estimer la valeur entre les centres des pixels.

note: Tag: para
en: Enhanced: 3.2.0 resample optional argument was added.
fr: Amélioration : 3.2.0 ajout du paramètre optionnel resample.

note: Tag: para
en: Enhanced: 2.0.0 exclude_nodata_value optional argument was added.
fr: Amélioration : 2.0.0 ajout du paramètre optionnel exclude_nodata_value.

note: Tag: refpurpose
en: Returns the nearest non-<varname>NODATA</varname> value of a given band's pixel specified by a columnx and rowy or a geometric point expressed in the same spatial reference coordinate system as the raster.
fr: Retourne la valeur la plus proche différent de <varname>NODATA</varname> pour une bande raster spécifiée au pixel donné par columnx et rowy, ou à un point géométrique spécifié dans le même système de référence spatial que le raster.

note: Tag: para
en: Returns the nearest non-<varname>NODATA</varname> value of a given band in a given columnx, rowy pixel or at a specific geometric point. If the columnx, rowy pixel or the pixel at the specified geometric point is <varname>NODATA</varname>, the function will find the nearest pixel to the columnx, rowy pixel or geometric point whose value is not <varname>NODATA</varname>.
fr: Retourne la valeur la plus proche différent de <varname>NODATA</varname> pour une bande raster spécifiée au pixel donné par columnx et rowy, ou à un point géométrique spécifié. Si le pixel donné par columnx, rowy ou par le point géométrique est de valeur <varname>NODATA</varname>, la fonction trouve le plus proche pixel dont la valeur est différente de <varname>NODATA</varname>.

note: Tag: para
en: Band numbers start at 1 and <varname>bandnum</varname> is assumed to be 1 if not specified. If <varname>exclude_nodata_value</varname> is set to false, then all pixels include <varname>nodata</varname> pixels are considered to intersect and return value. If <varname>exclude_nodata_value</varname> is not passed in then reads it from metadata of raster.
fr: Le numéro de bande démarre à 1, et la bande 1 est utilisée si <varname>bandnum</varname> non spécifié. Si <varname>exclude_nodata_value</varname> vaut false, tous les pixels y compris ceux ayant la valeur <varname>nodata</varname> sont considérés comme intersectés et leur valeur sera retournée. Si <varname>exclude_nodata_value</varname> n'est pas spécifié, la valeur est lue depuis les méta-données du raster.

note: Tag: para
en: ST_NearestValue is a drop-in replacement for ST_Value.
fr: ST_NearestValue remplace directement ST_Value.

note: Tag: refpurpose
en: Returns a geometry with the same X/Y coordinates as the input geometry, and values from the raster copied into the Z dimension using the requested resample algorithm.
fr: Retourne une géométrie avec les mêmes coordonnées X/Y que la géométrie d'entrée, et avec la coordonnée Z copiée depuis les valeurs du raster selon l'algorithme d'interpolation en paramètre.

note: Tag: para
en: Returns a geometry with the same X/Y coordinates as the input geometry, and values from the raster copied into the Z dimensions using the requested resample algorithm.
fr: Retourne une géométrie avec les mêmes coordonnées X/Y que la géométrie d'entrée, et avec la coordonnée Z copiée depuis les valeurs du raster selon l'algorithme d'interpolation en paramètre.

note: Tag: para
en: The <varname>resample</varname> parameter can be set to "nearest" to copy the values from the cell each vertex falls within, or "bilinear" to use <link xlink:href="https://en.wikipedia.org/wiki/Bilinear_interpolation">bilinear interpolation</link> to calculate a value that takes neighboring cells into account also.
fr: Le paramètre <varname>resample</varname> peut être "nearest" (plus proche) pour copier les valeurs de chaque pixel auquel le vertex correspond, ou "bilinear" pour utiliser une <link xlink:href="https://fr.wikipedia.org/wiki/Interpolation_bilin%C3%A9aire">interpolation bilinéaire</link> pour calculer une valeur qui prend aussi en compte les pixels voisins.

note: Tag: refpurpose
en: Returns a geometry with the same X/Y coordinates as the input geometry, and values from the raster copied into the M dimension using the requested resample algorithm.
fr: Retourne une géométrie avec les mêmes coordonnées X/Y que la géométrie d'entrée, et avec la coordonnée M copiée depuis les valeurs du raster selon l'algorithme d'interpolation en paramètre.

note: Tag: para
en: Returns a geometry with the same X/Y coordinates as the input geometry, and values from the raster copied into the M dimensions using the requested resample algorithm.
fr: Retourne une géométrie avec les mêmes coordonnées X/Y que la géométrie d'entrée, et avec la coordonnée M copiée depuis les valeurs du raster selon l'algorithme d'interpolation en paramètre.

note: Tag: refpurpose
en: Returns a 2-D double precision array of the non-<varname>NODATA</varname> values around a given band's pixel specified by either a columnX and rowY or a geometric point expressed in the same spatial reference coordinate system as the raster.
fr: Retourne un tableau 2-D de double avec les valeurs non <varname>NODATA</varname> autour du pixel de la bande spécifiée, aux coordonnées spécifiées par columnX &amp; rowY ou par un point géométrique dans le même système de référence spatial que le raster.

note: Tag: para
en: Returns a 2-D double precision array of the non-<varname>NODATA</varname> values around a given band's pixel specified by either a columnX and rowY or a geometric point expressed in the same spatial reference coordinate system as the raster. The <varname>distanceX</varname> and <varname>distanceY</varname> parameters define the number of pixels around the specified pixel in the X and Y axes, e.g. I want all values within 3 pixel distance along the X axis and 2 pixel distance along the Y axis around my pixel of interest. The center value of the 2-D array will be the value at the pixel specified by the columnX and rowY or the geometric point.
fr: Retourne un tableau 2-D de double avec les valeurs non <varname>NODATA</varname> autour du pixel de la bande spécifiée, aux coordonnées spécifiées par columnX &amp; rowY ou par un point géométrique dans le même système de référence spatial que le raster. Les paramètres <varname>distanceX</varname> et <varname>distanceY</varname> définissent le nombre de pixels autour du pixel spécifié sur les axes X et Y. Exemple : vous pouvez récupérer toutes les valeurs autour du pixel souhaité, à une distance de 3 pixels selon l'axe X et à une distance de 2 pixels selon l'axe Y. La valeur centrale du tableau 2-D sera la valeur du pixel spécifié par columnX et rowY ou par le point géométrique.

note: Tag: para
en: The number of elements along each axis of the returning 2-D array is 2 * (<varname>distanceX</varname>|<varname>distanceY</varname>) + 1. So for a <varname>distanceX</varname> and <varname>distanceY</varname> of 1, the returning array will be 3x3.
fr: Le nombre d'éléments retournés dans le tableau 2-D sur chaque axe sera 2 * (<varname>distanceX</varname>|<varname>distanceY</varname>) + 1. Pour <varname>distanceX</varname> et <varname>distanceY</varname> de 1, le tableau sera de taille 3x3.

note: Tag: para
en: The 2-D array output can be passed to any of the raster processing builtin functions, e.g. ST_Min4ma, ST_Sum4ma, ST_Mean4ma.
fr: Le tableau 2-D en sortie peut être passé à n'importe quelle fonction de traitement raster, comme ST_Min4ma, ST_Sum4ma, ST_Mean4ma.

note: Tag: refpurpose
en: Returns modified raster resulting from setting the value of a given band in a given columnx, rowy pixel or the pixels that intersect a particular geometry. Band numbers start at 1 and assumed to be 1 if not specified.
fr: Retourne un nouveau raster en modifiant la valeur du pixel pour la bande spécifiée et aux coordonnées columnx, rowy, ou pour tous les pixels qui intersectent une géométrie spécifiée. Le numéro de bande démarre à 1, et la bande 1 est utilisée si non spécifié.

note: Tag: para
en: Returns modified raster resulting from setting the specified pixels' values to new value for the designated band given the raster's row and column or a geometry. If no band is specified, then band 1 is assumed.
fr: Retourne un nouveau raster en modifiant la valeur du pixel pour la bande spécifiée et aux coordonnées columnx, rowy, ou pour tous les pixels qui intersectent une géométrie spécifiée. Le numéro de bande démarre à 1, et la bande 1 est utilisée si non spécifié.

note: Tag: para
en: Enhanced: 2.1.0 Geometry variant of ST_SetValue() now supports any geometry type, not just point. The geometry variant is a wrapper around the geomval[] variant of ST_SetValues()
fr: Amélioration : 2.1.0 La variante de ST_SetValue() avec la géométrie supporte n'importe quelle type de géométrie, pas uniquement des points. La variante avec la géométrie est une enveloppe autour de la variante de ST_SetValues() avec geomval[]

note: Tag: refpurpose
en: Returns modified raster resulting from setting the values of a given band.
fr: Retourne un nouveau raster en modifiant les valeurs de certains pixels d'une bande spécifiée.

note: Tag: para
en: Returns modified raster resulting from setting specified pixels to new value(s) for the designated band. <varname>columnx</varname> and <varname>rowy</varname> are 1-indexed.
fr: Retourne un nouveau raster en modifiant les valeurs de certains pixels d'une bande spécifiée. Les paramètres <varname>columnx</varname> et <varname>rowy</varname> démarrent à 1.

note: Tag: para
en: If <varname>keepnodata</varname> is TRUE, those pixels whose values are NODATA will not be set with the corresponding value in <varname>newvalueset</varname>.
fr: Si <varname>keepnodata</varname> est TRUE, les pixels qui sont NODATA ne seront pas mis à jour avec la valeur donnée par <varname>newvalueset</varname>.

note: Tag: para
en: For Variant 1, the specific pixels to be set are determined by the <varname>columnx</varname>, <varname>rowy</varname> pixel coordinates and the dimensions of the <varname>newvalueset</varname> array. <varname>noset</varname> can be used to prevent pixels with values present in <varname>newvalueset</varname> from being set (due to PostgreSQL not permitting ragged/jagged arrays). See example Variant 1.
fr: Pour la variante 1, les pixels sont déterminés par les coordonnées du pixel <varname>columnx</varname> et <varname>rowy</varname>, ainsi que la dimension du tableau <varname>newvalueset</varname>. <varname>noset</varname> peut être utilisé pour s'assurer qu'aucun pixel présent dans <varname>newvalueset</varname> et ayant déjà une valeur soient modifiés (PostgreSQL ne supportant pas les tableaux irréguliers/agglomérés). Voir l'exemple Variante 1.

note: Tag: para
en: Variant 2 is like Variant 1 but with a simple double precision <varname>nosetvalue</varname> instead of a boolean <varname>noset</varname> array. Elements in <varname>newvalueset</varname> with the <varname>nosetvalue</varname> value with be skipped. See example Variant 2.
fr: La variante 2 est similaire à la variante 1, mais avec une valeur unique en double precision <varname>nosetvalue</varname> au lieu du tableau de booléens <varname>noset</varname>. Les éléments dans <varname>newvalueset</varname> avec la valeur <varname>nosetvalue</varname> seront ignorés. Voir l'exemple Variante 2.

note: Tag: para
en: For Variant 3, the specific pixels to be set are determined by the <varname>columnx</varname>, <varname>rowy</varname> pixel coordinates, <varname>width</varname> and <varname>height</varname>. See example Variant 3.
fr: Pour la variante 3, les pixels à modifier doivent être explicitement spécifiés par les coordonnées <varname>columnx</varname>, <varname>rowy</varname>, ainsi que les tailles <varname>width</varname> (largeur) et <varname>height</varname> (hauteur). Voir l'exemple Variante 3.

note: Tag: para
en: Variant 4 is the same as Variant 3 with the exception that it assumes that the first band's pixels of <varname>rast</varname> will be set.
fr: La variante 4 est identique à la variante 3, en modifiant la bande raster 1 du raster <varname>rast</varname>.

note: Tag: para
en: For Variant 5, an array of <xref linkend="geomval"/> is used to determine the specific pixels to be set. If all the geometries in the array are of type POINT or MULTIPOINT, the function uses a shortcut where the longitude and latitude of each point is used to set a pixel directly. Otherwise, the geometries are converted to rasters and then iterated through in one pass. See example Variant 5.
fr: Pour la variante 5, un tableau de <xref linkend="geomval"/> est utilisé pour déterminer les pixels à modifier. Si toutes les géométries du tableau sont de type POINT ou MULTIPOINT, la fonction utilise un raccourci où la longitude et la latitude du chaque point sont utilisés pour modifier directement le pixel. Sinon, les géométries sont converties en raster, puis itérés en une passe. Voir l'exemple Variante 5.

note: Tag: title
en: Examples: Variant 3
fr: Exemples : Variante 3

note: Tag: title
en: Examples: Variant 5
fr: Exemples : Variante 5

note: Tag: para
en: The following shows that geomvals later in the array can overwrite prior geomvals
fr: L'exemple suivant montre qu'une géométrie située plus loin dans le tableau peut écraser une valeur issue d'une géométrie précédente

note: Tag: para
en: This example is the opposite of the prior example
fr: Cet exemple est le contraire de l'exemple précédent

note: Tag: refpurpose
en: Get the values of the specified band as a 2-dimension array.
fr: Retourne les valeurs d'une bande raster spécifiée, sous forme d'un tableau à deux dimensions.

note: Tag: para
en: Get the values of the specified band as a 2-dimension array (first index is row, second is column). If <varname>nband</varname> is NULL or not provided, all raster bands are processed.
fr: Retour les valeurs d'une bande, sous forme d'un tableau à 2 dimensions (le premier index étant la ligne, le second étant la colonne). Si <varname>nband</varname> est NULL ou non spécifié, toutes les bandes raster sont traitées.

note: Tag: refpurpose
en: Get the columnx, rowy coordinates of the pixel whose value equals the search value.
fr: Retourne les coordonnées columnx, rowy du pixel dont la valeur est égale à la valeur recherchée.

note: Tag: para
en: Get the columnx, rowy coordinates of the pixel whose value equals the search value. If no band is specified, then band 1 is assumed.
fr: Retourne les coordonnées columnx, rowy du pixel dont la valeur est égale à la valeur recherchée. Si aucune bande n'est spécifiée, la bande 1 est utilisée.

note: Tag: title
en: Raster Editors
fr: Éditeurs de raster

note: Tag: refpurpose
en: Set Georeference 6 georeference parameters in a single call. Numbers should be separated by white space. Accepts inputs in GDAL or ESRI format. Default is GDAL.
fr: Définit les 6 paramètres de géo-référencement en un seul appel. Les nombres doivent être séparés par un espace. Accepte les formats GDAL (par défaut) ou ESRI.

note: Tag: para
en: Set Georeference 6 georeference parameters in a single call. Accepts inputs in 'GDAL' or 'ESRI' format. Default is GDAL. If 6 coordinates are not provided will return null.
fr: Définit les 6 paramètres de géo-référencement en un seul appel. Accepte les formats 'GDAL' (par défaut) ou 'ESRI'. Si les 6 coordonnées ne sont pas spécifiées, retourne null.

note: Tag: para
en: If the raster has out-db bands, changing the georeference may result in incorrect access of the band's externally stored data.
fr: Si le raster a des bandes out-db, modifier le géoréférencement peut entraîner un accès incorrect aux données de la bande out-db.

note: Tag: para
en: Enhanced: 2.1.0 Addition of ST_SetGeoReference(raster, double precision, ...) variant
fr: Amélioration : 2.1.0 Ajout de la variante ST_SetGeoReference(raster, double precision, ...)

note: Tag: refpurpose
en: Set the rotation of the raster in radian.
fr: Définit la rotation du raster en radians.

note: Tag: para
en: Uniformly rotate the raster. Rotation is in radian. Refer to <link xlink:href="http://en.wikipedia.org/wiki/World_file">World File</link> for more details.
fr: Applique une rotation uniforme du raster. L'angle de rotation est en radians. Voir <link xlink:href="https://fr.wikipedia.org/wiki/World_file">World File</link> pour plus de détails.

note: Tag: refpurpose
en: Sets the X and Y size of pixels in units of coordinate reference system. Number units/pixel width/height.
fr: Définit la résolution des pixels en X et Y en unité du système de référence spatial : nombre d'unités/pixel en largeur/hauteur.

note: Tag: para
en: Sets the X and Y size of pixels in units of coordinate reference system. Number units/pixel width/height. If only one unit passed in, assumed X and Y are the same number.
fr: Définit la résolution des pixels en X et Y en unité du système de référence spatial : nombre d'unités/pixel en largeur/hauteur. Si une seule unité est spécifiée, la même résolution est utilisée pour X et pour Y.

note: Tag: para
en: ST_SetScale is different from <xref linkend="RT_ST_Rescale"/> in that ST_SetScale do not resample the raster to match the raster extent. It only changes the metadata (or georeference) of the raster to correct an originally mis-specified scaling. ST_Rescale results in a raster having different width and height computed to fit the geographic extent of the input raster. ST_SetScale do not modify the width, nor the height of the raster.
fr: ST_SetScale est différent de <xref linkend="RT_ST_Rescale"/> : ST_SetScale ne rééchantillonne pas le raster pour correspondre à l'étendue du raster. La fonction modifie seulement les méta-données (ou la géo-référence) d'un raster pour corriger une échelle incorrecte. ST_Rescale produit un raster de taille différente pour correspondre à l'étendue spatiale du raster d'entrée. ST_SetScale ne modifie pas la largeur ou hauteur du raster.

note: Tag: para
en: Changed: 2.0.0 In WKTRaster versions this was called ST_SetPixelSize. This was changed in 2.0.0.
fr: Changement : 2.0.0 Dans les versions WKTRaster, cette fonction était appelée ST_SetPixelSize.

note: Tag: refpurpose
en: Sets the georeference X and Y skew (or rotation parameter). If only one is passed in, sets X and Y to the same value.
fr: Définit l'obliquité X et Y (skew, ou paramètre de rotation). Si une seule valeur est spécifiée, la même valeur est utilisée pour X et pour Y.

note: Tag: para
en: Sets the georeference X and Y skew (or rotation parameter). If only one is passed in, sets X and Y to the same value. Refer to <link xlink:href="http://en.wikipedia.org/wiki/World_file">World File</link> for more details.
fr: Définit l'obliquité X et Y (skew, ou paramètre de rotation). Si une seule valeur est spécifiée, la même valeur est utilisée pour X et pour Y. Voir <link xlink:href="https://fr.wikipedia.org/wiki/World_file">World File</link> pour plus de détails.

note: Tag: refpurpose
en: Sets the SRID of a raster to a particular integer srid defined in the spatial_ref_sys table.
fr: Modifie le SRID d'un raster à une valeur définie dans la table spatial_ref_sys.

note: Tag: para
en: Sets the SRID on a raster to a particular integer value.
fr: Modifie le SRID d'un raster à une valeur spécifiée.

note: Tag: para
en: This function does not transform the raster in any way - it simply sets meta data defining the spatial ref of the coordinate reference system that it's currently in. Useful for transformations later.
fr: Cette fonction ne modifie pas le raster en lui-même : elle définit juste la méta-données définissant le système de référence spatial. Ceci est utile pour ensuite effectuer des transformations.

note: Tag: refpurpose
en: Sets the value of the upper left corner of the pixel of the raster to projected X and Y coordinates.
fr: Modifie les coordonnées du pixel du coin supérieur gauche du raster, selon les coordonnées X et Y projetées.

note: Tag: para
en: Set the value of the upper left corner of raster to the projected X and Y coordinates
fr: Modifie les coordonnées du pixel du coin supérieur gauche du raster aux coordonnées X et Y projetées

note: Tag: refpurpose
en: Resample a raster using a specified resampling algorithm, new dimensions, an arbitrary grid corner and a set of raster georeferencing attributes defined or borrowed from another raster.
fr: Rééchantillonne un raster, en utilisant l'algorithme spécifié, les nouvelles dimensions, un coin arbitraire de la grille et un ensemble de paramètres de géo-référencement définis ou empruntés à un autre raster.

note: Tag: para
en: Resample a raster using a specified resampling algorithm, new dimensions (width &amp; height), a grid corner (gridx &amp; gridy) and a set of raster georeferencing attributes (scalex, scaley, skewx &amp; skewy) defined or borrowed from another raster. If using a reference raster, the two rasters must have the same SRID.
fr: Rééchantillonne un raster, en utilisant l'algorithme spécifié, les nouvelles dimensions (width &amp; height), un coin de la grille (gridx &amp; gridy) et un ensemble de paramètres de géo-référencement (scalex, scaley, skewx &amp; skewy) définis ou empruntés à un autre raster. Si un raster de référence est spécifié, les deux rasters doivent avoir le même SRID.

note: Tag: para
en: New pixel values are computed using one of the following resampling algorithms:
fr: Les nouvelles valeurs des pixels sont calculées par un des algorithmes de rééchantillonnage suivants :

note: Tag: para
en: NearestNeighbor (english or american spelling)
fr: NearestNeighbor (plus proche voisin)

note: Tag: para
en: Bilinear
fr: Bilinear (Bilinéaire)

note: Tag: para
en: Cubic
fr: Cubic (Cubique)

note: Tag: para
en: CubicSpline
fr: CubicSpline (Cubique Spline)

note: Tag: para
en: The default is NearestNeighbor which is the fastest but results in the worst interpolation.
fr: L'algorithme par défaut est NearestNeighbor, qui est le plus rapide mais donne le moins bon résultat.

note: Tag: para
en: A maxerror percent of 0.125 is used if no <varname>maxerr</varname> is specified.
fr: Une erreur maximale de 0.125 est utilisée si le paramètre <varname>maxerr</varname> n'est pas spécifié.

note: Tag: para
en: Refer to: <link xlink:href="http://www.gdal.org/gdalwarp.html">GDAL Warp resampling methods</link> for more details.
fr: Voir <link xlink:href="http://www.gdal.org/gdalwarp.html">GDAL Warp resampling methods</link> pour plus de détails.

note: Tag: para
en: Availability: 2.0.0 Requires GDAL 1.6.1+
fr: Disponibilité : 2.0.0 Nécessite GDAL 1.6.1+

note: Tag: para
en: Enhanced: 3.4.0 max and min resampling options added
fr: Améliration : 3.4.0 ajout des options de rééchantillonnage max et min

note: Tag: refpurpose
en: Resample a raster by adjusting only its scale (or pixel size). New pixel values are computed using the NearestNeighbor (english or american spelling), Bilinear, Cubic, CubicSpline, Lanczos, Max or Min resampling algorithm. Default is NearestNeighbor.
fr: Rééchantillonne un raster en ajustant juste son échelle (ou la taille des pixels). Les nouvelles valeurs des pixels sont calculées en utilisant l'algorithme de rééchantillonnage NearestNeighbor (plus proche voisin), Bilinear (Bilinéaire), Cubic (Cubique), CubicSpline (Cubique Spline), Lanczos, Max ou Min. La valeur par défaut est NearestNeighbor.

note: Tag: para
en: Resample a raster by adjusting only its scale (or pixel size). New pixel values are computed using one of the following resampling algorithms:
fr: Rééchantillonne un raster en ajustant juste son échelle (ou la taille des pixels). Les nouvelles valeurs des pixels sont calculées en utilisant un des algorithmes de rééchantillonnage suivants :

note: Tag: para
en: <varname>scalex</varname> and <varname>scaley</varname> define the new pixel size. scaley must often be negative to get well oriented raster.
fr: <varname>scalex</varname> et <varname>scaley</varname> définissent la nouvelle taille des pixels. scaley est souvent négatif pour obtenir un raster correctement orienté.

note: Tag: para
en: When the new scalex or scaley is not a divisor of the raster width or height, the extent of the resulting raster is expanded to encompass the extent of the provided raster. If you want to be sure to retain exact input extent see <xref linkend="RT_ST_Resize"/>
fr: Quand la nouvelle valeur de scalex (respectivement scaley) n'est pas un diviseur de la hauteur (respectivement largeur) du raster, l'étendue du raster résultant est agrandie pour englober l'étendue du raster d'entrée. Si vous voulez conserver l'étendue exacte du raster d'entrée, utilisez <xref linkend="RT_ST_Resize"/>

note: Tag: para
en: <varname>maxerr</varname> is the threshold for transformation approximation by the resampling algorithm (in pixel units). A default of 0.125 is used if no <varname>maxerr</varname> is specified, which is the same value used in GDAL gdalwarp utility. If set to zero, no approximation takes place.
fr: <varname>maxerr</varname> est le seuil pour l'approximation de l'algorithme de rééchantillonnage (en pixels). La valeur de 0.125 est utilisée si le paramètre <varname>maxerr</varname> n'est pas spécifié, qui est la même valeur que celle utilisée par l'utilitaire GDAL gdalwarp. Si définie à 0, aucune approximation n'est effectuée.

note: Tag: para
en: ST_Rescale is different from <xref linkend="RT_ST_SetScale"/> in that ST_SetScale do not resample the raster to match the raster extent. ST_SetScale only changes the metadata (or georeference) of the raster to correct an originally mis-specified scaling. ST_Rescale results in a raster having different width and height computed to fit the geographic extent of the input raster. ST_SetScale do not modify the width, nor the height of the raster.
fr: ST_Rescale est différent de <xref linkend="RT_ST_SetScale"/> : ST_SetScale ne rééchantillonne pas le raster pour correspondre à l'étendue du raster. ST_SetScale modifie seulement les méta-données (ou lagéo-référence) d'un raster pour corriger une échelle incorrecte. ST_Rescale produit un raster de taille différente pour correspondre à l'étendue spatiale du raster d'entrée. ST_SetScale ne modifie pas la largeur ou hauteur du raster.

note: Tag: para
en: Changed: 2.1.0 Works on rasters with no SRID
fr: Changement : 2.1.0 Fonctionne avec les rasters sans SRID

note: Tag: para
en: A simple example rescaling a raster from a pixel size of 0.001 degree to a pixel size of 0.0015 degree.
fr: Exemple simple de rééchantillonnage d'un raster d'une taille de pixel de 0.001 degrés vers une taille de pixel de 0.0015 degrés.

note: Tag: refpurpose
en: Resample a raster by adjusting only its skew (or rotation parameters). New pixel values are computed using the NearestNeighbor (english or american spelling), Bilinear, Cubic, CubicSpline or Lanczos resampling algorithm. Default is NearestNeighbor.
fr: Rééchantillonne un raster en ajustant simplement son obliquité (skew, ou paramètre de rotation). Les nouvelles valeurs des pixels sont calculées en utilisant l'algorithme de rééchantillonnage NearestNeighbor (plus proche voisin), Bilinear (Bilinéaire), Cubic (Cubique), CubicSpline (Cubique Spline) ou Lanczos. La valeur par défaut est NearestNeighbor.

note: Tag: para
en: Resample a raster by adjusting only its skew (or rotation parameters). New pixel values are computed using the NearestNeighbor (english or american spelling), Bilinear, Cubic, CubicSpline or Lanczos resampling algorithm. The default is NearestNeighbor which is the fastest but results in the worst interpolation.
fr: Rééchantillonne un raster en ajustant simplement son obliquité (skew, ou paramètre de rotation). Les nouvelles valeurs des pixels sont calculées en utilisant l'algorithme de rééchantillonnage NearestNeighbor (plus proche voisin), Bilinear (Bilinéaire), Cubic (Cubique), CubicSpline (Cubique Spline) ou Lanczos. La valeur par défaut est NearestNeighbor, qui est le plus rapide mais donne le moins bon résultat.

note: Tag: para
en: <varname>skewx</varname> and <varname>skewy</varname> define the new skew.
fr: <varname>skewx</varname> et <varname>skewy</varname> définissent la nouvelle obliquité.

note: Tag: para
en: The extent of the new raster will encompass the extent of the provided raster.
fr: L'étendue du nouveau raster englobe l'étendu du raster en entrée.

note: Tag: para
en: A maxerror percent of 0.125 if no <varname>maxerr</varname> is specified.
fr: Un pourcentage maximal d'erreur de 0.125 % est utilisé si le paramètre <varname>maxerr</varname> n'est pas spécifié.

note: Tag: para
en: ST_Reskew is different from <xref linkend="RT_ST_SetSkew"/> in that ST_SetSkew do not resample the raster to match the raster extent. ST_SetSkew only changes the metadata (or georeference) of the raster to correct an originally mis-specified skew. ST_Reskew results in a raster having different width and height computed to fit the geographic extent of the input raster. ST_SetSkew do not modify the width, nor the height of the raster.
fr: ST_Reskew est différent de <xref linkend="RT_ST_SetSkew"/> : ST_SetSkew ne rééchantillonne pas le raster pour correspondre à l'étendue du raster. ST_SetSkew modifie seulement les méta-données (ou la géo-référence) du raster pour corriger une obliquité incorrecte. ST_Reskew produit un raster de taille différente pour correspondre à l'étendue spatiale du raster d'entrée. ST_SetSkew ne modifie pas la largeur ou hauteur du raster.

note: Tag: para
en: A simple example reskewing a raster from a skew of 0.0 to a skew of 0.0015.
fr: Exemple simple de rééchantillonnage d'un raster d'une obliquité de 0.0 à 0.0015.

note: Tag: refpurpose
en: Resample a raster by snapping it to a grid. New pixel values are computed using the NearestNeighbor (english or american spelling), Bilinear, Cubic, CubicSpline or Lanczos resampling algorithm. Default is NearestNeighbor.
fr: Rééchantillonne un raster en l'accrochant sur une grille. Les nouvelles valeurs des pixels sont calculées en utilisant l'algorithme de rééchantillonnage NearestNeighbor (plus proche voisin), Bilinear (Bilinéaire), Cubic (Cubique), CubicSpline (Cubique Spline) ou Lanczos. La valeur par défaut est NearestNeighbor.

note: Tag: para
en: Resample a raster by snapping it to a grid defined by an arbitrary pixel corner (gridx &amp; gridy) and optionally a pixel size (scalex &amp; scaley). New pixel values are computed using the NearestNeighbor (english or american spelling), Bilinear, Cubic, CubicSpline or Lanczos resampling algorithm. The default is NearestNeighbor which is the fastest but results in the worst interpolation.
fr: Rééchantillonne un raster en l'accrochant sur une grille définie par un coin arbitraire (gridx &amp; gridy) et une taille de pixel optionnelle (scalex &amp; scaley). Les nouvelles valeurs des pixels sont calculées en utilisant l'algorithme de rééchantillonnage NearestNeighbor (plus proche voisin), Bilinear (Bilinéaire), Cubic (Cubique), CubicSpline (Cubique Spline) ou Lanczos. La valeur par défaut est NearestNeighbor, qui est le plus rapide mais donne le moins bon résultat.

note: Tag: para
en: <varname>gridx</varname> and <varname>gridy</varname> define any arbitrary pixel corner of the new grid. This is not necessarily the upper left corner of the new raster and it does not have to be inside or on the edge of the new raster extent.
fr: <varname>gridx</varname> et <varname>gridy</varname> définissent le pixel d'un coin arbitraire de la nouvelle grille. Ce n'est pas nécessairement le coin supérieur gauche du nouveau raster, et n'a pas besoin d'être à l'intérieur ou sur les bords de l'emprise du nouveau raster.

note: Tag: para
en: You can optionally define the pixel size of the new grid with <varname>scalex</varname> and <varname>scaley</varname>.
fr: Il est possible de définir une taille de pixel pour la nouvelle grille avec les paramètres optionnels <varname>scalex</varname> et <varname>scaley</varname>.

note: Tag: para
en: Use <xref linkend="RT_ST_Resample"/> if you need more control over the grid parameters.
fr: Voir <xref linkend="RT_ST_Resample"/> pour plus de contrôle sur les paramètres de la grille.

note: Tag: para
en: A simple example snapping a raster to a slightly different grid.
fr: Exemple simple d'accrochage d'un raster sur une grille légèrement différente.

note: Tag: refpurpose
en: Resize a raster to a new width/height
fr: Redimensionne un raster à une nouvelle largeur/hauteur

note: Tag: para
en: Resize a raster to a new width/height. The new width/height can be specified in exact number of pixels or a percentage of the raster's width/height. The extent of the the new raster will be the same as the extent of the provided raster.
fr: Redimensionne un raster à une nouvelle largeur/hauteur. La nouvelle largeur/hauteur peut être spécifiée comme un nombre exact de pixels ou un pourcentage de la taille du raster. L'étendue du nouveau raster est la même que le raster d'entrée.

note: Tag: para
en: New pixel values are computed using the NearestNeighbor (english or american spelling), Bilinear, Cubic, CubicSpline or Lanczos resampling algorithm. The default is NearestNeighbor which is the fastest but results in the worst interpolation.
fr: Les nouvelles valeurs des pixels sont calculées en utilisant l'algorithme de rééchantillonnage NearestNeighbor (plus proche voisin), Bilinear (Bilinéaire), Cubic (Cubique), CubicSpline (Cubique Spline) ou Lanczos. La valeur par défaut est NearestNeighbor, qui est le plus rapide mais donne le moins bon résultat.

note: Tag: para
en: Variant 1 expects the actual width/height of the output raster.
fr: La variante 1 attend la largeur/hauteur réelle du raster de sortie.

note: Tag: para
en: Variant 2 expects decimal values between zero (0) and one (1) indicating the percentage of the input raster's width/height.
fr: La variante 2 attend des valeurs décimales entre zéro (0) et un (1) indiquant le pourcentage de la largeur/hauteur du raster d'entrée.

note: Tag: para
en: Variant 3 takes either the actual width/height of the output raster or a textual percentage ("20%") indicating the percentage of the input raster's width/height.
fr: La variante 3 prend en compte soit la largeur/hauteur réelle du raster de sortie ou un pourcentage sous forme de texte ("20%") indiquant le pourcentage de la largeur/hauteur du raster d'entrée.

note: Tag: para
en: Availability: 2.1.0 Requires GDAL 1.6.1+
fr: Disponibilité : 2.1.0 Nécessite GDAL 1.6.1+

note: Tag: refpurpose
en: Reprojects a raster in a known spatial reference system to another known spatial reference system using specified resampling algorithm. Options are NearestNeighbor, Bilinear, Cubic, CubicSpline, Lanczos defaulting to NearestNeighbor.
fr: Reprojette un raster depuis un système de référence spatial vers un autre, en utilisant l'algorithme de rééchantillonnage spécifié. Les algorithmes possibles sont NearestNeighbor (plus proche voisin), Bilinear (Bilinéaire), Cubic (Cubique), CubicSpline (Cubique Spline) ou Lanczos. La valeur par défaut est NearestNeighbor.

note: Tag: para
en: Reprojects a raster in a known spatial reference system to another known spatial reference system using specified pixel warping algorithm. Uses 'NearestNeighbor' if no algorithm is specified and maxerror percent of 0.125 if no maxerr is specified.
fr: Reprojette un raster depuis un système de référence spatial vers un autre, en utilisant l'algorithme de rééchantillonnage spécifié. L'algorithme utilisé par défaut est NearestNeighbor si aucun n'est spécifié. Le pourcentage d'erreur maximal est 0.125 si maxerr n'est pas spécifié.

note: Tag: para
en: ST_Transform is often confused with ST_SetSRID(). ST_Transform actually changes the coordinates of a raster (and resamples the pixel values) from one spatial reference system to another, while ST_SetSRID() simply changes the SRID identifier of the raster.
fr: ST_Transform est souvent confondu avec ST_SetSRID(). ST_Transform modifie réellement les coordonnées du raster (et rééchantillonne les valeurs des pixels) d'un système de référence spatial vers un autre, alors que ST_SetSRID() change uniquement l'identifiant SRID du raster.

note: Tag: para
en: Unlike the other variants, Variant 3 requires a reference raster as <varname>alignto</varname>. The transformed raster will be transformed to the spatial reference system (SRID) of the reference raster and be aligned (ST_SameAlignment = TRUE) to the reference raster.
fr: Contrairement aux autres variantes, la variante 3 nécessite un raster de référence <varname>alignto</varname>. Le raster de sortie sera transformé dans le système de référence spatial (SRID) du raster de référence et sera aligné (ST_SameAlignment = TRUE) avec le raster de référence.

note: Tag: para
en: If you find your transformation support is not working right, you may need to set the environment variable PROJSO to the .so or .dll projection library your PostGIS is using. This just needs to have the name of the file. So for example on windows, you would in Control Panel -&gt; System -&gt; Environment Variables add a system variable called <varname>PROJSO</varname> and set it to <varname>libproj.dll</varname> (if you are using proj 4.6.1). You'll have to restart your PostgreSQL service/daemon after this change.
fr: Si vous constatez que votre support de transformation ne fonctionne pas correctement, il se peut que vous deviez définir la variable d'environnement PROJSO avec la bibliothèque de projection .so ou .dll utilisée par PostGIS. Il suffit que le nom du fichier soit indiqué. Par exemple, sous Windows, dans Panneau de configuration -&gt; Système -&gt; Variables d'environnement, ajoutez une variable système appelée <varname>PROJSO</varname> et définissez-la sur <varname>libproj.dll</varname> (si vous utilisez proj 4.6.1). Vous devrez redémarrer votre service/daemon PostgreSQL après ce changement.

note: Tag: para
en: When transforming a coverage of tiles, you almost always want to use a reference raster to insure same alignment and no gaps in your tiles as demonstrated in example: Variant 3.
fr: Lors de la transformation d'une couverture tuilée, vous voudrez en général utiliser un raster de référence pour garantir le même alignement et sans lacunes dans les tuiles, comme le montre l'exemple Variante 3.

note: Tag: para
en: Enhanced: 2.1.0 Addition of ST_Transform(rast, alignto) variant
fr: Amélioration : 2.1.0 Ajout de la variante ST_Transform(rast, alignto)

note: Tag: para
en: original mass state plane meters (mass_stm)
fr: mass_stm original

note: Tag: para
en: After transform to wgs 84 long lat (wgs_84)
fr: Après transformation en WGS84 long lat (wgs_84)

note: Tag: para
en: After transform to wgs 84 long lat with bilinear algorithm instead of NN default (wgs_84_bilin)
fr: Après transformation en WGS84 long lat avec interpolation bilinéaire au lieu de NN par défaut (wgs_84_bilin)

note: Tag: para
en: The following shows the difference between using ST_Transform(raster, srid) and ST_Transform(raster, alignto)
fr: L'exemple suivant montre la différence entre ST_Transform(raster, srid) et ST_Transform(raster, alignto)

note: Tag: para
en: not_aligned
fr: Non aligné (not_aligned)

note: Tag: para
en: aligned
fr: Aligné (aligned)

note: Tag: title
en: Raster Band Editors
fr: Éditeurs de bandes raster

note: Tag: refpurpose
en: Sets the value for the given band that represents no data. Band 1 is assumed if no band is specified. To mark a band as having no nodata value, set the nodata value = NULL.
fr: Définit la valeur pour l'absence de données (nodata) pour la bande spécifiée. Si aucune bande n'est spécifiée, la bande 1 est utilisée. Pour indiquer qu'une bande n'a pas de valeur nodata, définir la valeur nodata = NULL.

note: Tag: para
en: Sets the value that represents no data for the band. Band 1 is assumed if not specified. This will affect results from <xref linkend="RT_ST_Polygon"/>, <xref linkend="RT_ST_DumpAsPolygons"/>, and the ST_PixelAs...() functions.
fr: Définit la valeur pour l'absence de données (nodata) pour la bande spécifiée. Si aucune bande n'est spécifiée, la bande 1 est utilisée. Cette valeur affecte les résultats de <xref linkend="RT_ST_Polygon"/>, <xref linkend="RT_ST_DumpAsPolygons"/>, ainsi que les fonctions ST_PixelAs...().

note: Tag: refpurpose
en: Sets the isnodata flag of the band to TRUE.
fr: Définit la valeur du flag isnodata de la bande à TRUE.

note: Tag: para
en: Sets the isnodata flag for the band to true. Band 1 is assumed if not specified. This function should be called only when the flag is considered dirty. That is, when the result calling <xref linkend="RT_ST_BandIsNoData"/> is different using TRUE as last argument and without using it
fr: Définit la valeur du flag isnodata de la bande à TRUE. Si aucune bande n'est spécifiée, la bande 1 est utilisée. Cette fonction ne devrait être appelée que si le flag est considéré comme obsolète, i.e. si le résultat de <xref linkend="RT_ST_BandIsNoData"/> est différent selon qu'on utilise TRUE comme dernier argument ou non

note: Tag: refpurpose
en: Update the external path and band number of an out-db band
fr: Met à jour le chemin externe et le numéro de bande d'une bande out-db

note: Tag: para
en: Updates an out-db band's external raster file path and external band number.
fr: Met à jour le chemin externe et le numéro de bande d'une bande externe out-db.

note: Tag: para
en: If <varname>force</varname> is set to true, no tests are done to ensure compatibility (e.g. alignment, pixel support) between the external raster file and the PostGIS raster. This mode is intended for file system changes where the external raster resides.
fr: Si <varname>force</varname> est true, aucun test n'est effectué pour garantir la compatibilité (e.g. alignement, support des pixels) entre le fichier raster externe et le raster PostGIS. Ce mode est prévu pour les changements sur le système de fichiers où réside le raster externe.

note: Tag: refpurpose
en: Update the external band number of an out-db band
fr: Met à jour le numéro de bande externe d'une bande out-db

note: Tag: para
en: Updates an out-db band's external band number. This does not touch the external raster file associated with the out-db band
fr: Met à jour le numéro de bande externe d'une bande out-db. Cette opération n'affecte pas le fichier raster externe associé à la bande out-db

note: Tag: para
en: If <varname>force</varname> is set to true, no tests are done to ensure compatibility (e.g. alignment, pixel support) between the external raster file and the PostGIS raster. This mode is intended for where bands are moved around in the external raster file.
fr: Si <varname>force</varname> est true, aucun test n'est effectué pour assurer la compatibilité (e.g., l'alignement, le support des pixels) entre le fichier raster externe et le raster PostGIS. Ce mode est destiné aux cas où les bandes sont déplacées dans le fichier raster externe.

note: Tag: para
en: Internally, this method replaces the PostGIS raster's band at index <varname>band</varname> with a new band instead of updating the existing path information.
fr: En interne, cette méthode remplacement la bande du raster PostGIS à l'index <varname>band</varname> avec la nouvelle bande, au lieu de mettre à jour les informations de chemin existantes.

note: Tag: title
en: Raster Band Statistics and Analytics
fr: Statistiques et analyses des bandes raster

note: Tag: refpurpose
en: Returns the number of pixels in a given band of a raster or raster coverage. If no band is specified defaults to band 1. If exclude_nodata_value is set to true, will only count pixels that are not equal to the nodata value.
fr: Renvoie le nombre de pixels dans une bande donnée d'un raster ou d'une couverture raster. Si aucune bande n'est spécifiée, la valeur par défaut est la bande 1. Si exclude_nodata_value est true, seuls les pixels dont la valeur est différente de la valeur nodata seront comptés.

note: Tag: para
en: Returns the number of pixels in a given band of a raster or raster coverage. If no band is specified <varname>nband</varname> defaults to 1.
fr: Renvoie le nombre de pixels dans une bande donnée d'un raster ou d'une couverture raster. Si aucune bande <varname>nband</varname> n'est spécifiée, la valeur par défaut est 1.

note: Tag: para
en: If <varname>exclude_nodata_value</varname> is set to true, will only count pixels with value not equal to the <varname>nodata</varname> value of the raster. Set <varname>exclude_nodata_value</varname> to false to get count all pixels
fr: Si <varname>exclude_nodata_value</varname> est true, seuls les pixels dont la valeur est différente de la valeur <varname>nodata</varname> du raster seront comptés. Définir <varname>exclude_nodata_value</varname> à false pour compter tous les pixels

note: Tag: para
en: Changed: 3.1.0 - The ST_Count(rastertable, rastercolumn, ...) variants removed. Use <xref linkend="RT_ST_CountAgg"/> instead.
fr: Changement : 3.1.0 - Suppression des variantes ST_Count(rastertable, rastercolumn, ...). Utiliser <xref linkend="RT_ST_CountAgg"/> à la place.

note: Tag: refpurpose
en: Aggregate. Returns the number of pixels in a given band of a set of rasters. If no band is specified defaults to band 1. If exclude_nodata_value is set to true, will only count pixels that are not equal to the NODATA value.
fr: Agrégat. Renvoie le nombre de pixels dans une bande donnée d'un ensemble de rasters. Si aucune bande n'est spécifiée, la valeur par défaut est la bande 1. Si exclude_nodata_value est true, seuls les pixels différents de la valeur NODATA seront comptés.

note: Tag: para
en: Returns the number of pixels in a given band of a set of rasters. If no band is specified <varname>nband</varname> defaults to 1.
fr: Renvoie le nombre de pixels dans une bande donnée d'un ensemble de rasters. Si aucune bande <varname>nband</varname> n'est spécifiée, la valeur par défaut est 1.

note: Tag: para
en: If <varname>exclude_nodata_value</varname> is set to true, will only count pixels with value not equal to the <varname>NODATA</varname> value of the raster. Set <varname>exclude_nodata_value</varname> to false to get count all pixels
fr: Si <varname>exclude_nodata_value</varname> est true, seuls les pixels dont la valeur est différente de la valeur <varname>nodata</varname> du raster seront comptés. Définir <varname>exclude_nodata_value</varname> à false pour compter tous les pixels

note: Tag: para
en: By default will sample all pixels. To get faster response, set <varname>sample_percent</varname> to value between zero (0) and one (1)
fr: Par défaut, tous les pixels sont échantillonnés. Pour obtenir une réponse plus rapide, définir <varname>sample_percent</varname> à une valeur comprise entre zéro (0) et un (1)

note: Tag: refpurpose
en: Returns a set of record summarizing a raster or raster coverage data distribution separate bin ranges. Number of bins are autocomputed if not specified.
fr: Retourne un ensemble d'enregistrements résumant une distribution de données raster ou de couverture raster, dans des classes distinctes. Le nombre de classes est calculé automatiquement s'il n'est pas spécifié.

note: Tag: para
en: Returns set of records consisting of min, max, count, percent for a given raster band for each bin. If no band is specified <varname>nband</varname> defaults to 1.
fr: Retourne un ensemble d'enregistrements composés de min, max, count, percent pour une bande raster donnée pour chaque classe. Si aucune bande <varname>nband</varname> n'est spécifiée, la bande 1 est utilisée.

note: Tag: para
en: By default only considers pixel values not equal to the <varname>nodata</varname> value . Set <varname>exclude_nodata_value</varname> to false to get count all pixels.
fr: Par défaut, seules les valeurs de pixels différentes de la valeur <varname>nodata</varname> sont prises en compte. Définir <varname>exclude_nodata_value</varname> à false pour obtenir le comptage de tous les pixels.

note: Tag: para
en: width: an array indicating the width of each category/bin. If the number of bins is greater than the number of widths, the widths are repeated.
fr: width : un tableau indiquant la largeur de chaque classe. Si le nombre de classes est supérieur au nombre de largeurs, les largeurs sont répétées.

note: Tag: para
en: Example: 9 bins, widths are [a, b, c] will have the output be [a, b, c, a, b, c, a, b, c]
fr: Exemple : 9 classes, les largeurs étant [a, b, c], le résultat sera [a, b, c, a, b, c, a, b, c]

note: Tag: para
en: Number of breakouts -- this is the number of records you'll get back from the function if specified. If not specified then the number of breakouts is autocomputed.
fr: Nombre de classes -- c'est le nombre d'enregistrements retournés par la fonction si spécifié. Si non spécifié, le nombre de classes est calculé automatiquement.

note: Tag: para
en: compute the histogram from the right rather than from the left (default). This changes the criteria for evaluating a value x from [a, b) to (a, b]
fr: calcule l'histogramme à partir de la droite plutôt que de la gauche (par défaut). Cela modifie les critères d'évaluation d'une valeur x de [a, b) à (a, b]

note: Tag: para
en: Changed: 3.1.0 Removed ST_Histogram(table_name, column_name) variant.
fr: Changement : 3.1.0 Suppression de la variante ST_Histogram(table_name, column_name).

note: Tag: title
en: Example: Single raster tile - compute histograms for bands 1, 2, 3 and autocompute bins
fr: Exemple : Une seule tuile raster - calcul des histogrames pour les bandes 1, 2, 3 avec calcul automatique des classes

note: Tag: title
en: Example: Just band 2 but for 6 bins
fr: Exemple : Seulement la bande 2, mais avec 6 classes

note: Tag: refpurpose
en: <refpurpose>Compute quantiles for a raster or raster table coverage in the context of the sample or population. Thus, a value could be examined to be at the raster's 25%, 50%, 75% percentile.</refpurpose>
fr: <refpurpose>Calcule les quantiles d'un raster ou d'une couverture raster, dans le contexte de l'échantillon ou de la population. Ainsi, une valeur peut être examinée pour se situer au percentile de 25%, 50% ou 75% du raster.</refpurpose>

note: Tag: para
en: <para>Compute quantiles for a raster or raster table coverage in the context of the sample or population. Thus, a value could be examined to be at the raster's 25%, 50%, 75% percentile.</para>
fr: <para>Calcule les quantiles d'un raster ou d'une couverture raster, dans le contexte de l'échantillon ou de la population. Ainsi, une valeur peut être examinée pour se situer au percentile de 25%, 50% ou 75% du raster.</para>

note: Tag: para
en: If <varname>exclude_nodata_value</varname> is set to false, will also count pixels with no data.
fr: Si <varname>exclude_nodata_value</varname> est false, les pixels de valeur nodata seront également pris en compte.

note: Tag: para
en: Changed: 3.1.0 Removed ST_Quantile(table_name, column_name) variant.
fr: Changement : 3.1.0 Suppression de la variante ST_Quantile(table_name, column_name).

note: Tag: refpurpose
en: Returns summarystats consisting of count, sum, mean, stddev, min, max for a given raster band of a raster or raster coverage. Band 1 is assumed is no band is specified.
fr: Retourne des résumés statistiques (count, sum, mean, stddev, min, max) pour une bande raster ou une couverture raster spécifiée. Si aucune bande n'est spécifiée, la bande 1 est utilisée.

note: Tag: para
en: Returns <xref linkend="summarystats"/> consisting of count, sum, mean, stddev, min, max for a given raster band of a raster or raster coverage. If no band is specified <varname>nband</varname> defaults to 1.
fr: Retourne un résumé statistique <xref linkend="summarystats"/> composé de count, sum, mean, stddev, min, max pour une bande raster ou une couverture raster spécifiée. Si aucune bande <varname>nband</varname> n'est spécifiée, la bande 1 est utilisée.

note: Tag: para
en: By default only considers pixel values not equal to the <varname>nodata</varname> value. Set <varname>exclude_nodata_value</varname> to false to get count of all pixels.
fr: Par défaut, seules les valeurs de pixels différentes de la valeur <varname>nodata</varname> sont prises en compte. Définir <varname>exclude_nodata_value</varname> à false pour obtenir le comptage de tous les pixels.

note: Tag: para
en: By default will sample all pixels. To get faster response, set <varname>sample_percent</varname> to lower than 1
fr: Par défaut, tous les pixels sont échantillonnés. Pour obtenir une réponse plus rapide, définir <varname>sample_percent</varname> à une valeur inférieure à 1

note: Tag: para
en: Changed: 3.1.0 ST_SummaryStats(rastertable, rastercolumn, ...) variants are removed. Use <xref linkend="RT_ST_SummaryStatsAgg"/> instead.
fr: Changement : 3.1.0 Suppression des variantes ST_SummaryStats(rastertable, rastercolumn, ...). Utiliser <xref linkend="RT_ST_SummaryStatsAgg"/> à la place.

note: Tag: title
en: Example: Single raster tile
fr: Exemple : Une seule tuile raster

note: Tag: title
en: Example: Summarize pixels that intersect buildings of interest
fr: Exemple : Statistiques des pixels qui intersectent des bâtiments d'intérêt

note: Tag: para
en: This example took 574ms on PostGIS windows 64-bit with all of Boston Buildings and aerial Tiles (tiles each 150x150 pixels ~ 134,000 tiles), ~102,000 building records
fr: Cet exemple a pris 574 ms sur PostGIS Windows 64-bit avec tous les bâtiments de Boston et les tuiles aériennes (tuiles de 150x150 pixels chacune ~ 134 000 tuiles), ~102 000 enregistrements de bâtiments

note: Tag: title
en: Example: Raster coverage
fr: Exemple : Couverture raster

note: Tag: refpurpose
en: Aggregate. Returns summarystats consisting of count, sum, mean, stddev, min, max for a given raster band of a set of raster. Band 1 is assumed is no band is specified.
fr: Agrégat. Retourne des résumés statistiques (count, sum, mean, stddev, min, max) pour une bande raster spécifiée pour une ensemble de rasters. Si aucune bande n'est spécifiée, la bande 1 est utilisée.

note: Tag: para
en: By default only considers pixel values not equal to the <varname>NODATA</varname> value. Set <varname>exclude_nodata_value</varname> to False to get count of all pixels.
fr: Par défaut, seules les valeurs de pixels différentes de la valeur <varname>NODATA</varname> sont prises en compte. Définir <varname>exclude_nodata_value</varname> à false pour obtenir le comptage de tous les pixels.

note: Tag: para
en: By default will sample all pixels. To get faster response, set <varname>sample_percent</varname> to value between 0 and 1
fr: Par défaut, tous les pixels sont échantillonnés. Pour obtenir une réponse plus rapide, définir <varname>sample_percent</varname> à une valeur comprise entre zéro (0) et un (1)

note: Tag: refpurpose
en: Returns a set of records containing a pixel band value and count of the number of pixels in a given band of a raster (or a raster coverage) that have a given set of values. If no band is specified defaults to band 1. By default nodata value pixels are not counted. and all other values in the pixel are output and pixel band values are rounded to the nearest integer.
fr: Retourne un ensemble d'enregistrements contenant une valeur de pixels et le nombre de pixels ayant cette valeur dans la bande du raster spécifié (ou de la couverture raster). Si aucune bande n'est spécifiée, la bande 1 est utilisée. Par défaut, les pixels de valeur nodata ne sont pas comptés, et toutes les autres valeurs sont retournées, avec leur valeur arrondies à l'entier le plus proche.

note: Tag: para
en: Returns a set of records with columns <varname>value</varname> <varname>count</varname> which contain the pixel band value and count of pixels in the raster tile or raster coverage of selected band.
fr: Retourne un ensemble d'enregistrements contenant les colonnes <varname>value</varname> <varname>count</varname>, correspondant à la valeur de pixel dans la bande et le nombre de pixels ayant cette valeur dans la bande du raster spécifié (ou de la couverture raster).

note: Tag: para
en: If no band is specified <varname>nband</varname> defaults to 1. If no <varname>searchvalues</varname> are specified, will return all pixel values found in the raster or raster coverage. If one searchvalue is given, will return an integer instead of records denoting the count of pixels having that pixel band value
fr: Si aucune bande <varname>nband</varname> n'est spécifiée, la bande 1 est utilisée. Si aucune valeur <varname>searchvalues</varname> n'est spécifiée, retourne toutes les valeurs de pixel trouvées dans le raster ou dans la couverture raster. Si une valeur searchvalue est spécifiée, retourne un entier au lieu d'enregistrements, correspondant au nombre de pixels ayant la valeur recherchée

note: Tag: title
en: Raster Inputs
fr: Import de raster

note: Tag: refpurpose
en: Return a raster value from a Well-Known Binary (WKB) raster.
fr: Retourne un raster à partir d'un raster Well-Known Binary (WKB).

note: Tag: para
en: Given a Well-Known Binary (WKB) raster, return a raster.
fr: Construit un raster PostGIS à partir d'une représentation raster Well-Known Binary (WKB).

note: Tag: refpurpose
en: Return a raster value from a Hex representation of Well-Known Binary (WKB) raster.
fr: Retourne un raster à partir d'un raster Well-Known Binary (WKB) en hexadécimal.

note: Tag: para
en: Given a Well-Known Binary (WKB) raster in Hex representation, return a raster.
fr: Construit un raster PostGIS à partir d'une représentation hexadécimale raster Well-Known Binary (WKB).

note: Tag: title
en: Raster Outputs
fr: Export de raster

note: Tag: refpurpose
en: Return the Well-Known Binary (WKB) representation of the raster.
fr: Retourne la représentation Well-Known Binary (WKB) de ce raster.

note: Tag: para
en: Returns the Binary representation of the raster. If <varname>outasin</varname> is TRUE, out-db bands are treated as in-db. Refer to raster/doc/RFC2-WellKnownBinaryFormat located in the PostGIS source folder for details of the representation.
fr: Retourne la représentation binaire du raster. Si <varname>outasin</varname> est TRUE, les bandes out-db sont traitées comme in-db. Voir raster/doc/RFC2-WellKnownBinaryFormat situé dans le dossier source de PostGIS pour plus de détails sur la représentation.

note: Tag: para
en: This is useful in binary cursors to pull data out of the database without converting it to a string representation.
fr: Cette fonction est utile dans les curseurs binaires pour extraire des données de la base de données sans les convertir en une représentation sous forme de chaîne de caractères.

note: Tag: para
en: By default, WKB output contains the external file path for out-db bands. If the client does not have access to the raster file underlying an out-db band, set <varname>outasin</varname> to TRUE.
fr: Par défaut, la sortie WKB contient le chemin d'accès au fichier externe pour les bandes out-db. Si le client n'a pas accès au fichier raster sous-jacent d'une bande out-db, définir <varname>outasin</varname> à TRUE.

note: Tag: para
en: Enhanced: 2.1.0 Addition of <varname>outasin</varname>
fr: Amélioration : 2.1.0 Ajout de <varname>outasin</varname>

note: Tag: para
en: Enhanced: 2.5.0 Addition of <varname>ST_AsWKB</varname>
fr: Amélioration : 2.5.0 Ajout de <varname>ST_AsWKB</varname>

note: Tag: refpurpose
en: Return the Well-Known Binary (WKB) in Hex representation of the raster.
fr: Retourne la représentation hexadécimale Well-Known Binary (WKB) de ce raster.

note: Tag: para
en: Returns the Binary representation in Hex representation of the raster. If <varname>outasin</varname> is TRUE, out-db bands are treated as in-db. Refer to raster/doc/RFC2-WellKnownBinaryFormat located in the PostGIS source folder for details of the representation.
fr: Retourne la représentation binaire en hexadécimal du raster. Si <varname>outasin</varname> est TRUE, les bandes out-db sont traitées comme in-db. Voir raster/doc/RFC2-WellKnownBinaryFormat situé dans le dossier source de PostGIS pour les détails de la représentation.

note: Tag: para
en: By default, Hex WKB output contains the external file path for out-db bands. If the client does not have access to the raster file underlying an out-db band, set <varname>outasin</varname> to TRUE.
fr: Par défaut, la sortie Hex WKB contient le chemin d'accès au fichier externe pour les bandes out-db. Si le client n'a pas accès au fichier raster sous-jacent de la bande out-db, définir <varname>outasin</varname> à TRUE.

note: Tag: refpurpose
en: Return the raster tile in the designated GDAL Raster format. Raster formats are one of those supported by your compiled library. Use ST_GDALDrivers() to get a list of formats supported by your library.
fr: Retourne la tuile raster dans le format GDAL raster spécifié. Les formats raster disponibles sont ceux supportés par votre bibliothèque compilée. Utilisez ST_GDALDrivers() pour obtenir la liste des formats supportés par votre bibliothèque.

note: Tag: para
en: Returns the raster tile in the designated format. Arguments are itemized below:
fr: Retourne la tuile raster dans le format spécifié. Les paramètres sont détaillés ci-dessous :

note: Tag: para
en: <varname>format</varname> format to output. This is dependent on the drivers compiled in your libgdal library. Generally available are 'JPEG', 'GTIff', 'PNG'. Use <xref linkend="RT_ST_GDALDrivers"/> to get a list of formats supported by your library.
fr: <varname>format</varname> format de sortie. Cela dépend des drivers compilés dans votre bibliothèque libgdal. Les formats généralement disponibles sont 'JPEG', 'GTIff', 'PNG'. Utilisez <xref linkend="RT_ST_GDALDrivers"/> pour obtenir une liste des formats pris en charge par votre bibliothèque.

note: Tag: para
en: <varname>options</varname> text array of GDAL options. Valid options are dependent on the format. Refer to <link xlink:href="http://www.gdal.org/frmt_various.html">GDAL Raster format options</link> for more details.
fr: <varname>options</varname> tableau textuel d'options GDAL. Les options valides dépendent du format. Pour plus de détails, voir <link xlink:href="http://www.gdal.org/frmt_various.html">GDAL Raster format options</link>.

note: Tag: para
en: <varname>srs</varname> The proj4text or srtext (from spatial_ref_sys) to embed in the image
fr: <varname>srs</varname> La chaîne proj4text ou srtext (issue de spatial_ref_sys) à incorporer dans l'image

note: Tag: title
en: JPEG Output Example, multiple tiles as single raster
fr: Exemple de sortie JPEG, plusieurs tuiles en un seul raster

note: Tag: title
en: Using PostgreSQL Large Object Support to export raster
fr: Utilisation de PostgreSQL Large Object Support pour exporter des données raster

note: Tag: para
en: One way to export raster into another format is using <link xlink:href="https://www.postgresql.org/docs/current/static/lo-funcs.html">PostgreSQL large object export functions</link>. We'lll repeat the prior example but also exporting. Note for this you'll need to have super user access to db since it uses server side lo functions. It will also export to path on server network. If you need export locally, use the psql equivalent lo_ functions which export to the local file system instead of the server file system.
fr: Une façon d'exporter des données raster vers un autre format est d'utiliser <link xlink:href="https://www.postgresql.org/docs/current/static/lo-funcs.html">les fonctions d'exportation de grands objets de PostgreSQL</link>. Nous allons reprendre l'exemple précédent en ajoutant l'export. Notez que vous devrez avoir un accès super utilisateur à la base de données car elle utilise les fonctions lo côté serveur. L'exportation se fera également vers un chemin d'accès sur le réseau du serveur. Si vous avez besoin d'exporter localement, utilisez les fonctions lo_ équivalentes de psql qui exportent vers le système de fichiers local au lieu du système de fichiers du serveur.

note: Tag: title
en: GTIFF Output Examples
fr: Exemples de sorties GTIFF

note: Tag: refpurpose
en: Return the raster tile selected bands as a single Joint Photographic Exports Group (JPEG) image (byte array). If no band is specified and 1 or more than 3 bands, then only the first band is used. If only 3 bands then all 3 bands are used and mapped to RGB.
fr: Retourne les bandes sélectionnées du raster sous la forme d'une image JPEG (sous forme de tableau d'octets). Si aucune bande n'est spécifiée, et que le raster a 1 ou plus de 3 bandes, seule la première bande est utilisée. Si le raster a exactement 3 bandes, les 3 bandes sont utilisées et mappées en RGB.

note: Tag: para
en: Returns the selected bands of the raster as a single Joint Photographic Exports Group Image (JPEG). Use <xref linkend="RT_ST_AsGDALRaster"/> if you need to export as less common raster types. If no band is specified and 1 or more than 3 bands, then only the first band is used. If 3 bands then all 3 bands are used. There are many variants of the function with many options. These are itemized below:
fr: Retourne les bandes sélectionnées du raster sous la forme d'une seule image JPEG (Joint Photographic Exports Group Image). Utilisez <xref linkend="RT_ST_AsGDALRaster"/> si vous avez besoin d'exporter vers des types de raster moins courants. Si aucune bande n'est spécifiée, et que le raster a 1 ou plus de 3 bandes, seule la première bande est utilisée. Si le raster a exactement 3 bandes, les 3 bandes sont utilisées. Il existe de nombreuses variantes de la fonction avec de nombreuses options. Celles-ci sont détaillées ci-dessous :

note: Tag: para
en: <varname>nband</varname> is for single band exports.
fr: <varname>nband</varname> pour exporter une seule bande.

note: Tag: para
en: <varname>nbands</varname> is an array of bands to export (note that max is 3 for JPEG) and the order of the bands is RGB. e.g ARRAY[3,2,1] means map band 3 to Red, band 2 to green and band 1 to blue
fr: <varname>nbands</varname> spécifie un tableau des bandes à exporter (à noter que JPEG ne supporte que 3 bandes aux maximum). L'ordre des bandes est RGB. Par exemple, ARRAY[3,2,1] signifie que la bande 3 est la rouge, la bande 2 est la verte et la bande 1 est la bleue

note: Tag: para
en: <varname>quality</varname> number from 0 to 100. The higher the number the crisper the image.
fr: <varname>quality</varname> nombre de 0 à 100. Plus le chiffre est élevé, plus l'image est nette.

note: Tag: para
en: <varname>options</varname> text Array of GDAL options as defined for JPEG (look at create_options for JPEG <xref linkend="RT_ST_GDALDrivers"/>). For JPEG valid ones are <varname>PROGRESSIVE</varname> ON or OFF and <varname>QUALITY</varname> a range from 0 to 100 and default to 75. Refer to <link xlink:href="http://www.gdal.org/frmt_various.html">GDAL Raster format options</link> for more details.
fr: <varname>options</varname> tableau textuel d'options GDAL, parmi les options définies pour JPEG (voir create_options pour JPEG de <xref linkend="RT_ST_GDALDrivers"/>). Pour JPEG, les options disponibles sont <varname>PROGRESSIVE</varname> ON ou OFF et <varname>QUALITY</varname> une valeur de 0 à 100 et par défaut 75. Voir <link xlink:href="http://www.gdal.org/frmt_various.html">GDAL Raster format options</link> pour plus de détails.

note: Tag: title
en: Examples: Output
fr: Exemples : Export

note: Tag: refpurpose
en: Return the raster tile selected bands as a single portable network graphics (PNG) image (byte array). If 1, 3, or 4 bands in raster and no bands are specified, then all bands are used. If more 2 or more than 4 bands and no bands specified, then only band 1 is used. Bands are mapped to RGB or RGBA space.
fr: Retourne les bandes sélectionnées du raster sous la forme d'une image PNG (sous forme de tableau d'octets). Si aucune bande n'est spécifiée et que le raster a 1, 3 ou 4 bandes, toutes les bandes sont utilisées. Si aucune bande n'est spécifiée et que le raster a 2 ou plus de 4 bandes, seule la bande 1 est utilisée. Les bandes sont mappées en RGB ou RGBA.

note: Tag: para
en: Returns the selected bands of the raster as a single Portable Network Graphics Image (PNG). Use <xref linkend="RT_ST_AsGDALRaster"/> if you need to export as less common raster types. If no band is specified, then the first 3 bands are exported. There are many variants of the function with many options. If no <varname>srid</varname> is specified then then srid of the raster is used. These are itemized below:
fr: Retourne les bandes sélectionnées du raster sous la forme d'une seule PNG (image graphique portable). Utilisez <xref linkend="RT_ST_AsGDALRaster"/> si vous avez besoin d'exporter vers des types de raster moins courants. Si aucune bande n'est spécifiée, les 3 premières bandes sont exportées. Il existe de nombreuses variantes de cette fonction avec de nombreuses options. Si aucun <varname>srid</varname> n'est spécifié, c'est le srid du raster qui est utilisé. Ces options sont détaillées ci-dessous :

note: Tag: para
en: <varname>nbands</varname> is an array of bands to export (note that max is 4 for PNG) and the order of the bands is RGBA. e.g ARRAY[3,2,1] means map band 3 to Red, band 2 to green and band 1 to blue
fr: <varname>nbands</varname> spécifie un tableau des bandes à exporter (à noter que PNG ne supporte que 4 bandes aux maximum). L'ordre des bandes est RGBA. Par exemple, ARRAY[3,2,1] signifie que la bande 3 est la rouge, la bande 2 est la verte et la bande 1 est la bleue

note: Tag: para
en: <varname>compression</varname> number from 1 to 9. The higher the number the greater the compression.
fr: <varname>compression</varname> nombre de 1 à 9. Plus le chiffre est élevé, plus la compression est importante.

note: Tag: para
en: <varname>options</varname> text Array of GDAL options as defined for PNG (look at create_options for PNG of <xref linkend="RT_ST_GDALDrivers"/>). For PNG valid one is only ZLEVEL (amount of time to spend on compression -- default 6) e.g. ARRAY['ZLEVEL=9']. WORLDFILE is not allowed since the function would have to output two outputs. Refer to <link xlink:href="http://www.gdal.org/frmt_various.html">GDAL Raster format options</link> for more details.
fr: <varname>options</varname> tableau textuel d'options GDAL, parmi les options définies pour PNG (voir create_options pour PNG de <xref linkend="RT_ST_GDALDrivers"/>). Pour PNG, seule l'option ZLEVEL est valide (temps à consacrer à la compression -- par défaut 6), par exemple ARRAY['ZLEVEL=9']. WORLDFILE n'est pas autorisé car la fonction devrait produire deux sorties. Voir <link xlink:href="http://www.gdal.org/frmt_various.html">GDAL Raster format options</link> pour plus de détails.

note: Tag: refpurpose
en: Return the raster selected bands as a single TIFF image (byte array). If no band is specified or any of specified bands does not exist in the raster, then will try to use all bands.
fr: Retourne les bandes sélectionnées du raster sous la forme d'une seule image TIFF (sous forme de tableau d'octets). Si aucune bande n'est spécifiée ou si l'une des bandes spécifiées n'existe pas dans le raster, toutes les bandes sont utilisées.

note: Tag: para
en: Returns the selected bands of the raster as a single Tagged Image File Format (TIFF). If no band is specified, will try to use all bands. This is a wrapper around <xref linkend="RT_ST_AsGDALRaster"/>. Use <xref linkend="RT_ST_AsGDALRaster"/> if you need to export as less common raster types. There are many variants of the function with many options. If no spatial reference SRS text is present, the spatial reference of the raster is used. These are itemized below:
fr: Retourne les bandes sélectionnées du raster sous la forme d'un fichier TIFF (Tagged Image File Format). Si aucune bande n'est spécifiée, toutes les bandes seront utilisées. Cette fonction est une enveloppe autour de <xref linkend="RT_ST_AsGDALRaster"/>. Utilisez <xref linkend="RT_ST_AsGDALRaster"/> si vous avez besoin d'exporter vers des types de raster moins courants. Il existe de nombreuses variantes de la fonction avec de nombreuses options. Si aucun texte SRS de référence spatiale n'est présent, la référence spatiale du raster est utilisée. Ces options sont détaillées ci-dessous :

note: Tag: para
en: <varname>nbands</varname> is an array of bands to export (note that max is 3 for PNG) and the order of the bands is RGB. e.g ARRAY[3,2,1] means map band 3 to Red, band 2 to green and band 1 to blue
fr: <varname>nbands</varname> spécifie un tableau des bandes à exporter (à noter que PNG ne supporte que 3 bandes aux maximum). L'ordre des bandes est RGB. Par exemple, ARRAY[3,2,1] signifie que la bande 3 est la rouge, la bande 2 est la verte et la bande 1 est la bleue

note: Tag: para
en: <varname>compression</varname> Compression expression -- JPEG90 (or some other percent), LZW, JPEG, DEFLATE9.
fr: <varname>compression</varname> Expression de compression -- JPEG90 (ou un autre pourcentage), LZW, JPEG, DEFLATE9.

note: Tag: para
en: <varname>options</varname> text Array of GDAL create options as defined for GTiff (look at create_options for GTiff of <xref linkend="RT_ST_GDALDrivers"/>). or refer to <link xlink:href="http://www.gdal.org/frmt_various.html">GDAL Raster format options</link> for more details.
fr: <varname>options</varname> tableau textuel d'options GDAL, parmi les options définies pour GTiff (voir create_options pour GTiff de <xref linkend="RT_ST_GDALDrivers"/>). Voir <link xlink:href="http://www.gdal.org/frmt_various.html">GDAL Raster format options</link> pour plus de détails.

note: Tag: para
en: <varname>srid</varname> srid of spatial_ref_sys of the raster. This is used to populate the georeference information
fr: <varname>srid</varname> srid du système de référence spatial du raster. Il est utilisé pour remplir les informations de géo-référence

note: Tag: title
en: Examples: Use jpeg compression 90%
fr: Exemple : Utiliser la compression jpeg à 90%

note: Tag: title
en: Raster Processing: Map Algebra
fr: Traitement des données raster : algèbre cartographique

note: Tag: para
en: Returns a raster that is clipped by the input geometry <varname>geom</varname>. If band index is not specified, all bands are processed.
fr: Retourne un raster coupé par la géométrie d'entrée <varname>geom</varname>. Si l'index des bandes n'est pas spécifié, toutes les bandes sont traitées.

note: Tag: para
en: Rasters resulting from ST_Clip must have a nodata value assigned for areas clipped, one for each band. If none are provided and the input raster do not have a nodata value defined, nodata values of the resulting raster are set to ST_MinPossibleValue(ST_BandPixelType(rast, band)). When the number of nodata value in the array is smaller than the number of band, the last one in the array is used for the remaining bands. If the number of nodata value is greater than the number of band, the extra nodata values are ignored. All variants accepting an array of nodata values also accept a single value which will be assigned to each band.
fr: Les rasters résultant de ST_Clip doivent avoir une valeur de nodata assignée pour les zones découpées, une pour chaque bande. Si aucune valeur n'est fournie et que le raster d'entrée n'a pas de valeur de nodata définie, les valeurs de nodata du raster résultant sont fixées à ST_MinPossibleValue(ST_BandPixelType(rast, band)). Lorsque la taille du tableau nodata inférieure au nombre de bandes, la dernière valeur du tableau est utilisée pour les bandes restantes. Si la taille du tableau nodata est supérieure au nombre de bandes, les valeurs de nodata supplémentaires sont ignorées. Toutes les variantes acceptant un tableau de valeurs de nodata acceptent également une valeur unique qui sera assignée à chaque bande.

note: Tag: para
en: If <varname>crop</varname> is not specified, true is assumed meaning the output raster is cropped to the intersection of the <varname>geom</varname>and <varname>rast</varname> extents. If <varname>crop</varname> is set to false, the new raster gets the same extent as <varname>rast</varname>. If <varname>touched</varname> is set to true, then all pixels in the <varname>rast</varname> that intersect the geometry are selected.
fr: Si <varname>crop</varname> n'est pas spécifié ou si défini à true, le raster de sortie est recadré à l'intersection des extensions <varname>geom</varname>et <varname>rast</varname>. Si <varname>crop</varname> est défini à false, le nouveau raster a la même étendue que <varname>rast</varname>. Si <varname>touched</varname> est défini comme vrai, tous les pixels de <varname>rast</varname> qui intersectent la géométrie sont sélectionnés.

note: Tag: para
en: The default behavior is touched=false, which will only select pixels where the center of the pixel is covered by the geometry.
fr: Le comportement par défaut est touched=false, ce qui sélectionnera uniquement les pixels dont le centre est couvert par la géométrie.

note: Tag: para
en: Enhanced: 3.5.0 - touched argument added.
fr: Amélioration : 3.5.0 - ajout de l'argument touched.

note: Tag: para
en: Enhanced: 2.1.0 Rewritten in C
fr: Amélioration : 2.1.0 Réécrit en C

note: Tag: para
en: Examples here use Massachusetts aerial data available on MassGIS site <link xlink:href="https://www.mass.gov/info-details/massgis-data-20082009-aerial-imagery">MassGIS Aerial Orthos</link>.
fr: Les exemples présentés ici utilisent les données aériennes du Massachusetts disponibles sur le site de MassGIS <link xlink:href="https://www.mass.gov/info-details/massgis-data-20082009-aerial-imagery">MassGIS Aerial Orthos</link>.

note: Tag: title
en: Examples: Comparing selecting all touched vs. not all touched
fr: Exemples : Comparaison entre la sélection des pixels intersectés et non

note: Tag: title
en: Examples: 1 band clipping (not touched)
fr: Exemples : Coupe d'une bande (non modifiée)

note: Tag: para
en: Full raster tile before clipping
fr: Tuile raster complète avant découpe

note: Tag: para
en: After Clipping
fr: Après découpe

note: Tag: title
en: Examples: 1 band clipping with no crop and add back other bands unchanged
fr: Exemples : Coupe d'une bande sans recadrage et ajout d'autres bandes inchangées

note: Tag: para
en: After Clipping - surreal
fr: Après découpe - surréaliste

note: Tag: title
en: Examples: Clip all bands
fr: Exemples : Coupe de toutes les bandes

note: Tag: refpurpose
en: Creates a new raster of up to four 8BUI bands (grayscale, RGB, RGBA) from the source raster and a specified band. Band 1 is assumed if not specified.
fr: Crée un nouveau raster comprenant jusqu'à quatre bandes 8BUI (niveaux de gris, RGB, RGBA) à partir du raster source et d'une bande spécifiée. Si aucune bande n'est spécifiée, la bande 1 est utilisée.

note: Tag: para
en: Apply a <varname>colormap</varname> to the band at <varname>nband</varname> of <varname>rast</varname> resulting a new raster comprised of up to four 8BUI bands. The number of 8BUI bands in the new raster is determined by the number of color components defined in <varname>colormap</varname>.
fr: Appliquer une palette de couleurs <varname>colormap</varname> à la bande <varname>nband</varname> du raster <varname>rast</varname>, pour obtenir un nouveau raster comprenant jusqu'à quatre bandes 8BUI. Le nombre de bandes 8BUI dans le nouveau raster est déterminé par le nombre de composantes de couleur définies dans <varname>colormap</varname>.

note: Tag: para
en: If <varname>nband</varname> is not specified, then band 1 is assumed.
fr: Si <varname>nband</varname> n'est pas spécifié, la bande 1 est utilisée.

note: Tag: para
en: <varname>colormap</varname> can be a keyword of a pre-defined colormap or a set of lines defining the value and the color components.
fr: <varname>colormap</varname> peut être un mot-clé d'une palette de couleurs prédéfinie, ou un ensemble de lignes définissant la valeur et les composants de couleur.

note: Tag: para
en: Valid pre-defined <varname>colormap</varname> keyword:
fr: Valeurs prédéfinies disponibles pour <varname>colormap</varname> :

note: Tag: para
en: <varname>grayscale</varname> or <varname>greyscale</varname> for a one 8BUI band raster of shades of gray.
fr: <varname>grayscale</varname> ou <varname>greyscale</varname> pour un raster à 1 bande 8BUI en nuances de gris.

note: Tag: para
en: <varname>pseudocolor</varname> for a four 8BUI (RGBA) band raster with colors going from blue to green to red.
fr: <varname>pseudocolor</varname> pour un raster à 4 bandes 8BUI (RGBA) avec des couleurs allant du bleu au rouge en passant par le vert.

note: Tag: para
en: <varname>fire</varname> for a four 8BUI (RGBA) band raster with colors going from black to red to pale yellow.
fr: <varname>fire</varname> pour un raster à 4 bandes 8BUI (RGBA) avec des couleurs allant du noir au rouge en passant par le jaune pâle.

note: Tag: para
en: <varname>bluered</varname> for a four 8BUI (RGBA) band raster with colors going from blue to pale white to red.
fr: <varname>bluered</varname> pour un raster à 4 bandes 8BUI (RGBA) avec des couleurs allant du bleu au rouge en passant par le blanc pâle.

note: Tag: para
en: Users can pass a set of entries (one per line) to <varname>colormap</varname> to specify custom colormaps. Each entry generally consists of five values: the pixel value and corresponding Red, Green, Blue, Alpha components (color components between 0 and 255). Percent values can be used instead of pixel values where 0% and 100% are the minimum and maximum values found in the raster band. Values can be separated with commas (','), tabs, colons (':') and/or spaces. The pixel value can be set to <emphasis>nv</emphasis>, <emphasis>null</emphasis> or <emphasis>nodata</emphasis> for the NODATA value. An example is provided below.
fr: Vous pouvez passer un ensemble d'entrées (une par ligne) à <varname>colormap</varname> pour spécifier des palettes de couleurs personnalisées. Chaque entrée se compose généralement de cinq valeurs : la valeur du pixel et les composantes rouge, verte, bleue et alpha correspondantes (composantes de couleur comprises entre 0 et 255). Des valeurs en pourcentage peuvent être utilisées à la place des valeurs en pixels, où 0% et 100% sont les valeurs minimales et maximales trouvées dans la bande raster. Les valeurs peuvent être séparées par des virgules (','), des tabulations, des deux-points (':') et/ou des espaces. La valeur du pixel peut être fixée à <emphasis>nv</emphasis>, <emphasis>null</emphasis> ou <emphasis>nodata</emphasis> pour la valeur NODATA. Un exemple est fourni ci-dessous.

note: Tag: para
en: The syntax of <varname>colormap</varname> is similar to that of the color-relief mode of GDAL <link xlink:href="http://www.gdal.org/gdaldem.html#gdaldem_color_relief">gdaldem</link>.
fr: La syntaxe de <varname>colormap</varname> est similaire à celle du mode couleur du relief de GDAL <link xlink:href="http://www.gdal.org/gdaldem.html#gdaldem_color_relief">gdaldem</link>.

note: Tag: para
en: Valid keywords for <varname>method</varname>:
fr: Valeurs disponibles pour <varname>method</varname> :

note: Tag: para
en: <varname>INTERPOLATE</varname> to use linear interpolation to smoothly blend the colors between the given pixel values
fr: <varname>INTERPOLATE</varname> pour utiliser l'interpolation linéaire afin de mélanger les couleurs entre les valeurs de pixels données

note: Tag: para
en: <varname>EXACT</varname> to strictly match only those pixels values found in the colormap. Pixels whose value does not match a colormap entry will be set to 0 0 0 0 (RGBA)
fr: <varname>EXACT</varname> pour correspondre strictement aux valeurs des pixels trouvés dans la palette de couleurs. Les pixels dont la valeur ne correspond pas à une entrée de la palette de couleurs seront mis à 0 0 0 0 (RGBA)

note: Tag: para
en: <varname>NEAREST</varname> to use the colormap entry whose value is closest to the pixel value
fr: <varname>NEAREST</varname> pour utiliser l'entrée de la palette de couleurs dont la valeur est la plus proche de la valeur du pixel

note: Tag: para
en: A great reference for colormaps is <link xlink:href="http://www.colorbrewer2.org">ColorBrewer</link>.
fr: Une excellente référence pour les palette de couleurs est <link xlink:href="http://www.colorbrewer2.org">ColorBrewer</link>.

note: Tag: para
en: The resulting bands of new raster will have no NODATA value set. Use <xref linkend="RT_ST_SetBandNoDataValue"/> to set a NODATA value if one is needed.
fr: Les bandes résultantes du nouveau raster n'auront pas de valeur NODATA définie. Utilisez <xref linkend="RT_ST_SetBandNoDataValue"/> pour définir une valeur NODATA si nécessaire.

note: Tag: para
en: This is a junk table to play with
fr: Définit une table de bric-à-brac pour jouer

note: Tag: title
en: Examples: Compare different color map looks using ST_AsPNG
fr: Exemples : Comparaison de différentes palettes de couleurs via ST_AsPNG

note: Tag: refpurpose
en: Creates a new one-8BUI band raster from the source raster and specified bands representing Red, Green and Blue
fr: Crée un nouveau raster à 1 bande 8BUI à partir du raster source et des bandes spécifiées représentant les composantes rouge, vert et bleu

note: Tag: para
en: Create a raster with one 8BUI band given three input bands (from one or more rasters). Any input band whose pixel type is not 8BUI will be reclassified using <xref linkend="RT_ST_Reclass"/>.
fr: Crée un raster à 1 bande 8BUI à partir de trois bandes d'entrée (provenant d'un ou plusieurs rasters). Toute bande d'entrée dont le type de pixel n'est pas 8BUI sera reclassée avec <xref linkend="RT_ST_Reclass"/>.

note: Tag: para
en: This function is not like <xref linkend="RT_ST_ColorMap"/> with the <varname>grayscale</varname> keyword as ST_ColorMap operates on only one band while this function expects three bands for RGB. This function applies the following equation for converting RGB to Grayscale: 0.2989 * RED + 0.5870 * GREEN + 0.1140 * BLUE
fr: Cette fonction est différente de <xref linkend="RT_ST_ColorMap"/> avec le mot-clé <varname>grayscale</varname>, car ST_ColorMap n'opère que sur une seule bande alors que cette fonction s'attend à trois bandes pour RGB. Cette fonction applique l'équation suivante pour convertir les composantes RGB en niveaux de gris : 0,2989 * ROUGE + 0,5870 * VERT + 0,1140 * BLEU

note: Tag: refpurpose
en: <refpurpose>Returns a raster or a set of geometry-pixelvalue pairs representing the shared portion of two rasters or the geometrical intersection of a vectorization of the raster and a geometry.</refpurpose>
fr: <refpurpose>Retourne un raster ou un ensemble de paires (géométrie, valeur de pixel) représentant la partie partagée de deux rasters ou l'intersection géométrique d'une vectorisation du raster et d'une géométrie.</refpurpose>

note: Tag: para
en: <para>Returns a raster or a set of geometry-pixelvalue pairs representing the shared portion of two rasters or the geometrical intersection of a vectorization of the raster and a geometry.</para>
fr: <para>Retourne un raster ou un ensemble de paires (géométrie, valeur de pixel) représentant la partie partagée de deux rasters ou l'intersection géométrique d'une vectorisation du raster et d'une géométrie.</para>

note: Tag: para
en: The first three variants, returning a setof geomval, works in vector space. The raster is first vectorized (using <xref linkend="RT_ST_DumpAsPolygons"/>) into a set of geomval rows and those rows are then intersected with the geometry using the <xref linkend="ST_Intersection"/> (geometry, geometry) PostGIS function. Geometries intersecting only with a nodata value area of a raster returns an empty geometry. They are normally excluded from the results by the proper usage of <xref linkend="RT_ST_Intersects"/> in the WHERE clause.
fr: Les trois premières variantes, qui retournent un ensemble de géométries, fonctionnent dans l'espace vectoriel. Le raster est d'abord vectorisé (via <xref linkend="RT_ST_DumpAsPolygons"/>) en un ensemble de lignes geomval, et ces lignes sont ensuite intersectées avec la géométrie via la fonction PostGIS <xref linkend="ST_Intersection"/> (geometry, geometry). Les géométries intersectant uniquement une zone de valeur nodata d'un raster renvoient une géométrie vide. Elles sont normalement exclues des résultats par l'utilisation correcte de <xref linkend="RT_ST_Intersects"/> dans la clause WHERE.

note: Tag: para
en: You can access the geometry and the value parts of the resulting set of geomval by surrounding them with parenthesis and adding '.geom' or '.val' at the end of the expression. e.g. (ST_Intersection(rast, geom)).geom
fr: Vous pouvez accéder aux parties géométrie et valeur de l'ensemble résultant de geomval en les entourant de parenthèses et en ajoutant '.geom' ou '.val' à la fin de l'expression. par exemple (ST_Intersection(rast, geom)).geom

note: Tag: para
en: The other variants, returning a raster, works in raster space. They are using the two rasters version of ST_MapAlgebraExpr to perform the intersection.
fr: Les autres variantes, qui retournent un raster, fonctionnent dans l'espace raster. Elles utilisent la variante de ST_MapAlgebraExpr utilisant deux rasters pour réaliser l'intersection.

note: Tag: para
en: The extent of the resulting raster corresponds to the geometrical intersection of the two raster extents. The resulting raster includes 'BAND1', 'BAND2' or 'BOTH' bands, following what is passed as the <varname>returnband</varname> parameter. Nodata value areas present in any band results in nodata value areas in every bands of the result. In other words, any pixel intersecting with a nodata value pixel becomes a nodata value pixel in the result.
fr: L'étendue du raster résultant correspond à l'intersection géométrique des deux étendues des rasters. Le raster résultant inclut les bandes 'BAND1', 'BAND2' ou 'BOTH', en fonction du paramètre <varname>returnband</varname>. Les zones de valeurs nodata présentes dans n'importe quelle bande se traduisent par des zones de valeurs nodata dans toutes les bandes du résultat. En d'autres termes, tout pixel croisant un pixel à valeur nodata devient un pixel à valeur nodata dans le résultat.

note: Tag: para
en: Rasters resulting from ST_Intersection must have a nodata value assigned for areas not intersecting. You can define or replace the nodata value for any resulting band by providing a <varname>nodataval[]</varname> array of one or two nodata values depending if you request 'BAND1', 'BAND2' or 'BOTH' bands. The first value in the array replace the nodata value in the first band and the second value replace the nodata value in the second band. If one input band do not have a nodata value defined and none are provided as an array, one is chosen using the ST_MinPossibleValue function. All variant accepting an array of nodata value can also accept a single value which will be assigned to each requested band.
fr: Les rasters résultant de ST_Intersection doivent avoir une valeur nodata assignée pour les zones non intersectées. Vous pouvez définir ou remplacer la valeur nodata pour toute bande résultante en fournissant un tableau <varname>nodataval[]</varname> d'une ou deux valeurs nodata selon que vous demandez les bandes 'BAND1', 'BAND2' ou 'BOTH'. La première valeur du tableau remplace la valeur nodata dans la première bande et la deuxième valeur remplace la valeur nodata dans la deuxième bande. Si une bande d'entrée n'a pas de valeur nodata définie et qu'aucune n'est fournie sous forme de tableau, une valeur est choisie via la fonction ST_MinPossibleValue. Toutes les variantes acceptant un tableau de valeurs nodata peuvent également accepter une valeur unique qui sera assignée à chaque bande demandée.

note: Tag: para
en: In all variants, if no band number is specified band 1 is assumed. If you need an intersection between a raster and geometry that returns a raster, refer to <xref linkend="RT_ST_Clip"/>.
fr: Dans toutes les variantes, si aucune bande n'est spécifiée, la bande 1 est utilisée. Si vous avez besoin d'une intersection entre un raster et une géométrie qui retourne un raster, utilisez <xref linkend="RT_ST_Clip"/>.

note: Tag: para
en: To get more control on the resulting extent or on what to return when encountering a nodata value, use the two rasters version of <xref linkend="RT_ST_MapAlgebraExpr2"/>.
fr: Pour mieux contrôler l'étendue résultante, ou ce qu'il faut retourner lorsqu'une valeur nodata est rencontrée, utilisez la variante à deux rasters de <xref linkend="RT_ST_MapAlgebraExpr2"/>.

note: Tag: para
en: To compute the intersection of a raster band with a geometry in raster space, use <xref linkend="RT_ST_Clip"/>. ST_Clip works on multiple bands rasters and does not return a band corresponding to the rasterized geometry.
fr: Pour calculer l'intersection d'une bande raster avec une géométrie dans l'espace raster, utilisez <xref linkend="RT_ST_Clip"/>. ST_Clip travaille sur des bandes rasters multiples et ne retourne pas de bande correspondant à la géométrie rasterisée.

note: Tag: para
en: ST_Intersection should be used in conjunction with <xref linkend="RT_ST_Intersects"/> and an index on the raster column and/or the geometry column.
fr: ST_Intersection devrait être utilisée conjointement avec <xref linkend="RT_ST_Intersects"/> et un index sur la colonne raster et/ou la colonne géométrique.

note: Tag: para
en: Enhanced: 2.0.0 - Intersection in the raster space was introduced. In earlier pre-2.0.0 versions, only intersection performed in vector space were supported.
fr: Amélioration : 2.0.0 - Ajout de l'intersection dans l'espace raster. Dans les versions antérieures à la version 2.0.0, seules les intersections réalisées dans l'espace vectoriel étaient prises en charge.

note: Tag: title
en: Examples: Geometry, Raster -- resulting in geometry vals
fr: Exemples : Géométrie, Raster -- avec pour résultat des geomval

note: Tag: refpurpose
en: Callback function version - Returns a one-band raster given one or more input rasters, band indexes and one user-specified callback function.
fr: Version avec fonction de rappel - Retourne un raster à une bande à partir d'un ou plusieurs rasters d'entrée, d'index de bandes et d'une fonction de rappel spécifiée par l'utilisateur.

note: Tag: para
en: Returns a one-band raster given one or more input rasters, band indexes and one user-specified callback function.
fr: Retourne un raster à une bande à partir d'un ou plusieurs rasters d'entrée, d'index de bandes et d'une fonction de rappel spécifiée par l'utilisateur.

note: Tag: para
en: Rasters on which the map algebra process is evaluated.
fr: Rasters sur lesquels le traitement d'algèbre cartographique est évalué.

note: Tag: para
en: <varname>rastbandargset</varname> allows the use of a map algebra operation on many rasters and/or many bands. See example Variant 1.
fr: <varname>rastbandargset</varname> permet d'utiliser une opération d'algèbre cartographique sur plusieurs rasters et/ou plusieurs bandes. Voir l'exemple Variante 1.

note: Tag: para
en: Band numbers of the raster to be evaluated. nband can be an integer or integer[] denoting the bands. nband1 is band on rast1 and nband2 is band on rast2 for the 2 raster/2band case.
fr: Numéros de bande du raster à évaluer. nband peut être un entier ou un tableau d'entiers désignant les bandes. nband1 est la bande sur rast1 et nband2 est la bande sur rast2 pour le cas de 2 rasters/2 bandes.

note: Tag: para
en: The <varname>callbackfunc</varname> parameter must be the name and signature of an SQL or PL/pgSQL function, cast to a regprocedure. An example PL/pgSQL function example is:
fr: Le paramètre <varname>callbackfunc</varname> doit être le nom et la signature d'une fonction SQL ou PL/pgSQL, transformée en une regprocedure. Un exemple de fonction PL/pgSQL est le suivant :

note: Tag: para
en: The <varname>callbackfunc</varname> must have three arguments: a 3-dimension double precision array, a 2-dimension integer array and a variadic 1-dimension text array. The first argument <varname>value</varname> is the set of values (as double precision) from all input rasters. The three dimensions (where indexes are 1-based) are: raster #, row y, column x. The second argument <varname>position</varname> is the set of pixel positions from the output raster and input rasters. The outer dimension (where indexes are 0-based) is the raster #. The position at outer dimension index 0 is the output raster's pixel position. For each outer dimension, there are two elements in the inner dimension for X and Y. The third argument <varname>userargs</varname> is for passing through any user-specified arguments.
fr: Le <varname>callbackfunc</varname> doit avoir trois arguments : un tableau de double précision à 3 dimensions, un tableau d'entiers à 2 dimensions et un tableau de texte variadique à 1 dimension. Le premier argument <varname>valeur</varname> est l'ensemble des valeurs (en double précision) de toutes les matrices d'entrée. Les trois dimensions (où les index sont basés sur 1) sont : trame #, ligne y, colonne x. Le deuxième argument <varname>position</varname> est l'ensemble des positions des pixels de la trame de sortie et des trames d'entrée. La dimension extérieure (où les indices sont basés sur 0) est la trame #. La position à l'indice 0 de la dimension extérieure est la position en pixels de la trame de sortie. Pour chaque dimension extérieure, il y a deux éléments dans la dimension intérieure pour X et Y. Le troisième argument <varname>userargs</varname> sert à transmettre les arguments spécifiés par l'utilisateur.

note: Tag: para
en: Passing a <type>regprocedure</type> argument to a SQL function requires the full function signature to be passed, then cast to a <type>regprocedure</type> type. To pass the above example PL/pgSQL function as an argument, the SQL for the argument is:
fr: Passer un argument de type <type>regprocedure</type> à une fonction SQL nécessite de passer la signature complète de la fonction, puis de la convertir en un type <type>regprocedure</type>. Pour passer la fonction PL/pgSQL ci-dessus en tant qu'argument, le code SQL de l'argument est le suivant :

note: Tag: para
en: Note that the argument contains the name of the function, the types of the function arguments, quotes around the name and argument types, and a cast to a <type>regprocedure</type>.
fr: Notez que l'argument contient le nom de la fonction, les types des arguments de la fonction, des guillemets autour du nom et des types d'arguments, ainsi qu'un cast vers un <type>regprocedure</type>.

note: Tag: para
en: An n-dimensional array (matrix) of numbers used to filter what cells get passed to map algebra call-back function. 0 means a neighbor cell value should be treated as no-data and 1 means value should be treated as data. If weight is set to true, then the values, are used as multipliers to multiple the pixel value of that value in the neighborhood position.
fr: Un tableau à n dimensions (matrice) de nombres utilisés pour filtrer les cellules transmises à la fonction de rappel de l'algèbre cartographique. 0 signifie que la valeur d'une cellule voisine doit être traitée comme une absence de données et 1 signifie que la valeur doit être traitée comme une donnée. Si weight est définit à true, les valeurs sont utilisées comme multiplicateurs pour multiplier la valeur du pixel par cette valeur dans la position de voisinage.

note: Tag: para
en: boolean (true/false) to denote if a mask value should be weighted (multiplied by original value) or not (only applies to proto that takes a mask).
fr: booléen (true/false) indiquant si la valeur d'un masque doit être pondérée (multipliée par la valeur originale) ou non (ne s'applique qu'aux variantes qui prennent un masque).

note: Tag: para
en: If <varname>pixeltype</varname> is passed in, the one band of the new raster will be of that pixeltype. If pixeltype is passed NULL or left out, the new raster band will have the same pixeltype as the specified band of the first raster (for extent types: INTERSECTION, UNION, FIRST, CUSTOM) or the specified band of the appropriate raster (for extent types: SECOND, LAST). If in doubt, always specify <varname>pixeltype</varname>.
fr: Si <varname>pixeltype</varname> est spécifié, l'unique bande du nouveau raster sera de ce type de pixel. Si pixeltype est NULL ou omis, la nouvelle bande du raster aura le même pixeltype que la bande spécifiée du premier raster (pour les types d'étendue : INTERSECTION, UNION, FIRST, CUSTOM) ou que la bande spécifiée du raster approprié (pour les types d'étendue : SECOND, LAST). En cas de doute, spécifiez toujours <varname>pixeltype</varname>.

note: Tag: para
en: The resulting pixel type of the output raster must be one listed in <xref linkend="RT_ST_BandPixelType"/> or left out or set to NULL.
fr: Le type de pixel résultant du raster de sortie doit correspondre à l'un des types énumérés dans <xref linkend="RT_ST_BandPixelType"/>, ou être omis ou défini à NULL.

note: Tag: para
en: Possible values are INTERSECTION (default), UNION, FIRST (default for one raster variants), SECOND, LAST, CUSTOM.
fr: Les valeurs possibles sont INTERSECTION (par défaut), UNION, FIRST (premier, par défaut pour les variantes à un seul raster), SECOND, LAST (dernier), CUSTOM (personnalisé).

note: Tag: para
en: If <varname>extentype</varname> is CUSTOM, a raster must be provided for <varname>customextent</varname>. See example 4 of Variant 1.
fr: Si <varname>extentype</varname> est CUSTOM, un raster doit être spécifié par le paramètre <varname>customextent</varname>. Voir l'exemple 4 de la variante 1.

note: Tag: para
en: The distance in pixels from the reference cell in x direction. So width of resulting matrix would be <code>2*distancex + 1</code>.If not specified only the reference cell is considered (neighborhood of 0).
fr: La distance en pixels de la cellule de référence dans la direction x. La largeur de la matrice résultante sera donc <code>2*distancex + 1</code>. Si elle n'est pas spécifiée, seule la cellule de référence est prise en compte (voisinage de 0).

note: Tag: para
en: The distance in pixels from reference cell in y direction. Height of resulting matrix would be <code>2*distancey + 1</code> .If not specified only the reference cell is considered (neighborhood of 0).
fr: La distance en pixels de la cellule de référence dans la direction y. La hauteur de la matrice résultante sera <code>2*distancey + 1</code> Si elle n'est pas spécifiée, seule la cellule de référence est prise en compte (voisinage de 0).

note: Tag: para
en: The third argument to the <varname>callbackfunc</varname> is a <type>variadic text</type> array. All trailing text arguments are passed through to the specified <varname>callbackfunc</varname>, and are contained in the <varname>userargs</varname> argument.
fr: Le troisième paramètre de la fonction <varname>callbackfunc</varname> est un tableau <type>variadic text</type> . Tous les arguments textuels supplémentaires sont transmis à <varname>callbackfunc</varname>, et sont contenus dans l'argument <varname>userargs</varname>.

note: Tag: para
en: For more information about the VARIADIC keyword, please refer to the PostgreSQL documentation and the "SQL Functions with Variable Numbers of Arguments" section of <link xlink:href="http://www.postgresql.org/docs/current/static/xfunc-sql.html">Query Language (SQL) Functions</link>.
fr: Pour plus d'informations sur le mot-clé VARIADIC, veuillez vous référer à la documentation PostgreSQL et à la section "SQL Functions with Variable Numbers of Arguments" de <link xlink:href="http://www.postgresql.org/docs/current/static/xfunc-sql.html">Query Language (SQL) Functions</link>.

note: Tag: para
en: The <type>text[]</type> argument to the <varname>callbackfunc</varname> is required, regardless of whether you choose to pass any arguments to the callback function for processing or not.
fr: Le paramètre <type>text[]</type> de la fonction <varname>callbackfunc</varname> est obligatoire, que vous choisissiez ou non de transmettre des arguments à la fonction de rappel.

note: Tag: para
en: Variant 1 accepts an array of <varname>rastbandarg</varname> allowing the use of a map algebra operation on many rasters and/or many bands. See example Variant 1.
fr: La variante 1 accepte un tableau de <varname>rastbandarg</varname> permettant l'utilisation d'une opération d'algèbre cartographique sur de nombreux masters et/ou de nombreuses bandes. Voir l'exemple de la variante 1.

note: Tag: para
en: Variants 2 and 3 operate upon one or more bands of one raster. See example Variant 2 and 3.
fr: Les variantes 2 et 3 agissent sur une ou plusieurs bandes d'un même raster. Voir l'exemple des variantes 2 et 3.

note: Tag: para
en: Variant 4 operate upon two rasters with one band per raster. See example Variant 4.
fr: La variante 4 utilise deux rasters avec une bande par raster. Voir l'exemple de la variante 4.

note: Tag: para
en: Availability: 2.2.0: Ability to add a mask
fr: Disponibilité : 2.2.0 : Possibilité d'ajouter un masque

note: Tag: para
en: One raster, one band
fr: Un raster, une bande

note: Tag: para
en: One raster, several bands
fr: Un raster, plusieurs bandes

note: Tag: para
en: Several rasters, several bands
fr: Plusieurs rasters, plusieurs bandes

note: Tag: para
en: Complete example of tiles of a coverage with neighborhood. This query only works with PostgreSQL 9.1 or higher.
fr: Exemple complet avec les tuiles d'une couverture avec voisinage. Cette requête ne fonctionne qu'avec PostgreSQL 9.1 ou plus.

note: Tag: para
en: Example like the prior one for tiles of a coverage with neighborhood but works with PostgreSQL 9.0.
fr: Exemple identique au précédent pour les tuiles d'une couverture avec voisinage, mais fonctionne avec PostgreSQL 9.0.

note: Tag: title
en: Examples: Variants 2 and 3
fr: Exemples : Variantes 2 et 3

note: Tag: title
en: Examples: Variant 4
fr: Exemples : Variante 4

note: Tag: para
en: Two rasters, two bands
fr: Deux rasters, deux bandes

note: Tag: title
en: Examples: Using Masks
fr: Exemples : Utilisation de masques

note: Tag: para
en: no mask mean value (same as having all 1s in mask matrix)
fr: valeur moyenne, sans masque (ce qui revient à avoir que des 1 dans la matrice du masque)

note: Tag: para
en: mask only consider neighbors, exclude center
fr: masque uniquement sur les voisins, en excluant le centre

note: Tag: para
en: mask weighted only consider neighbors, exclude center multi other pixel values by 2
fr: masque pondéré, uniquement sur les voisins en excluant le centre, multiplier les autres pixels par 2

note: Tag: refpurpose
en: <refpurpose>Expression version - Returns a one-band raster given one or two input rasters, band indexes and one or more user-specified SQL expressions.</refpurpose>
fr: <refpurpose>Version avec expression - Retourne un raster à une bande à partir d'un ou deux rasters d'entrée, d'index de bandes et d'une ou plusieurs expressions SQL spécifiées par l'utilisateur.</refpurpose>

note: Tag: para
en: <para>Expression version - Returns a one-band raster given one or two input rasters, band indexes and one or more user-specified SQL expressions.</para>
fr: <para>Version avec expression - Retourne un raster à une bande à partir d'un ou deux rasters d'entrée, d'index de bandes et d'une ou plusieurs expressions SQL spécifiées par l'utilisateur.</para>

note: Tag: title
en: Description: Variants 1 and 2 (one raster)
fr: Description : Variantes 1 et 2 (un raster)

note: Tag: para
en: Creates a new one band raster formed by applying a valid PostgreSQL algebraic operation defined by the <varname>expression</varname> on the input raster (<varname>rast</varname>). If <varname>nband</varname> is not provided, band 1 is assumed. The new raster will have the same georeference, width, and height as the original raster but will only have one band.
fr: Crée un nouveau raster à une bande formé en appliquant une opération algébrique PostgreSQL valide définie par <varname>expression</varname> sur le raster d'entrée (<varname>rast</varname>). Si <varname>nband</varname> n'est pas fourni, la bande 1 est utilisée. Le nouveau raster aura la même géoréférence, la même largeur et la même hauteur que le raster original mais n'aura qu'une seule bande.

note: Tag: para
en: If <varname>pixeltype</varname> is passed in, then the new raster will have a band of that pixeltype. If pixeltype is passed NULL, then the new raster band will have the same pixeltype as the input <varname>rast</varname> band.
fr: Si <varname>pixeltype</varname> est fourni, le nouveau raster aura une bande de ce type de pixel. Si pixeltype est NULL, la nouvelle bande raster aura le même type de pixel que la bande d'entrée de <varname>rast</varname>.

note: Tag: para
en: Keywords permitted for <varname>expression</varname>
fr: Mots clés possibles pour <varname>expression</varname>

note: Tag: para
en: <varname>[rast]</varname> - Pixel value of the pixel of interest
fr: <varname>[rast]</varname> - Valeur du pixel d'intérêt

note: Tag: para
en: <varname>[rast.val]</varname> - Pixel value of the pixel of interest
fr: <varname>[rast.val]</varname> - Valeur du pixel d'intérêt

note: Tag: para
en: <varname>[rast.x]</varname> - 1-based pixel column of the pixel of interest
fr: <varname>[rast.x]</varname> - colonne du pixel d'intérêt (démarrant à 1)

note: Tag: para
en: <varname>[rast.y]</varname> - 1-based pixel row of the pixel of interest
fr: <varname>[rast.y]</varname> - ligne du pixel d'intérêt (démarrant à 1)

note: Tag: title
en: Description: Variants 3 and 4 (two raster)
fr: Description : Variantes 3 et 4 (deux rasters)

note: Tag: para
en: Creates a new one band raster formed by applying a valid PostgreSQL algebraic operation to the two bands defined by the <varname>expression</varname> on the two input raster bands <varname>rast1</varname>, (<varname>rast2</varname>). If no <varname>band1</varname>, <varname>band2</varname> is specified band 1 is assumed. The resulting raster will be aligned (scale, skew and pixel corners) on the grid defined by the first raster. The resulting raster will have the extent defined by the <varname>extenttype</varname> parameter.
fr: Crée un nouveau raster à une bande formé en appliquant une opération algébrique PostgreSQL valide aux deux bandes définies par <varname>expression</varname> sur les deux bandes d'entrée <varname>rast1</varname> (et optionnellement <varname>rast2</varname>). Si aucune bande <varname>band1</varname>, <varname>band2</varname> n'est spécifiée, la bande 1 est utilisée. Le raster résultant sera aligné (échelle, obliquité et coins) sur la grille définie par le premier raster. Le raster résultant aura l'étendue définie par le paramètre <varname>extenttype</varname>.

note: Tag: para
en: A PostgreSQL algebraic expression involving the two rasters and PostgreSQL defined functions/operators that will define the pixel value when pixels intersect. e.g. (([rast1] + [rast2])/2.0)::integer
fr: Une expression algébrique PostgreSQL impliquant les deux rasters et les fonctions/opérateurs définis par PostgreSQL qui définiront la valeur du pixel lorsque les pixels intersectent, par exemple (([rast1] + [rast2])/2.0)::integer

note: Tag: para
en: The resulting pixel type of the output raster. Must be one listed in <xref linkend="RT_ST_BandPixelType"/>, left out or set to NULL. If not passed in or set to NULL, will default to the pixeltype of the first raster.
fr: Le type de pixel résultant du raster de sortie. Doit être l'un de ceux listés dans <xref linkend="RT_ST_BandPixelType"/>, omis ou NULL. S'il n'est pas fourni ou NULL, le type de pixel du premier raster sera utilisé par défaut.

note: Tag: para
en: Controls the extent of resulting raster
fr: Contrôle l'étendue du raster de sortie

note: Tag: para
en: <varname>INTERSECTION</varname> - The extent of the new raster is the intersection of the two rasters. This is the default.
fr: <varname>INTERSECTION</varname> - L'étendue du nouveau raster est l'intersection des deux rasters. Il s'agit de la valeur par défaut.

note: Tag: para
en: <varname>UNION</varname> - The extent of the new raster is the union of the two rasters.
fr: <varname>UNION</varname> - L'étendue du nouveau raster est l'union des deux rasters.

note: Tag: para
en: <varname>FIRST</varname> - The extent of the new raster is the same as the one of the first raster.
fr: <varname>FIRST</varname> - L'étendue du nouveau raster est la même que celle du premier raster.

note: Tag: para
en: <varname>SECOND</varname> - The extent of the new raster is the same as the one of the second raster.
fr: <varname>SECOND</varname> - L'étendue du nouveau raster est la même que celle du second raster.

note: Tag: para
en: An algebraic expression involving only <varname>rast2</varname> or a constant that defines what to return when pixels of <varname>rast1</varname> are nodata values and spatially corresponding rast2 pixels have values.
fr: Une expression algébrique impliquant uniquement <varname>rast2</varname>, ou une constante qui définit la valeur à retourner lorsque les pixels de <varname>rast1</varname> sont des valeurs nodata et que les pixels correspondants dans rast2 ont des valeurs.

note: Tag: para
en: An algebraic expression involving only <varname>rast1</varname> or a constant that defines what to return when pixels of <varname>rast2</varname> are nodata values and spatially corresponding rast1 pixels have values.
fr: Une expression algébrique impliquant uniquement <varname>rast1</varname>, ou une constante qui définit la valeur à retourner lorsque les pixels de <varname>rast2</varname> sont des valeurs nodata et que les pixels correspondants dans rast1 ont des valeurs.

note: Tag: para
en: A numeric constant to return when spatially corresponding rast1 and rast2 pixels are both nodata values.
fr: Constante numérique à retourner lorsque les pixels de rast1 et de rast2 sont tous deux des valeurs nodata.

note: Tag: para
en: Keywords permitted in <varname>expression</varname>, <varname>nodata1expr</varname> and <varname>nodata2expr</varname>
fr: Mots clés possibles dans <varname>expression</varname>, <varname>nodata1expr</varname> et <varname>nodata2expr</varname>

note: Tag: para
en: <varname>[rast1]</varname> - Pixel value of the pixel of interest from <varname>rast1</varname>
fr: <varname>[rast1]</varname> - Valeur du pixel d'intérêt sur <varname>rast1</varname>

note: Tag: para
en: <varname>[rast1.val]</varname> - Pixel value of the pixel of interest from <varname>rast1</varname>
fr: <varname>[rast1.val]</varname> - Valeur du pixel d'intérêt de <varname>rast1</varname>

note: Tag: para
en: <varname>[rast1.x]</varname> - 1-based pixel column of the pixel of interest from <varname>rast1</varname>
fr: <varname>[rast1.x]</varname> - Colonne du pixel d'intérêt de <varname>rast1</varname> (démarrant à 1)

note: Tag: para
en: <varname>[rast1.y]</varname> - 1-based pixel row of the pixel of interest from <varname>rast1</varname>
fr: <varname>[rast1.y]</varname> - Ligne du pixel d'intérêt de <varname>rast1</varname> (démarrant à 1)

note: Tag: para
en: <varname>[rast2]</varname> - Pixel value of the pixel of interest from <varname>rast2</varname>
fr: <varname>[rast2]</varname> - Valeur du pixel d'intérêt sur <varname>rast2</varname>

note: Tag: para
en: <varname>[rast2.val]</varname> - Pixel value of the pixel of interest from <varname>rast2</varname>
fr: <varname>[rast2.val]</varname> - Valeur du pixel d'intérêt de <varname>rast2</varname>

note: Tag: para
en: <varname>[rast2.x]</varname> - 1-based pixel column of the pixel of interest from <varname>rast2</varname>
fr: <varname>[rast2.x]</varname> - Colonne du pixel d'intérêt de <varname>rast2</varname> (démarrant à 1)

note: Tag: para
en: <varname>[rast2.y]</varname> - 1-based pixel row of the pixel of interest from <varname>rast2</varname>
fr: <varname>[rast2.y]</varname> - Ligne du pixel d'intérêt de <varname>rast2</varname> (démarrant à 1)

note: Tag: title
en: Examples: Variants 1 and 2
fr: Exemples : Variantes 1 et 2

note: Tag: title
en: Examples: Variant 3 and 4
fr: Exemples : Variantes 3 et 4

note: Tag: refpurpose
en: 1 raster band version: Creates a new one band raster formed by applying a valid PostgreSQL algebraic operation on the input raster band and of pixeltype provided. Band 1 is assumed if no band is specified.
fr: Version avec raster à 1 bande : Crée un nouveau raster à une bande formé par l'application d'une opération algébrique PostgreSQL valide sur la bande d'entrée du raster et du type de pixel fourni. Si aucune bande n'est spécifiée, la bande 1 est utilisée.

note: Tag: para
en: is deprecated as of 2.1.0. Use <xref linkend="RT_ST_MapAlgebra_expr"/> instead.
fr: est obsolète depuis 2.1.0. Utilisez plutôt <xref linkend="RT_ST_MapAlgebra_expr"/>.

note: Tag: para
en: Creates a new one band raster formed by applying a valid PostgreSQL algebraic operation defined by the <varname>expression</varname> on the input raster (<varname>rast</varname>). If no <varname>band</varname> is specified band 1 is assumed. The new raster will have the same georeference, width, and height as the original raster but will only have one band.
fr: Crée un nouveau raster à une bande formé par l'application d'une opération algébrique PostgreSQL valide définie par <varname>expression</varname> sur le raster d'entrée (<varname>rast</varname>). Si aucune <varname>band</varname> n'est spécifiée, la bande 1 est utilisée. Le nouveau raster aura la même géoréférence, la même largeur et la même hauteur que le raster original mais n'aura qu'une seule bande.

note: Tag: para
en: In the expression you can use the term <varname>[rast]</varname> to refer to the pixel value of the original band, <varname>[rast.x]</varname> to refer to the 1-based pixel column index, <varname>[rast.y]</varname> to refer to the 1-based pixel row index.
fr: Dans l'expression, vous pouvez utiliser le mot clé <varname>[rast]</varname> pour faire référence à la valeur en pixels de la bande originale, <varname>[rast.x]</varname> pour faire référence à l'indice de colonne de pixels (basé sur 1), <varname>[rast.y]</varname> pour faire référence à l'indice de ligne de pixels (basé sur 1).

note: Tag: para
en: Create a new 1 band raster from our original that is a function of modulo 2 of the original raster band.
fr: Crée une nouveau raster à 1 bande qui est une fonction modulo 2 de la bande du raster original.

note: Tag: para
en: Create a new 1 band raster of pixel-type 2BUI from our original that is reclassified and set the nodata value to be 0.
fr: Crée un nouveau raster à 1 bande de type de pixel 2BUI à partir d'un raster original reclassifié et avec la valeur nodata à 0.

note: Tag: para
en: original (column rast_view)
fr: original (colonne rast_view)

note: Tag: para
en: Create a new 3 band raster same pixel type from our original 3 band raster with first band altered by map algebra and remaining 2 bands unaltered.
fr: Crée un nouveau raster à 3 bandes de même type de pixel que le raster original à 3 bandes, la première bande étant modifiée par l'algèbre cartographique et les 2 bandes restantes n'étant pas modifiées.

note: Tag: refpurpose
en: 2 raster band version: Creates a new one band raster formed by applying a valid PostgreSQL algebraic operation on the two input raster bands and of pixeltype provided. band 1 of each raster is assumed if no band numbers are specified. The resulting raster will be aligned (scale, skew and pixel corners) on the grid defined by the first raster and have its extent defined by the "extenttype" parameter. Values for "extenttype" can be: INTERSECTION, UNION, FIRST, SECOND.
fr: Version avec 2 bandes : Crée un nouveau raster à une bande formé en appliquant une opération algébrique PostgreSQL valide sur les deux bandes du raster d'entrée et du type de pixel fourni. La bande 1 de chaque raster est utilisée si aucun numéro de bande n'est spécifié. Le raster résultant sera aligné (échelle, obliquité et coins) sur la grille définie par le premier raster et aura son étendue définie par le paramètre "extenttype". Les valeurs de "extenttype" peuvent être : INTERSECTION, UNION, FIRST, SECOND.

note: Tag: para
en: If <varname>pixeltype</varname> is passed in, then the new raster will have a band of that pixeltype. If pixeltype is passed NULL or no pixel type specified, then the new raster band will have the same pixeltype as the input <varname>rast1</varname> band.
fr: Si le <varname>pixeltype</varname> est fourni, le nouveau raster aura une bande de ce type de pixel. Si le type de pixel est NULL ou si aucun type de pixel n'est spécifié, la nouvelle bande raster aura le même type de pixel que la bande d'entrée de <varname>rast1</varname>.

note: Tag: para
en: Use the term <varname>[rast1.val]</varname> <varname>[rast2.val]</varname> to refer to the pixel value of the original raster bands and <varname>[rast1.x]</varname>, <varname>[rast1.y]</varname> etc. to refer to the column / row positions of the pixels.
fr: Utilisez le mot clé <varname>[rast1.val]</varname> <varname>[rast2.val]</varname> pour désigner la valeur en pixels des bandes raster d'origine et <varname>[rast1.x]</varname>, <varname>[rast1.y]</varname> etc. pour désigner la position des pixels dans les colonnes et les lignes.

note: Tag: title
en: Example: 2 Band Intersection and Union
fr: Exemple : Intersection et Union avec 2 bandes

note: Tag: para
en: mapalgebra intersection
fr: intersection

note: Tag: para
en: map algebra union
fr: union

note: Tag: title
en: Example: Overlaying rasters on a canvas as separate bands
fr: Exemple : Superposition de rasters sur un canevas sous forme de bandes distinctes

note: Tag: title
en: Example: Overlay 2 meter boundary of select parcels over an aerial imagery
fr: Exemple : Superposition d'une délimitation de 2 mètres de certaines parcelles sur une image aérienne

note: Tag: para
en: The blue lines are the boundaries of select parcels
fr: Les lignes bleues représentent les limites des parcelles sélectionnées

note: Tag: refpurpose
en: 1 band version - Creates a new one band raster formed by applying a valid PostgreSQL function on the input raster band and of pixeltype prodived. Band 1 is assumed if no band is specified.
fr: Version à 1 bande - Crée un nouveau raster à une bande formé par l'application d'une fonction PostgreSQL valide sur la bande d'entrée du raster et sur le type de pixel fourni. La bande 1 est utilisée si aucune bande n'est spécifiée.

note: Tag: para
en: is deprecated as of 2.1.0. Use <xref linkend="RT_ST_MapAlgebra"/> instead.
fr: est obsolète depuis 2.1.0. Utilisez plutôt <xref linkend="RT_ST_MapAlgebra"/>.

note: Tag: para
en: Creates a new one band raster formed by applying a valid PostgreSQL function specified by the <varname>onerasteruserfunc</varname> on the input raster (<varname>rast</varname>). If no <varname>band</varname> is specified, band 1 is assumed. The new raster will have the same georeference, width, and height as the original raster but will only have one band.
fr: Crée un nouveau raster à une bande formé en appliquant une fonction PostgreSQL valide spécifiée par <varname>onerasteruserfunc</varname> sur le raster d'entrée (<varname>rast</varname>). Si aucune bande <varname>band</varname> n'est spécifiée, la bande 1 est utilisée. Le nouveau raster aura la même géoréférence, la même largeur et la même hauteur que le raster original mais n'aura qu'une seule bande.

note: Tag: para
en: The <varname>onerasteruserfunc</varname> parameter must be the name and signature of a SQL or PL/pgSQL function, cast to a regprocedure. A very simple and quite useless PL/pgSQL function example is:
fr: Le paramètre <varname>onerasteruserfunc</varname> doit être le nom et la signature d'une fonction SQL ou PL/pgSQL, transformée en regprocedure. Un exemple de fonction PL/pgSQL très simple et assez inutile est le suivant :

note: Tag: para
en: The <varname>userfunction</varname> may accept two or three arguments: a float value, an optional integer array, and a variadic text array. The first argument is the value of an individual raster cell (regardless of the raster datatype). The second argument is the position of the current processing cell in the form '{x,y}'. The third argument indicates that all remaining parameters to <xref linkend="RT_ST_MapAlgebraFct"/> shall be passed through to the <varname>userfunction</varname>.
fr: La <varname>fonction utilisateur</varname> peut accepter deux ou trois arguments : une valeur flottante, un tableau d'entiers facultatif et un tableau de texte variable. Le premier argument est la valeur d'une cellule matricielle individuelle (quel que soit le type de données matricielles). Le deuxième argument est la position de la cellule de traitement actuelle sous la forme '{x,y}'. Le troisième argument indique que tous les paramètres restants de <xref linkend="RT_ST_MapAlgebraFct"/> doivent être transmis à la <varname>fonction utilisateur</varname>.

note: Tag: para
en: Passing a <type>regprodedure</type> argument to a SQL function requires the full function signature to be passed, then cast to a <type>regprocedure</type> type. To pass the above example PL/pgSQL function as an argument, the SQL for the argument is:
fr: Passer un argument de type <type>regprodedure</type> à une fonction SQL nécessite de passer la signature complète de la fonction, puis de la convertir en un type <type>regprocedure</type>. Pour passer la fonction PL/pgSQL ci-dessus en tant qu'argument, le code SQL de l'argument est le suivant :

note: Tag: para
en: The third argument to the <varname>userfunction</varname> is a <type>variadic text</type> array. All trailing text arguments to any <xref linkend="RT_ST_MapAlgebraFct"/> call are passed through to the specified <varname>userfunction</varname>, and are contained in the <varname>args</varname> argument.
fr: Le troisième paramètre de la fonction <varname>userfunction</varname> est un tableau <type>variadic text</type> . Tous les arguments textuels supplémentaires de l'appel à <xref linkend="RT_ST_MapAlgebraFct"/> sont transmis à <varname>userfunction</varname>, et sont contenus dans l'argument <varname>args</varname>.

note: Tag: para
en: The <type>text[]</type> argument to the <varname>userfunction</varname> is required, regardless of whether you choose to pass any arguments to your user function for processing or not.
fr: Le paramètre <type>text[]</type> de la fonction <varname>userfunction</varname> est obligatoire, que vous choisissiez ou non de transmettre des arguments à la fonction de rappel.

note: Tag: para
en: Create a new 1 band raster of pixel-type 2BUI from our original that is reclassified and set the nodata value to a passed parameter to the user function (0).
fr: Crée un nouveau raster à 1 bande de type de pixel 2BUI à partir d'un raster reclassifié avec la valeur nodata fixée via un paramètre passé à la fonction utilisateur (0).

note: Tag: para
en: original (column rast-view)
fr: original (colonne rast-view)

note: Tag: refpurpose
en: 2 band version - Creates a new one band raster formed by applying a valid PostgreSQL function on the 2 input raster bands and of pixeltype prodived. Band 1 is assumed if no band is specified. Extent type defaults to INTERSECTION if not specified.
fr: Version à 2 bandes - Crée un nouveau raster à une bande formé par l'application d'une fonction PostgreSQL valide sur les 2 bandes d'entrée du raster et sur le type de pixel fourni. La bande 1 est utilisée si aucune bande n'est spécifiée. Le type d'étendue INTERSECTION est utilisé si non spécifié.

note: Tag: para
en: Creates a new one band raster formed by applying a valid PostgreSQL function specified by the <varname>tworastuserfunc</varname> on the input raster <varname>rast1</varname>, <varname>rast2</varname>. If no <varname>band1</varname> or <varname>band2</varname> is specified, band 1 is assumed. The new raster will have the same georeference, width, and height as the original rasters but will only have one band.
fr: Crée un nouveau raster à une bande formé par l'application d'une fonction PostgreSQL valide spécifiée par <varname>tworastuserfunc</varname> sur les rasters d'entrée <varname>rast1</varname>, <varname>rast2</varname>. Si aucune bande <varname>band1</varname> ou <varname>band2</varname> n'est spécifiée, la bande 1 est utilisée. Le nouveau raster aura la même géoréférence, la même largeur et la même hauteur que les rasters originaux, mais il n'aura qu'une seule bande.

note: Tag: para
en: If <varname>pixeltype</varname> is passed in, then the new raster will have a band of that pixeltype. If pixeltype is passed NULL or left out, then the new raster band will have the same pixeltype as the input <varname>rast1</varname> band.
fr: Si <varname>pixeltype</varname> est fourni, le nouveau raster aura une bande de ce type de pixel. Si pixeltype est NULL ou omis, la nouvelle bande raster aura le même type de pixel que la bande d'entrée de <varname>rast1</varname>.

note: Tag: para
en: The <varname>tworastuserfunc</varname> parameter must be the name and signature of an SQL or PL/pgSQL function, cast to a regprocedure. An example PL/pgSQL function example is:
fr: Le paramètre <varname>tworastuserfunc</varname> doit être le nom et la signature d'une fonction SQL ou PL/pgSQL, transformée en une regprocedure. Un exemple de fonction PL/pgSQL est le suivant :

note: Tag: para
en: The <varname>tworastuserfunc</varname> may accept three or four arguments: a double precision value, a double precision value, an optional integer array, and a variadic text array. The first argument is the value of an individual raster cell in <varname>rast1</varname> (regardless of the raster datatype). The second argument is an individual raster cell value in <varname>rast2</varname>. The third argument is the position of the current processing cell in the form '{x,y}'. The fourth argument indicates that all remaining parameters to <xref linkend="RT_ST_MapAlgebraFct2"/> shall be passed through to the <varname>tworastuserfunc</varname>.
fr: La <varname>tworastuserfunc</varname> peut accepter trois ou quatre arguments : une valeur de double précision, une valeur de double précision, un tableau d'entiers facultatif et un tableau de texte variable. Le premier argument est la valeur d'une cellule matricielle individuelle dans <varname>rast1</varname> (quel que soit le type de données matricielles). Le deuxième argument est la valeur d'une cellule de trame individuelle dans <varname>rast2</varname>. Le troisième argument est la position de la cellule de traitement actuelle sous la forme '{x,y}'. Le quatrième argument indique que tous les paramètres restants de <xref linkend="RT_ST_MapAlgebraFct2"/> doivent être transmis au <varname>tworastuserfunc</varname>.

note: Tag: para
en: The fourth argument to the <varname>tworastuserfunc</varname> is a <type>variadic text</type> array. All trailing text arguments to any <xref linkend="RT_ST_MapAlgebraFct2"/> call are passed through to the specified <varname>tworastuserfunc</varname>, and are contained in the <varname>userargs</varname> argument.
fr: Le quatrième paramètre de la fonction <varname>tworastuserfunc</varname> est un tableau <type>variadic text</type> . Tous les arguments textuels supplémentaires de l'appel à <xref linkend="RT_ST_MapAlgebraFct2"/> sont transmis à <varname>tworastuserfunc</varname>, et sont contenus dans l'argument <varname>userargs</varname>.

note: Tag: para
en: The <type>text[]</type> argument to the <varname>tworastuserfunc</varname> is required, regardless of whether you choose to pass any arguments to your user function for processing or not.
fr: Le paramètre <type>text[]</type> de la fonction <varname>tworastuserfunc</varname> est obligatoire, que vous choisissiez ou non de transmettre des arguments à la fonction de rappel.

note: Tag: para
en: map bands overlay (canvas) (R: small road, G: circle, B: big road)
fr: superposition des bandes de la carte (canevas) (R : small road, G : circle, B : big road)

note: Tag: title
en: User Defined function that takes extra args
fr: Fonction définie par l'utilisateur avec arguments supplémentaires

note: Tag: para
en: user defined with extra args and different bands from same raster
fr: Fonction définie par l'utilisateur avec arguments supplémentaires et plusieurs bandes issus du même raster

note: Tag: refpurpose
en: 1-band version: Map Algebra Nearest Neighbor using user-defined PostgreSQL function. Return a raster which values are the result of a PLPGSQL user function involving a neighborhood of values from the input raster band.
fr: Version à 1 bande : Algèbre cartographique Plus proche voisin en utilisant une fonction PostgreSQL définie par l'utilisateur. Retourne un raster dont les valeurs sont le résultat d'une fonction utilisateur PLPGSQL prenant un voisinage des valeurs de la bande raster d'entrée.

note: Tag: para
en: (one raster version) Return a raster which values are the result of a PLPGSQL user function involving a neighborhood of values from the input raster band. The user function takes the neighborhood of pixel values as an array of numbers, for each pixel, returns the result from the user function, replacing pixel value of currently inspected pixel with the function result.
fr: (version à un raster) Retourne un raster dont les valeurs sont le résultat d'une fonction utilisateur PLPGSQL prenant un voisinage de valeurs de la bande du raster d'entrée. La fonction utilisateur prend le voisinage des valeurs des pixels sous la forme d'un tableau de nombres. Pour chaque pixel, elle renvoie le résultat de la fonction utilisateur, en remplaçant la valeur du pixel actuellement traité par le résultat de la fonction utilisateur.

note: Tag: para
en: Raster on which the user function is evaluated.
fr: Raster sur lequel la fonction utilisateur est évaluée.

note: Tag: para
en: Band number of the raster to be evaluated. Default to 1.
fr: Numéro de bande du raster à évaluer. La valeur par défaut est 1.

note: Tag: para
en: The resulting pixel type of the output raster. Must be one listed in <xref linkend="RT_ST_BandPixelType"/> or left out or set to NULL. If not passed in or set to NULL, will default to the pixeltype of the <varname>rast</varname>. Results are truncated if they are larger than what is allowed for the pixeltype.
fr: Le type de pixel résultant du raster de sortie. Doit être l'un de ceux listés dans <xref linkend="RT_ST_BandPixelType"/>, ou être omis ou défini à NULL. S'il n'est pas spécifié ou s'il est défini à NULL, le type de pixel du raster <varname>rast</varname> sera utilisé par défaut. Les résultats sont tronqués s'ils sont plus grands que ce qui est autorisé pour le type de pixel.

note: Tag: para
en: The width of the neighborhood, in cells.
fr: La largeur du voisinage, en nombre de cellules.

note: Tag: para
en: The height of the neighborhood, in cells.
fr: La hauteur du voisinage, en nombre de cellules.

note: Tag: para
en: PLPGSQL/psql user function to apply to neighborhood pixels of a single band of a raster. The first element is a 2-dimensional array of numbers representing the rectangular pixel neighborhood
fr: Fonction utilisateur PLPGSQL/psql à appliquer aux pixels du voisinage de la bande du raster. Le premier élément est un tableau bidimensionnel de nombres, représentant le voisinage rectangulaire du pixel

note: Tag: para
en: Defines what value to pass to the function for a neighborhood pixel that is nodata or NULL
fr: Définit la valeur à transmettre à la fonction pour un pixel de voisinage qui est nodata ou NULL

note: Tag: para
en: 'ignore': any NODATA values encountered in the neighborhood are ignored by the computation -- this flag must be sent to the user callback function, and the user function decides how to ignore it.
fr: 'ignore' : toutes les valeurs NODATA rencontrées dans le voisinage sont ignorées par le calcul -- ce drapeau doit être envoyé à la fonction de rappel de l'utilisateur, et c'est la fonction de l'utilisateur qui décide comment l'ignorer.

note: Tag: para
en: 'NULL': any NODATA values encountered in the neighborhood will cause the resulting pixel to be NULL -- the user callback function is skipped in this case.
fr: 'NULL' : toute valeur NODATA rencontrée dans le voisinage aura pour conséquence que le pixel résultant sera NULL -- la fonction de rappel de l'utilisateur est ignorée dans ce cas.

note: Tag: para
en: 'value': any NODATA values encountered in the neighborhood are replaced by the reference pixel (the one in the center of the neighborhood). Note that if this value is NODATA, the behavior is the same as 'NULL' (for the affected neighborhood)
fr: 'value' : toutes les valeurs NODATA rencontrées dans le voisinage sont remplacées par le pixel de référence (celui qui se trouve au centre du voisinage). Notez que si cette valeur est NODATA, le comportement est le même que 'NULL' (pour le voisinage concerné)

note: Tag: para
en: Arguments to pass into the user function.
fr: Arguments à transmettre à la fonction utilisateur.

note: Tag: para
en: Examples utilize the katrina raster loaded as a single tile described in <link xlink:href="http://trac.osgeo.org/gdal/wiki/frmts_wtkraster.html">http://trac.osgeo.org/gdal/wiki/frmts_wtkraster.html</link> and then prepared in the <xref linkend="RT_ST_Rescale"/> examples
fr: Les exemples utilisent le raster katrina chargé comme une seule tuile, tel que décrit dans <link xlink:href="http://trac.osgeo.org/gdal/wiki/frmts_wtkraster.html">http://trac.osgeo.org/gdal/wiki/frmts_wtkraster.html</link> et ensuite traitée dans les exemples <xref linkend="RT_ST_Rescale"/>

note: Tag: para
en: First band of our raster
fr: Première bande du raster

note: Tag: para
en: new raster after averaging pixels within 4x4 pixels of each other
fr: nouveau raster après calcul de la moyenne des pixels situés à moins de 4x4 pixels les uns des autres

note: Tag: refpurpose
en: Creates a new raster composed of band types reclassified from original. The nband is the band to be changed. If nband is not specified assumed to be 1. All other bands are returned unchanged. Use case: convert a 16BUI band to a 8BUI and so forth for simpler rendering as viewable formats.
fr: Crée un nouveau raster composé de types de bandes reclassifiés par rapport à l'original. La bande n est la bande à modifier. Si nband n'est pas spécifié, la bande 1 est utilisée. Toutes les autres bandes sont retournées inchangées. Cas d'utilisation : convertir une bande 16BUI en 8BUI et ainsi de suite pour un rendu plus simple en tant que formats visualisables.

note: Tag: para
en: Creates a new raster formed by applying a valid PostgreSQL algebraic operation defined by the <varname>reclassexpr</varname> on the input raster (<varname>rast</varname>). If no <varname>band</varname> is specified band 1 is assumed. The new raster will have the same georeference, width, and height as the original raster. Bands not designated will come back unchanged. Refer to <xref linkend="reclassarg"/> for description of valid reclassification expressions.
fr: Crée un nouveau raster formé par l'application d'une opération algébrique PostgreSQL valide définie par <varname>reclassexpr</varname> sur le raster d'entrée (<varname>rast</varname>). Si aucune bande <varname>band</varname> n'est spécifiée, la bande 1 est utilisée. Le nouveau raster aura la même géoréférence, la même largeur et la même hauteur que le raster original. Les bandes non désignées seront retournées inchangées. Voir <xref linkend="reclassarg"/> pour la description des expressions de reclassification valides.

note: Tag: para
en: The bands of the new raster will have pixel type of <varname>pixeltype</varname>. If <varname>reclassargset</varname> is passed in then each reclassarg defines behavior of each band generated.
fr: Les bandes du nouveau raster auront le type de pixel <varname>pixeltype</varname>. Si <varname>reclassargset</varname> est spécifié, chaque reclassarg définit le comportement de chaque bande générée.

note: Tag: para
en: Create a new raster from the original where band 2 is converted from 8BUI to 4BUI and all values from 101-254 are set to nodata value.
fr: Crée un nouveau raster à partir de l'original où la bande 2 est convertie de 8BUI à 4BUI et où toutes les valeurs entre 101 et 254 sont fixées à nodata.

note: Tag: title
en: Example: Advanced using multiple reclassargs
fr: Exemple avancé : utiliser plusieurs reclassargs

note: Tag: para
en: Create a new raster from the original where band 1,2,3 is converted to 1BB,4BUI, 4BUI respectively and reclassified. Note this uses the variadic <varname>reclassarg</varname> argument which can take as input an indefinite number of reclassargs (theoretically as many bands as you have)
fr: Crée un nouveau raster à partir de l'original où les bandes 1, 2, 3 sont respectivement converties en 1BB, 4BUI, 4BUI et reclassifiées. Cette opération utilise l'argument variadique <varname>reclassarg</varname> qui peut prendre en entrée un nombre variable de reclassargs (théoriquement autant de bandes que vous avez)

note: Tag: title
en: Example: Advanced Map a single band 32BF raster to multiple viewable bands
fr: Exemple avancé : Mapping d'un raster 32BF à bande unique en plusieurs bandes visualisables

note: Tag: para
en: Create a new 3 band (8BUI,8BUI,8BUI viewable raster) from a raster that has only one 32bf band
fr: Crée un nouveau raster à 3 bandes (8BUI, 8BUI, 8BUI visualisable) à partir d'un raster qui n'a qu'une seule bande de 32bf

note: Tag: refpurpose
en: Returns the union of a set of raster tiles into a single raster composed of 1 or more bands.
fr: Retourne l'union d'un ensemble de tuiles raster, en un seul raster composé de 1 ou plusieurs bandes.

note: Tag: para
en: Returns the union of a set of raster tiles into a single raster composed of at least one band. The resulting raster's extent is the extent of the whole set. In the case of intersection, the resulting value is defined by <varname>uniontype</varname> which is one of the following: LAST (default), FIRST, MIN, MAX, COUNT, SUM, MEAN, RANGE.
fr: Retourne l'union d'un ensemble de tuiles raster en un seul raster, composé d'au moins une bande. L'étendue du raster résultant est l'étendue de l'ensemble. Dans le cas d'une intersection, la valeur résultante est définie par <varname>uniontype</varname> parmi : LAST (par défaut), FIRST, MIN, MAX, COUNT, SUM, MEAN, RANGE.

note: Tag: para
en: In order for rasters to be unioned, they must all have the same alignment. Use <xref linkend="RT_ST_SameAlignment"/> and <xref linkend="RT_ST_NotSameAlignmentReason"/> for more details and help. One way to fix alignment issues is to use <xref linkend="RT_ST_Resample"/> and use the same reference raster for alignment.
fr: Pour pouvoir calculer l'union de raster, tous les rasters doivent avoir le même alignement. Voir <xref linkend="RT_ST_SameAlignment"/> et <xref linkend="RT_ST_NotSameAlignmentReason"/> pour plus de détails. Une façon de résoudre les problèmes d'alignement est d'utiliser <xref linkend="RT_ST_Resample"/> et d'utiliser le même raster de référence pour l'alignement.

note: Tag: para
en: Enhanced: 2.1.0 Improved Speed (fully C-Based).
fr: Amélioration : 2.1.0 Vitesse améliorée (entièrement en C).

note: Tag: para
en: Availability: 2.1.0 ST_Union(rast, unionarg) variant was introduced.
fr: Disponibilité : 2.1.0 Ajout de la variante ST_Union(rast, unionarg).

note: Tag: para
en: Enhanced: 2.1.0 ST_Union(rast) (variant 1) unions all bands of all input rasters. Prior versions of PostGIS assumed the first band.
fr: Amélioration : 2.1.0 ST_Union(rast) (variante 1) permet l'union sur toutes les bandes de tous les rasters d'entrée. Les versions précédentes de PostGIS ne prenaient en compte que la première bande.

note: Tag: para
en: Enhanced: 2.1.0 ST_Union(rast, uniontype) (variant 4) unions all bands of all input rasters.
fr: Amélioration : 2.1.0 ST_Union(rast, uniontype) (variante 4) permet l'union de toutes les bandes de tous les rasters d'entrée.

note: Tag: title
en: Examples: Reconstitute a single band chunked raster tile
fr: Exemples : Reconstituer une tuile raster à partir d'une tuile raster fragmentée d'une seule bande

note: Tag: title
en: Examples: Return a multi-band raster that is the union of tiles intersecting geometry
fr: Exemples : Retourne un raster multi-bandes qui est l'union de tuiles intersectant une géométrie

note: Tag: para
en: Here we use the longer syntax if we only wanted a subset of bands or we want to change order of bands
fr: Nous utilisons ici la syntaxe plus longue si nous ne voulons qu'un sous-ensemble de bandes ou si nous voulons changer l'ordre des bandes

note: Tag: title
en: Built-in Map Algebra Callback Functions
fr: Fonctions de rappel intégrées d'algèbre cartographique

note: Tag: refpurpose
en: Raster processing function that calculates the number of unique pixel values in a neighborhood.
fr: Fonction de traitement des données raster qui calcule le nombre de valeurs de pixels uniques dans un voisinage.

note: Tag: para
en: Calculate the number of unique pixel values in a neighborhood of pixels.
fr: Calcule le nombre de valeurs de pixels uniques dans un voisinage de pixels.

note: Tag: para
en: Variant 1 is a specialized callback function for use as a callback parameter to <xref linkend="RT_ST_MapAlgebraFctNgb"/>.
fr: La variante 1 est une fonction de rappel spécialisée à utiliser comme paramètre de rappel pour <xref linkend="RT_ST_MapAlgebraFctNgb"/>.

note: Tag: para
en: Variant 2 is a specialized callback function for use as a callback parameter to <xref linkend="RT_ST_MapAlgebra"/>.
fr: La variante 2 est une fonction de rappel spécialisée à utiliser comme paramètre de rappel pour <xref linkend="RT_ST_MapAlgebra"/>.

note: Tag: para
en: Use of Variant 1 is discouraged since <xref linkend="RT_ST_MapAlgebraFctNgb"/> has been deprecated as of 2.1.0.
fr: L'utilisation de la variante 1 est non recommandée, <xref linkend="RT_ST_MapAlgebraFctNgb"/> étant dépréciée depuis 2.1.0.

note: Tag: para
en: Enhanced: 2.1.0 Addition of Variant 2
fr: Amélioration : 2.1.0 Ajout de la variante 2

note: Tag: refpurpose
en: Raster processing function that interpolates a pixel's value from the pixel's neighborhood.
fr: Fonction de traitement des données raster qui interpole la valeur d'un pixel à partir de son voisinage.

note: Tag: para
en: Calculate an interpolated value for a pixel using the Inverse Distance Weighted method.
fr: Calcule une valeur interpolée pour un pixel en utilisant la méthode de la distance inverse pondérée.

note: Tag: para
en: There are two optional parameters that can be passed through <varname>userargs</varname>. The first parameter is the power factor (variable k in the equation below) between 0 and 1 used in the Inverse Distance Weighted equation. If not specified, default value is 1. The second parameter is the weight percentage applied only when the value of the pixel of interest is included with the interpolated value from the neighborhood. If not specified and the pixel of interest has a value, that value is returned.
fr: Deux paramètres facultatifs peuvent être fournis par l'intermédiaire de <varname>userargs</varname>. Le premier paramètre est le facteur de puissance (variable k dans l'équation ci-dessous) entre 0 et 1, utilisé dans l'équation de la pondération de la distance inverse. S'il n'est pas spécifié, la valeur par défaut est 1. Le second paramètre est le pourcentage de pondération, appliqué uniquement lorsque la valeur du pixel d'intérêt est incluse dans la valeur interpolée du voisinage. S'il n'est pas spécifié et que le pixel d'intérêt a une valeur, cette valeur est retournée.

note: Tag: para
en: The basic inverse distance weight equation is:
fr: L'équation de base de la distance inverse pondérée est :

note: Tag: para
en: k = power factor, a real number between 0 and 1
fr: k = facteur de puissance, un nombre réel entre 0 et 1

note: Tag: para
en: This function is a specialized callback function for use as a callback parameter to <xref linkend="RT_ST_MapAlgebra"/>.
fr: Cette fonction est une fonction de rappel spécialisée à utiliser comme paramètre de rappel pour <xref linkend="RT_ST_MapAlgebra"/>.

note: Tag: refpurpose
en: Raster processing function that calculates the maximum pixel value in a neighborhood.
fr: Fonction de traitement des données raster qui calcule la valeur maximale d'un pixel dans un voisinage.

note: Tag: para
en: Calculate the maximum pixel value in a neighborhood of pixels.
fr: Calcule la valeur maximale d'un pixel dans un voisinage de pixels.

note: Tag: para
en: For Variant 2, a substitution value for NODATA pixels can be specified by passing that value to userargs.
fr: Pour la variante 2, une valeur de substitution pour les pixels NODATA peut être spécifiée en passant cette valeur à userargs.

note: Tag: refpurpose
en: Raster processing function that calculates the mean pixel value in a neighborhood.
fr: Fonction de traitement des données raster qui calcule la valeur moyenne d'un pixel dans un voisinage.

note: Tag: para
en: Calculate the mean pixel value in a neighborhood of pixels.
fr: Calcule la valeur moyenne d'un pixel dans un voisinage de pixels.

note: Tag: refpurpose
en: Raster processing function that calculates the minimum pixel value in a neighborhood.
fr: Fonction de traitement des données raster qui calcule la valeur minimale d'un pixel dans un voisinage.

note: Tag: para
en: Calculate the minimum pixel value in a neighborhood of pixels.
fr: Calcule la valeur minimale d'un pixel dans un voisinage de pixels.

note: Tag: refpurpose
en: Raster processing function that returns the minimum distance (in number of pixels) between the pixel of interest and a neighboring pixel with value.
fr: Fonction de traitement des données raster qui renvoie la distance minimale (en nombre de pixels) entre le pixel d'intérêt et un pixel voisin ayant une valeur.

note: Tag: para
en: Return the shortest distance (in number of pixels) between the pixel of interest and the closest pixel with value in the neighborhood.
fr: Retourne la plus petite distance (en nombre de pixels) entre le pixel d'intérêt et le pixel le plus proche ayant une valeur dans le voisinage.

note: Tag: para
en: The intent of this function is to provide an informative data point that helps infer the usefulness of the pixel of interest's interpolated value from <xref linkend="RT_ST_InvDistWeight4ma"/>. This function is particularly useful when the neighborhood is sparsely populated.
fr: Le but de cette fonction est de fournir un point de données informatif qui aide à déduire l'utilité de la valeur interpolée du pixel d'intérêt à partir de <xref linkend="RT_ST_InvDistWeight4ma"/>. Cette fonction est particulièrement utile lorsque le voisinage est peu peuplé.

note: Tag: refpurpose
en: Raster processing function that calculates the range of pixel values in a neighborhood.
fr: Fonction de traitement des données raster qui calcule la plage de valeurs des pixels dans un voisinage.

note: Tag: para
en: Calculate the range of pixel values in a neighborhood of pixels.
fr: Calcule la plage de valeurs des pixels dans un voisinage de pixels.

note: Tag: refpurpose
en: Raster processing function that calculates the standard deviation of pixel values in a neighborhood.
fr: Fonction de traitement des données raster qui calcule l'écart type des valeurs des pixels dans un voisinage.

note: Tag: para
en: Calculate the standard deviation of pixel values in a neighborhood of pixels.
fr: Calcule l'écart type des valeurs des pixels dans un voisinage de pixels.

note: Tag: refpurpose
en: Raster processing function that calculates the sum of all pixel values in a neighborhood.
fr: Fonction de traitement des données raster qui calcule la somme de toutes les valeurs de pixels dans un voisinage.

note: Tag: para
en: Calculate the sum of all pixel values in a neighborhood of pixels.
fr: Calcule la somme de toutes les valeurs des pixels dans un voisinage de pixels.

note: Tag: title
en: Raster Processing: DEM (Elevation)
fr: Traitement des données raster : MNT (élévation)

note: Tag: refpurpose
en: Returns the aspect (in degrees by default) of an elevation raster band. Useful for analyzing terrain.
fr: Retourne l'exposition (par défaut, en degrés) d'une bande raster d'élévation. Utile pour l'analyse de terrain.

note: Tag: para
en: Returns the aspect (in degrees by default) of an elevation raster band. Utilizes map algebra and applies the aspect equation to neighboring pixels.
fr: Retourne l'exposition (par défaut, en degrés) d'une bande raster d'élévation. Utilise l'algèbre cartographique et applique l'équation d'exposition aux pixels voisins.

note: Tag: para
en: <varname>units</varname> indicates the units of the aspect. Possible values are: RADIANS, DEGREES (default).
fr: <varname>units</varname> indique l'unité de l'exposition. Les valeurs possibles sont : RADIANS, DEGREES (par défaut).

note: Tag: para
en: When <varname>units</varname> = RADIANS, values are between 0 and 2 * pi radians measured clockwise from North.
fr: Lorsque <varname>units</varname> = RADIANS, les valeurs sont comprises entre 0 et 2 * pi radians, mesurés dans le sens des aiguilles d'une montre à partir du nord.

note: Tag: para
en: When <varname>units</varname> = DEGREES, values are between 0 and 360 degrees measured clockwise from North.
fr: Lorsque <varname>units</varname> = DEGREES, les valeurs sont comprises entre 0 et 360 degrés, mesurés dans le sens des aiguilles d'une montre à partir du nord.

note: Tag: para
en: If slope of pixel is zero, aspect of pixel is -1.
fr: Si la pente du pixel est nulle, l'exposition du pixel est -1.

note: Tag: para
en: For more information about Slope, Aspect and Hillshade, please refer to <link xlink:href="http://webhelp.esri.com/arcgisdesktop/9.3/index.cfm?TopicName=How%20Hillshade%20works">ESRI - How hillshade works</link> and <link xlink:href="http://e2b.erdas.com/fieldguide/wwhelp/wwhimpl/common/html/wwhelp.htm?context=FieldGuide&amp;file=Aspect_Images.html">ERDAS Field Guide - Aspect Images</link>.
fr: Pour plus d'informations sur la pente, l'exposition et l'ombrage, veuillez consulter <link xlink:href="http://webhelp.esri.com/arcgisdesktop/9.3/index.cfm?TopicName=How%20Hillshade%20works">ESRI - How hillshade works</link> et <link xlink:href="http://e2b.erdas.com/fieldguide/wwhelp/wwhimpl/common/html/wwhelp.htm?context=FieldGuide&amp;file=Aspect_Images.html">ERDAS Field Guide - Aspect Images</link>.

note: Tag: para
en: Enhanced: 2.1.0 Uses ST_MapAlgebra() and added optional <varname>interpolate_nodata</varname> function parameter
fr: Amélioration : 2.1.0 Utilise ST_MapAlgebra() et ajout du paramètre optionnel <varname>interpolate_nodata</varname>

note: Tag: para
en: Changed: 2.1.0 In prior versions, return values were in radians. Now, return values default to degrees
fr: Changement : 2.1.0 Dans les versions précédentes, les valeurs retournées étaient en radians. Désormais, les valeurs retournées sont par défaut en degrés

note: Tag: para
en: Complete example of tiles of a coverage. This query only works with PostgreSQL 9.1 or higher.
fr: Exemple complet avec les tuiles d'une couverture. Cette requête ne fonctionne qu'avec PostgreSQL 9.1 ou plus.

note: Tag: refpurpose
en: Returns the hypothetical illumination of an elevation raster band using provided azimuth, altitude, brightness and scale inputs.
fr: Retourne l'hypothétique éclairage d'une bande raster d'élévation en utilisant les valeurs d'azimut, d'altitude, de luminosité et d'échelle fournies.

note: Tag: para
en: Returns the hypothetical illumination of an elevation raster band using the azimuth, altitude, brightness, and scale inputs. Utilizes map algebra and applies the hill shade equation to neighboring pixels. Return pixel values are between 0 and 255.
fr: Retourne l'hypothétique éclairage d'une bande raster d'élévation en utilisant les données d'entrée d'azimut, d'altitude, de luminosité et d'échelle. Utilise l'algèbre cartographique et applique l'équation d'ombrage aux pixels voisins. Les valeurs des pixels retournées sont comprises entre 0 et 255.

note: Tag: para
en: <varname>azimuth</varname> is a value between 0 and 360 degrees measured clockwise from North.
fr: <varname>azimuth</varname> est une valeur comprise entre 0 et 360 degrés, mesurée dans le sens des aiguilles d'une montre à partir du nord.

note: Tag: para
en: <varname>altitude</varname> is a value between 0 and 90 degrees where 0 degrees is at the horizon and 90 degrees is directly overhead.
fr: <varname>altitude</varname> est une valeur comprise entre 0 et 90 degrés, où 0 degré correspond à l'horizon et 90 degrés à la verticale.

note: Tag: para
en: <varname>max_bright</varname> is a value between 0 and 255 with 0 as no brightness and 255 as max brightness.
fr: <varname>max_bright</varname> est une valeur comprise entre 0 et 255, 0 correspondant à une absence de luminosité et 255 à une luminosité maximale.

note: Tag: para
en: <varname>scale</varname> is the ratio of vertical units to horizontal. For Feet:LatLon use scale=370400, for Meters:LatLon use scale=111120.
fr: <varname>scale</varname> est le rapport entre les unités verticales et les unités horizontales. Pour Feet:LatLon, utiliser scale=370400, pour Meters:LatLon utiliser scale=111120.

note: Tag: para
en: If <varname>interpolate_nodata</varname> is TRUE, values for NODATA pixels from the input raster will be interpolated using <xref linkend="RT_ST_InvDistWeight4ma"/> before computing the hillshade illumination.
fr: Si <varname>interpolate_nodata</varname> est TRUE, les valeurs des pixels NODATA du raster d'entrée seront interpolées à l'aide de <xref linkend="RT_ST_InvDistWeight4ma"/> avant de calculer l'éclairage.

note: Tag: para
en: For more information about Hillshade, please refer to <link xlink:href="http://webhelp.esri.com/arcgisdesktop/9.3/index.cfm?TopicName=How%20Hillshade%20works">How hillshade works</link>.
fr: Pour plus d'informations sur l'ombrage, veuillez consulter <link xlink:href="http://webhelp.esri.com/arcgisdesktop/9.3/index.cfm?TopicName=How%20Hillshade%20works">How hillshade works</link>.

note: Tag: para
en: Changed: 2.1.0 In prior versions, azimuth and altitude were expressed in radians. Now, azimuth and altitude are expressed in degrees
fr: Changement : 2.1.0 Dans les versions précédentes, l'azimut et l'altitude étaient exprimés en radians. Désormais, l'azimut et l'altitude sont exprimés en degrés

note: Tag: refpurpose
en: Returns a raster with the calculated "roughness" of a DEM.
fr: Retourne un raster avec la rugosité d'un MNT.

note: Tag: para
en: Calculates the "roughness" of a DEM, by subtracting the maximum from the minimum for a given area.
fr: Calcule la rugosité d'un MNT en soustrayant le maximum du minimum pour une zone donnée.

note: Tag: refpurpose
en: Returns the slope (in degrees by default) of an elevation raster band. Useful for analyzing terrain.
fr: Retourne la pente (par défaut, en degrés) d'une bande raster d'élévation. Utile pour l'analyse de terrain.

note: Tag: para
en: Returns the slope (in degrees by default) of an elevation raster band. Utilizes map algebra and applies the slope equation to neighboring pixels.
fr: Retourne la pente (par défaut, en degrés) d'une bande raster d'élévation. Utilise l'algèbre cartographique et applique l'équation de pente aux pixels voisins.

note: Tag: para
en: <varname>units</varname> indicates the units of the slope. Possible values are: RADIANS, DEGREES (default), PERCENT.
fr: <varname>units</varname> indique l'unité de la pente. Les valeurs possibles sont : RADIANS, DEGREES (par défaut), PERCENT.

note: Tag: para
en: If <varname>interpolate_nodata</varname> is TRUE, values for NODATA pixels from the input raster will be interpolated using <xref linkend="RT_ST_InvDistWeight4ma"/> before computing the surface slope.
fr: Si <varname>interpolate_nodata</varname> est TRUE, les valeurs des pixels NODATA du raster d'entrée seront interpolées à l'aide de <xref linkend="RT_ST_InvDistWeight4ma"/> avant de calculer la pente de la surface.

note: Tag: para
en: For more information about Slope, Aspect and Hillshade, please refer to <link xlink:href="http://webhelp.esri.com/arcgisdesktop/9.3/index.cfm?TopicName=How%20Hillshade%20works">ESRI - How hillshade works</link> and <link xlink:href="http://e2b.erdas.com/fieldguide/wwhelp/wwhimpl/common/html/wwhelp.htm?context=FieldGuide&amp;file=Slope_Images.html">ERDAS Field Guide - Slope Images</link>.
fr: Pour plus d'informations sur la pente, l'exposition et l'ombrage, veuillez consulter <link xlink:href="http://webhelp.esri.com/arcgisdesktop/9.3/index.cfm?TopicName=How%20Hillshade%20works">ESRI - How hillshade works</link> et <link xlink:href="http://e2b.erdas.com/fieldguide/wwhelp/wwhimpl/common/html/wwhelp.htm?context=FieldGuide&amp;file=Slope_Images.html">ERDAS Field Guide - Slope Images</link>.

note: Tag: para
en: Enhanced: 2.1.0 Uses ST_MapAlgebra() and added optional <varname>units</varname>, <varname>scale</varname>, <varname>interpolate_nodata</varname> function parameters
fr: Amélioration : 2.1.0 Utilise ST_MapAlgebra() et ajout des paramètres optionnels <varname>units</varname>, <varname>scale</varname>, <varname>interpolate_nodata</varname>

note: Tag: refpurpose
en: Returns a raster with the calculated Topographic Position Index.
fr: Retourne un raster avec l'index de position topographique (TPI) calculé.

note: Tag: para
en: Calculates the Topographic Position Index, which is defined as the focal mean with radius of one minus the center cell.
fr: Calcule l'index de position topographique (TPI), qui est défini comme la moyenne focale avec un rayon de un moins la cellule centrale.

note: Tag: para
en: This function only supports a focalmean radius of one.
fr: Cette fonction ne prend en charge qu'un rayon focal de un.

note: Tag: refpurpose
en: Returns a raster with the calculated Terrain Ruggedness Index.
fr: Retourne un raster avec l'indice de rugosité du terrain (TRI) calculé.

note: Tag: para
en: Terrain Ruggedness Index is calculated by comparing a central pixel with its neighbors, taking the absolute values of the differences, and averaging the result.
fr: L'indice de rugosité du terrain est calculé en comparant le pixel central à ses voisins, en prenant les valeurs absolues des différences et en faisant la moyenne du résultat.

note: Tag: title
en: Raster Processing: Raster to Geometry
fr: Traitement des données raster : raster vers géométrie

note: Tag: refpurpose
en: Returns the box 3d representation of the enclosing box of the raster.
fr: Retourne la représentation 3d de la boîte englobante du raster.

note: Tag: para
en: Returns the box representing the extent of the raster.
fr: Retourne la boîte représentant l'étendue du raster.

note: Tag: para
en: The polygon is defined by the corner points of the bounding box ((<varname>MINX</varname>, <varname>MINY</varname>), (<varname>MAXX</varname>, <varname>MAXY</varname>))
fr: Le polygone est défini par les points des coins de la boîte englobante ((<varname>MINX</varname>, <varname>MINY</varname>), (<varname>MAXX</varname>, <varname>MAXY</varname>))

note: Tag: para
en: Changed: 2.0.0 In pre-2.0 versions, there used to be a box2d instead of box3d. Since box2d is a deprecated type, this was changed to box3d.
fr: Changement : 2.0.0 Dans les versions antérieures à la version 2.0, utilisait le type box2d au lieu de box3d. Comme box2d est un type obsolète, il a été remplacé par box3d.

note: Tag: refpurpose
en: Return the convex hull geometry of the raster including pixel values equal to BandNoDataValue. For regular shaped and non-skewed rasters, this gives the same result as ST_Envelope so only useful for irregularly shaped or skewed rasters.
fr: Retourne l'enveloppe convexe du raster, en incluant les valeurs de pixels égales à BandNoDataValue. Pour les données raster de forme régulière et sans obliquité, cette fonction donne le même résultat que ST_Envelope ; elle n'est donc utile que pour les données raster de forme irrégulière ou inclinée.

note: Tag: para
en: Return the convex hull geometry of the raster including the NoDataBandValue band pixels. For regular shaped and non-skewed rasters, this gives more or less the same result as ST_Envelope so only useful for irregularly shaped or skewed rasters.
fr: Retourne l'enveloppe convexe du raster, en incluant les valeurs de pixels égales à BandNoDataValue. Pour les données raster de forme régulière et sans obliquité, cette fonction donne plus ou moins le même résultat que ST_Envelope ; elle n'est donc utile que pour les données raster de forme irrégulière ou inclinée.

note: Tag: para
en: ST_Envelope floors the coordinates and hence add a little buffer around the raster so the answer is subtly different from ST_ConvexHull which does not floor.
fr: ST_Envelope arrondit les coordonnées à l'inférieur, et ajoute donc un petit tampon autour du raster. La réponse est donc subtilement différente de ST_ConvexHull qui n'arrondit pas les coordonnées.

note: Tag: para
en: Refer to <link xlink:href="http://trac.osgeo.org/postgis/wiki/WKTRaster/SpecificationWorking01">PostGIS Raster Specification</link> for a diagram of this.
fr: Voir <link xlink:href="http://trac.osgeo.org/postgis/wiki/WKTRaster/SpecificationWorking01">PostGIS Raster Specification</link> pour un diagramme de ceci.

note: Tag: refpurpose
en: Returns a set of geomval (geom,val) rows, from a given raster band. If no band number is specified, band num defaults to 1.
fr: Retourne un ensemble d'enregistrements de type geomval (geom, val), à partir d'une bande raster donnée. Si aucune bande bandnum n'est spécifiée, la bande 1 est utilisée.

note: Tag: para
en: This is a set-returning function (SRF). It returns a set of geomval rows, formed by a geometry (geom) and a pixel band value (val). Each polygon is the union of all pixels for that band that have the same pixel value denoted by val.
fr: Il s'agit d'une fonction de retour d'ensemble (SRF). Elle retourne un ensemble d'enregistrements geomval, composés par une géométrie (geom) et une valeur de bande de pixels (val). Chaque polygone est l'union de tous les pixels de cette bande qui ont la même valeur de pixel, indiquée par val.

note: Tag: para
en: ST_DumpAsPolygon is useful for polygonizing rasters. It is the reverse of a GROUP BY in that it creates new rows. For example it can be used to expand a single raster into multiple POLYGONS/MULTIPOLYGONS.
fr: ST_DumpAsPolygon est utile pour polygoniser les données raster. C'est l'inverse d'un GROUP BY, en ce sens qu'elle crée de nouvelles lignes. Par exemple, cette fonction peut être utilisée pour décomposer un seul raster en plusieurs POLYGONS/MULTIPOLYGONS.

note: Tag: para
en: Changed 3.3.0, validation and fixing is disabled to improve performance. May result invalid geometries.
fr: Changement 3.3.0, la validation et la correction sont désactivées pour améliorer les performances. Peut donc retourner des géométries non valides.

note: Tag: para
en: Availability: Requires GDAL 1.7 or higher.
fr: Disponibilité : Nécessite GDAL 1.7 ou plus.

note: Tag: para
en: If there is a no data value set for a band, pixels with that value will not be returned except in the case of exclude_nodata_value=false.
fr: Si une valeur nodata est définie pour une bande, les pixels ayant cette valeur ne seront pas retournés, sauf si exclude_nodata_value=false.

note: Tag: para
en: If you only care about count of pixels with a given value in a raster, it is faster to use <xref linkend="RT_ST_ValueCount"/>.
fr: Si vous ne voulez que le nombre de pixels ayant une valeur donnée dans un raster, il est plus rapide d'utiliser <xref linkend="RT_ST_ValueCount"/>.

note: Tag: para
en: This is different than ST_PixelAsPolygons where one geometry is returned for each pixel regardless of pixel value.
fr: Cette fonction est différente de ST_PixelAsPolygons, où une géométrie est retournée pour chaque pixel, quelle que soit la valeur du pixel.

note: Tag: refpurpose
en: Returns the polygon representation of the extent of the raster.
fr: Retourne la représentation polygonale de l'étendue du raster.

note: Tag: para
en: Returns the polygon representation of the extent of the raster in spatial coordinate units defined by srid. It is a float8 minimum bounding box represented as a polygon.
fr: Retourne la représentation polygonale de l'étendue du raster, dans les unités du système de référence spatial défini par srid. Il s'agit d'une boîte de délimitation minimale float8 représentée sous la forme d'un polygone.

note: Tag: para
en: The polygon is defined by the corner points of the bounding box ((<varname>MINX</varname>, <varname>MINY</varname>), (<varname>MINX</varname>, <varname>MAXY</varname>), (<varname>MAXX</varname>, <varname>MAXY</varname>), (<varname>MAXX</varname>, <varname>MINY</varname>), (<varname>MINX</varname>, <varname>MINY</varname>))
fr: Le polygone est défini par les points des coins de la boîte englobante ((<varname>MINX</varname>, <varname>MINY</varname>), (<varname>MINX</varname>, <varname>MAXY</varname>), (<varname>MAXX</varname>, <varname>MAXY</varname>), (<varname>MAXX</varname>, <varname>MINY</varname>), (<varname>MINX</varname>, <varname>MINY</varname>))

note: Tag: refpurpose
en: Return the convex hull geometry of the raster excluding NODATA pixels.
fr: Retourne la géométrie de l'enveloppe convexe du raster en excluant les pixels NODATA.

note: Tag: para
en: Return the convex hull geometry of the raster excluding NODATA pixels. If <varname>nband</varname> is NULL, all bands of the raster are considered.
fr: Retourne la géométrie de l'enveloppe convexe du raster en excluant les pixels NODATA. Si <varname>nband</varname> est NULL, toutes les bandes du raster sont prises en compte.

note: Tag: refpurpose
en: Returns a multipolygon geometry formed by the union of pixels that have a pixel value that is not no data value. If no band number is specified, band num defaults to 1.
fr: Retourne une géométrie multipolygonale formée par l'union des pixels dont la valeur est différente de nodata. Si aucune bande bandnum n'est spécifiée, la bande 1 est utilisée.

note: Tag: para
en: Availability: 0.1.6 Requires GDAL 1.7 or higher.
fr: Disponibilité : 0.1.6 Nécessite GDAL 1.7 ou plus.

note: Tag: para
en: Enhanced: 2.1.0 Improved Speed (fully C-Based) and the returning multipolygon is ensured to be valid.
fr: Amélioration : 2.1.0 Vitesse améliorée (entièrement en C) et le multipolygone retourné est garanti d'être valide.

note: Tag: para
en: Changed: 2.1.0 In prior versions would sometimes return a polygon, changed to always return multipolygon.
fr: Changement : 2.1.0 Dans les versions précédentes, retournait parfois un polygone, retourne désormais toujours un multipolygon.

note: Tag: title
en: Raster Operators
fr: Opérateurs raster

note: Tag: refpurpose
en: Returns <varname>TRUE</varname> if A's bounding box intersects B's bounding box.
fr: Retourne <varname>TRUE</varname> si la boite englobante de A intersecte la boite englobante de B.

note: Tag: para
en: The <varname>&amp;&amp;</varname> operator returns <varname>TRUE</varname> if the bounding box of raster/geometr A intersects the bounding box of raster/geometr B.
fr: L'opérateur <varname>&amp;&amp;</varname> retourne <varname>TRUE</varname> si la boîte englobante du raster/géométrie A intersecte la boîte englobante du raster/géométrie B.

note: Tag: para
en: This operand will make use of any indexes that may be available on the rasters.
fr: Cet opérande utilisera tous les index qui peuvent être disponibles sur les données raster.

note: Tag: refpurpose
en: Returns <varname>TRUE</varname> if A's bounding box is to the left of B's.
fr: Retourne <varname>TRUE</varname> si la boîte englobante de A est à gauche de celle de B.

note: Tag: para
en: The <varname>&amp;&lt;</varname> operator returns <varname>TRUE</varname> if the bounding box of raster A overlaps or is to the left of the bounding box of raster B, or more accurately, overlaps or is NOT to the right of the bounding box of raster B.
fr: L'opérateur <varname>&amp;&lt;</varname> retourne <varname>TRUE</varname> si la boîte englobante du raster A chevauche ou est à gauche de la boîte englobante de B ou, plus précisément, si elle chevauche ou n'est PAS à droite de la boîte englobante de B.

note: Tag: refpurpose
en: Returns <varname>TRUE</varname> if A's bounding box is to the right of B's.
fr: Retourne <varname>TRUE</varname> si la boîte englobante de A est à droite de celle de B.

note: Tag: para
en: The <varname>&amp;&gt;</varname> operator returns <varname>TRUE</varname> if the bounding box of raster A overlaps or is to the right of the bounding box of raster B, or more accurately, overlaps or is NOT to the left of the bounding box of raster B.
fr: L'opérateur <varname>&amp;&gt;</varname> retourne <varname>TRUE</varname> si la boîte englobante du raster A chevauche ou est à droite de la boîte englobante du raster B ou, plus précisément, si elle chevauche ou n'est PAS à gauche de la boîte englobante du raster B.

note: Tag: refpurpose
en: Returns <varname>TRUE</varname> if A's bounding box is the same as B's. Uses double precision bounding box.
fr: Retourne <varname>TRUE</varname> si la boîte englobante de A est la même que celle de B. Utilise des boîtes englobantes en double précision.

note: Tag: para
en: The <varname>&#61;</varname> operator returns <varname>TRUE</varname> if the bounding box of raster A is the same as the bounding box of raster B. PostgreSQL uses the =, &lt;, and &gt; operators defined for rasters to perform internal orderings and comparison of rasters (ie. in a GROUP BY or ORDER BY clause).
fr: L'opérateur <varname>&#61;</varname> retourne <varname>TRUE</varname> si la boîte englobante du raster A est la même que celle du raster B. PostgreSQL utilise les opérateurs =, &lt;, et &gt; définis pour les rasters pour effectuer des tris et comparaisons internes sur les rasters (par exemple, dans une clause GROUP BY ou ORDER BY).

note: Tag: para
en: This operand will NOT make use of any indexes that may be available on the rasters. Use <xref linkend="RT_Raster_Same"/> instead. This operator exists mostly so one can group by the raster column.
fr: Cet opérande n'utilisera PAS les index éventuellement disponibles sur les données raster. Utilisez plutôt <xref linkend="RT_Raster_Same"/>. Cet opérateur existe principalement pour permettre le regroupement par colonne raster.

note: Tag: refpurpose
en: Returns <varname>TRUE</varname> if A's bounding box is contained by B's. Uses double precision bounding box.
fr: Retourne <varname>TRUE</varname> si la boîte englobante de A est contenue dans celle de B. Utilise des boîtes englobantes en double précision.

note: Tag: para
en: The <varname>@</varname> operator returns <varname>TRUE</varname> if the bounding box of raster/geometry A is contained by bounding box of raster/geometr B.
fr: L'opérateur <varname>@</varname> retourne <varname>TRUE</varname> si la boîte englobante du raster/géométrie A est contenue dans la boîte englobante du raster/géométrie B.

note: Tag: para
en: This operand will use spatial indexes on the rasters.
fr: Cet opérande utilisera des index spatiaux sur les données raster.

note: Tag: para
en: Availability: 2.0.0 raster @ raster, raster @ geometry introduced
fr: Disponibilité : 2.0.0 ajout de raster @ raster, raster @ geometry

note: Tag: para
en: Availability: 2.0.5 geometry @ raster introduced
fr: Disponibilité : 2.0.5 ajout de geometry @ raster

note: Tag: para
en: The <varname>~=</varname> operator returns <varname>TRUE</varname> if the bounding box of raster A is the same as the bounding box of raster B.
fr: L'opérateur <varname>~=</varname> retourne <varname>TRUE</varname> si la boîte englobante du raster A est la même que la boîte englobante du raster B.

note: Tag: para
en: Very useful usecase is for taking two sets of single band rasters that are of the same chunk but represent different themes and creating a multi-band raster
fr: Un cas d'utilisation très utile est celui où l'on prend deux ensembles de rasters à bande unique qui sont du même morceau mais représentent des thèmes différents, et où l'on crée un raster multi-bandes

note: Tag: refpurpose
en: Returns <varname>TRUE</varname> if A's bounding box is contains B's. Uses double precision bounding box.
fr: Retourne <varname>TRUE</varname> si la boîte englobante de A contient celle de B. Utilise des boîtes englobantes en double précision.

note: Tag: para
en: The <varname>~</varname> operator returns <varname>TRUE</varname> if the bounding box of raster/geometry A is contains bounding box of raster/geometr B.
fr: L'opérateur <varname>~</varname> retourne <varname>TRUE</varname> si la boîte englobante du raster/géométrie A contient la boîte englobante du raster/géométrie B.

note: Tag: title
en: Raster and Raster Band Spatial Relationships
fr: Relations spatiales entre raster et entre bandes raster

note: Tag: refpurpose
en: Return true if no points of raster rastB lie in the exterior of raster rastA and at least one point of the interior of rastB lies in the interior of rastA.
fr: Retourne true si aucun point du raster rastB ne se trouve à l'extérieur du raster rastA et si au moins un point de l'intérieur du raster rastB se trouve à l'intérieur du raster rastA.

note: Tag: para
en: Raster rastA contains rastB if and only if no points of rastB lie in the exterior of rastA and at least one point of the interior of rastB lies in the interior of rastA. If the band number is not provided (or set to NULL), only the convex hull of the raster is considered in the test. If the band number is provided, only those pixels with value (not NODATA) are considered in the test.
fr: Le raster rastA contient rastB si et seulement si aucun point de rastB ne se trouve à l'extérieur de rastA et si au moins un point de l'intérieur de rastB se trouve à l'intérieur de rastA. Si le numéro de bande n'est pas spécifié (ou si NULL), seule l'enveloppe convexe du raster est prise en compte dans le test. Si un numéro de bande est spécifié, seuls les pixels ayant une valeur (différente de NODATA) sont pris en compte dans le test.

note: Tag: para
en: This function will make use of any indexes that may be available on the rasters.
fr: Cette fonction utilisera tous les index qui peuvent être disponibles sur les données raster.

note: Tag: para
en: To test the spatial relationship of a raster and a geometry, use ST_Polygon on the raster, e.g. ST_Contains(ST_Polygon(raster), geometry) or ST_Contains(geometry, ST_Polygon(raster)).
fr: Pour tester la relation spatiale entre un raster et une géométrie, utilisez ST_Polygon sur le raster, par exemple ST_Contains(ST_Polygon(raster), geometry) ou ST_Contains(geometry, ST_Polygon(raster)).

note: Tag: para
en: ST_Contains() is the inverse of ST_Within(). So, ST_Contains(rastA, rastB) implies ST_Within(rastB, rastA).
fr: ST_Contains() est l'inverse de ST_Within(). Ainsi, ST_Contains(rastA, rastB) implique ST_Within(rastB, rastA).

note: Tag: refpurpose
en: Return true if rastB intersects the interior of rastA but not the boundary or exterior of rastA.
fr: Retourne true si rastB intersecte l'intérieur de rastA, mais pas la frontière ou l'extérieur de rastA.

note: Tag: para
en: Raster rastA contains properly rastB if rastB intersects the interior of rastA but not the boundary or exterior of rastA. If the band number is not provided (or set to NULL), only the convex hull of the raster is considered in the test. If the band number is provided, only those pixels with value (not NODATA) are considered in the test.
fr: Le raster rastA contient proprement rastB si rastB intersecte l'intérieur de rastA mais pas la limite ou l'extérieur de rastA. Si le numéro de bande n'est pas spécifié (ou si NULL), seule l'enveloppe convexe du raster est prise en compte dans le test. Si le numéro de bande est spécifié, seuls les pixels ayant une valeur (différente de NODATA) sont pris en compte dans le test.

note: Tag: para
en: Raster rastA does not contain properly itself but does contain itself.
fr: Le raster rastA ne contient pas proprement lui-même, mais il se contient lui-même.

note: Tag: para
en: To test the spatial relationship of a raster and a geometry, use ST_Polygon on the raster, e.g. ST_ContainsProperly(ST_Polygon(raster), geometry) or ST_ContainsProperly(geometry, ST_Polygon(raster)).
fr: Pour tester la relation spatiale entre un raster et une géométrie, utilisez ST_Polygon sur le raster, par exemple ST_ContainsProperly(ST_Polygon(raster), geometry) ou ST_ContainsProperly(geometry, ST_Polygon(raster)).

note: Tag: refpurpose
en: Return true if no points of raster rastB lie outside raster rastA.
fr: Retourne true si aucun point du raster rastB ne se trouve à l'extérieur du raster rastA.

note: Tag: para
en: Raster rastA covers rastB if and only if no points of rastB lie in the exterior of rastA. If the band number is not provided (or set to NULL), only the convex hull of the raster is considered in the test. If the band number is provided, only those pixels with value (not NODATA) are considered in the test.
fr: Le raster rastA recouvre le raster rastB si et seulement si aucun point du raster rastB ne se trouve à l'extérieur du raster rastA. Si le numéro de bande n'est pas spécifié (ou si NULL), seule l'enveloppe convexe du raster est prise en compte dans le test. Si le numéro de bande est spécifié, seuls les pixels ayant une valeur (différente de NODATA) sont pris en compte dans le test.

note: Tag: para
en: To test the spatial relationship of a raster and a geometry, use ST_Polygon on the raster, e.g. ST_Covers(ST_Polygon(raster), geometry) or ST_Covers(geometry, ST_Polygon(raster)).
fr: Pour tester la relation spatiale entre un raster et une géométrie, utilisez ST_Polygon sur le raster, par exemple ST_Covers(ST_Polygon(raster), geometry) ou ST_Covers(geometry, ST_Polygon(raster)).

note: Tag: refpurpose
en: Return true if no points of raster rastA lie outside raster rastB.
fr: Retourne true si aucun point du raster rastA ne se trouve à l'extérieur du raster rastB.

note: Tag: para
en: Raster rastA is covered by rastB if and only if no points of rastA lie in the exterior of rastB. If the band number is not provided (or set to NULL), only the convex hull of the raster is considered in the test. If the band number is provided, only those pixels with value (not NODATA) are considered in the test.
fr: Le raster rastA est couvert par rastB si et seulement si aucun point de rastA ne se trouve à l'extérieur de rastB. Si le numéro de bande n'est pas spécifié (ou si NULL), seule l'enveloppe convexe du raster est prise en compte dans le test. Si le numéro de bande est spécifié, seuls les pixels ayant une valeur (différente de NODATA) sont pris en compte dans le test.

note: Tag: para
en: To test the spatial relationship of a raster and a geometry, use ST_Polygon on the raster, e.g. ST_CoveredBy(ST_Polygon(raster), geometry) or ST_CoveredBy(geometry, ST_Polygon(raster)).
fr: Pour tester la relation spatiale entre un raster et une géométrie, utilisez ST_Polygon sur le raster, par exemple ST_CoveredBy(ST_Polygon(raster), geometry) ou ST_CoveredBy(geometry, ST_Polygon(raster)).

note: Tag: refpurpose
en: Return true if raster rastA does not spatially intersect rastB.
fr: Retourne true si le raster rastA n'intersecte pas spatialement le rastB.

note: Tag: para
en: Raster rastA and rastB are disjointed if they do not share any space together. If the band number is not provided (or set to NULL), only the convex hull of the raster is considered in the test. If the band number is provided, only those pixels with value (not NODATA) are considered in the test.
fr: Les rasters rastA et rastB sont disjoints s'ils ne partagent aucun espace. Si le numéro de bande n'est pas spécifié (ou si NULL), seule l'enveloppe convexe du raster est prise en compte dans le test. Si le numéro de bande est spécifié, seuls les pixels ayant une valeur (différente de NODATA) sont pris en compte dans le test.

note: Tag: para
en: This function does NOT use any indexes.
fr: Cette fonction n'utilise PAS d'index.

note: Tag: para
en: To test the spatial relationship of a raster and a geometry, use ST_Polygon on the raster, e.g. ST_Disjoint(ST_Polygon(raster), geometry).
fr: Pour tester la relation spatiale entre un raster et une géométrie, utilisez ST_Polygon sur le raster, par exemple ST_Disjoint(ST_Polygon(raster), geometry).

note: Tag: refpurpose
en: Return true if raster rastA spatially intersects raster rastB.
fr: Retourne vrai si le raster rastA intersecte spatialement le raster rastB.

note: Tag: para
en: Return true if raster rastA spatially intersects raster rastB. If the band number is not provided (or set to NULL), only the convex hull of the raster is considered in the test. If the band number is provided, only those pixels with value (not NODATA) are considered in the test.
fr: Retourne vrai si le raster rastA intersecte spatialement le raster rastB. Si le numéro de bande n'est pas spécifié (ou si NULL), seule l'enveloppe convexe du raster est prise en compte dans le test. Si le numéro de bande est spécifié, seuls les pixels ayant une valeur (différente de NODATA) sont pris en compte dans le test.

note: Tag: para
en: Enhanced: 2.0.0 support raster/raster intersects was introduced.
fr: Amélioration : 2.0.0 ajout de l'intersection raster/raster.

note: Tag: para
en: Changed: 2.1.0 The behavior of the ST_Intersects(raster, geometry) variants changed to match that of ST_Intersects(geometry, raster).
fr: Changement : 2.1.0 Le fonctionnement des variantes ST_Intersects(raster, geometry) a changé pour correspondre au fonctionnement de ST_Intersects(geometry, raster).

note: Tag: refpurpose
en: Return true if raster rastA and rastB intersect but one does not completely contain the other.
fr: Retourne true si les raster rastA et rastB intersectent mais que l'un ne contient pas complètement l'autre.

note: Tag: para
en: Return true if raster rastA spatially overlaps raster rastB. This means that rastA and rastB intersect but one does not completely contain the other. If the band number is not provided (or set to NULL), only the convex hull of the raster is considered in the test. If the band number is provided, only those pixels with value (not NODATA) are considered in the test.
fr: Retourne true si le raster rastA recouvre spatialement le raster rastB. Cela signifie que rastA et rastB intersectent mais que l'un ne contient pas complètement l'autre. Si le numéro de bande n'est pas spécifié (ou si NULL), seule l'enveloppe convexe du raster est prise en compte dans le test. Si le numéro de bande est spécifié, seuls les pixels ayant une valeur (différente de NODATA) sont pris en compte dans le test.

note: Tag: para
en: To test the spatial relationship of a raster and a geometry, use ST_Polygon on the raster, e.g. ST_Overlaps(ST_Polygon(raster), geometry).
fr: Pour tester la relation spatiale entre un raster et une géométrie, utilisez ST_Polygon sur le raster, par exemple ST_Overlaps(ST_Polygon(raster), geometry).

note: Tag: refpurpose
en: Return true if raster rastA and rastB have at least one point in common but their interiors do not intersect.
fr: Retourne true si les raster rastA et rastB ont au moins un point en commun mais que leurs intérieurs n'intersectent pas.

note: Tag: para
en: Return true if raster rastA spatially touches raster rastB. This means that rastA and rastB have at least one point in common but their interiors do not intersect. If the band number is not provided (or set to NULL), only the convex hull of the raster is considered in the test. If the band number is provided, only those pixels with value (not NODATA) are considered in the test.
fr: Retourne true si le raster rastA touche spatialement le raster rastB. Cela signifie que rastA et rastB ont au moins un point en commun mais que leurs intérieurs n’intersectent pas. Si le numéro de bande n'est pas spécifié (ou si NULL), seule l'enveloppe convexe du raster est prise en compte dans le test. Si le numéro de bande est spécifié, seuls les pixels ayant une valeur (différente de NODATA) sont pris en compte dans le test.

note: Tag: para
en: To test the spatial relationship of a raster and a geometry, use ST_Polygon on the raster, e.g. ST_Touches(ST_Polygon(raster), geometry).
fr: Pour tester la relation spatiale entre un raster et une géométrie, utilisez ST_Polygon sur le raster, par exemple ST_Touches(ST_Polygon(raster), geometry).

note: Tag: refpurpose
en: Returns true if rasters have same skew, scale, spatial ref, and offset (pixels can be put on same grid without cutting into pixels) and false if they don't with notice detailing issue.
fr: Retourne true si les rasters ont les mêmes skew, scale, spatial ref, et offset (les pixels peuvent être placés sur la même grille sans être coupés) et false si ce n'est pas le cas, avec une NOTICE détaillant le problème.

note: Tag: para
en: Non-Aggregate version (Variants 1 and 2): Returns true if the two rasters (either provided directly or made using the values for upperleft, scale, skew and srid) have the same scale, skew, srid and at least one of any of the four corners of any pixel of one raster falls on any corner of the grid of the other raster. Returns false if they don't and a NOTICE detailing the alignment issue.
fr: Version non agrégée (variantes 1 et 2) : Retourne true si les deux rasters (fournis directement ou créés en utilisant les valeurs pour upperleft, scale, skew et srid) ont la même échelle, le même skew, le même srid et si au moins un des quatre coins de n'importe quel pixel d'un raster tombe sur n'importe quel coin de la grille de l'autre raster. Retourne false si ce n'est pas le cas et un NOTICE détaillant le problème d'alignement.

note: Tag: para
en: Aggregate version (Variant 3): From a set of rasters, returns true if all rasters in the set are aligned. The ST_SameAlignment() function is an "aggregate" function in the terminology of PostgreSQL. That means that it operates on rows of data, in the same way the SUM() and AVG() functions do.
fr: Version agrégée (variante 3) : A partir d'un ensemble de rasters, retourne vrai si tous les rasters de l'ensemble sont alignés. La fonction ST_SameAlignment() est une fonction "agrégée" dans la terminologie de PostgreSQL. Cela signifie qu'elle opère sur des lignes de données, de la même manière que les fonctions SUM() et AVG().

note: Tag: para
en: Enhanced: 2.1.0 addition of Aggegrate variant
fr: Amélioration : 2.1.0 ajout de la variante agrégée

note: Tag: title
en: Examples: Rasters
fr: Exemples : Rasters

note: Tag: refpurpose
en: <refpurpose>Returns text stating if rasters are aligned and if not aligned, a reason why.</refpurpose>
fr: <refpurpose>Retourne un texte indiquant si les rasters sont alignés et, s'ils ne le sont pas, la raison du problème.</refpurpose>

note: Tag: para
en: <para>Returns text stating if rasters are aligned and if not aligned, a reason why.</para>
fr: <para>Retourne un texte indiquant si les rasters sont alignés et, s'ils ne le sont pas, la raison du problème.</para>

note: Tag: para
en: If there are several reasons why the rasters are not aligned, only one reason (the first test to fail) will be returned.
fr: S'il y a plusieurs raisons pour lesquelles les rasters ne sont pas alignés, une seule raison (le premier test qui a échoué) sera retournée.

note: Tag: refpurpose
en: Return true if no points of raster rastA lie in the exterior of raster rastB and at least one point of the interior of rastA lies in the interior of rastB.
fr: Retourne true si aucun point du raster rastA ne se trouve à l'extérieur du raster rastB et si au moins un point de l'intérieur du raster rastA se trouve à l'intérieur du raster rastB.

note: Tag: para
en: Raster rastA is within rastB if and only if no points of rastA lie in the exterior of rastB and at least one point of the interior of rastA lies in the interior of rastB. If the band number is not provided (or set to NULL), only the convex hull of the raster is considered in the test. If the band number is provided, only those pixels with value (not NODATA) are considered in the test.
fr: Le raster rastA est compris dans rastB si et seulement si aucun point de rastA ne se trouve à l'extérieur de rastB et si au moins un point de l'intérieur de rastA se trouve à l'intérieur de rastB. Si le numéro de bande n'est pas spécifié (ou si NULL), seule l'enveloppe convexe du raster est prise en compte dans le test. Si le numéro de bande est spécifié, seuls les pixels ayant une valeur (différente de NODATA) sont pris en compte dans le test.

note: Tag: para
en: To test the spatial relationship of a raster and a geometry, use ST_Polygon on the raster, e.g. ST_Within(ST_Polygon(raster), geometry) or ST_Within(geometry, ST_Polygon(raster)).
fr: Pour tester la relation spatiale entre un raster et une géométrie, utilisez ST_Polygon sur le raster, par exemple ST_Within(ST_Polygon(raster), geometry) ou ST_Within(geometry, ST_Polygon(raster)).

note: Tag: para
en: ST_Within() is the inverse of ST_Contains(). So, ST_Within(rastA, rastB) implies ST_Contains(rastB, rastA).
fr: ST_Within() est l'inverse de ST_Contains(). Ainsi, ST_Within(rastA, rastB) implique ST_Contains(rastB, rastA).

note: Tag: refpurpose
en: Return true if rasters rastA and rastB are within the specified distance of each other.
fr: Retourne true si les rasters rastA et rastB se trouvent à une distance donnée l'un de l'autre.

note: Tag: para
en: Return true if rasters rastA and rastB are within the specified distance of each other. If the band number is not provided (or set to NULL), only the convex hull of the raster is considered in the test. If the band number is provided, only those pixels with value (not NODATA) are considered in the test.
fr: Retourne true si les rasters rastA et rastB sont à la distance spécifiée l'un de l'autre. Si le numéro de bande n'est pas spécifié (ou si NULL), seule l'enveloppe convexe du raster est prise en compte dans le test. Si le numéro de bande est spécifié, seuls les pixels ayant une valeur (différente de NODATA) sont pris en compte dans le test.

note: Tag: para
en: The distance is specified in units defined by the spatial reference system of the rasters. For this function to make sense, the source rasters must both be of the same coordinate projection, having the same SRID.
fr: La distance est spécifiée en unités définies par le système de référence spatiale des rasters. Pour que cette fonction ait un sens, les rasters sources doivent avoir la même projection de coordonnées et le même SRID.

note: Tag: para
en: To test the spatial relationship of a raster and a geometry, use ST_Polygon on the raster, e.g. ST_DWithin(ST_Polygon(raster), geometry).
fr: Pour tester la relation spatiale entre un raster et une géométrie, utilisez ST_Polygon sur le raster, par exemple ST_DWithin(ST_Polygon(raster), geometry).

note: Tag: refpurpose
en: Return true if rasters rastA and rastB are fully within the specified distance of each other.
fr: Retourne true si les rasters rastA et rastB se trouvent entièrement à une distance donnée l'un de l'autre.

note: Tag: para
en: Return true if rasters rastA and rastB are fully within the specified distance of each other. If the band number is not provided (or set to NULL), only the convex hull of the raster is considered in the test. If the band number is provided, only those pixels with value (not NODATA) are considered in the test.
fr: Retourne true si les rasters rastA et rastB sont entièrement à une distance donnée l'un de l'autre. Si le numéro de bande n'est pas spécifié (ou si NULL), seule l'enveloppe convexe du raster est prise en compte dans le test. Si le numéro de bande est spécifié, seuls les pixels ayant une valeur (différente de NODATA) sont pris en compte dans le test.

note: Tag: para
en: To test the spatial relationship of a raster and a geometry, use ST_Polygon on the raster, e.g. ST_DFullyWithin(ST_Polygon(raster), geometry).
fr: Pour tester la relation spatiale entre un raster et une géométrie, utilisez ST_Polygon sur le raster, par exemple ST_DFullyWithin(ST_Polygon(raster), geometry).

note: Tag: title
en: Raster Tips
fr: Astuces raster

note: Tag: para
en: This section documents various gotchas and tips related to PostGIS Raster.
fr: Cette section présente divers pièges et astuces liés à PostGIS raster.

note: Tag: title
en: Out-DB Rasters
fr: Rasters out-DB

note: Tag: title
en: Directory containing many files
fr: Répertoire contenant de nombreux fichiers

note: Tag: para
en: When GDAL opens a file, GDAL eagerly scans the directory of that file to build a catalog of other files. If this directory contains many files (e.g. thousands, millions), opening that file becomes extremely slow (especially if that file happens to be on a network drive such as NFS).
fr: Lorsque GDAL ouvre un fichier, il parcourt l'entièreté du répertoire du fichier pour construire un catalogue d'autres fichiers. Si ce répertoire contient de nombreux fichiers (par exemple des milliers, des millions), l'ouverture de ce fichier devient extrêmement lente (en particulier si ce fichier se trouve sur un lecteur réseau tel que NFS).

note: Tag: para
en: To control this behavior, GDAL provides the following environment variable: <link xlink:href="https://trac.osgeo.org/gdal/wiki/ConfigOptions#GDAL_DISABLE_READDIR_ON_OPEN">GDAL_DISABLE_READDIR_ON_OPEN</link>. Set <varname>GDAL_DISABLE_READDIR_ON_OPEN</varname> to <varname>TRUE</varname> to disable directory scanning.
fr: Pour contrôler ce comportement, GDAL fournit la variable d'environnement suivante : <link xlink:href="https://trac.osgeo.org/gdal/wiki/ConfigOptions#GDAL_DISABLE_READDIR_ON_OPEN">GDAL_DISABLE_READDIR_ON_OPEN</link>. Définissez <varname>GDAL_DISABLE_READDIR_ON_OPEN</varname> à <varname>TRUE</varname> pour désactiver l'analyse des répertoires.

note: Tag: para
en: In Ubuntu (and assuming you are using PostgreSQL's packages for Ubuntu), <varname>GDAL_DISABLE_READDIR_ON_OPEN</varname> can be set in <emphasis>/etc/postgresql/POSTGRESQL_VERSION/CLUSTER_NAME/environment</emphasis> (where POSTGRESQL_VERSION is the version of PostgreSQL, e.g. 9.6 and CLUSTER_NAME is the name of the cluster, e.g. maindb). You can also set PostGIS environment variables here as well.
fr: Sous Ubuntu (et en supposant que vous utilisez les paquets PostgreSQL pour Ubuntu), <varname>GDAL_DISABLE_READDIR_ON_OPEN</varname> peut être défini dans <emphasis>/etc/postgresql/POSTGRESQL_VERSION/CLUSTER_NAME/environment</emphasis> (où POSTGRESQL_VERSION est la version de PostgreSQL, par ex.9.6 et CLUSTER_NAME est le nom du cluster, par exemple maindb). Vous pouvez également définir les variables d'environnement PostGIS ici.

note: Tag: title
en: Maximum Number of Open Files
fr: Nombre maximum de fichiers ouverts

note: Tag: para
en: The maximum number of open files permitted by Linux and PostgreSQL are typically conservative (typically 1024 open files per process) given the assumption that the system is consumed by human users. For Out-DB Rasters, a single valid query can easily exceed this limit (e.g. a dataset of 10 year's worth of rasters with one raster for each day containing minimum and maximum temperatures and we want to know the absolute min and max value for a pixel in that dataset).
fr: Le nombre maximum de fichiers ouverts autorisé par Linux et PostgreSQL est généralement prudent (typiquement 1024 fichiers ouverts par processus), étant donné l'hypothèse que le système est utilisé par des utilisateurs humains. Pour les rasters Out-DB, une seule requête valide peut facilement dépasser cette limite (par exemple, un jeu de données de 10 ans avec un raster pour chaque jour contenant les températures minimales et maximales et nous voulons connaître les valeurs min et max absolues pour un pixel dans ce jeu de données).

note: Tag: para
en: The easiest change to make is the following PostgreSQL setting: <link xlink:href="https://www.postgresql.org/docs/current/static/runtime-config-resource.html#GUC-MAX-FILES-PER-PROCESS">max_files_per_process</link>. The default is set to 1000, which is far too low for Out-DB Rasters. A safe starting value could be 65536 but this really depends on your datasets and the queries run against those datasets. This setting can only be made on server start and probably only in the PostgreSQL configuration file (e.g. <emphasis>/etc/postgresql/POSTGRESQL_VERSION/CLUSTER_NAME/postgresql.conf</emphasis> in Ubuntu environments).
fr: Le changement le plus simple à effectuer est le paramètre suivant de PostgreSQL : <link xlink:href="https://www.postgresql.org/docs/current/static/runtime-config-resource.html#GUC-MAX-FILES-PER-PROCESS">max_files_per_process</link>. La valeur par défaut est de 1000, ce qui est beaucoup trop faible pour les données raster Out-DB. Une valeur de départ sûre pourrait être 65536, mais cela dépend vraiment de vos ensembles de données et des requêtes exécutées sur ces ensembles de données. Ce paramètre ne peut être défini qu'au démarrage du serveur et probablement uniquement dans le fichier de configuration de PostgreSQL (par exemple <emphasis>/etc/postgresql/POSTGRESQL_VERSION/CLUSTER_NAME/postgresql.conf</emphasis> dans les environnements Ubuntu).

note: Tag: para
en: The major change to make is the Linux kernel's open files limits. There are two parts to this:
fr: La principale modification à apporter concerne les limites des fichiers ouverts du noyau Linux. Il y a deux parties à cela :

note: Tag: para
en: <para>Maximum number of open files for the entire system</para>
fr: <para>Nombre maximal de fichiers ouverts pour l'ensemble du système</para>

note: Tag: para
en: <para>Maximum number of open files per process</para>
fr: <para>Nombre maximal de fichiers ouverts par processus</para>

note: Tag: title
en: <title>Maximum number of open files for the entire system</title>
fr: <title>Nombre maximal de fichiers ouverts pour l'ensemble du système</title>

note: Tag: para
en: You can inspect the current maximum number of open files for the entire system with the following example:
fr: L'exemple suivant vous permet de connaître le nombre maximum de fichiers ouverts sur l'ensemble du système :

note: Tag: para
en: If the value returned is not large enough, add a file to <emphasis>/etc/sysctl.d/</emphasis> as per the following example:
fr: Si la valeur retournée n'est pas assez importante, ajoutez un fichier dans <emphasis>/etc/sysctl.d/</emphasis> comme dans l'exemple suivant :

note: Tag: title
en: <title>Maximum number of open files per process</title>
fr: <title>Nombre maximal de fichiers ouverts par processus</title>

note: Tag: para
en: We need to increase the maximum number of open files per process for the PostgreSQL server processes.
fr: Nous devons augmenter le nombre maximum de fichiers ouverts par processus pour les processus du serveur PostgreSQL.

note: Tag: para
en: To see what the current PostgreSQL service processes are using for maximum number of open files, do as per the following example (make sure to have PostgreSQL running):
fr: Pour connaître le nombre maximal de fichiers ouverts utilisé par les processus de service PostgreSQL, suivez l'exemple suivant (assurez-vous que PostgreSQL est en cours d'exécution) :

note: Tag: para
en: In the example above, we inspected the open files limit for Process 31718. It doesn't matter which PostgreSQL process, any of them will do. The response we are interested in is <emphasis>Max open files</emphasis>.
fr: Dans l'exemple ci-dessus, nous avons inspecté la limite des fichiers ouverts pour le processus 31718. Peu importe le processus PostgreSQL, n'importe lequel fera l'affaire. La réponse qui nous intéresse est <emphasis>Max open files</emphasis>.

note: Tag: para
en: We want to increase <emphasis>Soft Limit</emphasis> and <emphasis>Hard Limit</emphasis> of <emphasis>Max open files</emphasis> to be greater than the value we specified for the PostgreSQL setting <varname>max_files_per_process</varname>. In our example, we set <varname>max_files_per_process</varname> to 65536.
fr: Nous voulons augmenter <emphasis>Soft Limit</emphasis> et <emphasis>Hard Limit</emphasis> de <emphasis>Max open files</emphasis> pour qu'il soit supérieur à la valeur que nous avons spécifiée pour le paramètre PostgreSQL <varname>max_files_per_process</varname>. Dans notre exemple, nous avons fixé <varname>max_files_per_process</varname> à 65536.

note: Tag: para
en: In Ubuntu (and assuming you are using PostgreSQL's packages for Ubuntu), the easiest way to change the <emphasis>Soft Limit</emphasis> and <emphasis>Hard Limit</emphasis> is to edit <emphasis role="strong">/etc/init.d/postgresql</emphasis> (SysV) or <emphasis role="strong">/lib/systemd/system/postgresql*.service</emphasis> (systemd).
fr: Sous Ubuntu (et en supposant que vous utilisez les paquets PostgreSQL pour Ubuntu), la façon la plus simple de changer les paramètres <emphasis>Soft Limit</emphasis> et <emphasis>Hard Limit</emphasis> est d'éditer <emphasis role="strong">/etc/init.d/postgresql</emphasis> (SysV) ou <emphasis role="strong">/lib/systemd/system/postgresql*.service</emphasis> (systemd).

note: Tag: para
en: Let's first address the SysV Ubuntu case where we add <emphasis role="strong">ulimit -H -n 262144</emphasis> and <emphasis role="strong">ulimit -n 131072</emphasis> to <emphasis role="strong">/etc/init.d/postgresql</emphasis>.
fr: Commençons par le cas de SysV Ubuntu où nous ajoutons <emphasis role="strong">ulimit -H -n 262144</emphasis> et <emphasis role="strong">ulimit -n 131072</emphasis> à <emphasis role="strong">/etc/init.d/postgresql</emphasis>.

note: Tag: para
en: Now to address the systemd Ubuntu case. We will add <emphasis role="strong">LimitNOFILE=131072</emphasis> to every <emphasis role="strong">/lib/systemd/system/postgresql*.service</emphasis> file in the <emphasis role="strong">[Service]</emphasis> section.
fr: Passons maintenant au cas de systemd Ubuntu. Nous ajouterons <emphasis role="strong">LimitNOFILE=131072</emphasis> à chaque fichier <emphasis role="strong">/lib/systemd/system/postgresql*.service</emphasis> dans la section <emphasis role="strong">[Service]</emphasis>.

note: Tag: para
en: After making the necessary systemd changes, make sure to reload the daemon
fr: Après avoir effectué les changements nécessaires à systemd, assurez-vous de recharger le démon

note: Tag: title
en: Spatial Relationships
fr: Relations spatiales

note: Tag: para
en: These functions determine spatial relationships between geometries.
fr: Ces fonctions déterminent les relations spatiales entre les géométries.

note: Tag: title
en: Topological Relationships
fr: Relations topologiques

note: Tag: refpurpose
en: Tests if two geometries spatially intersect in 3D - only for points, linestrings, polygons, polyhedral surface (area)
fr: Teste si deux géométries se croisent dans l'espace en 3D - uniquement pour les points, les lignes, les polygones, les surfaces polyédriques (aire)

note: Tag: para
en: Overlaps, Touches, Within all imply spatial intersection. If any of the aforementioned returns true, then the geometries also spatially intersect. Disjoint implies false for spatial intersection.
fr: Overlaps, Touches, Within impliquent tous une intersection spatiale. Si l'un des éléments susmentionnés renvoie un résultat positif, les géométries se recoupent également dans l'espace. Disjoint implique faux pour l'intersection spatiale.

note: Tag: para
en: Because of floating robustness failures, geometries don't always intersect as you'd expect them to after geometric processing. For example the closest point on a linestring to a geometry may not lie on the linestring. For these kind of issues where a distance of a centimeter you want to just consider as intersecting, use <xref linkend="ST_3DDWithin"/>.
fr: En raison des défaillances de la robustesse flottante, les géométries ne se croisent pas toujours comme on s'y attendrait après le traitement géométrique. Par exemple, le point le plus proche d'une géométrie sur une ligne peut ne pas se trouver sur la ligne. Pour ce type de problèmes, lorsqu'une distance d'un centimètre est considérée comme une intersection, utilisez <xref linkend="ST_3DDWithin"/>.

note: Tag: para
en: Changed: 3.0.0 SFCGAL backend removed, GEOS backend supports TINs.
fr: Modifié : 3.0.0 SFCGAL backend supprimé, GEOS backend supporte les TINs.

note: Tag: title
en: TIN Examples
fr: Exemples TIN

note: Tag: refpurpose
en: Tests if every point of B lies in A, and their interiors have a point in common
fr: Tests si chaque point de B est situé dans A, et que leurs intérieurs ont un point commun

note: Tag: para
en: Returns TRUE if geometry A contains geometry B. A contains B if and only if all points of B lie inside (i.e. in the interior or boundary of) A (or equivalently, no points of B lie in the exterior of A), and the interiors of A and B have at least one point in common.
fr: Renvoie TRUE si la géométrie A contient la géométrie B. A contient B si et seulement si tous les points de B se trouvent à l'intérieur (c'est-à-dire à l'intérieur ou à la limite) de A (ou, de manière équivalente, si aucun point de B ne se trouve à l'extérieur de A), et si les intérieurs de A et de B ont au moins un point en commun.

note: Tag: para
en: In mathematical terms: <emphasis>ST_Contains(A, B) ⇔ (A ⋂ B = B) ∧ (Int(A) ⋂ Int(B) ≠ ∅) </emphasis>
fr: En termes mathématiques : <emphasis>ST_Contains(A, B) ⇔ (A ⋂ B = B) ∧ (Int(A) ⋂ Int(B) ≠ ∅). </emphasis>

note: Tag: para
en: The contains relationship is reflexive: every geometry contains itself. (In contrast, in the <xref linkend="ST_ContainsProperly"/> predicate a geometry does <emphasis>not</emphasis> properly contain itself.) The relationship is antisymmetric: if <code>ST_Contains(A,B) = true</code> and <code>ST_Contains(B,A) = true</code>, then the two geometries must be topologically equal (<code>ST_Equals(A,B) = true</code>).
fr: La relation contains est réflexive : toute géométrie se contient elle-même. (En revanche, dans le prédicat <xref linkend="ST_ContainsProperly"/>, une géométrie ne se contient<emphasis>pas</emphasis> elle-même correctement). La relation est antisymétrique : si <code>ST_Contains(A,B) = true</code> et <code>ST_Contains(B,A) = true</code>, alors les deux géométries doivent être topologiquement égales (<code>ST_Equals(A,B) = true</code>).

note: Tag: para
en: ST_Contains is the converse of <xref linkend="ST_Within"/>. So, <code>ST_Contains(A,B) = ST_Within(B,A)</code>.
fr: ST_Contains est le contraire de <xref linkend="ST_Within"/>. Ainsi, <code>ST_Contains(A,B) = ST_Within(B,A)</code>.

note: Tag: para
en: Because the interiors must have a common point, a subtlety of the definition is that polygons and lines do <emphasis>not</emphasis> contain lines and points lying fully in their boundary. For further details see <link xlink:href="http://lin-ear-th-inking.blogspot.com/2007/06/subtleties-of-ogc-covers-spatial.html">Subtleties of OGC Covers, Contains, Within</link>. The <xref linkend="ST_Covers"/> predicate provides a more inclusive relationship.
fr: Comme les intérieurs doivent avoir un point commun, une subtilité de la définition est que les polygones et les lignes ne contiennent <emphasis>pas</emphasis> de lignes et de points se trouvant entièrement dans leur limite. Pour plus de détails, voir <link xlink:href="http://lin-ear-th-inking.blogspot.com/2007/06/subtleties-of-ogc-covers-spatial.html">Subtleties of OGC Covers, Contains, Within</link>. Le prédicat <xref linkend="ST_Covers"/> fournit une relation plus inclusive.

note: Tag: para
en: &index_aware; To avoid index use, use the function <function>_ST_Contains</function>.
fr: &index_aware; Pour éviter l'utilisation d'un index, utilisez la fonction <function>_ST_Contains</function>.

note: Tag: para
en: Enhanced: 2.3.0 Enhancement to PIP short-circuit extended to support MultiPoints with few points. Prior versions only supported point in polygon.
fr: Amélioré : 2.3.0 Amélioration du court-circuit PIP étendu à la prise en charge des multipoints avec peu de points. Les versions précédentes ne prenaient en charge que les points dans les polygones.

note: Tag: para
en: Enhanced: 3.0.0 enabled support for <varname>GEOMETRYCOLLECTION</varname>
fr: Amélioration : 3.0.0 a permis la prise en charge de <varname>GEOMETRYCOLLECTION</varname>

note: Tag: para
en: Do not use this function with invalid geometries. You will get unexpected results.
fr: N'utilisez pas cette fonction avec des géométries non valides. Vous obtiendrez des résultats inattendus.

note: Tag: para
en: NOTE: this is the "allowable" version that returns a boolean, not an integer.
fr: NOTE : il s'agit de la version "autorisée" qui renvoie un booléen et non un entier.

note: Tag: para
en: &sfs_compliant; s2.1.1.2 // s2.1.13.3 - same as within(geometry B, geometry A)
fr: &sfs_compliant; s2.1.1.2 // s2.1.13.3 - identique à within(geometry B, geometry A)

note: Tag: para
en: <function>ST_Contains</function> returns <varname>TRUE</varname> in the following situations:
fr: <function>ST_Contains</function> renvoie <varname>TRUE</varname> dans les situations suivantes :

note: Tag: para
en: <function>ST_Contains</function> returns <varname>FALSE</varname> in the following situations:
fr: La <function>ST_Contains</function> renvoie <varname>FALSE</varname> dans les situations suivantes :

note: Tag: para
en: Due to the interior intersection condition <function>ST_Contains</function> returns <varname>FALSE</varname> in the following situations (whereas <function>ST_Covers</function> returns <varname>TRUE</varname>):
fr: En raison de la condition d'intersection intérieure, la <function>ST_Contains</function> renvoie <varname>FALSE</varname> dans les situations suivantes (alors que la <function>ST_Covers</function> renvoie <varname>TRUE</varname>) :

note: Tag: refpurpose
en: Tests if every point of B lies in the interior of A
fr: Tests si chaque point de B se trouve à l'intérieur de A

note: Tag: para
en: Returns <varname>true</varname> if every point of B lies in the interior of A (or equivalently, no point of B lies in the the boundary or exterior of A).
fr: Retourne <varname>vrai</varname> si chaque point de B se trouve à l'intérieur de A (ou, de façon équivalente, si aucun point de B ne se trouve à la limite ou à l'extérieur de A).

note: Tag: para
en: In mathematical terms: <emphasis>ST_ContainsProperly(A, B) ⇔ Int(A) ⋂ B = B </emphasis>
fr: En termes mathématiques : <emphasis>ST_ContainsProperly(A, B) ⇔ Int(A) ⋂ B = B </emphasis>

note: Tag: para
en: A contains B properly if the DE-9IM Intersection Matrix for the two geometries matches [T**FF*FF*]
fr: A contient B correctement si la matrice d'intersection DE-9IM pour les deux géométries correspond à [T**FF*FF*]

note: Tag: para
en: A does not properly contain itself, but does contain itself.
fr: A ne se contient pas proprement, mais se contient.

note: Tag: para
en: A use for this predicate is computing the intersections of a set of geometries with a large polygonal geometry. Since intersection is a fairly slow operation, it can be more efficient to use containsProperly to filter out test geometries which lie fully inside the area. In these cases the intersection is known a priori to be exactly the original test geometry.
fr: Ce prédicat peut être utilisé pour calculer les intersections d'un ensemble de géométries avec une grande géométrie polygonale. L'intersection étant une opération assez lente, il peut être plus efficace d'utiliser containsProperly pour filtrer les géométries de test qui se trouvent entièrement à l'intérieur de la zone. Dans ce cas, on sait a priori que l'intersection correspond exactement à la géométrie d'essai originale.

note: Tag: para
en: &index_aware; To avoid index use, use the function <function>_ST_ContainsProperly</function>.
fr: &index_aware; Pour éviter l'utilisation d'un index, utilisez la fonction <function>_ST_ContainsProperly</function>.

note: Tag: para
en: The advantage of this predicate over <xref linkend="ST_Contains"/> and <xref linkend="ST_Intersects"/> is that it can be computed more efficiently, with no need to compute topology at individual points.
fr: L'avantage de ce prédicat par rapport à <xref linkend="ST_Contains"/> et <xref linkend="ST_Intersects"/> est qu'il peut être calculé plus efficacement, sans qu'il soit nécessaire de calculer la topologie en des points individuels.

note: Tag: refpurpose
en: Tests if every point of A lies in B
fr: Tests si chaque point de A se trouve dans B

note: Tag: para
en: Returns <varname>true</varname> if every point in Geometry/Geography A lies inside (i.e. intersects the interior or boundary of) Geometry/Geography B. Equivalently, tests that no point of A lies outside (in the exterior of) B.
fr: Renvoie <varname>true</varname> si chaque point de la geometry/geography A se trouve à l'intérieur (c'est-à-dire coupe l'intérieur ou la limite) de la geometry/geography B. De manière équivalente, teste qu'aucun point de A ne se trouve à l'extérieur (dans l'extérieur) de B.

note: Tag: para
en: In mathematical terms: <emphasis>ST_CoveredBy(A, B) ⇔ A ⋂ B = A </emphasis>
fr: En termes mathématiques : <emphasis>ST_CoveredBy(A, B) ⇔ A ⋂ B = A </emphasis>

note: Tag: para
en: ST_CoveredBy is the converse of <xref linkend="ST_Covers"/>. So, <code>ST_CoveredBy(A,B) = ST_Covers(B,A)</code>.
fr: ST_CoveredBy est le contraire de <xref linkend="ST_Covers"/>. Ainsi, <code>ST_CoveredBy(A,B) = ST_Covers(B,A)</code>.

note: Tag: para
en: Generally this function should be used instead of <xref linkend="ST_Within"/>, since it has a simpler definition which does not have the quirk that "boundaries are not within their geometry".
fr: En général, cette fonction devrait être utilisée à la place de <xref linkend="ST_Within"/>, car elle a une définition plus simple qui n'a pas la particularité que "les limites ne sont pas à l'intérieur de leur géométrie".

note: Tag: para
en: &index_aware; To avoid index use, use the function <function>_ST_CoveredBy</function>.
fr: &index_aware; Pour éviter l'utilisation d'un index, utilisez la fonction <function>_ST_CoveredBy</function>.

note: Tag: para
en: Not an OGC standard, but Oracle has it too.
fr: Il ne s'agit pas d'une norme de l'OGC, mais Oracle l'a également.

note: Tag: refpurpose
en: Tests if every point of B lies in A
fr: Tests si chaque point de B est situé dans A

note: Tag: para
en: Returns <varname>true</varname> if every point in Geometry/Geography B lies inside (i.e. intersects the interior or boundary of) Geometry/Geography A. Equivalently, tests that no point of B lies outside (in the exterior of) A.
fr: Renvoie <varname>true</varname> si chaque point de la geometry/geography B se trouve à l'intérieur (c'est-à-dire qu'il coupe l'intérieur ou la limite) de la geometry/geography A. De façon équivalente, teste qu'aucun point de B ne se trouve à l'extérieur (dans l'extérieur) de A.

note: Tag: para
en: In mathematical terms: <emphasis>ST_Covers(A, B) ⇔ A ⋂ B = B </emphasis>
fr: En termes mathématiques : <emphasis>ST_Covers(A, B) ⇔ A ⋂ B = B </emphasis>

note: Tag: para
en: ST_Covers is the converse of <xref linkend="ST_CoveredBy"/>. So, <code>ST_Covers(A,B) = ST_CoveredBy(B,A)</code>.
fr: ST_Covers est le contraire de <xref linkend="ST_CoveredBy"/>. Ainsi, <code>ST_Covers(A,B) = ST_CoveredBy(B,A)</code>.

note: Tag: para
en: Generally this function should be used instead of <xref linkend="ST_Contains"/>, since it has a simpler definition which does not have the quirk that "geometries do not contain their boundary".
fr: En général, cette fonction devrait être utilisée à la place de <xref linkend="ST_Contains"/>, car elle a une définition plus simple qui n'a pas la particularité que "les géométries ne contiennent pas leur frontière".

note: Tag: para
en: &index_aware; To avoid index use, use the function <function>_ST_Covers</function>.
fr: &index_aware; Pour éviter l'utilisation d'un index, utilisez la fonction <function>_ST_Covers</function>.

note: Tag: para
en: Enhanced: 2.4.0 Support for polygon in polygon and line in polygon added for geography type
fr: Amélioration : 2.4.0 Ajout de la prise en charge des polygones dans les polygones et des lignes dans les polygones pour le type geography

note: Tag: para
en: Enhanced: 2.3.0 Enhancement to PIP short-circuit for geometry extended to support MultiPoints with few points. Prior versions only supported point in polygon.
fr: Amélioration : 2.3.0 Amélioration du court-circuit PIP pour la géométrie étendue à la prise en charge des multipoints avec peu de points. Les versions précédentes ne prenaient en charge que les points dans les polygones.

note: Tag: para
en: Geometry example
fr: Exemple géométrique

note: Tag: para
en: Geeography Example
fr: Exemple géographique

note: Tag: refpurpose
en: Tests if two geometries have some, but not all, interior points in common
fr: Teste si deux géométries ont en commun certains points intérieurs, mais pas tous

note: Tag: para
en: Compares two geometry objects and returns <varname>true</varname> if their intersection "spatially crosses"; that is, the geometries have some, but not all interior points in common. The intersection of the interiors of the geometries must be non-empty and must have dimension less than the maximum dimension of the two input geometries, and the intersection of the two geometries must not equal either geometry. Otherwise, it returns <varname>false</varname>. The crosses relation is symmetric and irreflexive.
fr: Compare deux objets géométriques et renvoie <varname>true</varname> si leur intersection "se croise spatialement", c'est-à-dire que les géométries ont certains points intérieurs en commun, mais pas tous. L'intersection des intérieurs des géométries doit être non vide et doit avoir une dimension inférieure à la dimension maximale des deux géométries d'entrée, et l'intersection des deux géométries ne doit pas être égale à l'une ou l'autre géométrie. Sinon, il renvoie <varname>false</varname>. La relation entre les croix est symétrique et irréflexive.

note: Tag: para
en: In mathematical terms: <emphasis>ST_Crosses(A, B) ⇔ (dim( Int(A) ⋂ Int(B) ) &lt; max( dim( Int(A) ), dim( Int(B) ) )) ∧ (A ⋂ B ≠ A) ∧ (A ⋂ B ≠ B) </emphasis>
fr: En termes mathématiques : <emphasis>ST_Crosses(A, B) ⇔ (dim( Int(A) ⋂ Int(B) ) &lt; max( dim( Int(A) ), dim( Int(B) ) )) ∧ (A ⋂ B ≠ A) ∧ (A ⋂ B ≠ B) </emphasis>

note: Tag: para
en: Geometries cross if their DE-9IM Intersection Matrix matches:
fr: Les géométries se croisent si leur matrice d'intersection DE-9IM correspond :

note: Tag: para
en: <code>T*T******</code> for Point/Line, Point/Area, and Line/Area situations
fr: <code>T*T******</code> pour les situations point/ligne, point/zone et ligne/zone

note: Tag: para
en: <code>T*****T**</code> for Line/Point, Area/Point, and Area/Line situations
fr: <code>T*****T**</code> pour les situations Ligne/Point, Zone/Point et Zone/Ligne

note: Tag: para
en: <code>0********</code> for Line/Line situations
fr: <code>0********</code> pour les situations ligne/ligne

note: Tag: para
en: the result is <varname>false</varname> for Point/Point and Area/Area situations
fr: le résultat est <varname>false</varname> pour les situations Point/Point et Area/Area

note: Tag: para
en: The OpenGIS Simple Features Specification defines this predicate only for Point/Line, Point/Area, Line/Line, and Line/Area situations. JTS / GEOS extends the definition to apply to Line/Point, Area/Point and Area/Line situations as well. This makes the relation symmetric.
fr: La spécification OpenGIS Simple Features définit ce prédicat uniquement pour les situations Point/Ligne, Point/Zone, Ligne/Ligne et Ligne/Zone. Le STC / GEOS étend la définition pour qu'elle s'applique également aux situations Ligne/Point, Zone/Point et Zone/Ligne. Cela rend la relation symétrique.

note: Tag: para
en: The following situations all return <varname>true</varname>.
fr: Les situations suivantes renvoient toutes <varname>true</varname>.

note: Tag: para
en: Consider a situation where a user has two tables: a table of roads and a table of highways.
fr: Prenons le cas d'un utilisateur qui dispose de deux tables : une table de routes et une table d'autoroutes.

note: Tag: para
en: To determine a list of roads that cross a highway, use a query similar to:
fr: Pour obtenir une liste des routes qui traversent une autoroute, utilisez une requête similaire à :

note: Tag: refpurpose
en: Tests if two geometries have no points in common
fr: Teste si deux géométries n'ont pas de points communs

note: Tag: para
en: Returns <varname>true</varname> if two geometries are disjoint. Geometries are disjoint if they have no point in common.
fr: Renvoie <varname>true</varname> si deux géométries sont disjointes. Les géométries sont disjointes si elles n'ont aucun point en commun.

note: Tag: para
en: If any other spatial relationship is true for a pair of geometries, they are not disjoint. Disjoint implies that <xref linkend="ST_Intersects"/> is false.
fr: Si une autre relation spatiale est vraie pour une paire de géométries, celles-ci ne sont pas disjointes. La disjonction implique que <xref linkend="ST_Intersects"/> est fausse.

note: Tag: para
en: In mathematical terms: <emphasis>ST_Disjoint(A, B) ⇔ A ⋂ B = ∅ </emphasis>
fr: En termes mathématiques : <emphasis>ST_Disjoint(A, B) ⇔ A ⋂ B = ∅ </emphasis>

note: Tag: para
en: This function call does not use indexes. A negated <xref linkend="ST_Intersects"/> predicate can be used as a more performant alternative that uses indexes: <code>ST_Disjoint(A,B) = NOT ST_Intersects(A,B)</code>
fr: Cet appel de fonction n'utilise pas d'index. Un prédicat négatif <xref linkend="ST_Intersects"/> peut être utilisé comme une alternative plus performante qui utilise des index : <code>ST_Disjoint(A,B) = NOT ST_Intersects(A,B)</code>

note: Tag: refpurpose
en: Tests if two geometries include the same set of points
fr: Teste si deux géométries comprennent le même ensemble de points

note: Tag: para
en: Returns <varname>true</varname> if the given geometries are "topologically equal". Use this for a 'better' answer than '='. Topological equality means that the geometries have the same dimension, and their point-sets occupy the same space. This means that the order of vertices may be different in topologically equal geometries. To verify the order of points is consistent use <xref linkend="ST_OrderingEquals"/> (it must be noted ST_OrderingEquals is a little more stringent than simply verifying order of points are the same).
fr: Renvoie <varname>true</varname> si les géométries données sont "topologiquement égales". Utilisez ceci pour une "meilleure" réponse que "=". L'égalité topologique signifie que les géométries ont la même dimension et que leurs ensembles de points occupent le même espace. Cela signifie que l'ordre des sommets peut être différent dans des géométries topologiquement égales. Pour vérifier que l'ordre des points est cohérent, utilisez <xref linkend="ST_OrderingEquals"/> (il convient de noter que ST_OrderingEquals est un peu plus strict que la simple vérification de l'ordre des points).

note: Tag: para
en: In mathematical terms: <emphasis>ST_Equals(A, B) ⇔ A = B </emphasis>
fr: En termes mathématiques : <emphasis>ST_Equals(A, B) ⇔ A = B </emphasis>

note: Tag: para
en: The following relation holds: <emphasis>ST_Equals(A, B) ⇔ ST_Within(A,B) ∧ ST_Within(B,A) </emphasis>
fr: La relation suivante est valable : <emphasis>ST_Equals(A, B) ⇔ ST_Within(A,B) ∧ ST_Within(B,A) </emphasis>

note: Tag: para
en: Changed: 2.2.0 Returns true even for invalid geometries if they are binary equal
fr: Modifié : 2.2.0 Retourne vrai même pour les géométries invalides si elles sont binairement égales

note: Tag: refpurpose
en: Tests if two geometries intersect (they have at least one point in common)
fr: Teste si deux géométries se croisent (elles ont au moins un point en commun)

note: Tag: para
en: Returns <varname>true</varname> if two geometries intersect. Geometries intersect if they have any point in common.
fr: Renvoie <varname>true</varname> si deux géométries se croisent. Les géométries se croisent si elles ont un point commun.

note: Tag: para
en: For geography, a distance tolerance of 0.00001 meters is used (so points that are very close are considered to intersect).
fr: Pour les objets de type geography, une tolérance de distance de 0,00001 mètre est utilisée (les points très proches sont donc considérés comme se croisant).

note: Tag: para
en: In mathematical terms: <emphasis>ST_Intersects(A, B) ⇔ A ⋂ B ≠ ∅ </emphasis>
fr: En termes mathématiques : <emphasis>ST_Intersects(A, B) ⇔ A ⋂ B ≠ ∅ </emphasis>

note: Tag: para
en: Geometries intersect if their DE-9IM Intersection Matrix matches one of:
fr: Les géométries se croisent si leur matrice d'intersection DE-9IM correspond à l'un des éléments suivants :

note: Tag: para
en: Spatial intersection is implied by all the other spatial relationship tests, except <xref linkend="ST_Disjoint"/>, which tests that geometries do NOT intersect.
fr: L'intersection spatiale est impliquée par tous les autres tests de relations spatiales, à l'exception de <xref linkend="ST_Disjoint"/>, qui teste que les géométries ne se croisent PAS.

note: Tag: para
en: Changed: 3.0.0 SFCGAL version removed and native support for 2D TINS added.
fr: Modifié : 3.0.0 La version SFCGAL a été supprimée et la prise en charge native des TINS 2D a été ajoutée.

note: Tag: para
en: Enhanced: 2.5.0 Supports GEOMETRYCOLLECTION.
fr: Amélioré : 2.5.0 Supporte GEOMETRYCOLLECTION.

note: Tag: para
en: Performed by the GEOS module (for geometry), geography is native
fr: Effectuée par le module GEOS (pour geometry), la geography est native

note: Tag: para
en: Availability: 1.5 support for geography was introduced.
fr: Disponibilité : la version 1.5 a introduit la prise en charge du type geography.

note: Tag: para
en: For geography, this function has a distance tolerance of about 0.00001 meters and uses the sphere rather than spheroid calculation.
fr: Pour geography, cette fonction a une tolérance de distance d'environ 0,00001 mètre et utilise la sphère plutôt que le calcul du sphéroïde.

note: Tag: refpurpose
en: Returns a number indicating the crossing behavior of two LineStrings
fr: Renvoie un nombre indiquant le comportement de croisement de deux LineStrings

note: Tag: para
en: Given two linestrings returns an integer between -3 and 3 indicating what kind of crossing behavior exists between them. 0 indicates no crossing. This is only supported for <varname>LINESTRING</varname>s.
fr: En ayant 2 lignes en entrée, renvoie un nombre entier entre -3 et 3 indiquant le type de croisement qui existe entre elles. 0 indique qu'il n'y a pas de croisement. Cette fonction n'est prise en charge que pour les <varname>LINESTRING</varname>s.

note: Tag: para
en: The crossing number has the following meaning:
fr: Le numéro de croisement a la signification suivante :

note: Tag: para
en: 0: LINE NO CROSS
fr: 0 : LIGNE SANS CROISEMENT

note: Tag: para
en: -1: LINE CROSS LEFT
fr: -1 : LIGNE CROISÉE À GAUCHE

note: Tag: para
en: 1: LINE CROSS RIGHT
fr: -1 : LIGNE CROISÉE À DROITE

note: Tag: para
en: -2: LINE MULTICROSS END LEFT
fr: -2 : LIGNE MULTICROISEMENT EXTRÉMITÉ GAUCHE

note: Tag: para
en: 2: LINE MULTICROSS END RIGHT
fr: -2 : LIGNE MULTICROISEMENT EXTRÉMITÉ DROITE

note: Tag: para
en: -3: LINE MULTICROSS END SAME FIRST LEFT
fr: -3 : LIGNE MULTICROISEMENT FIN IDENTIQUE AU PREMIER GAUCHE

note: Tag: para
en: 3: LINE MULTICROSS END SAME FIRST RIGHT
fr: -3 : LIGNE MULTICROISEMENT FIN IDENTIQUE AU PREMIER DROITE

note: Tag: para
en: Availability: 1.4
fr: Disponibilité : 1.4

note: Tag: para
en: <emphasis role="bold">Example:</emphasis> LINE CROSS LEFT and LINE CROSS RIGHT
fr: <emphasis role="bold">Exemple:</emphasis> LIGNE CROISEE A GAUCHE et LIGNE CROISEE A DROITE

note: Tag: para
en: Blue: Line A; Green: Line B
fr: Bleu : Ligne A ; Vert : Ligne B

note: Tag: para
en: <emphasis role="bold">Example:</emphasis> LINE MULTICROSS END SAME FIRST LEFT and LINE MULTICROSS END SAME FIRST RIGHT
fr: <emphasis role="bold">Exemple:</emphasis> LIGNE MULTICROISEMENT FIN IDENTIQUE AU PREMIER GAUCHE et LIGNE MULTICROISEMENT FIN IDENTIQUE AU PREMIER DROITE

note: Tag: para
en: <emphasis role="bold">Example:</emphasis> LINE MULTICROSS END LEFT and LINE MULTICROSS END RIGHT
fr: <emphasis role="bold">Exemple:</emphasis> LIGNE MULTICROISEMENT EXTRÉMITÉ GAUCHE et LIGNE MULTICROISEMENT EXTRÉMITÉ DROITE

note: Tag: para
en: <emphasis role="bold">Example:</emphasis> Finds all streets that cross
fr: <emphasis role="bold">Exemple:</emphasis> Trouve toutes les rues qui se croisent

note: Tag: refpurpose
en: Tests if two geometries represent the same geometry and have points in the same directional order
fr: Teste si deux géométries représentent la même géométrie et ont des points dans le même ordre directionnel

note: Tag: para
en: ST_OrderingEquals compares two geometries and returns t (TRUE) if the geometries are equal and the coordinates are in the same order; otherwise it returns f (FALSE).
fr: ST_OrderingEquals compare deux géométries et renvoie t (TRUE) si les géométries sont égales et si les coordonnées sont dans le même ordre ; sinon, il renvoie f (FALSE).

note: Tag: para
en: This function is implemented as per the ArcSDE SQL specification rather than SQL-MM. http://edndoc.esri.com/arcsde/9.1/sql_api/sqlapi3.htm#ST_OrderingEquals
fr: Cette fonction est mise en œuvre conformément à la spécification SQL d'ArcSDE plutôt que SQL-MM. http://edndoc.esri.com/arcsde/9.1/sql_api/sqlapi3.htm#ST_OrderingEquals

note: Tag: refpurpose
en: Tests if two geometries have the same dimension and intersect, but each has at least one point not in the other
fr: Teste si deux géométries ont la même dimension et se croisent, mais si chacune a au moins un point qui n'est pas dans l'autre

note: Tag: para
en: Returns TRUE if geometry A and B "spatially overlap". Two geometries overlap if they have the same dimension, their interiors intersect in that dimension. and each has at least one point inside the other (or equivalently, neither one covers the other). The overlaps relation is symmetric and irreflexive.
fr: Renvoie TRUE si les géométries A et B se "chevauchent spatialement". Deux géométries se chevauchent si elles ont la même dimension, si leurs intérieurs se croisent dans cette dimension et si chacune a au moins un point à l'intérieur de l'autre (ou, de manière équivalente, si aucune des deux ne recouvre l'autre). La relation de chevauchement est symétrique et irréflexive.

note: Tag: para
en: In mathematical terms: <emphasis>ST_Overlaps(A, B) ⇔ ( dim(A) = dim(B) = dim( Int(A) ⋂ Int(B) )) ∧ (A ⋂ B ≠ A) ∧ (A ⋂ B ≠ B) </emphasis>
fr: En termes mathématiques : <emphasis>ST_Overlaps(A, B) ⇔ ( dim(A) = dim(B) = dim( Int(A) ⋂ Int(B) )). ∧ (A ⋂ B ≠ A) ∧ (A ⋂ B ≠ B) </emphasis>

note: Tag: para
en: &index_aware; To avoid index use, use the function <function>_ST_Overlaps</function>.
fr: &index_aware; Pour éviter l'utilisation d'un index, utilisez la fonction <function>_ST_Overlaps</function>.

note: Tag: para
en: <function>ST_Overlaps</function> returns <varname>TRUE</varname> in the following situations:
fr: <function>ST_Overlaps</function> renvoie <varname>TRUE</varname> dans les situations suivantes :

note: Tag: para
en: A Point on a LineString is contained, but since it has lower dimension it does not overlap or cross.
fr: Un point sur une LineString est contenu, mais comme il a une dimension inférieure, il ne se chevauche pas et ne se croise pas.

note: Tag: para
en: A LineString that partly covers a Polygon intersects and crosses, but does not overlap since it has different dimension.
fr: Une chaîne de lignes qui recouvre partiellement un polygone l'intersecte et le traverse, mais ne se chevauche pas car elle a des dimensions différentes.

note: Tag: para
en: Two Polygons that intersect but with neither contained by the other overlap, but do not cross because their intersection has the same dimension.
fr: Deux polygones qui se croisent mais dont aucun n'est contenu par l'autre se chevauchent, mais ne se croisent pas car leur intersection a la même dimension.

note: Tag: refpurpose
en: Tests if two geometries have a topological relationship matching an Intersection Matrix pattern, or computes their Intersection Matrix
fr: Teste si deux géométries ont une relation topologique correspondant à un modèle de matrice d'intersection, ou calcule leur matrice d'intersection

note: Tag: para
en: These functions allow testing and evaluating the spatial (topological) relationship between two geometries, as defined by the <link xlink:href="http://en.wikipedia.org/wiki/DE-9IM">Dimensionally Extended 9-Intersection Model</link> (DE-9IM).
fr: Ces fonctions permettent de tester et d'évaluer la relation spatiale (topologique) entre deux géométries, telle que définie par le <link xlink:href="http://en.wikipedia.org/wiki/DE-9IM">Dimensionally Extended 9-Intersection Model</link> (DE-9IM).

note: Tag: para
en: The DE-9IM is specified as a 9-element matrix indicating the dimension of the intersections between the Interior, Boundary and Exterior of two geometries. It is represented by a 9-character text string using the symbols 'F', '0', '1', '2' (e.g. <code>'FF1FF0102'</code>).
fr: Le DE-9IM est une matrice à 9 éléments indiquant la dimension des intersections entre l'intérieur, la frontière et l'extérieur de deux géométries. Elle est représentée par une chaîne de texte de 9 caractères utilisant les symboles "F", "0", "1", "2" (par exemple, <code>'FF1FF0102'</code>).

note: Tag: para
en: A specific kind of spatial relationship can be tested by matching the intersection matrix to an <emphasis>intersection matrix pattern</emphasis>. Patterns can include the additional symbols 'T' (meaning "intersection is non-empty") and '*' (meaning "any value"). Common spatial relationships are provided by the named functions <xref linkend="ST_Contains"/>, <xref linkend="ST_ContainsProperly"/>, <xref linkend="ST_Covers"/>, <xref linkend="ST_CoveredBy"/>, <xref linkend="ST_Crosses"/>, <xref linkend="ST_Disjoint"/>, <xref linkend="ST_Equals"/>, <xref linkend="ST_Intersects"/>, <xref linkend="ST_Overlaps"/>, <xref linkend="ST_Touches"/>, and <xref linkend="ST_Within"/>. Using an explicit pattern allows testing multiple conditions of intersects, crosses, etc in one step. It also allows testing spatial relationships which do not have a named spatial relationship function. For example, the relationship "Interior-Intersects" has the DE-9IM pattern <code>T********</code>, which is not evaluated by any named predicate.
fr: Un type spécifique de relation spatiale peut être testé en faisant correspondre la matrice d'intersection à un <emphasis>motif de matrice d'intersection</emphasis>. Les motifs peuvent inclure les symboles supplémentaires "T" (signifiant "l'intersection est non vide") et "*" (signifiant "n'importe quelle valeur"). Les relations spatiales communes sont fournies par les fonctions nommées <xref linkend="ST_Contains"/>, <xref linkend="ST_ContainsProperly"/>, <xref linkend="ST_Covers"/>, <xref linkend="ST_CoveredBy"/>, <xref linkend="ST_Crosses"/>, <xref linkend="ST_Disjoint"/>, <xref linkend="ST_Equals"/>, <xref linkend="ST_Intersects"/>, <xref linkend="ST_Overlaps"/>, <xref linkend="ST_Touches"/>, et <xref linkend="ST_Within"/>. L'utilisation d'un modèle explicite permet de tester plusieurs conditions d'intersection, de croisement, etc. en une seule étape. Elle permet également de tester des relations spatiales qui n'ont pas de fonction de relation spatiale nommée. Par exemple, la relation "Interior-Intersects" possède le motif DE-9IM <code>T********</code>, qui n'est évalué par aucun prédicat nommé.

note: Tag: para
en: For more information refer to <xref linkend="eval_spatial_rel"/>.
fr: Pour plus d'informations, voir <xref linkend="eval_spatial_rel"/>.

note: Tag: para
en: <emphasis role="bold">Variant 1:</emphasis> Tests if two geometries are spatially related according to the given <varname>intersectionMatrixPattern</varname>.
fr: <emphasis role="bold">Variante 1:</emphasis> Teste si deux géométries sont spatialement liées selon le <varname>intersectionMatrixPattern</varname> donné.

note: Tag: para
en: Unlike most of the named spatial relationship predicates, this does NOT automatically include an index call. The reason is that some relationships are true for geometries which do NOT intersect (e.g. Disjoint). If you are using a relationship pattern that requires intersection, then include the &amp;&amp; index call.
fr: Contrairement à la plupart des prédicats de relations spatiales nommées, ce prédicat n'inclut PAS automatiquement un appel d'index. La raison en est que certaines relations sont vraies pour des géométries qui ne s'intersectent PAS (par exemple Disjoint). Si vous utilisez un modèle de relation qui nécessite une intersection, incluez l'appel à l'index &amp;&amp;.

note: Tag: para
en: It is better to use a named relationship function if available, since they automatically use a spatial index where one exists. Also, they may implement performance optimizations which are not available with full relate evaluation.
fr: Il est préférable d'utiliser une fonction de relation nommée si elle est disponible, car elle utilise automatiquement un index spatial lorsqu'il existe. En outre, elles peuvent mettre en œuvre des optimisations de performance qui ne sont pas disponibles avec l'évaluation de la relation complète.

note: Tag: para
en: <emphasis role="bold">Variant 2:</emphasis> Returns the DE-9IM matrix string for the spatial relationship between the two input geometries. The matrix string can be tested for matching a DE-9IM pattern using <xref linkend="ST_RelateMatch"/>.
fr: <emphasis role="bold">Variante 2:</emphasis> Renvoie la chaîne matricielle DE-9IM pour la relation spatiale entre les deux géométries d'entrée. La chaîne matricielle peut être testée pour vérifier si elle correspond à un modèle DE-9IM en utilisant <xref linkend="ST_RelateMatch"/>.

note: Tag: para
en: <emphasis role="bold">Variant 3:</emphasis> Like variant 2, but allows specifying a <emphasis role="bold">Boundary Node Rule</emphasis>. A boundary node rule allows finer control over whether the endpoints of MultiLineStrings are considered to lie in the DE-9IM Interior or Boundary. The <varname>boundaryNodeRule</varname> values are:
fr: <emphasis role="bold">Variante 3:</emphasis> Comme la variante 2, mais permet de spécifier une <emphasis role="bold">Boundary Node Rule</emphasis>. Une boundary node rule permet de contrôler plus finement si les extrémités des multilignes sont considérées comme se situant à l'intérieur ou à la limite du DE-9IM. Les valeurs de <varname>boundaryNodeRule</varname> sont les suivantes :

note: Tag: para
en: <code>1</code>: <emphasis role="bold">OGC-Mod2</emphasis> - line endpoints are in the Boundary if they occur an odd number of times. This is the rule defined by the OGC SFS standard, and is the default for <function>ST_Relate</function>.
fr: <code>1</code> : <emphasis role="bold">OGC-Mod2</emphasis> - les extrémités des lignes sont dans la frontière si elles apparaissent un nombre impair de fois. C'est la règle définie par la norme SFS de l'OGC, et c'est la valeur par défaut de la <function>ST_Relate</function>.

note: Tag: para
en: <code>2</code>: <emphasis role="bold">Endpoint</emphasis> - all endpoints are in the Boundary.
fr: <code>2</code> : <emphasis role="bold">Endpoint</emphasis> - tous les points d'extrémité sont dans la frontière.

note: Tag: para
en: <code>3</code>: <emphasis role="bold">MultivalentEndpoint</emphasis> - endpoints are in the Boundary if they occur more than once. In other words, the boundary is all the "attached" or "inner" endpoints (but not the "unattached/outer" ones).
fr: <code>3</code> : <emphasis role="bold">MultivalentEndpoint</emphasis> - les points d'extrémité sont dans la frontière s'ils apparaissent plus d'une fois. En d'autres termes, la frontière est constituée de tous les points d'extrémité "attachés" ou "internes" (mais pas des points d'extrémité "non attachés/externes").

note: Tag: para
en: <code>4</code>: <emphasis role="bold">MonovalentEndpoint</emphasis> - endpoints are in the Boundary if they occur only once. In other words, the boundary is all the "unattached" or "outer" endpoints.
fr: <code>4</code> : <emphasis role="bold">MonovalentEndpoint</emphasis> - les points d'extrémité sont dans la frontière s'ils n'apparaissent qu'une seule fois. En d'autres termes, la frontière est constituée de tous les points d'extrémité "non attachés" ou "extérieurs".

note: Tag: para
en: This function is not in the OGC spec, but is implied. see s2.1.13.2
fr: Cette fonction ne figure pas dans la spécification de l'OGC, mais elle est implicite. voir s2.1.13.2

note: Tag: para
en: Enhanced: 2.0.0 - added support for specifying boundary node rule.
fr: Amélioration : 2.0.0 - ajout de la prise en charge de la spécification de boundary node rule.

note: Tag: para
en: Using the boolean-valued function to test spatial relationships.
fr: Utilisation de la fonction booléenne pour tester les relations spatiales.

note: Tag: para
en: Testing a custom spatial relationship pattern as a query condition, with <code>&amp;&amp;</code> to enable using a spatial index.
fr: Test d'un modèle de relation spatiale personnalisé comme condition de requête, avec <code>&amp;&amp;</code> pour permettre l'utilisation d'un index spatial.

note: Tag: para
en: Computing the intersection matrix for spatial relationships.
fr: Calcul de la matrice d'intersection pour les relations spatiales.

note: Tag: para
en: Using different Boundary Node Rules to compute the spatial relationship between a LineString and a MultiLineString with a duplicate endpoint <code>(3 3)</code>:
fr: Utilisation de différentes Boundary Node Rules pour calculer la relation spatiale entre une LineString et une MultiLineString avec une extrémité dupliquée <code>(3 3)</code> :

note: Tag: para
en: Using the <emphasis role="bold">OGC-Mod2</emphasis> rule (1) the duplicate endpoint is in the <emphasis role="bold">interior</emphasis> of the MultiLineString, so the DE-9IM matrix entry [aB:bI] is <code>0</code> and [aB:bB] is <code>F</code>.
fr: En utilisant la règle <emphasis role="bold">OGC-Mod2</emphasis> (1), l'extrémité dupliquée se trouve dans l' <emphasis role="bold">intérieur</emphasis> de la MultiLineString, de sorte que l'entrée de la matrice DE-9IM [aB:bI] est <code>0</code> et [aB:bB] est <code>F</code>.

note: Tag: para
en: Using the <emphasis role="bold">Endpoint</emphasis> rule (2) the duplicate endpoint is in the <emphasis role="bold">boundary</emphasis> of the MultiLineString, so the DE-9IM matrix entry [aB:bI] is <code>F</code> and [aB:bB] is <code>0</code>.
fr: En utilisant la règle <emphasis role="bold">Endpoint</emphasis> (2), l'extrémité dupliquée se trouve dans la <emphasis role="bold">limite</emphasis> de la MultiLineString, de sorte que l'entrée de la matrice DE-9IM [aB:bI] est <code>F</code> et [aB:bB] est <code>0</code>.

note: Tag: refpurpose
en: Tests if a DE-9IM Intersection Matrix matches an Intersection Matrix pattern
fr: Teste si une matrice d'intersection DE-9IM correspond à un modèle de matrice d'intersection

note: Tag: para
en: Tests if a <link xlink:href="http://en.wikipedia.org/wiki/DE-9IM">Dimensionally Extended 9-Intersection Model</link> (DE-9IM) <varname>intersectionMatrix</varname> value satisfies an <varname>intersectionMatrixPattern</varname>. Intersection matrix values can be computed by <xref linkend="ST_Relate"/>.
fr: Teste si une <link xlink:href="http://en.wikipedia.org/wiki/DE-9IM">Dimensionally Extended 9-Intersection Model</link> (DE-9IM) <varname>intersectionMatrix</varname> satisfait un <varname>intersectionMatrixPattern</varname>. Les valeurs de la matrice d'intersection peuvent être calculées par <xref linkend="ST_Relate"/>.

note: Tag: para
en: Patterns for common spatial relationships matched against intersection matrix values, for a line in various positions relative to a polygon
fr: Modèles de relations spatiales communes mis en correspondance avec les valeurs de la matrice d'intersection, pour une ligne dans différentes positions par rapport à un polygone

note: Tag: refpurpose
en: Tests if two geometries have at least one point in common, but their interiors do not intersect
fr: Teste si deux géométries ont au moins un point en commun, mais que leurs intérieurs ne se croisent pas

note: Tag: para
en: Returns <varname>TRUE</varname> if A and B intersect, but their interiors do not intersect. Equivalently, A and B have at least one point in common, and the common points lie in at least one boundary. For Point/Point inputs the relationship is always <varname>FALSE</varname>, since points do not have a boundary.
fr: Retourne <varname>TRUE</varname> si A et B se croisent, mais que leurs intérieurs ne se croisent pas. De manière équivalente, A et B ont au moins un point en commun, et les points communs se situent dans au moins une frontière. Pour les entrées point/point, la relation est toujours <varname>FALSE</varname>, puisque les points n'ont pas de frontière.

note: Tag: para
en: This relationship holds if the DE-9IM Intersection Matrix for the two geometries matches one of:
fr: Cette relation est valable si la matrice d'intersection DE-9IM pour les deux géométries correspond à l'une d'entre elles :

note: Tag: para
en: &index_aware; To avoid using an index, use <function>_ST_Touches</function> instead.
fr: &index_aware; Pour éviter d'utiliser un index, utilisez plutôt la <function>_ST_Touches</function>.

note: Tag: para
en: The <function>ST_Touches</function> predicate returns <varname>TRUE</varname> in the following examples.
fr: Le prédicat <function>ST_Touches</function> renvoie <varname>TRUE</varname> dans les exemples suivants.

note: Tag: refpurpose
en: Tests if every point of A lies in B, and their interiors have a point in common
fr: Tests si chaque point de A se trouve dans B, et que leurs intérieurs ont un point commun

note: Tag: para
en: Returns TRUE if geometry A is within geometry B. A is within B if and only if all points of A lie inside (i.e. in the interior or boundary of) B (or equivalently, no points of A lie in the exterior of B), and the interiors of A and B have at least one point in common.
fr: Renvoie TRUE si la géométrie A est à l'intérieur de la géométrie B. A est à l'intérieur de B si et seulement si tous les points de A se trouvent à l'intérieur (c'est-à-dire à l'intérieur ou à la limite) de B (ou de manière équivalente, aucun point de A ne se trouve à l'extérieur de B), et si les intérieurs de A et de B ont au moins un point en commun.

note: Tag: para
en: For this function to make sense, the source geometries must both be of the same coordinate projection, having the same SRID.
fr: Pour que cette fonction ait un sens, les géométries sources doivent toutes deux avoir la même projection de coordonnées et le même SRID.

note: Tag: para
en: In mathematical terms: <emphasis>ST_Within(A, B) ⇔ (A ⋂ B = A) ∧ (Int(A) ⋂ Int(B) ≠ ∅) </emphasis>
fr: En termes mathématiques : <emphasis>ST_Within(A, B) ⇔ (A ⋂ B = A) ∧ (Int(A) ⋂ Int(B) ≠ ∅). </emphasis>

note: Tag: para
en: The within relation is reflexive: every geometry is within itself. The relation is antisymmetric: if <code>ST_Within(A,B) = true</code> and <code>ST_Within(B,A) = true</code>, then the two geometries must be topologically equal (<code>ST_Equals(A,B) = true</code>).
fr: La relation within est réflexive : toute géométrie est à l'intérieur d'elle-même. La relation est antisymétrique : si <code>ST_Within(A,B) = true</code> et <code>ST_Within(B,A) = true</code>, alors les deux géométries doivent être topologiquement égales (<code>ST_Equals(A,B) = true</code>).

note: Tag: para
en: ST_Within is the converse of <xref linkend="ST_Contains"/>. So, <code>ST_Within(A,B) = ST_Contains(B,A)</code>.
fr: ST_Within est le contraire de <xref linkend="ST_Contains"/>. Ainsi, <code>ST_Within(A,B) = ST_Contains(B,A)</code>.

note: Tag: para
en: Because the interiors must have a common point, a subtlety of the definition is that lines and points lying fully in the boundary of polygons or lines are <emphasis>not</emphasis> within the geometry. For further details see <link xlink:href="http://lin-ear-th-inking.blogspot.com/2007/06/subtleties-of-ogc-covers-spatial.html">Subtleties of OGC Covers, Contains, Within</link>. The <xref linkend="ST_CoveredBy"/> predicate provides a more inclusive relationship.
fr: Comme les intérieurs doivent avoir un point commun, une subtilité de la définition est que les lignes et les points situés entièrement dans la limite des polygones ou des lignes ne sont <emphasis>pas</emphasis> à l'intérieur de la géométrie. Pour plus de détails, voir <link xlink:href="http://lin-ear-th-inking.blogspot.com/2007/06/subtleties-of-ogc-covers-spatial.html">Subtleties of OGC Covers, Contains, Within</link>. Le prédicat <xref linkend="ST_CoveredBy"/> fournit une relation plus inclusive.

note: Tag: para
en: &index_aware; To avoid index use, use the function <function>_ST_Within</function>.
fr: &index_aware; Pour éviter l'utilisation d'un index, utilisez la fonction <function>_ST_Within</function>.

note: Tag: title
en: Distance Relationships
fr: Relations de distance

note: Tag: refpurpose
en: Tests if two 3D geometries are within a given 3D distance
fr: Teste si deux géométries 3D se trouvent à une distance 3D donnée

note: Tag: para
en: Returns true if the 3D distance between two geometry values is no larger than distance <varname>distance_of_srid</varname>. The distance is specified in units defined by the spatial reference system of the geometries. For this function to make sense the source geometries must be in the same coordinate system (have the same SRID).
fr: Renvoie true si la distance 3D entre deux valeurs géométriques n'est pas supérieure à la distance <varname>distance_of_srid</varname>. La distance est spécifiée en unités définies par le système de référence spatial des géométries. Pour que cette fonction ait un sens, les géométries sources doivent se trouver dans le même système de coordonnées (avoir le même SRID).

note: Tag: refpurpose
en: Tests if two 3D geometries are entirely within a given 3D distance
fr: Teste si deux géométries 3D sont entièrement comprises dans une distance 3D donnée

note: Tag: para
en: Returns true if the 3D geometries are fully within the specified distance of one another. The distance is specified in units defined by the spatial reference system of the geometries. For this function to make sense, the source geometries must both be of the same coordinate projection, having the same SRID.
fr: Renvoie true si les géométries 3D se trouvent à la distance spécifiée l'une de l'autre. La distance est spécifiée en unités définies par le système de référence spatiale des géométries. Pour que cette fonction ait un sens, les géométries sources doivent toutes deux avoir la même projection de coordonnées et le même SRID.

note: Tag: refpurpose
en: Tests if a geometry is entirely inside a distance of another
fr: Teste si une géométrie se trouve entièrement à une distance d'une autre géométrie

note: Tag: para
en: Returns true if <code>g2</code> is entirely within <code>distance</code> of <code>g1</code>. Visually, the condition is true if <code>g2</code> is contained within a <code>distance</code> buffer of <code>g1</code>. The distance is specified in units defined by the spatial reference system of the geometries.
fr: Retourne vrai si <code>g2</code> se trouve entièrement à une distance <code>distance</code> de <code>g1</code>. Visuellement, la condition est vraie si <code>g2</code> est contenu dans un tampon de <code>distance</code> de <code>g1</code>. La distance est spécifiée en unités définies par le système de référence spatial des géométries.

note: Tag: para
en: Changed: 3.5.0 : the logic behind the function now uses a test of containment within a buffer, rather than the ST_MaxDistance algorithm. Results will differ from prior versions, but should be closer to user expectations.
fr: Modifié : 3.5.0 : la logique implémentée utilise désormais un test de confinement dans un tampon, plutôt que l'algorithme ST_MaxDistance. Les résultats seront différents de ceux des versions précédentes, mais devraient être plus proches des attentes de l'utilisateur.

note: Tag: refpurpose
en: Tests if two geometries are within a given distance
fr: Teste si deux géométries se trouvent à une distance donnée

note: Tag: para
en: Returns true if the geometries are within a given distance
fr: Renvoie true si les géométries se trouvent à une distance donnée

note: Tag: para
en: For <type>geometry</type>: The distance is specified in units defined by the spatial reference system of the geometries. For this function to make sense, the source geometries must be in the same coordinate system (have the same SRID).
fr: Pour le type <type>geometry</type> : la distance est spécifiée en unités définies par le système de référence spatiale des géométries. Pour que cette fonction ait un sens, les géométries sources doivent se trouver dans le même système de coordonnées (avoir le même SRID).

note: Tag: para
en: For <type>geography</type>: units are in meters and distance measurement defaults to <varname>use_spheroid = true</varname>. For faster evaluation use <varname>use_spheroid = false</varname> to measure on the sphere.
fr: Pour le type <type>geography</type> : les unités sont en mètres et la mesure de la distance est par défaut <varname>use_spheroid = true</varname>. Pour une évaluation plus rapide, utilisez <varname>use_spheroid = false</varname> pour mesurer sur la sphère.

note: Tag: para
en: Use <xref linkend="ST_3DDWithin"/> for 3D geometries.
fr: Utilisez <xref linkend="ST_3DDWithin"/> pour les géométries 3D.

note: Tag: para
en: This function call includes a bounding box comparison that makes use of any indexes that are available on the geometries.
fr: Cet appel de fonction inclut une comparaison de la boîte de délimitation qui utilise tous les index disponibles sur les géométries.

note: Tag: para
en: Availability: 1.5.0 support for geography was introduced
fr: Disponibilité : la prise en charge du type geography a été introduite dans la version 1.5.0

note: Tag: para
en: Enhanced: 2.1.0 improved speed for geography. See <link xlink:href="http://blog.opengeo.org/2012/07/12/making-geography-faster/">Making Geography faster</link> for details.
fr: Amélioration : la version 2.1.0 a amélioré la vitesse de la géographie. Voir <link xlink:href="http://blog.opengeo.org/2012/07/12/making-geography-faster/">Making Geography faster</link> pour plus de détails.

note: Tag: para
en: Enhanced: 2.1.0 support for curved geometries was introduced.
fr: Amélioration : la prise en charge des géométries courbes a été introduite dans la version 2.1.0.

note: Tag: para
en: Prior to 1.3, <xref linkend="ST_Expand"/> was commonly used in conjunction with &amp;&amp; and ST_Distance to test for distance, and in pre-1.3.4 this function used that logic. From 1.3.4, ST_DWithin uses a faster short-circuit distance function.
fr: Avant la version 1.3, <xref linkend="ST_Expand"/> était couramment utilisé en conjonction avec &amp;&amp; et ST_Distance pour tester la distance, et avant la version 1.3.4, cette fonction utilisait cette logique. À partir de la version 1.3.4, ST_DWithin utilise une fonction de distance de court-circuit plus rapide.

note: Tag: refpurpose
en: Tests if a point geometry is inside a circle defined by a center and radius
fr: Teste si un point géométrique se trouve à l'intérieur d'un cercle défini par un centre et un rayon

note: Tag: para
en: Returns true if the geometry is a point and is inside the circle with center <varname>center_x</varname>,<varname>center_y</varname> and radius <varname>radius</varname>.
fr: Retourne true si la géométrie est un point et se trouve à l'intérieur du cercle de centre <varname>center_x</varname>,<varname>center_y</varname> et de rayon <varname>radius</varname>.

note: Tag: para
en: Does not use spatial indexes. Use <xref linkend="ST_DWithin"/> instead.
fr: N'utilise pas les index spatiaux. Utilisez plutôt <xref linkend="ST_DWithin"/>.

note: Tag: para
en: Availability: 1.2
fr: Disponibilité : 1.2

note: Tag: para
en: Changed: 2.2.0 In prior versions this was called ST_Point_Inside_Circle
fr: Modifié : 2.2.0 Dans les versions précédentes, cette fonction était appelée ST_Point_Inside_Circle

note: Tag: title
en: SFCGAL Functions Reference
fr: Référence des fonctions SFCGAL

note: Tag: para
en: SFCGAL is a C++ wrapper library around CGAL that provides advanced 2D and 3D spatial functions. For robustness, geometry coordinates have an exact rational number representation.
fr: SFCGAL est une bibliothèque C++ autour de CGAL qui fournit des fonctions spatiales avancées en 2D et 3D. Pour des raisons de robustesse, les coordonnées géométriques sont représentées par des nombres rationnels exacts.

note: Tag: para
en: Installation instructions for the library can be found on the SFCGAL home page (<link xlink:href="http://www.sfcgal.org">http://www.sfcgal.org</link>). To enable the functions use <code>create extension postgis_sfcgal</code>.
fr: Les instructions d'installation de la bibliothèque se trouvent sur la page d'accueil de SFCGAL (<link xlink:href="http://www.sfcgal.org">http://www.sfcgal.org</link>). Pour activer les fonctions, utilisez <code>create extension postgis_sfcgal</code>.

note: Tag: title
en: SFCGAL Management Functions
fr: Fonctions de gestion de SFCGAL

note: Tag: para
en: This section lists functions for determining version of SFCGAL and library dependencies you are running.
fr: Cette section énumère les fonctions permettant de déterminer la version de SFCGAL et les dépendances de la bibliothèque que vous utilisez.

note: Tag: refpurpose
en: <refpurpose>Returns the version of SFCGAL in use</refpurpose>
fr: <refpurpose>Retourne la version de SFCGAL utilisée</refpurpose>

note: Tag: para
en: <para>Returns the version of SFCGAL in use</para>
fr: <para>Retourne la version de SFCGAL utilisée</para>

note: Tag: refpurpose
en: <refpurpose>Returns the full version of SFCGAL in use including CGAL and Boost versions</refpurpose>
fr: <refpurpose>Retourne la version complète de SFCGAL en cours d'utilisation, y compris les versions CGAL et Boost</refpurpose>

note: Tag: para
en: <para>Returns the full version of SFCGAL in use including CGAL and Boost versions</para>
fr: <para>Retourne la version complète de SFCGAL utilisée, y compris les versions CGAL et Boost</para>

note: Tag: title
en: SFCGAL Accessors and Setters
fr: Fonctions d'accès et de modifications SFCGAL

note: Tag: para
en: These functions access or set properties of geometries. Geometries primarily supported by these functions are TINS and Polyhedral Surfaces.
fr: Ces fonctions permettent d'accéder aux propriétés des géométries ou de les définir. Les géométries principalement prises en charge par ces fonctions sont les TINS et les surfaces polyédriques.

note: Tag: refpurpose
en: Force LHR orientation
fr: Force l'orientation LHR d'un objet

note: Tag: refpurpose
en: Check if a surface is or not planar
fr: Vérifie si une surface est planaire ou non

note: Tag: refpurpose
en: Test if the geometry is a solid. No validity check is performed.
fr: Teste si la géométrie est un solide. Aucun contrôle de validité n'est effectué.

note: Tag: refpurpose
en: Cast the geometry into a solid. No check is performed. To obtain a valid solid, the input geometry must be a closed Polyhedral Surface or a closed TIN.
fr: Transformer la géométrie dans un solide. Aucune vérification n'est effectuée. Pour obtenir un solide valide, la géométrie d'entrée doit être une surface polyédrique fermée ou un TIN fermé.

note: Tag: refpurpose
en: Determine surface orientation
fr: Détermine l'orientation d'une surface

note: Tag: para
en: The function only applies to polygons. It returns -1 if the polygon is counterclockwise oriented and 1 if the polygon is clockwise oriented.
fr: Cette fonction ne s'applique qu'aux polygones. Elle renvoie -1 si le polygone est orienté dans le sens inverse des aiguilles d'une montre et 1 s'il est orienté dans le sens des aiguilles d'une montre.

note: Tag: refpurpose
en: Calculates the area of a geometry
fr: Calcule la surface d'une géométrie

note: Tag: para
en: Calculates the area of a geometry.
fr: Calcule la surface d'une géométrie.

note: Tag: para
en: Performed by the SFCGAL module
fr: Réalisé par le module SFCGAL

note: Tag: para
en: NOTE: this function returns a double precision value representing the area.
fr: NOTE : cette fonction renvoie une valeur en double précision représentant la surface.

note: Tag: refpurpose
en: Computes area of 3D surface geometries. Will return 0 for solids.
fr: Calcule la surface des géométries de surface 3D. Retourne 0 pour les solides.

note: Tag: para
en: Note: By default a PolyhedralSurface built from WKT is a surface geometry, not solid. It therefore has surface area. Once converted to a solid, no area.
fr: Remarque : par défaut, une PolyhedralSurface construite à partir de WKT est une géométrie de surface, et non un solide. Elle possède donc une surface. Une fois convertie en solide, elle n'a plus de surface.

note: Tag: refpurpose
en: Computes the volume of a 3D solid. If applied to surface (even closed) geometries will return 0.
fr: Calcule le volume d'un solide 3D. S'il est appliqué à des géométries de surface (même fermées), il renvoie 0.

note: Tag: para
en: Availability: 2.2.0: This was documented in 2.1.0 but got accidentally left out in 2.1 release.
fr: Disponibilité : 2.2.0 : Ce point était documenté dans la version 2.1.0 mais a été accidentellement omis dans la version 2.1.

note: Tag: para
en: &sqlmm_compliant; SQL-MM IEC 13249-3: 9.1 (same as ST_3DVolume)
fr: &sqlmm_compliant; SQL-MM IEC 13249-3 : 9.1 (identique à ST_3DVolume)

note: Tag: para
en: When closed surfaces are created with WKT, they are treated as areal rather than solid. To make them solid, you need to use <xref linkend="ST_MakeSolid"/>. Areal geometries have no volume. Here is an example to demonstrate.
fr: Lorsque des surfaces fermées sont créées avec WKT, elles sont traitées comme des surfaces aréolaires plutôt que comme des surfaces solides. Pour les rendre solides, vous devez utiliser <xref linkend="ST_MakeSolid"/>. Les géométries aréolaires n'ont pas de volume. Voici un exemple pour le démontrer.

note: Tag: title
en: SFCGAL Processing and Relationship Functions
fr: Fonctions de traitement et de relation SFCGAL

note: Tag: refpurpose
en: Computes the intersection of two geometries
fr: Calcul l'intersection de deux géométries

note: Tag: para
en: Computes the intersection of two geometries.
fr: Calcule l'intersection de deux géométries.

note: Tag: para
en: NOTE: this function returns a geometry representing the intersection.
fr: NOTE : cette fonction renvoie une géométrie représentant l'intersection.

note: Tag: refpurpose
en: Tests if two 3D geometries intersect
fr: Teste si deux géométries 3D intersectent

note: Tag: para
en: Tests if two 3D geometries intersect. 3D geometries intersect if they have any point in common in the three-dimensional space.
fr: Teste si deux géométries 3D intersectent. Les géométries 3D intersectent si elles ont au moins un point commun dans l'espace tridimensionnel.

note: Tag: refpurpose
en: Computes the geometric difference between two geometries
fr: Calcul la différence géométrique entre deux géométries

note: Tag: para
en: Computes the geometric difference between two geometries. The resulting geometry is a set of points that are present in geomA but not in geomB.
fr: Calcule la différence géométrique entre deux géométries. La géométrie résultante est un ensemble de points présents dans la géométrie A mais pas dans la géométrie B.

note: Tag: para
en: NOTE: this function returns a geometry.
fr: NOTE : cette fonction renvoie une géométrie.

note: Tag: refpurpose
en: Perform 3D difference
fr: Effectuer une différence 3D

note: Tag: para
en: Returns that part of geom1 that is not part of geom2.
fr: Renvoie la partie de geom1 qui ne fait pas partie de geom2.

note: Tag: para
en: 3D images were generated using PostGIS <xref linkend="ST_AsX3D"/> and rendering in HTML using <link xlink:href="http://www.x3dom.org">X3Dom HTML Javascript rendering library</link>.
fr: Les images 3D ont été générées à l'aide de PostGIS <xref linkend="ST_AsX3D"/> et rendues en HTML à l'aide de <link xlink:href="http://www.x3dom.org">X3Dom HTML Javascript rendering library</link>.

note: Tag: para
en: Original 3D geometries overlaid. geom2 is the part that will be removed.
fr: Géométries 3D originales superposées. geom2 est la partie qui sera retirée.

note: Tag: para
en: What's left after removing geom2
fr: Ce qui reste après la suppression de geom2

note: Tag: refpurpose
en: Computes the minimum distance between two geometries
fr: Calcule la distance minimale entre deux géométries

note: Tag: para
en: Computes the minimum distance between two geometries.
fr: Calcule la distance minimale entre deux géométries.

note: Tag: para
en: NOTE: this function returns a double precision value representing the distance.
fr: NOTE : cette fonction renvoie une valeur double précision représentant la distance.

note: Tag: refpurpose
en: Computes the minimum 3D distance between two geometries
fr: Calcule la distance 3D minimale entre deux géométries

note: Tag: para
en: Computes the minimum 3D distance between two geometries.
fr: Calcule la distance 3D minimale entre deux géométries.

note: Tag: para
en: NOTE: this function returns a double precision value representing the 3D distance.
fr: NOTE : cette fonction renvoie une valeur double précision représentant la distance 3D.

note: Tag: refpurpose
en: Computes the 3D convex hull of a geometry.
fr: Calcule l'enveloppe convexe 3D d'une géométrie.

note: Tag: para
en: Original geometry overlaid with 3D convex hull
fr: Géométrie originale superposée à l'enveloppe convexe 3D

note: Tag: refpurpose
en: Perform 3D intersection
fr: Réaliser une intersection 3D

note: Tag: para
en: Return a geometry that is the shared portion between geom1 and geom2.
fr: Renvoie une géométrie qui est la partie partagée entre geom1 et geom2.

note: Tag: para
en: Original 3D geometries overlaid. geom2 is shown semi-transparent
fr: Géométries 3D originales superposées. geom2 est représentée en semi-transparence

note: Tag: para
en: Intersection of geom1 and geom2
fr: Intersection de geom1 et geom2

note: Tag: para
en: 3D linestrings and polygons
fr: Lignes et polygones en 3D

note: Tag: para
en: Cube (closed Polyhedral Surface) and Polygon Z
fr: Cube (surface polyédrique fermée) et polygone Z

note: Tag: para
en: Intersection of 2 solids that result in volumetric intersection is also a solid (ST_Dimension returns 3)
fr: L'intersection de 2 solides qui résulte en une intersection volumétrique est également un solide (ST_Dimension renvoie 3)

note: Tag: refpurpose
en: Computes the union of two geometries
fr: Calcule l'union de deux géométries

note: Tag: para
en: Computes the union of two geometries.
fr: Calcule l'union de deux géométries.

note: Tag: para
en: NOTE: this function returns a geometry representing the union.
fr: NOTE : cette fonction renvoie une géométrie représentant l'union.

note: Tag: refpurpose
en: Perform 3D union.
fr: Effectuer l'union 3D.

note: Tag: para
en: Availability: 3.3.0 aggregate variant was added
fr: Disponibilité : 3.3.0 la variante agrégée a été ajoutée

note: Tag: para
en: <emphasis role="bold">Aggregate variant:</emphasis> returns a geometry that is the 3D union of a rowset of geometries. The ST_3DUnion() function is an "aggregate" function in the terminology of PostgreSQL. That means that it operates on rows of data, in the same way the SUM() and AVG() functions do and like most aggregates, it also ignores NULL geometries.
fr: <emphasis role="bold">Variante agrégée:</emphasis> renvoie une géométrie qui est l'union 3D d'un ensemble de géométries. La fonction ST_3DUnion() est une fonction "agrégée" dans la terminologie de PostgreSQL. Cela signifie qu'elle opère sur des lignes de données, de la même manière que les fonctions SUM() et AVG() et, comme la plupart des agrégats, elle ignore les géométries NULL.

note: Tag: para
en: Original 3D geometries overlaid. geom2 is the one with transparency.
fr: Géométries 3D originales superposées. geom2 est celle qui est transparente.

note: Tag: para
en: Union of geom1 and geom2
fr: Union de geom1 et geom2

note: Tag: refpurpose
en: Computes an Alpha-shape enclosing a geometry
fr: Calcul d'une forme Alpha entourant une géométrie

note: Tag: para
en: Computes the <link xlink:href="https://en.wikipedia.org/wiki/Alpha_shape">Alpha-Shape</link> of the points in a geometry. An alpha-shape is a (usually) concave polygonal geometry which contains all the vertices of the input, and whose vertices are a subset of the input vertices. An alpha-shape provides a closer fit to the shape of the input than the shape produced by the <link linkend="ST_ConvexHull">convex hull</link>.
fr: Calcule la <link xlink:href="https://en.wikipedia.org/wiki/Alpha_shape">forme alpha</link> des points d'une géométrie. Une forme alpha est une géométrie polygonale (généralement) concave qui contient tous les sommets de l'entrée et dont les sommets sont un sous-ensemble des sommets de l'entrée. Une forme alpha permet de se rapprocher davantage de la forme de l'entrée que la forme produite par l' <link linkend="ST_ConvexHull">enveloppe convexe</link>.

note: Tag: para
en: The "closeness of fit" is controlled by the <varname>alpha</varname> parameter, which can have values from 0 to infinity. Smaller alpha values produce more concave results. Alpha values greater than some data-dependent value produce the convex hull of the input.
fr: La "proximité de l'ajustement" est contrôlée par le paramètre <varname>alpha</varname>, qui peut prendre des valeurs comprises entre 0 et l'infini. Des valeurs alpha plus petites produisent des résultats plus concaves. Les valeurs alpha supérieures à une certaine valeur dépendant des données produisent l'enveloppe convexe de l'entrée.

note: Tag: para
en: Following the CGAL implementation, the alpha value is the <emphasis>square</emphasis> of the radius of the disc used in the Alpha-Shape algorithm to "erode" the Delaunay Triangulation of the input points. See <link xlink:href="https://doc.cgal.org/latest/Alpha_shapes_2/index.html#Chapter_2D_Alpha_Shapes">CGAL Alpha-Shapes</link> for more information. This is different from the original definition of alpha-shapes, which defines alpha as the radius of the eroding disc.
fr: Conformément à l'implémentation du CGAL, la valeur alpha est le <emphasis>carré</emphasis> du rayon du disque utilisé dans l'algorithme Alpha-Shape pour "éroder" la triangulation de Delaunay des points d'entrée. Voir <link xlink:href="https://doc.cgal.org/latest/Alpha_shapes_2/index.html#Chapter_2D_Alpha_Shapes">CGAL Alpha-Shapes</link> pour plus d'informations. Cela diffère de la définition originale des formes alpha, qui définit alpha comme le rayon du disque d'érosion.

note: Tag: para
en: The computed shape does not contain holes unless the optional <varname>allow_holes</varname> argument is specified as true.
fr: La forme calculée ne contient pas de trous, sauf si l'argument facultatif <varname>allow_holes</varname> est spécifié comme true.

note: Tag: para
en: This function effectively computes a concave hull of a geometry in a similar way to <xref linkend="ST_ConcaveHull"/>, but uses CGAL and a different algorithm.
fr: Cette fonction calcule effectivement une enveloppe concave d'une géométrie d'une manière similaire à <xref linkend="ST_ConcaveHull"/>, mais utilise CGAL et un algorithme différent.

note: Tag: para
en: Alpha-shape of a MultiPoint, allowing holes (same example as <xref linkend="ST_ConcaveHull"/>)
fr: Forme alpha d'un MultiPoint, autorisant les trous (même exemple que <xref linkend="ST_ConcaveHull"/>)

note: Tag: refpurpose
en: Computes approximal convex partition of the polygon geometry
fr: Calcul de la partition convexe approximative de la géométrie du polygone

note: Tag: para
en: Computes approximal convex partition of the polygon geometry (using a triangulation).
fr: Calcule la partition convexe approximative de la géométrie du polygone (à l'aide d'une triangulation).

note: Tag: para
en: A partition of a polygon P is a set of polygons such that the interiors of the polygons do not intersect and the union of the polygons is equal to the interior of the original polygon P. CG_ApproxConvexPartition and CG_GreeneApproxConvexPartition functions produce approximately optimal convex partitions. Both these functions produce convex decompositions by first decomposing the polygon into simpler polygons; CG_ApproxConvexPartition uses a triangulation and CG_GreeneApproxConvexPartition a monotone partition. These two functions both guarantee that they will produce no more than four times the optimal number of convex pieces but they differ in their runtime complexities. Though the triangulation-based approximation algorithm often results in fewer convex pieces, this is not always the case.
fr: Une partition d'un polygone P est un ensemble de polygones tels que les intérieurs des polygones ne se coupent pas et que l'union des polygones est égale à l'intérieur du polygone original P. Les fonctions CG_ApproxConvexPartition et CG_GreeneApproxConvexPartition produisent des partitions convexes approximativement optimales. Ces deux fonctions produisent des décompositions convexes en décomposant d'abord le polygone en polygones plus simples ; CG_ApproxConvexPartition utilise une triangulation et CG_GreeneApproxConvexPartition une partition monotone. Ces deux fonctions garantissent toutes deux qu'elles ne produiront pas plus de quatre fois le nombre optimal de pièces convexes, mais elles diffèrent par leur complexité d'exécution. Bien que l'algorithme d'approximation basé sur la triangulation produise souvent moins de pièces convexes, ce n'est pas toujours le cas.

note: Tag: para
en: Availability: 3.5.0 - requires SFCGAL &gt;= 1.5.0.
fr: Disponibilité : 3.5.0 - nécessite SFCGAL &gt;= 1.5.0.

note: Tag: para
en: Requires SFCGAL &gt;= 1.5.0
fr: Nécessite SFCGAL &gt;= 1.5.0

note: Tag: para
en: Approximal Convex Partition (same example As <xref linkend="CG_YMonotonePartition"/>, <xref linkend="CG_GreeneApproxConvexPartition"/> and <xref linkend="CG_OptimalConvexPartition"/>)
fr: Partition convexe approximative (même exemple que <xref linkend="CG_YMonotonePartition"/>, <xref linkend="CG_GreeneApproxConvexPartition"/> et <xref linkend="CG_OptimalConvexPartition"/>)

note: Tag: refpurpose
en: Compute the approximate medial axis of an areal geometry.
fr: Calculer l'axe médian approximatif d'une géométrie aréolaire.

note: Tag: para
en: Return an approximate medial axis for the areal input based on its straight skeleton. Uses an SFCGAL specific API when built against a capable version (1.2.0+). Otherwise the function is just a wrapper around CG_StraightSkeleton (slower case).
fr: Retourne un axe médian approximatif pour l'entrée aréolaire en se basant sur son squelette (straight skeleton). Utilise une API spécifique à SFCGAL lorsque compilée avec une version compatible (1.2.0+). Sinon, la fonction est juste un wrapper de CG_StraightSkeleton (cas le plus lent).

note: Tag: para
en: A polygon and its approximate medial axis
fr: Un polygone et son axe médian approximatif

note: Tag: refpurpose
en: Return a constrained Delaunay triangulation around the given input geometry.
fr: Renvoie une triangulation de Delaunay contrainte autour de la géométrie d'entrée donnée.

note: Tag: para
en: Return a <link xlink:href="https://en.wikipedia.org/wiki/Constrained_Delaunay_triangulation">Constrained Delaunay triangulation</link> around the vertices of the input geometry. Output is a TIN.
fr: Renvoie un <link xlink:href="https://en.wikipedia.org/wiki/Constrained_Delaunay_triangulation">Constrained Delaunay triangulation</link> autour des sommets de la géométrie d'entrée. Le résultat est un TIN.

note: Tag: para
en: of 2 polygons. Triangle edges cross polygon boundaries.
fr: de 2 polygones. Les arêtes des triangles traversent les limites des polygones.

note: Tag: refpurpose
en: Extrude a surface to a related volume
fr: Extruder une surface vers un volume

note: Tag: para
en: Original octagon formed from buffering point
fr: Octogone original formé à partir du point tampon

note: Tag: para
en: Hexagon extruded 30 units along Z produces a PolyhedralSurfaceZ
fr: Un hexagone extrudé de 30 unités le long de Z produit une PolyhedralSurfaceZ

note: Tag: para
en: Original linestring
fr: Ligne d'origine

note: Tag: para
en: LineString Extruded along Z produces a PolyhedralSurfaceZ
fr: LineString extrudé le long de Z produit une PolyhedralSurfaceZ

note: Tag: refpurpose
en: Straight Skeleton Extrusion
fr: Extrusion de squelette droit

note: Tag: para
en: Computes an extrusion with a maximal height of the polygon geometry.
fr: Calcule une extrusion avec une hauteur maximale de la géométrie du polygone.

note: Tag: para
en: Computes approximal monotone convex partition of the polygon geometry.
fr: Calcule une partition convexe approximative monotone de la géométrie du polygone.

note: Tag: para
en: Greene Approximal Convex Partition (same example As <xref linkend="CG_YMonotonePartition"/>, <xref linkend="CG_ApproxConvexPartition"/> and <xref linkend="CG_OptimalConvexPartition"/>)
fr: Partition convexe approximative de Greene (même exemple que <xref linkend="CG_YMonotonePartition"/>, <xref linkend="CG_ApproxConvexPartition"/> et <xref linkend="CG_OptimalConvexPartition"/>)

note: Tag: refpurpose
en: Performs Minkowski sum
fr: Effectue la somme de Minkowski

note: Tag: para
en: This function performs a 2D minkowski sum of a point, line or polygon with a polygon.
fr: Cette fonction effectue une somme de minkowski en 2D d'un point, d'une ligne ou d'un polygone avec un polygone.

note: Tag: para
en: A minkowski sum of two geometries A and B is the set of all points that are the sum of any point in A and B. Minkowski sums are often used in motion planning and computer-aided design. More details on <link xlink:href="https://en.wikipedia.org/wiki/Minkowski_addition">Wikipedia Minkowski addition</link>.
fr: Une somme de minkowski de deux géométries A et B est l'ensemble de tous les points qui sont la somme de n'importe quel point de A et B. Les sommes de minkowski sont souvent utilisées dans la planification des mouvements et la conception assistée par ordinateur. Plus de détails sur <link xlink:href="https://en.wikipedia.org/wiki/Minkowski_addition">Wikipedia Addition de Minkowski</link>.

note: Tag: para
en: The first parameter can be any 2D geometry (point, linestring, polygon). If a 3D geometry is passed, it will be converted to 2D by forcing Z to 0, leading to possible cases of invalidity. The second parameter must be a 2D polygon.
fr: Le premier paramètre peut être n'importe quelle géométrie 2D (point, ligne, polygone). Si une géométrie 3D est transmise, elle sera convertie en 2D en forçant Z à 0, ce qui peut entraîner des cas d'invalidité. Le second paramètre doit être un polygone 2D.

note: Tag: para
en: Implementation utilizes <link xlink:href="http://doc.cgal.org/latest/Minkowski_sum_2/">CGAL 2D Minkowskisum</link>.
fr: La mise en œuvre utilise <link xlink:href="http://doc.cgal.org/latest/Minkowski_sum_2/">CGAL 2D Minkowskisum</link>.

note: Tag: para
en: Minkowski Sum of Linestring and circle polygon where Linestring cuts thru the circle
fr: Somme de Minkowski d'une ligne et d'un cercle polygonal où la ligne traverse le cercle

note: Tag: para
en: Before Summing
fr: Avant la somme

note: Tag: para
en: After summing
fr: Après la somme

note: Tag: para
en: Minkowski Sum of a polygon and multipoint
fr: Somme de Minkowski d'un polygone et d'un multipoint

note: Tag: para
en: After summing: polygon is duplicated and translated to position of points
fr: Après la somme : le polygone est dupliqué et traduit en position de points

note: Tag: refpurpose
en: Computes an Alpha-shape enclosing a geometry using an "optimal" alpha value.
fr: Calcule une forme alpha entourant une géométrie en utilisant une valeur alpha "optimale".

note: Tag: para
en: Computes the "optimal" alpha-shape of the points in a geometry. The alpha-shape is computed using a value of α chosen so that:
fr: Calcule la forme alpha "optimale" des points d'une géométrie. La forme alpha est calculée en utilisant une valeur de α choisie de telle sorte que :

note: Tag: para
en: the number of polygon elements is equal to or smaller than <varname>nb_components</varname> (which defaults to 1)
fr: le nombre d'éléments du polygone est égal ou inférieur à <varname>nb_components</varname> (qui vaut 1 par défaut)

note: Tag: para
en: all input points are contained in the shape
fr: tous les points d'entrée sont contenus dans la forme

note: Tag: para
en: The result will not contain holes unless the optional <varname>allow_holes</varname> argument is specified as true.
fr: Le résultat ne contiendra pas de trous à moins que l'argument facultatif <varname>allow_holes</varname> ne soit spécifié comme true.

note: Tag: para
en: Availability: 3.3.0 - requires SFCGAL &gt;= 1.4.1.
fr: Disponibilité : 3.3.0 - nécessite SFCGAL &gt;= 1.4.1.

note: Tag: refpurpose
en: Computes an optimal convex partition of the polygon geometry
fr: Calcul d'une partition convexe optimale de la géométrie du polygone

note: Tag: para
en: Computes an optimal convex partition of the polygon geometry.
fr: Calcul d'une partition convexe optimale de la géométrie du polygone.

note: Tag: para
en: A partition of a polygon P is a set of polygons such that the interiors of the polygons do not intersect and the union of the polygons is equal to the interior of the original polygon P. CG_OptimalConvexPartition produces a partition that is optimal in the number of pieces.
fr: Une partition d'un polygone P est un ensemble de polygones tels que les intérieurs des polygones ne se croisent pas et que l'union des polygones est égale à l'intérieur du polygone original P. CG_OptimalConvexPartition produit une partition optimale en termes de nombre de morceaux.

note: Tag: para
en: Optimal Convex Partition (same example As <xref linkend="CG_YMonotonePartition"/>, <xref linkend="CG_ApproxConvexPartition"/> and <xref linkend="CG_GreeneApproxConvexPartition"/>)
fr: Partition convexe optimale (même exemple que <xref linkend="CG_YMonotonePartition"/>, <xref linkend="CG_ApproxConvexPartition"/> et <xref linkend="CG_GreeneApproxConvexPartition"/>)

note: Tag: refpurpose
en: Compute a straight skeleton from a geometry
fr: Calcule un squelette (straight skeleton) à partir d'une géométrie

note: Tag: para
en: Requires SFCGAL &gt;= 1.3.8 for option use_distance_as_m
fr: Nécessite SFCGAL &gt;= 1.3.8 pour l'option use_distance_as_m

note: Tag: para
en: Straight Skeleton of polygon
fr: Squelette d'un polygone

note: Tag: refpurpose
en: Perform surface Tessellation of a polygon or polyhedralsurface and returns as a TIN or collection of TINS
fr: Effectue la tessellation de la surface d'un polygone ou d'une surface polyédrique et renvoie un TIN ou une collection de TINS

note: Tag: para
en: Takes as input a surface such a MULTI(POLYGON) or POLYHEDRALSURFACE and returns a TIN representation via the process of tessellation using triangles.
fr: Prend en entrée une surface telle que MULTI(POLYGON) ou POLYHEDRALSURFACE et renvoie une représentation TIN via le processus de tessellation à l'aide de triangles.

note: Tag: para
en: does similar to this function except that it returns a geometry collection of polygons instead of a TIN and also only works with 2D geometries.
fr: est similaire à cette fonction, sauf qu'elle renvoie une collection géométrique de polygones au lieu d'un TIN et qu'elle ne fonctionne qu'avec des géométries 2D.

note: Tag: para
en: Original Cube
fr: Cube d'origine

note: Tag: para
en: ST_AsText output:
fr: Sortie ST_AsText :

note: Tag: para
en: Tessellated Cube with triangles colored
fr: Cube tessellé avec triangles colorés

note: Tag: para
en: Tessellated Polygon
fr: Polygone tessellé

note: Tag: refpurpose
en: Triangulates a polygonal geometry
fr: Triangule une géométrie polygonale

note: Tag: para
en: Triangulates a polygonal geometry.
fr: Triangule une géométrie polygonale.

note: Tag: para
en: NOTE: this function returns a geometry representing the triangulated result.
fr: NOTE : cette fonction renvoie une géométrie représentant le résultat de la triangulation.

note: Tag: refpurpose
en: Compute a visibility polygon from a point or a segment in a polygon geometry
fr: Calculer un polygone de visibilité à partir d'un point ou d'un segment dans une géométrie polygonale

note: Tag: para
en: Visibility from the point
fr: Visibilité depuis le point

note: Tag: para
en: Visibility from the segment
fr: Visibilité depuis le segment

note: Tag: refpurpose
en: Computes y-monotone partition of the polygon geometry
fr: Calcul de la partition y-monotone de la géométrie du polygone

note: Tag: para
en: Computes y-monotone partition of the polygon geometry.
fr: Calcul de la partition y-monotone de la géométrie du polygone.

note: Tag: para
en: A partition of a polygon P is a set of polygons such that the interiors of the polygons do not intersect and the union of the polygons is equal to the interior of the original polygon P. A y-monotone polygon is a polygon whose vertices v1,…,vn can be divided into two chains v1,…,vk and vk,…,vn,v1, such that any horizontal line intersects either chain at most once. This algorithm does not guarantee a bound on the number of polygons produced with respect to the optimal number.
fr: Une partition d'un polygone P est un ensemble de polygones tels que les intérieurs des polygones ne se croisent pas et que l'union des polygones est égale à l'intérieur du polygone original P. Un polygone y-monotone est un polygone dont les sommets v1,...,vn peuvent être divisés en deux chaînes v1,...,vk et vk,...,vn,v1, de sorte que toute ligne horizontale croise l'une ou l'autre chaîne au plus une fois. Cet algorithme ne garantit pas de limite au nombre de polygones produits par rapport au nombre optimal.

note: Tag: para
en: Y-Monotone Partition (same example As <xref linkend="CG_ApproxConvexPartition"/>, <xref linkend="CG_GreeneApproxConvexPartition"/> and <xref linkend="CG_OptimalConvexPartition"/>)
fr: Partition Y-Monotone (même exemple que <xref linkend="CG_ApproxConvexPartition"/>, <xref linkend="CG_GreeneApproxConvexPartition"/> et <xref linkend="CG_OptimalConvexPartition"/>)

note: Tag: title
en: Spatial Reference System Functions
fr: Fonctions des systèmes de référence spatiale

note: Tag: para
en: These functions work with the Spatial Reference System of geometries as defined in the <varname>spatial_ref_sys</varname> table.
fr: Ces fonctions fonctionnent avec le système de référence spatiale des géométries défini dans la table <varname>spatial_ref_sys</varname>.

note: Tag: refpurpose
en: Return a new geometry with coordinates transformed to a different spatial reference system using the inverse of a defined coordinate transformation pipeline.
fr: Renvoie une nouvelle géométrie dont les coordonnées ont été transformées dans un système de référence spatial différent en utilisant l'inverse d'un pipeline de transformation de coordonnées défini.

note: Tag: para
en: Return a new geometry with coordinates transformed to a different spatial reference system using a defined coordinate transformation pipeline to go in the inverse direction.
fr: Renvoie une nouvelle géométrie dont les coordonnées ont été transformées dans un système de référence spatial différent à l'aide d'un pipeline de transformation de coordonnées défini pour aller dans la direction inverse.

note: Tag: para
en: Refer to <xref linkend="ST_TransformPipeline"/> for details on writing a transformation pipeline.
fr: Voir <xref linkend="ST_TransformPipeline"/> pour plus de détails sur l'écriture d'un pipeline de transformation.

note: Tag: para
en: The SRID of the input geometry is ignored, and the SRID of the output geometry will be set to zero unless a value is provided via the optional <varname>to_srid</varname> parameter. When using <xref linkend="ST_TransformPipeline"/> the pipeline is executed in a forward direction. Using `ST_InverseTransformPipeline()` the pipeline is executed in the inverse direction.
fr: Le SRID de la géométrie en entrée est ignoré et le SRID de la géométrie de sortie sera mis à zéro à moins qu'une valeur ne soit fournie via le paramètre facultatif <varname>to_srid</varname>. Lors de l'utilisation de <xref linkend="ST_TransformPipeline"/>, le pipeline est exécuté dans le sens direct. En utilisant `ST_InverseTransformPipeline()`, le pipeline est exécuté dans le sens inverse.

note: Tag: para
en: Transforms using pipelines are a specialised version of <xref linkend="ST_Transform"/>. In most cases `ST_Transform` will choose the correct operations to convert between coordinate systems, and should be preferred.
fr: Les transformations utilisant des pipelines sont une version spéciale de <xref linkend="ST_Transform"/>. Dans la plupart des cas, `ST_Transform` choisira les opérations correctes pour convertir entre les systèmes de coordonnées, et devrait être préféré.

note: Tag: para
en: Change WGS 84 long lat to UTM 31N using the EPSG:16031 conversion
fr: Changer WGS 84 long lat en UTM 31N en utilisant la conversion EPSG:16031

note: Tag: para
en: GDA2020 example.
fr: Exemple GDA2020.

note: Tag: refpurpose
en: Set the SRID on a geometry.
fr: Définir le SRID d'une géométrie.

note: Tag: para
en: Sets the SRID on a geometry to a particular integer value. Useful in constructing bounding boxes for queries.
fr: Définit le SRID d'une géométrie à une valeur entière particulière. Utile pour construire des boîtes de délimitation pour les requêtes.

note: Tag: para
en: This function does not transform the geometry coordinates in any way - it simply sets the meta data defining the spatial reference system the geometry is assumed to be in. Use <xref linkend="ST_Transform"/> if you want to transform the geometry into a new projection.
fr: Cette fonction ne transforme en aucune façon les coordonnées de la géométrie - elle définit simplement les métadonnées définissant le système de référence spatiale dans lequel la géométrie est supposée se trouver. Utilisez <xref linkend="ST_Transform"/> si vous souhaitez transformer la géométrie dans une nouvelle projection.

note: Tag: para
en: -- Mark a point as WGS 84 long lat --
fr: -- Marquer un point comme WGS 84 long lat --

note: Tag: para
en: -- Mark a point as WGS 84 long lat and then transform to web mercator (Spherical Mercator) --
fr: -- Marquer un point comme WGS 84 long lat puis le transformer en mercator web (Mercator Sphérique) --

note: Tag: refpurpose
en: Returns the spatial reference identifier for a geometry.
fr: Renvoie l'identifiant de référence spatiale d'une géométrie.

note: Tag: para
en: &sqlmm_compliant; SQL-MM 3: 5.1.5
fr: &sqlmm_compliant; SQL-MM 3 : 5.1.5

note: Tag: refpurpose
en: Return a new geometry with coordinates transformed to a different spatial reference system.
fr: Renvoie une nouvelle géométrie dont les coordonnées ont été transformées dans un système de référence spatial différent.

note: Tag: para
en: Returns a new geometry with its coordinates transformed to a different spatial reference system. The destination spatial reference <varname>to_srid</varname> may be identified by a valid SRID integer parameter (i.e. it must exist in the <varname>spatial_ref_sys</varname> table). Alternatively, a spatial reference defined as a PROJ.4 string can be used for <varname>to_proj</varname> and/or <varname>from_proj</varname>, however these methods are not optimized. If the destination spatial reference system is expressed with a PROJ.4 string instead of an SRID, the SRID of the output geometry will be set to zero. With the exception of functions with <varname>from_proj</varname>, input geometries must have a defined SRID.
fr: Renvoie une nouvelle géométrie dont les coordonnées ont été transformées dans un système de référence spatiale différent. La référence spatiale de destination <varname>to_srid</varname> peut être identifiée par un paramètre entier SRID valide (c'est-à-dire qu'elle doit exister dans la table <varname>spatial_ref_sys</varname>). Il est également possible d'utiliser une référence spatiale définie comme une chaîne PROJ.4 pour <varname>to_proj</varname> et/ou <varname>from_proj</varname>, mais ces méthodes ne sont pas optimisées. Si le système de référence spatiale de destination est exprimé avec une chaîne PROJ.4 au lieu d'un SRID, le SRID de la géométrie de sortie sera mis à zéro. A l'exception des fonctions avec <varname>from_proj</varname>, les géométries d'entrée doivent avoir un SRID défini.

note: Tag: para
en: ST_Transform is often confused with <xref linkend="ST_SetSRID"/>. ST_Transform actually changes the coordinates of a geometry from one spatial reference system to another, while ST_SetSRID() simply changes the SRID identifier of the geometry.
fr: ST_Transform est souvent confondu avec <xref linkend="ST_SetSRID"/>. ST_Transform modifie en fait les coordonnées d'une géométrie d'un système de référence spatiale à un autre, tandis que ST_SetSRID() modifie simplement l'identifiant SRID de la géométrie.

note: Tag: para
en: ST_Transform automatically selects a suitable conversion pipeline given the source and target spatial reference systems. To use a specific conversion method, use <xref linkend="ST_TransformPipeline"/>.
fr: ST_Transform sélectionne automatiquement un pipeline de conversion approprié en fonction des systèmes de référence spatiale source et cible. Pour utiliser une méthode de conversion spécifique, utilisez <xref linkend="ST_TransformPipeline"/>.

note: Tag: para
en: Requires PostGIS be compiled with PROJ support. Use <xref linkend="PostGIS_Full_Version"/> to confirm you have PROJ support compiled in.
fr: PostGIS doit être compilé avec le support PROJ. Utilisez <xref linkend="PostGIS_Full_Version"/> pour confirmer que vous avez compilé le support PROJ.

note: Tag: para
en: If using more than one transformation, it is useful to have a functional index on the commonly used transformations to take advantage of index usage.
fr: Si l'on utilise plus d'une transformation, il est utile de disposer d'un index fonctionnel sur les transformations les plus couramment utilisées afin de tirer parti de l'utilisation de l'index.

note: Tag: para
en: Enhanced: 2.3.0 support for direct PROJ.4 text was introduced.
fr: Amélioration : la version 2.3.0 a introduit la prise en charge du texte PROJ.4 direct.

note: Tag: para
en: Change Massachusetts state plane US feet geometry to WGS 84 long lat
fr: Changer la géométrie des pieds US du plan de l'État du Massachusetts en WGS 84 long lat

note: Tag: para
en: Example of creating a partial functional index. For tables where you are not sure all the geometries will be filled in, its best to use a partial index that leaves out null geometries which will both conserve space and make your index smaller and more efficient.
fr: Exemple de création d'un index fonctionnel partiel. Pour les tables dont vous n'êtes pas sûr que toutes les géométries seront renseignées, il est préférable d'utiliser un index partiel qui laisse de côté les géométries nulles, ce qui permet à la fois de conserver de l'espace et de rendre votre index plus petit et plus efficace.

note: Tag: para
en: Examples of using PROJ.4 text to transform with custom spatial references.
fr: Exemples d'utilisation du texte PROJ.4 pour transformer avec des références spatiales personnalisées.

note: Tag: title
en: Configuring transformation behavior
fr: Configurer le comportement de transformation

note: Tag: para
en: Sometimes coordinate transformation involving a grid-shift can fail, for example if PROJ.4 has not been built with grid-shift files or the coordinate does not lie within the range for which the grid shift is defined. By default, PostGIS will throw an error if a grid shift file is not present, but this behavior can be configured on a per-SRID basis either by testing different <varname>to_proj</varname> values of PROJ.4 text, or altering the <varname>proj4text</varname> value within the <varname>spatial_ref_sys</varname> table.
fr: Parfois, la transformation de coordonnées impliquant un décalage de grille peut échouer, par exemple si PROJ.4 n'a pas été construit avec des fichiers de décalage de grille ou si la coordonnée ne se trouve pas dans la plage pour laquelle le décalage de grille est défini. Par défaut, PostGIS génère une erreur si un fichier de décalage de grille n'est pas présent, mais ce comportement peut être configuré pour chaque SRID, soit en testant différentes valeurs <varname>to_proj</varname> de texte PROJ.4, soit en modifiant la valeur <varname>proj4text</varname> dans la table <varname>spatial_ref_sys</varname>.

note: Tag: para
en: For example, the proj4text parameter +datum=NAD87 is a shorthand form for the following +nadgrids parameter:
fr: Par exemple, le paramètre proj4text +datum=NAD87 est une forme abrégée du paramètre +nadgrids suivant :

note: Tag: para
en: The @ prefix means no error is reported if the files are not present, but if the end of the list is reached with no file having been appropriate (ie. found and overlapping) then an error is issued.
fr: Le préfixe @ signifie qu'aucune erreur n'est signalée si les fichiers ne sont pas présents, mais si la fin de la liste est atteinte sans qu'aucun fichier n'ait été approprié (c'est-à-dire trouvé et se chevauchant), une erreur est émise.

note: Tag: para
en: If, conversely, you wanted to ensure that at least the standard files were present, but that if all files were scanned without a hit a null transformation is applied you could use:
fr: Si, à l'inverse, vous voulez vous assurer qu'au moins les fichiers standard sont présents, mais que si tous les fichiers ont été analysés sans résultat, une transformation nulle est appliquée, vous pouvez utiliser :

note: Tag: para
en: The null grid shift file is a valid grid shift file covering the whole world and applying no shift. So for a complete example, if you wanted to alter PostGIS so that transformations to SRID 4267 that didn't lie within the correct range did not throw an ERROR, you would use the following:
fr: Le fichier de décalage de grille nul est un fichier de décalage de grille valide couvrant le monde entier et n'appliquant aucun décalage. Ainsi, pour un exemple complet, si vous vouliez modifier PostGIS de manière à ce que les transformations du SRID 4267 qui ne se situent pas dans la plage correcte n'entraînent pas d'ERREUR, vous utiliseriez ce qui suit :

note: Tag: refpurpose
en: <refpurpose>Return a new geometry with coordinates transformed to a different spatial reference system using a defined coordinate transformation pipeline.</refpurpose>
fr: <refpurpose>Retourner une nouvelle géométrie avec des coordonnées transformées dans un système de référence spatial différent à l'aide d'un pipeline de transformation de coordonnées défini.</refpurpose>

note: Tag: para
en: <para>Return a new geometry with coordinates transformed to a different spatial reference system using a defined coordinate transformation pipeline.</para>
fr: <para>Retourner une nouvelle géométrie dont les coordonnées ont été transformées dans un système de référence spatial différent à l'aide d'un pipeline de transformation de coordonnées défini.</para>

note: Tag: para
en: Transformation pipelines are defined using any of the following string formats:
fr: Les pipelines de transformation sont définis à l'aide de l'un des formats de texte suivants :

note: Tag: para
en: <varname>urn:ogc:def:coordinateOperation:AUTHORITY::CODE</varname>. Note that a simple <varname>EPSG:CODE</varname> string does not uniquely identify a coordinate operation: the same EPSG code can be used for a CRS definition.
fr: <varname>urn:ogc:def:coordinateOperation:AUTHORITY::CODE</varname>. Notez qu'une simple chaîne de caractère <varname>EPSG:CODE</varname> n'identifie pas de manière unique une opération de coordonnées : le même code EPSG peut être utilisé pour une définition CRS.

note: Tag: para
en: A PROJ pipeline string of the form: <varname>+proj=pipeline ...</varname>. Automatic axis normalisation will not be applied, and if necessary the caller will need to add an additional pipeline step, or remove <varname>axisswap</varname> steps.
fr: Une chaîne de caractères de pipeline PROJ de la forme : <varname>+proj=pipeline ...</varname>. La normalisation automatique des axes ne sera pas appliquée et, si nécessaire, l'appelant devra ajouter une étape de pipeline supplémentaire ou supprimer les étapes <varname>axisswap</varname>.

note: Tag: para
en: Concatenated operations of the form: <varname>urn:ogc:def:coordinateOperation,coordinateOperation:EPSG::3895,coordinateOperation:EPSG::1618</varname>.
fr: Opérations concaténées de la forme : <varname>urn:ogc:def:coordinateOperation,coordinateOperation:EPSG::3895,coordinateOperation:EPSG::1618</varname>.

note: Tag: para
en: The SRID of the input geometry is ignored, and the SRID of the output geometry will be set to zero unless a value is provided via the optional <varname>to_srid</varname> parameter. When using `ST_TransformPipeline()` the pipeline is executed in a forward direction. Using <xref linkend="ST_InverseTransformPipeline"/> the pipeline is executed in the inverse direction.
fr: Le SRID de la géométrie d'entrée est ignoré, et le SRID de la géométrie de sortie sera mis à zéro à moins qu'une valeur ne soit fournie via le paramètre optionnel <varname>to_srid</varname>. Lors de l'utilisation de `ST_TransformPipeline()`, le pipeline est exécuté dans la direction avant. En utilisant <xref linkend="ST_InverseTransformPipeline"/> le pipeline est exécuté dans le sens inverse.

note: Tag: refpurpose
en: Return the list of SRS codes associated with the given authority.
fr: Renvoie la liste des codes SRS associés à l'autorité donnée.

note: Tag: para
en: Returns a set of all <varname>auth_srid</varname> for the given <varname>auth_name</varname>.
fr: Renvoie un ensemble de tous les <varname>auth_srid</varname> pour le <varname>auth_name</varname> donné.

note: Tag: para
en: List the first ten codes associated with the EPSG authority.
fr: Indiquez les dix premiers codes associés à l'autorité EPSG.

note: Tag: refpurpose
en: Return a metadata record for the requested authority and srid.
fr: Renvoyer une fiche de métadonnées pour l'autorité et le srid demandés.

note: Tag: para
en: Returns a metadata record for the requested <varname>auth_srid</varname> for the given <varname>auth_name</varname>. The record will have the <varname>auth_name</varname>, <varname>auth_srid</varname>, <varname>srname</varname>, <varname>srtext</varname>, <varname>proj4text</varname>, and the corners of the area of usage, <varname>point_sw</varname> and <varname>point_ne</varname>.
fr: Renvoie un enregistrement de métadonnées pour le <varname>auth_srid</varname> demandé pour le <varname>auth_name</varname> donné. L'enregistrement contiendra les éléments suivants : <varname>auth_name</varname>, <varname>auth_srid</varname>, <varname>srname</varname>, <varname>srtext</varname>, <varname>proj4text</varname>, et les angles de la zone d'utilisation, <varname>point_sw</varname> et <varname>point_ne</varname>.

note: Tag: para
en: Get the metadata for EPSG:3005.
fr: Obtenir les métadonnées pour EPSG:3005.

note: Tag: refpurpose
en: Return metadata records for every spatial reference system in the underlying Proj database.
fr: Renvoie des enregistrements de métadonnées pour chaque système de référence spatiale dans la base de données Proj sous-jacente.

note: Tag: para
en: Returns a set of all metadata records in the underlying Proj database. The records will have the <varname>auth_name</varname>, <varname>auth_srid</varname>, <varname>srname</varname>, <varname>srtext</varname>, <varname>proj4text</varname>, and the corners of the area of usage, <varname>point_sw</varname> and <varname>point_ne</varname>.
fr: Renvoie un ensemble d'enregistrements de métadonnées dans la base de données Proj sous-jacente. Les enregistrements auront le <varname>auth_name</varname>, <varname>auth_srid</varname>, <varname>srname</varname>, <varname>srtext</varname>, <varname>proj4text</varname>, et les angles de la zone d'utilisation, <varname>point_sw</varname> et <varname>point_ne</varname>.

note: Tag: para
en: Get the first 10 metadata records from the Proj database.
fr: Obtenir les 10 premiers enregistrements de métadonnées de la base de données Proj.

note: Tag: refpurpose
en: Return metadata records for projected coordinate systems that have areas of usage that fully contain the bounds parameter.
fr: Renvoyer les enregistrements de métadonnées pour les systèmes de coordonnées projetées dont les zones d'utilisation contiennent entièrement le paramètre bounds.

note: Tag: para
en: Return a set of metadata records for projected coordinate systems that have areas of usage that fully contain the bounds parameter. Each record will have the <varname>auth_name</varname>, <varname>auth_srid</varname>, <varname>srname</varname>, <varname>srtext</varname>, <varname>proj4text</varname>, and the corners of the area of usage, <varname>point_sw</varname> and <varname>point_ne</varname>.
fr: Renvoie un ensemble d'enregistrements de métadonnées pour les systèmes de coordonnées projetées dont les zones d'utilisation contiennent entièrement le paramètre bounds. Chaque enregistrement contiendra le <varname>auth_name</varname>, <varname>auth_srid</varname>, <varname>srname</varname>, <varname>srtext</varname>, <varname>proj4text</varname>, et les angles de la zone d'utilisation, <varname>point_sw</varname> et <varname>point_ne</varname>.

note: Tag: para
en: The search only looks for projected coordinate systems, and is intended for users to explore the possible systems that work for the extent of their data.
fr: La recherche ne porte que sur les systèmes de coordonnées projetées et vise à permettre aux utilisateurs d'explorer les systèmes possibles en fonction de l'étendue de leurs données.

note: Tag: para
en: Search for projected coordinate systems in Louisiana.
fr: Recherche de systèmes de coordonnées projetées en Louisiane.

note: Tag: para
en: Scan a table for max extent and find projected coordinate systems that might suit.
fr: Examinez une table pour connaître l'étendue maximale et trouvez les systèmes de coordonnées projetées qui pourraient convenir.

note: Tag: title
en: Trajectory Functions
fr: Fonctions de trajectoire

note: Tag: para
en: These functions support working with trajectories. A trajectory is a linear geometry with increasing measures (M value) on each coordinate. Spatio-temporal data can be modeled by using relative times (such as the epoch) as the measure values.
fr: Ces fonctions permettent de travailler avec des trajectoires. Une trajectoire est une géométrie linéaire avec des mesures croissantes (valeur M) sur chaque coordonnée. Les données spatio-temporelles peuvent être modélisées en utilisant des temps relatifs (comme l'époque) comme valeurs de mesure.

note: Tag: refpurpose
en: Tests if the geometry is a valid trajectory.
fr: Teste si la géométrie est une trajectoire valide.

note: Tag: para
en: Tests if a geometry encodes a valid trajectory. A valid trajectory is represented as a <varname>LINESTRING</varname> with measures (M values). The measure values must increase from each vertex to the next.
fr: Teste si une géométrie encode une trajectoire valide. Une trajectoire valide est représentée comme une <varname>LINESTRING</varname> avec des mesures (valeurs M). Les valeurs de mesure doivent augmenter de chaque sommet au suivant.

note: Tag: para
en: Valid trajectories are expected as input to spatio-temporal functions like <xref linkend="ST_ClosestPointOfApproach"/>
fr: Les trajectoires valides sont attendues comme entrées pour des fonctions spatio-temporelles telles que <xref linkend="ST_ClosestPointOfApproach"/>

note: Tag: refpurpose
en: Returns a measure at the closest point of approach of two trajectories.
fr: Renvoie une mesure au point d'approche le plus proche de deux trajectoires.

note: Tag: para
en: Returns the smallest measure at which points interpolated along the given trajectories are the least distance apart.
fr: Renvoie la plus petite mesure pour laquelle les points interpolés le long des trajectoires données sont les moins éloignés les uns des autres.

note: Tag: para
en: Inputs must be valid trajectories as checked by <xref linkend="ST_IsValidTrajectory"/>. Null is returned if the trajectories do not overlap in their M ranges.
fr: Les entrées doivent être des trajectoires valides comme vérifié par <xref linkend="ST_IsValidTrajectory"/>. Null est retourné si les trajectoires ne se chevauchent pas dans leurs plages M.

note: Tag: para
en: To obtain the actual points at the computed measure use <xref linkend="ST_LocateAlong"/> .
fr: Pour obtenir les points réels à la mesure calculée, utilisez <xref linkend="ST_LocateAlong"/> .

note: Tag: refpurpose
en: Returns the distance between the closest point of approach of two trajectories.
fr: Renvoie la distance entre le point d'approche le plus proche de deux trajectoires.

note: Tag: para
en: Returns the distance (in 2D) between two trajectories at their closest point of approach.
fr: Renvoie la distance (en 2D) entre deux trajectoires à leur point d'approche le plus proche.

note: Tag: refpurpose
en: Tests if the closest point of approach of two trajectories is within the specified distance.
fr: Teste si le point d'approche le plus proche de deux trajectoires se trouve dans la distance spécifiée.

note: Tag: para
en: Tests whether two moving objects have ever been closer than the specified distance.
fr: Teste si deux objets en mouvement ont déjà été plus proches que la distance spécifiée.

note: Tag: para
en: Inputs must be valid trajectories as checked by <xref linkend="ST_IsValidTrajectory"/>. False is returned if the trajectories do not overlap in their M ranges.
fr: Les entrées doivent être des trajectoires valides comme vérifié par <xref linkend="ST_IsValidTrajectory"/>. False est retourné si les trajectoires ne se chevauchent pas dans leurs plages M.

note: Tag: title
en: Affine Transformations
fr: Transformations affines

note: Tag: para
en: These functions change the position and shape of geometries using <link xlink:href="https://en.wikipedia.org/wiki/Affine_transformation">affine transformations</link>.
fr: Ces fonctions modifient la position et la forme des géométries à l'aide de <link xlink:href="https://en.wikipedia.org/wiki/Affine_transformation">transformations affines</link>.

note: Tag: refpurpose
en: Apply a 3D affine transformation to a geometry.
fr: Appliquer une transformation affine 3D à une géométrie.

note: Tag: para
en: Applies a 3D affine transformation to the geometry to do things like translate, rotate, scale in one step.
fr: Applique une transformation affine 3D à la géométrie pour effectuer des opérations telles que la translation, la rotation et la mise à l'échelle en une seule étape.

note: Tag: para
en: Version 1: The call <programlisting>ST_Affine(geom, a, b, c, d, e, f, g, h, i, xoff, yoff, zoff) </programlisting> represents the transformation matrix <programlisting>/ a  b  c  xoff \
    | d  e  f  yoff |
    | g  h  i  zoff |
    \ 0  0  0     1 /</programlisting> and the vertices are transformed as follows: <programlisting>x' = a*x + b*y + c*z + xoff
    y' = d*x + e*y + f*z + yoff
    z' = g*x + h*y + i*z + zoff</programlisting> All of the translate / scale functions below are expressed via such an affine transformation.
fr: Version 1: L'appel <programlisting>ST_Affine(geom, a, b, c, d, e, f, g, h, i, xoff, yoff, zoff) </programlisting> représente la matrice de transformation <programlisting>/ a  b  c  xoff \
    | d  e  f  yoff |
    | g  h  i  zoff |
    \ 0  0  0     1 /</programlisting> et les sommets sont transformés comme suit : <programlisting>x' = a*x + b*y + c*z + xoff
    y' = d*x + e*y + f*z + yoff
    z' = g*x + h*y + i*z + zoff</programlisting> Toutes les fonctions de translation / mise à l'échelle ci-dessous sont exprimées par une telle transformation affine.

note: Tag: para
en: Version 2: Applies a 2d affine transformation to the geometry. The call <programlisting>ST_Affine(geom, a, b, d, e, xoff, yoff)</programlisting> represents the transformation matrix <programlisting>/  a  b  0  xoff  \       /  a  b  xoff  \
    |  d  e  0  yoff  | rsp.  |  d  e  yoff  |
    |  0  0  1     0  |       \  0  0     1  /
    \  0  0  0     1  /</programlisting> and the vertices are transformed as follows: <programlisting>x' = a*x + b*y + xoff
    y' = d*x + e*y + yoff
    z' = z </programlisting> This method is a subcase of the 3D method above.
fr: Version 2: Applique une transformation affine 2d à la géométrie. L'appel <programlisting>ST_Affine(geom, a, b, d, e, xoff, yoff)</programlisting> représente la matrice de transformation <programlisting>/  a  b  0  xoff  \       /  a  b  xoff  \
    |  d  e  0  yoff  | rsp.  |  d  e  yoff  |
    |  0  0  1     0  |       \  0  0     1  /
    \  0  0  0     1  /</programlisting> et les sommets sont transformés comme suit : <programlisting>x' = a*x + b*y + xoff
    y' = d*x + e*y + yoff
    z' = z </programlisting> Cette méthode est un sous-cas de la méthode 3D ci-dessus.

note: Tag: para
en: Availability: 1.1.2. Name changed from Affine to ST_Affine in 1.2.2
fr: Disponibilité : 1.1.2. Le nom a été changé de Affine à ST_Affine dans la version 1.2.2

note: Tag: refpurpose
en: Rotates a geometry about an origin point.
fr: Fait pivoter une géométrie autour d'un point d'origine.

note: Tag: para
en: Rotates geometry rotRadians counter-clockwise about the origin point. The rotation origin can be specified either as a POINT geometry, or as x and y coordinates. If the origin is not specified, the geometry is rotated about POINT(0 0).
fr: Fait pivoter la géométrie rotRadians dans le sens inverse des aiguilles d'une montre autour du point d'origine. Le point d'origine de la rotation peut être spécifié sous la forme d'une géométrie POINT, ou sous la forme de coordonnées x et y. Si l'origine n'est pas spécifiée, la géométrie est tournée autour de POINT(0 0).

note: Tag: para
en: Enhanced: 2.0.0 additional parameters for specifying the origin of rotation were added.
fr: Amélioration : 2.0.0 des paramètres supplémentaires ont été ajoutés pour spécifier l'origine de la rotation.

note: Tag: para
en: Availability: 1.1.2. Name changed from Rotate to ST_Rotate in 1.2.2
fr: Disponibilité : 1.1.2. Nom modifié de Rotate en ST_Rotate dans la version 1.2.2

note: Tag: refpurpose
en: Rotates a geometry about the X axis.
fr: Fait pivoter une géométrie autour de l'axe X.

note: Tag: para
en: Rotates a geometry geomA - rotRadians about the X axis.
fr: Fait pivoter une géométrie geomA - rotRadians autour de l'axe X.

note: Tag: para
en: <code>ST_RotateX(geomA, rotRadians)</code> is short-hand for <code>ST_Affine(geomA, 1, 0, 0, 0, cos(rotRadians), -sin(rotRadians), 0, sin(rotRadians), cos(rotRadians), 0, 0, 0)</code>.
fr: <code>ST_RotateX(geomA, rotRadians)</code> est un raccourci pour <code>ST_Affine(geomA, 1, 0, 0, 0, cos(rotRadians), -sin(rotRadians), 0, sin(rotRadians), cos(rotRadians), 0, 0, 0)</code>.

note: Tag: para
en: Availability: 1.1.2. Name changed from RotateX to ST_RotateX in 1.2.2
fr: Disponibilité : 1.1.2. Nom modifié de RotateX en ST_RotateX dans la version 1.2.2

note: Tag: refpurpose
en: Rotates a geometry about the Y axis.
fr: Fait pivoter une géométrie autour de l'axe Y.

note: Tag: para
en: Rotates a geometry geomA - rotRadians about the y axis.
fr: Fait pivoter une géométrie geomA - rotRadians autour de l'axe y.

note: Tag: para
en: <code>ST_RotateY(geomA, rotRadians)</code> is short-hand for <code>ST_Affine(geomA, cos(rotRadians), 0, sin(rotRadians), 0, 1, 0, -sin(rotRadians), 0, cos(rotRadians), 0, 0, 0)</code>.
fr: <code>ST_RotateY(geomA, rotRadians)</code> est un raccourci pour <code>ST_Affine(geomA, cos(rotRadians), 0, sin(rotRadians), 0, 1, 0, -sin(rotRadians), 0, cos(rotRadians), 0, 0, 0)</code>.

note: Tag: para
en: Availability: 1.1.2. Name changed from RotateY to ST_RotateY in 1.2.2
fr: Disponibilité : 1.1.2. Nom modifié de RotateY en ST_RotateY dans la version 1.2.2

note: Tag: refpurpose
en: Rotates a geometry about the Z axis.
fr: Fait pivoter une géométrie autour de l'axe Z.

note: Tag: para
en: Rotates a geometry geomA - rotRadians about the Z axis.
fr: Fait pivoter une géométrie geomA - rotRadians autour de l'axe Z.

note: Tag: para
en: This is a synonym for ST_Rotate
fr: C'est un synonyme de ST_Rotate

note: Tag: para
en: <code>ST_RotateZ(geomA, rotRadians)</code> is short-hand for <code>SELECT ST_Affine(geomA, cos(rotRadians), -sin(rotRadians), 0, sin(rotRadians), cos(rotRadians), 0, 0, 0, 1, 0, 0, 0)</code>.
fr: <code>ST_RotateZ(geomA, rotRadians)</code> est un raccourci <code>SELECT ST_Affine(geomA, cos(rotRadians), -sin(rotRadians), 0, sin(rotRadians), cos(rotRadians), 0, 0, 0, 1, 0, 0, 0)</code>.

note: Tag: para
en: Availability: 1.1.2. Name changed from RotateZ to ST_RotateZ in 1.2.2
fr: Disponibilité : 1.1.2. Nom modifié de RotateZ en ST_RotateZ dans la version 1.2.2

note: Tag: refpurpose
en: Scales a geometry by given factors.
fr: Met à l'échelle une géométrie en fonction de facteurs donnés.

note: Tag: para
en: Scales the geometry to a new size by multiplying the ordinates with the corresponding factor parameters.
fr: Met la géométrie à l'échelle en multipliant les ordonnées par les paramètres factor correspondants.

note: Tag: para
en: The version taking a geometry as the <varname>factor</varname> parameter allows passing a 2d, 3dm, 3dz or 4d point to set scaling factor for all supported dimensions. Missing dimensions in the <varname>factor</varname> point are equivalent to no scaling the corresponding dimension.
fr: La version prenant une géométrie comme paramètre <varname>factor</varname> permet de passer un point 2d, 3dm, 3dz ou 4d pour définir le facteur d'échelle pour toutes les dimensions prises en charge. Les dimensions manquantes dans le point <varname>factor</varname> sont équivalentes à l'absence de mise à l'échelle de la dimension correspondante.

note: Tag: para
en: The three-geometry variant allows a "false origin" for the scaling to be passed in. This allows "scaling in place", for example using the centroid of the geometry as the false origin. Without a false origin, scaling takes place relative to the actual origin, so all coordinates are just multiplied by the scale factor.
fr: La variante à trois géométries permet de transmettre une "fausse origine" pour la mise à l'échelle. Cela permet une "mise à l'échelle sur place", par exemple en utilisant le centroïde de la géométrie comme fausse origine. Sans fausse origine, la mise à l'échelle s'effectue par rapport à l'origine réelle, de sorte que toutes les coordonnées sont simplement multipliées par le facteur d'échelle.

note: Tag: para
en: Availability: 1.1.0.
fr: Disponibilité : 1.1.0.

note: Tag: para
en: Enhanced: 2.2.0 support for scaling all dimension (<varname>factor</varname> parameter) was introduced.
fr: Amélioration : La prise en charge de la mise à l'échelle de toutes les dimensions (paramètre <varname>factor</varname>) a été introduite dans la version 2.2.0.

note: Tag: para
en: Enhanced: 2.5.0 support for scaling relative to a local origin (<varname>origin</varname> parameter) was introduced.
fr: Amélioration : la prise en charge de la mise à l'échelle par rapport à une origine locale (paramètre <varname>origin</varname>) a été introduite dans la version 2.5.0.

note: Tag: refpurpose
en: Translates a geometry by given offsets.
fr: Traduit une géométrie en fonction de décalages donnés.

note: Tag: para
en: Returns a new geometry whose coordinates are translated delta x,delta y,delta z units. Units are based on the units defined in spatial reference (SRID) for this geometry.
fr: Renvoie une nouvelle géométrie dont les coordonnées sont des unités de translation delta x,delta y,delta z. Les unités sont basées sur les unités définies dans la référence spatiale (SRID) pour cette géométrie. Les unités sont basées sur les unités définies dans la référence spatiale (SRID) pour cette géométrie.

note: Tag: para
en: Move a point 1 degree longitude
fr: Déplacer un point de 1 degré de longitude

note: Tag: para
en: Move a linestring 1 degree longitude and 1/2 degree latitude
fr: Déplacer une ligne d'un degré de longitude et d'un demi-degré de latitude

note: Tag: para
en: Move a 3d point
fr: Déplacer un point 3D

note: Tag: para
en: Move a curve and a point
fr: Déplacer une courbe et un point

note: Tag: refpurpose
en: Translates and scales a geometry by given offsets and factors.
fr: Traduit et met à l'échelle une géométrie en fonction des paramètres offset et factor spécifiés.

note: Tag: para
en: Translates the geometry using the deltaX and deltaY args, then scales it using the XFactor, YFactor args, working in 2D only.
fr: Traduit la géométrie à l'aide des paramètres deltaX et deltaY, puis la met à l'échelle à l'aide des paramètres XFactor et YFactor, uniquement en 2D.

note: Tag: para
en: <code>ST_TransScale(geomA, deltaX, deltaY, XFactor, YFactor)</code> is short-hand for <code>ST_Affine(geomA, XFactor, 0, 0, 0, YFactor, 0, 0, 0, 1, deltaX*XFactor, deltaY*YFactor, 0)</code>.
fr: <code>ST_TransScale(geomA, deltaX, deltaY, XFactor, YFactor)</code> est un raccourci pour <code>ST_Affine(geomA, XFactor, 0, 0, 0, YFactor, 0, 0, 0, 1, deltaX*XFactor, deltaY*YFactor, 0)</code>.

note: Tag: title
en: Troubleshooting Functions
fr: Fonctions de dépannage

note: Tag: para
en: These functions are utilities for troubleshooting and repairing geometry data. They are only needed if the geometry data is corrupted in some way, which should never happen under normal circumstances.
fr: Ces fonctions sont des utilitaires de dépannage et de réparation des données géométriques. Elles ne sont nécessaires que si les données géométriques sont corrompues d'une manière ou d'une autre, ce qui ne devrait jamais se produire dans des circonstances normales.

note: Tag: title
en: PostGIS Geometry/Geography/Box Data Types
fr: Types de données PostGIS Geometry/Geography/Box

note: Tag: para
en: This section lists the custom PostgreSQL data types installed by PostGIS to represent spatial data.
fr: Cette section répertorie les types de données PostgreSQL personnalisés installés par PostGIS pour représenter les données spatiales.

note: Tag: para
en: Each data type describes its type casting behavior. A <link xlink:href="https://www.postgresql.org/docs/current/sql-expressions.html#SQL-SYNTAX-TYPE-CASTS">type cast</link> converts values of one data type into another type. PostgreSQL allows defining casting behavior for custom types, along with the functions used to convert type values. Casts can have <emphasis role="bold">automatic</emphasis> behavior, which allows automatic conversion of a function argument to a type supported by the function.
fr: Chaque type de données décrit son comportement de type cast. Un <link xlink:href="https://www.postgresql.org/docs/current/sql-expressions.html#SQL-SYNTAX-TYPE-CASTS">type cast</link> convertit les valeurs d'un type de données en un autre type. PostgreSQL permet de définir le comportement de casting pour les types personnalisés, ainsi que les fonctions utilisées pour convertir les valeurs du type. Les cast peuvent avoir <emphasis role="bold">un comportement automatique</emphasis>, ce qui permet la conversion automatique d'un argument de fonction vers un type supporté par la fonction.

note: Tag: para
en: Some casts have <emphasis role="bold">explicit</emphasis> behavior, which means the cast must be specified using the syntax <varname>CAST(myval As sometype)</varname> or <varname>myval::sometype</varname>. Explicit casting avoids the issue of ambiguous casts, which can occur when using an overloaded function which does not support a given type. For example, a function may accept a box2d or a box3d, but not a geometry. Since geometry has an automatic cast to both box types, this produces an "ambiguous function" error. To prevent the error use an explicit cast to the desired box type.
fr: Certains castings ont un comportement <emphasis role="bold">explicite</emphasis>, ce qui signifie que le cast doit être spécifié en utilisant la syntaxe <varname>CAST(myval As sometype)</varname> ou <varname>myval::sometype</varname>. Le casting explicite évite le problème des casts ambigus, qui peuvent se produire lors de l'utilisation d'une fonction surchargée qui ne supporte pas un type donné. Par exemple, une fonction peut accepter un box2d ou un box3d, mais pas un geometry. Puisque la géométrie a un cast automatique vers les deux types de boîtes, cela produit une erreur de "fonction ambiguë". Pour éviter cette erreur, utilisez un cast explicite vers le type de boîte souhaité.

note: Tag: para
en: All data types can be cast to <varname>text</varname>, so this does not need to be specified explicitly.
fr: Tous les types de données peuvent être transformés en <varname>text</varname>, il n'est donc pas nécessaire de le spécifier explicitement.

note: Tag: refpurpose
en: The type representing a 2-dimensional bounding box.
fr: Le type représentant une boîte de délimitation bidimensionnelle.

note: Tag: para
en: <varname>box2d</varname> is a spatial data type used to represent the two-dimensional bounding box enclosing a geometry or collection of geometries. For example, the <xref linkend="ST_Extent"/> aggregate function returns a <varname>box2d</varname> object.
fr: <varname>box2d</varname> est un type de données spatiales utilisé pour représenter la boîte de délimitation bidimensionnelle entourant une géométrie ou une collection de géométries. Par exemple, la fonction d'agrégation <xref linkend="ST_Extent"/> renvoie un objet <varname>box2d</varname>.

note: Tag: para
en: The representation contains the values <varname>xmin, ymin, xmax, ymax</varname>. These are the minimum and maximum values of the X and Y extents.
fr: La représentation contient les valeurs <varname>xmin, ymin, xmax, ymax</varname>. Ce sont les valeurs minimales et maximales des étendues X et Y.

note: Tag: para
en: <varname>box2d</varname> objects have a text representation which looks like <code>BOX(1 2,5 6)</code>.
fr: Les objets <varname>box2d</varname> ont une représentation textuelle qui ressemble à <code>BOX(1 2,5 6)</code>.

note: Tag: para
en: This table lists the automatic and explicit casts allowed for this data type:
fr: Ce tableau énumère les casts automatiques et explicites autorisés pour ce type de données :

note: Tag: refpurpose
en: The type representing a 3-dimensional bounding box.
fr: Le type représentant une boîte de délimitation tridimensionnelle.

note: Tag: para
en: <varname>box3d</varname> is a PostGIS spatial data type used to represent the three-dimensional bounding box enclosing a geometry or collection of geometries. For example, the <xref linkend="ST_3DExtent"/> aggregate function returns a <varname>box3d</varname> object.
fr: <varname>box3d</varname> est un type de données spatiales PostGIS utilisé pour représenter la boîte de délimitation tridimensionnelle entourant une géométrie ou une collection de géométries. Par exemple, la fonction d'agrégation <xref linkend="ST_3DExtent"/> renvoie un objet <varname>box3d</varname>.

note: Tag: para
en: The representation contains the values <varname>xmin, ymin, zmin, xmax, ymax, zmax</varname>. These are the minimum and maximum values of the X, Y and Z extents.
fr: La représentation contient les valeurs <varname>xmin, ymin, zmin, xmax, ymax, zmax</varname>. Il s'agit des valeurs minimales et maximales des étendues X, Y et Z.

note: Tag: para
en: <varname>box3d</varname> objects have a text representation which looks like <code>BOX3D(1 2 3,5 6 5)</code>.
fr: Les objets <varname>box3d</varname> ont une représentation textuelle qui ressemble à <code>BOX3D(1 2 3,5 6 5)</code>.

note: Tag: refpurpose
en: The type representing spatial features with planar coordinate systems.
fr: Le type représentant les caractéristiques spatiales avec des systèmes de coordonnées planaires.

note: Tag: para
en: <varname>geometry</varname> is a fundamental PostGIS spatial data type used to represent a feature in planar (Euclidean) coordinate systems.
fr: <varname>géométrie</varname> est un type de données spatiales fondamental de PostGIS utilisé pour représenter une caractéristique dans des systèmes de coordonnées planes (euclidiennes).

note: Tag: para
en: All spatial operations on geometry use the units of the Spatial Reference System the geometry is in.
fr: Toutes les opérations spatiales sur la géométrie utilisent les unités du système de référence spatiale dans lequel se trouve la géométrie.

note: Tag: refpurpose
en: A composite type used to describe the parts of complex geometry.
fr: Un type composite utilisé pour décrire les parties d'une géométrie complexe.

note: Tag: para
en: <varname>geometry_dump</varname> is a <link xlink:href="https://www.postgresql.org/docs/current/rowtypes.html">composite data type</link> containing the fields:
fr: <varname>geometry_dump</varname> est un <link xlink:href="https://www.postgresql.org/docs/current/rowtypes.html">type de données composite</link> contenant les champs :

note: Tag: para
en: <varname>geom</varname> - a geometry representing a component of the dumped geometry. The geometry type depends on the originating function.
fr: <varname>geom</varname> - une géométrie représentant un composant de la géométrie explosée. Le type de géométrie dépend de la fonction d'origine.

note: Tag: para
en: <varname>path[]</varname> - an integer array that defines the navigation path within the dumped geometry to the <varname>geom</varname> component. The path array is 1-based (i.e. <varname>path[1]</varname> is the first element.)
fr: <varname>path[]</varname> - un tableau d'entiers qui définit le chemin de navigation dans la géométrie explosée vers le composant <varname>geom</varname>. Le tableau de chemins est basé sur 1 (c'est-à-dire que <varname>path[1]</varname> est le premier élément)

note: Tag: para
en: It is used by the <varname>ST_Dump*</varname> family of functions as an output type to explode a complex geometry into its constituent parts.
fr: Il est utilisé par la famille de fonctions <varname>ST_Dump*</varname> comme type de sortie pour exploser une géométrie complexe en ses parties constitutives.

note: Tag: refpurpose
en: The type representing spatial features with geodetic (ellipsoidal) coordinate systems.
fr: Le type représentant les entités spatiales avec des systèmes de coordonnées géodésiques (ellipsoïdales).

note: Tag: para
en: <varname>geography</varname> is a spatial data type used to represent a feature in geodetic coordinate systems. Geodetic coordinate systems model the earth using an ellipsoid.
fr: <varname>geography</varname> est un type de données spatiales utilisé pour représenter une entité dans les systèmes de coordonnées géodésiques. Les systèmes de coordonnées géodésiques modélisent la terre à l'aide d'un ellipsoïde.

note: Tag: para
en: Spatial operations on the geography type provide more accurate results by taking the ellipsoidal model into account.
fr: Les opérations spatiales sur le type geography fournissent des résultats plus précis en prenant en compte le modèle ellipsoïdal.

note: Tag: entry
en: explicit
fr: explicite

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

note: Tag: para
en: These functions test whether geometries are valid according to the OGC SFS standard. They also provide information about the nature and location of invalidity. There is also a function to create a valid geometry out of an invalid one.
fr: Ces fonctions vérifient si les géométries sont valides selon la norme SFS de l'OGC. Elles fournissent également des informations sur la nature et la localisation de l'invalidité. Il existe également une fonction permettant de créer une géométrie valide à partir d'une géométrie invalide.

note: Tag: refpurpose
en: Tests if a geometry is well-formed in 2D.
fr: Teste si une géométrie est bien formée en 2D.

note: Tag: para
en: Tests if an ST_Geometry value is well-formed and valid in 2D according to the OGC rules. For geometries with 3 and 4 dimensions, the validity is still only tested in 2 dimensions. For geometries that are invalid, a PostgreSQL NOTICE is emitted providing details of why it is not valid.
fr: Teste si une valeur ST_Geometry est bien formée et valide en 2D selon les règles de l'OGC. Pour les géométries à 3 et 4 dimensions, la validité est toujours testée uniquement en 2 dimensions. Pour les géométries qui ne sont pas valides, une NOTICE PostgreSQL est émise fournissant les détails de la raison pour laquelle elle n'est pas valide.

note: Tag: para
en: For the version with the <varname>flags</varname> parameter, supported values are documented in <xref linkend="ST_IsValidDetail"/> This version does not print a NOTICE explaining invalidity.
fr: Pour la version avec le paramètre <varname>flags</varname>, les valeurs prises en charge sont documentées dans <xref linkend="ST_IsValidDetail"/> Cette version n'imprime pas de NOTICE expliquant l'invalidité.

note: Tag: para
en: For more information on the definition of geometry validity, refer to <xref linkend="OGC_Validity"/>
fr: Pour plus d'informations sur la définition de la validité des géométries, reportez-vous à <xref linkend="OGC_Validity"/>

note: Tag: para
en: SQL-MM defines the result of ST_IsValid(NULL) to be 0, while PostGIS returns NULL.
fr: SQL-MM définit le résultat de ST_IsValid(NULL) comme étant 0, alors que PostGIS renvoie NULL.

note: Tag: para
en: The version accepting flags is available starting with 2.0.0.
fr: La version acceptant les flags est disponible à partir de la version 2.0.0.

note: Tag: para
en: &sqlmm_compliant; SQL-MM 3: 5.1.9
fr: &sqlmm_compliant; SQL-MM 3 : 5.1.9

note: Tag: para
en: Neither OGC-SFS nor SQL-MM specifications include a flag argument for ST_IsValid. The flag is a PostGIS extension.
fr: Les spécifications de l'OGC-SFS et de SQL-MM ne comprennent pas d'argument de type flag pour ST_IsValid. L'indicateur est une extension de PostGIS.

note: Tag: refpurpose
en: Returns a <varname>valid_detail</varname> row stating if a geometry is valid or if not a reason and a location.
fr: Renvoie une ligne <varname>valid_detail</varname> indiquant si une géométrie est valide ou sinon une raison et une localisation.

note: Tag: para
en: Returns a <varname>valid_detail</varname> row, containing a boolean (<varname>valid</varname>) stating if a geometry is valid, a varchar (<varname>reason</varname>) stating a reason why it is invalid and a geometry (<varname>location</varname>) pointing out where it is invalid.
fr: Renvoie une ligne <varname>valid_detail</varname>, contenant un booléen (<varname>valid</varname>) indiquant si une géométrie est valide, un varchar (<varname>reason</varname>) indiquant une raison pour laquelle elle est invalide et une géométrie (<varname>location</varname>) indiquant où elle est invalide.

note: Tag: para
en: Useful to improve on the combination of <xref linkend="ST_IsValid"/> and <xref linkend="ST_IsValidReason"/> to generate a detailed report of invalid geometries.
fr: Utile pour améliorer la combinaison de <xref linkend="ST_IsValid"/> et <xref linkend="ST_IsValidReason"/> afin de générer un rapport détaillé des géométries invalides.

note: Tag: para
en: The optional <varname>flags</varname> parameter is a bitfield. It can have the following values:
fr: Le paramètre facultatif <varname>flags</varname> est un champ de type bit. Il peut avoir les valeurs suivantes :

note: Tag: para
en: 0: Use usual OGC SFS validity semantics.
fr: 0 : utiliser la sémantique de validité habituelle de l'OGC SFS.

note: Tag: para
en: 1: Consider certain kinds of self-touching rings (inverted shells and exverted holes) as valid. This is also known as "the ESRI flag", since this is the validity model used by those tools. Note that this is invalid under the OGC model.
fr: 1 : Considérer certains types d'anneaux auto-touchants (coquilles inversées et trous exverts) comme valides. Ceci est également connu sous le nom de "flag ESRI", car c'est le modèle de validité utilisé par ces outils. Notez que cela n'est pas valide selon le modèle OGC.

note: Tag: refpurpose
en: Returns text stating if a geometry is valid, or a reason for invalidity.
fr: Renvoie un texte indiquant si une géométrie est valide, ou la raison de son invalidité.

note: Tag: para
en: Returns text stating if a geometry is valid, or if invalid a reason why.
fr: Renvoie un texte indiquant si une géométrie est valide ou, si elle est invalide, une raison pour laquelle elle l'est.

note: Tag: para
en: Useful in combination with <xref linkend="ST_IsValid"/> to generate a detailed report of invalid geometries and reasons.
fr: Utile en combinaison avec <xref linkend="ST_IsValid"/> pour générer un rapport détaillé des géométries invalides et des raisons.

note: Tag: para
en: Allowed <varname>flags</varname> are documented in <xref linkend="ST_IsValidDetail"/>.
fr: Les <varname>flags</varname> autorisés sont documentés dans <xref linkend="ST_IsValidDetail"/>.

note: Tag: para
en: Availability: 2.0 version taking flags.
fr: Disponibilité : la version 2.0 prend des flags.

note: Tag: refpurpose
en: Attempts to make an invalid geometry valid without losing vertices.
fr: Tente de rendre valide une géométrie invalide sans perdre de sommets.

note: Tag: para
en: The function attempts to create a valid representation of a given invalid geometry without losing any of the input vertices. Valid geometries are returned unchanged.
fr: La fonction tente de créer une représentation valide d'une géométrie invalide donnée sans perdre aucun des sommets d'entrée. Les géométries valides sont retournées inchangées.

note: Tag: para
en: Supported inputs are: POINTS, MULTIPOINTS, LINESTRINGS, MULTILINESTRINGS, POLYGONS, MULTIPOLYGONS and GEOMETRYCOLLECTIONS containing any mix of them.
fr: Les types de données pris en charge sont : POINTS, MULTIPOINTS, LINESTRINGS, MULTILINESTRINGS, POLYGONS, MULTIPOLYGONS et GEOMETRYCOLLECTIONS contenant n'importe quel mélange de ces éléments.

note: Tag: para
en: In case of full or partial dimensional collapses, the output geometry may be a collection of lower-to-equal dimension geometries, or a geometry of lower dimension.
fr: En cas de diminution de dimension (total ou partiel), la géométrie de sortie peut être une collection de géométries de dimension inférieure à égale, ou une géométrie de dimension inférieure.

note: Tag: para
en: Single polygons may become multi-geometries in case of self-intersections.
fr: Les polygones simples peuvent devenir des multigéométries en cas d'auto-intersections.

note: Tag: para
en: The <varname>params</varname> argument can be used to supply an options string to select the method to use for building valid geometry. The options string is in the format "method=linework|structure keepcollapsed=true|false". If no "params" argument is provided, the "linework" algorithm will be used as the default.
fr: L'argument <varname>params</varname> peut être utilisé pour fournir une chaîne d'options permettant de sélectionner la méthode à utiliser pour construire une géométrie valide. La chaîne d'options est au format "method=linework|structure keepcollapsed=true|false". Si aucun argument "params" n'est fourni, l'algorithme "linework" sera utilisé par défaut.

note: Tag: para
en: The "method" key has two values.
fr: La clé "method" a deux valeurs.

note: Tag: para
en: "linework" is the original algorithm, and builds valid geometries by first extracting all lines, noding that linework together, then building a value output from the linework.
fr: Le "linework" est l'algorithme original, et construit des géométries valides en extrayant d'abord toutes les lignes, en codant ce linework ensemble, puis en construisant une sortie de valeur à partir du linework.

note: Tag: para
en: "structure" is an algorithm that distinguishes between interior and exterior rings, building new geometry by unioning exterior rings, and then differencing all interior rings.
fr: La "structure" est un algorithme qui distingue les anneaux intérieurs et extérieurs, construisant une nouvelle géométrie en réunissant les anneaux extérieurs, puis en différenciant tous les anneaux intérieurs.

note: Tag: para
en: The "keepcollapsed" key is only valid for the "structure" algorithm, and takes a value of "true" or "false". When set to "false", geometry components that collapse to a lower dimensionality, for example a one-point linestring would be dropped.
fr: La clé "keepcollapsed" est uniquement valable pour l'algorithme "structure" et prend la valeur "true" ou "false". Lorsqu'elle est définie sur "false", les composants géométriques qui se réduisent à une dimension inférieure, par exemple une ligne à un point, sont abandonnés.

note: Tag: para
en: Enhanced: 2.0.1, speed improvements
fr: Amélioré : 2.0.1, améliorations de la vitesse

note: Tag: para
en: Enhanced: 2.1.0, added support for GEOMETRYCOLLECTION and MULTIPOINT.
fr: Amélioration : 2.1.0, ajout du support pour GEOMETRYCOLLECTION et MULTIPOINT.

note: Tag: para
en: Enhanced: 3.1.0, added removal of Coordinates with NaN values.
fr: Amélioration : 3.1.0, suppression des coordonnées avec des valeurs NaN.

note: Tag: para
en: Enhanced: 3.2.0, added algorithm options, 'linework' and 'structure' which requires GEOS &gt;= 3.10.0.
fr: Amélioration : 3.2.0, ajout d'options d'algorithme, 'linework' et 'structure' qui nécessite GEOS &gt;= 3.10.0.

note: Tag: para
en: before_geom: MULTIPOLYGON of 2 overlapping polygons
fr: before_geom : MULTIPOLYGON de 2 polygones qui se superposent

note: Tag: para
en: after_geom: MULTIPOLYGON of 4 non-overlapping polygons
fr: after_geom : MULTIPOLYGON de 4 polygones qui ne se superposent pas

note: Tag: para
en: after_geom_structure: MULTIPOLYGON of 1 non-overlapping polygon
fr: after_geom_structure : MULTIPOLYGON de 1 polygone qui ne se chevauche pas

note: Tag: para
en: before_geom: MULTIPOLYGON of 6 overlapping polygons
fr: before_geom : MULTIPOLYGON de 6 polygones qui se superposent

note: Tag: para
en: after_geom: MULTIPOLYGON of 14 Non-overlapping polygons
fr: after_geom : MULTIPOLYGON de 14 polygones qui ne se superposent pas

note: Tag: para
en: after_geom_structure: MULTIPOLYGON of 1 Non-overlapping polygon
fr: after_geom_structure : MULTIPOLYGON de 1 polygone qui ne se chevauche pas

note: Tag: title
en: Version Functions
fr: Fonctions de version

note: Tag: para
en: These functions report and upgrade PostGIS versions.
fr: Ces fonctions permettent de signaler et de mettre à jour les versions de PostGIS.

note: Tag: refpurpose
en: Packages and upgrades PostGIS extensions (e.g. postgis_raster, postgis_topology, postgis_sfcgal) to given or latest version.
fr: Packages et mises à jour des extensions PostGIS (par exemple postgis_raster, postgis_topology, postgis_sfcgal) vers la version donnée ou la plus récente.

note: Tag: para
en: Packages and upgrades PostGIS extensions to given or latest version. Only extensions you have installed in the database will be packaged and upgraded if needed. Reports full PostGIS version and build configuration infos after. This is short-hand for doing multiple CREATE EXTENSION .. FROM unpackaged and ALTER EXTENSION .. UPDATE for each PostGIS extension. Currently only tries to upgrade extensions postgis, postgis_raster, postgis_sfcgal, postgis_topology, and postgis_tiger_geocoder.
fr: Packages et mises à jour des extensions PostGIS vers la version donnée ou la plus récente. Seules les extensions que vous avez installées dans la base de données seront packagées et mises à jour si nécessaire. Rapporte la version complète de PostGIS et les informations sur la configuration de la compilation. C'est un raccourci pour faire plusieurs CREATE EXTENSION ... FROM non packagée et ALTER EXTENSION ... UPDATE pour chaque extension PostGIS. Actuellement, il n'essaie de mettre à jour que les extensions postgis, postgis_raster, postgis_sfcgal, postgis_topology, et postgis_tiger_geocoder.

note: Tag: para
en: Changed: 3.4.0 to add target_version argument.
fr: Modifié : 3.4.0 pour ajouter l'argument target_version.

note: Tag: para
en: Changed: 3.3.0 support for upgrades from any PostGIS version. Does not work on all systems.
fr: Modifié : 3.3.0 support pour les mises à jour à partir de n'importe quelle version de PostGIS. Ne fonctionne pas sur tous les systèmes.

note: Tag: para
en: Changed: 3.0.0 to repackage loose extensions and support postgis_raster.
fr: Modifié : 3.0.0 pour repackager les extensions libres et supporter postgis_raster.

note: Tag: refpurpose
en: Reports full PostGIS version and build configuration infos.
fr: Donne des informations complètes sur la version de PostGIS et la configuration du packaging.

note: Tag: para
en: Reports full PostGIS version and build configuration infos. Also informs about synchronization between libraries and scripts suggesting upgrades as needed.
fr: Donne des informations complètes sur la version de PostGIS et la configuration du packaging. Il fournit également des informations sur la synchronisation entre les bibliothèques et les scripts, suggérant des mises à niveau si nécessaire.

note: Tag: para
en: Enhanced: 3.4.0 now includes extra PROJ configurations NETWORK_ENABLED, URL_ENDPOINT and DATABASE_PATH of proj.db location
fr: Amélioration : 3.4.0 inclut désormais les configurations supplémentaires PROJ NETWORK_ENABLED, URL_ENDPOINT et DATABASE_PATH pour l'emplacement proj.db

note: Tag: refpurpose
en: Returns the version number of the GEOS library.
fr: Renvoie le numéro de version de la librairie GEOS.

note: Tag: para
en: Returns the version number of the GEOS library, or <varname>NULL</varname> if GEOS support is not enabled.
fr: Renvoie le numéro de version de la librairie GEOS, ou <varname>NULL</varname> si le support GEOS n'est pas activé.

note: Tag: refpurpose
en: Returns the version number of the GEOS library against which PostGIS was built.
fr: Renvoie le numéro de version de la librairie GEOS avec laquelle PostGIS a été construit.

note: Tag: para
en: Returns the version number of the GEOS library, or against which PostGIS was built.
fr: Renvoie le numéro de version de la librairie GEOS, ou par rapport à laquelle PostGIS a été construit.

note: Tag: refpurpose
en: Returns the version number of the liblwgeom library. This should match the version of PostGIS.
fr: Renvoie le numéro de version de la librairie liblwgeom. Cela devrait correspondre à la version de PostGIS.

note: Tag: para
en: Returns the version number of the liblwgeom library/
fr: Renvoie le numéro de version de la librairie liblwgeom

note: Tag: refpurpose
en: Returns the version number of the libxml2 library.
fr: Renvoie le numéro de version de la librairie libxml2.

note: Tag: para
en: Returns the version number of the LibXML2 library.
fr: Renvoie le numéro de version de la librairie LibXML2.

note: Tag: refpurpose
en: <refpurpose>Returns build date of the PostGIS library.</refpurpose>
fr: <refpurpose>Retourne la date de packaging de l'extension PostGIS.</refpurpose>

note: Tag: para
en: <para>Returns build date of the PostGIS library.</para>
fr: <para>Retourne la date de packaging de l'extension PostGIS.</para>

note: Tag: refpurpose
en: <refpurpose>Returns the version number of the PostGIS library.</refpurpose>
fr: <refpurpose>Retourne le numéro de version de l'extension PostGIS.</refpurpose>

note: Tag: para
en: <para>Returns the version number of the PostGIS library.</para>
fr: <para>Retourne le numéro de version de l'extension PostGIS.</para>

note: Tag: refpurpose
en: Returns the version number of the PROJ4 library.
fr: Renvoie le numéro de version de la librairie PROJ4.

note: Tag: para
en: Returns the version number of the PROJ library and some configuration options of proj.
fr: Retourne le numéro de version de la bibliothèque PROJ et certaines options de configuration de proj.

note: Tag: para
en: Enhanced: 3.4.0 now includes NETWORK_ENABLED, URL_ENDPOINT and DATABASE_PATH of proj.db location
fr: Amélioration : 3.4.0 inclut désormais PROJ NETWORK_ENABLED, URL_ENDPOINT et DATABASE_PATH pour l'emplacement proj.db

note: Tag: refpurpose
en: Returns the version number of the internal Wagyu library.
fr: Renvoie le numéro de version de la librairie interne de Wagyu.

note: Tag: para
en: Returns the version number of the internal Wagyu library, or <varname>NULL</varname> if Wagyu support is not enabled.
fr: Renvoie le numéro de version de la librairie interne Wagyu, ou <varname>NULL</varname> si le support Wagyu n'est pas activé.

note: Tag: refpurpose
en: <refpurpose>Returns build date of the PostGIS scripts.</refpurpose>
fr: <refpurpose>Retourne la date de packaging des scripts PostGIS.</refpurpose>

note: Tag: para
en: <para>Returns build date of the PostGIS scripts.</para>
fr: <para>Retourne la date de packaging des scripts PostGIS.</para>

note: Tag: refpurpose
en: <refpurpose>Returns version of the PostGIS scripts installed in this database.</refpurpose>
fr: <refpurpose>Retourne la version des scripts PostGIS installés dans cette base de données.</refpurpose>

note: Tag: para
en: <para>Returns version of the PostGIS scripts installed in this database.</para>
fr: <para>Retourne la version des scripts PostGIS installés dans cette base de données.</para>

note: Tag: para
en: If the output of this function doesn't match the output of <xref linkend="PostGIS_Scripts_Released"/> you probably missed to properly upgrade an existing database. See the <link linkend="upgrading">Upgrading</link> section for more info.
fr: Si la sortie de cette fonction ne correspond pas à la sortie de <xref linkend="PostGIS_Scripts_Released"/>, vous avez probablement manqué de mettre correctement à niveau une base de données existante. Consultez la section <link linkend="upgrading">Upgrading</link> pour plus d'informations.

note: Tag: para
en: Availability: 0.9.0
fr: Disponibilité : 0.9.0

note: Tag: refpurpose
en: <refpurpose>Returns the version number of the postgis.sql script released with the installed PostGIS lib.</refpurpose>
fr: <refpurpose>Retourne le numéro de version du script postgis.sql publié avec la librairie PostGIS installée.</refpurpose>

note: Tag: para
en: <para>Returns the version number of the postgis.sql script released with the installed PostGIS lib.</para>
fr: <para>Retourne le numéro de version du script postgis.sql publié avec la librairie PostGIS installée.</para>

note: Tag: para
en: Starting with version 1.1.0 this function returns the same value of <xref linkend="PostGIS_Lib_Version"/>. Kept for backward compatibility.
fr: À partir de la version 1.1.0, cette fonction renvoie la même valeur de <xref linkend="PostGIS_Lib_Version"/>. Conservée pour des raisons de rétrocompatibilité.

note: Tag: refpurpose
en: <refpurpose>Returns PostGIS version number and compile-time options.</refpurpose>
fr: <refpurpose>Retourne le numéro de version de PostGIS et les options de compilation.</refpurpose>

note: Tag: para
en: <para>Returns PostGIS version number and compile-time options.</para>
fr: <para>Retourne le numéro de version de PostGIS et les options de compilation.</para>

note: Tag: title
en: Appendix
fr: Annexes

note: Tag: subtitle
en: Release Notes
fr: Notes de version

note: Tag: para
en: Many thanks to our translation teams, in particular:
fr: Un grand merci à nos équipes de traduction, en particulier :

note: Tag: title
en: Breaking Changes
fr: Changements avec rupture

note: Tag: title
en: New features
fr: Nouvelles fonctionnalités

note: Tag: title
en: Enhancements
fr: Améliorations

note: Tag: title
en: Reporting Problems
fr: Rapporter un problème

note: Tag: title
en: Reporting Software Bugs
fr: Rapporter un problème logiciel

note: Tag: para
en: Reporting bugs effectively is a fundamental way to help PostGIS development. The most effective bug report is that enabling PostGIS developers to reproduce it, so it would ideally contain a script triggering it and every information regarding the environment in which it was detected. Good enough info can be extracted running <code>SELECT postgis_full_version()</code> [for PostGIS] and <code>SELECT version()</code> [for postgresql].
fr: Rapporter un problème est effectivement fondamental afin d'aider le développement de PostGIS. Un rapport de bug efficace permet à l'équipe des développeurs de PostGIS de reproduire le problème. Le rapport est donc pertinent s'il contient le script qui le déclenche et toutes les informations à propos de l'environnement dans lequel il a été détecté. De bonnes informations peuvent être obtenus par l’exécution de <code>SELECT postgis_full_version()</code> [pour postgis] et <code>SELECT version()</code> [pour postgresql].

note: Tag: para
en: If you aren't using the latest release, it's worth taking a look at its <link xlink:href="https://git.osgeo.org/gitea/postgis/postgis/raw/branch/master/NEWS">release changelog</link> first, to find out if your bug has already been fixed.
fr: Si vous n'utilisez pas la dernière version, il vaut la peine de jeter un coup d'œil à son <link xlink:href="https://git.osgeo.org/gitea/postgis/postgis/raw/branch/master/NEWS">journal des changements de la version</link> d'abord, pour savoir si votre bug a déjà été corrigé.

note: Tag: para
en: Using the <link xlink:href="http://trac.osgeo.org/postgis/">PostGIS bug tracker</link> will ensure your reports are not discarded, and will keep you informed on its handling process. Before reporting a new bug please query the database to see if it is a known one, and if it is please add any new information you have about it.
fr: L'utilisation du <link xlink:href="http://trac.osgeo.org/postgis/">PostGIS bug tracker</link> permettra de s'assurer que vos rapports ne sont pas rejetés et vous tiendra informé du processus de traitement. Avant de signaler un nouveau bug, veuillez interroger la base de données pour voir s'il s'agit d'un bug connu, et si c'est le cas, veuillez ajouter toute nouvelle information que vous possédez à son sujet.

note: Tag: para
en: You might want to read Simon Tatham's paper about <link xlink:href="http://www.chiark.greenend.org.uk/~sgtatham/bugs.html">How to Report Bugs Effectively</link> before filing a new report.
fr: Vous pouvez lire l'article de Simon Tatham sur <link xlink:href="http://www.chiark.greenend.org.uk/~sgtatham/bugs.html">Comment signaler efficacement les bugs</link> avant de déposer un nouveau rapport.

note: Tag: title
en: Reporting Documentation Issues
fr: Signaler les problèmes de documentation

note: Tag: para
en: The documentation should accurately reflect the features and behavior of the software. If it doesn't, it could be because of a software bug or because the documentation is in error or deficient.
fr: La documentation doit refléter fidèlement les caractéristiques et le comportement du logiciel. Si ce n'est pas le cas, cela peut être dû à un bug du logiciel ou à une erreur ou une lacune dans la documentation.

note: Tag: para
en: Documentation issues can also be reported to the <link xlink:href="http://trac.osgeo.org/postgis">PostGIS bug tracker</link>.
fr: Les problèmes de documentation peuvent également être signalés au <link xlink:href="http://trac.osgeo.org/postgis">PostGIS bug tracker</link>.

note: Tag: para
en: If your revision is trivial, just describe it in a new bug tracker issue, being specific about its location in the documentation.
fr: Si votre révision est triviale, décrivez-la simplement dans une nouvelle question du bug tracker, en précisant son emplacement dans la documentation.

note: Tag: para
en: If your changes are more extensive, a patch is definitely preferred. This is a four step process on Unix (assuming you already have <link xlink:href="https://git-scm.com/">git</link> installed):
fr: Si vos modifications sont plus importantes, il est préférable d'utiliser un correctif. Il s'agit d'un processus en quatre étapes sous Unix (en supposant que vous ayez déjà installé <link xlink:href="https://git-scm.com/">git</link>) :

note: Tag: para
en: Clone the PostGIS' git repository. On Unix, type:
fr: Clonez le dépôt git de PostGIS. Sous Unix, tapez :

note: Tag: para
en: This will be stored in the directory postgis
fr: Cela sera stocké dans le répertoire postgis

note: Tag: para
en: Make your changes to the documentation with your favorite text editor. On Unix, type (for example):
fr: Faites vos changements sur la documentation avec votre éditeur de texte favori. Sur Unix, tapez (pour exemple) :

note: Tag: para
en: Note that the documentation is written in DocBook XML rather than HTML, so if you are not familiar with it please follow the example of the rest of the documentation.
fr: Remarquez que la documentation est écrite avec DocBook XML au lieu de HTML, donc si vous ne vous sentez pas familier avec cela, vous devriez suivre les exemples dans la suite de la documentation.

note: Tag: para
en: Make a patch file containing the differences from the master copy of the documentation. On Unix, type:
fr: Faites un correctif contenant les différences avec une copie de la documentation principale. Sur Unix, tapez :

note: Tag: para
en: Attach the patch to a new issue in bug tracker.
fr: Ajoutez le correctif à un nouveau ticket dans le système de suivi de bogues.

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 <link xlink:href="https://www.ogc.org/standards/sfa"><emphasis>Simple Features Access</emphasis></link> 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 <link xlink:href="https://www.ogc.org/standards/sfa"><emphasis>Simple Features Access</emphasis></link> (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 <link xlink:href="https://portal.ogc.org/files/?artifact_id=25355"><emphasis>Simple Features Access - Part 1: Common architecture v1.2.1</emphasis></link> 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 <link xlink:href="https://portal.ogc.org/files/?artifact_id=25355"><emphasis>Simple Features Access - Part 1: Common architecture v1.2.1</emphasis></link> 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 <link xlink:href="https://en.wikipedia.org/wiki/Triangulated_irregular_network">Triangulated Irregular Network</link>.
fr: Un TIN est une collection de <link linkend="Triangle">Triangle</link>s non superposés, représentant un réseau irrégulier triangulé (<link xlink:href="https://en.wikipedia.org/wiki/Triangulated_irregular_network">Triangulated Irregular Network</link>).

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

note: Tag: para
en: The <link xlink:href="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></link> 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 <link xlink:href="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></link> (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 <link xlink:href="https://portal.ogc.org/files/?artifact_id=25354"><emphasis>Simple feature access - Part 2: SQL option</emphasis></link> (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 <link xlink:href="https://portal.ogc.org/files/?artifact_id=25354"><emphasis>Simple feature access - Part 2: SQL option</emphasis></link> (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 <link xlink:href="https://www.postgresql.org/docs/current/sql-createtable.html">CREATE TABLE</link> 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 <link xlink:href="https://www.postgresql.org/docs/current/sql-createtable.html">CREATE TABLE</link>, 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)) (<link xlink:href="http://gc.kls2.com/cgi-bin/gc?PATH=SEA-LHR">map the route</link>).
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)) (<link xlink:href="http://gc.kls2.com/cgi-bin/gc?PATH=SEA-LHR">voir la route</link>).

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: 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 cannot 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 cela. (<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 <link xlink:href="https://en.wikipedia.org/wiki/Spatial_reference_system">Spatial Reference System</link> (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 <link xlink:href="https://en.wikipedia.org/wiki/Spatial_reference_system">système de référence spatiale</link> (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 <link xlink:href="http://www.epsg.org/">EPSG database</link>. 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 <link xlink:href="http://www.epsg.org/">EPSG database</link>. 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 <link xlink:href="http://en.wikipedia.org/wiki/SRID">Spatial Reference System</link> (SRS) within the database.
fr: Un code entier qui identifie de manière unique le <link xlink:href="http://en.wikipedia.org/wiki/SRID">Système de référence spatiale</link> (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 <link xlink:href="http://docs.opengeospatial.org/is/12-063r5/12-063r5.html">Well-known text representation of coordinate reference systems</link>.
fr: Pour une discussion sur le SRS WKT, voir la norme OGC <link xlink:href="http://docs.opengeospatial.org/is/12-063r5/12-063r5.html">Well-known text representation of coordinate reference systems</link>.

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 <link xlink:href="https://proj.org/">PROJ web site</link>. 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 <link xlink:href="https://proj.org/">site web de PROJ</link>. 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 <link xlink:href="https://proj.org">PROJ</link> 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 <link xlink:href="https://proj.org">PROJ</link>. 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 <link xlink:href="http://spatialreference.org/">http://spatialreference.org/</link>
fr: Une ressource permettant de trouver des systèmes de référence spatiale non définis dans le jeu de base est <link xlink:href="http://spatialreference.org/">http://spatialreference.org/</link>

note: Tag: para
en: Some commonly used spatial reference systems are: <link xlink:href="http://spatialreference.org/ref/epsg/4326/">4326 - WGS 84 Long Lat</link>, <link xlink:href="http://spatialreference.org/ref/epsg/4269/">4269 - NAD 83 Long Lat</link>, <link xlink:href="http://spatialreference.org/ref/epsg/3395/">3395 - WGS 84 World Mercator</link>, <link xlink:href="http://spatialreference.org/ref/epsg/2163/">2163 - US National Atlas Equal Area</link>, 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 <link xlink:href="http://trac.osgeo.org/postgis/wiki/UsersWikiplpgsqlfunctionsDistance">utmzone PostGIS plpgsql helper function</link>.)
fr: Les systèmes de référence spatiale les plus couramment utilisés sont les suivants : <link xlink:href="http://spatialreference.org/ref/epsg/4326/">4326 - WGS 84 Long Lat</link>, <link xlink:href="http://spatialreference.org/ref/epsg/4269/">4269 - NAD 83 Long Lat</link>, <link xlink:href="http://spatialreference.org/ref/epsg/3395/">3395 - WGS 84 World Mercator</link>, <link xlink:href="http://spatialreference.org/ref/epsg/2163/">2163 - US National Atlas Equal Area</link>, 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 <link xlink:href="http://trac.osgeo.org/postgis/wiki/UsersWikiplpgsqlfunctionsDistance">utmzone PostGIS plpgsql helper function</link>.)

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 <link xlink:href="http://spatialreference.org">spatialreference.org</link>.
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 <link xlink:href="http://spatialreference.org">spatialreference.org</link>.

note: Tag: para
en: You can even define non-Earth-based coordinate systems, such as <link xlink:href="http://spatialreference.org/ref/iau2000/mars-2000/">Mars 2000</link> 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 <link xlink:href="http://spatialreference.org/ref/iau2000/mars-2000/">Mars 2000</link> 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 <link xlink:href="https://www.postgresql.org/docs/current/sql-createtable.html">CREATE TABLE</link> 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 <link xlink:href="https://www.postgresql.org/docs/current/sql-createtable.html">CREATE TABLE</link> 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 <link xlink:href="https://www.postgresql.org/docs/current/sql-altertable.html">ALTER TABLE</link> 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 <link xlink:href="https://www.postgresql.org/docs/current/sql-altertable.html">ALTER TABLE</link>. 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 <link xlink:href="https://postgis.net/workshops/postgis-intro/indexing.html">PostGIS Workshop section on spatial indexes</link>, and the <link xlink:href="https://www.postgresql.org/docs/current/indexes.html">PostgreSQL manual</link>.
fr: Voir également <link xlink:href="https://postgis.net/workshops/postgis-intro/indexing.html">la section de l'atelier PostGIS sur les index spatiaux</link> et le <link xlink:href="https://www.postgresql.org/docs/current/indexes.html">manuel de PostgreSQL</link>.

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 <link xlink:href="https://www.postgresql.org/docs/current/gist.html">PostgreSQL manual</link>.
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 <link xlink:href="https://www.postgresql.org/docs/current/gist.html">manuel PostgreSQL</link>.

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 <link xlink:href="https://www.postgresql.org/docs/current/brin.html">PostgreSQL manual</link>.
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 <link xlink:href="https://www.postgresql.org/docs/current/brin.html">Manuel de PostgreSQL</link>.

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 <link xlink:href="https://www.postgresql.org/docs/current/brin-intro.html#BRIN-OPERATION">manual</link>.
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 <link xlink:href="https://www.postgresql.org/docs/current/brin-intro.html#BRIN-OPERATION">manuel</link>.

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 <link xlink:href="https://www.postgresql.org/docs/current/spgist.html">PostgreSQL manual</link>.
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 <link xlink:href="https://www.postgresql.org/docs/current/spgist.html">manuel PostgreSQL</link>.

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 <link xlink:href="https://www.postgresql.org/docs/current/runtime-config-query.html">Query Planning</link>.
fr: Pour plus d'informations, voir la section du manuel Postgres sur <link xlink:href="https://www.postgresql.org/docs/current/runtime-config-query.html">Query Planning</link>.

note: Tag: title
en: Spatial Queries
fr: Requêtes spatiales

note: Tag: para
en: The <emphasis>raison d'etre</emphasis> of spatial databases is to perform queries inside the database which would ordinarily require desktop GIS functionality. Using PostGIS effectively requires knowing what spatial functions are available, how to use them in queries, and ensuring that appropriate indexes are in place to provide good performance.
fr: La <emphasis>raison d'être</emphasis> des bases de données spatiales est de réaliser à l'intérieur de la base de données des requêtes qui normalement nécessiteraient des fonctionnalités d'un SIG Desktop. Utiliser PostGIS requiert en effet la connaissance de quelles fonctions spatiales sont disponibles, comment les utiliser dans une requête, et de s'assurer de la mise en place adéquate des index, pour une bonne performance.

note: Tag: title
en: Determining Spatial Relationships
fr: Déterminer les relations spatiales

note: Tag: para
en: Spatial relationships indicate how two geometries interact with one another. They are a fundamental capability for querying geometry.
fr: Les relations spatiales indiquent comment deux géométries interagissent l'une avec l'autre. Elles constituent une fonctionnalité fondamentale pour effectuer des requêtes sur des géométries.

note: Tag: title
en: Dimensionally Extended 9-Intersection Model
fr: Modèle à 9 intersections dimensionnellement étendu

note: Tag: para
en: According to the <link xlink:href="http://www.opengeospatial.org/standards/sfs">OpenGIS Simple Features Implementation Specification for SQL</link>, "the basic approach to comparing two geometries is to make pair-wise tests of the intersections between the Interiors, Boundaries and Exteriors of the two geometries and to classify the relationship between the two geometries based on the entries in the resulting 'intersection' matrix."
fr: Selon le <link xlink:href="http://www.opengeospatial.org/standards/sfs">OpenGIS Simple Features Implementation Specification for SQL</link>, "l'approche de base pour comparer deux géométries consiste à effectuer des tests par paire des intersections entre les intérieurs, les limites et les extérieurs des deux géométries et à classer la relation entre les deux géométries sur la base des entrées de la matrice "intersection" résultante."

note: Tag: para
en: In the theory of point-set topology, the points in a geometry embedded in 2-dimensional space are categorized into three sets:
fr: Dans la théorie de la topologie des ensembles de points, les points d'une géométrie intégrée dans un espace à deux dimensions sont classés en trois ensembles :

note: Tag: glossterm
en: <glossterm>Boundary</glossterm>
fr: <glossterm>Limites</glossterm>

note: Tag: para
en: The boundary of a geometry is the set of geometries of the next lower dimension. For <varname>POINT</varname>s, which have a dimension of 0, the boundary is the empty set. The boundary of a <varname>LINESTRING</varname> is the two endpoints. For <varname>POLYGON</varname>s, the boundary is the linework of the exterior and interior rings.
fr: La limite d'une géométrie est l'ensemble des géométries de la dimension immédiatement inférieure. Pour les <varname>POINT</varname>, qui ont une dimension de 0, la limite est l'ensemble vide. La limite d'une <varname>LINESTRING</varname> est constituée par ses deux extrémités. Pour les <varname>POLYGON</varname>, la limite est le réseau de lignes des anneaux extérieur et intérieur.

note: Tag: glossterm
en: <glossterm>Interior</glossterm>
fr: <glossterm>Intérieur</glossterm>

note: Tag: para
en: The interior of a geometry are those points of a geometry that are not in the boundary. For <varname>POINT</varname>s, the interior is the point itself. The interior of a <varname>LINESTRING</varname> is the set of points between the endpoints. For <varname>POLYGON</varname>s, the interior is the areal surface inside the polygon.
fr: L'intérieur d'une géométrie est constitué des points de la géométrie qui ne se trouvent pas dans la limite. Pour les <varname>POINT</varname>, l'intérieur est le point lui-même. L'intérieur d'une <varname>LINESTRING</varname> est l'ensemble des points situés entre les extrémités. Pour les <varname>POLYGON</varname>, l'intérieur est la surface aréale à l'intérieur du polygone.

note: Tag: glossterm
en: <glossterm>Exterior</glossterm>
fr: <glossterm>Extérieur</glossterm>

note: Tag: para
en: The exterior of a geometry is the rest of the space in which the geometry is embedded; in other words, all points not in the interior or on the boundary of the geometry. It is a 2-dimensional non-closed surface.
fr: L'extérieur d'une géométrie est le reste de l'espace dans lequel la géométrie est intégrée ; en d'autres termes, tous les points qui ne se trouvent pas à l'intérieur ou sur la limite de la géométrie. Il s'agit d'une surface non fermée à 2 dimensions.

note: Tag: para
en: The <link xlink:href="http://en.wikipedia.org/wiki/DE-9IM">Dimensionally Extended 9-Intersection Model</link> (DE-9IM) describes the spatial relationship between two geometries by specifying the dimensions of the 9 intersections between the above sets for each geometry. The intersection dimensions can be formally represented in a 3x3 <emphasis role="bold">intersection matrix</emphasis>.
fr: Le <link xlink:href="http://en.wikipedia.org/wiki/DE-9IM">Dimensionally Extended 9-Intersection Model</link> (DE-9IM) décrit la relation spatiale entre deux géométries en spécifiant les dimensions des 9 intersections entre les ensembles ci-dessus pour chaque géométrie. Les dimensions des intersections peuvent être représentées formellement dans une <emphasis role="bold">matrice d'intersections</emphasis> de 3x3.

note: Tag: para
en: For a geometry <emphasis>g</emphasis> the <emphasis>Interior</emphasis>, <emphasis>Boundary</emphasis>, and <emphasis>Exterior</emphasis> are denoted using the notation <emphasis>I(g)</emphasis>, <emphasis>B(g)</emphasis>, and <emphasis>E(g)</emphasis>. Also, <emphasis>dim(s)</emphasis> denotes the dimension of a set <emphasis>s</emphasis> with the domain of <literal>{0,1,2,F}</literal>:
fr: Pour une géométrie <emphasis>g</emphasis>, les <emphasis>Limites</emphasis>, <emphasis>Intérieures</emphasis>, et <emphasis>Extérieures</emphasis> sont désignés par la notation <emphasis>I(g)</emphasis>, <emphasis>B(g)</emphasis>, et <emphasis>E(g)</emphasis>. En outre, <emphasis>dim(s)</emphasis> désigne la dimension d'un ensemble <emphasis>s</emphasis> dont le domaine est <literal>{0,1,2,F}</literal> :

note: Tag: para
en: <literal>1</literal> =&gt; line
fr: <literal>1</literal> =&gt; ligne

note: Tag: para
en: <literal>F</literal> =&gt; empty set
fr: <literal>F</literal> =&gt; ensemble vide

note: Tag: para
en: Using this notation, the intersection matrix for two geometries <emphasis>a</emphasis> and <emphasis>b</emphasis> is:
fr: En utilisant cette notation, la matrice d'intersection pour deux géométries <emphasis>a</emphasis> et <emphasis>b</emphasis> est :

note: Tag: emphasis
en: <emphasis role="bold">Interior</emphasis>
fr: <emphasis role="bold">Intérieur</emphasis>

note: Tag: emphasis
en: <emphasis role="bold">Boundary</emphasis>
fr: <emphasis role="bold">Limite</emphasis>

note: Tag: emphasis
en: <emphasis role="bold">Exterior</emphasis>
fr: <emphasis role="bold">Extérieur</emphasis>

note: Tag: para
en: Visually, for two overlapping polygonal geometries, this looks like:
fr: Visuellement, pour deux géométries polygonales qui se chevauchent, cela ressemble à ce qui suit :

note: Tag: para
en: Reading from left to right and top to bottom, the intersection matrix is represented as the text string '<emphasis role="bold">212101212</emphasis>'.
fr: En lisant de gauche à droite et de haut en bas, la matrice d'intersection est représentée par la chaîne de texte "<emphasis role="bold">212101212</emphasis>".

note: Tag: para
en: For more information, refer to:
fr: Pour plus d'informations, voir :

note: Tag: link
en: Wikipedia: Dimensionally Extended Nine-Intersection Model (DE-9IM)
fr: Wikipedia : Dimensionally Extended Nine-Intersection Model (DE-9IM)

note: Tag: link
en: GeoTools: Point Set Theory and the DE-9IM Matrix
fr: GeoTools : Théorie des ensembles de points et matrice DE-9IM

note: Tag: title
en: Named Spatial Relationships
fr: Relations spatiales nommées

note: Tag: para
en: To make it easy to determine common spatial relationships, the OGC SFS defines a set of <emphasis>named spatial relationship predicates</emphasis>. PostGIS provides these as the functions <xref linkend="ST_Contains"/>, <xref linkend="ST_Crosses"/>, <xref linkend="ST_Disjoint"/>, <xref linkend="ST_Equals"/>, <xref linkend="ST_Intersects"/>, <xref linkend="ST_Overlaps"/>, <xref linkend="ST_Touches"/>, <xref linkend="ST_Within"/>. It also defines the non-standard relationship predicates <xref linkend="ST_Covers"/>, <xref linkend="ST_CoveredBy"/>, and <xref linkend="ST_ContainsProperly"/>.
fr: Pour faciliter la détermination des relations spatiales communes, l'OGC SFS définit un ensemble de <emphasis>prédicats de relations spatiales</emphasis>. PostGIS fournit ces prédicats sous la forme des fonctions <xref linkend="ST_Contains"/>, <xref linkend="ST_Crosses"/>, <xref linkend="ST_Disjoint"/>, <xref linkend="ST_Equals"/>, <xref linkend="ST_Intersects"/>, <xref linkend="ST_Overlaps"/>, <xref linkend="ST_Touches"/>, <xref linkend="ST_Within"/>. Il définit également les prédicats de relation non standard <xref linkend="ST_Covers"/>, <xref linkend="ST_CoveredBy"/>, et <xref linkend="ST_ContainsProperly"/>.

note: Tag: para
en: Spatial predicates are usually used as conditions in SQL <code>WHERE</code> or <code>JOIN</code> clauses. The named spatial predicates automatically use a spatial index if one is available, so there is no need to use the bounding box operator <code>&amp;&amp;</code> as well. For example:
fr: Les prédicats spatiaux sont généralement utilisés comme conditions dans les clauses SQL <code>WHERE</code> ou <code>JOIN</code>. Les prédicats spatiaux nommés utilisent automatiquement un index spatial s'il existe, de sorte qu'il n'est pas nécessaire d'utiliser également l'opérateur de boîte de délimitation <code>&amp;&amp;</code>. Par exemple :

note: Tag: para
en: For more details and illustrations, see the <link xlink:href="https://postgis.net/workshops/postgis-intro/spatial_relationships.html">PostGIS Workshop.</link>
fr: Pour plus de détails et d'illustrations, voir l' <link xlink:href="https://postgis.net/workshops/postgis-intro/spatial_relationships.html">Atelier PostGIS.</link>

note: Tag: title
en: General Spatial Relationships
fr: Relations spatiales générales

note: Tag: para
en: In some cases the named spatial relationships are insufficient to provide a desired spatial filter condition.
fr: Dans certains cas, les relations spatiales nommées sont insuffisantes pour fournir une condition de filtrage spatial souhaitée.

note: Tag: para
en: For example, consider a linear dataset representing a road network. It may be required to identify all road segments that cross each other, not at a point, but in a line (perhaps to validate some business rule). In this case <xref linkend="ST_Crosses"/> does not provide the necessary spatial filter, since for linear features it returns <varname>true</varname> only where they cross at a point.
fr: Prenons l'exemple d'un ensemble de données linéaires représentant un réseau routier. Il peut être nécessaire d'identifier tous les segments de route qui se croisent, non pas en un point, mais en une ligne (peut-être pour valider une règle commerciale). Dans ce cas, <xref linkend="ST_Crosses"/> ne fournit pas le filtre spatial nécessaire, puisque pour les caractéristiques linéaires, il renvoie <varname>true</varname> uniquement lorsqu'elles se croisent en un point.

note: Tag: para
en: A two-step solution would be to first compute the actual intersection (<xref linkend="ST_Intersection"/>) of pairs of road lines that spatially intersect (<xref linkend="ST_Intersects"/>), and then check if the intersection's <xref linkend="ST_GeometryType"/> is '<varname>LINESTRING</varname>' (properly dealing with cases that return <varname>GEOMETRYCOLLECTION</varname>s of <varname>[MULTI]POINT</varname>s, <varname>[MULTI]LINESTRING</varname>s, etc.).
fr: Une solution en deux étapes consisterait à calculer d'abord l'intersection réelle (<xref linkend="ST_Intersection"/>) des paires de lignes routières qui se croisent dans l'espace (<xref linkend="ST_Intersects"/>), puis vérifier si le <xref linkend="ST_GeometryType"/> de l'intersection est "<varname>LINESTRING</varname>" (en traitant correctement les cas qui renvoient des <varname>GEOMETRYCOLLECTION</varname>s de <varname>[MULTI]POINT</varname>s, <varname>[MULTI]LINESTRING</varname>s, etc. ).

note: Tag: para
en: Clearly, a simpler and faster solution is desirable.
fr: Il est évident qu'une solution plus simple et plus rapide est souhaitable.

note: Tag: para
en: A second example is locating wharves that intersect a lake's boundary on a line and where one end of the wharf is up on shore. In other words, where a wharf is within but not completely contained by a lake, intersects the boundary of a lake on a line, and where exactly one of the wharf's endpoints is within or on the boundary of the lake. It is possible to use a combination of spatial predicates to find the required features:
fr: Un deuxième exemple est la localisation des quais qui coupent les limites d'un lac sur une ligne et dont l'une des extrémités se trouve sur le rivage. En d'autres termes, lorsqu'un quai est situé à l'intérieur d'un lac mais n'est pas complètement contenu par celui-ci, qu'il coupe la limite d'un lac sur une ligne et que l'une des extrémités du quai se trouve à l'intérieur ou sur la limite du lac. Il est possible d'utiliser une combinaison de prédicats spatiaux pour trouver les caractéristiques requises :

note: Tag: para
en: ... but needless to say, this is quite complicated.
fr: ... mais inutile de dire que c'est assez compliqué.

note: Tag: para
en: These requirements can be met by computing the full DE-9IM intersection matrix. PostGIS provides the <xref linkend="ST_Relate"/> function to do this:
fr: Ces exigences peuvent être satisfaites en calculant la matrice d'intersection DE-9IM complète. PostGIS fournit la fonction <xref linkend="ST_Relate"/> pour ce faire :

note: Tag: para
en: To test a particular spatial relationship, an <emphasis role="bold">intersection matrix pattern</emphasis> is used. This is the matrix representation augmented with the additional symbols <literal>{T,*}</literal>:
fr: Pour tester une relation spatiale particulière, un <emphasis role="bold">modèle de matrice d'intersection</emphasis> est utilisé. Il s'agit de la représentation matricielle augmentée des symboles supplémentaires <literal>{T,*}</literal> :

note: Tag: para
en: <literal>T</literal> =&gt; intersection dimension is non-empty; i.e. is in <literal>{0,1,2}</literal>
fr: <literal>T</literal> =&gt; la dimension d'intersection est non vide ; c'est-à-dire qu'elle se trouve dans <literal>{0,1,2}</literal>

note: Tag: para
en: <literal>*</literal> =&gt; don't care
fr: <literal>*</literal> =&gt; indifférent

note: Tag: para
en: Using intersection matrix patterns, specific spatial relationships can be evaluated in a more succinct way. The <xref linkend="ST_Relate"/> and the <xref linkend="ST_RelateMatch"/> functions can be used to test intersection matrix patterns. For the first example above, the intersection matrix pattern specifying two lines intersecting in a line is '<emphasis role="bold">1*1***1**</emphasis>':
fr: Les modèles de matrice d'intersection permettent d'évaluer des relations spatiales spécifiques de manière plus succincte. Les fonctions <xref linkend="ST_Relate"/> et <xref linkend="ST_RelateMatch"/> peuvent être utilisées pour tester les modèles de matrice d'intersection. Pour le premier exemple ci-dessus, le modèle de matrice d'intersection spécifiant deux lignes se croisant dans une ligne est '<emphasis role="bold">1*1***1**</emphasis>' :

note: Tag: para
en: For the second example, the intersection matrix pattern specifying a line partly inside and partly outside a polygon is '<emphasis role="bold">102101FF2</emphasis>':
fr: Pour le deuxième exemple, le modèle de matrice d'intersection spécifiant une ligne située en partie à l'intérieur et en partie à l'extérieur d'un polygone est "<emphasis role="bold">102101FF2</emphasis>" :

note: Tag: title
en: Using Spatial Indexes
fr: Utilisation des index spatiaux

note: Tag: para
en: When constructing queries using spatial conditions, for best performance it is important to ensure that a spatial index is used, if one exists (see <xref linkend="build-indexes"/>). To do this, a spatial operator or index-aware function must be used in a <code>WHERE</code> or <code>ON</code> clause of the query.
fr: Lors de la construction de requêtes utilisant des conditions spatiales, il est important, pour de meilleures performances, de s'assurer qu'un index spatial est utilisé, s'il existe (voir <xref linkend="build-indexes"/>). Pour ce faire, un opérateur spatial ou une fonction sensible à l'index doit être utilisé dans une clause <code>WHERE</code> ou <code>ON</code> de la requête.

note: Tag: para
en: Spatial operators include the bounding box operators (of which the most commonly used is <xref linkend="geometry_overlaps"/>; see <xref linkend="operators-bbox"/> for the full list) and the distance operators used in nearest-neighbor queries (the most common being <xref linkend="geometry_distance_knn"/>; see <xref linkend="operators-distance"/> for the full list.)
fr: Les opérateurs spatiaux comprennent les opérateurs de boîte de délimitation (dont le plus couramment utilisé est <xref linkend="geometry_overlaps"/> ; voir <xref linkend="operators-bbox"/> pour la liste complète) et les opérateurs de distance utilisés dans les requêtes sur les plus proches voisins (le plus courant étant <xref linkend="geometry_distance_knn"/> ; voir <xref linkend="operators-distance"/> pour la liste complète.)

note: Tag: para
en: Index-aware functions automatically add a bounding box operator to the spatial condition. Index-aware functions include the named spatial relationship predicates <xref linkend="ST_Contains"/>, <xref linkend="ST_ContainsProperly"/>, <xref linkend="ST_CoveredBy"/>, <xref linkend="ST_Covers"/>, <xref linkend="ST_Crosses"/>, <xref linkend="ST_Intersects"/>, <xref linkend="ST_Overlaps"/>, <xref linkend="ST_Touches"/>, <xref linkend="ST_Within"/>, <xref linkend="ST_Within"/>, and <xref linkend="ST_3DIntersects"/>, and the distance predicates <xref linkend="ST_DWithin"/>, <xref linkend="ST_DFullyWithin"/>, <xref linkend="ST_3DDFullyWithin"/>, and <xref linkend="ST_3DDWithin"/> .)
fr: Les fonctions tenant compte de l'index ajoutent automatiquement un opérateur de boîte de délimitation à la condition spatiale. Les fonctions tenant compte de l'index comprennent les prédicats de relation spatiale nommés <xref linkend="ST_Contains"/>, <xref linkend="ST_ContainsProperly"/>, <xref linkend="ST_CoveredBy"/>, <xref linkend="ST_Covers"/>, <xref linkend="ST_Crosses"/>, <xref linkend="ST_Intersects"/>, <xref linkend="ST_Overlaps"/>, <xref linkend="ST_Touches"/>, <xref linkend="ST_Within"/>, <xref linkend="ST_Within"/>, et <xref linkend="ST_3DIntersects"/>, et les prédicats de distance <xref linkend="ST_DWithin"/>, <xref linkend="ST_DFullyWithin"/>, <xref linkend="ST_3DDFullyWithin"/>, et <xref linkend="ST_3DDWithin"/> . )

note: Tag: para
en: Functions such as <xref linkend="ST_Distance"/> do <emphasis>not</emphasis> use indexes to optimize their operation. For example, the following query would be quite slow on a large table:
fr: Les fonctions telles que <xref linkend="ST_Distance"/> n'utilisent <emphasis>pas</emphasis> les index pour optimiser leur fonctionnement. Par exemple, la requête suivante serait assez lente sur une grande table :

note: Tag: para
en: This query selects all the geometries in <code>geom_table</code> which are within 100 units of the point (100000, 200000). It will be slow because it is calculating the distance between each point in the table and the specified point, ie. one <varname>ST_Distance()</varname> calculation is computed for <emphasis role="bold">every</emphasis> row in the table.
fr: Cette requête sélectionne toutes les géométries de la <code>geom_table</code> qui se trouvent à moins de 100 unités du point (100000, 200000). Elle sera lente car elle calcule la distance entre chaque point du tableau et le point spécifié, c'est-à-dire qu'un calcul <varname>ST_Distance()</varname> est effectué pour <emphasis role="bold">chaque</emphasis> ligne du tableau.

note: Tag: para
en: The number of rows processed can be reduced substantially by using the index-aware function <xref linkend="ST_DWithin"/>:
fr: Le nombre de lignes traitées peut être considérablement réduit en utilisant la fonction d'indexation <xref linkend="ST_DWithin"/> :

note: Tag: para
en: This query selects the same geometries, but it does it in a more efficient way. This is enabled by <varname>ST_DWithin()</varname> using the <varname>&amp;&amp;</varname> operator internally on an expanded bounding box of the query geometry. If there is a spatial index on <code>geom</code>, the query planner will recognize that it can use the index to reduce the number of rows scanned before calculating the distance. The spatial index allows retrieving only records with geometries whose bounding boxes overlap the expanded extent and hence which <emphasis>might</emphasis> be within the required distance. The actual distance is then computed to confirm whether to include the record in the result set.
fr: Cette requête sélectionne les mêmes géométries, mais de manière plus efficace. Ceci est possible en <varname>ST_DWithin()</varname> utilisant l'opérateur <varname>&amp;&amp;</varname> en interne sur une boîte de délimitation élargie de la géométrie de la requête. S'il existe un index spatial sur <code>geom</code>, le planificateur de requêtes reconnaîtra qu'il peut utiliser l'index pour réduire le nombre de lignes analysées avant de calculer la distance. L'index spatial permet d'extraire uniquement les enregistrements dont les boîtes de délimitation chevauchent l'étendue élargie et qui, par conséquent, <emphasis>pourraient</emphasis> se trouver à l'intérieur de la distance requise. La distance réelle est ensuite calculée pour confirmer l'inclusion de l'enregistrement dans l'ensemble des résultats.

note: Tag: para
en: For more information and examples see the <link xlink:href="https://postgis.net/workshops/postgis-intro/indexing.html">PostGIS Workshop</link>.
fr: Pour plus d'informations et d'exemples, voir l' <link xlink:href="https://postgis.net/workshops/postgis-intro/indexing.html">atelier de travail PostGIS</link>.

note: Tag: title
en: Examples of Spatial SQL
fr: Exemples de SQL spatial

note: Tag: para
en: The examples in this section make use of a table of linear roads, and a table of polygonal municipality boundaries. The definition of the <varname>bc_roads</varname> table is:
fr: Les exemples de cette section utilisent une table de routes linéaires et une table de limites de communes polygonales. La définition de la table <varname>bc_roads</varname> est la suivante :

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

note: Tag: para
en: What is the total length of all roads, expressed in kilometers?
fr: Quelle est la longueur totale de toutes les routes, exprimée en kilomètres ?

note: Tag: para
en: You can answer this question with a very simple piece of SQL:
fr: Vous pouvez répondre à cette question à l'aide d'un code SQL très simple :

note: Tag: para
en: How large is the city of Prince George, in hectares?
fr: Quelle est la superficie de la ville de Prince George, en hectares ?

note: Tag: para
en: This query combines an attribute condition (on the municipality name) with a spatial calculation (of the polygon area):
fr: Cette requête combine une condition d'attribut (sur le nom de la municipalité) avec un calcul spatial (de la surface du polygone) :

note: Tag: para
en: What is the largest municipality in the province, by area?
fr: Quelle est la plus grande municipalité de la province, en termes de superficie ?

note: Tag: para
en: This query uses a spatial measurement as an ordering value. There are several ways of approaching this problem, but the most efficient is below:
fr: Cette requête utilise une mesure spatiale comme valeur de référence. Il existe plusieurs façons d'aborder ce problème, mais la plus efficace est la suivante :

note: Tag: para
en: Note that in order to answer this query we have to calculate the area of every polygon. If we were doing this a lot it would make sense to add an area column to the table that could be indexed for performance. By ordering the results in a descending direction, and them using the PostgreSQL "LIMIT" command we can easily select just the largest value without using an aggregate function like MAX().
fr: Notez que pour répondre à cette question, nous devons calculer la surface de chaque polygone. Si nous faisions cela souvent, il serait logique d'ajouter une colonne de surface à la table qui pourrait être indexée pour des raisons de performance. En ordonnant les résultats dans une direction décroissante et en utilisant la commande "LIMIT" de PostgreSQL, nous pouvons facilement sélectionner la plus grande valeur sans utiliser une fonction d'agrégation comme MAX().

note: Tag: para
en: What is the length of roads fully contained within each municipality?
fr: Quelle est la longueur des routes entièrement comprises dans chaque municipalité ?

note: Tag: para
en: This is an example of a "spatial join", which brings together data from two tables (with a join) using a spatial interaction ("contained") as the join condition (rather than the usual relational approach of joining on a common key):
fr: Il s'agit d'un exemple de "jointure spatiale", qui rassemble les données de deux tables (avec une jointure) en utilisant une interaction spatiale ("contenu") comme condition de jointure (plutôt que l'approche relationnelle habituelle de jointure sur une clé commune) :

note: Tag: para
en: This query takes a while, because every road in the table is summarized into the final result (about 250K roads for the example table). For smaller datasets (several thousand records on several hundred) the response can be very fast.
fr: Cette requête prend un certain temps, car chaque route du tableau est résumée dans le résultat final (environ 250 000 routes pour le tableau de l'exemple). Pour des ensembles de données plus petits (plusieurs milliers d'enregistrements sur plusieurs centaines), la réponse peut être très rapide.

note: Tag: para
en: Create a new table with all the roads within the city of Prince George.
fr: Créez un nouveau tableau avec toutes les routes de la ville de Prince George.

note: Tag: para
en: This is an example of an "overlay", which takes in two tables and outputs a new table that consists of spatially clipped or cut resultants. Unlike the "spatial join" demonstrated above, this query creates new geometries. An overlay is like a turbo-charged spatial join, and is useful for more exact analysis work:
fr: Il s'agit d'un exemple de "superposition", qui prend en compte deux tableaux et produit un nouveau tableau composé de résultats coupés dans l'espace. Contrairement à la "jointure spatiale" présentée ci-dessus, cette requête crée de nouvelles géométries. Une superposition est comme une jointure spatiale turbocompressée, et est utile pour des travaux d'analyse plus précis :

note: Tag: para
en: What is the length in kilometers of "Douglas St" in Victoria?
fr: Quelle est la longueur en kilomètres de "Douglas St" à Victoria ?

note: Tag: para
en: What is the largest municipality polygon that has a hole?
fr: Quel est le plus grand polygone municipal comportant un trou ?

note: Tag: title
en: Raster Data Management, Queries, and Applications
fr: Gestion des données raster, requêtes et applications

note: Tag: title
en: Loading and Creating Rasters
fr: Chargement et création de rasters

note: Tag: para
en: For most use cases, you will create PostGIS rasters by loading existing raster files using the packaged <varname>raster2pgsql</varname> raster loader.
fr: Dans la plupart des cas, vous créerez des rasters PostGIS en chargeant des fichiers raster existants à l'aide du chargeur de rasters <varname>raster2pgsql</varname>.

note: Tag: title
en: Using raster2pgsql to load rasters
fr: Utilisation de raster2pgsql pour charger des rasters

note: Tag: para
en: The <varname>raster2pgsql</varname> is a raster loader executable that loads GDAL supported raster formats into SQL suitable for loading into a PostGIS raster table. It is capable of loading folders of raster files as well as creating overviews of rasters.
fr: Le <varname>raster2pgsql</varname> est un exécutable de chargement de données raster qui charge les formats de données matricielles pris en charge par GDAL en SQL adapté au chargement dans une table raster PostGIS. Il est capable de charger des dossiers de fichiers raster ainsi que de créer des aperçus de rasters.

note: Tag: para
en: Since the raster2pgsql is compiled as part of PostGIS most often (unless you compile your own GDAL library), the raster types supported by the executable will be the same as those compiled in the GDAL dependency library. To get a list of raster types your particular <varname>raster2pgsql</varname> supports use the <varname>-G</varname> switch.
fr: Comme raster2pgsql est le plus souvent compilé dans le cadre de PostGIS (à moins que vous ne compiliez votre propre bibliothèque GDAL), les types de données raster pris en charge par l'exécutable seront les mêmes que ceux compilés dans la bibliothèque de dépendance GDAL. Pour obtenir une liste des types de données raster que votre <varname>raster2pgsql</varname> supporte, utilisez l'argument <varname>-G</varname>.

note: Tag: para
en: When creating overviews of a specific factor from a set of rasters that are aligned, it is possible for the overviews to not align. Visit <link xlink:href="http://trac.osgeo.org/postgis/ticket/1764">http://trac.osgeo.org/postgis/ticket/1764</link> for an example where the overviews do not align.
fr: Lors de la création de vues d'ensemble d'un facteur spécifique à partir d'un ensemble de rasters alignés, il est possible que les vues d'ensemble ne soient pas alignées. Consultez <link xlink:href="http://trac.osgeo.org/postgis/ticket/1764">http://trac.osgeo.org/postgis/ticket/1764</link> pour un exemple où les vues d'ensemble ne sont pas alignées.

note: Tag: title
en: Example Usage
fr: Exemple d'utilisation

note: Tag: para
en: An example session using the loader to create an input file and uploading it chunked in 100x100 tiles might look like this:
fr: Une session d'exemple utilisant le chargeur pour créer un fichier d'entrée et le charger en morceaux de 100 x 100 tuiles peut ressembler à ceci :

note: Tag: para
en: If you do not specify the schema as part of the target table name, the table will be created in the default schema of the database or user you are connecting with.
fr: Si vous ne spécifiez pas le schéma dans le nom de la table cible, la table sera créée dans le schéma par défaut de la base de données ou de l'utilisateur avec lequel vous vous connectez.

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

note: Tag: para
en: Load rasters Massachusetts state plane meters aerial tiles into a schema called <varname>aerial</varname> and create a full view, 2 and 4 level overview tables, use copy mode for inserting (no intermediary file just straight to db), and -e don't force everything in a transaction (good if you want to see data in tables right away without waiting). Break up the rasters into 128x128 pixel tiles and apply raster constraints. Use copy mode instead of table insert. (-F) Include a field called filename to hold the name of the file the tiles were cut from.
fr: Charger les rasters Massachusetts state plane meters aerial tiles dans un schéma appelé <varname>aerial</varname> et créer une vue complète, des tables d'ensemble à 2 et 4 niveaux, utiliser le mode copy pour l'insertion (pas de fichier intermédiaire juste directement dans la base de données), et -e ne pas forcer tout dans une transaction (bien si vous voulez voir les données dans les tables tout de suite sans attendre). Décomposer les rasters en tuiles de 128x128 pixels et appliquer les contraintes des rasters. Utilisez le mode copy au lieu de l'insertion de table. (-F) Inclure un champ appelé filename pour contenir le nom du fichier à partir duquel les tuiles ont été découpées.

note: Tag: para
en: The -G commands outputs a list something like
fr: La commande -G génère une liste du type

note: Tag: title
en: raster2pgsql options
fr: options raster2pgsql

note: Tag: para
en: Display help screen. Help will also display if you don't pass in any arguments.
fr: Affiche l'écran d'aide. L'aide s'affichera également si vous ne fournissez aucun argument.

note: Tag: para
en: Print the supported raster formats.
fr: Affiche les formats raster pris en charge.

note: Tag: para
en: Create new table and populate it with raster(s), <emphasis>this is the default mode</emphasis>
fr: Créer une nouvelle table et la remplir de données raster, <emphasis>c'est le mode par défaut</emphasis>

note: Tag: para
en: Append raster(s) to an existing table.
fr: Ajouter des données raster à une table existante.

note: Tag: para
en: Drop table, create new one and populate it with raster(s)
fr: Supprimer la table, en créer une nouvelle et l'alimenter avec des données raster

note: Tag: para
en: Prepare mode, only create the table.
fr: En mode préparation, ne créez que la table.

note: Tag: term
en: Raster processing: Applying constraints for proper registering in raster catalogs
fr: Traitement des données raster : Application de contraintes pour un enregistrement correct dans les catalogues de données raster

note: Tag: para
en: Apply raster constraints -- srid, pixelsize etc. to ensure raster is properly registered in <varname>raster_columns</varname> view.
fr: Appliquer les contraintes du raster -- srid, pixelsize etc. pour s'assurer que le raster est correctement enregistré dans la vue <varname>raster_columns</varname>.

note: Tag: para
en: Disable setting the max extent constraint. Only applied if -C flag is also used.
fr: Désactive la contrainte d'étendue maximale. Ne s'applique que si l'option -C est également utilisée.

note: Tag: para
en: Set the constraints (spatially unique and coverage tile) for regular blocking. Only applied if -C flag is also used.
fr: Définit les contraintes (espacement unique et tuiles de couverture) pour le blocage régulier. Ne s'applique que si l'option -C est également utilisée.

note: Tag: term
en: Raster processing: Optional parameters used to manipulate input raster dataset
fr: Traitement des données raster : Paramètres facultatifs utilisés pour manipuler le jeu de données raster d'entrée

note: Tag: para
en: Assign output raster with specified SRID. If not provided or is zero, raster's metadata will be checked to determine an appropriate SRID.
fr: Attribue au raster de sortie le SRID spécifié. S'il n'est pas fourni ou s'il est égal à zéro, les métadonnées du raster seront vérifiées pour déterminer un SRID approprié.

note: Tag: para
en: Index (1-based) of band to extract from raster. For more than one band index, separate with comma (,). If unspecified, all bands of raster will be extracted.
fr: Indice (basé sur 1) de la bande à extraire du raster. Pour plus d'un indice de bande, séparez-les par une virgule (,). Si rien n'est spécifié, toutes les bandes de l'image seront extraites.

note: Tag: para
en: Cut raster into tiles to be inserted one per table row. <varname>TILE_SIZE</varname> is expressed as WIDTHxHEIGHT or set to the value "auto" to allow the loader to compute an appropriate tile size using the first raster and applied to all rasters.
fr: Découpe le raster en tuiles qui seront insérées une par une dans la table. <varname>TILE_SIZE</varname> est exprimée en LARGEURxHAUTEUR ou fixée à la valeur "auto" pour permettre au chargeur de calculer une taille de tuile appropriée en utilisant le premier raster et en l'appliquant à tous les rasters.

note: Tag: para
en: Pad right-most and bottom-most tiles to guarantee that all tiles have the same width and height.
fr: Les tuiles les plus à droite et les plus en bas sont remplacées pour garantir que toutes les tuiles ont la même largeur et la même hauteur.

note: Tag: para
en: Register the raster as a filesystem (out-db) raster.
fr: Enregistrer le raster en tant que raster de système de fichiers (out-db).

note: Tag: para
en: Only the metadata of the raster and path location to the raster is stored in the database (not the pixels).
fr: Seules les métadonnées du raster et le chemin d'accès au raster sont stockés dans la base de données (pas les pixels).

note: Tag: para
en: Create overview of the raster. For more than one factor, separate with comma(,). Overview table name follows the pattern o_<varname>overview factor</varname>_<varname>table</varname>, where <varname>overview factor</varname> is a placeholder for numerical overview factor and <varname>table</varname> is replaced with the base table name. Created overview is stored in the database and is not affected by -R. Note that your generated sql file will contain both the main table and overview tables.
fr: Créer un aperçu du raster. Pour plus d'un facteur, séparez-les par une virgule (,). Le nom de la table de synthèse suit le modèle o_<varname>facteur de synthèse</varname>_<varname>table</varname>, où <varname>facteur de synthèse</varname> est un espace réservé pour le facteur de synthèse numérique et <varname>table</varname> est remplacé par le nom de la table de base. La vue d'ensemble créée est stockée dans la base de données et n'est pas affectée par -R. Notez que le fichier sql généré contiendra à la fois la table principale et les tables de synthèse.

note: Tag: para
en: NODATA value to use on bands without a NODATA value.
fr: Valeur NODATA à utiliser pour les bandes sans valeur NODATA.

note: Tag: term
en: Optional parameters used to manipulate database objects
fr: Paramètres facultatifs utilisés pour manipuler les objets de la base de données

note: Tag: para
en: Specify name of destination raster column, default is 'rast'
fr: Spécifier le nom de la colonne raster de destination, la valeur par défaut étant "rast"

note: Tag: para
en: Add a column with the name of the file
fr: Ajouter une colonne avec le nom du fichier

note: Tag: para
en: Specify the name of the filename column. Implies -F.
fr: Spécifier le nom de la colonne "nom de fichier". Implique -F.

note: Tag: para
en: Wrap PostgreSQL identifiers in quotes.
fr: Mettre les identifiants PostgreSQL entre guillemets.

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

note: Tag: para
en: Vacuum analyze the raster table.
fr: Vacuum analyze la table raster.

note: Tag: para
en: Keeps empty tiles and skips NODATA value checks for each raster band. Note you save time in checking, but could end up with far more junk rows in your database and those junk rows are not marked as empty tiles.
fr: Conserve les tuiles vides et saute les vérifications des valeurs NODATA pour chaque bande de données matricielles. Vous gagnez du temps en vérifiant, mais vous risquez de vous retrouver avec beaucoup plus de lignes inutiles dans votre base de données et ces lignes inutiles ne sont pas marquées comme des tuiles vides.

note: Tag: para
en: Specify the tablespace for the new table. Note that indices (including the primary key) will still use the default tablespace unless the -X flag is also used.
fr: Spécifier le tablespace pour la nouvelle table. Notez que les index (y compris la clé primaire) utiliseront toujours le tablespace par défaut à moins que l'option -X ne soit également utilisée.

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

note: Tag: para
en: Use copy statements instead of insert statements. Optionally specify <varname>max_rows_per_copy</varname>; default 50 when not specified.
fr: Utiliser les instructions de copie au lieu des instructions d'insertion. Spécifier optionnellement <varname>max_rows_per_copy</varname> ; par défaut 50 si non spécifié.

note: Tag: para
en: Execute each statement individually, do not use a transaction.
fr: Exécutez chaque déclaration individuellement, n'utilisez pas de transaction.

note: Tag: para
en: Control endianness of generated binary output of raster; specify 0 for XDR and 1 for NDR (default); only NDR output is supported now
fr: Contrôle l'ordre des octets de la sortie binaire générée du raster ; spécifier 0 pour XDR et 1 pour NDR (par défaut) ; seule la sortie NDR est prise en charge actuellement

note: Tag: para
en: Specify version of output format. Default is 0. Only 0 is supported at this time.
fr: Indique la version du format de sortie. La valeur par défaut est 0. Seule la valeur 0 est prise en charge pour l'instant.

note: Tag: title
en: Creating rasters using PostGIS raster functions
fr: Création de rasters à l'aide des fonctions raster de PostGIS

note: Tag: para
en: On many occasions, you'll want to create rasters and raster tables right in the database. There are a plethora of functions to do that. The general steps to follow.
fr: Il arrive souvent que vous souhaitiez créer des rasters et des tables de rasters directement dans la base de données. Il existe une multitude de fonctions pour ce faire. Les étapes générales à suivre.

note: Tag: para
en: Create a table with a raster column to hold the new raster records which can be accomplished with:
fr: Créer une table avec une colonne raster pour contenir les nouveaux enregistrements raster, ce qui peut être fait avec :

note: Tag: para
en: There are many functions to help with that goal. If you are creating rasters not as a derivative of other rasters, you will want to start with: <xref linkend="RT_ST_MakeEmptyRaster"/>, followed by <xref linkend="RT_ST_AddBand"/>
fr: Il existe de nombreuses fonctions pour vous aider à atteindre cet objectif. Si vous créez des rasters qui ne sont pas des dérivés d'autres rasters, vous devrez commencer par <xref linkend="RT_ST_MakeEmptyRaster"/>, suivi de <xref linkend="RT_ST_AddBand"/>

note: Tag: para
en: You can also create rasters from geometries. To achieve that you'll want to use <xref linkend="RT_ST_AsRaster"/> perhaps accompanied with other functions such as <xref linkend="RT_ST_Union"/> or <xref linkend="RT_ST_MapAlgebraFct2"/> or any of the family of other map algebra functions.
fr: Vous pouvez également créer des rasters à partir de géométries. Pour ce faire, vous devrez utiliser <xref linkend="RT_ST_AsRaster"/> éventuellement accompagné d'autres fonctions telles que <xref linkend="RT_ST_Union"/> ou <xref linkend="RT_ST_MapAlgebraFct2"/> ou n'importe quelle autre fonction d'algèbre de carte.

note: Tag: para
en: There are even many more options for creating new raster tables from existing tables. For example you can create a raster table in a different projection from an existing one using <xref linkend="RT_ST_Transform"/>
fr: Il existe encore bien d'autres options pour créer de nouvelles tables raster à partir de tables existantes. Par exemple, vous pouvez créer une table raster dans une projection différente de celle d'une table existante en utilisant <xref linkend="RT_ST_Transform"/>

note: Tag: para
en: Once you are done populating your table initially, you'll want to create a spatial index on the raster column with something like:
fr: Une fois que vous avez rempli votre table initialement, vous devez créer un index spatial sur la colonne des données raster avec quelque chose comme :

note: Tag: para
en: Note the use of <xref linkend="RT_ST_ConvexHull"/> since most raster operators are based on the convex hull of the rasters.
fr: Notez l'utilisation de <xref linkend="RT_ST_ConvexHull"/> puisque la plupart des opérateurs de données raster sont basés sur l'enveloppe convexe des données raster.

note: Tag: para
en: Pre-2.0 versions of PostGIS raster were based on the envelop rather than the convex hull. For the spatial indexes to work properly you'll need to drop those and replace with convex hull based index.
fr: Les versions antérieures à la version 2.0 de PostGIS raster étaient basées sur l'enveloppe plutôt que sur l'enveloppe convexe. Pour que les index spatiaux fonctionnent correctement, vous devez les supprimer et les remplacer par des index basés sur l'enveloppe convexe.

note: Tag: para
en: Apply raster constraints using <xref linkend="RT_AddRasterConstraints"/>
fr: Appliquer des contraintes raster en utilisant <xref linkend="RT_AddRasterConstraints"/>

note: Tag: title
en: Using "out db" cloud rasters
fr: Utilisation de rasters "out db" stockés sur le cloud

note: Tag: para
en: The <varname>raster2pgsql</varname> tool uses GDAL to access raster data, and can take advantage of a key GDAL feature: the ability to read from rasters that are <link xlink:href="https://gdal.org/user/virtual_file_systems.html#network-based-file-systems">stored remotely</link> in cloud "object stores" (e.g. AWS S3, Google Cloud Storage).
fr: L'outil <varname>raster2pgsql</varname> utilise GDAL pour accéder aux données raster et peut tirer parti d'une fonctionnalité clé de GDAL : la possibilité de lire des données raster qui sont <link xlink:href="https://gdal.org/user/virtual_file_systems.html#network-based-file-systems">stockées à distance</link> dans des "magasins d'objets" en nuage (par exemple AWS S3, Google Cloud Storage).

note: Tag: para
en: Efficient use of cloud stored rasters requires the use of a "cloud optimized" format. The most well-known and widely used is the "<link xlink:href="https://gdal.org/drivers/raster/cog.html">cloud optimized GeoTIFF</link>" format. Using a non-cloud format, like a JPEG, or an un-tiled TIFF will result in very poor performance, as the system will have to download the entire raster each time it needs to access a subset.
fr: L'utilisation efficace des rasters stockés dans le cloud nécessite l'utilisation d'un format "optimisé pour le cloud". Le plus connu et le plus largement utilisé est le format "<link xlink:href="https://gdal.org/drivers/raster/cog.html">cloud optimized GeoTIFF</link>". L'utilisation d'un format non optimisé pour le cloud, comme un JPEG ou un TIFF non structuré, se traduira par des performances très médiocres, car le système devra télécharger l'intégralité du raster chaque fois qu'il devra accéder à un sous-ensemble.

note: Tag: para
en: First, load your raster into the cloud storage of your choice. Once it is loaded, you will have a URI to access it with, either an "http" URI, or sometimes a URI specific to the service. (e.g., "s3://bucket/object"). To access non-public buckets, you will need to supply GDAL config options to authenticate your connection. Note that this command is <emphasis>reading</emphasis> from the cloud raster and <emphasis>writing</emphasis> to the database.
fr: Tout d'abord, chargez votre raster dans le service de stockage cloud de votre choix. Une fois qu'il est chargé, vous aurez un URI pour y accéder, soit un URI "http", soit parfois un URI spécifique au service (par exemple, "s3://bucket/object") Pour accéder aux buckets non publics, vous devrez fournir des options de configuration GDAL pour authentifier votre connexion. Notez que cette commande <emphasis>lit</emphasis> à partir du raster (stocké dans le cloud) et <emphasis>écrit</emphasis> dans la base de données.

note: Tag: para
en: Once the table is loaded, you need to give the database permission to read from remote rasters, by setting two permissions, <xref linkend="postgis_enable_outdb_rasters"/> and <xref linkend="postgis_gdal_enabled_drivers"/>.
fr: Une fois la table chargée, vous devez donner à la base de données la permission de lire les rasters distants, en définissant deux permissions, <xref linkend="postgis_enable_outdb_rasters"/> et <xref linkend="postgis_gdal_enabled_drivers"/>.

note: Tag: para
en: To make the changes sticky, set them directly on your database. You will need to re-connect to experience the new settings.
fr: Pour que les changements soient durables, définissez-les directement dans votre base de données. Vous devrez vous reconnecter pour bénéficier des nouveaux paramètres.

note: Tag: para
en: For non-public rasters, you may have to provide access keys to read from the cloud rasters. The same keys you used to write the <varname>raster2pgsql</varname> call can be set for use inside the database, with the <xref linkend="postgis_gdal_vsi_options"/> configuration. Note that multiple options can be set by space-separating the <varname>key=value</varname> pairs.
fr: Pour les rasters non publics, il se peut que vous deviez fournir des clés d'accès pour lire les rasters stockés dans le cloud. Les mêmes clés que vous avez utilisées pour écrire l'appel <varname>raster2pgsql</varname> peuvent être définies pour être utilisées à l'intérieur de la base de données, avec la configuration <xref linkend="postgis_gdal_vsi_options"/>. Notez que plusieurs options peuvent être définies en séparant les paires <varname>key=value</varname> par des espaces.

note: Tag: para
en: Once you have the data loaded and permissions set you can interact with the raster table like any other raster table, using the same functions. The database will handle all the mechanics of connecting to the cloud data when it needs to read pixel data.
fr: Une fois les données chargées et les autorisations définies, vous pouvez interagir avec la table raster comme avec n'importe quelle autre table raster, en utilisant les mêmes fonctions. La base de données se chargera de tous les mécanismes de connexion aux données stockées dans le cloud lorsqu'elle aura besoin de lire les données des pixels.

note: Tag: title
en: Raster Catalogs
fr: Catalogues Raster

note: Tag: para
en: There are two raster catalog views that come packaged with PostGIS. Both views utilize information embedded in the constraints of the raster tables. As a result the catalog views are always consistent with the raster data in the tables since the constraints are enforced.
fr: Deux vues de catalogue raster sont fournies avec PostGIS. Ces deux vues utilisent des informations intégrées dans les contraintes des tables raster. Par conséquent, les vues de catalogue sont toujours cohérentes avec les données raster des tables puisque les contraintes sont appliquées.

note: Tag: para
en: <varname>raster_columns</varname> this view catalogs all the raster table columns in your database.
fr: <varname>raster_columns</varname> cette vue répertorie toutes les colonnes des tables raster de votre base de données.

note: Tag: para
en: <varname>raster_overviews</varname> this view catalogs all the raster table columns in your database that serve as overviews for a finer grained table. Tables of this type are generated when you use the <varname>-l</varname> switch during load.
fr: <varname>raster_overviews</varname> cette vue répertorie toutes les colonnes des tables raster de votre base de données qui servent d'aperçu pour une table plus finement structurée. Les tables de ce type sont générées lorsque vous utilisez le commutateur <varname>-l</varname> pendant le chargement.

note: Tag: title
en: Raster Columns Catalog
fr: Catalogue des colonnes raster

note: Tag: para
en: The <varname>raster_columns</varname> is a catalog of all raster table columns in your database that are of type raster. It is a view utilizing the constraints on the tables so the information is always consistent even if you restore one raster table from a backup of another database. The following columns exist in the <varname>raster_columns</varname> catalog.
fr: Le <varname>raster_columns</varname> est un catalogue de toutes les colonnes des tables raster de votre base de données qui sont de type raster. Il s'agit d'une vue qui utilise les contraintes des tables afin que les informations soient toujours cohérentes, même si vous restaurez une table raster à partir d'une sauvegarde d'une autre base de données. Les colonnes suivantes existent dans le catalogue <varname>raster_columns</varname>.

note: Tag: para
en: If you created your tables not with the loader or forgot to specify the <varname>-C</varname> flag during load, you can enforce the constraints after the fact using <xref linkend="RT_AddRasterConstraints"/> so that the <varname>raster_columns</varname> catalog registers the common information about your raster tiles.
fr: Si vous n'avez pas créé vos tables avec le chargeur ou si vous avez oublié de spécifier l'option <varname>-C</varname> pendant le chargement, vous pouvez appliquer les contraintes après coup en utilisant <xref linkend="RT_AddRasterConstraints"/> pour que le catalogue <varname>raster_columns</varname> enregistre les informations communes sur vos tuiles raster.

note: Tag: para
en: <varname>r_table_catalog</varname> The database the table is in. This will always read the current database.
fr: <varname>r_table_catalog</varname> La base de données dans laquelle se trouve la table. La lecture se fera toujours dans la base de données actuelle.

note: Tag: para
en: <varname>r_table_schema</varname> The database schema the raster table belongs to.
fr: <varname>r_table_schema</varname> Schéma de la base de données auquel appartient la table raster.

note: Tag: para
en: <varname>r_table_name</varname> raster table
fr: <varname>r_table_name</varname> table raster

note: Tag: para
en: <varname>r_raster_column</varname> the column in the <varname>r_table_name</varname> table that is of type raster. There is nothing in PostGIS preventing you from having multiple raster columns per table so its possible to have a raster table listed multiple times with a different raster column for each.
fr: <varname>r_raster_column</varname> la colonne de la table <varname>r_table_name</varname> qui est de type raster. Rien dans PostGIS ne vous empêche d'avoir plusieurs colonnes raster par table. Il est donc possible d'avoir une table raster listée plusieurs fois avec une colonne raster différente pour chacune d'entre elles.

note: Tag: para
en: <varname>srid</varname> The spatial reference identifier of the raster. Should be an entry in the <xref linkend="spatial_ref_sys"/>.
fr: <varname>srid</varname> L'identifiant de référence spatiale du raster. Il doit s'agir d'une entrée dans le fichier <xref linkend="spatial_ref_sys"/>.

note: Tag: para
en: <varname>scale_x</varname> The scaling between geometric spatial coordinates and pixel. This is only available if all tiles in the raster column have the same <varname>scale_x</varname> and this constraint is applied. Refer to <xref linkend="RT_ST_ScaleX"/> for more details.
fr: <varname>scale_x</varname> L'échelle entre les coordonnées spatiales géométriques et le pixel. Elle n'est disponible que si toutes les tuiles de la colonne raster ont la même <varname>scale_x</varname> et que cette contrainte est appliquée. Se référer à <xref linkend="RT_ST_ScaleX"/> pour plus de détails.

note: Tag: para
en: <varname>scale_y</varname> The scaling between geometric spatial coordinates and pixel. This is only available if all tiles in the raster column have the same <varname>scale_y</varname> and the <varname>scale_y</varname> constraint is applied. Refer to <xref linkend="RT_ST_ScaleY"/> for more details.
fr: <varname>scale_y</varname> L'échelle entre les coordonnées spatiales géométriques et le pixel. Elle n'est disponible que si toutes les tuiles de la colonne matricielle ont la même <varname>scale_y</varname> et que la contrainte <varname>scale_y</varname> est appliquée. Voir <xref linkend="RT_ST_ScaleY"/> pour plus de détails.

note: Tag: para
en: <varname>blocksize_x</varname> The width (number of pixels across) of each raster tile . Refer to <xref linkend="RT_ST_Width"/> for more details.
fr: <varname>blocksize_x</varname> La largeur (nombre de pixels) de chaque tuile raster. Pour plus de détails, voir <xref linkend="RT_ST_Width"/>.

note: Tag: para
en: <varname>blocksize_y</varname> The width (number of pixels down) of each raster tile . Refer to <xref linkend="RT_ST_Height"/> for more details.
fr: <varname>blocksize_y</varname> La largeur (nombre de pixels vers le bas) de chaque tuile raster. Voir <xref linkend="RT_ST_Height"/> pour plus de détails.

note: Tag: para
en: <varname>same_alignment</varname> A boolean that is true if all the raster tiles have the same alignment . Refer to <xref linkend="RT_ST_SameAlignment"/> for more details.
fr: <varname>same_alignment</varname> Un booléen qui est vrai si toutes les tuiles raster ont le même alignement . Pour plus de détails, voir <xref linkend="RT_ST_SameAlignment"/>.

note: Tag: para
en: <varname>regular_blocking</varname> If the raster column has the spatially unique and coverage tile constraints, the value with be TRUE. Otherwise, it will be FALSE.
fr: <varname>regular_blocking</varname> Si la colonne de données raster est soumise aux contraintes d'unicité spatiale et de couverture des tuiles, la valeur sera TRUE. Dans le cas contraire, la valeur sera FALSE.

note: Tag: para
en: <varname>num_bands</varname> The number of bands in each tile of your raster set. This is the same information as what is provided by
fr: <varname>num_bands</varname> Le nombre de bandes dans chaque tuile de votre jeu de données raster. Il s'agit de la même information que celle fournie par

note: Tag: para
en: <varname>pixel_types</varname> An array defining the pixel type for each band. You will have the same number of elements in this array as you have number of bands. The pixel_types are one of the following defined in <xref linkend="RT_ST_BandPixelType"/>.
fr: <varname>pixel_types</varname> Un tableau définissant le type de pixel pour chaque bande. Le nombre d'éléments de ce tableau est identique au nombre de bandes. Les types de pixels sont l'un des suivants, définis dans <xref linkend="RT_ST_BandPixelType"/>.

note: Tag: para
en: <varname>nodata_values</varname> An array of double precision numbers denoting the <varname>nodata_value</varname> for each band. You will have the same number of elements in this array as you have number of bands. These numbers define the pixel value for each band that should be ignored for most operations. This is similar information provided by <xref linkend="RT_ST_BandNoDataValue"/>.
fr: <varname>nodata_values</varname> Un tableau de nombres en double précision indiquant la <varname>nodata_value</varname> pour chaque bande. Le nombre d'éléments de ce tableau est égal au nombre de bandes. Ces nombres définissent la valeur du pixel pour chaque bande qui doit être ignorée pour la plupart des opérations. Il s'agit d'informations similaires à celles fournies par <xref linkend="RT_ST_BandNoDataValue"/>.

note: Tag: para
en: <varname>out_db</varname> An array of boolean flags indicating if the raster bands data is maintained outside the database. You will have the same number of elements in this array as you have number of bands.
fr: <varname>out_db</varname> Un tableau d'indicateurs booléens indiquant si les données des bandes raster sont conservées en dehors de la base de données. Le nombre d'éléments de ce tableau est égal au nombre de bandes.

note: Tag: para
en: <varname>extent</varname> This is the extent of all the raster rows in your raster set. If you plan to load more data that will change the extent of the set, you'll want to run the <xref linkend="RT_DropRasterConstraints"/> function before load and then reapply constraints with <xref linkend="RT_AddRasterConstraints"/> after load.
fr: <varname>extent</varname> Il s'agit de l'étendue de toutes les lignes de votre jeu de données raster. Si vous prévoyez de charger d'autres données qui modifieront l'étendue de l'ensemble, vous devrez exécuter la fonction <xref linkend="RT_DropRasterConstraints"/> avant le chargement, puis réappliquer les contraintes avec <xref linkend="RT_AddRasterConstraints"/> après le chargement.

note: Tag: para
en: <varname>spatial_index</varname> A boolean that is true if raster column has a spatial index.
fr: <varname>spatial_index</varname> Un booléen qui est vrai si la colonne raster a un index spatial.

note: Tag: title
en: Raster Overviews
fr: Aperçu des données raster

note: Tag: para
en: <varname>raster_overviews</varname> catalogs information about raster table columns used for overviews and additional information about them that is useful to know when utilizing overviews. Overview tables are cataloged in both <varname>raster_columns</varname> and <varname>raster_overviews</varname> because they are rasters in their own right but also serve an additional special purpose of being a lower resolution caricature of a higher resolution table. These are generated along-side the main raster table when you use the <varname>-l</varname> switch in raster loading or can be generated manually using <xref linkend="RT_AddOverviewConstraints"/>.
fr: <varname>raster_overviews</varname> catalogue des informations sur les colonnes des tables raster utilisées pour les aperçus et des informations supplémentaires à leur sujet qu'il est utile de connaître lors de l'utilisation des aperçus. Les tableaux de synthèse sont catalogués à la fois dans <varname>raster_columns</varname> et <varname>raster_overviews</varname> parce qu'il s'agit d'images raster à part entière, mais aussi parce qu'elles servent de caricature à plus faible résolution d'un tableau à plus haute résolution. Elles sont générées en même temps que la table raster principale lorsque vous utilisez le commutateur <varname>-l</varname> dans le chargement des données raster ou peuvent être générées manuellement en utilisant <xref linkend="RT_AddOverviewConstraints"/>.

note: Tag: para
en: Overview tables contain the same constraints as other raster tables as well as additional informational only constraints specific to overviews.
fr: Les tableaux d'aperçus contiennent les mêmes contraintes que les autres tableaux raster, ainsi que des contraintes supplémentaires spécifiques aux aperçus.

note: Tag: para
en: The information in <varname>raster_overviews</varname> does not duplicate the information in <varname>raster_columns</varname>. If you need the information about an overview table present in <varname>raster_columns</varname> you can join the <varname>raster_overviews</varname> and <varname>raster_columns</varname> together to get the full set of information you need.
fr: Les informations contenues dans <varname>raster_overviews</varname> ne font pas double emploi avec les informations contenues dans <varname>raster_columns</varname>. Si vous avez besoin des informations sur un tableau de synthèse présentes dans <varname>raster_columns</varname>, vous pouvez joindre les <varname>raster_overviews</varname> et <varname>raster_columns</varname> pour obtenir l'ensemble des informations dont vous avez besoin.

note: Tag: para
en: Two main reasons for overviews are:
fr: Les deux principales raisons pour lesquelles les aperçus sont nécessaires sont les suivantes :

note: Tag: para
en: Low resolution representation of the core tables commonly used for fast mapping zoom-out.
fr: Représentation à basse résolution des tables centrales, couramment utilisée pour l'agrandissement rapide des cartes.

note: Tag: para
en: Computations are generally faster to do on them than their higher resolution parents because there are fewer records and each pixel covers more territory. Though the computations are not as accurate as the high-res tables they support, they can be sufficient in many rule-of-thumb computations.
fr: Les calculs y sont généralement plus rapides que sur leurs homologues à plus haute résolution, car il y a moins d'enregistrements et chaque pixel couvre un plus grand territoire. Bien que les calculs ne soient pas aussi précis que les tableaux à haute résolution qu'ils supportent, ils peuvent être suffisants pour de nombreux calculs empiriques.

note: Tag: para
en: The <varname>raster_overviews</varname> catalog contains the following columns of information.
fr: Le catalogue <varname>raster_overviews</varname> contient les colonnes d'information suivantes.

note: Tag: para
en: <varname>o_table_catalog</varname> The database the overview table is in. This will always read the current database.
fr: <varname>o_table_catalog</varname> La base de données dans laquelle se trouve l'aperçu. Il s'agit toujours de la base de données actuelle.

note: Tag: para
en: <varname>o_table_schema</varname> The database schema the overview raster table belongs to.
fr: <varname>o_table_schema</varname> Schéma de la base de données auquel appartient l'aperçu de la table raster.

note: Tag: para
en: <varname>o_table_name</varname> raster overview table name
fr: <varname>o_table_name</varname> nom de la table d'aperçu du raster

note: Tag: para
en: <varname>o_raster_column</varname> the raster column in the overview table.
fr: <varname>o_raster_column</varname> la colonne raster dans le tableau de synthèse.

note: Tag: para
en: <varname>r_table_catalog</varname> The database the raster table that this overview services is in. This will always read the current database.
fr: <varname>r_table_catalog</varname> La base de données dans laquelle se trouve la table raster pour laquelle cette vue d'ensemble est utilisée. Il s'agit toujours de la base de données actuelle.

note: Tag: para
en: <varname>r_table_schema</varname> The database schema the raster table that this overview services belongs to.
fr: <varname>r_table_schema</varname> Schéma de la base de données auquel appartient la table raster à laquelle ce service de vue d'ensemble est associé.

note: Tag: para
en: <varname>r_table_name</varname> raster table that this overview services.
fr: <varname>r_table_name</varname> table raster que cet aperçu dessert.

note: Tag: para
en: <varname>r_raster_column</varname> the raster column that this overview column services.
fr: <varname>r_raster_column</varname> la colonne raster que cette colonne d'aperçu dessert.

note: Tag: para
en: <varname>overview_factor</varname> - this is the pyramid level of the overview table. The higher the number the lower the resolution of the table. raster2pgsql if given a folder of images, will compute overview of each image file and load separately. Level 1 is assumed and always the original file. Level 2 is will have each tile represent 4 of the original. So for example if you have a folder of 5000x5000 pixel image files that you chose to chunk 125x125, for each image file your base table will have (5000*5000)/(125*125) records = 1600, your (l=2) <varname>o_2</varname> table will have ceiling(1600/Power(2,2)) = 400 rows, your (l=3) <varname>o_3</varname> will have ceiling(1600/Power(2,3) ) = 200 rows. If your pixels aren't divisible by the size of your tiles, you'll get some scrap tiles (tiles not completely filled). Note that each overview tile generated by raster2pgsql has the same number of pixels as its parent, but is of a lower resolution where each pixel of it represents (Power(2,overview_factor) pixels of the original).
fr: <varname>overview_factor</varname> - il s'agit du niveau pyramidal de l'aperçu. Plus le nombre est élevé, plus la résolution du tableau est faible. raster2pgsql, s'il reçoit un dossier d'images, calculera la vue d'ensemble de chaque fichier image et le chargera séparément. Le niveau 1 est supposé être le fichier original. Au niveau 2, chaque tuile représente 4 de l'original. Par exemple, si vous avez un dossier de fichiers images de 5000x5000 pixels que vous avez choisi de diviser en 125x125, pour chaque fichier image votre table de base aura (5000*5000)/(125*125) enregistrements = 1600, votre table (l=2) <varname>o_2</varname> aura un plafond(1600/Power(2,2)) = 400 lignes, votre (l=3) <varname>o_3</varname> aura un plafond(1600/Power(2,3) ) = 200 lignes. Si vos pixels ne sont pas divisibles par la taille de vos tuiles, vous obtiendrez des bouts de tuiles (tuiles non complètement remplies). Notez que chaque tuile d'aperçu générée par raster2pgsql a le même nombre de pixels que son parent, mais a une résolution inférieure, chaque pixel représentant (Puissance(2,facteur_d'aperçu) pixels de l'original).

note: Tag: title
en: Building Custom Applications with PostGIS Raster
fr: Créer des applications personnalisées avec PostGIS Raster

note: Tag: para
en: The fact that PostGIS raster provides you with SQL functions to render rasters in known image formats gives you a lot of options for rendering them. For example you can use OpenOffice / LibreOffice for rendering as demonstrated in <link xlink:href="http://www.postgresonline.com/journal/archives/244-Rendering-PostGIS-Raster-graphics-with-LibreOffice-Base-Reports.html">Rendering PostGIS Raster graphics with LibreOffice Base Reports</link>. In addition you can use a wide variety of languages as demonstrated in this section.
fr: Le fait que PostGIS raster vous fournisse des fonctions SQL pour rendre les rasters dans les formats d'image connus vous donne beaucoup d'options pour les rendre. Par exemple, vous pouvez utiliser OpenOffice / LibreOffice pour le rendu comme démontré dans <link xlink:href="http://www.postgresonline.com/journal/archives/244-Rendering-PostGIS-Raster-graphics-with-LibreOffice-Base-Reports.html">Rendering PostGIS Raster graphics with LibreOffice Base Reports</link>. En outre, vous pouvez utiliser une grande variété de langages, comme le montre cette section.

note: Tag: title
en: PHP Example Outputting using ST_AsPNG in concert with other raster functions
fr: Exemple de sortie PHP utilisant ST_AsPNG avec d'autres fonctions raster

note: Tag: para
en: In this section, we'll demonstrate how to use the PHP PostgreSQL driver and the <xref linkend="RT_ST_AsGDALRaster"/> family of functions to output band 1,2,3 of a raster to a PHP request stream that can then be embedded in an img src html tag.
fr: Dans cette section, nous allons montrer comment utiliser le driver PHP PostgreSQL et la famille de fonctions <xref linkend="RT_ST_AsGDALRaster"/> pour produire les bandes 1,2,3 d'un raster dans un flux de requête PHP qui peut ensuite être incorporé dans une balise html img src.

note: Tag: para
en: The sample query demonstrates how to combine a whole bunch of raster functions together to grab all tiles that intersect a particular wgs 84 bounding box and then unions with <xref linkend="RT_ST_Union"/> the intersecting tiles together returning all bands, transforms to user specified projection using <xref linkend="RT_ST_Transform"/>, and then outputs the results as a png using <xref linkend="RT_ST_AsPNG"/>.
fr: L'exemple de requête montre comment combiner tout un ensemble de fonctions raster pour récupérer toutes les tuiles qui intersectent une boîte de délimitation wgs 84 particulière, puis unit avec <xref linkend="RT_ST_Union"/> les tuiles intersectées en retournant toutes les bandes, transforme en projection spécifiée par l'utilisateur en utilisant <xref linkend="RT_ST_Transform"/>, et sort les résultats au format png en utilisant <xref linkend="RT_ST_AsPNG"/>.

note: Tag: para
en: You would call the below using <programlisting>http://mywebserver/test_raster.php?srid=2249</programlisting> to get the raster image in Massachusetts state plane feet.
fr: Vous appellerez la commande ci-dessous en utilisant <programlisting>http://mywebserver/test_raster.php?srid=2249</programlisting> pour obtenir l'image raster en pieds de plan de l'État du Massachusetts.

note: Tag: title
en: ASP.NET C# Example Outputting using ST_AsPNG in concert with other raster functions
fr: Exemple ASP.NET C# Sortie utilisant ST_AsPNG en conjonction avec d'autres fonctions raster

note: Tag: para
en: In this section, we'll demonstrate how to use Npgsql PostgreSQL .NET driver and the <xref linkend="RT_ST_AsGDALRaster"/> family of functions to output band 1,2,3 of a raster to a PHP request stream that can then be embedded in an img src html tag.
fr: Dans cette section, nous allons montrer comment utiliser le driver Npgsql PostgreSQL .NET et la famille de fonctions <xref linkend="RT_ST_AsGDALRaster"/> pour produire les bandes 1,2,3 d'un raster dans un flux de requête PHP qui peut ensuite être incorporé dans une balise html img src.

note: Tag: para
en: You will need the npgsql .NET PostgreSQL driver for this exercise which you can get the latest of from <link xlink:href="http://npgsql.projects.postgresql.org/">http://npgsql.projects.postgresql.org/</link>. Just download the latest and drop into your ASP.NET bin folder and you'll be good to go.
fr: Pour cet exercice, vous aurez besoin du driver PostgreSQL npgsql .NET dont vous pouvez obtenir la dernière version sur <link xlink:href="http://npgsql.projects.postgresql.org/">http://npgsql.projects.postgresql.org/</link>. Il vous suffit de télécharger la dernière version et de la placer dans votre dossier ASP.NET bin.

note: Tag: para
en: This is same example as <xref linkend="RT_PHP_Output"/> except implemented in C#.
fr: Il s'agit du même exemple que <xref linkend="RT_PHP_Output"/> sauf qu'il est implémenté en C#.

note: Tag: para
en: You would call the below using <programlisting>http://mywebserver/TestRaster.ashx?srid=2249</programlisting> to get the raster image in Massachusetts state plane feet.
fr: Vous appellerez la commande ci-dessous en utilisant <programlisting>http://mywebserver/TestRaster.ashx?srid=2249</programlisting> pour obtenir l'image raster en pieds de plan de l'État du Massachusetts.

note: Tag: title
en: Java console app that outputs raster query as Image file
fr: Application console Java qui produit une requête raster sous forme de fichier image

note: Tag: para
en: This is a simple java console app that takes a query that returns one image and outputs to specified file.
fr: Il s'agit d'une simple application console Java qui prend une requête renvoyant une image et l'envoie dans le fichier spécifié.

note: Tag: para
en: You can download the latest PostgreSQL JDBC drivers from <link xlink:href="http://jdbc.postgresql.org/download.html">http://jdbc.postgresql.org/download.html</link>
fr: Vous pouvez télécharger les derniers drivers JDBC de PostgreSQL à partir de <link xlink:href="http://jdbc.postgresql.org/download.html">http://jdbc.postgresql.org/download.html</link>

note: Tag: para
en: You can compile the following code using a command something like:
fr: Vous pouvez compiler le code suivant à l'aide d'une commande du type :

note: Tag: para
en: And call it from the command-line with something like
fr: Et l'appeler à partir de la ligne de commande avec quelque chose comme

note: Tag: title
en: Use PLPython to dump out images via SQL
fr: Utiliser PLPython pour extraire des images via SQL

note: Tag: para
en: This is a plpython stored function that creates a file in the server directory for each record. Requires you have plpython installed. Should work fine with both plpythonu and plpython3u.
fr: Il s'agit d'une fonction stockée en plpython qui crée un fichier dans le répertoire du serveur pour chaque enregistrement. Nécessite l'installation de plpython. Elle devrait fonctionner correctement avec plpythonu et plpython3u.

note: Tag: title
en: Outputting Rasters with PSQL
fr: Sortie de données raster avec PSQL

note: Tag: para
en: Sadly PSQL doesn't have easy to use built-in functionality for outputting binaries. This is a bit of a hack that piggy backs on PostgreSQL somewhat legacy large object support. To use first launch your psql commandline connected to your database.
fr: Malheureusement, PSQL n'a pas de fonctionnalité intégrée facile à utiliser pour produire des binaires. Il s'agit d'une astuce qui s'appuie sur le support des gros objets de PostgreSQL. Pour l'utiliser, lancez d'abord votre ligne de commande psql connectée à votre base de données.

note: Tag: para
en: Unlike the python approach, this approach creates the file on your local computer.
fr: Contrairement à l'approche python, cette approche crée le fichier sur votre ordinateur local.

note: Tag: title
en: PostGIS Functions new or enhanced in %
fr: Fonctions PostGIS nouvelles ou améliorées en %

note: Tag: para
en: The functions given below are PostGIS functions that were added or enhanced.
fr: Les fonctions indiquées ci-dessous sont des fonctions PostGIS qui ont été ajoutées ou améliorées.

note: Tag: para
en: Functions new in PostGIS %
fr: Fonctions nouvelles dans PostGIS %

note: Tag: para
en: Functions enhanced in PostGIS %
fr: Fonctions améliorées dans PostGIS %

note: Tag: para
en: Functions changed in PostGIS %
fr: Fonctions modifiées dans PostGIS %

note: Tag: para
en: This method needs address_standardizer extension.
fr: Cette méthode nécessite l'extension address_standardizer.

note: Tag: para
en: This method supports Circular Strings and Curves.
fr: Cette méthode prend en charge les types Circular String et Curve.

note: Tag: para
en: For geography this is a thin wrapper around the geometry implementation.
fr: Pour le type geography, il s'agit d'un fin wrapper autour de l'implémentation de la géométrie.

note: Tag: para
en: This function automatically includes a bounding box comparison that makes use of any spatial indexes that are available on the geometries.
fr: Cette fonction inclut une comparaison de la boîte englobante qui utilise tous les index disponibles sur les géométries.

note: Tag: para
en: This function supports M coordinates.
fr: Cette fonction prend en charge les coordonnées M.

note: Tag: para
en: This function supports Polyhedral surfaces.
fr: Cette fonction prend en charge les surfaces Polyhedral.

note: Tag: para
en: This method is also provided by SFCGAL backend.
fr: Cette méthode est également fournie par le backend SFCGAL.

note: Tag: para
en: This method needs SFCGAL backend.
fr: Cette méthode nécessite le backend SFCGAL.

note: Tag: para
en: This method implements the <link xlink:href="http://www.opengeospatial.org/standards/sfs">OGC Simple Features Implementation Specification for SQL 1.1.</link>
fr: Cette méthode implémente la spécification <link xlink:href="http://www.opengeospatial.org/standards/sfs">OGC Simple Features Implementation Specification for SQL 1.1.</link>

note: Tag: para
en: This method implements the SQL/MM specification.
fr: Cette méthode implémente la spécification SQL/MM.

note: Tag: para
en: This function supports Triangles and Triangulated Irregular Network Surfaces (TIN).
fr: Cette fonction prend en charge les triangles et les réseaux irréguliers triangulés (TIN).

note: Tag: para
en: This function supports 3d and will not drop the z-index.
fr: Cette fonction prend en charge la 3D et ne supprime pas l'indice z.

note: Tag: para
en: New in this release
fr: Nouveautés de cette version

note: Tag: para
en: Enhanced in this release
fr: Améliorations dans cette version

note: Tag: para
en: Aggregate
fr: Agrégat

note: Tag: para
en: Window function
fr: Fonction Window

note: Tag: para
en: Requires GEOS (3.9,3.10,3.11,3.12) or higher
fr: Nécessite GEOS (3.9,3.10,3.11,3.12) ou une version plus récente

note: Tag: para
en: Requires SFCGAL 1.5 or higher
fr: Nécessite SFCGAL 1.5 ou une version plus récente

note: Tag: para
en: 2.5/3D support
fr: Support 2.5/3D

note: Tag: para
en: Supports geography
fr: Prise en charge du type geography
