Utiliser un service d’API de l’OGC

Vous pouvez utiliser des services d’entités d’API de l’OGC ou de tuiles d’API de l’OGC (tuiles de carte) disponibles sur le web lorsque vous utilisez ArcGIS Pro. La prise en charge du client du service d’API de l’OGC dans ArcGIS vous permet d’accéder à ces services sur Internet et d’ajouter une couche d’entités d’API de l’OGC ou de tuiles d’API de l’OGC (tuiles de carte) à votre carte.

La norme des entités d’API de l’OGC est une spécification multipartie qui vous permet de travailler avec des données spatiales sur le Web. Le client ArcGIS Pro prend en charge la 1re partie de la spécification des entités de l’API de l’OGC. Pour plus d’informations concernant la norme des entités d’API de l’OGC, reportez-vous au site web de l’OGC à l’adresse https://ogc.org/standard/ogcapi-features/.

La norme des tuiles d’API de l’OGC est une spécification qui vous permet d’utiliser les informations géospatiales en tant que tuiles. Actuellement, le client ArcGIS Pro prend uniquement en charge le type de tuiles de carte de la spécification des tuiles d’API de l’OGC. Pour plus d’informations concernant la norme des tuiles d’API de l’OGC, reportez-vous au site web de l’OGC à l’adresse https://ogc.org/standard/ogcapi-tiles/.

Afficher une couche d’entités d’API de l’OGC ou de tuiles de carte de l’API de l’OGC dans la fenêtre Contents (Contenu)

Après avoir établi une connexion au serveur d’API de l’OGC, une connexion au serveur d’API de l’OGC apparaît dans le dossier Servers (Serveurs) de la fenêtre Catalog (Catalogue). Vous pouvez ajouter un service d’entités d’API de l’OGC ou de tuiles d’API de l’OGC à une carte en sélectionnant la couche dans la connexion au serveur d’API de l’OGC et en la faisant glisser sur la carte, ou en cliquant avec le bouton droit sur la couche et en sélectionnant Add To Current Map (Ajouter à la carte actuelle). Lorsque vous ajoutez une couche d’entités d’API de l’OGC ou de tuiles d’API de l’OGC à la carte, la couche est ajoutée à la fenêtre Contents (Contenu) et les entités sont affichées sur la carte.

Utiliser une couche d’entités d’API de l’OGC depuis le Web

Une fois ajoutée à ArcGIS Pro, une couche d’entités d’API de l’OGC fonctionne comme une couche d’entités en lecture seule. Vous pouvez par exemple ouvrir la table attributaire pour afficher les enregistrements dans la couche, les entités de requête sur la carte, ou modifier la symbologie de la couche. La couche d’entités d’API de l’OGC n’étant pas modifiable, vous ne pouvez pas modifier les données, ni la structure via ArcGIS Pro.

Ajouter une boîte de dialogue Couches API OGC

Lorsque vous ajoutez une couche d’entités API OGC à la carte à l’aide d’une connexion de serveur API OGC ou à partir d’un élément OGCFeatureServer sur l’onglet Portal (Portail) de la fenêtre Catalog (Catalogue), la boîte de dialogue Add OGC API Layer(s) [Ajouter une ou des couches API OGC] s’ouvre. Cette boîte de dialogue vous permet de limiter les entités ouvertes dans la carte en spécifiant une étendue ou en définissant le nombre maximum d’entités ajoutées à la carte. La possibilité de limiter les entités ajoutées à la carte peut s’avérer utile en termes de performances lorsque les jeux de données sont très volumineux. Ces propriétés peuvent également être modifiées dans la boîte de dialogue OGC Features layer properties (Propriétés de couche d’entités de l’OGC).

1. Set the maximum features returned (Définir le nombre maximum d’entités renvoyées) : pour définir le nombre maximum d’entités renvoyées pour la couche, vous pouvez spécifier une valeur dans la zone de texte Set the maximum features returned (Définir le nombre maximum d’entités renvoyées). Si aucune valeur n’est définie, toutes les entités seront renvoyées. Si une étendue est également utilisée pour limiter le nombre d’entités renvoyées, le nombre maximum d’entités renvoyées sera appliqué aux entités renvoyées dans l’étendue définie.
2. Use Spatial Extent (Utiliser l’étendue spatiale) : choisissez de limiter les entités en indiquant une zone d’intérêt (étendue spatiale).
   • Cochée : limitez les entités ajoutées à la carte en indiquant une étendue. Le service OGC API Features (Entités API de l’OGC) doit prendre en charge le paramètre bbox pour utiliser cette fonction. Indiquez l’étendue à utiliser dans le paramètre Selected extend (Étendue sélectionnée).
   • Décochée : ne limitez pas spatialement les entités ajoutées à la carte. Il s’agit de l’option par défaut.
