[Savoir] L’API Autodesk AEC Data Model

Avant de tout vous expliquer sur l’API Autodesk AEC Data Model, je fais quelques petits rappels et quelques définitions.

Tout d’abord, la société Autodesk propose des solutions cloud pour les différents domaines d’activités qu’elle couvre, telles que les plateformes collaboratives :

• Autodesk Forma pour l’architecture et la construction
• Autodesk Fusion pour la conception et fabrication de produits manufacturés
• Autodesk Flow pour l’industrie des médias et le divertissement

Ces trois plateformes sont basées sur une fondation appelée Autodesk Platform Services (APS) qui comprend un ensemble d’APIs et de services pour personnaliser les solutions, créer des workflows innovants, intégration d’autres outils basé sur les données hébergées.

Mais alors, en quoi consiste une API ?

Une API, ou Application Programming Interface, est un ensemble de routines, protocoles et outils pour construire des applications logicielles. Les API sont des outils pour les développeurs, les services et les applications logicielles, avec un public principal composé d’utilisateurs technologiquement avertis.

Dans ce contexte, Autodesk introduit une nouvelle API nommée Autodesk AEC Data Model. Celle-ci englobe un éventail de fonctionnalités et de structures de données qui instaurent un langage commun à travers le cycle de vie d’un projet, en reliant la planification, la conception, la construction et la gestion. Elle offre un accès libre aux données pour favoriser une collaboration transparente sur les données entre les outils spécialisés.

Autodesk AEC Data Model est basé sur GraphQL qui fournit un accès cloud direct aux données de conception granulaires sans qu’il soit nécessaire d’écrire des plugins d’application ou un traitement supplémentaire pour récupérer les données.

Pourquoi la nouvelle API Autodesk AEC Data Model ?

Avec l’émergence du BIM, du Big Data et de l’IoT, les fichiers gagnent en volume et requièrent des transformations, rallongeant ainsi les temps de partage et de synchronisation tout en consommant davantage de ressources. Cela nécessite de mettre en place des gestions complexes avec les multiples versions et variantes de fichiers en constante évolution.

En proposant l’API Autodesk AEC Data Model, Autodesk permet de rendre les données plus granulaires, interopérable et facilement accessible, ce qui permet aux utilisateurs de se connecter aux données spécifiques dont ils ont besoin, de manipuler aisément ces données à travers différents formats et types, et d’accéder aux données via des API sans nécessiter l’application originale de création.

Des données « granulaire » c’est quoi ?

Rendre un fichier granulaire implique de subdiviser des données volumineuses en éléments distincts et plus détaillés, permettant une analyse précise et une meilleure gestion des informations au niveau le plus fondamental.

Dans le contexte d’un fichier Revit, rendre un fichier granulaire signifie, par exemple, l’accès à des données spécifiques au sein d’un modèle Revit sans avoir à charger l’intégralité du fichier. Comme par exemple, extraire toutes les dimensions des portes constituant le fichier Revit.

Autodesk Data Model en s’appuyant sur GrapheQL permet d’interroger les données granulaires dans des fichiers propriétaires de type Revit et les gère à partir du cloud facilement et en toute sécurité. Pour permettre aux parties prenantes de créer plus rapidement, de manière plus efficace et plus écologique.

GraphQL, qu’est-ce que c’est ?

GraphQL est un langage de requête conçu pour les API qui permet une récupération efficace et précise des données. Il offre une très grande flexibilité dans la façon dont les données sont demandées et retournées, permettant aux utilisateurs de spécifier exactement quelles données ils souhaitent recevoir, réduisant ainsi le sur- et le sous-chargement des données. Cela est particulièrement avantageux dans les environnements cloud où l’efficacité et la performance sont critiques. Avec GraphQL, les développeurs peuvent construire des requêtes qui récupèrent des données de plusieurs ressources en une seule interaction réseau, ce qui améliore l’expérience utilisateur et réduit la latence.

Comme son nom l’indique, GraphQL est une technologie qui présente les données sous forme de graphe pour interroger et manipuler des données à travers une API, permettant une interaction plus intuitive et structurée avec les ensembles de données complexes.

Prenons l’exemple d’une simple maquette BIM, composée de murs, d’un toit et ouvertures.

Chaque objet BIM peut être réduit à leurs plus simples données intrinsèques.

Qui peuvent être rendues disponibles à tous les participants au projet suivant leurs besoins propres.

A l’aide d’une requête GraphQL utilisé par l‘API Autodesk Data Model les utilisateurs disposent instantanément des informations dont ils ont besoin.

Voici l’exemple ci-dessous :

Limitation de débit du service Autodesk Data Model.

Afin de maintenir la stabilité et d’assurer l’accessibilité de l’API à tous les utilisateurs, Autodesk mis en œuvre certaines mesures de protection sur les demandes entrantes vers l’API GraphQL via des limites de débit.

Autodesk a mis en place une limite basée sous forme de points prenant en compte la complexité de la requête. Par conséquent, il est essentiel de ne demander que les données que vous utiliserez réellement. Il existe également une limite au nombre total de points qu’une application ou une demande individuelle peut consommer en une minute.

• Une demande d’application aura une limite de débit par défaut de 6 000 points par minute. Pour demander une limite de débit plus élevée, veuillez contacter le support.
• Une demande individuelle a une limite de 1 000 points par requête. Toute requête dépassant cette limite sera rejetée.

Comment calculer la valeur de point d’une requête ?

Le point associé à une requête est calculé en additionnant les points de chaque champ de la requête. Ce calcul dépend du type de champ renvoyé. Les points suivants sont les valeurs par défaut attribuées à chaque type. Cependant, il est important de noter que les valeurs en points pour des champs individuels spécifiques peuvent varier, en étant soit supérieures, soit inférieures.

Ci-dessous, la liste de la valeur des points en fonction des demandes :

Dans le cas de dépassement, vous serez averti par un message (voir ci-dessous) :

Limitations connues :

• Les modèles Revit liés ne sont actuellement pas pris en charge
• La géométrie n’est actuellement pas prise en charge

Dans un prochain billet, je traiterai un exemple afin de vous montrer la prise en main de l’API Autodesk Data Model.