Résumé
Ajoute un champ à la sous-couche d'une couche d’analyse de réseau.
Utilisation
Cet outil s'utilise principalement avec l'outil Ajouter des localisations pour transférer des champs des entités en entrée aux sous-couches. Par exemple, si vous souhaitez transférer un champ appelé UniqueID de vos entités en entrée vers la sous-couche Facilities de la couche Service Area, utilisez cet outil pour ajouter le champ UniqueID à la sous-couche Facilities, puis utilisez les appariements de champs dans l’outil Ajouter des emplacements pour fournir des valeurs en entrée pour le champ UniqueID.
Il est possible d'ajouter des champs à l'une des sous-couches des couches d'analyse de réseau.
Syntaxe
arcpy.na.AddFieldToAnalysisLayer(in_network_analysis_layer, sub_layer, field_name, field_type, {field_precision}, {field_scale}, {field_length}, {field_alias}, {field_is_nullable})| Paramètre | 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 | Type de champ utilisé pour la création du nouveau champ.
| String |
field_precision (Facultatif) | Nombre de chiffres pouvant être stockés dans le champ. Tous les chiffres sont comptabilisés, qu’ils se trouvent à gauche ou à droite de la virgule. La valeur de paramètre est valide uniquement pour les champs de type numérique. | Long |
field_scale (Facultatif) | Nombre de décimales stockées dans un champ. Ce paramètre est utilisé uniquement dans les champs de données de type Réel simple ou Réel double. | Long |
field_length (Facultatif) | Longueur du champ en cours d'ajout. Définit le nombre maximal de caractères autorisés pour chaque enregistrement du champ. Ce paramètre est uniquement applicable aux champs de type texte. | Long |
field_alias (Facultatif) | Autre nom donné au champ. Ce nom sert à décrire les noms de champs 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 différentes de zéro ou de champs vides et sont uniquement valables pour les champs d'une géodatabase.
| Boolean |
Sortie dérivée
| Nom | Explication | Type de données |
| output_layer | Couche d’analyse de réseau mise à jour. | Couche Network Analyst |
Exemple de code
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")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 2, 3 et 5 minutes calculées à partir d’une analyse des zones 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 peut être utilisée pour 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:
#Check out Network Analyst license if available. Fail if the Network Analyst license is not available.
if arcpy.CheckExtension("network") == "Available":
arcpy.CheckOutExtension("network")
else:
raise arcpy.ExecuteError("Network Analyst Extension license is not available.")
#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))Environnements
Informations de licence
- Basic: Oui
- Standard: Oui
- Advanced: Oui
Rubriques connexes
Vous avez un commentaire à formuler concernant cette rubrique ?