À propos de ce cours
Durée : 4 h en classe + travail personnel · Travail : en binôme · API : Open-Meteo (gratuite, sans clé, sans inscription).
Cahier des charges
L'application doit permettre de :
- Rechercher une ville par son nom (API de géocodage) et choisir parmi les résultats.
- Afficher la météo actuelle: température, vent, icône et description (« Ensoleillé », « Pluie »…).
- Afficher les prévisions sur 7 jours: jour, icône, minimum et maximum.
- Gérer les trois états sur chaque écran (chargement, erreur avec Réessayer, données) et le « tirer pour actualiser ».
- Enregistrer des villes favorites (SQLite du chapitre 22 ou
shared_preferences). - Fonctionner hors ligne en affichant la dernière météo en cache, avec la date de mise à jour.
- Respecter l'architecture en couches de la leçon 24.8.
Bonus : position actuelle avec le package geolocator, thème sombre, fond qui change selon la météo, animation Lottie, graphique des températures (package fl_chart).
Les endpoints à utiliser
| Besoin | URL |
|---|---|
| Rechercher une ville | https://geocoding-api.open-meteo.com/v1/search?name=Lyon&count=5&language=fr |
| Météo actuelle + 7 jours | https://api.open-meteo.com/v1/forecast?latitude=45.75&longitude=4.85¤t=temperature_2m,wind_speed_10m,weather_code&daily=weather_code,temperature_2m_max,temperature_2m_min&timezone=auto |
Dans la réponse, daily contient des listes parallèles: daily['time'][0], daily['temperature_2m_max'][0] et daily['weather_code'][0] concernent le même jour. Il faut les combiner dans une liste d'objets DailyForecast.
Code de départ fourni
// services/geocoding_service.dart
class City {
final String name, country;
final double latitude, longitude;
City({required this.name, required this.country, required this.latitude, required this.longitude});
factory City.fromJson(Map<String, dynamic> j) => City(
name: j['name'],
country: j['country'] ?? '',
latitude: (j['latitude'] as num).toDouble(),
longitude: (j['longitude'] as num).toDouble(),
);
}
Future<List<City>> searchCity(String query) async {
final uri = Uri.https('geocoding-api.open-meteo.com', '/v1/search',
{'name': query, 'count': '5', 'language': 'fr'});
final r = await http.get(uri).timeout(const Duration(seconds: 10));
if (r.statusCode != 200) throw ApiException('Recherche impossible');
final results = jsonDecode(r.body)['results'] as List<dynamic>?; // absent si aucun résultat
return (results ?? []).map((e) => City.fromJson(e)).toList();
}
// models/weather_code.dart : codes météo WMO utilisés par Open-Meteo
({String label, IconData icon}) describeWeather(int code) {
if (code == 0) return (label: 'Ciel dégagé', icon: Icons.wb_sunny);
if (code <= 3) return (label: 'Partiellement nuageux', icon: Icons.cloud_queue);
if (code == 45 || code == 48) return (label: 'Brouillard', icon: Icons.foggy);
if (code >= 51 && code <= 57) return (label: 'Bruine', icon: Icons.grain);
if (code >= 61 && code <= 67) return (label: 'Pluie', icon: Icons.umbrella);
if (code >= 71 && code <= 77) return (label: 'Neige', icon: Icons.ac_unit);
if (code >= 80 && code <= 82) return (label: 'Averses', icon: Icons.water_drop);
if (code >= 95) return (label: 'Orage', icon: Icons.thunderstorm);
return (label: 'Inconnu', icon: Icons.help_outline);
}
Déroulement conseillé
| Étape | Tâche | Leçons mobilisées |
|---|---|---|
| 1 (30 min) | Tester les deux URL dans le navigateur, dessiner les écrans sur papier | 24.2 |
| 2 (45 min) | Modèles City, CurrentWeather, DailyForecast + services |
24.3, 24.4 |
| 3 (1 h) | Écran de recherche + écran météo avec FutureBuilder |
24.5 |
| 4 (45 min) | Repository + cache hors ligne + favoris | 24.8, chap. 22 |
| 5 (1 h) | Finitions UI, gestion des erreurs, tests sur téléphone réel | toutes |
Livrables
- Le dépôt Git du projet avec un
README(captures d'écran, API utilisées, répartition du travail). - Une démonstration de 5 minutes, dont un test en mode avion.
Grille d'évaluation du projet (sur 20)
| Critère | Points |
|---|---|
| Recherche de ville fonctionnelle (y compris « aucun résultat ») | 3 |
| Météo actuelle et prévisions 7 jours correctes | 4 |
Modèles Dart propres (fromJson, types corrects) |
2 |
| Trois états gérés sur chaque écran + actualisation | 3 |
Architecture en couches respectée (aucun http dans les écrans) |
3 |
| Favoris et mode hors ligne | 2 |
| Qualité de l'interface et expérience utilisateur | 2 |
| Démonstration et README | 1 |
| Bonus (géolocalisation, graphique, animations…) | +2 |
Cet article vous a-t-il aidé ?
Merci pour votre avis sur cet article 🙏
Merci, votre message nous a bien été transmis 🙏
Cette leçon vous a été utile ? Partagez-la !