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.
Wichtig
Die APIs unter der /beta Version in Microsoft Graph können sich ändern. Die Verwendung dieser APIs in Produktionsanwendungen wird nicht unterstützt. Um festzustellen, ob eine API in v1.0 verfügbar ist, verwenden Sie die Version Selektor.
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 |
| Upsert-Orte | Ort | Upsert-Orte |
| 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 |
Vergleich Places-APIs mit findRooms und findRoomLists
Die Funktionen findRooms und findRoomLists unterstützen ähnliche Suchvorgänge für Räume und Raumlisten in einem Mandanten. In der folgenden Tabelle werden die Orte-API und diese Funktionen verglichen.
Hinweis
Die Funktionen findRooms und findRoomLists sind veraltet.
| Places-API | findRooms- und findRoomLists-Funktionen (veraltet) |
|---|---|
| Ruft alle Räume oder Raumlisten in einem Mandanten und alle Räume in einer Raumliste ab. | Ruft alle Räume oder Raumlisten in einem Mandanten und alle Räume in einer Raumliste ab. |
| Die Liste kann mehr als 100 Räume in einem Mandanten zurückgeben. | findRooms gibt bis zu den ersten 100 Räumen in einem Mandanten zurück. |
| Unterstützt das Abrufen eines einzelnen Raums oder einer Raumliste in einem Mandanten. | Unterstützt nicht das Abrufen eines einzelnen Raums oder einer Raumliste in einem Mandanten. |
| Definiert die spezifischen Entitäten von room und roomList , die zusätzlich zum Anzeigenamen und der SMTP-Adresse einen umfangreicheren Eigenschaftensatz angeben. | Jede Raum- und Raumliste weist einen leichteren emailAddress-Typ auf, der nur den Anzeigenamen und die SMTP-Adresse angibt. |
| Unterstützt nur Organisationsszenarien mit delegierten (nur für Geschäfts-, Schul- oder Unikonten) oder Anwendungsberechtigungen. | Unterstützt nur Organisationsszenarien mit delegierten oder Anwendungsberechtigungen. |
| Unterstützt das Aktualisieren eines einzelnen Raums oder einer Raumliste in einem Mandanten. | Die Aktualisierung eines einzelnen Raums oder einer Raumliste in einem Mandanten wird nicht unterstützt. |
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.