Analyse Urbaine - Générateur de Rapports et Cartes

Ce projet permet de générer des rapports HTML et des cartes visuelles présentant les résultats d'analyse urbaine pour une ville donnée, à partir de données JSON et OpenStreetMap.

Note : Pour des instructions détaillées, consultez le Guide d'Utilisation Détaillé.

Fonctionnalités

• Génération de rapports HTML à partir de données JSON
• Visualisation des statistiques urbaines (routes, pistes cyclables, parkings, bâtiments, etc.)
• Génération de cartes visuelles des villes à partir de leur ID OpenStreetMap
• Utilisation du fond de carte Stamen Terrain pour une meilleure lisibilité
• Sélecteur de fonds de carte (Stamen Terrain, Stamen Toner, Stamen Watercolor, OpenStreetMap)
• Calcul automatique de ratios et d'indicateurs
• Templates personnalisables
• Interface responsive adaptée aux mobiles et ordinateurs

Prérequis

• Python 3.6 ou supérieur
• Jinja2 (pip install jinja2)
• Pour les cartes : OSMnx ou Folium (voir requirements.txt)

Installation

1. Clonez ce dépôt :

   git clone https://github.com/votre-utilisateur/analyse-urbaine.git
   cd analyse-urbaine
   

2. Installez les dépendances :

   pip install -r requirements.txt
   

3. Pour la conversion HTML vers JPG, installez l'un des outils suivants :

   • wkhtmltopdf/wkhtmltoimage : https://wkhtmltopdf.org/downloads.html
   • CutyCapt (pour Linux) : sudo apt-get install cutycapt
   • Playwright (recommandé) :

     pip install playwright
     playwright install
     

Utilisation

Génération d'un rapport HTML

python present.py <fichier_json> [fichier_html_sortie] [fichier_template]

Arguments :

• <fichier_json> : Chemin vers le fichier JSON contenant les données (obligatoire)
• [fichier_html_sortie] : Chemin où sauvegarder le fichier HTML (par défaut: resultat.html)
• [fichier_template] : Nom du fichier template à utiliser (par défaut: template.html)

Exemple

python present.py summary_results.json rapport_ville.html template_ameliore.html

Génération d'une carte de ville

python generate_city_map.py <osm_id> [options]

Arguments :

• <osm_id> : ID OpenStreetMap de la ville (obligatoire)
• -o, --output : Chemin où sauvegarder l'image
• --folium : Utiliser Folium au lieu d'OSMnx (plus léger mais moins détaillé)
• -v, --verbose : Afficher les messages de débogage

Exemple

python generate_city_map.py 123456 -o carte_ville.jpg

Utilisation avancée

Pour plus de contrôle, vous pouvez utiliser les scripts individuels :

1. Génération de carte avec OSMnx (haute qualité) :

   python map.py <osm_id> [-o output.jpg]
   

2. Génération de carte avec Folium (plus léger) :

   python map_simple.py <osm_id> [-o output.html]
   

3. Conversion d'une carte HTML en JPG :

   python html_to_jpg.py <fichier_html> [-o output.jpg] [-m méthode]
   

   Ou avec le nouveau script simplifié (recommandé) :

   python html2jpg.py <fichier_html> [-o output.jpg]
   

Test de la solution

Pour tester la solution avec des données fictives :

python test_present.py

Structure des données JSON

Le fichier JSON doit contenir les clés suivantes :

{
  "city_name": "Nom de la ville",
  "longueur_route_km": 228.33,
  "road_cycleway_km": 12.5,
  "compte_highways": 3530,
  "surface_route_km2": 1.59,
  "building_count": 2516,
  "building_area": 2.65,
  "building_sizes": [0, 10, 50, 100, 200, 500, "Infinity"],
  "building_size_counts": [120, 450, 780, 650, 400, 116],
  "compte_piste_cyclable": 42,
  "car_parking_capacity_provided": 491,
  "roundabout_count": 12,
  "mini_roundabout_count": 5,
  "surface_parking_km2": 0.35,
  "surface_bicycle_parking_km2": 0.042,
  "charging_stations": 14,
  "charging_stations_with_capacity_count": 12,
  "charging_stations_capacity_provided": 28,
  "charging_points": 32
}

Templates disponibles

• template.html : Template de base avec tableau simple
• template_ameliore.html : Template amélioré avec design moderne, cartes et visualisations

Personnalisation

Vous pouvez créer vos propres templates en vous basant sur les templates existants. Utilisez la syntaxe Jinja2 pour accéder aux données.

Trouver l'ID OpenStreetMap d'une ville

Méthode manuelle

1. Allez sur OpenStreetMap
2. Recherchez la ville souhaitée
3. Cliquez sur la ville dans les résultats
4. L'URL contiendra l'ID de la relation, par exemple : https://www.openstreetmap.org/relation/123456
5. L'ID est le nombre après "relation/" (ici, 123456)

Méthode automatique (recommandée)

Utilisez le script find_city_osm_id.py pour rechercher une ville par son nom et obtenir son ID de relation :

python find_city_osm_id.py "Nom de la ville"

Options disponibles :

• -c, --country : Filtrer par code pays (ex: fr, be, ch)
• -l, --limit : Nombre maximum de résultats (défaut: 5)
• -r, --relation-only : Afficher uniquement les IDs de relation
• -j, --json : Afficher les résultats au format JSON

Exemple :

python find_city_osm_id.py "Paris"

Licence

Ce projet est sous licence AGPLv3+.

Workflow recommandé pour générer une carte

Méthode simplifiée (recommandée)

Utilisez le script find_city_osm_id.py qui recherche et génère automatiquement la carte en une seule commande :

python find_city_osm_id.py "Nom de la ville" -c fr -o carte_ville.html

Pour convertir ensuite la carte HTML en image JPG :

python html2jpg.py carte_ville.html -o carte_ville.jpg

Cette méthode est la plus simple car elle :

• Recherche automatiquement l'ID OpenStreetMap de la ville
• Génère directement la carte HTML avec Folium
• Suggère la commande pour convertir en JPG

Méthode manuelle (étape par étape)

Si vous préférez contrôler chaque étape du processus :

Étape 1 : Trouver l'ID OpenStreetMap de la ville

Utilisez le script find_city_osm_id.py pour trouver l'ID de la ville par son nom, mais désactivez la génération automatique de carte :

python find_city_osm_id.py "Nom de la ville" -c fr -ng

Ou en ligne de commande pour obtenir directement l'ID :

ID=$(python find_city_osm_id.py "Nom de la ville" -c fr -r | head -n 1)

Étape 2 : Générer la carte HTML avec Folium

python generate_city_map.py <osm_id> -o carte_ville.html --folium

Étape 3 : Convertir la carte HTML en image JPG

python html2jpg.py carte_ville.html -o carte_ville.jpg

Workflow complet en une seule commande

Pour les utilisateurs avancés, voici comment combiner toutes les étapes en une seule commande :

python find_city_osm_id.py "Briis-sous-Forges" -c fr -o carte_ville.html && python html2jpg.py carte_ville.html -o carte_ville.jpg

Cette approche en une ou deux étapes est robuste et permet de générer des cartes pour n'importe quelle ville en connaissant simplement son nom.