Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Die Places-API in Microsoft Graph bietet eine einheitliche Möglichkeit zum Verwalten und Interagieren mit physischen Räumen wie Gebäuden, Räumen, Schreibtischen und Arbeitsbereichen innerhalb eines organization.
Unterstützte Typen
Die folgenden Typen werden in der Places-API unterstützt.
Platzieren von Typen
Place stellt verschiedene Leerraumtypen innerhalb eines Mandanten dar. Ein place-Objekt kann einer der folgenden Typen sein.
| Ortstyp | Details |
|---|---|
| Gebäude | Stellt ein Gebäude innerhalb des Mandanten dar und verfügt über Eigenschaften wie Name, Adresse und geografische Koordinaten. |
| Schreibtisch | Stellt einzelne Schreibtische dar. Einem Abschnitt muss ein Schreibtisch hinzugefügt werden. Zu den umfassenden Eigenschaften des Abschnitts gehören E-Mail-Adresse, Modus und Barrierefreiheit. |
| Boden | Stellt eine Etage in einem Gebäude dar, einschließlich Eigenschaften wie name, parentId und sortOrder. Ein Gebäude ist immer das Übergeordnete einer Etage. |
| Zimmer | Stellt einen Raum innerhalb des Mandanten dar. Alle Räume müssen Exchange-Postfächern zugeordnet sein. Ein Raum kann einer Etage oder einem Abschnitt hinzugefügt werden. Zu den umfangreichen Eigenschaften des Raums gehören eine E-Mail-Adresse für den Raum, Barrierefreiheit, Kapazität, Audiogerät, Videogerät usw. |
| roomList | Eine Sammlung von Räumen im Mandanten. Places unterstützt roomList, um sicherzustellen, dass die Raumbuchung in Room Finder für alle Clients auf allen Geräten funktioniert, z. B. klassisches Outlook auf desktops und mobilen Geräten. Es wird jedoch empfohlen, sich auf die neuen Ortstypen und die neue Hierarchie zu verlassen, wenn Sie roomFinder nicht im Mandanten verwenden. Weitere Informationen zu roomList finden Sie unter dem Ressourcentyp roomList . |
| section | Stellt einen Abschnitt innerhalb einer Etage dar, einschließlich Eigenschaften wie Name, parentId und Bezeichnung. Eine Etage ist immer das übergeordnete Element eines Abschnitts. |
| Arbeitsbereich | Stellt eine Auflistung von Schreibtischen dar. Alle Arbeitsbereiche müssen Exchange-Postfächern zugeordnet sein. Einem Abschnitt kann ein Arbeitsbereich hinzugefügt werden. Zu den umfangreichen Eigenschaften eines Arbeitsbereichs gehören eine E-Mail-Adresse für den Arbeitsbereich, den Modus, die Barrierefreiheit und die Kapazität. |
Zuordnungsfeaturetypen
Das Kartenfeature stellt die entsprechende Karte eines Ortes dar. Ein Zuordnungsfeatureobjekt kann einer der folgenden Typen sein.
| Zuordnungsfeaturetyp | Details |
|---|---|
| buildingMap | Stellt eine Zuordnungsdatei dar, die einem Gebäude in Places zugeordnet ist. Dieses Objekt ist die IMDF-Formatdarstellung von building.geojson. |
| fixtureMap | Stellt eine fixture.geojson-Datei im IMDF-Format dar, die bewegliche oder semi-permanente physische Ressourcen innerhalb eines Raums definiert. Diese Ressourcen unterstützen Hilfs-, Dienst- oder ästhetische Funktionen, ohne die strukturelle Integrität zu beeinträchtigen. |
| footprintMap | Stellt eine footprint.geojson-Datei im IMDF-Format dar, die den ungefähren physischen Umfang eines Gebäudes definiert, auf das verwiesen wird. |
| levelMap | Stellt eine datei level.geojson im IMDF-Format dar, die die physische Bodenstruktur innerhalb eines Gebäudes definiert. |
| sectionMap | Stellt eine section.geojson-Datei im IMDF-Format dar, die Abschnitte (z. B. Zonen oder Partitionen) auf dem Boden eines Gebäudes definiert. |
| unitMap | Stellt eine unit.geojson-Datei im IMDF-Format dar, die Einheiten (z. B. Räume oder Büros) auf einer Etage eines Gebäudes definiert. |
Verwenden der Places-API
Die Places-API ermöglicht Es Anwendungen mit entsprechenden Lese- oder Schreibberechtigungen, mit Ortsobjekten zu interagieren. Jedes Place-Objekt enthält grundlegende Eigenschaften wie id, placeId und displayName. Erweiterte Typen wie Räume, Arbeitsbereiche und Schreibtische bieten weitere Eigenschaften wie mode, emailAddress und deviceInformation.
Die Zuordnungs-APIs in Places Anwendungen mit entsprechenden Lese- oder Schreibberechtigungen für die Interaktion mit Kartenfeatureobjekten ermöglichen. Jedes Kartenfeatureobjekt enthält grundlegende Eigenschaften wie id und andere Eigenschaften wie placeId, geometry und display_point.
Ausführliche Beschreibungen der einzelnen Typen finden Sie in den jeweiligen Dokumentationsabschnitten.
Voraussetzungen für Places Listen- und Nachfolger-APIs
Bevor Sie die APIs für List place objects oder place: descendants verwenden können, müssen Sie sicherstellen, dass Places Einstellungen in Ihrer Microsoft 365-Umgebung ordnungsgemäß konfiguriert sind. Andernfalls geben diese APIs keine Orte zurück, es sei denn, die folgenden Setupschritte sind abgeschlossen:
- Laden Sie das MicrosoftPlaces PowerShell-Modul herunter, und stellen Sie eine Verbindung mit diesem Modul her. Weitere Informationen finden Sie unter Connect-MicrosoftPlaces.
- Machen Sie Orte sichtbar, indem Sie Gebäude mit dem folgenden Befehl aktivieren. Weitere Informationen finden Sie unter Set-PlacesSettings.
Set-PlacesSettings -EnableBuildings 'Default:true'
Allgemeine Anwendungsfälle
In der folgenden Tabelle sind einige der allgemeinen Verwendungsmöglichkeiten für die Places-API aufgeführt.
| Anwendungsfall | REST-Ressource | Siehe auch |
|---|---|---|
| Erstellen und Verwalten eines Orts | Ort | Place-Methoden |
| Interagieren mit Ortsräumen wie Gebäude, Boden, Abschnitt, Raum, Raumliste, Arbeitsbereich oder Schreibtisch | Ort | Place-Methoden |
| Erfassen der Kartendatei für ein Gebäude | Gebäude | Erfassungszuordnungsdatei |
| Auflisten von Ebenen in einem Gebäude | levelMap | Listenebenen |
| Auflisten von Fußabdrucken in einem Gebäude | footprintMap | Auflisten von Fußabdrücken |
| Abrufen und Löschen einer buildingMap | buildingMap | buildingMap-Methoden |
| Erstellen und Verwalten einer unitMap | unitMap | unitMap-Methoden |
| Erstellen und Verwalten einer FixtureMap | fixtureMap | fixtureMap-Methoden |
| Erstellen und Verwalten einer sectionMap | sectionMap | sectionMap-Methoden |
Nächste Schritte
Verwenden Sie die Microsoft Graph-Places-APIs, um mit verschiedenen Ortsentitäten zu interagieren. So erhalten Sie weitere Informationen:
- Erfahren Sie, welche Ressourcen und Methoden für Ihr Szenario am besten geeignet sind.
- Probieren Sie die API im Graph-Tester aus.