Crée une classe d’entités contenant des entités linéaires géodésiques ou planaires à partir des valeurs d’un champ de coordonnées x de départ, d’un champ de coordonnées y de départ, d’un champ de coordonnées x d’arrivée et d’un champ de coordonnées y d’arrivée dans une table.
Utilisation
Les lignes en sortie sont construites à partir de valeurs de champ. Les valeurs de champ sont notamment :
Les coordonnées x et y d’un point de départ
Les coordonnées x et y d’un point d’arrivée
Les champs et leurs valeurs sont inclus dans la sortie.
Pour une ligne géodésique, les coordonnées x et y sont des localisations à la surface de la Terre. Pour une ligne planaire, les coordonnées sont des localisations sur un plan projeté.
Une ligne géodésique est une courbe à la surface de la Terre. Une entité linéaire géodésique n’est cependant pas stockée en tant que courbe paramétrique (vraie) en sortie ; au lieu de cela, elle est stockée en tant que polyligne densifiée représentant la trajectoire de la ligne géodésique. Si la longueur d’une ligne géodésique est relativement courte, elle peut être représentée par une ligne droite dans la sortie. À mesure que la longueur de la ligne augmente, davantage de sommets sont utilisés pour représenter la trajectoire.
Lorsque la sortie est une classe d’entités dans une géodatabase, les valeurs du champ Shape_Length sont toujours exprimées dans les unités du système de coordonnées en sortie spécifiées par le paramètre Spatial Reference (Référence spatiale). Il s’agit des longueurs planaires des polylignes. Pour mesurer une longueur ou une distance géodésique, utilisez l’outil ArcGIS Pro Measure (Mesurer) et choisissez l’option Geodesic (Géodésique), Loxodrome (Loxodromie) ou Great Elliptic (Grande ellipse) en conséquence avant de prendre une mesure.
Table en entrée. Il peut s’agir d’un fichier texte, CSV, Excel, d’une table dBASE ou d’une table de géodatabase.
Table View
Classe d’entités en sortie
Classe d’entités en sortie contenant les lignes géodésiques ou planaires.
Feature Class
Champ de X de début
Champ numérique dans la table en entrée contenant les coordonnées x (ou longitudes) des points de départ des lignes à positionner dans le système de coordonnées en sortie spécifié par le paramètre Spatial Reference (Référence spatiale).
Field
Champ de Y de début
Champ numérique dans la table en entrée contenant les coordonnées y (ou latitudes) des points de départ des lignes à positionner dans le système de coordonnées en sortie spécifié par le paramètre Spatial Reference (Référence spatiale).
Field
Fin du champ X
Champ numérique dans la table en entrée contenant les coordonnées x (ou longitudes) des points d’arrivée des lignes à positionner dans le système de coordonnées en sortie spécifié par le paramètre Spatial Reference (Référence spatiale).
Field
Fin du champ Y
Champ numérique dans la table en entrée contenant les coordonnées y (ou latitudes) des points d’arrivée des lignes à positionner dans le système de coordonnées en sortie spécifié par le paramètre Spatial Reference (Référence spatiale).
Field
Type de ligne
(Facultatif)
Spécifie le type de ligne à construire.
Géodésique—Un type de ligne géodésique qui représente de la manière la plus précise la distance la plus courte entre deux points sur la surface de la Terre sera créé. Il s’agit de l’option par défaut.
Great circle (Grand cercle)—Un type de ligne géodésique qui représente le chemin entre deux points sur l’intersection entre la surface de la Terre et un plan qui passe par le centre de la Terre sera créé. Si la valeur du paramètre Spatial Reference (Référence spatiale) est un système de coordonnées basé sur une sphéroïde, la ligne est une grande ellipse. Si la valeur du paramètre Spatial Reference (Référence spatiale) est un système de coordonnées basé sur une sphéroïde, la ligne est appelée uniquement un grand cercle, un cercle du rayon le plus grand sur la surface sphérique.
Loxodromie—Un type de ligne géodésique, également appelée loxodromie, qui représente un chemin entre deux points à la surface d’une sphéroïde définie par un azimut constant à partir d’un pôle sera créé. Les loxodromies sont représentées par une ligne droite dans la projection de Mercator.
Section normale—Un type de ligne géodésique qui représente un chemin entre deux points à la surface d’une sphéroïde définie par l’intersection de la surface de la sphéroïde et un plan qui passe par les deux points et est normal (perpendiculaire) à la surface de la sphéroïde au point de départ des deux points sera créé. La ligne de section normale du point A au point B est différente de celle qui relie le point B et le point A.
Ligne planaire—La ligne droite sur le plan projeté est utilisée. Une ligne planaire ne représente généralement pas précisément la distance la plus courte sur la surface de la Terre, comme le fait la ligne géodésique. Cette option n’est pas disponible pour les systèmes de coordonnées géographiques.
String
ID
(Facultatif)
Un champ dans la table en entrée. Ce champ et les valeurs sont inclus dans la sortie et peuvent être utilisés pour joindre les entités en sortie aux enregistrements de la table en entrée.
Field
Référence spatiale
(Facultatif)
Référence spatiale de la classe d’entités en sortie. La valeur par défaut est GCS_WGS_1984 ou le système de coordonnées en entrée, s’il n’est pas Inconnu.
Spatial Reference
Conserver les attributs
(Facultatif)
Spécifie si les champs en entrée restants sont ajoutés dans la classe d’entités en sortie.
Activé—Les champs en entrée restants sont ajoutés dans la classe d’entités en sortie. Un nouveau champ, ORIG_FID, est également ajouté à la classe d’entités en sortie pour stocker les valeurs des identifiants d’entité en entrée.
Décoché—Les champs en entrée restants ne sont pas ajoutés dans la classe d’entités en sortie. Il s’agit de l’option par défaut.
Table en entrée. Il peut s’agir d’un fichier texte, CSV, Excel, d’une table dBASE ou d’une table de géodatabase.
Table View
out_featureclass
Classe d’entités en sortie contenant les lignes géodésiques ou planaires.
Feature Class
startx_field
Champ numérique dans la table en entrée contenant les coordonnées x (ou longitudes) des points de départ des lignes à positionner dans le système de coordonnées en sortie spécifié par le paramètre spatial_reference.
Field
starty_field
Champ numérique dans la table en entrée contenant les coordonnées y (ou latitudes) des points de départ des lignes à positionner dans le système de coordonnées en sortie spécifié par le paramètre spatial_reference.
Field
endx_field
Champ numérique dans la table en entrée contenant les coordonnées x (ou longitudes) des points d’arrivée des lignes à positionner dans le système de coordonnées en sortie spécifié par le paramètre spatial_reference.
Field
endy_field
Champ numérique dans la table en entrée contenant les coordonnées y (ou latitudes) des points d’arrivée des lignes à positionner dans le système de coordonnées en sortie spécifié par le paramètre spatial_reference.
Field
line_type
(Facultatif)
Spécifie le type de ligne à construire.
GEODESIC—Un type de ligne géodésique qui représente de la manière la plus précise la distance la plus courte entre deux points sur la surface de la Terre sera créé. Il s’agit de l’option par défaut.
GREAT_CIRCLE—Un type de ligne géodésique qui représente le chemin entre deux points sur l’intersection entre la surface de la Terre et un plan qui passe par le centre de la Terre sera créé. Si la valeur du paramètre Spatial Reference (Référence spatiale) est un système de coordonnées basé sur une sphéroïde, la ligne est une grande ellipse. Si la valeur du paramètre Spatial Reference (Référence spatiale) est un système de coordonnées basé sur une sphéroïde, la ligne est appelée uniquement un grand cercle, un cercle du rayon le plus grand sur la surface sphérique.
RHUMB_LINE—Un type de ligne géodésique, également appelée loxodromie, qui représente un chemin entre deux points à la surface d’une sphéroïde définie par un azimut constant à partir d’un pôle sera créé. Les loxodromies sont représentées par une ligne droite dans la projection de Mercator.
NORMAL_SECTION—Un type de ligne géodésique qui représente un chemin entre deux points à la surface d’une sphéroïde définie par l’intersection de la surface de la sphéroïde et un plan qui passe par les deux points et est normal (perpendiculaire) à la surface de la sphéroïde au point de départ des deux points sera créé. La ligne de section normale du point A au point B est différente de celle qui relie le point B et le point A.
PLANAR—La ligne droite sur le plan projeté est utilisée. Une ligne planaire ne représente généralement pas précisément la distance la plus courte sur la surface de la Terre, comme le fait la ligne géodésique. Cette option n’est pas disponible pour les systèmes de coordonnées géographiques.
String
id_field
(Facultatif)
Un champ dans la table en entrée. Ce champ et les valeurs sont inclus dans la sortie et peuvent être utilisés pour joindre les entités en sortie aux enregistrements de la table en entrée.
Field
spatial_reference
(Facultatif)
Référence spatiale de la classe d’entités en sortie. Une référence spatiale peut être spécifiée comme l’une des conditions suivantes :
Le chemin vers un fichier .prj, comme C:/workspace/watershed.prj
Le chemin vers une classe d’entités ou un jeu de classes d’entités dont vous souhaitez appliquer la référence spatiale (C:/workspace/myproject.gdb/landuse/grassland, par exemple)
Un objet SpatialReference, tel que arcpy.SpatialReference("C:/data/Africa/Carthage.prj")
Spatial Reference
attributes
(Facultatif)
Spécifie si les champs en entrée restants sont ajoutés dans la classe d’entités en sortie.
ATTRIBUTES—Les champs en entrée restants sont ajoutés dans la classe d’entités en sortie. Un nouveau champ, ORIG_FID, est également ajouté à la classe d’entités en sortie pour stocker les valeurs des identifiants d’entité en entrée.
NO_ATTRIBUTES—Les champs en entrée restants ne sont pas ajoutés dans la classe d’entités en sortie. Il s’agit de l’option par défaut.
Boolean
Exemple de code
Exemple d’utilisation de la fonction XYToLine (script autonome)
Cet exemple convertit une table DBF en lignes géodésiques à deux points.
# Import system modules
import arcpy
# Set local variables
input_table = r"c:\workspace\city2city.dbf"
out_lines = r"c:\workspace\flt4421.gdb\routing001"
# XY To Line
arcpy.management.XYToLine(input_table, out_lines, "LOND1", "LATD1", "LOND2",
"LATD2", "GEODESIC", "idnum")