Utiliser une API et des bibliothèques
- Fiche de cours
- Quiz et exercices
- Vidéos et podcasts
- Comprendre comment utiliser une API.
- Comprendre comment utiliser une bibliothèque.
- Une API est une interface qui permet aux développeurs d’intégrer à leurs projets des applications et des données.
- Une bibliothèque est un ensemble de fonctions déjà codées que les développeurs peuvent directement utiliser.
- Avant d’utiliser une API ou une bibliothèque, il est nécessaire d’en lire la documentation.
Savoir s’informer sur une bibliothèque Python.
Les utilisateurs ne sont pas obligés de comprendre comment les API sont codées. Ils doivent juste savoir trouver la documentation nécessaire à leur utilisation.
L’accès aux services des API est libre ou payante. Cela dépend de leur objet ainsi que de la nature de l’accès que l’on veut (nombre d’accès, quantité de données, vitesse, etc.).
Les API permettent souvent de faire des requêtes HTTP pour récupérer des données via le web (température dans une ville, coordonnées GPS, images, etc.). Ces données sont généralement formatées au format JSON ou XML.
Il n’y a pas de méthode générale pour utiliser une API. L’essentiel est d’en récupérer la documentation et d’étudier les exemples proposés pour les adapter à ses propres projets. Chaque API propose un site web dans lequel on peut trouver toutes ces informations.
Lorsque l’on veut utiliser une API avec Python, on peut utiliser le module urllib de la bibliothèque standard pour effectuer les requêtes HTTP.
Infoclimat est un site gratuit dont le but est de fournir des informations météorologiques en temps réel en France et dans une partie de l’Europe à partir d’un maillage de stations météo.
Ce site propose une API pour obtenir des prévisions météo à 7 jours.
On trouve son site à l’adresse : https://www.infoclimat.fr/.
Pour l’utiliser, il faut procéder de la manière suivante.
- Créer un compte (ce n’est pas obligatoire mais conseillé pour retrouver ses informations).
- Choisir « Toutes les villes » dans l’onglet « Prévision ».
- Renseigner le nom de la ville, par exemple « Lille ».
- Une page web s’affiche avec des prévisions météo à 7 jours pour la ville de Lille.
Précision à 7 jours pour la ville de Lille
- En bas de la page, cliquer sur le lien « Ces prévisions météo sur votre site ».
- Une nouvelle page web s’affiche avec
plusieurs codes qui permettent d’utiliser et/ou
d’afficher les prévisions
météo dans des projets informatiques.
On y trouve :- une balise iframe pour intégrer ces prévisions sur un site web avec un simple copier/coller du code ;
- une API XML pour récupérer les prévisions au format XML ;
- une API JSON pour récupérer les prévisions au format JSON.
Par exemple, avec l’API JSON, pour récupérer le dictionnaire Python de ces prévisions, on peut utiliser les modules urllib et json de la manière suivante.
Les données ainsi récupérées sont denses et complexes. Une analyse de leur contenu est nécessaire pour pouvoir les utiliser.
Le langage Python est libre et a une communauté très active. Il existe de nombreuses bibliothèques pour ce langage. Il convient toutefois d'être vigilant à ce que les bibliothèques utilisées soient de qualité et, au mieux, fassent ce que l’on veut. Il peut en effet être pertinent d’effectuer des tests et/ou d’en lire les codes avant utilisation. La qualité des bibliothèques est très variable.
Voici quelques bibliothèques intéressantes qui ne sont pas dans la bibliothèque standard de Python.
- Pillow ou PIL : Création et manipulation d’images
- scikit-learn : Machine learning (IA)
- folium : Cartographie
- pandas : Tableur sous Python
- numpy : Traitement scientifique de données
- …
Lorsque l’on veut utiliser une bibliothèque qui n’est pas dans la bibliothèque standard de Python, il faut procéder de la manière suivante.
- Installer la bibliothèque à partir
d’un terminal de votre système
d’exploitation grâce à la ligne de
code :
pip install nom_de_la_bibliothèque
- Dans la console Python, charger la nouvelle
bibliothèque pour tester si elle est bien
installée avec l’instruction :
import nom_de_la_bibliothèque
- En cas d’erreur, réessayer de l’installer.
- S’il n’y a pas d’erreur, la fonction help() permet d’obtenir la documentation de la bibliothèque en tapant help(nom_de_la_bibliothèque) dans la console Python.
Les bibliothèques les plus utilisées sont accompagnées de sites web dans lesquels on peut trouver une documentation détaillée et des exemples.
En utilisant une API, le code source n’intéresse pas les développeurs. C’est juste l'accès au service qui nous intéresse. L’utilisation d’une bibliothèque n’exclut en revanche pas de s'intéresser au code source. C’est d’ailleurs recommandé pour mieux l’utiliser et comprendre ses fonctions.
Folium est une bibliothèque Python qui permet de créer des cartes interactives.
On trouve son site à l’adresse :
http://python-visualization.github.io/folium/.
On y trouve un sommaire avec :
- une partie installing pour savoir comment installer folium ;
- une partie quickstart pour aider à la prise en main de la bibliothèque.
Par exemple, le code suivant permet de créer un fichier html permettant d’afficher dans un navigateur une carte interactive centrée sur la ville de Portland (de coordonnées GPS 45.5236 et –122.6750).
Le fichier html créé se nomme ma_carte.html et se trouve dans le même dossier que le fichier Python du code précédent.
La carte créée est la suivante.
Carte interactive centrée sur la ville de Portland
Des quiz et exercices pour mieux assimiler sa leçon
La plateforme de soutien scolaire en ligne myMaxicours propose des quiz et exercices en accompagnement de chaque fiche de cours. Les exercices permettent de vérifier si la leçon est bien comprise ou s’il reste encore des notions à revoir.
Des exercices variés pour ne pas s’ennuyer
Les exercices se déclinent sous toutes leurs formes sur myMaxicours ! Selon la matière et la classe étudiées, retrouvez des dictées, des mots à relier ou encore des phrases à compléter, mais aussi des textes à trous et bien d’autres formats !
Dans les classes de primaire, l’accent est mis sur des exercices illustrés très ludiques pour motiver les plus jeunes.
Des quiz pour une évaluation en direct
Les quiz et exercices permettent d’avoir un retour immédiat sur la bonne compréhension du cours. Une fois toutes les réponses communiquées, le résultat s’affiche à l’écran et permet à l’élève de se situer immédiatement.
myMaxicours offre des solutions efficaces de révision grâce aux fiches de cours et aux exercices associés. L’élève se rassure pour le prochain examen en testant ses connaissances au préalable.
Des vidéos et des podcasts pour apprendre différemment
Certains élèves ont une mémoire visuelle quand d’autres ont plutôt une mémoire auditive. myMaxicours s’adapte à tous les enfants et adolescents pour leur proposer un apprentissage serein et efficace.
Découvrez de nombreuses vidéos et podcasts en complément des fiches de cours et des exercices pour une année scolaire au top !
Des podcasts pour les révisions
La plateforme de soutien scolaire en ligne myMaxicours propose des podcasts de révision pour toutes les classes à examen : troisième, première et terminale.
Les ados peuvent écouter les différents cours afin de mieux les mémoriser en préparation de leurs examens. Des fiches de cours de différentes matières sont disponibles en podcasts ainsi qu’une préparation au grand oral avec de nombreux conseils pratiques.
Des vidéos de cours pour comprendre en image
Des vidéos de cours illustrent les notions principales à retenir et complètent les fiches de cours. De quoi réviser sa prochaine évaluation ou son prochain examen en toute confiance !