Serviços de funcionalidades externas no Fabric Maps

Os Fabric Maps podem ligar-se a serviços externos de feature e renderizar os 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 ligar-se a um serviço externo de funcionalidades, pode visualizar dados espaciais alojados remotamente sem antes os copiar para uma casa de lago ou casa de eventos. O Fabric Maps consulta o serviço, recupera as características e atributos selecionados e apresenta os resultados como uma camada de dados vetorial.

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

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

Acede a estes protocolos através do tipo de ligação Geospatial Web Services , juntamente com WMS e WMTS. Crie a ligação à cloud em Gerir ligações e gateways e, em seguida, adicione a ligação a um mapa no separador Fontes externas no Explorador do mapa.

O que é um serviço externo de funcionalidades?

Um serviço externo de funcionalidades é uma API geoespacial baseada na web que publica características geográficas individuais. Cada funcionalidade 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, estado, medição ou data.

Por exemplo, um serviço de funcionalidades pode publicar localizações de veículos como pontos, estradas como linhas ou limites administrativos como polígonos. O Fabric Maps utiliza a geometria para desenhar cada característica e disponibiliza atributos selecionados para estilização, filtragem, etiquetas, legendas e tooltips.

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

Protocolos de serviço de funcionalidades suportados

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

Como funcionam os serviços de funcionalidades externas no Fabric Maps

Quando adiciona um serviço externo de funcionalidades a um mapa, Fabric Maps:

1. Utiliza uma ligação existente ou cria uma ligação ao endpoint remoto.
2. Descobre as camadas de funcionalidades ou coleções publicadas pelo serviço.
3. Lê metadados disponíveis, incluindo tipos de geometria, campos, limites de registos e capacidades de consulta suportadas.
4. Permite-lhe configurar uma consulta do lado do servidor e selecionar os campos a recuperar.
5. Solicita as funcionalidades 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 baseia-se na geometria devolvida pelo serviço:

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

No caso de uma resposta de geometria mista de WFS ou 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. Os elementos pontuais utilizam uma camada de bolhas, os elementos lineares utilizam uma camada de linhas e os elementos poligonais utilizam uma camada poligonal sem extrusão. Se ativares o estilo orientado por dados, o Fabric Maps mostra as legendas dos tipos de geometria no painel da camada de dados. O clustering não está disponível para camadas de geometria mista.

As camadas externas de serviço de elementos suportam estilização baseada em dados por categoria e por intervalo de valores.

Descoberta de camadas e coleções

O Fabric Maps lista camadas ou coleções de características elegíveis na ligação na secção Fontes Externas do Explorer. A hierarquia disponível depende do protocolo e dos metadados expostos pelo serviço.

Atualizar a ligação recupera os metadados mais recentes do serviço, incluindo campos, camadas ou coleções recentemente adicionados. Estas alterações podem não aparecer automaticamente. Para usar um campo recém-adicionado, atualize a ligação e depois adicione novamente a camada de origem e selecione o campo.

Os metadados devolvidos pelo serviço podem incluir:

• Nomes de exibição e identificadores
• Tipos de geometria
• Campos de atributos e tipos de dados
• Extensões espaciais
• Contagem máxima de registos
• Suportava filtragem, ordenação, paginação e capacidades temporais

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

Consultas de fonte

Antes de adicionar uma camada de funcionalidades a um mapa, pode configurar uma consulta de origem que limite os registos 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 numa consulta de origem dependem do protocolo selecionado e das capacidades anunciadas pelo serviço. As consultas de origem suportam a seleção do campo de saída e podem suportar filtragem temporal. O Fabric Maps interpreta valores de data/hora como UTC no formato RFC 3339.

O Fabric Maps valida a consulta face ao serviço selecionado. Se um campo, valor ou operador não for suportado, a experiência de configuração mostra um erro que pode usar para rever a consulta.

Não podes voltar à interface de consulta de origem para editar a consulta depois de adicionares a camada. Para usar diferentes condições de consulta de código-fonte, adicione novamente a camada de origem e configure uma nova consulta.

O Fabric Maps deriva automaticamente uma caixa delimitadora a partir da janela de visualização do mapa quando solicita funcionalidades. A caixa delimitadora não é visível nem configurável na interface de consulta de origem. Os utilizadores não podem introduzir coordenadas nem selecionar uma área como condição de consulta espacial.

Consultas de origem e filtros de camada de mapa

