Disponible avec une licence Network Analyst.
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 Ressources de la couche Zone de desserte, utilisez cet outil pour ajouter le champ UniqueID à la sous-couche Ressources, puis utilisez les appariements de champs dans l'outil Ajouter des localisations 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
AddFieldToAnalysisLayer_na (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, à gauche comme à 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 possibles dans un champ. Ce paramètre est utilisé uniquement dans les champs de données de type Réel simple et 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. Cette option n'est applicable qu'aux champs de type texte ou blob. | Long |
field_alias (Facultatif) | Autre nom donné au champ. Ce nom permet d'attribuer des noms plus explicites aux champs portant des noms sibyllins. Ce paramètre d'alias de champs ne s'applique qu'aux géodatabases et aux couvertures. | String |
field_is_nullable (Facultatif) | Indique si le champ peut contenir des valeurs nulles. Des valeurs nulles sont différentes de champs zéro ou vides et sont uniquement valables pour les champs d'une géodatabase.
| Boolean |
Exemple de code
Exemple 1 d'utilisation de l'outil Ajouter un champ à la couche d'analyse (fenêtre Python)
Le script de fenêtre Python suivant montre comment ajouter un champ UniqueID à la sous-couche Ressources de la couche d'analyse de réseau Zone de desserte.
arcpy.na.AddFieldToAnalysisLayer("Service Area", "Facilities", "UniqueID",
"LONG")
Exemple 2 d'utilisation de l'outil Ajouter un champ à la couche d'analyse (workflow)
Le script Python autonome ci-dessous montre comment l'outil Ajouter un champ à la couche d'analyse 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.
# 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
try:
#Check out the Network Analyst extension license
arcpy.CheckOutExtension("Network")
#Set environment settings
env.workspace = "C:/data/SanFrancisco.gdb"
env.overwriteOutput = True
#Set local variables
inNetworkDataset = "Transportation/Streets_ND"
outNALayerName = "FireStationsCoverage"
impedanceAttribute = "TravelTime"
defaultBreakValues = "2 3 5"
fieldName = "Address"
fieldType = "TEXT"
inFeatures = "Analysis/FireStations"
searchTolerance = "2 Miles"
outFeatures = outNALayerName + "Area"
saFacilities = "Facilities"
saPolygons = "SAPolygons"
#Create a new service area analysis layer. For this scenario, the default
#value for all the remaining parameters statisfies the analysis requirements
outNALayer = arcpy.na.MakeServiceAreaLayer(inNetworkDataset, outNALayerName,
impedanceAttribute,"",
defaultBreakValues)
#Get the layer object from the result object. The service layer can now be
#referenced using the layer object.
outNALayer = outNALayer.getOutput(0)
#Get the names of all the sublayers within the service area layer.
subLayerNames = arcpy.na.GetNAClassNames(outNALayer)
#Stores the layer names that we will use later
facilitiesLayerName = subLayerNames[saFacilities]
polygonLayerName = subLayerNames[saPolygons]
#Get the layer objects for all the sublayers within the service area layer
#The first layer returned by ListLayers is the Service area layer itself
#which we don't want to use.
subLayers = {}
for layer in arcpy.mapping.ListLayers(outNALayer)[1:]:
subLayers[layer.datasetName] = layer
#Store the layer objects that we will use later
facilitiesLayer = subLayers[saFacilities]
polygonLayer = subLayers[saPolygons]
#Add a 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. The service area layer created previously is
#referred by the layer object.
arcpy.na.AddFieldToAnalysisLayer(outNALayer,facilitiesLayerName,fieldName,
fieldType)
#Add the fire station features as Facilities and map the Name and the
#Address properties from the Name and Address fields from fire station
#features using the field mappings.
fieldMappings = arcpy.na.NAClassFieldMappings(outNALayer, facilitiesLayerName)
fieldMappings['Name'].mappedFieldName = "Name"
fieldMappings['Address'].mappedFieldName = "Address"
arcpy.na.AddLocations(outNALayer,facilitiesLayerName,inFeatures,
fieldMappings, searchTolerance)
#Solve the service area layer
arcpy.na.Solve(outNALayer)
#Transfer the Address field from Facilities sublayer to Polygons sublayer
#of the service area layer since we wish to export the polygons. The
#FacilityID field in Polygons sub layer is related to the ObjectID field in
#the Facilities sub layer.
arcpy.management.JoinField(polygonLayer, "FacilityID",facilitiesLayer,
"ObjectID", fieldName)
#Export the Polygons sublayer to a feature class on disk.
arcpy.management.CopyFeatures(polygonLayer, outFeatures)
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
- ArcGIS Desktop Basic: Oui
- ArcGIS Desktop Standard: Oui
- ArcGIS Desktop Advanced: Oui