Ajouter un champ à la couche d’analyse (Network Analyst)

Synthèse

Ajoute un champ à la sous-couche d'une couche d’analyse de réseau.

Utilisation

  • Cet outil est en général utilisé avec l’outil Ajouter des localisations pour transférer des champs des entités en entrée aux sous-couches. Par exemple, pour 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. Ensuite, 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.

Paramètres

ÉtiquetteExplicationType de données
Couche d’analyse de réseau en entrée

Couche d'analyse de réseau à laquelle le nouveau champ sera ajouté.

Network Analyst Layer
Sous-couche

Sous-couche de la couche d'analyse de réseau auquel le nouveau champ sera ajouté.

String
Nom de champ

Nom du champ ajouté à la sous-couche spécifiée de la couche d'analyse de réseau.

String
Type de champ

Spécifie le type de champ utilisé pour la création du nouveau champ.

  • TexteLe champ est de type texte. Les champs de type texte prennent en charge une chaîne de caractères.
  • Flottant (Virgule flottante 32 bits)Le champ est de type réel simple. Les champs de type réel simple prennent en charge les nombres fractionnaires compris entre -3,4E38 et 1,2E38.
  • Double (Virgule flottante 64 bits)Le champ est de type réel double. Les champs de type réel double prennent en charge les nombres fractionnaires compris entre -2,2E308 et 1,8E308.
  • Court (Entier 16 bits)Le champ est de type court. Les champs de type court prennent en charge les nombres entiers compris entre -32 768 et 32 767.
  • Long (Entier 32 bits)Le champ est de type long. Les champs de type long prennent en charge les nombres entiers compris entre 2 147 483 648 et 2 147 483 647.
  • DateLe champ est de type date. Les champs de date prennent en charge les valeurs de date et d'heure.
  • BLOB (données binaires)Le champ sera de type BLOB. Les champs de type BLOB prennent en charge les données stockées en tant que 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 (identifiant unique global)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.
  • Entier très grand (entier de 64 bits)Le type de champ est Entier très grand. Les champs de type entier très grand prennent en charge les nombres entiers compris entre -(253) et 253.
  • Temps seulementLe type de champ est Temps seulement. Les champs de type heure uniquement prennent en charge des valeurs d’heure sans valeurs de date.
  • Date uniquementLe type de champ est Date uniquement. Les champs Date uniquement prennent en charge des valeurs de date sans valeurs d’heure.
  • Décalage de l’horodatageLe type de champ est Décalage de l’horodatage. Les champs de type décalage de l’horodatage prennent en charge des valeurs de date, d’heure et un décalage par rapport à une valeur UTC (temps universel coordonné).
String
Précision de champ
(Facultatif)
Héritage :

Ce paramètre est obsolète et conservé uniquement en vue de la rétrocompatibilité.

Long
Échelle du champ
(Facultatif)
Héritage :

Ce paramètre est obsolète et conservé uniquement en vue de la rétrocompatibilité.

Long
Longueur du champ
(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
Alias du champ
(Facultatif)

Autre nom du champ. Ce nom sert à décrire les noms de champs sibyllins. Ce paramètre s’applique uniquement aux géodatabases.

String
Champ acceptant les valeurs Null
(Facultatif)

Indique si le champ peut contenir des valeurs Null (nulles). Les valeurs Null sont différentes de zéro ou les champs vides sont uniquement pris en charge pour les champs d’une géodatabase.

  • Option sélectionnée : le champ peut contenir des valeurs Null. Il s’agit de l’option par défaut.
  • Option désélectionnée : le champ ne peut pas contenir de valeurs Null.

Boolean

Sortie obtenue

ÉtiquetteExplicationType de données
Sous-couche en entrée mise à jour

La couche d’analyse de réseau mise à jour.

Network Analyst Layer

arcpy.management.AddFieldToAnalysisLayer(in_network_analysis_layer, sub_layer, field_name, field_type, {field_precision}, {field_scale}, {field_length}, {field_alias}, {field_is_nullable})
NomExplicationType 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.

  • LONGLe champ est de type long. Les champs de type long prennent en charge les nombres entiers compris entre 2 147 483 648 et 2 147 483 647.
  • TEXTLe champ est de type texte. Les champs de type texte prennent en charge une chaîne de caractères.
  • FLOATLe champ est de type réel simple. Les champs de type réel simple prennent en charge les nombres fractionnaires compris entre -3,4E38 et 1,2E38.
  • DOUBLELe champ est de type réel double. Les champs de type réel double prennent en charge les nombres fractionnaires compris entre -2,2E308 et 1,8E308.
  • SHORTLe champ est de type court. Les champs de type court prennent en charge les nombres entiers compris entre -32 768 et 32 767.
  • DATELe champ est de type date. Les champs de date prennent en charge les valeurs de date et d'heure.
  • BLOBLe champ sera de type BLOB. Les champs de type BLOB prennent en charge les données stockées en tant que 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.
  • GUIDLe 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.
  • BIGINTEGERLe type de champ est Entier très grand. Les champs de type entier très grand prennent en charge les nombres entiers compris entre -(253) et 253.
  • TIMEONLYLe type de champ est Temps seulement. Les champs de type heure uniquement prennent en charge des valeurs d’heure sans valeurs de date.
  • DATEONLYLe type de champ est Date uniquement. Les champs Date uniquement prennent en charge des valeurs de date sans valeurs d’heure.
  • TIMESTAMPOFFSETLe type de champ est Décalage de l’horodatage. Les champs de type décalage de l’horodatage prennent en charge des valeurs de date, d’heure et un décalage par rapport à une valeur UTC (temps universel coordonné).
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 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 (nulles). Les valeurs Null sont différentes de zéro ou les champs vides sont uniquement pris en charge pour les champs d’une géodatabase.

  • NULLABLELe champ peut contenir des valeurs Null. Il s’agit de l’option par défaut.
  • NON_NULLABLELe champ ne peut pas contenir de valeurs Null.
Boolean

Sortie obtenue

NomExplicationType de données
output_layer

La couche d’analyse de réseau mise à jour.

Network Analyst Layer

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 Facilities de la couche d’analyse de réseau Service Area.

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 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:
    #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"
    impedance = "TravelTime"
    default_break_values = "2 3 5"
    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.MakeServiceAreaLayer(network, layer_name,
                                                    impedance, "",
                                                    default_break_values)

    #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)))