Le portail francophone de la géomatique

Bonjour,

I - la documentation
-----------------------

- La documentation officielle la plus à jour est traduite par des membres de l'OSGEO-fr à http://docs.qgis.org/2.2/fr/docs/pyqgis … _cookbook/
- il y a aussi le livre du "créateur" de QGIS (Gary Sherman),  "PyQGIS Programmer's guide" chez  https://locatepress.com/ppg

Cependant, pour un programmeur Python, habitué à sa simplicité et à l'utilisation d'autres modules spatiaux, la manière d'expliquer les choses est rendue complexe à souhait alors qu'il y a moyen de simplifier le tout  de manière plus "Pythonesque"  (voir chez les voisins http://www.forumsig.org/showthread.php/ … -le-retour).  La raison est historique : l'API de QGIS est une API SIP, générée à partir de l'API C++, d'où le renvoi à l'API C++ pour les détails.

Alors, dans le détail:

1) contrairement à ce qu'il est souvent dit, il faut bien connaître et comprendre Python avant de commencer (le traitement des listes en Python, par exemple)
2) il y a trois moyens d'utiliser Python dans QGIS:
a) dans la console Python,
b) dans un Plugin 
c)  dans un script de la Boîte à outils de Traitement (Processing)
3) la solution a) est la plus facile pour commencer et apprendre les principes, c) ne nécessite pas de connaître PyQT4 pour créer un interface  et b) est la plus complexe (PyQGIS + PyQT4)

Malheureusement, les fonctions Python utilisées dans a), b) et c) pour traiter les données ne sont pas tout à fait les mêmes, mais une fois qu'on a bien compris a), c'est facile de passer aux autres (ce sont les mêmes principes).

La majorité des utilisateurs  a tendance à choisir directement  la solution Plugin (pour avoir un bel interface, c'est ce que les gens demandent) sans réellement avoir compris a), ni PyQT4 (car il y a un livre de recettes tout fait pour créer un Plugin)

II  l'apprentissage
---------------------

Ici, si on veut le faire de manière sérieuse, il n'y a malheureusement pas de solution  tout faite. Il faut farfouiller dans les exemples dans

- http://gis.stackexchange.com/questions qui est le site de questions/réponses international le plus important: il y a moyen de trouver de nombreux exemples sur PyQGIS et des cas pratiques.
- de nombreux sites comme le http://www.portailsig.org/ offrent aussi des exemples de traitements. (il y en a d'autres)

Je constate néanmoins que, si l'on connaît bien Python, il n'y a pas de grosses difficultés à utiliser la documentation de l'API C++ comme aide (les classes et les fonctions sont les mêmes). De plus, si on a la chance de maîtriser d'autres modules spatiaux (comme osgeo, Shapely, Fiona, Pyshp ...), c'est facile.

III Conclusions
------------------

Pourquoi n'existe-t-il  rien de plus concret, comme dans le cas d'ArcPy, par exemple ?

Car il faut du temps, des volontaires et éventuellement de l'argent. Ce n'est donc pas une question de volonté mais de capacité. Il existe 2 livres dans le domaine géospatial  OpenSource avec Python:

- https://www.packtpub.com/python-geospat … pment/book
- http://www.packtpub.com/learning-geospa … ython/book

Euh ... excusez moi ... je ne vois pas clairement où se situe la documentation de l'API C++ ... quelqu'un peut-il m'aiguiller ?
Merci d'avance.

Ah euh ... j'étais déjà dedans alors ... j'avais cru comprendre qu'il y avait une documentation de l'API C++ différente et plus explicite(...) que la documentation Python ...