Compartir a través de

Trabajar con la API de Places en Microsoft Graph

La API de Places de Microsoft Graph proporciona una manera unificada de administrar e interactuar con espacios físicos, como edificios, salas, escritorios y áreas de trabajo, dentro de una organización.

Tipos compatibles

Los siguientes tipos se admiten en la API de Places.

Colocar tipos

Place representa diferentes tipos de espacio dentro de un inquilino. Un objeto place puede ser uno de los siguientes tipos.

Tipo de lugar Detalles
edificio Representa un edificio dentro del inquilino y tiene propiedades como el nombre, la dirección y las coordenadas geográficas.
escritorio Representa escritorios individuales. Se debe agregar un escritorio a una sección. Las propiedades enriquecidas de la sección incluyen la dirección de correo electrónico, el modo y la accesibilidad.
piso Representa un piso dentro de un edificio, incluidas propiedades como name, parentId y sortOrder. Un edificio siempre es el elemento primario de un piso.
cuarto Representa una sala dentro del inquilino. Todas las salas deben estar asociadas a buzones de Exchange. Se puede agregar una habitación a un piso o a una sección. Las propiedades enriquecidas de la habitación incluyen una dirección de correo electrónico para la habitación, accesibilidad, capacidad, dispositivo de audio, dispositivo de vídeo, etc.
roomList Colección de habitaciones en el inquilino. Places admite roomList para garantizar que la reserva de habitaciones funciona en Room Finder en todos los clientes de todos los dispositivos, como Outlook clásico en escritorio y móvil.

Sin embargo, se recomienda confiar en los nuevos tipos de lugar y jerarquía si no usa roomFinder en el inquilino. Para obtener más información sobre roomList, consulte el tipo de recurso roomList .
section Representa una sección dentro de un piso, incluidas propiedades como name, parentId y label. Un piso siempre es el elemento primario de una sección.
área de trabajo Representa una colección de escritorios. Todas las áreas de trabajo deben estar asociadas a buzones de Exchange. Se puede agregar un área de trabajo a una sección. Las propiedades enriquecidas de un área de trabajo incluyen una dirección de correo electrónico para el área de trabajo, el modo, la accesibilidad y la capacidad.

Tipos de características de mapa

La característica de mapa representa el mapa correspondiente de un lugar. Un objeto de entidad de mapa puede ser uno de los siguientes tipos.

Tipo de característica de mapa Detalles
buildingMap Representa un archivo de mapa asociado a un edificio en Places. Este objeto es la representación en formato IMDF de building.geojson.
fixtureMap Representa un archivo fixture.geojson en formato IMDF que define los recursos físicos móviles o semi-permanentes dentro de un espacio. Estos recursos admiten funciones de utilidad, servicio o estética sin afectar a la integridad estructural.
footprintMap Representa un archivo footprint.geojson en formato IMDF que define la extensión física aproximada de un edificio al que se hace referencia.
levelMap Representa un archivo level.geojson en formato IMDF que define la estructura del suelo físico dentro de un edificio.
sectionMap Representa un archivo section.geojson en formato IMDF que define secciones (como zonas o particiones) en el suelo de un edificio.
unitMap Representa un archivo unit.geojson en formato IMDF que define unidades (como salas u oficinas) en un piso de un edificio.

Uso de la API de Places

La API de Places permite que las aplicaciones con permisos de lectura o escritura adecuados interactúen con objetos place. Cada objeto place incluye propiedades fundamentales como id, placeId y displayName. Los tipos más avanzados, como salas, áreas de trabajo y escritorios, ofrecen más propiedades como mode, emailAddress y deviceInformation.

Las API de mapa de Places permiten que las aplicaciones con permisos de lectura o escritura adecuados interactúen con objetos de características de mapa. Cada objeto de característica de mapa incluye propiedades fundamentales como id y otras propiedades como placeId, geometry y display_point.

Las descripciones detalladas de cada tipo están disponibles en sus respectivas secciones de documentación.

Requisitos previos para las API de lista y descendiente de Places

Para poder usar las API List place objects o place: descendants, debe asegurarse de que la configuración de Places esté configurada correctamente en el entorno de Microsoft 365; de lo contrario, estas API no devuelven ningún lugar a menos que se completen los pasos de configuración siguientes:

  1. Descargue y conéctese al módulo de PowerShell MicrosoftPlaces . Para obtener más información, consulte Connect-MicrosoftPlaces.
  2. Haga que los lugares sean visibles habilitando los edificios con el siguiente comando. Para obtener más información, vea Set-PlacesSettings. 
    Set-PlacesSettings -EnableBuildings 'Default:true'

Casos de uso comunes

En la tabla siguiente se enumeran algunos de los usos comunes de la API de Places.

Caso de uso Recurso REST Vea también
Creación y administración de un lugar lugar métodos place
Interactuar con espacios de colocación como edificio, piso, sección, sala, lista de salas, área de trabajo o escritorio lugar métodos place
Ingerir el archivo de mapa para un edificio edificio Ingesta del archivo de mapa
Enumerar los niveles de un edificio levelMap Niveles de lista
Enumerar las superficies de un edificio footprintMap Enumeración de superficies
Obtener y eliminar un buildingMap buildingMap métodos buildingMap
Creación y administración de un unitMap unitMap métodos unitMap
Creación y administración de un fixtureMap fixtureMap métodos fixtureMap
Creación y administración de un sectionMap sectionMap sectionMap (métodos)

Pasos siguientes

Use las API de Places de Microsoft Graph para interactuar con distintas entidades de ubicación. Para obtener más información:

  • Explore los recursos y los métodos que son más útiles para su escenario.
  • Pruebe la API en el Probador de Graph.
  • Last updated on