Microsoft Graph の Places API は、建物、部屋、デスク、ワークスペースなどの物理空間をorganization内で管理および操作するための統合された方法を提供します。
サポートされる種類
Places API では、次の種類がサポートされています。
配置の種類
[場所] は、テナント内のさまざまなスペースの種類を表します。 place オブジェクトには、次のいずれかの型を指定できます。
| 場所の種類 | 詳細 |
|---|---|
| 建物 | テナント内の建物を表し、名前、住所、地理的座標などのプロパティを持つ。 |
| 机 | 個々のデスクを表します。 セクションにデスクを追加する必要があります。 セクションのリッチ プロパティには、メール アドレス、モード、アクセシビリティが含まれます。 |
| 床 | name、parentId、sortOrder などのプロパティを含む、建物内のフロアを表します。 建物は常に床の親です。 |
| 部屋 | テナント内の部屋を表します。 すべての会議室が Exchange メールボックスに関連付けられている必要があります。 部屋はフロアまたはセクションに追加できます。 会議室の豊富なプロパティには、 会議室 のメール アドレス、アクセシビリティ、容量、オーディオ デバイス、ビデオ デバイスなどが含まれます。 |
| roomList | テナント内の会議室のコレクション。 Placesでは roomList がサポートされており、デスクトップやモバイル全体の従来の Outlook など、すべてのデバイス上のすべてのクライアントで Room Finder で会議室の予約が確実に機能します。 ただし、テナントで roomFinder を使用しない場合は、新しい場所の種類と階層に依存することをお勧めします。 roomList の詳細については、 roomList リソースの種類に関する ページを 参照してください。 |
| セクション | name、parentId、label などのプロパティを含む、フロア内のセクションを表します。 フロアは常にセクションの親です。 |
| ワークスペース | デスクのコレクションを表します。 すべてのワークスペースを Exchange メールボックスに関連付ける必要があります。 ワークスペースはセクションに追加できます。 ワークスペースのリッチ プロパティには、ワークスペース、モード、アクセシビリティ、容量のメール アドレスが含まれます。 |
マップ フィーチャタイプ
マップ フィーチャは、場所の対応するマップを表します。 マップ フィーチャ オブジェクトには、次のいずれかの種類を指定できます。
| マップ フィーチャの種類 | 詳細 |
|---|---|
| buildingMap | Placesの建物に関連付けられているマップ ファイルを表します。 このオブジェクトは、building.geojson の IMDF 形式の表現です。 |
| fixtureMap | iMDF 形式のフィクスチャ.geojson ファイルを表します。これは、スペース内の移動可能な物理資産または半永続的な物理資産を定義します。 これらの資産は、構造の整合性に影響を与えることなく、ユーティリティ、サービス、または審美的な機能をサポートします。 |
| footprintMap | 参照される建物のおおよその物理的範囲を定義する IMDF 形式の footprint.geojson ファイルを表 します。 |
| levelMap | 建物内の物理フロア構造を定義する、IMDF 形式の level.geojson ファイルを表 します。 |
| sectionMap | 建物の床のセクション (ゾーンやパーティションなど) を定義する、IMDF 形式の section.geojson ファイルを表 します。 |
| unitMap | 建物のフロアの単位 (部屋やオフィスなど) を定義する、IMDF 形式の unit.geojson ファイルを表 します。 |
Places API の使用
Places API を使用すると、適切な読み取りまたは書き込みアクセス許可を持つアプリケーションが place オブジェクトと対話できます。 すべての place オブジェクトには、 id、 placeId、 displayName などの基本的なプロパティが含まれています。 会議室、ワークスペース、デスクなどの高度な種類では、 mode、 emailAddress、 deviceInformation などのより多くのプロパティが提供されます。
Placesのマップ API を使用すると、適切な読み取りまたは書き込みアクセス許可を持つアプリケーションがマップフィーチャ オブジェクトと対話できるようになります。 各マップ フィーチャ オブジェクトには 、id などの基本的なプロパティと、 placeId、 geometry、display_pointなどのその他のプロパティ が含まれます。
各種類の詳細な説明については、それぞれのドキュメント セクションを参照してください。
Placesリスト API と子孫 API の前提条件
List place オブジェクトまたは場所: 子孫 API を使用する前に、Places設定が Microsoft 365 環境で適切に構成されていることを確認する必要があります。それ以外の場合は、次の設定手順が完了しない限り、これらの API は場所を返しません。
- MicrosoftPlaces PowerShell モジュールをダウンロードして接続します。 詳細については、「 Connect-MicrosoftPlaces」を参照してください。
- 次のコマンドを使用して建物を有効にして、場所を表示します。 詳細については、「 Set-PlacesSettings」を参照してください。
Set-PlacesSettings -EnableBuildings 'Default:true'
一般的なユース ケース
次の表に、Places API の一般的な使用方法をいくつか示します。
| ユース ケース | REST リソース | 関連項目 |
|---|---|---|
| 場所の作成と管理 | 場所 | place メソッド |
| 建物、床、セクション、部屋、部屋の一覧、ワークスペース、デスクなどの場所スペースと対話する | 場所 | place メソッド |
| 建物のマップ ファイルを取り込む | 建物 | マップ ファイルを取り込む |
| 建物内のレベルを一覧表示する | levelMap | レベルの一覧表示 |
| 建物内のフットプリントを一覧表示する | footprintMap | フットプリントを一覧表示する |
| buildingMap を取得および削除する | buildingMap | buildingMap メソッド |
| unitMap の作成と管理 | unitMap | unitMap メソッド |
| フィクスチャの作成と管理Map | fixtureMap | fixtureMap メソッド |
| セクションの作成と管理Map | sectionMap | sectionMap メソッド |
次の手順
Microsoft Graph Places API を使用して、さまざまな場所のエンティティと対話します。 詳細情報
- 自分のシナリオに最も役立つリソースと方法を検討する。
- Graph エクスプローラーで API を試す。