Services de fonctionnalités externes dans Fabric Maps

Fabric Maps peut se connecter à des services de fonctionnalités externes et afficher leurs données vectorielles sous forme de couches de carte. Un service de caractéristiques externe fournit des caractéristiques géographiques, telles que des points, des lignes et des polygones, ainsi que des attributs qui décrivent ces caractéristiques.

En vous connectant à un service de fonctionnalités externe, vous pouvez visualiser des données spatiales hébergées à distance sans d’abord les copier dans une maison lacustre ou une maison événementielle. Fabric Maps interroge le service, récupère les caractéristiques et attributs sélectionnés, et affiche les résultats sous forme de couche de données vectorielle.

Fabric Maps prend en charge les protocoles de service de fonctionnalités externes suivants :

• Service d'entités Web (WFS)
• API OGC - Fonctionnalités
• Service de fonctionnalités Esri

Vous accédez à ces protocoles via le type de connexion Geospatial Web Services , ainsi que WMS et WMTS. Créez la connexion cloud dans Gérer les connexions et passerelles, puis ajoutez la connexion à une carte depuis l’onglet Sources externes dans l’Explorateur de la carte.

Qu’est-ce qu’un service de fonctionnalités externe ?

Un service de fonctionnalités externe est une API géospatiale web qui publie des caractéristiques géographiques individuelles. Chaque fonctionnalité contient :

• La géométrie, qui définit l’emplacement et la forme de la caractéristique sous forme de point, de ligne ou de polygone.
• Attributs, qui fournissent des informations sur la caractéristique, telles qu’un nom, une catégorie, un statut, une mesure ou une date.

Par exemple, un service de fonctionnalités peut publier les emplacements des véhicules comme des points, les routes comme des lignes, ou les limites administratives sous forme de polygones. Fabric Maps utilise la géométrie pour dessiner chaque caractéristique et met à disposition certains attributs pour le style, le filtrage, les labels, les légendes et les infobulles.

Le service et ses données restent en dehors de l’élément cartographique. La carte stocke une référence à la connexion et à la configuration nécessaire pour récupérer et afficher les données.

Protocoles de service de fonctionnalités pris en charge

Le tableau suivant résume comment Fabric Maps fonctionne avec chaque protocole pris en charge.

Comment fonctionnent les services de fonctionnalités externes dans Fabric Maps

Lorsque vous ajoutez un service de fonctionnalités externe à une carte, Fabric Maps :

1. Utilise une connexion existante ou crée une connexion vers le point d’accès distant.
2. Découvre les couches de fonctionnalités ou collections publiées par le service.
3. Lit les métadonnées disponibles, y compris les types de géométrie, les champs, les limites d’enregistrements et les capacités de requête prises en charge.
4. Cela vous permet de configurer une requête côté serveur et de sélectionner les champs à récupérer.
5. Demande les fonctionnalités de correspondance, y compris des pages de résultats supplémentaires lorsque cela est supporté et nécessaire.
6. Affiche les caractéristiques retournées sous forme de couche de données vectorielles.

La visualisation par défaut est basée sur la géométrie renvoyée par le service :

Une fois le calque ajouté, vous pouvez configurer les options de calque vectoriel prises en charge telles que le style, les labels, les légendes, les infobulles, la visibilité et les filtres de couche cartographique. Pour plus d’informations, voir Personnaliser une carte et le filtrage des données dans Fabric Maps.

Pour une réponse avec géométries mixtes d’un service WFS ou d’une API OGC - Features, Fabric Maps crée une couche de données. Le type de géométrie rapporté par la couche est Inconnu car aucun type ne le décrit uniquement. Les entités ponctuelles utilisent une couche de bulles, les entités linéaires utilisent une couche de lignes, et les entités polygonales utilisent une couche polygonale sans extrusion. Si vous activez le style basé sur les données, Fabric Maps affiche les légendes des types de géométrie dans le panneau de la couche de données. Le clustering n’est pas disponible pour les couches à géométrie mixte.

Les couches de service d’entités externes prennent en charge la stylisation pilotée par les données par catégorie et par plage de valeurs.

Découverte de couches et de collections

Fabric Maps répertorie les couches d’entités ou les collections éligibles sous la connexion dans la section Sources externes de l’Explorateur. La hiérarchie disponible dépend du protocole et des métadonnées exposés par le service.

Le rafraîchissement de la connexion récupère les dernières métadonnées de service, y compris les champs, couches ou collections nouvellement ajoutés. Ces changements peuvent ne pas apparaître automatiquement. Pour utiliser un champ nouvellement ajouté, rafraîchissez la connexion, puis ajoutez à nouveau la couche source et sélectionnez le champ.

