Compartilhar via

Trabalhar com a API de Places no Microsoft Graph

A API de Places no Microsoft Graph fornece uma forma unificada de gerir e interagir com espaços físicos, como edifícios, salas, secretárias e áreas de trabalho, dentro de uma organização.

Tipos suportados

Os seguintes tipos são suportados na API Places.

Tipos de local

Place representa diferentes tipos de espaço dentro de um inquilino. Um objeto de local pode ser um dos seguintes tipos.

Tipo de local Detalhes
edifício Representa um edifício no inquilino e tem propriedades como nome, endereço e coordenadas geográficas.
secretária Representa secretárias individuais. Uma secretária tem de ser adicionada a uma secção. As propriedades avançadas da secção incluem o endereço de e-mail, o modo e a acessibilidade.
piso Representa um piso dentro de um edifício, incluindo propriedades como nome, parentId e sortOrder. Um edifício é sempre o pai de um piso.
sala Representa uma sala dentro do inquilino. Todas as salas têm de estar associadas a caixas de correio do Exchange. Uma sala pode ser adicionada a um piso ou a uma secção. As propriedades avançadas da sala incluem um endereço de e-mail para a sala, acessibilidade, capacidade, dispositivo de áudio, dispositivo de vídeo, entre outros.
roomList Uma coleção de salas no inquilino. Places suporta roomList para garantir que a reserva de salas funciona no Localizador de Salas em todos os clientes em todos os dispositivos, como o Outlook clássico em todo o ambiente de trabalho e dispositivos móveis.

No entanto, recomendamos que confie nos novos tipos de local e hierarquia se não utilizar roomFinder no inquilino. Para obter mais informações sobre roomList, veja o tipo de recurso roomList .
section Representa uma secção num piso, incluindo propriedades como nome, parentId e etiqueta. Um piso é sempre o elemento principal de uma secção.
área de trabalho Representa uma coleção de secretárias. Todas as áreas de trabalho têm de estar associadas a caixas de correio do Exchange. Uma área de trabalho pode ser adicionada a uma secção. As propriedades avançadas de uma área de trabalho incluem um endereço de e-mail para a área de trabalho, modo, acessibilidade e capacidade.

Tipos de funcionalidades de mapa

A funcionalidade de mapa representa o mapa correspondente de um local. Um objeto de funcionalidade de mapa pode ser um dos seguintes tipos.

Tipo de funcionalidade de mapa Detalhes
buildingMap Representa um ficheiro de mapa associado a um edifício no Places. Este objeto é a representação em formato IMDF de building.geojson.
fixtureMap Representa um ficheiro fixture.geojson no formato IMDF que define recursos físicos móveis ou semi-permanentes num espaço. Estes recursos suportam funções de utilidade, serviço ou estética sem afetar a integridade estrutural.
footprintMap Representa um ficheiro footprint.geojson no formato IMDF que define a extensão física aproximada de um edifício referenciado.
levelMap Representa um ficheiro level.geojson no formato IMDF que define a estrutura física do piso dentro de um edifício.
sectionMap Representa um ficheiro section.geojson no formato IMDF que define secções (como zonas ou partições) no piso de um edifício.
unitMap Representa um ficheiro unit.geojson no formato IMDF que define unidades (como salas ou escritórios) num piso de um edifício.

Utilizar a API de Places

A API de Places permite que as aplicações com permissões de leitura ou escrita adequadas interajam com objetos de local. Cada objeto de local inclui propriedades fundamentais, como id, placeId e displayName. Os tipos mais avançados, como salas, áreas de trabalho e secretárias, oferecem mais propriedades, como modo, emailAddress e deviceInformation.

As APIs de mapa no Places permitem que as aplicações com permissões de leitura ou escrita adequadas interajam com objetos de funcionalidade de mapa. Cada objeto de funcionalidade de mapa inclui propriedades fundamentais como id e outras propriedades, como placeId, geometria e display_point.

As descrições detalhadas de cada tipo estão disponíveis nas respetivas secções de documentação.

Pré-requisitos para Places lista e APIs descendentes

Antes de poder utilizar os objetos ou o local da lista: APIs descendentes, tem de se certificar de que Places definições estão configuradas corretamente no seu ambiente do Microsoft 365; caso contrário, estas APIs não devolvem quaisquer locais, a menos que os seguintes passos de configuração estejam concluídos:

  1. Transfira e ligue-se ao módulo MicrosoftPlaces PowerShell. Para obter mais informações, consulte Connect-MicrosoftPlaces.
  2. Torne os locais visíveis ao ativar os 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 seguinte lista algumas das utilizações comuns para a API de Places.

Caso de uso Recurso REST Confira também
Criar e gerir um local local métodos place
Interagir com espaços de local, como edifício, piso, secção, sala, lista de salas, área de trabalho ou secretária local métodos place
Ingerir o ficheiro de mapa de um edifício edifício Ingerir ficheiro de mapa
Listar níveis num edifício levelMap Níveis de lista
Listar requisitos de espaço num edifício footprintMap Listar requisitos de espaço
Obter e eliminar um buildingMap buildingMap buildingMap methods (métodos buildingMap)
Criar e gerir um unitMap unitMap métodos unitMap
Criar e gerir um fixtureMap fixtureMap métodos fixtureMap
Criar e gerir uma secçãoAp sectionMap sectionMap methods (métodos sectionMap)

Próximas etapas

Utilize as APIs de Places do Microsoft Graph 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