Performance élevée :

• Construit sur Starlette et Pydantic, il offre des performances proches de celles d'outils comme Node.js et Go.
• Idéal pour des applications nécessitant des réponses rapides, comme les appels API.
• Starlette est un framework léger et asynchrone pour développer des applications web en Python.
  Il se concentre sur les performances et la modularité, tout en respectant le standard ASGI (Asynchronous Server Gateway Interface).
• Pydantic est une bibliothèque Python utilisée pour la validation et la gestion des données structurées.
  Elle se base sur les annotations de type Python et offre une validation automatique des données d'entrée et de sortie.

Documentation automatique :

• Documentation interactive générée automatiquement à partir des types Python (OpenAPI et Swagger UI).
• Accessible via /docs.
• OpenAPI est une spécification standardisée pour décrire des APIs REST.
• Swagger UI est une interface utilisateur interactive permettant d'explorer, de tester et de documenter des APIs en utilisant la spécification OpenAPI.

Gestion des données structurées :

• Les modèles basés sur Pydantic assurent une validation stricte des entrées et des sorties JSON.

Middleware intégré :

• Par exemple, le middleware CORS (Cross-Origin Resource Sharing) est configuré pour permettre l'accès depuis d'autres domaines.

1. Recherche d'adresses avec l'API Addok :

• Endpoint : /api/v1/{adresse}
• Description : Envoie une requête à l'API publique Addok pour rechercher des adresses.
  Retourne des informations enrichies (latitude, longitude, score, ville, code postal, etc.).
• Utilisation typique : GET /api/v1/8 bd du port
  Réponse JSON structurée avec les coordonnées et détails de l'adresse.

2. Recherche des événements CatNat :

• Endpoint : /api/v1/catnat/
• Description : Interroge l'API Géorisques pour obtenir des informations sur les catastrophes naturelles dans un rayon défini autour d'une position géographique.
  Retourne une liste d'événements (type, date, gravité, etc.).
• Utilisation typique : GET /api/v1/catnat/?longitude=2.3522&latitude=48.8566&rayon=1000
  Réponse contenant les événements trouvés pour les coordonnées fournies.

1. Centralisation des données :

• Les utilisateurs accèdent à des informations variées (adresses, catastrophes naturelles, inondations, risques sismiques, cavités) via une seule API, simplifiant l'intégration des services.

2. Utilisation des données publiques :

• Les données issues des services Géorisques et d'autres APIs gouvernementales deviennent facilement exploitables.

3. Adaptabilité et extensibilité :

• L'API est conçue pour intégrer facilement d'autres sources de données gouvernementales, ajoutant des fonctionnalités au besoin.

API Addok (api-adresse.data.gouv.fr) :

• Objectif : Fournir une recherche d'adresses et de géocodage à partir de textes.
• Exemple : http://api-adresse.data.gouv.fr/search/?q=adresse
  Résultat : Liste des événements correspondant à une zone géographique donnée.

API CatNat (Géorisques - Ministère de la Transition écologique) :

• Objectif : Fournir des informations sur les zones à risque et les événements de catastrophes naturelles.
• Exemple : https://georisques.gouv.fr/api/v1/gaspar/catnat/?longitude=2.3522&latitude=48.8566&rayon=1000
  Résultat : Liste des événements correspondant à une zone géographique donnée.

API AZI (Aléa Zones Inondables) :

• Objectif : Fournir des informations sur les zones présentant un risque d’inondation.
• Exemple : https://georisques.gouv.fr/api/v1/azi
  Résultat : Aléa inondation, classe de risque, et détails par parcelle.

API Zonage Sismique :

• Objectif : Fournir des informations sur la classification sismique des zones en France.
• Exemple : https://georisques.gouv.fr/api/v1/zonage-sismique
  Résultat : Niveau de sismicité et description du zonage.

API Cavités :

• Objectif : Recenser les cavités souterraines (naturelles ou anthropiques) pouvant présenter un risque pour la stabilité des sols.
• Exemple : https://georisques.gouv.fr/api/v1/cavites
  Résultat : Liste des cavités recensées dans la zone, avec détails sur leur nature, origine, et risque associé.