Trabalhar com a API do Places no Microsoft Graph

A API do Places no Microsoft Graph fornece uma maneira unificada de gerenciar e interagir com espaços físicos, como edifícios, salas, mesas e espaços de trabalho, dentro de uma organização.

Tipos suportados

Os tipos a seguir são compatíveis com a API do Places.

Tipos de local

Local representa diferentes tipos de espaço dentro de um locatário. Um objeto de lugar pode ser um dos seguintes tipos.

Tipo de lugar Detalhes
habilidades técnicas Representa um edifício dentro do locatário e tem propriedades como nome, endereço e coordenadas geográficas.
escrivaninha Representa mesas individuais. Uma mesa deve ser adicionada a uma seção. As propriedades avançadas da seção incluem endereço de email, modo e acessibilidade.
de chão Representa um andar em um edifício, incluindo propriedades como name, parentId e sortOrder. Um edifício é sempre o pai de um andar.
Quarto Representa uma sala dentro do locatário. Todas as salas devem ser associadas a caixas de correio do Exchange. Uma sala pode ser adicionada a um andar ou a uma seção. As propriedades ricas da sala incluem um endereço de e-mail para a sala, acessibilidade, capacidade, dispositivo de áudio, dispositivo de vídeo e assim por diante.
roomList Uma coleção de salas no locatário. O Places oferece suporte ao roomList para garantir que a reserva de salas funcione no Localizador de Salas em todos os clientes em todos os dispositivos, como o Outlook clássico no desktop e no celular.

No entanto, recomendamos que você confie nos novos tipos de local e hierarquia se não usar roomFinder no locatário. Para obter mais informações sobre roomList, consulte o tipo de recurso roomList .
section Representa uma seção em um andar, incluindo propriedades como name, parentId e label. Um andar é sempre o pai de uma seção.
espaço de trabalho Representa um conjunto de mesas. Todos os workspaces devem ser associados a caixas de correio do Exchange. Um espaço de trabalho pode ser adicionado a uma seção. As propriedades avançadas de um espaço de trabalho incluem um endereço de email para o espaço de trabalho, modo, acessibilidade e capacidade.

Tipos de recursos de mapa

O recurso de mapa representa o mapa correspondente de um lugar. Um objeto de recurso de mapa pode ser um dos seguintes tipos.

Tipo de recurso de mapa Detalhes
buildingMap Representa um arquivo de mapa associado a um edifício no Places. Este objeto é a representação no formato IMDF de building.geojson.
Mapa de dispositivos Representa um arquivo fixture.geojson no formato IMDF que define ativos físicos móveis ou semipermanentes dentro de um espaço. Esses ativos dão suporte a funções de utilidade, serviço ou estética sem afetar a integridade estrutural.
footprintMap Representa um arquivo footprint.geojson no formato IMDF que define a extensão física aproximada de um edifício referenciado.
levelMap Representa um arquivo level.geojson no formato IMDF que define a estrutura física do piso dentro de um edifício.
sectionMap Representa um arquivo section.geojson no formato IMDF que define seções (como zonas ou partições) no andar de um edifício.
unitMap Representa um arquivo unit.geojson no formato IMDF que define unidades (como salas ou escritórios) em um andar de um edifício.

Usando a API do Places

A API do Places permite que aplicativos com permissões apropriadas de leitura ou gravação interajam com objetos de lugar. Cada objeto place inclui propriedades fundamentais, como id, placeId e displayName. Tipos mais avançados, como salas, espaços de trabalho e mesas, oferecem mais propriedades, como mode, emailAddress e deviceInformation.

As APIs de mapa no Places permitem que aplicativos com permissões apropriadas de leitura ou gravação interajam com objetos de recursos de mapa. Cada objeto de recurso de mapa inclui propriedades fundamentais, como id e outras propriedades, como placeId, geometria e display_point.

Descrições detalhadas de cada tipo estão disponíveis em suas respectivas seções de documentação.

Pré-requisitos para a lista de Places e APIs descendentes

Antes de usar as APIs List place objects ou place: descendentes, você deve garantir que as configurações do Places estejam configuradas corretamente em seu ambiente do Microsoft 365; caso contrário, essas APIs não retornarão nenhum Places, a menos que as seguintes etapas de configuração sejam concluídas:

  1. Baixe e conecte-se ao módulo MicrosoftPlaces PowerShell. Para obter mais informações, consulte Connect-MicrosoftPlaces.
  2. Torne os lugares visíveis ativando edifícios com o seguinte comando. Para obter mais informações, consulte Set-PlacesSettings. 
    Set-PlacesSettings -EnableBuildings 'Default:true'

Casos de uso comuns

A tabela a seguir lista alguns dos usos comuns da API do Places.

Caso de uso Recurso REST Confira também
Criar e gerenciar um local Local Métodos de colocação
Interaja com espaços de lugar, como edifício, piso, seção, sala, lista de salas, espaço de trabalho ou mesa Local Métodos de colocação
Ingerir o arquivo de mapa de um edifício habilidades técnicas Ingerir arquivo de mapa
Listar níveis em um edifício levelMap Níveis de lista
Listar pegadas em um edifício footprintMap Listar pegadas
Obter e excluir um buildingMap buildingMap métodos buildingMap
Criar e gerenciar um unitMap unitMap Métodos unitMap
Criar e gerenciar um fixtureMap Mapa de dispositivos métodos fixtureMap
Criar e gerenciar um sectionMap sectionMap métodos sectionMap

Próximas etapas

Use as APIs do Microsoft Graph Places para interagir com diferentes entidades de local. Para saber mais:

  • Explore os recursos e os métodos mais úteis para seu cenário.
  • Experimente a API no Explorador do Graph.
  • Last updated on