arcpy.na.AddFieldToAnalysisLayer(in_network_analysis_layer, sub_layer, field_name, field_type, {field_precision}, {field_scale}, {field_length}, {field_alias}, {field_is_nullable})
|
Nom
|
Explication
|
Type de données
|
|
in_network_analysis_layer
|
Couche d'analyse de réseau à laquelle le nouveau champ sera ajouté.
|
Network Analyst Layer
|
|
sub_layer
|
Sous-couche de la couche d'analyse de réseau auquel le nouveau champ sera ajouté.
|
String
|
|
field_name
|
Nom du champ ajouté à la sous-couche spécifiée de la couche d'analyse de réseau.
|
String
|
|
field_type
|
Spécifie le type de champ utilisé pour la création du nouveau champ.
LONG—Le champ sera de type long. Les champs longs prennent en charge les nombres entiers compris entre -2 147 483 648 et 2 147 483 647.
TEXT—Le champ sera de type texte. Les champs de texte prennent en charge une chaîne de caractères.
FLOAT—Le champ sera de type réel simple. Les champs de type réel simple prennent en charge les nombres fractionnels compris entre -3,4E38 et 1,2E38.
DOUBLE—Le champ sera de type réel double. Les champs de type réel double prennent en charge les nombres fractionnels compris entre -2,2E308 et 1,8E308.
SHORT—Le champ sera de type court. Les champs courts prennent en charge les nombres entiers compris entre -32 768 et 32 767.
DATE—Le champ sera de type date. Les champs de date prennent en charge les valeurs d’heure et de date.
BLOB—Le champ sera de type BLOB. Les champs BLOB prennent en charge les données stockées sous forme d’une longue séquence de nombres binaires. Vous avez besoin d’une visionneuse ou d’un chargeur personnalisé, ou d’une application tierce pour charger des attributs dans un champ BLOB ou afficher le contenu d’un champ BLOB.
GUID—Le champ sera de type GUID. Les champs GUID contiennent des chaînes de registre constituées de 36 caractères placés entre des accolades.
BIGINTEGER—Le champ sera de type entier très grand. Les champs d’entiers très grands prennent en charge les nombres entiers compris entre -(253) et 253.
TIMEONLY—Le champ sera de type heure uniquement. Les champs Heure uniquement prennent en charge des valeurs d’heure sans valeurs de date.
DATEONLY—Le champ sera de type date uniquement. Les champs Date uniquement prennent en charge des valeurs de date sans valeurs d’heure.
TIMESTAMPOFFSET—Le champ sera de type décalage de l’horodatage. Les champs Décalage de l’horodatage prennent en charge des valeurs de date, d’heure et un décalage par rapport à une valeur de temps universel coordonné (UTC).
|
String
|
|
field_precision
(Facultatif)
|
Héritage :
Ce paramètre est obsolète et conservé uniquement en vue de la rétrocompatibilité.
|
Long
|
|
field_scale
(Facultatif)
|
Héritage :
Ce paramètre est obsolète et conservé uniquement en vue de la rétrocompatibilité.
|
Long
|
|
field_length
(Facultatif)
|
Longueur du champ. Définit le nombre maximal de caractères autorisés pour chaque enregistrement du champ. Si aucune longueur de champ n’est spécifiée, une longueur égale à 255 est utilisée.
La longueur de champ ne s'applique qu'aux champs de type texte.
|
Long
|
|
field_alias
(Facultatif)
|
Autre nom du champ. Ce nom est utilisé pour décrire les noms de champ sibyllins. Ce paramètre s’applique uniquement aux géodatabases.
|
String
|
|
field_is_nullable
(Facultatif)
|
Indique si le champ peut contenir des valeurs Null. Les valeurs Null sont des valeurs différentes de zéro ou des champs vides et ne sont prises en charge que dans les champs d’une géodatabase.
|
Boolean
|
Sortie dérivée
|
Nom
|
Explication
|
Type de données
|
|
output_layer
|
La couche d’analyse de réseau mise à jour.
|
Network Analyst Layer
|
Exemple de code
Conseil :
Bien que cet outil puisse être utilisé dans un script Python, la meilleure pratique pour effectuer une analyse de réseau dans Python consiste à lui préférer les classes du solveur dans le module arcpy.nax. En savoir plus sur l’analyse de réseau dans Python.
Exemple 1 d’utilisation de la fonction AddFieldToAnalysisLayer (fenêtre Python)
Le script de fenêtre Python suivant montre comment ajouter un champ UniqueID à la sous-couche Facilities de la couche d’analyse de réseau Service Area.
arcpy.na.AddFieldToAnalysisLayer("Service Area", "Facilities", "UniqueID",
"LONG")
Exemple 2 d’utilisation de la fonction AddFieldToAnalysisLayer (processus)
Le script Python autonome ci-dessous montre comment la fonction AddFieldToAnalysisLayer permet de transférer le champ StationID des entités de caserne de pompiers en entrée aux entités polygone de zone de desserte de 2, 3 et 5 minutes calculées à partir d’une analyse de la zone de desserte. Le champ StationID permet de joindre d’autres attributs des entités de caserne de pompiers aux entités polygones de zone de desserte.
Héritage :
La fonction GetNASublayer permet d’extraire les sous-couches d’une couche d’analyse de réseau. Elle a été introduite dans ArcGIS Pro 2.7. Dans les versions précédentes, la meilleure manière d’extraire un objet de sous-couche d’une couche d’analyse de réseau consistait à utiliser la méthode listLayers de l’objet Layer d’analyse de réseau en utilisant le nom de la sous-couche en tant que caractère générique.
# Name: AddFieldToAnalysisLayer_Workflow.py
# Description: Transfers the Address field from the input fire station
# features to the 2-,3-, and 5-minute service area polygon features
# calculated from a service area analysis. The Address field can
# be used to join other attributes from the fire station features
# to the service area polygon features.
# Requirements: Network Analyst extension
#Import system modules
import arcpy
from arcpy import env
import os
try:
#Set environment settings
output_dir = "C:/Data"
#The NA layer's data will be saved to the workspace specified here
env.workspace = os.path.join(output_dir, "Output.gdb")
env.overwriteOutput = True
#Set local variables
input_gdb = "C:/Data/SanFrancisco.gdb"
network = os.path.join(input_gdb, "Transportation", "Streets_ND")
layer_name = "FireStationsCoverage"
travel_mode = "Driving Time"
cutoffs = [2, 3, 5] #minutes
field_to_add = "Address"
field_type = "TEXT"
facilities = os.path.join(input_gdb, "Analysis", "FireStations")
search_tolerance = "2 Miles"
out_featureclass = os.path.join(output_dir, "Output.gdb",
"FireStationsCoverageArea")
#Create a new service area analysis layer. For this scenario, the default
#value for all the remaining parameters statisfies the analysis requirements
result_object = arcpy.na.MakeServiceAreaAnalysisLayer(network, layer_name,
travel_mode, cutoffs=cutoffs)
#Get the layer object from the result object. The service area layer can now
#be referenced using the layer object.
layer_object = result_object.getOutput(0)
#Get the names of all the sublayers within the service area layer.
sublayer_names = arcpy.na.GetNAClassNames(layer_object)
#Stores the layer names that we will use later
facilities_layer_name = sublayer_names["Facilities"]
polygons_layer_name = sublayer_names["SAPolygons"]
#Add the Address field to the Facilities sublayer of the service area layer.
#This is done before loading the fire stations as facilities so that the
#Address values can be transferred from the input features to the
#Facilities sublayer.
arcpy.na.AddFieldToAnalysisLayer(layer_object, facilities_layer_name,
field_to_add, field_type)
#Add the fire station features as Facilities and map the Name and the
#Address fields from the fire station features to the Name and Address
#properties on the Facilities sublayer
field_mappings = arcpy.na.NAClassFieldMappings(layer_object,
facilities_layer_name)
field_mappings['Name'].mappedFieldName = "Name"
field_mappings['Address'].mappedFieldName = "Address"
arcpy.na.AddLocations(layer_object, facilities_layer_name, facilities,
field_mappings, search_tolerance)
#Solve the service area layer
arcpy.na.Solve(layer_object)
#Get the layer objects for all the sublayers within the service area layer
facilities_sublayer = layer_object.listLayers(facilities_layer_name)[0]
polygons_sublayer = layer_object.listLayers(polygons_layer_name)[0]
#Transfer the Address field from the Facilities sublayer to the Polygons
#sublayer of the service area layer since we wish to export the polygons.
#The FacilityID field in the Polygons sublayer is related to the ObjectID
#field in the Facilities sublayer.
arcpy.management.JoinField(polygons_sublayer, "FacilityID",
facilities_sublayer, "ObjectID", field_to_add)
#Export the Polygons sublayer to a feature class on disk.
arcpy.management.CopyFeatures(polygons_sublayer, out_featureclass)
print("Script completed successfully")
except Exception as e:
# If an error occurred, print line number and error message
import traceback, sys
tb = sys.exc_info()[2]
print("An error occurred on line %i" % tb.tb_lineno)
print(str(e))