Les métadonnées retournées par le service peuvent inclure :

• Noms d’affichage et identifiants
• Type de géométries
• Champs d’attributs et types de données
• Étendues spatiales
• Nombre maximal d’enregistrements
• Capacités de filtrage, de tri, de pagination et capacités temporelles prises en charge

Les options de configuration disponibles peuvent varier d’un service à l’autre, car Fabric Maps utilise les fonctionnalités annoncées par chaque point de terminaison.

Requêtes source

Avant d’ajouter une couche de fonctionnalités à une carte, vous pouvez configurer une requête source qui limite les enregistrements et champs récupérés depuis le service distant. Traiter une requête sur le serveur peut réduire la quantité de données transférées vers Fabric Maps et concentrer la couche sur les fonctionnalités pertinentes à votre scénario.

Les champs et opérateurs disponibles dans une requête source dépendent du protocole sélectionné et des capacités annoncées par le service. Les requêtes source supportent la sélection du champ de sortie et peuvent prendre en charge le filtrage temporel. Fabric Maps interprète les valeurs date/heure comme UTC au format RFC 3339.

Fabric Maps valide la requête par rapport au service sélectionné. Si un champ, une valeur ou un opérateur n’est pas pris en charge, l’expérience de configuration affiche une erreur que vous pouvez utiliser pour réviser la requête.

Vous ne pouvez pas revenir à l’interface source-query pour modifier la requête après avoir ajouté la couche. Pour utiliser différentes conditions de requête source, ajoutez à nouveau la couche source et configurez une nouvelle requête.

Fabric Maps dérive automatiquement une boîte englobante à partir de la fenêtre de carte lorsqu’il demande des fonctionnalités. La boîte englobante n’est ni visible ni configurable dans l’interface de requête source. Les utilisateurs ne peuvent pas entrer de coordonnées ni sélectionner une zone comme condition de requête spatiale.

Requêtes source et filtres à couche cartographie

Les requêtes source et les filtres de couche cartographique limitent les données à différents stades :

Utilisez une requête source pour réduire les données demandées au service distant. Utilisez un filtre de couche cartographique lorsque les constructeurs ou les visualiseurs de cartes doivent affiner de manière interactive les données retournées. Pour plus d’informations sur les filtres à couche cartographique, voir Filtrage des données dans Fabric Maps.

Les couches de service de caractéristiques externes prennent en charge les filtres catégoriques, de plage numérique, booléens et de couche cartographique date/heure. Plusieurs filtres fonctionnent avec une logique AND. Les filtres verrouillés, le comportement en mode édition et vue, ainsi que la persistance des filtres fonctionnent de la même manière entre WFS, API OGC - Features, et les couches Feature Service d’Esri.

Pagination et limites de résultats

Les services de fonctionnalités peuvent limiter le nombre de dossiers qu’ils retournent en une seule réponse. Fabric Maps utilise automatiquement la configuration de pagination annoncée par le service pour récupérer les résultats suivants. Le pageage est transparent, et les constructeurs ne peuvent pas configurer la taille de la page ou le comportement de pagination.

Fabric Maps rend jusqu’à 100 000 caractéristiques par couche. Si une requête source renvoie plus de fonctionnalités, Fabric Maps affiche les 100 000 premières et affiche un avertissement dans le volet des paramètres de calque. Affinez la requête source pour réduire l’ensemble des résultats.

Si une requête de page échoue, Fabric la réessaie jusqu’à trois fois. Si la requête échoue toujours, Fabric Maps affiche le message Une requête a échoué ; certaines fonctionnalités manquent. Rafraîchissez pour réessayer.

Configuration sauvegardée

Lorsque vous sauvegardez une carte, Fabric Maps préserve la configuration des couches externes, y compris :

• Référence de connexion
• Couche ou collection de fonctionnalités sélectionnée
• Requête source
• Champs de sortie sélectionnés
• Style des couches et légende
• Visibilité
• Ordre des couches

Lorsque vous rouvrez la carte, Fabric Maps utilise la configuration sauvegardée pour récupérer et afficher le calque.

Les couches dupliquées font référence à la même source de données, connexion, requête source et champs de sortie sélectionnés. Les filtres de couche cartographie et les réglages visuels sont indépendants pour chaque doublon. Vous ne pouvez pas modifier les champs de requête source ou de sortie après avoir ajouté le calque dans cette version.

Rafraîchir les services de fonctionnalités externes

Fabric Maps propose deux actions de rafraîchissement en mode édition :

