Location resource type

Namespace: microsoft.graph

Important

APIs under the /beta version in Microsoft Graph are subject to change. Use of these APIs in production applications is not supported. To determine whether an API is available in v1.0, use the Version selector.

Represents location information of an event.

There are multiple ways to create events in a calendar, for example, through an app using the create event REST API, or manually using the Outlook user interface. When you create an event using the user interface, you can specify the location as plain text (for example, "Harry's Bar"), or from the rooms list provided by Outlook, Bing Autosuggest, or Bing local search.

Depending on how an event is created, expect Outlook to set the read-only locationType property differently.

How event was created	Property	Expected value
create event REST API	locationType	default
User interface in Outlook	locationType	One of the following: default for a location entered as plain text. conferenceRoom for a room provided by the Outlook rooms list. Or, any of this list - homeAddress, businessAddress,geoCoordinates, streetAddress, hotel, restaurant, localBusiness, postalAddress - for a location from Bing Autosuggest or Bing local search.

Properties

Property	Type	Description
address	physicalAddress	The street address of the location.
coordinates	outlookGeoCoordinates	The geographic coordinates and elevation of the location.
displayName	String	The name associated with the location.
locationEmailAddress	String	Optional email address of the location.
locationUri	String	Optional URI representing the location.
locationType	locationType	The type of location. Possible values are: default, conferenceRoom, homeAddress, businessAddress,geoCoordinates, streetAddress, hotel, restaurant, localBusiness, postalAddress. Read-only.
uniqueId	String	For internal use only.
uniqueIdType	String	For internal use only.

Relationships

None.

JSON representation

The following JSON representation shows the resource type.

{
  "address": {"@odata.type": "microsoft.graph.physicalAddress"},
  "coordinates": {"@odata.type": "microsoft.graph.outlookGeoCoordinates"},
  "displayName": "string",
  "locationEmailAddress": "string",
  "locationType": "string",
  "locationUri": "string",
  "uniqueId": "string",
  "uniqueIdType": "string"
}