Serviços externos de recursos no Fabric Maps

O Fabric Maps pode se conectar a serviços de feições externos e renderizar seus dados vetoriais como camadas de mapa. Um serviço externo de características fornece características geográficas, como pontos, linhas e polígonos, juntamente com atributos que descrevem essas características.

Ao se conectar a um serviço externo de recursos, você pode visualizar dados espaciais hospedados remotamente sem precisar antes copiá-los para uma casa de lago ou evento. O Fabric Maps consulta o serviço, recupera as características e atributos selecionados e renderiza os resultados como uma camada de dados vetorial.

O Fabric Maps suporta os seguintes protocolos externos de serviço de funcionalidades:

• Serviço de Recursos Web (WFS)
• API OGC - Recursos
• Serviço de Recursos da Esri

Você acessa esses protocolos pelo tipo de conexão Geospatial Web Services , juntamente com WMS e WMTS. Crie a conexão na nuvem em Gerenciar conexões e gateways, e depois adicione a conexão a um mapa na aba Fontes Externas no Explorador do mapa.

O que é um serviço de recursos externos?

Um serviço externo de recursos é uma API geoespacial baseada na web que publica características geográficas individuais. Cada recurso contém:

• Geometria, que define a localização e a forma da característica como um ponto, linha ou polígono.
• Atributos que fornecem informações sobre a característica, como nome, categoria, status, medição ou data.

Por exemplo, um serviço de recursos pode publicar localizações de veículos como pontos, estradas como linhas ou limites administrativos como polígonos. Fabric Maps usa a geometria para desenhar cada recurso e disponibiliza atributos selecionados para estilismo, filtragem, etiquetas, legendas e dicas de ferramentas.

O serviço e seus dados permanecem fora do item do mapa. O mapa armazena uma referência à conexão e à configuração necessária para recuperar e exibir os dados.

Protocolos de serviço de recursos suportados

A tabela a seguir resume como o Fabric Maps funciona com cada protocolo suportado.

Como funcionam os serviços de recursos externos no Fabric Maps

Quando você adiciona um serviço externo de recursos a um mapa, Fabric Maps:

1. Usa uma conexão existente ou cria uma conexão com o endpoint remoto.
2. Descobre as camadas de recursos ou coleções publicadas pelo serviço.
3. Lê metadados disponíveis, incluindo tipos de geometria, campos, limites de registros e capacidades de consulta suportadas.
4. Permite configurar uma consulta do lado do servidor e selecionar os campos a serem recuperados.
5. Solicita os recursos correspondentes, incluindo páginas de resultados adicionais quando suportado e necessário.
6. Renderiza as características retornadas como uma camada de dados vetorial.

A visualização padrão é baseada na geometria retornada pelo serviço:

Depois que a camada for adicionada, você pode configurar opções suportadas de camada vetorial, como estilo, etiquetas, legendas, dicas de ferramentas, visibilidade e filtros de camada de mapa. Para mais informações, veja Personalizar um mapa e filtragem de dados no Fabric Maps.

Para uma resposta de geometrias mistas do WFS ou da OGC API - Features, o Fabric Maps cria uma camada de dados. O tipo de geometria reportado pela camada é Desconhecido porque nenhum tipo único o descreve. As feições pontuais usam uma camada de bolhas, as feições lineares usam uma camada de linha, e as feições poligonais usam uma camada de polígono sem extrusão. Se você ativar o estilo orientado por dados, o Fabric Maps exibe as legendas dos tipos de geometria no painel da camada de dados. O agrupamento não está disponível para camadas de geometria mista.

Camadas externas de serviço de recursos suportam estilo baseado em categorias e valores orientados por dados.

Descoberta de camadas e coleções

O Fabric Maps lista camadas de feição ou coleções elegíveis na conexão, na seção Fontes externas do Explorador. A hierarquia disponível depende do protocolo e dos metadados expostos pelo serviço.

Atualizar a conexão recupera os metadados mais recentes do serviço, incluindo campos, camadas ou coleções recém-adicionadas. Essas mudanças podem não aparecer automaticamente. Para usar um campo recém-adicionado, atualize a conexão, adicione novamente a camada de origem e selecione o campo.