3. Selected extent (Étendue sélectionnée) : définissez une étendue personnalisée à utiliser pour limiter les données ajoutées à la carte. Vous pouvez saisir les coordonnées manuellement ou récupérer les valeurs d’étendue à partir de l’étendue actuellement visible, l’étendue des données dans toutes les couches ou l’étendue d’une couche spécifique. Lorsqu’une étendue est fournie, ArcGIS Pro envoie les valeurs d’étendue à l’aide d’un paramètre bbox avec chaque requête adressée au serveur. ArcGIS Pro dépend de la réponse du serveur pour renvoyer les entités correctes dans le bbox envoyé, le service doit donc prendre en charge le paramètre bbox conformément aux spécifications des entités API de l’OGC.

Gardez ce qui suit à l’esprit :

• Pour les couches ajoutées via la connexion de serveur API OGC, les entités présentes dans la couche ne seront par défaut pas limitées par une étendue ou un nombre maximum renvoyé. Ce qui signifie que toutes les entités seront ajoutées.
• Pour les couches ajoutées via l’onglet Portal (Portail), il est possible de définir le nombre maximum d’entités renvoyées afin de refléter la limite par défaut du service. Vous pouvez supprimer la valeur pré-renseignée pour supprimer la limitation.
• Lorsque plusieurs couches sont sélectionnées et ajoutées à la carte simultanément, les valeurs définies pour cette boîte de dialogue sont appliquées à toutes les couches sélectionnées.

Lorsqu’une couche d’entités API OGC est ajoutée à la carte, les valeurs maximum d’entités et d’étendue fonctionnent indépendamment des autres couches ouvertes dans la carte. Pour modifier ces valeurs une fois que la couche a été ajoutée à la carte, cliquez avec le bouton droit sur la couche dans la fenêtre Contents (Contenu), sélectionnez Properties (Propriétés), cliquez sur l’onglet OGC Features (Entités OGC), modifiez les valeurs selon vos besoins et cliquez sur OK.

Le modèle de données ArcGIS autorise un seul type de géométrie par table. Si une couche d’entités API de l’OGC à géométrie mixte est ajoutée à la carte, le type de géométrie de la couche est déterminé en interrogeant la première entité dans le service d’entités API de l’OGC. Par exemple, si la première ligne dans les données est un polygone, la couche des entités API de l’OGC est ajoutée à la carte en tant que couche surfacique.

Propriétés de couche d’entités d’API de l’OGC

Pour obtenir des informations sur la couche, accédez à la boîte de dialogue Layer Properties (Propriétés de la couche) en cliquant avec le bouton droit sur la couche d’entités d’API de l’OGC dans la fenêtre Contents (Contenu) et en choisissant Properties (Propriétés). Vous pouvez par exemple voir le type de données, le nom de la couche URL, et l’alias de la couche sur l’onglet Source.

Sur l’onglet OGC Features (Entités OGC) vous pouvez limiter le nombre d’entités ajoutées à la carte en définissant une valeur pour le nombre maximum d’entités renvoyées. Si une valeur a été définie lors de l’ajout de la couche à la carte, vous pouvez la modifier ici. Pour supprimer la limitation du nombre maximum d’entités, laissez la zone de texte Set the maximum features returned (Définir le nombre maximum d’entités renvoyées) vide et cliquez sur OK.

Sur l’onglet OGC Features (Entités OGC) vous pouvez limiter le nombre d’entités ajoutées à la carte en définissant une étendue qui sera utilisée en tant qu’emprise. Pour utiliser cette fonction, vous pouvez cocher la case Spatial Extent (Étendue spatiale) et renseigner une étendue en utilisant l’une des options Get extent from (Obtenir l’étendue à partir de) ou renseigner vos propres valeurs dans le formulaire Selected extent (Étendue sélectionnée). Lorsqu’une étendue est fournie, ArcGIS Pro envoie les valeurs d’étendue à l’aide d’un paramètre bbox avec chaque requête adressée au serveur. ArcGIS Pro dépend de la réponse du serveur pour renvoyer les entités correctes dans le bbox envoyé, le service doit donc prendre en charge le paramètre bbox conformément aux spécifications des entités API de l’OGC. Si vous avez défini la valeur d’étendue lorsque vous avez ajouté une couche à la carte à l’aide de la boîte de dialogue Add OGC API Layer(s) (Ajouter une ou des couches API OGC), vous pouvez voir quelles valeurs ont été définies et décider de les modifier. Si vous ne souhaitez plus limiter les entités par une étendue, vous pouvez décocher la case Spatial Extent (Étendue spatiale) et cliquer sur OK.

Obtenir les données les plus récentes de votre service

Lorsque vous utilisez une couche d’entités API de l’OGC dans ArcGIS Pro, si les enregistrements dans votre service changent souvent, vous rechercherez peut-être un moyen d’actualiser votre couche avec les données les plus récentes de votre service.

Mode de connexion de couche

Comme les couches WFS dans ArcGIS Pro, les couches d’entités API de l’OGC incluent également des modes de connexion instantané et à la demande.

