Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
L’API Places dans Microsoft Graph offre un moyen unifié de gérer et d’interagir avec les espaces physiques, tels que les bâtiments, les salles, les bureaux et les espaces de travail, au sein d’un organization.
Types pris en charge
Les types suivants sont pris en charge dans l’API Places.
Types de place
Place représente différents types d’espace au sein d’un locataire. Un objet place peut être l’un des types suivants.
| Type de place | Détails |
|---|---|
| bâtiment | Représente un bâtiment au sein du locataire et possède des propriétés telles que le nom, l’adresse et les coordonnées géographiques. |
| bureau | Représente des bureaux individuels. Un bureau doit être ajouté à une section. Les propriétés enrichies de la section incluent l’adresse e-mail, le mode et l’accessibilité. |
| sol | Représente un étage dans un bâtiment, y compris les propriétés telles que name, parentId et sortOrder. Un bâtiment est toujours le parent d’un étage. |
| chambre | Représente une salle dans le locataire. Toutes les salles doivent être associées aux boîtes aux lettres Exchange. Une pièce peut être ajoutée à un étage ou à une section. Les propriétés enrichies de la salle incluent une adresse e-mail pour la salle, l’accessibilité, la capacité, le périphérique audio, l’appareil vidéo, etc. |
| roomList | Collection de salles dans le locataire. Places prend en charge roomList pour s’assurer que la réservation de salles fonctionne dans Room Finder sur tous les clients sur tous les appareils, tels qu’Outlook classique sur ordinateur de bureau et mobile. Toutefois, nous vous recommandons de vous appuyer sur les nouveaux types de lieux et la nouvelle hiérarchie si vous n’utilisez pas roomFinder dans le locataire. Pour plus d’informations sur roomList, consultez le type de ressource roomList . |
| section | Représente une section dans un étage, y compris les propriétés telles que name, parentId et label. Un plancher est toujours le parent d’une section. |
| Espace | Représente une collection de bureaux. Tous les espaces de travail doivent être associés aux boîtes aux lettres Exchange. Un espace de travail peut être ajouté à une section. Les propriétés enrichies d’un espace de travail incluent une adresse e-mail pour l’espace de travail, le mode, l’accessibilité et la capacité. |
Types de caractéristiques de mappage
La fonctionnalité de carte représente la carte correspondante d’un lieu. Un objet de fonctionnalité de mappage peut être l’un des types suivants.
| Type de fonctionnalité mapper | Détails |
|---|---|
| buildingMap | Représente un fichier de carte associé à un bâtiment dans Places. Cet objet est la représentation au format IMDF de building.geojson. |
| fixtureMap | Représente un fichier fixture.geojson au format IMDF qui définit des ressources physiques mobiles ou semi-permanentes dans un espace. Ces ressources prennent en charge les fonctions utilitaires, de service ou esthétiques sans affecter l’intégrité structurelle. |
| footprintMap | Représente un fichier footprint.geojson au format IMDF qui définit l’étendue physique approximative d’un bâtiment référencé. |
| levelMap | Représente un fichier level.geojson au format IMDF qui définit la structure physique du plancher au sein d’un bâtiment. |
| sectionMap | Représente un fichier section.geojson au format IMDF qui définit des sections (telles que des zones ou des partitions) à l’étage d’un bâtiment. |
| unitMap | Représente un fichier unit.geojson au format IMDF qui définit des unités (telles que des salles ou des bureaux) sur un étage d’un bâtiment. |
Utilisation de l’API Places
L’API Places permet aux applications disposant d’autorisations de lecture ou d’écriture appropriées d’interagir avec des objets de place. Chaque objet place inclut des propriétés fondamentales telles que id, placeId et displayName. Les types plus avancés, tels que les salles, les espaces de travail et les bureaux, offrent davantage de propriétés telles que mode, emailAddress et deviceInformation.
Les API de carte dans Places permettent aux applications disposant d’autorisations de lecture ou d’écriture appropriées d’interagir avec les objets de fonctionnalité de carte. Chaque objet de fonctionnalité de mappage inclut des propriétés fondamentales telles que id et d’autres propriétés telles que placeId, geometry et display_point.
Des descriptions détaillées de chaque type sont disponibles dans leurs sections de documentation respectives.
Prérequis pour Places liste et les API descendantes
Avant de pouvoir utiliser les API Place list ou place : descendants, vous devez vous assurer que les paramètres de Places sont correctement configurés dans votre environnement Microsoft 365 ; sinon, ces API ne retournent aucun emplacement, sauf si les étapes de configuration suivantes sont effectuées :
- Téléchargez et connectez-vous au module PowerShell MicrosoftPlaces . Pour plus d’informations, consultez Connect-MicrosoftPlaces.
- Rendez les lieux visibles en activant les bâtiments avec la commande suivante. Pour plus d’informations, consultez Set-PlacesSettings.
Set-PlacesSettings -EnableBuildings 'Default:true'
Cas d’utilisation courants
Le tableau suivant répertorie certaines des utilisations courantes de l’API Places.
| Cas d’utilisation | Ressource REST | Voir aussi |
|---|---|---|
| Créer et gérer un emplacement | lieu | méthodes de place |
| Interagir avec les espaces tels que le bâtiment, l’étage, la section, la salle, la liste des salles, l’espace de travail ou le bureau | lieu | méthodes de place |
| Ingérer le fichier de carte pour un bâtiment | bâtiment | Ingérer un fichier de carte |
| Répertorier les niveaux d’un bâtiment | levelMap | Répertorier les niveaux |
| Lister les empreintes dans un bâtiment | footprintMap | Lister les empreintes |
| Obtenir et supprimer un buildingMap | buildingMap | méthodes buildingMap |
| Créer et gérer un unitMap | unitMap | méthodes unitMap |
| Créer et gérer un fixtureMap | fixtureMap | méthodes fixtureMap |
| Créer et gérer un sectionMap | sectionMap | méthodes sectionMap |
Étapes suivantes
Utilisez les API de Places Microsoft Graph pour interagir avec différentes entités de lieu. Pour en savoir plus :
- Explorez les ressources et les méthodes les plus utiles à votre scénario.
- Essayez l’API dans l’Afficheur Graph.