Edit

Location resource type

  • Article

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.

JSON representation

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