• Rafraîchir une connexion dans les sources externes pour récupérer les dernières métadonnées du service, y compris les champs, couches ou collections nouvellement ajoutés. Pour utiliser un champ nouvellement ajouté, ajoutez à nouveau la couche source et sélectionnez le champ.
• Rafraîchir l’élément de la carte pour interroger les couches enregistrées afin de rechercher les données actuelles. Cette action ne modifie pas la requête source sauvegardée.

Les spectateurs ne peuvent pas actualiser les données de service de fonctionnalités externes dans cette version. Les champs de sortie sauvegardés, le style, les légendes, la visibilité et l’ordre des calques persistent après un rafraîchissement.

Authentification et accès

Les services de fonctionnalités externes peuvent nécessiter des identifiants en plus des autorisations nécessaires pour ouvrir ou modifier une carte Fabric.

Pour l’authentification de clé API du service Esri Feature Service, utilisez token comme nom du paramètre clé API.

Fabric stocke les identifiants dans la connexion cloud. Les spectateurs n’ont pas besoin que la connexion leur soit partagée séparément pour afficher les données externes. Si Fabric Maps ne peut pas récupérer les identifiants de connexion valides ni atteindre le service, il affiche une erreur indiquant que le service n'a pas pu être atteint.

Services d’entités externes et services d’imagerie

Les services de caractéristiques externes retournent des géométries et attributs vectoriels. Les services WMS et WMTS renvoient des images matricielles ou des tuiles rendues. Choisissez le type de source qui correspond aux données et interactions dont votre carte a besoin.

Pour des informations sur l’imagerie externe, voir Créer des calques à l’aide de sources d’images WMS et WMTS dans Fabric Maps.

Considérations spécifiques au protocole

WFS

• Découvrez les couches disponibles des capacités de service.
• Utilisez les versions 1.0.0, 1.1.0 ou 2.0.0 de WFS.
• Lorsque le service annonce plusieurs versions prises en charge, Fabric Maps utilise la dernière version.
• Le service WFS doit prendre en charge les réponses GeoJSON.
• Prendre en charge les réponses à géométrie mixte en une seule couche.

API OGC - Fonctionnalités

• Organisez les données disponibles en collections.
• Les opérations d’attributs avancées et temporelles dépendent des classes de conformité annoncées par le service.
• Prendre en charge les réponses à géométrie mixte en une seule couche.
• Fabric Maps utilise uniquement les capacités prises en charge par le point de terminaison sélectionné.

Service de fonctionnalités Esri

• La couche sélectionnée doit prendre en charge la sortie GeoJSON.
• Je ne supporte pas les réponses en géométrie mixte.
• Fabric Maps accepte la géométrie avec des valeurs de coordonnées M ou Z et ignore les dimensions supplémentaires.

Limitations et considérations

• L’intégration des services de fonctionnalités externes est en lecture seule. L’ingestion, la relecture de fonctionnalités et l’écriture ne sont pas prises en charge.
• Les fonctionnalités de requête dépendent des fonctionnalités annoncées par le service distant.
• Fabric Maps demande des fonctionnalités dans EPSG :4326, avec des coordonnées en longitude et ordre de latitude. Les services qui publient des données dans un autre système de référence de coordonnées sont pris en charge si le service peut reprojeter les données vers EPSG :4326. Si le service ne peut pas reprojeter les données, par exemple lorsque le système de coordonnées de la couche manque d’un code d’autorité EPSG, la couche ne se charge pas.
• Les boîtes englobantes qui traversent l’antiméridien ne sont pas prises en charge.
• Les entités dont la géométrie est une collection de géométries ne sont pas affichées. Les autres fonctionnalités supportées dans la même couche s’affichent normalement.
• Le clustering n’est pas disponible pour les couches à géométrie mixte.
• Les couches WFS et Feature Service Esri doivent prendre en charge la sortie GeoJSON.
• Les formats de réponse GML ne sont pas pris en charge dans cette version.
• Fabric Maps ignore les dimensions M et Z dans la géométrie du service Feature Esri.
• Un calque peut rendre jusqu’à 100 000 fonctionnalités.
• Un élément de carte peut référencer jusqu’à 100 connexions externes via WMS, WMTS, WFS, API OGC - Features, et Esri Feature Service.
• Seuls les services accessibles via Internet public sont pris en charge. Les terminaux privés, les passerelles de données sur site, les passerelles de données virtuelles et d’autres options de réseau privé géré ne sont pas pris en charge.
• La disponibilité et le temps de réponse aux requêtes dépendent du service distant et de la connexion réseau.

Étapes suivantes

Pour les options de style, voir Personnaliser une carte.