Arbeiten mit der Places-API in Microsoft Graph

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 zur Verwaltung von und Interaktion mit physischen Räumen wie Gebäuden, Räumen, Schreibtischen und Arbeitsbereichen innerhalb einer organization.

Unterstützte Typen

Die folgenden Typen werden in der Places-API unterstützt.

Ortstypen

Platz steht für verschiedene Raumtypen innerhalb eines Mieters. Ein Ortsobjekt kann eine der folgenden Typen aufweisen.

Ortstyp Details
Gebäude Stellt ein Gebäude innerhalb des Mieters dar und verfügt über Eigenschaften wie Name, Adresse und geografische Koordinaten.
Schreibtisch Stellt einzelne Schreibtische dar. Ein Schreibtisch muss zu einem Abschnitt hinzugefügt werden. Zu den umfangreichen Eigenschaften des Abschnitts gehören E-Mail-Adresse, Modus und Barrierefreiheit.
Etage Stellt eine Etage innerhalb eines Gebäudes dar, einschließlich Eigenschaften wie name, parentId und sortOrder. Ein Gebäude ist immer das übergeordnete Element eines Stockwerks.
Zimmer Stellt einen Raum innerhalb des Mieters dar. Alle Räume müssen Exchange-Postfächern zugeordnet sein. Ein Raum kann zu einer Etage oder zu 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 Mieter. Places unterstützt die Raumliste, um sicherzustellen, dass die Raumbuchung in der Raumsuche auf allen Clients auf allen Geräten funktioniert, z. B. klassisches Outlook auf Desktops und Mobilgeräten.

Wir empfehlen jedoch, dass Sie sich auf die neuen Ortstypen und die neue Hierarchie 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 Label. Ein Stockwerk ist immer das übergeordnete Element eines Abschnitts.
Arbeitsbereich Stellt eine Sammlung 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.

Zuordnen von Featuretypen

Das Karten-Feature stellt die entsprechende Karte eines Ortes dar. Ein Karten-Feature-Objekt kann einer der folgenden Typen aufweisen.

Typ des Zuordnungsfeatures Details
buildingMap Stellt eine Kartendatei 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 Assets innerhalb eines Raums definiert. Diese Anlagen unterstützen Utility-, Service- oder ästhetische Funktionen, ohne die strukturelle Integrität zu beeinträchtigen.
footprintMap Stellt eine footprint.geojson-Datei im IMDF-Format dar, die die ungefähre physische Ausdehnung eines referenzierten Gebäudes definiert.
levelMap Stellt eine level.geojson-Datei im IMDF-Format dar, die die physische Bodenstruktur innerhalb eines Gebäudes definiert.
sectionMap Stellt eine Datei section.geojson im IMDF-Format dar, die Abschnitte (z. B. Zonen oder Trennwände) 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 Anwendungen mit entsprechenden Lese- oder Schreibberechtigungen die Interaktion mit Place-Objekten. 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 Karten-APIs in Places ermöglichen Anwendungen mit entsprechenden Lese- oder Schreibberechtigungen die Interaktion mit Karten-Feature-Objekten. Jedes Karten-Feature-Objekt enthält grundlegende Eigenschaften wie id und andere Eigenschaften wie placeId, geometry und display_point.

Detaillierte Beschreibungen der einzelnen Typen finden Sie in den jeweiligen Dokumentationsabschnitten.

Voraussetzungen für die Liste "Places" und Nachfolger-APIs

Bevor Sie die List place-Objekte oder die Place:-Nachkommen-APIs verwenden können, müssen Sie sicherstellen, dass die Places-Einstellungen in Ihrer Microsoft 365-Umgebung ordnungsgemäß konfiguriert sind. Andernfalls geben diese APIs keine Orte zurück, es sei denn, die folgenden Einrichtungsschritte sind abgeschlossen:

  1. Laden Sie das PowerShell-Modul MicrosoftPlaces herunter, und stellen Sie eine Verbindung her. Weitere Informationen finden Sie unter Connect-MicrosoftPlaces.
  2. 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 häufigsten Verwendungsmöglichkeiten für die Places-API aufgeführt.

Anwendungsfall REST-Ressource Siehe auch
Erstellen und Verwalten eines Ortes place place-Methoden
Interagieren Sie mit Ortsräumen wie Gebäude, Etage, Abschnitt, Raum, Raumliste, Arbeitsbereich oder Schreibtisch place place-Methoden
Upsert von Orten place Upsert von Orten
Aufnehmen der Kartendatei für ein Gebäude Gebäude Zuordnungsdatei erfassen
Listen von Ebenen in einem Gebäude levelMap Listenebenen
Auflisten von Fußabdrücken in einem Gebäude footprintMap Fußabdrücke auflisten
Abrufen und Löschen einer Gebäudekarte 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 von Places-APIs mit findRooms und findRoomLists

Die Funktionen findRooms und findRoomLists unterstützen ähnliche Suchen nach Räumen und Raumlisten in einem Mandanten. In der folgenden Tabelle werden die Places-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.
Liste können 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. Jeder Raum und jede Raumliste ist von einem leichteren emailAddress-Typ , der nur den Anzeigenamen und die SMTP-Adresse angibt.
Unterstützt nur organisatorische Szenarien mit delegierten (nur für Geschäfts-, Schul- oder Unikonten) oder Anwendungsberechtigungen. Unterstützt nur Organisationsszenarien mit delegierten oder Anwendungsberechtigungen.
Unterstützt die Aktualisierung eines einzelnen Raums oder einer Raumliste in einem Mandanten. Das Aktualisieren 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.
  • Last updated on