Примечание.
Для доступа к этой странице требуется авторизация. Вы можете попробовать войти или изменить каталоги.
Для доступа к этой странице требуется авторизация. Вы можете попробовать изменить каталоги.
API Places в Microsoft Graph предоставляет единый способ управления физическими пространствами, такими как здания, комнаты, столы и рабочие области, и взаимодействовать с ними в организации.
Поддерживаемые типы
В API Places поддерживаются следующие типы.
Типы мест
Место представляет различные типы пространства в клиенте. Объект place может быть одного из следующих типов.
| Тип места | Сведения |
|---|---|
| здание | Представляет здание в клиенте и имеет такие свойства, как имя, адрес и географические координаты. |
| стол | Представляет отдельные столы. В раздел необходимо добавить стол. К расширенным свойствам раздела относятся адрес электронной почты, режим и специальные возможности. |
| этаж | Представляет этаж в здании, включая такие свойства, как name, parentId и sortOrder. Здание всегда является родителем этажа. |
| комната | Представляет комнату в клиенте. Все комнаты должны быть связаны с почтовыми ящиками Exchange. Комнату можно добавить на этаж или в раздел. К расширенным свойствам комнаты относятся адрес электронной почты комнаты, специальные возможности, емкость, аудиоустройство, видеоустройство и т. д. |
| roomList | Коллекция комнат в клиенте. Places поддерживает roomList, чтобы резервирование номеров работало в Поиске помещений на всех клиентах на всех устройствах, таких как классический Outlook на настольных и мобильных устройствах. Однако рекомендуется полагаться на новые типы мест и иерархию, если вы не используете roomFinder в клиенте. Дополнительные сведения о roomList см. в разделе Тип ресурса roomList . |
| section | Представляет раздел в полу, включая такие свойства, как name, parentId и label. Этаж всегда является родительским элементом секции. |
| рабочая область | Представляет коллекцию столов. Все рабочие области должны быть связаны с почтовыми ящиками Exchange. Рабочую область можно добавить в раздел. К расширенным свойствам рабочей области относятся адрес электронной почты рабочей области, режим, специальные возможности и емкость. |
Сопоставление типов признаков
Функция карты представляет соответствующую карту места. Объект функции карты может быть одного из следующих типов.
| Тип функции сопоставления | Сведения |
|---|---|
| BuildingMap | Представляет файл карты, связанный со зданием в Places. Этот объект представляет собой представление building.geojson в формате IMDF. |
| fixtureMap | Представляет файл fixture.geojson в формате IMDF, который определяет перемещаемые или полупостоясные физические ресурсы в пространстве. Эти ресурсы поддерживают служебные, служебные или эстетические функции, не влияя на структурную целостность. |
| FootprintMap | Представляет файл footprint.geojson в формате IMDF, который определяет приблизительный физический экстент указанного здания. |
| levelMap | Представляет файл level.geojson в формате IMDF, который определяет физическую структуру пола в здании. |
| sectionMap | Представляет файл section.geojson в формате IMDF, который определяет секции (например, зоны или секции) на этаже здания. |
| unitMap | Представляет файл unit.geojson в формате IMDF, который определяет единицы (например, комнаты или офисы) на этаже здания. |
Использование API Places
API Places позволяет приложениям с соответствующими разрешениями на чтение или запись взаимодействовать с объектами place. Каждый объект place включает в себя основные свойства, такие как id, placeId и displayName. Более сложные типы, такие как комнаты, рабочие области и столы, предоставляют дополнительные свойства, такие как mode, emailAddress и deviceInformation.
API-интерфейсы сопоставления в Places позволяют приложениям с соответствующими разрешениями на чтение или запись взаимодействовать с объектами признаков карты. Каждый объект признаков карты включает в себя фундаментальные свойства, такие как id, и другие свойства, такие как placeId, geometry и display_point.
Подробные описания каждого типа доступны в соответствующих разделах документации.
Предварительные требования для Places списков и api-интерфейсов потомков
Прежде чем использовать API-интерфейсы перечисления объектов place или place: потомков, необходимо убедиться, что параметры Places правильно настроены в среде Microsoft 365. В противном случае эти API не возвращают места, если не будут выполнены следующие действия по настройке.
- Скачайте модуль MicrosoftPlaces PowerShell и подключитесь к нему. Дополнительные сведения см. в разделе Connect-MicrosoftPlaces.
- Сделайте места видимыми, включив здания с помощью следующей команды. Дополнительные сведения см. в разделе Set-PlacesSettings.
Set-PlacesSettings -EnableBuildings 'Default:true'
Основные варианты использования
В следующей таблице перечислены некоторые распространенные способы использования API Places.
| Вариант использования | Ресурс REST | См. также |
|---|---|---|
| Создание места и управление им | место | Методы place |
| Взаимодействие с пространствами, такими как здание, этаж, раздел, комната, список комнат, рабочая область или стол | место | Методы place |
| Прием файла карты для здания | здание | Прием файла карты |
| Перечисление уровней в здании | levelMap | Уровни списка |
| Вывод списка занимаемых помещений в здании | FootprintMap | Вывод списка занимаемых площадей |
| Получение и удаление объекта buildingMap | BuildingMap | Методы buildingMap |
| Создание unitMap и управление ею | unitMap | Методы unitMap |
| Создание fixtureMap и управление ею | fixtureMap | методы fixtureMap |
| Создание разделаMap и управление им | sectionMap | Методы sectionMap |
Дальнейшие действия
Используйте API-интерфейсы Microsoft Graph Places для взаимодействия с различными сущностями мест. Чтобы узнать больше:
- Изучите ресурсы и методы, наиболее полезные для вашего сценария.
- опробуйте API в песочнице Graph.