Nota
O acesso a esta página requer autorização. Pode tentar iniciar sessão ou alterar os diretórios.
O acesso a esta página requer autorização. Pode tentar alterar os diretórios.
Importante
As APIs na versão /beta no Microsoft Graph estão sujeitas a alterações. Não há suporte para o uso dessas APIs em aplicativos de produção. Para determinar se uma API está disponível na v1.0, use o seletor Versão.
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:
- Baixe e conecte-se ao módulo MicrosoftPlaces PowerShell. Para obter mais informações, consulte Connect-MicrosoftPlaces.
- 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 |
| Upsert de locais | Local | Upsert de locais |
| 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 |
Comparando APIs do Places com findRooms e findRoomLists
As funções findRooms e findRoomLists dão suporte a pesquisas semelhantes para salas e listas de salas em um locatário. A tabela a seguir compara a API Places e essas funções.
Observação
As funções findRooms e findRoomLists foram preteridas.
| API do Places | Funções findRooms e findRoomLists (preteridas) |
|---|---|
| Obtém todos os quartos ou listas de quartos em um locatário e todos os quartos em uma lista de quartos. | Obtém todos os quartos ou listas de quartos em um locatário e todos os quartos em uma lista de quartos. |
| A Lista pode retornar mais de 100 quartos em um locatário. | findRooms retorna até as primeiras 100 salas em um locatário. |
| Dá suporte à obtenção de uma lista de salas individual ou de salas em um locatário. | Não dá suporte à obtenção de uma sala individual ou lista de salas em um locatário. |
| Define as entidades específicas de room e roomList que especificam um conjunto de propriedades mais avançado, além do nome de exibição e do endereço SMTP. | Cada sala e lista de salas é de um tipo emailAddress mais leve que especifica apenas o nome de exibição e o endereço SMTP. |
| Suporta apenas cenários organizacionais com permissões delegadas (somente para contas corporativas ou de estudante) ou de aplicativo. | Suporta apenas cenários organizacionais com permissões delegadas ou de aplicativo. |
| Dá suporte à atualização de uma sala individual ou lista de salas em um locatário. | Não dá suporte à atualização de uma sala individual ou lista de salas em um locatário. |
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.