Mettre à jour par des champs d'ID de substitution (Network Analyst)

Synthèse

Met à jour toutes les références au tronçon dans les classes d'entités tournants du jeu de données réseau à l'aide d'un champ d'ID de substitution. Cet outil doit être utilisé après avoir apporté des modifications aux entités linéaires en entrée référencées par les entités tournants pour synchroniser les entités tournants selon les champs d'ID de substitution.

Utilisation

  • Cet outil met à jour les valeurs du champ Edge#FID de la classe d'entités tournants selon les ID de substitution stockés dans chaque entité tournant. Si les classes d'entités tournants ne référencent pas les tronçons selon les ID de substitution, utilisez d'abord l'outil Renseigner les champs d'ID de substitution pour créer et renseigner les champs d'ID de substitution.

Paramètres

ÉtiquetteExplicationType de données
Jeu de données réseau en entrée

Jeu de données réseau dont les classes d'entités tournants sont mises à jour par leurs champs d'ID de substitution.

Network Dataset Layer
Nom du champ d'ID de substitution

Nom du champ d'ID de substitution sur les sources de tronçons du jeu de données réseau. Toutes les sources de tronçons référencées par des tournants doivent avoir le même nom de champ d'ID de substitution.

String

Sortie obtenue

ÉtiquetteExplicationType de données
Jeu de données réseau en entrée mis à jour

Jeu de données réseau mis à jour.

Couche du jeu de données réseau

arcpy.management.UpdateByAlternateIDFields(in_network_dataset, alternate_ID_field_name)
NomExplicationType de données
in_network_dataset

Jeu de données réseau dont les classes d'entités tournants sont mises à jour par leurs champs d'ID de substitution.

Network Dataset Layer
alternate_ID_field_name

Nom du champ d'ID de substitution sur les sources de tronçons du jeu de données réseau. Toutes les sources de tronçons référencées par des tournants doivent avoir le même nom de champ d'ID de substitution.

String

Sortie obtenue

NomExplicationType de données
out_network_dataset

Jeu de données réseau mis à jour.

Couche du jeu de données réseau

Exemple de code

Exemple 1 d'utilisation de l'outil UpdateByAlternateIDFields (fenêtre Python)

Exécutez l’outil avec tous les paramètres.

network = "C:/Data/SanFrancisco.gdb/Transportation/Streets_ND"
arcpy.na.UpdateByAlternateIDFields(network, "ID")
Exemple 2 d'utilisation de l'outil UpdateByAlternateIDFields (script autonome)

Le script Python ci-dessous illustre l'utilisation de l'outil UpdateByAlternateIDFields dans un script autonome.

# Name: UpdateByAlternateIDFields_ex02.py
# Description: Update the edge references in the turn feature classes using
#              alternate IDs and build the network dataset.
# Requirements: Network Analyst Extension

#Import system modules
import arcpy
from arcpy import env

#Set environment settings
env.workspace = "C:/data/SanFrancisco.gdb"

#Set local variables
inNetworkDataset = "Transportation/Streets_ND"
altIDFieldName = "ID"

#Update the edge references in the turn features using alternate ID fields
arcpy.UpdateByAlternateIDFields_na(inNetworkDataset, altIDFieldName)

#Since we have modified the edge references for turn sources, we should rebuild
#the network dataset so that the turn features are correctly interpreted by the
#network dataset
arcpy.BuildNetwork_na(inNetworkDataset)

print("Script completed successfully.")