WFS vers classe d’entités (Conversion)

Synthèse

Importe un type d’entité depuis un service WFS (Web Feature Service) dans une classe d’entités d’une géodatabase.

Utilisation

  • Téléchargez des entités depuis un service WFS simple ou complexe.

  • Si l’URL a été spécifiée pour le paramètre Serveur WFS, tous les types d’entité publiés depuis le serveur sont répertoriés comme options du paramètre Sélectionner le type d’entité à extraire. Cette liste peut ainsi inclure des types d’entités WFS pour les écoles, les routes, et les parcelles.

  • Par défaut, toutes les entités de la source WFS sont ajoutées à la classe d’entités. L’environnement Étendue en sortie peut permettre de limiter les entités aux entités qui croisent une étendue définie par l’utilisateur. Vous pouvez également spécifier un mot-clé de configuration en sortie à l’aide de la section des paramètres de géodatabase des paramètres d’environnement.

Paramètres

ÉtiquetteExplicationType de données
Serveur WFS

URL du service WFS source (par exemple, http://sampleserver6.arcgisonline.com/arcgis/services/SampleWorldCities/MapServer/WFSServer?). Si l’entrée est un service WFS complexe (le paramètre Service WFS complexe est activé), il peut également s’agir du chemin vers le fichier .xml.

String
Sélectionner le type d’entité à extraire

Nom de la couche WFS qui sera extraite depuis le service WFS en entrée.

String
Emplacement en sortie

Emplacement de la classe d’entités en sortie ou de la géodatabase.

Si l’entrée est un service WFS simple, l’emplacement en sortie peut être une géodatabase ou un jeu de données d’entités dans une géodatabase. Si l’emplacement en sortie correspond à un jeu de classes d’entités, les coordonnées font l’objet d’une conversion entre le système de coordonnées source et le système de coordonnées du jeu de classes d’entités.

Si l’entrée est un service WFS complexe, l’emplacement en sortie doit être un dossier.

Workspace; Feature Dataset; Folder
Nom

Nom de la classe d’entités en sortie ou de la géodatabase.

Si l’entrée est un service WFS simple, le nom sert à créer une classe d’entités dans l’emplacement en sortie. Si le nom de la classe d’entités existe déjà dans la géodatabase, il sera automatiquement incrémenté. Par défaut, le nom du type d'entité est utilisé.

Si l’entrée est un service WFS complexe, le nom sert à créer une géodatabase dans l’emplacement en sortie.

String
Service WFS complexe
(Facultatif)

Indique si la valeur du paramètre Serveur WFS est un service WFS complexe.

  • Activé : le service WFS est un service WFS complexe.
  • Désactivé : le service WFS n’est pas un service WFS complexe. Il s’agit de l’option par défaut.

Boolean
Nombre d’entités maximal
(Facultatif)

Le nombre maximal d’entités pouvant être renvoyées. La valeur par défaut est 1000.

Long
Exposer les métadonnées
(Facultatif)

Indique si des tables de métadonnées sont créées à partir du service. Cette option s’applique uniquement aux services WFS complexes.

  • Option activée : des tables de métadonnées seront créées dans la géodatabase en sortie.
  • Option désactivée : des tables de métadonnées ne seront pas créées dans la géodatabase en sortie. Il s’agit de l’option par défaut.

Boolean
Échanger l’ordre des axes XY
(Facultatif)

Indique si l’ordre des axes x,y de la classe d’entités en sortie sera échangé. Pour certains services WFS, l’ordre des coordonnées x,y peut être échangé côté serveur, ce qui provoque un mauvais affichage de la classe d’entités.

  • Option activée : l’ordre des axes x,y sera échangé.
  • Option désactivée : l’ordre des axes x,y ne sera pas échangé. Il s’agit de l’option par défaut.

Boolean
Taille de la page
(Facultatif)

Taille de page utilisée lors du téléchargement des entités à partir du service WFS. La valeur par défaut est 100.

Certains serveurs limitent le nombre d’entités qu’il est possible de demander simultanément ou voient leurs performances ralenties lorsque le nombre d’entités demandés dans une seule requête est élevé. Utilisez ce paramètre pour demander un nombre d’entités plus petit sur plusieurs pages afin d’éviter les dépassements du délai d’expiration des serveurs ou d’être contraints par les limites maximales d’entités.

Ce paramètre s’applique uniquement aux services WFS 2.0 simples qui prennent en charge les paramètres WFS startIndex et count. Le paramètre est ignoré pour les anciennes versions de WFS (1.1.0 et 1.0.0).

Long

Sortie obtenue

ÉtiquetteExplicationType de données
Classe d’entités en sortie

Classe d’entités en sortie lors de la conversion d’un service WFS simple.

Feature Class
Espace de travail en sortie

Géodatabase du fichier en sortie lors de la conversion d’un service WFS complexe.

Workspace

arcpy.conversion.WFSToFeatureClass(input_WFS_server, WFS_feature_type, out_path, out_name, {is_complex}, {max_features}, {expose_metadata}, {swap_xy}, {page_size})
NomExplicationType de données
input_WFS_server

URL du service WFS source (par exemple, http://sampleserver6.arcgisonline.com/arcgis/services/SampleWorldCities/MapServer/WFSServer?). Si l’entrée est un service WFS complexe (is_complex a pour valeur COMPLEX), il peut également s’agir du chemin vers le fichier .xml.

String
WFS_feature_type

Nom de la couche WFS qui sera extraite depuis le service WFS en entrée.

String
out_path

Emplacement de la classe d’entités en sortie ou de la géodatabase.

Si l’entrée est un service WFS simple, l’emplacement en sortie peut être une géodatabase ou un jeu de données d’entités dans une géodatabase. Si l’emplacement en sortie correspond à un jeu de classes d’entités, les coordonnées font l’objet d’une conversion entre le système de coordonnées source et le système de coordonnées du jeu de classes d’entités.

Si l’entrée est un service WFS complexe, l’emplacement en sortie doit être un dossier.

Workspace; Feature Dataset; Folder
out_name

Nom de la classe d’entités en sortie ou de la géodatabase.

Si l’entrée est un service WFS simple, le nom sert à créer une classe d’entités dans l’emplacement en sortie. Si le nom de la classe d’entités existe déjà dans la géodatabase, il sera automatiquement incrémenté. Par défaut, le nom du type d'entité est utilisé.

Si l’entrée est un service WFS complexe, le nom sert à créer une géodatabase dans l’emplacement en sortie.

String
is_complex
(Facultatif)

Indique si la valeur du paramètre input_WFS_server est un service WFS complexe.

  • COMPLEXLe service WFS est un service WFS complexe.
  • NOT_COMPLEXLe service WFS n’est pas un service WFS complexe. Il s’agit de l’option par défaut.
Boolean
max_features
(Facultatif)

Le nombre maximal d’entités pouvant être renvoyées. La valeur par défaut est 1000.

Long
expose_metadata
(Facultatif)

Indique si des tables de métadonnées sont créées à partir du service. Cette option s’applique uniquement aux services WFS complexes.

  • EXPOSE_METADATADes tables de métadonnées seront créées dans la géodatabase en sortie.
  • DO_NOT_EXPOSEDes tables de métadonnées ne seront pas créées dans la géodatabase en sortie. Il s’agit de l’option par défaut.
Boolean
swap_xy
(Facultatif)

Indique si l’ordre des axes x,y de la classe d’entités en sortie sera échangé. Pour certains services WFS, l’ordre des coordonnées x,y peut être échangé côté serveur, ce qui provoque un mauvais affichage de la classe d’entités.

  • SWAP_XYL’ordre des axes x,y sera échangé.
  • DO_NOT_SWAP_XYL’ordre des axes x,y ne sera pas échangé. Il s’agit de l’option par défaut.
Boolean
page_size
(Facultatif)

Taille de page utilisée lors du téléchargement des entités à partir du service WFS. La valeur par défaut est 100.

Certains serveurs limitent le nombre d’entités qu’il est possible de demander simultanément ou voient leurs performances ralenties lorsque le nombre d’entités demandés dans une seule requête est élevé. Utilisez ce paramètre pour demander un nombre d’entités plus petit sur plusieurs pages afin d’éviter les dépassements du délai d’expiration des serveurs ou d’être contraints par les limites maximales d’entités.

Ce paramètre s’applique uniquement aux services WFS 2.0 simples qui prennent en charge les paramètres WFS startIndex et count. Le paramètre est ignoré pour les anciennes versions de WFS (1.1.0 et 1.0.0).

Long

Sortie obtenue

NomExplicationType de données
out_feature_class

Classe d’entités en sortie lors de la conversion d’un service WFS simple.

Feature Class
out_gdb

Géodatabase du fichier en sortie lors de la conversion d’un service WFS complexe.

Workspace

Exemple de code

Exemple 1 d'utilisation de l'outil WFSToFeatureClass (script autonome)

Le script ci-après illustre l’utilisation de la fonction WFSToFeatureClass dans un script autonome.


# Name: WFSToFeatureClass_example1.py
# Description: Create a feature class from a WFS service

# Import arcpy module
import arcpy

# Set local variables
wfs_service = "http://sampleserver6.arcgisonline.com/arcgis/services/SampleWorldCities/MapServer/WFSServer?request=GetCapabilities&service=WFS"
wfs_featuretype = "cities"
out_location = "C:/Data/Default.gdb"
out_name = "SampleWorldCities"

# Run the WFSToFeatureClass tool
arcpy.conversion.WFSToFeatureClass(wfs_service, wfs_featuretype, out_location, out_name)
Exemple 2 d’utilisation de la fonction WFSToFeatureClass (script autonome)

Le script ci-après illustre l’utilisation de la fonction WFSToFeatureClass pour limiter la sortie à une zone géographique spécifiée, à l’aide de l’environnement Étendue.


# Name: WFSToFeatureClass_example2.py
# Description: Create a feature class from a WFS service and use extent environment

# Import arcpy module
import arcpy

# Use arcpy.EnvManager to set the extent to be used by the tool
with arcpy.EnvManager(extent=arcpy.Extent(9.3385, 45.7384250210615, 17.2915, 49.7115749789385, spatial_reference=arcpy.SpatialReference('GCS_WGS_1984'))):
    arcpy.conversion.WFSToFeatureClass(
        input_WFS_server="http://sampleserver6.arcgisonline.com/arcgis/services/SampleWorldCities/MapServer/WFSServer",
        WFS_feature_type="Cities",
        out_path=r"C:\MyProject\MyData.gdb",
        out_name="cities_use_extent",
        is_complex="NOT_COMPLEX",
        max_features=1000,
        expose_metadata="DO_NOT_EXPOSE",
        swap_xy="DO_NOT_SWAP_XY",
        page_size=100
    )

Rubriques connexes