place resource type

Important

APIs under the /beta version in Microsoft Graph are subject to change. Use of these APIs in production applications is not supported.

Represents basic location attributes such as name, physical address, and geographic coordinates. This 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 lookup for rooms and room lists in a tenant. The following is a comparison between the places API and these functions.

Places API findRooms and findRoomLists functions
Supports getting all the rooms or room lists in a tenant, and all the rooms in a room list Similar support - get 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 Does not support getting an individual room or room list in a tenant
Defines the specific entities of room and roomList which 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 which specifies only the display name and SMTP address
Supports only organizational scenarios with delegated (work or school accounts) or application permissions Similar support for only organizational scenarios with delegated or application permissions
Supports updating an individual room or room list in a tenant Does not 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 Unique identifier for the place. Read-only.
phone String The phone number of the place.

Relationships

None.

JSON representation

The following is a JSON representation of the resource.

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

See also