Consultas de origem e filtros de camada de mapa limitam os dados em diferentes fases:

Use uma consulta de origem para reduzir os dados solicitados ao serviço remoto. Use um filtro de camada de mapa quando os criadores ou visualizadores de mapas precisarem de refinar interativamente os dados devolvidos. Para mais informações sobre filtros de camada de mapa, consulte Filtragem de dados em 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 utilizam a lógica AND. Filtros bloqueados, comportamento dos 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

Os serviços de funcionalidades podem limitar o número de registos que retornam numa única resposta. O Fabric Maps utiliza automaticamente a configuração de paginação anunciada pelo serviço para obter resultados subsequentes. A paginação é transparente e os construtores não conseguem configurar o tamanho da página ou o comportamento de paginação.

O Fabric Maps renderiza até 100.000 funcionalidades por camada. Se uma consulta de origem devolver mais elementos, o Fabric Maps renderiza os primeiros 100.000 e apresenta um aviso no painel Definições da camada. Refinar a consulta de origem para reduzir o conjunto de resultados.

Se um pedido de página falhar, o Fabric tenta novamente até três vezes. Se o pedido continuar a falhar, o Fabric Maps mostra a mensagem Um pedido falhou; algumas funcionalidades estão em falta. Atualize para tentar novamente.

Configuração guardada

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

• Referência de conexão
• Camada ou coleção de funcionalidades selecionada
• Consulta de origem
• Campos de saída selecionados
• Estilo e legenda da camada
• Visibilidade
• Ordem da camada

Quando reabres o mapa, o Fabric Maps usa a configuração guardada para recuperar e renderizar a camada.

Camadas duplicadas referenciam a mesma fonte de dados, ligação, consulta de origem e campos de saída selecionados. Os filtros da camada do mapa e as definições visuais são independentes para cada duplicado. 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 funcionalidades externas

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

• Atualize uma ligação em Fontes Externas para recuperar os metadados mais recentes do serviço, incluindo campos, camadas ou coleções recentemente adicionados. 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 guardadas e obter os dados atuais. Esta ação não altera a consulta de origem guardada.

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

Autenticação e acesso

Os serviços externos de funcionalidades podem exigir credenciais além das permissões necessárias para abrir ou editar um Fabric map.

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

O Fabric armazena as credenciais na ligação à cloud. Os visualizadores não precisam que a ligação seja partilhada separadamente com eles para renderizar os dados externos. Se o Fabric Maps não conseguir recuperar credenciais de ligação válidas ou aceder ao serviço, apresenta um erro indicando que o serviço não pôde ser contactado.

Serviços externos de reportagens e serviços de imagens

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

Para informações sobre imagens externas, veja Criar camadas usando fontes de imagens WMS e WMTS no 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 utiliza a versão mais recente.
• O serviço WFS deve suportar respostas GeoJSON.
• Suporta respostas de geometria mista numa só camada.

API OGC - Funcionalidades

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

Serviço de Funcionalidades Esri

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

Limitações e considerações

• A integração externa de serviços de funcionalidades é apenas de leitura. A importação, a edição de elementos e a reescrita na origem não são suportadas.
• As funcionalidades de consulta dependem das capacidades anunciadas pelo serviço remoto.
• O Fabric Maps solicita características em EPSG:4326, com coordenadas em ordem de longitude e latitude. Serviços que publicam dados noutro sistema de referência de coordenadas são suportados se o serviço conseguir reprojetar os dados para EPSG:4326. Se o serviço não conseguir reprojetar os dados, como quando o sistema de coordenadas da camada não tem um código de autoridade EPSG, a camada não carrega.
• Caixas delimitadoras que cruzam o antimeridiano não são permitidas.
• As funcionalidades cuja geometria é uma coleção de geometria não são renderizadas. Outras funcionalidades suportadas na mesma camada renderizam normalmente.
• O clustering não está disponível para camadas de geometria mista.
• As camadas WFS e Feature Service Esri devem suportar saída GeoJSON.
• Os 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 características.
• Um item de mapa pode referenciar até 100 ligações externas através de WMS, WMTS, WFS, API OGC - Features e Esri Feature Service.
• Apenas os serviços acessíveis através da internet pública são suportados. Pontos finais privados, gateways de dados no local, gateways de dados de rede virtual e outras opções de rede privada gerida não são suportados.
• A disponibilidade e o tempo de resposta à consulta dependem do serviço remoto e da ligação à rede.

Passos seguintes

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