• Mode instantané : cela signifie que les données sont téléchargées en local dans un dossier temporaire, puis supprimées à la fermeture de la session de ArcGIS Pro. Étant donné que la couche dans la carte utilise une copie locale des données qui ont été téléchargées lors de l’ouverture de la couche (c’est-à-dire un instantané dans le temps), la couche n’inclut pas les modifications apportées au service, sauf en cas d’actualisation manuelle. Ce mode est le plus adapté pour les services tiers ou les services ArcGIS plus anciens, car il nécessite que le service prenne en charge uniquement une requête de base pour télécharger les données à partir de votre service. Par défaut, la plupart des couches de service d’entités API de l’OGC sont ajoutées à la carte en mode instantané.
• Mode à la demande : le mode à la demande obtient les enregistrements les plus récents du service lorsque vous vous déplacez sur la carte et effectuez des zooms. Dans ce mode, ArcGIS Pro envoie des requêtes au serveur pendant que vous vous déplacez sur la carte, sélectionnez des entités ou interrogez les données. Les requêtes envoyées au serveur dans ce mode utilisent les méthodes décrites dans les spécifications des entités API de l’OGC. Les couches de service d’entités API de l’OGC de ArcGIS Enterprise sont ajoutées par défaut à la carte en mode à la demande.

Remarque :

Pour qu’un service fonctionne en mode à la demande, le service doit prendre en charge bbox, les paramètres de filtre (par exemple cql2-text) et utiliser un champ d’ID avec des valeurs uniques. Il est également recommandé que vous utilisiez ce mode uniquement si le serveur présente de bonnes performances, car ArcGIS Pro s’appuie sur le temps de réponse du serveur pour charger les données au bon moment. Veuillez noter qu’il existe des limitations connues à l’utilisation de ce mode lorsque vous envoyez des interrogations plus complexes aux données, des interrogations sur les champs de date ou d’heure, ainsi que des interrogations sur la table attributaire. Pour afficher les requêtes que ArcGIS Pro envoie à votre service pendant ces opérations, vous pouvez utiliser l’onglet HTTP de l’outil Diagnostic Monitor (Moniteur de diagnostic).

Définir le mode de connexion

Les services d’entités API de l’OGC de ArcGIS Enterprise sont ajoutés à la carte à l’aide du mode de connexion à la demande. Tous les autres services sont ajoutés à l’aide du mode de connexion instantané. Si vous voulez forcer la connexion à utiliser un mode spécifique, vous pouvez définir un paramètre de requête client sur la connexion au serveur d’API OGC, où MODE est la clé et SNAPSHOT ou ONDEMAND la valeur. Cette propriété est définie pour toutes les couches de la connexion.

Actualiser votre couche

Que vous ayez choisi d’utiliser le mode instantané ou à la demande, il existe un moyen d’actualiser les données de la couche de façon à obtenir les enregistrements les plus récents auprès du serveur.

• Pour actualiser votre couche en mode instantané, vous pouvez procéder comme suit :
  • Modifiez une des propriétés de l’onglet OGC Features (Entités de l’OGC) dans la boîte de dialogue des propriétés de la couche, puis cliquez sur OK.
  • Ajoutez de nouveau votre couche à la carte.
  • Enregistrez votre projet, puis fermez et redémarrez ArcGIS Pro.
• Pour actualiser votre couche en mode à la demande, vous pouvez vous déplacer et effectuer des zooms sur la carte, ou modifier une des propriétés des entités de l’OGC dans la boîte de dialogue des propriétés de la couche.

Si vous aviez choisi de limiter les entités à une zone d’intérêt en fournissant une étendue lors de l’ajout de la couche à la carte, les deux modes (instantané et à la demande) respectent cette étendue. Si vous voulez actualiser les données en dehors de l’étendue d’origine spécifiée, vous pouvez modifier le paramètre bbox de l’étendue ou décider de ne plus utiliser un filtre d’étendue spatiale en mettant à jour la propriété d’étendue spatiale dans l’onglet OGC Features (Entités de l’OGC) de la boîte de dialogue des propriétés de la couche.

Utiliser une couche de tuiles de carte d’API de l’OGC depuis le web

Une fois ajoutée à ArcGIS Pro, une couche de tuiles de carte d’API de l’OGC fonctionne comme une couche de carte. Vous pouvez voir les images de carte géoréférencées prégénérées ou modifier le format d’image et la structure de tuilage de la couche.

Propriétés de la couche de tuiles de carte d’API de l’OGC

Pour obtenir des informations sur la couche, accédez à la boîte de dialogue Layer Properties (Propriétés de la couche) en cliquant avec le bouton droit sur la couche de tuiles de carte d’API de l’OGC dans la fenêtre Contents (Contenu) et en choisissant Properties (Propriétés). Vous pouvez par exemple voir le type de données, le nom de la couche URL, et l’alias de la couche sur l’onglet Source. Sous l’onglet OGC API Maptiles (Tuiles de carte d’API de l’OGC), vous pouvez modifier le format d’image et la structure de tuilage.