Servicios externos de características en Fabric Maps

Fabric Maps puede conectarse a servicios externos de características y renderizar sus datos vectoriales como capas de mapa. Un servicio externo de características proporciona características geográficas, como puntos, líneas y polígonos, junto con atributos que describen dichas características.

Al conectarte a un servicio externo de funcionalidades, puedes visualizar datos espaciales alojados remotamente sin tener que copiarlos primero en una casa de lago o de eventos. Fabric Maps consulta el servicio, recupera las características y atributos seleccionados y muestra los resultados como una capa de datos vectorial.

Fabric Maps soporta los siguientes protocolos externos de servicio de funcionalidades:

• Servicio de Funciones Web (WFS)
• API OGC - Características
• Servicio de Características de Esri

Se accede a estos protocolos a través del tipo de conexión Geospatial Web Services , incluyendo WMS y WMTS. Crea la conexión en la nube en Gestionar conexiones y gateways, y luego añade la conexión a un mapa desde la pestaña de Fuentes Externas en el Explorador del mapa.

¿Qué es un servicio de funciones externas?

Un servicio externo de características es una API geoespacial basada en la web que publica características geográficas individuales. Cada característica contiene:

• Geometría, que define la ubicación y forma de la característica como un punto, línea o polígono.
• Atributos que proporcionan información sobre la característica, como un nombre, categoría, estado, medida o fecha.

Por ejemplo, un servicio de características podría publicar la ubicación de vehículos como puntos, carreteras como líneas o límites administrativos como polígonos. Fabric Maps utiliza la geometría para dibujar cada característica y pone a disposición los atributos seleccionados para estilización, filtrado, etiquetas, leyendas y descripciones emergentes.

El servicio y sus datos permanecen fuera del elemento del mapa. El mapa almacena una referencia a la conexión y la configuración necesaria para recuperar y mostrar los datos.

Protocolos de servicio de funcionalidades soportados

La siguiente tabla resume cómo funciona Fabric Maps con cada protocolo soportado.

Cómo funcionan los servicios externos de características en Fabric Maps

Cuando añades un servicio externo de características a un mapa, Fabric Maps:

1. Utiliza una conexión existente o crea una conexión con el punto final remoto.
2. Descubre las capas de características o colecciones publicadas por el servicio.
3. Lee los metadatos disponibles, incluyendo tipos de geometría, campos, límites de registros y capacidades de consulta compatibles.
4. Te permite configurar una consulta del lado del servidor y seleccionar los campos para recuperar.
5. Solicita las funciones de coincidencia, incluyendo páginas de resultados adicionales cuando sea compatible y necesario.
6. Renderiza las características devueltas como una capa de datos vectorial.

La visualización por defecto se basa en la geometría devuelta por el servicio:

Una vez añadida la capa, puedes configurar opciones de capa vectorial compatibles como estilo, etiquetas, leyendas, descripciones emergentes, visibilidad y filtros de capa de mapa. Para más información, consulte Personalizar un mapa y filtrado de datos en Fabric Maps.

Para una respuesta de geometría mixta de un servicio WFS o de OGC API - Features, Fabric Maps crea una única capa de datos. El tipo de geometría reportado de la capa es Desconocido porque ningún tipo lo describe. Las entidades puntuales usan una Bubble layer, las entidades lineales usan una Line layer y las entidades poligonales usan una Polygon layer sin extrusión. Si activas el estilo basado en datos, Fabric Maps muestra las leyendas de los tipos de geometría en el panel de capa de datos. El clustering no está disponible para capas de geometría mixta.

Las capas externas de servicio de características soportan el estilo basado en datos basado en categorías y rangos de valor.

Descubrimiento de capas y colecciones

Fabric Maps lista capas o colecciones de características elegibles debajo de la conexión en la sección Fuentes externas del Explorador. La jerarquía disponible depende del protocolo y los metadatos expuestos por el servicio.

Al actualizar la conexión, se recuperan los últimos metadatos del servicio, incluyendo campos, capas o colecciones recién añadidos. Estos cambios pueden no aparecer automáticamente. Para usar un campo recién añadido, actualiza la conexión, luego vuelve a añadir la capa de origen y selecciona el campo.

Los metadatos devueltos por el servicio pueden incluir:

