place resource type

Namespace: microsoft.graph

Represents basic location attributes such as name, physical address, and geographic coordinates. This resource is the base type for richer location types such as room and roomList.

Using the places API

Exchange Online administrators can organize meeting rooms in a tenant into room lists. Using the places API, you can get all the room lists or rooms in the tenant, or get all the rooms in a specific room list.

Places like room and roomList contain the basic ID, display name, and email address. In addition, they contain navigational information like physical address and geographical coordinates, and in the case of rooms, other relevant information such as AV capabilities, floor number, and capacity.

The findRooms and findRoomLists functions support similar lookups for rooms and room lists in a tenant. The following table compares the places API and these functions.

Note: The findRooms and findRoomLists functions are deprecated.

Places API	findRooms and findRoomLists functions (deprecated)
Gets all the rooms or room lists in a tenant, and all the rooms in a room list.	Gets all the rooms or room lists in a tenant, and all the rooms in a room list.
List places can return more than 100 rooms in a tenant.	findRooms returns up to the first 100 rooms in a tenant.
Supports getting an individual room or room list in a tenant.	It doesn't support getting an individual room or room list in a tenant.
Defines the specific entities of room and roomList that specify a richer property set, in addition to the display name and SMTP address.	Each room and room list is of a lighter weight emailAddress type that specifies only the display name and SMTP address.
Supports only organizational scenarios with delegated (work or school accounts) or application permissions.	Supports only organizational scenarios with delegated or application permissions.
Supports updating an individual room or room list in a tenant.	Doesn't support updating an individual room or room list in a tenant.

Methods

Method	Return Type	Description
List places	A collection of the requested, derived type of place	Get a collection of the specified type of place objects defined in the tenant.
Get place	The requested, derived type of place	Get the properties and relationships of a specified place object.
Update place	The requested, derived type of place	Update the properties and relationships of a specified place object.

Properties

Property	Type	Description
address	physicalAddress	The street address of the place.
displayName	String	The name associated with the place.
geoCoordinates	outlookGeoCoordinates	Specifies the place location in latitude, longitude, and (optionally) altitude coordinates.
id	String	A unique identifier for the place. Read-only. This identifier isn't immutable and can change if there are changes to the mailbox or the tenant configuration. The beta version of this API has a new property added called placeId, which provides an immutable ID.
phone	String	The phone number of the place.

Relationships

None.

JSON representation

The following JSON representation shows the resource type.

{
  "address": {"@odata.type": "microsoft.graph.physicalAddress"},
  "displayName": "String",
  "id": "String (identifier)",
  "geoCoordinates": {"@odata.type": "microsoft.graph.outlookGeoCoordinates"},
  "phone": "String"
}

Related content

• For administrators to create a room list, use the Exchange PowerShell cmdlet New-DistributionGroup.
• For administrators to add a room to a room list, use the Exchange Powershell cmdlet Add-DistributionGroupMember.