PyQGISdevelopercookbook
                                              Version 3.4
                                           QGISProject
                                               mars15,2020
                                                                                                                                                                                            Contents
                             1     Introduction                                                                                                                                                                  1
                                   1.1        Scripter dans la console Python . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .                                                              2
                                   1.2        Extensions Python . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .                                                              2
                                   1.3        Exécuter du code python quand QGIS démarre . . . . . . . . . . . . . . . . . . . . . . . . . . .                                                                   3
                                   1.4        Applications Python . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .                                                              3
                                   1.5        Notes techniques sur PyQt et SIP                        .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  . . . . . . . . . .                6
                             2     Chargementdeprojets                                                                                                                                                           7
                             3     Chargementdecouches                                                                                                                                                           9
                                   3.1        Couches vectorielles . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .                                                             9
                                   3.2        Couches raster . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .                                                           12
                                   3.3        QgsProject instance                .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  . . . . . . . . . . .               13
                             4     Utiliser des couches raster                                                                                                                                                 15
                                   4.1        Détails d’une couche . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .                                                           15
                                   4.2        Moteur de rendu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .                                                            16
                                   4.3        Interrogation des données . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .                                                            17
                             5     Utilisation de couches vectorielles                                                                                                                                         19
                                   5.1        Récupérer les informations relatives aux attributs . . . . . . . . . . . . . . . . . . . . . . . . . .                                                           20
                                   5.2        Itérer sur une couche vecteur . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .                                                          20
                                   5.3        Sélection des entités . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .                                                          21
                                   5.4        Modifierdescouchesvecteur . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .                                                                 23
                                   5.5        Utilisation des index spatiaux                    .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  . . . . . . . . . .              26
                                   5.6        Creating Vector Layers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .                                                           27
                                   5.7        Apparence (Symbologie) des couches vecteur . . . . . . . . . . . . . . . . . . . . . . . . . . . .                                                               30
                                   5.8        Sujets complémentaires                   .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  . . . . . . . . . .              38
                             6     Manipulation de la géométrie                                                                                                                                                41
                                   6.1        Construction de géométrie . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .                                                            41
                                   6.2        Accéder à la Géométrie                   .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  . . . . . . . . . .              42
                                   6.3        Prédicats et opérations géométriques                          .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  . . . . . . . . .             43
                             7     Support de projections                                                                                                                                                      45
                                   7.1        Système de coordonnées de référence . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .                                                              45
                                   7.2        Transformation de CRS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .                                                              46
                             8     Using the Map Canvas                                                                                                                                                        49
                                   8.1        Intégrer un canevas de carte . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .                                                           50
                                   8.2        Contour d’édition et symboles de sommets . . . . . . . . . . . . . . . . . . . . . . . . . . . . .                                                               50
                                   8.3        Utiliser les outils cartographiques avec le canevas . . . . . . . . . . . . . . . . . . . . . . . . . .                                                          51
                                                                                                                                                                                                                  i
                                   8.4        Ecrire des outils cartographiques personnalisés . . . . . . . . . . . . . . . . . . . . . . . . . . .                                                            52
                                   8.5        Ecrire des éléments de canevas de carte personnalisés                                    .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  . . . . . . .           54
                             9     RenducartographiqueetImpression                                                                                                                                             55
                                   9.1        Rendusimple . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .                                                            55
                                   9.2        Rendudescouchesayantdifférents SCR . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .                                                                   56
                                   9.3        Output using print layout . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .                                                          56
                             10 Expressions, Filtrage et Calcul de valeurs                                                                                                                                     59
                                   10.1 Analyse syntaxique d’expressions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .                                                                   60
                                   10.2 Évaluation des expressions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .                                                                 60
                                   10.3 Gestion des erreurs dans une expression . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .                                                                  62
                             11 Lecture et sauvegarde de configurations                                                                                                                                         63
                             12 Communiqueravecl’utilisateur                                                                                                                                                   65
                                   12.1 Showingmessages. The QgsMessageBar class . . . . . . . . . . . . . . . . . . . . . . . . . . .                                                                         65
                                   12.2 Afficher la progression . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .                                                                 67
                                   12.3 Journal . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .                                                                68
                             13 Infrastructure d’authentification                                                                                                                                               69
                                   13.1 Introduction                 .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  . . . . . . . . . . . .                70
                                   13.2 Glossaire . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .                                                                70
                                   13.3 QgsAuthManagerlepointd’entrée . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .                                                                        70
                                   13.4 Adaptplugins to use Authentication infrastructure . . . . . . . . . . . . . . . . . . . . . . . . .                                                                    73
                                   13.5 Authentication GUIs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .                                                                  74
                             14 Tasks - doing heavy work in the background                                                                                                                                     77
                                   14.1 Introduction                 .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  . . . . . . . . . . . .                77
                                   14.2 Exemples . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .                                                                 78
                             15 Développer des extensions Python                                                                                                                                               83
                                   15.1 Structuring Python Plugins . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .                                                                 83
                                   15.2 CodeSnippets . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .                                                                   91
                                   15.3 Using Plugin Layers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .                                                                  92
                                   15.4 IDEsettings for writing and debugging plugins . . . . . . . . . . . . . . . . . . . . . . . . . . .                                                                    93
                                   15.5 Releasing your plugin . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .                                                                  99
                             16 Créer une extension avec Processing                                                                                                                                          103
                             17 Bibliothèque d’analyse de réseau                                                                                                                                             105
                                   17.1 Information générale . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 105
                                   17.2 Construire un graphe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 106
                                   17.3 Analyse de graphe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 107
                             18 Extensions Python pour QGIS Server                                                                                                                                           113
                                   18.1 Architecture des extensions de filtre serveur . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 114
                                   18.2 Déclencher une exception depuis une extension . . . . . . . . . . . . . . . . . . . . . . . . . . . 115
                                   18.3 Écriture d’une extension serveur . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 115
                                   18.4 Extension de contrôle d’accès . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 119
                             19 Cheatsheet for PyQGIS                                                                                                                                                        123
                                   19.1 Interface utilisateur . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 123
                                   19.2 Réglages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 123
                                   19.3 Barres d’outils . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 123
                                   19.4 Menus . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 124
                                   19.5 Canevas . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 124
                                   19.6 Couches . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 124
                                   19.7 Table des matières . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 128
                                   19.8 Table des matières (avancé) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 128
                             ii