• Nombres de visualización e identificadores
• Tipos de geometría
• Campos de atributos y tipos de datos
• Extensiones espaciales
• Número máximo de registros
• Capacidades soportadas para filtrado, ordenación, paginación y temporal

Las opciones de configuración disponibles pueden variar entre servicios porque Fabric Maps utiliza las capacidades anunciadas por cada endpoint.

Consultas de fuente

Antes de añadir una capa de características a un mapa, puedes configurar una consulta de código fuente que limite los registros y campos recuperados del servicio remoto. Procesar una consulta en el servidor puede reducir la cantidad de datos transferidos a Fabric Maps y centrar la capa en las características relevantes para tu escenario.

Los campos y operadores disponibles en una consulta de código fuente dependen del protocolo seleccionado y de las capacidades anunciadas por el servicio. Las consultas de fuente soportan la selección del campo de salida y pueden soportar filtrado temporal. Fabric Maps interpreta los valores de fecha/hora como UTC en formato RFC 3339.

Fabric Maps valida la consulta frente al servicio seleccionado. Si un campo, valor u operador no está soportado, la experiencia de configuración muestra un error que puedes usar para revisar la consulta.

No puedes volver a la interfaz de consulta de código fuente para editar la consulta después de añadir la capa. Para usar diferentes condiciones de consulta de fuente, añade de nuevo la capa de código fuente y configura una nueva consulta.

Fabric Maps obtiene automáticamente un cuadro delimitador a partir de la ventana gráfica del mapa cuando solicita entidades. La caja delimitadora no es visible ni configurable en la interfaz de consulta de fuente. Los usuarios no pueden introducir coordenadas ni seleccionar un área como condición de consulta espacial.

Consultas de origen y filtros de capa de mapa

Las consultas de origen y los filtros de capa de mapa limitan los datos en diferentes etapas:

Utiliza una consulta de fuente para reducir los datos solicitados al servicio remoto. Utiliza un filtro de capa del mapa cuando los creadores de mapas o los usuarios necesiten refinar interactivamente los datos devueltos. Para más información sobre filtros de capa de mapa, consulta Filtrado de datos en Fabric Maps.

Las capas externas de servicio de características soportan filtros categóricos, numéricos, booleanos y de capas de mapa de fecha/hora. Múltiples filtros usan AND lógica. Los filtros bloqueados, el comportamiento en modo edición y visualización, y la persistencia de los filtros funcionan igual en las capas WFS, API OGC - Features y Esri Feature Service.

Paginación y límites de resultados

Los servicios de funcionalidades pueden limitar cuántos registros devuelven en una sola respuesta. Fabric Maps utiliza automáticamente la configuración de paginación anunciada por el servicio para recuperar los resultados posteriores. El paginado es transparente y los constructores no pueden configurar el tamaño de página ni el comportamiento de paginación.

Fabric Maps renderiza hasta 100.000 características por capa. Si una consulta de código fuente devuelve más características, Fabric Maps muestra las primeras 100.000 y muestra una advertencia en el panel de configuración de capas. Refinar la consulta de código fuente para reducir el conjunto de resultados.

Si una solicitud de página falla, Fabric la intenta hasta tres veces. Si la petición sigue fallando, Fabric Maps muestra el mensaje A petición fallida; faltan algunas funciones. Refrescar para intentarlo de nuevo.

Configuración guardada

Cuando guardas un mapa, Fabric Maps conserva la configuración de la capa externa, incluyendo:

• Referencia de conexión
• Capa o colección de características seleccionadas
• Consulta de fuente
• Campos de salida seleccionados
• Estilo de capas y leyenda
• Visibilidad
• Orden de capas

Cuando vuelves a abrir el mapa, Fabric Maps usa la configuración guardada para recuperar y renderizar la capa.

Las capas duplicadas hacen referencia a la misma fuente de datos, conexión, consulta de fuente y campos de salida seleccionados. Los filtros de capa de mapa y los ajustes visuales son independientes para cada duplicado. No puedes editar la consulta de origen ni los campos de salida después de añadir la capa en esta versión.

Actualizar los servicios de funcionalidades externas

Fabric Maps ofrece dos acciones de actualización en modo edición:

• Actualiza una conexión en Fuentes externas para recuperar los últimos metadatos del servicio, incluyendo campos, capas o colecciones recién añadidos. Para usar un campo recién añadido, vuelve a añadir la capa de origen y selecciona el campo.
• Actualiza el elemento del mapa para consultar las capas guardadas y obtener datos actuales. Esta acción no cambia la consulta de código fuente guardada.

Los espectadores no pueden actualizar los datos de servicios externos de funciones en esta versión. Los campos de salida guardados, el estilo, las leyendas, la visibilidad y el orden de las capas persisten tras una actualización.

Autenticación y acceso

Los servicios externos de funcionalidades pueden requerir credenciales además de los permisos necesarios para abrir o editar un mapa de Fabric.

Para la autenticación de la clave API de Esri Feature Service, úsalo token como nombre del parámetro de clave de la API.

Fabric almacena las credenciales en la conexión en la nube. Los espectadores no necesitan que la conexión se comparta con ellos por separado para renderizar los datos externos. Si Fabric Maps no puede recuperar credenciales de conexión válidas ni acceder al servicio, muestra un error que indica que no se pudo contactar con el servicio.

Servicios externos de reportajes y servicios de imágenes

Los servicios externos de características devuelven geometrías vectoriales y atributos. Los servicios WMS y WMTS devolven imágenes raster o tiles renderizados. Elige el tipo de fuente que coincida con los datos e interacciones que requiere tu mapa.

Para información sobre imágenes externas, véase Crear capas usando fuentes de imágenes WMS y WMTS en Fabric Maps.

Consideraciones específicas de cada protocolo

WFS

• Descubre las capas disponibles de las capacidades del servicio.
• Utiliza las versiones 1.0.0, 1.1.0 o 2.0.0 de WFS.
• Cuando el servicio anuncia múltiples versiones compatibles, Fabric Maps utiliza la última versión.
• El servicio WFS debe soportar respuestas GeoJSON.
• Soportar respuestas de geometría mixta en una sola capa.

API OGC - Características

• Organizar los datos disponibles en colecciones.
• Las operaciones avanzadas de atributos y temporales dependen de las clases de conformidad anunciadas por el servicio.
• Soportar respuestas de geometría mixta en una sola capa.
• Fabric Maps utiliza únicamente las capacidades soportadas por el endpoint seleccionado.

Servicio de Características de Esri

• La capa seleccionada debe soportar la salida GeoJSON.
• No soportan respuestas de geometría mixta.
• Fabric Maps acepta geometría con valores de coordenadas M o Z e ignora las dimensiones adicionales.

Limitaciones y consideraciones

• La integración de servicios de funcionalidad externa es de solo lectura. No se admiten la ingestión, la edición de funciones y la escritura posterior.
• Las funciones de consulta dependen de las capacidades anunciadas por el servicio remoto.
• Fabric Maps solicita características en EPSG:4326, con coordenadas en longitud y orden de latitud. Los servicios que publican datos en otro sistema de referencia de coordenadas son soportados si el servicio puede reproyectar los datos a EPSG:4326. Si el servicio no puede reproyectar los datos, como cuando el sistema de coordenadas de la capa carece de un código de autoridad EPSG, la capa no se carga.
• No se admiten cajas delimitadoras que cruzan el antimeridiano.
• Las características cuya geometría es una colección de geometría no se renderizan. Otras funciones soportadas en la misma capa se renderizan normalmente.
• El clustering no está disponible para capas de geometría mixta.
• Las capas de WFS y Feature Service de Esri deben soportar salida GeoJSON.
• Los formatos de respuesta GML no están soportados en esta versión.
• Fabric Maps ignora las dimensiones M y Z en la geometría de Esri Feature Service.
• Una capa puede renderizar hasta 100.000 características.
• Un elemento de mapa puede referenciar hasta 100 conexiones externas a través de WMS, WMTS, WFS, API OGC - Features y Esri Feature Service.
• Solo se soportan servicios accesibles a través de internet público. No se admiten endpoints privados, pasarelas de datos locales, pasarelas de datos de red virtual y otras opciones de red privada gestionada.
• La disponibilidad y el tiempo de respuesta a la consulta dependen del servicio remoto y la conexión de red.

Pasos siguientes

Para opciones de estilo, consulta Personalizar un mapa.