Seus ativos vivem no ArcGIS. Suas inspeções, levantamentos de vegetação e capturas de local agora vivem como Gaussian Splats no Splat Labs Cloud. Este guia mostra como conectar os dois — para que seus usuários GIS possam clicar em um recurso no mapa e imediatamente explorar uma captura 3D fotorrealista daquele ativo, sem sair do fluxo de trabalho do ArcGIS.
Cobrimos quatro métodos de integração, do mais simples ao mais poderoso. Todos os métodos funcionam hoje com o que o Splat Labs Cloud já fornece: URLs de visualizador compartilháveis e iframes incorporáveis.
Antes de Começar
Para cada método abaixo, você precisa de duas coisas:
-
Uma conta no Splat Labs Cloud com seus Gaussian Splats carregados e organizados em projetos. Cadastre-se gratuitamente em cloud.rockrobotic.com.
-
Uma URL de visualizador para cada projeto que você deseja conectar ao ArcGIS. Cada projeto do Splat Labs tem uma URL de visualizador neste formato:
https://cloud.rockrobotic.com/viewer/{project-id}?view=splat
Copie esta URL no diálogo de Compartilhamento — você irá usá-la ao longo deste guia.
Opções de Compartilhamento para Integração com o ArcGIS
Você tem três formas de controlar quem pode visualizar seus Gaussian Splats quando acessados a partir do ArcGIS:
- Compartilhamento por link público — Ative "Compartilhamento por link habilitado" no diálogo de Compartilhamento. Qualquer pessoa com a URL pode visualizar o splat sem fazer login. Esta é a opção mais simples e funciona bem para ativos não sensíveis.
- Compartilhamento por e-mail (plano Business) — Compartilhe o projeto com usuários específicos por e-mail. Somente esses usuários podem visualizá-lo após autenticação com sua conta do Splat Labs. Funciona com hiperlinks e embeds de iframe — os visualizadores são solicitados a fazer login quando acessam o visualizador.
- Grupos empresariais (plano Enterprise) — Todo projeto criado por um usuário em um grupo Enterprise fica automaticamente disponível para todos no grupo. Nenhum compartilhamento por projeto é necessário. Esta é a opção mais otimizada para equipes e organizações — todos os membros do grupo podem visualizar qualquer projeto em iframes ou hiperlinks sem compartilhamento manual.
Nota: As três opções funcionam com todos os métodos de integração descritos neste guia, incluindo embeds de iframe em Dashboards e Experience Builder. Para mais detalhes sobre estratégias de acesso para infraestrutura sensível, veja a seção Gerenciando Acesso para Infraestrutura Sensível no final deste guia.
Método 1: Hiperlink em um Pop-Up de Recurso
Ideal para: Usuários do ArcGIS Online e ArcGIS Pro que querem um link rápido "Visualizar Captura 3D" em cada ativo.
Como funciona: Você adiciona um campo de texto à tabela de atributos da sua camada de recurso que armazena a URL do visualizador do Splat Labs para cada ativo. Quando um usuário GIS clica em um ativo no mapa, o pop-up mostra um hiperlink que abre o visualizador de Gaussian Splat em uma nova aba do navegador.
Complexidade: Baixa — sem código, sem widgets personalizados, funciona em qualquer produto ArcGIS que suporte pop-ups.
Etapa 1: Adicione um Campo de URL à Sua Camada de Recurso
No ArcGIS Pro ou ArcGIS Online, adicione um novo campo de texto à sua camada de recurso de ativos. Dê um nome descritivo:
| Nome do Campo | Alias | Tipo |
|---|---|---|
splat_url | URL de Captura 3D | Texto (String) |
Se você tem um campo existente para links de documentos ou anexos de mídia, pode reutilizá-lo — mas um campo dedicado mantém as coisas organizadas, especialmente quando você tem centenas ou milhares de ativos.
Etapa 2: Preencha o Campo
Para cada ativo que tem uma captura de Gaussian Splat correspondente, cole a URL do visualizador do Splat Labs no campo splat_url. A URL se parece com isso:
https://cloud.rockrobotic.com/viewer/e6d9b3eb-35bb-4a73-8499-8f2e3ad21d4b?view=splat
Se você está trabalhando em escala — centenas de postes, subestações ou instalações — pode preencher em lote este campo usando a Calculadora de Campo do ArcGIS Pro ou um script Python com a API ArcGIS para Python. A chave é manter um mapeamento entre seus IDs de ativo GIS e seus IDs de projeto do Splat Labs.
Dica para preenchimento em massa: Se seus projetos do Splat Labs têm nomes consistentes (por exemplo, usando IDs de ativo como SUB-0042 ou números de poste), você pode criar o mapeamento por script. Exporte sua lista de projetos do Splat Labs, faça a correspondência pela convenção de nomenclatura e calcule os valores dos campos em lote.
Etapa 3: Configure o Pop-Up
No ArcGIS Online (Map Viewer):
- Abra seu mapa web e selecione a camada de ativo.
- Abra o painel Pop-ups na barra de ferramentas de configurações.
- Clique em Adicionar conteúdo e selecione Texto.
- No editor de texto, digite o rótulo que você quer que os usuários vejam — por exemplo,
Visualizar Captura 3D. - Selecione esse texto e clique no botão Link.
- Para a URL, digite
{splat_url}— isso referencia o campo que você criou. - Salve o mapa.
Agora, quando um usuário clica em um ativo, ele vê um link "Visualizar Captura 3D" no pop-up. Clicar nele abre o visualizador de Gaussian Splat em uma nova aba do navegador — alimentado pelo streaming inteligente do Splat Labs Cloud, para que a cena carregue rapidamente em qualquer dispositivo.
No ArcGIS Pro:
- No painel Conteúdo, clique com o botão direito na sua camada de recurso e abra Configurar Pop-ups.
- Adicione um elemento de Texto.
- Insira um hiperlink com a URL definida como
{splat_url}e a descrição definida comoVisualizar Captura 3D. - Clique em Aplicar.
Quando os usuários clicam nos recursos com a ferramenta pop-up, eles veem o link clicável.
Etapa 4 (Opcional): Use uma Expressão Arcade para URLs Dinâmicas
Se seus IDs de projeto do Splat Labs seguem um padrão previsível com base nos atributos do ativo, você pode usar uma expressão Arcade em vez de um campo estático. Isso é útil quando você não quer preencher manualmente as URLs para cada recurso.
Por exemplo, se seus projetos do Splat Labs são nomeados usando o ID de instalação do ativo:
// Expressão Arcade para hiperlink no pop-up
"https://cloud.rockrobotic.com/viewer/" + $feature.facility_id + "?view=splat"
Adicione isso como uma Expressão de Atributo na configuração do seu pop-up e referencie-a em um hiperlink como {expression/expr0}.
Importante: Isso só funciona se seus IDs de projeto do Splat Labs correspondem aos identificadores de ativo GIS. Se não corresponderem, use a abordagem de campo de URL estático nas Etapas 1–3.
Método 2: Visualizador Incorporado nos Dashboards do ArcGIS
Ideal para: Centros de operações, salas de controle e equipes que usam o ArcGIS Dashboards para monitoramento. O visualizador de Gaussian Splat aparece como um painel ao vivo junto ao seu mapa e widgets de dados.
Como funciona: O ArcGIS Dashboards suporta um elemento de Conteúdo Incorporado que pode carregar qualquer URL externa em um iframe — incluindo o visualizador do Splat Labs. Você pode configurá-lo para ser estático (uma URL fixa) ou dinâmico (a URL muda com base no recurso que o usuário seleciona no mapa).
Complexidade: Baixa a Média — sem necessidade de código, mas você precisa entender as ações e fontes de dados do Dashboard.
Embed Estático (Um Splat Fixo)
Use isso quando seu painel foca em um único local — por exemplo, um painel de visão geral de subestação.
- Abra seu painel no modo de edição.
- Clique no botão + para adicionar um elemento e selecione Conteúdo Incorporado.
- Em Opções de Dados, selecione Sem Fonte de Dados (configuração estática).
- Cole a URL do visualizador do Splat Labs no campo de URL:
https://cloud.rockrobotic.com/viewer/e6d9b3eb-35bb-4a73-8499-8f2e3ad21d4b?view=splat - Redimensione e posicione o painel de conteúdo incorporado no layout do seu painel.
- Salve.
O visualizador de Gaussian Splat agora aparece como um painel 3D ao vivo e interativo no seu painel. Os usuários podem orbitar, dar zoom e explorar a cena diretamente dentro do painel — completo com as medições de precisão do Splat Labs e desempenho suave de streaming.
Embed Dinâmico (Orientado por Recurso)
Esta é a abordagem mais poderosa. Quando um usuário clica em um ativo no widget de mapa do painel, o painel de conteúdo incorporado carrega automaticamente o Gaussian Splat correspondente.
- Certifique-se de que sua camada de recurso tem um campo
splat_urlpreenchido com URLs de visualizador (veja o Método 1, Etapas 1–2). - Adicione um elemento de Conteúdo Incorporado ao seu painel.
- Em Opções de Dados, selecione Uma camada de recurso e escolha sua camada de ativo como fonte de dados.
- Para a URL, insira o modelo de URL usando o nome do seu campo entre chaves:
{splat_url} - Em Ações, configure o widget de mapa para filtrar ou selecionar recursos ao clicar, o que faz o conteúdo incorporado atualizar.
- Opcionalmente, habilite Renderizar apenas quando filtrado para que o painel de incorporação mostre uma mensagem útil ("Selecione um ativo no mapa para visualizar sua captura 3D") até que o usuário faça uma seleção.
- Salve.
Agora seu painel funciona assim: clique em um poste no mapa → o painel incorporado carrega uma visualização 3D fotorrealista daquele exato poste. Isso é extremamente poderoso para fluxos de trabalho de inspeção remota onde os operadores precisam confirmar visualmente o estado de um ativo sem enviar uma equipe de campo.
Recomendações de Layout do Painel
Para um painel de operações de utilities com Gaussian Splats, considere este layout:
- Painel esquerdo (40% de largura): Widget de mapa mostrando as localizações dos ativos
- Painel direito (60% de largura): Conteúdo incorporado mostrando o visualizador de Gaussian Splat
- Faixa inferior: Widgets de gráfico de série ou indicador mostrando status de inspeção, data da última captura, etc.
Quanto maior você tornar o painel de conteúdo incorporado, melhor será a experiência de visualização 3D. O visualizador do Splat Labs é responsivo e preencherá o espaço que lhe for dado.
Método 3: Visualizador Incorporado no ArcGIS Experience Builder
Ideal para: Aplicações web personalizadas criadas para fluxos de trabalho específicos — revisão de inspeção de campo, gerenciamento de vegetação, apresentações para partes interessadas ou visualizadores de ativos voltados ao público.
Como funciona: O ArcGIS Experience Builder inclui um widget Embed que aceita URLs externas ou código iframe HTML. Você pode conectar o widget aos seus dados para que o visualizador do Splat Labs incorporado atualize dinamicamente quando os usuários interagem com o mapa ou uma lista.
Complexidade: Média — requer familiaridade com o Experience Builder e uma conta organizacional ArcGIS.
Configuração Básica
- Crie uma nova Experiência no ArcGIS Experience Builder.
- Adicione seu mapa web de ativos como fonte de dados.
- Arraste um widget de Mapa para a tela no seu painel esquerdo.
- Arraste um widget de Embed para a tela no seu painel direito.
Embed Estático
Nas configurações do widget Embed, selecione URL e cole a URL do visualizador do Splat Labs. Isso carrega um Gaussian Splat fixo.
Embed Dinâmico (Orientado por Recurso)
É aqui que o Experience Builder realmente brilha. Você pode fazer a URL de incorporação mudar com base em qual recurso o usuário seleciona.
- No widget Embed, selecione URL e ative Conectar a dados.
- Selecione sua camada de recurso de ativo como fonte de dados.
- Escolha Atributo e selecione seu campo
splat_url.
Agora, quando um usuário clica em um ativo no widget de mapa, o widget Embed carrega a URL do visualizador do Splat Labs correspondente. O visualizador 3D atualiza no lugar — sem recarregar a página, sem nova aba.
Usando o Widget Embed com Código HTML
Se você quiser mais controle sobre os atributos do iframe, pode usar a opção Código em vez de URL:
<iframe
src="https://cloud.rockrobotic.com/viewer/{project-id}?view=splat"
width="100%"
height="100%"
frameborder="0"
allowfullscreen
loading="eager">
</iframe>
Quer um passo a passo detalhado da incorporação de iframe? Veja nosso guia completo: Como Incorporar um Visualizador 3D Gaussian Splat no Seu Site.
Nota: A opção Código tem um limite de tamanho de 8 KB e requer que você esteja conectado com uma conta organizacional ArcGIS. Para a maioria dos casos, a opção URL é mais simples e suficiente.
Criando uma Experiência Completa de Revisão de Inspeção
Aqui está um layout prático para uma aplicação de revisão de inspeção de campo para utilities:
- Página 1 — Visão Geral do Mapa: Mapa em tela cheia com todos os ativos. Clicar em um ativo navega para a Página 2.
- Página 2 — Detalhe do Ativo: Layout dividido com atributos do ativo à esquerda (nome, tipo, data da última inspeção, status) e o visualizador do Splat Labs incorporado à direita. Inclua um botão "Voltar ao Mapa".
Isso dá aos supervisores de campo e engenheiros um fluxo de trabalho otimizado: navegar no mapa, tocar em um ativo, revisar a captura 3D, tomar uma decisão, seguir em frente. O streaming inteligente do Splat Labs faz o visualizador carregar rapidamente mesmo em tablets de campo com conectividade limitada.
Adicionando um Widget de Lista para Navegação de Múltiplos Splats
Para equipes gerenciando muitas capturas — digamos, centenas de postes ao longo de um corredor de transmissão — adicione um widget de Lista junto ao mapa:
- Adicione um widget de Lista mostrando nomes de ativos, miniaturas e datas da última captura.
- Configure o widget Embed para conectar à mesma fonte de dados da lista.
- Quando um usuário clica em um item na lista, o embed atualiza para mostrar o Gaussian Splat daquele ativo.
Isso funciona como um navegador de galeria para suas capturas 3D, tudo dentro do ambiente ArcGIS.
Método 4: ArcGIS StoryMaps para Comunicação com Partes Interessadas
Ideal para: Compartilhar resultados de inspeção com executivos, reguladores ou partes interessadas externas que não usam o ArcGIS diretamente. Os StoryMaps fornecem um formato narrativo e orientado por rolagem que combina texto, mapas, imagens e conteúdo incorporado.
Como funciona: O ArcGIS StoryMaps suporta a incorporação de conteúdo web externo via URL. Você cola a URL do visualizador do Splat Labs em um bloco de incorporação e o Gaussian Splat aparece inline dentro da sua história.
Complexidade: Baixa — sem configuração técnica, puramente autoria de conteúdo.
Como Incorporar
- Abra seu StoryMap no construtor.
- Clique em + para adicionar um bloco de conteúdo.
- Selecione Incorporar (não Imagem ou Vídeo).
- Cole a URL do visualizador do Splat Labs:
https://cloud.rockrobotic.com/viewer/e6d9b3eb-35bb-4a73-8499-8f2e3ad21d4b?view=splat - Escolha um tamanho (médio ou grande funciona melhor para visualizadores 3D).
- Adicione uma legenda explicando o que o visualizador mostra.
- Continue construindo sua história.
Casos de Uso para Utilities
- Relatórios de conformidade regulatória: Incorpore capturas antes e depois de trabalhos de limpeza de vegetação junto com evidências escritas de conformidade. As ferramentas de medição de precisão do Splat Labs permitem que os reguladores verifiquem as distâncias de limpeza diretamente na visualização 3D.
- Avaliação de danos por tempestade: Guie os executivos pelos danos com capturas 3D incorporadas de infraestrutura afetada, ordenadas cronologicamente. Use o recurso de linha do tempo 4D do Splat Labs para mostrar o mesmo ativo antes e depois do evento.
- Atualizações de projetos de capital: Mostre o progresso da construção em uma subestação ou instalação ao longo do tempo, com capturas de cada fase incorporadas em sequência.
- Comunicação pública: Se um projeto afeta uma comunidade, um StoryMap com visualizações 3D incorporadas ajuda os moradores a entender o que está sendo construído e por quê.
Esquema de Geodatabase Recomendado
Para obter o máximo da integração do Splat Labs com todos os métodos acima, adicione estes campos às suas camadas de recurso de ativos:
| Nome do Campo | Alias | Tipo | Descrição |
|---|---|---|---|
splat_url | URL de Captura 3D | Texto | A URL do visualizador do Splat Labs para este ativo |
splat_project_id | ID do Projeto Splat Labs | Texto | O UUID do projeto do Splat Labs (útil para scripting) |
splat_capture_date | Data da Última Captura 3D | Data | Quando o Gaussian Splat foi capturado |
splat_capture_source | Método de Captura | Texto | Como foi capturado (drone, portátil, montado em veículo) |
O campo splat_url é o mínimo. Os outros campos adicionam contexto que ajuda sua equipe a gerenciar sua biblioteca de capturas ao longo do tempo — filtrando por data de captura, identificando ativos que precisam de re-captura ou reportando a cobertura.
Gerenciando Acesso para Infraestrutura Sensível
A infraestrutura de utilities costuma ser sensível à segurança. O Splat Labs oferece controle total sobre quem pode visualizar seus Gaussian Splats — e todos os métodos de acesso funcionam com todos os quatro métodos de integração ArcGIS descritos neste guia, incluindo embeds de iframe.
Compartilhamento por Link Público
Quando o compartilhamento por link está habilitado, qualquer pessoa com a URL pode visualizar o splat sem fazer login. Isso é apropriado para:
- Ativos não sensíveis (parques, edifícios públicos, canteiros de obras gerais)
- Apresentações para partes interessadas onde você controla quem recebe o link
- StoryMaps compartilhados com públicos conhecidos
A URL não é indexada por mecanismos de busca e não é adivinhável — contém um UUID — mas não é autenticada. Se alguém compartilhar o link, o destinatário pode visualizá-lo.
Acesso Baseado em E-mail (Plano Business)
Para infraestrutura sensível, use o compartilhamento baseado em e-mail do Splat Labs Cloud em vez de links públicos:
- No diálogo de Compartilhamento, mantenha o Compartilhamento por link desabilitado.
- Adicione os endereços de e-mail dos usuários autorizados.
- Somente esses usuários — após fazer login — podem visualizar o projeto.
Isso funciona com todos os métodos de integração, incluindo embeds de iframe em Dashboards e Experience Builder. Quando um usuário autorizado abre um painel ou experiência que contém um visualizador do Splat Labs incorporado, ele é solicitado a fazer login no Splat Labs. Uma vez autenticado, o iframe carrega e ele pode interagir com a cena 3D normalmente. Usuários não autorizados veem um prompt de login em vez do visualizador.
Grupos Empresariais (Plano Enterprise)
Para organizações que precisam de acesso fluido em toda a equipe sem compartilhar cada projeto individualmente, o plano Enterprise fornece controle de acesso baseado em grupo:
- Todo projeto criado por um usuário em um grupo Enterprise fica automaticamente disponível para todos os outros membros do grupo — nenhum compartilhamento manual necessário.
- Os Gerentes Enterprise têm visibilidade total de todos os projetos na organização.
- Três funções (Gerente Enterprise, Criador, Usuário) fornecem controle granular sobre quem pode criar, editar, excluir e compartilhar projetos e pastas.
Esta é a opção mais eficiente para equipes de utilities. Uma vez que seus analistas GIS e equipes de campo estejam no mesmo grupo Enterprise, cada Gaussian Splat que eles carregarem fica imediatamente disponível para toda a equipe — em hiperlinks, em visualizadores incorporados, em painéis, em todo lugar. Sem etapas de compartilhamento por projeto.
Os planos Enterprise começam com 3 usuários e 50 projetos, escalando para 20+ usuários e 500+ projetos. Veja Preços para detalhes ou entre em contato com nossa equipe para discutir opções Enterprise.
Estratégia de Acesso Prática para Utilities
Para a maioria dos deployments de utilities, recomendamos uma abordagem em camadas:
- Grupos Enterprise para sua equipe principal — equipes de campo, analistas GIS, engenheiros, supervisores. Todos no grupo veem automaticamente cada projeto. Os visualizadores incorporados nos Dashboards e Experience Builder simplesmente funcionam para membros autenticados do grupo.
- Compartilhamento baseado em e-mail para partes interessadas externas, contratados ou reguladores que precisam de acesso a projetos específicos, mas não fazem parte do seu grupo Enterprise.
- Compartilhamento por link público para ativos não sensíveis onde você quer o acesso mais simples possível — sem login, sem necessidade de conta. Use isso para StoryMaps voltados ao público ou apresentações para partes interessadas.
- Segurança do ArcGIS como uma camada adicional. Seus mapas web, painéis e experiências já estão protegidos pela autenticação organizacional do ArcGIS. Uma pessoa não autorizada não pode acessar a URL do splat a menos que primeiro tenha acesso ao seu ambiente ArcGIS.
Esta abordagem em camadas — grupos Enterprise para sua equipe, compartilhamento por e-mail para colaboradores externos, links públicos onde apropriado, e autenticação ArcGIS como camada adicional — cobre as necessidades da maioria das organizações de utilities hoje.
Convenções de Nomenclatura e Organização
À medida que sua biblioteca de splats cresce de dezenas para centenas para milhares de capturas, a organização consistente se torna crítica. Aqui estão recomendações para equipes de utilities:
Nomenclatura de Projetos no Splat Labs Cloud
Use uma convenção de nomenclatura que mapeia para sua hierarquia de ativos GIS:
{Região}-{TipoDeAtivo}-{IDDoAtivo}-{DataDeCaptura}
Exemplos:
NORTE-SUB-0042-2025-06-15(Região Norte, Subestação 42, capturada em 15 de junho de 2025)LESTE-POSTE-LT205-1847-2025-03-22(Região Leste, Linha de Transmissão 205 Poste 1847)OESTE-FDC-SEG14-2025-09-01(Região Oeste, Faixa de Domínio e Construção Segmento 14)
Estrutura de Pastas no Splat Labs Cloud
Organize seu workspace do Splat Labs Cloud para espelhar sua hierarquia organizacional GIS:
📁 Região Norte
📁 Subestações
📁 SUB-0042
📁 SUB-0043
📁 Linhas de Transmissão
📁 LT-205
📁 LT-206
📁 Região Leste
📁 Subestações
📁 Distribuição
📁 Gerenciamento de Vegetação
📁 2025-T1
📁 2025-T2
Isso facilita para os analistas GIS encontrarem o projeto certo ao preencher o campo splat_url, e para os gerentes navegarem nas capturas por área ou período. A organização de pastas está disponível nos planos Business e superiores do Splat Labs.
Exemplos de Fluxos de Trabalho
Inspeção Remota de Poste
- O operador de drone captura um corredor de linha de transmissão usando LiDAR ou fotogrametria.
- Os dados são processados em Gaussian Splats e carregados para o Splat Labs Cloud, um projeto por vão ou por cluster de postes.
- O analista GIS preenche o campo
splat_urlem cada recurso de poste no geodatabase. - O supervisor de campo abre o ArcGIS Dashboard, clica em um poste no mapa e o Gaussian Splat carrega no painel incorporado.
- O supervisor rotaciona a visualização para inspecionar a folga do condutor, a condição do braço transversal e a proximidade da vegetação — tudo do escritório. As ferramentas de medição de precisão do Splat Labs fornecem distâncias exatas quando necessário.
- Se uma ação for necessária, eles criam uma ordem de serviço diretamente do painel.
Este fluxo de trabalho reduz as visitas ao local em até 75%, com base nos resultados de equipes de construção e utilities já usando o Splat Labs para documentação remota.
Documentação As-Built de Subestação
- A equipe de levantamento captura uma subestação com um scanner portátil (PortalCam, Lixel L2 Pro ou similar).
- O Gaussian Splat é carregado para o Splat Labs Cloud e colocado na pasta de projeto apropriada.
- O recurso de subestação no ArcGIS é atualizado com a URL do visualizador.
- Os engenheiros revisando o as-built podem clicar na subestação no mapa e caminhar pela cena 3D completa, verificando a colocação de equipamentos, folgas e nivelamento com medições dentro da cena.
Evidência de Gerenciamento de Vegetação
- O contratado de gerenciamento de vegetação captura os corredores de faixa de domínio antes e depois do corte.
- Ambas as capturas são carregadas como projetos separados do Splat Labs —
FDC-SEG14-PRE-2025-06eFDC-SEG14-POS-2025-07. - Um StoryMap é criado para o relatório regulatório trimestral, com Gaussian Splats antes e depois incorporados lado a lado. O recurso de linha do tempo 4D do Splat Labs também pode vincular ambas as capturas para comparação interativa antes/depois.
- Os reguladores podem explorar ambas as capturas interativamente, verificando se os requisitos de folga foram cumpridos.
Solução de Problemas
O visualizador incorporado mostra um espaço em branco
- Confirme que o visualizador tem acesso ao projeto. Para compartilhamento por link público, verifique se "Compartilhamento por link habilitado" está marcado. Para compartilhamento baseado em e-mail, confirme que o usuário visualizador foi convidado e está conectado ao Splat Labs. Para grupos Enterprise, confirme que o usuário é membro do grupo. Se o visualizador não tiver acesso, o iframe mostrará um prompt de login ou erro de acesso.
- Confirme que tanto seu ambiente ArcGIS quanto o Splat Labs Cloud estão usando HTTPS. Conteúdo misto (página pai HTTP carregando um iframe HTTPS) é bloqueado por navegadores modernos. O Splat Labs Cloud sempre usa HTTPS, então geralmente isso não é um problema.
- Nos ArcGIS Dashboards, verifique o console do desenvolvedor do navegador para erros
X-Frame-OptionsouContent-Security-Policy. O Splat Labs Cloud permite incorporação de iframe por padrão, então esses erros geralmente vêm das políticas de segurança de rede da sua organização.
O pop-up mostra a URL como texto simples em vez de um link clicável
- No ArcGIS Online Map Viewer, certifique-se de ter adicionado a URL usando o botão Link no editor de texto, não como texto bruto. O pop-up não detecta automaticamente URLs em campos de texto.
- No ArcGIS Pro, verifique se o campo
splat_urlestá configurado como hiperlink nas configurações do pop-up, não apenas exibido como valor de atributo.
O visualizador carrega lentamente no painel incorporado
- Os Gaussian Splats são transmitidos progressivamente — o visualizador primeiro carrega uma versão de baixa resolução, depois refina. Este é o comportamento normal, não um problema de desempenho.
- Se o painel incorporado for muito pequeno (menos de 400px de largura), considere torná-lo maior. O visualizador se adapta ao espaço disponível, mas painéis pequenos limitam a experiência visual.
- Use
loading="eager"no seu código iframe se o visualizador for o conteúdo principal. Useloading="lazy"se estiver abaixo do dobramento ou for secundário.
Os pop-ups não suportam iframes
Isso está correto para pop-ups do ArcGIS Online Map Viewer — a Esri bloqueou a incorporação de iframe em pop-ups por razões de segurança. É por isso que recomendamos a abordagem de hiperlink para pop-ups (abre em uma nova aba) e a abordagem de Conteúdo Incorporado ou widget Embed para Dashboards e Experience Builder (exibe inline). Não tente colar HTML de iframe em um elemento de texto de pop-up — ele será removido.
O que Vem a Seguir
Os iframes com controle de acesso e os visualizadores incorporados já funcionam hoje — você pode usar compartilhamento por e-mail (plano Business) ou grupos Enterprise para controlar quem pode visualizar seus Gaussian Splats em Dashboards, Experience Builder e StoryMaps. Sem necessidade de compartilhamento por link público.
O Splat Labs está construindo capacidades de integração mais profundas para tornar os fluxos de trabalho do ArcGIS ainda mais fluidos. No roadmap:
- Autenticação OAuth2 para o ArcGIS — Autentique-se diretamente pelo ArcGIS para que você possa navegar e selecionar seus projetos do Splat Labs de dentro do ArcGIS sem mudar para o painel do Splat Labs. Isso permitirá que as extensões do ArcGIS obtenham uma lista de todos os seus projetos disponíveis e os adicionem automaticamente aos seus mapas e painéis.
- Suporte a SSO/SAML — Logon único empresarial para que seus usuários do ArcGIS se autentiquem no Splat Labs com as mesmas credenciais corporativas que já usam — um login para ambas as plataformas.
À medida que esses recursos ficarem disponíveis, atualizaremos este guia com métodos de integração adicionais. Entre em contato com nossa equipe se quiser acesso antecipado ou tiver requisitos de integração específicos.
Resumo
| Método | Produto ArcGIS | Experiência de Visualização | Esforço de Configuração |
|---|---|---|---|
| Hiperlink em pop-up | ArcGIS Online, ArcGIS Pro, ArcGIS Enterprise | Abre em nova aba | Baixo |
| Conteúdo incorporado no Dashboard | ArcGIS Dashboards | Inline, orientado por recurso | Baixo–Médio |
| Widget embed no Experience Builder | ArcGIS Experience Builder | Inline, orientado por recurso | Médio |
| Embed em StoryMaps | ArcGIS StoryMaps | Inline, narrativo | Baixo |
Todos os quatro métodos funcionam hoje com as capacidades de compartilhamento e incorporação existentes do Splat Labs Cloud. Comece com o Método 1 se quiser testar o fluxo de trabalho rapidamente. Mude para o Método 2 ou 3 quando estiver pronto para construir uma aplicação operacional que sua equipe usa diariamente.
Precisa de ajuda para configurar sua integração com o ArcGIS? Entre em contato com nossa equipe — trabalhamos com equipes GIS de utilities e empresariais todos os dias e temos prazer em orientá-lo.


