Edit

place resource type

  • Article

Namespace: microsoft.graph

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. If you're creating a production app, choose the places API as the API is now generally available in v1.0. Plan to update any existing code that uses findRooms or findRoomLists to use the places API, because findRooms or findRoomLists will be deprecated, and a timeline will be announced.

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 Doesn't 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 that 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 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 Unique identifier for the place. Read-only.
phone String The phone number of the place.

Relationships

None.

JSON representation

Here's 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