Os metadados retornados pelo serviço podem incluir:

• Nomes de exibição e identificadores
• Tipos de geometria
• Campos de atributos e tipos de dados
• Extensões espaciais
• Número máximo de registros
• Suportava filtragem, ordenação, paginação e capacidades temporais

As opções de configuração disponíveis podem variar entre os serviços porque o Fabric Maps utiliza as capacidades anunciadas por cada endpoint.

Consultas de fonte

Antes de adicionar uma camada de recursos a um mapa, você pode configurar uma consulta de fonte que limite os registros e campos recuperados do serviço remoto. Processar uma consulta no servidor pode reduzir a quantidade de dados transferidos para o Fabric Maps e focar a camada nas funcionalidades relevantes para o seu cenário.

Os campos e operadores disponíveis em uma consulta de origem dependem do protocolo selecionado e das capacidades anunciadas pelo serviço. Consultas de origem suportam seleção de campo de saída e podem suportar filtragem temporal. O Fabric Maps interpreta valores de data/hora como UTC no formato RFC 3339.

Fabric Maps valida a consulta em relação ao serviço selecionado. Se um campo, valor ou operador não for suportado, a experiência de configuração exibe um erro que você pode usar para revisar a consulta.

Você não pode voltar para a interface de consulta de origem para editar a consulta após adicionar a camada. Para usar diferentes condições de consulta de código-fonte, adicione novamente a camada de origem e configure uma nova consulta.

Fabric Maps gera automaticamente uma caixa envolvente a partir da área de visualização do mapa ao solicitar feições. A caixa delimitadora não é visível nem configurável na interface de consulta de código-fonte. Os usuários não podem inserir coordenadas ou selecionar uma área como condição de consulta espacial.

Consultas de fonte e filtros de camada de mapa

Consultas de origem e filtros de camada de mapa limitam dados em diferentes estágios:

Use uma consulta de fonte para reduzir os dados solicitados ao serviço remoto. Use um filtro de camada de mapa quando construtores ou visualizadores de mapas precisarem refinar interativamente os dados retornados. Para mais informações sobre filtros de camada de mapa, veja Filtragem de dados no Fabric Maps.

Camadas externas de serviço de características suportam filtros categóricos, de intervalo numérico, booleanos e de data/hora da camada de mapa. Vários filtros usam lógica AND. Filtros travados, comportamento nos modos de edição e visualização, e persistência de filtros funcionam da mesma forma entre as camadas WFS, API OGC - Features e Esri Feature Service.

Limites de paginação e resultados

Serviços de recursos podem limitar quantos registros retornam em uma única resposta. Fabric Maps usa automaticamente a configuração de paginação anunciada pelo serviço para recuperar resultados subsequentes. A paginação é transparente, e os construtores não conseguem configurar tamanho da página ou comportamento de paginação.

Fabric Maps renderiza até 100.000 recursos por camada. Se uma consulta de fonte devolver mais recursos, o Fabric Maps renderiza os primeiros 100.000 e exibe um aviso no painel de configurações de camadas. Refinar a consulta de origem para reduzir o conjunto de resultados.

Se uma solicitação de página falhar, o Fabric tenta novamente até três vezes. Se a requisição ainda falhar, o Fabric Maps exibe a mensagem Uma requisição falhou; alguns recursos estão faltando. Atualize para tentar novamente.

Configuração salva

Quando você salva um mapa, o Fabric Maps preserva a configuração da camada externa, incluindo:

• Referência de conexão
• Camada ou coleção de recursos selecionada
• Consulta de fonte
• Campos de saída selecionados
• Estilização das camadas e legenda
• Visibilidade
• Ordem de camada

Quando você reabre o mapa, o Fabric Maps usa a configuração salva para recuperar e renderizar a camada.

Camadas duplicadas referenciam a mesma fonte de dados, conexão, consulta de origem e campos de saída selecionados. Filtros de camada de mapa e configurações visuais são independentes para cada duplicado. Você não pode editar a consulta de origem ou os campos de saída depois de adicionar a camada nesta versão.

Atualizar serviços de recursos externos

O Fabric Maps oferece duas ações de atualização no modo de edição:

• Atualize uma conexão em fontes externas para recuperar os metadados mais recentes do serviço, incluindo campos, camadas ou coleções recém-adicionadas. Para usar um campo recém-adicionado, adicione novamente a camada de origem e selecione o campo.
• Atualize o item de mapa para consultar as camadas salvas em busca dos dados atuais. Essa ação não altera a consulta de código salvo.

Os visualizadores não podem atualizar dados de serviços externos de recursos nesta versão. Campos de saída salvos, estilo, legendas, visibilidade e ordem das camadas persistem após uma atualização.

Autenticação e acesso

Serviços externos de recursos podem exigir credenciais além das permissões necessárias para abrir ou editar um mapa Fabric.

Para autenticação por chave de API do Esri Feature Service, use token como nome do parâmetro da chave de API.

O Fabric armazena credenciais na conexão na nuvem. Os usuários não precisam que a conexão seja compartilhada com eles separadamente para exibir os dados externos. Se o Fabric Maps não conseguir recuperar credenciais de conexão válidas ou acessar o serviço, ele exibe um erro indicando que o serviço não pôde ser alcançado.

Serviços externos de feições e de imagens

Serviços externos de características retornam geometrias vetoriais e atributos. Os serviços WMS e WMTS retornam imagens raster renderizadas ou blocos renderizados. Escolha o tipo de fonte que corresponde aos dados e interações que seu mapa exige.

Para informações sobre imagens externas, veja Criar camadas usando fontes de imagens WMS e WMTS em Fabric Maps.

Considerações específicas do protocolo

WFS

• Descubra as camadas disponíveis das capacidades do serviço.
• Use as versões 1.0.0, 1.1.0 ou 2.0.0 do WFS.
• Quando o serviço anuncia múltiplas versões suportadas, o Fabric Maps usa a versão mais recente.
• O serviço WFS deve suportar respostas GeoJSON.
• Suporte respostas de geometria mista em uma camada.

API OGC - Recursos

• Organize os dados disponíveis em coleções.
• Operações avançadas de atributos e temporais dependem das classes de conformidade anunciadas pelo serviço.
• Suporte respostas de geometria mista em uma camada.
• Fabric Maps utiliza apenas capacidades suportadas pelo endpoint selecionado.

Serviço de Recursos da Esri

• A camada selecionada deve suportar a saída GeoJSON.
• Não oferece suporte a respostas com geometria mista.
• Fabric Maps aceita geometrias com valores de coordenadas M ou Z e ignora as dimensões extras.

Limitações e considerações

• A integração com serviço de feição externo é somente para leitura. Ingestão, edição de atributos e gravação de volta não são compatíveis.
• As funcionalidades de consulta dependem das capacidades anunciadas pelo serviço remoto.
• O Fabric Maps solicita recursos em EPSG:4326, com coordenadas em ordem de longitude e latitude. Serviços que publicam dados em outro sistema de referência de coordenadas são suportados se o serviço puder reprojetar os dados para EPSG:4326. Se o serviço não conseguir reprojetar os dados, como quando o sistema de coordenadas da camada está sem um código de autoridade EPSG, a camada não carrega.
• Caixas delimitadoras que cruzam o antimeridiano não são suportadas.
• Recursos cuja geometria é uma coleção de geometria não são renderizados. Outros recursos suportados na mesma camada renderizam normalmente.
• O agrupamento não está disponível para camadas de geometria mista.
• As camadas WFS e Feature Service Esri devem suportar saída GeoJSON.
• Formatos de resposta GML não são suportados nesta versão.
• O Fabric Maps ignora as dimensões M e Z na geometria do Esri Feature Service.
• Uma camada pode renderizar até 100.000 recursos.
• Um item de mapa pode referenciar até 100 conexões externas através de WMS, WMTS, WFS, API OGC - Features e Esri Feature Service.
• Apenas serviços acessíveis pela internet pública são suportados. Endpoints privados, gateways de dados locais, gateways de dados de rede virtual e outras opções de rede privada gerenciada não são suportados.
• Disponibilidade e tempo de resposta à consulta dependem do serviço remoto e da conexão de rede.

Próximas Etapas 

Para opções de estilo, veja Personalizar um mapa.