Agregar ubicaciones (Herramientas de Network Analyst)

Resumen

Agrega entidades de entrada o las registra en una capa de análisis de red. Las entradas se agregan a subcapas específicas como paradas y barreras. Cuando la capa de análisis de red hace referencia a un dataset de red como su fuente de datos de red, la herramienta calcula las ubicaciones de red de las entradas, a menos que se asignen campos de ubicación de red precalculados de las entradas.

Más información sobre cómo la herramienta Agregar ubicaciones localiza entradas de análisis en la red

Uso

Esta herramienta suele utilizarse como parte de un proceso de análisis de redes.

Más información sobre el flujo de trabajo de la capa de análisis de redes
Al ubicar entradas, el modo de viaje y las barreras existentes de la capa de análisis de red se tienen en cuenta. Por lo tanto, se recomienda que defina el modo de viaje del análisis y cargue las barreras antes de cargar otras entradas de análisis.
Los valores de los parámetros Tolerancia de búsqueda, Criterios de búsqueda y Consulta de búsqueda se rellenan automáticamente en función de las propiedades de ubicación almacenadas en la capa de análisis de red de entrada. Si la capa de análisis de red tiene invalidaciones de configuración de ubicación para la subcapa seleccionada, se utilizan esas configuraciones. De lo contrario, se utiliza la configuración de ubicación predeterminada de la capa de análisis de red.

Más información sobre la configuración de ubicación de una capa de análisis de red
Si cambia el valor de los parámetros Tolerancia de búsqueda, Criterios de búsqueda o Consulta de búsqueda, la ejecución de la herramienta actualizará las invalidaciones de configuración de ubicación de la capa de análisis de red para la subcapa seleccionada. Almacenar esta configuración de ubicación en la capa de análisis de red garantiza que cualquier reubicación automática realizada en el momento de la resolución respete la misma configuración de ubicación que utilizó al calcular inicialmente las ubicaciones de red.
Si la capa de análisis hace referencia a un servicio de portal, los campos de ubicación no se calculan hasta que no resuelva el análisis. Para estas capas, la herramienta Agregar ubicaciones incorpora las entradas a la capa de análisis sin calcular los campos de ubicación. Por lo tanto, algunos parámetros de herramienta no se aplican a estas capas y se ocultan en el panel Geoprocesamiento y se ignoran en Python.
Aunque esta herramienta se puede utilizar en un script de Python, la práctica recomendada para realizar análisis de redes en Python es utilizar las clases de resolución del módulo arcpy.nax.

Más información sobre cómo realizar el análisis de red en Python.

Etiqueta	Explicación	Tipo de datos
Capa de análisis de red de entrada	La capa de análisis de red a la que se agregarán los objetos de análisis de red.	Network Analyst Layer
Subcapa	El nombre de la subcapa de la capa de análisis de red a la que se agregarán los objetos de análisis de red.	String
Ubicaciones de entrada	La tabla o clase de entidad que contiene las ubicaciones que se agregarán a la subcapa de análisis de red.	Table View
Asignaciones de campos (Opcional)	La asignación entre los campos de entrada de la subcapa de análisis de red a la que se agregarán ubicaciones y los campos de los datos de entrada o constantes especificadas. Las subcapas de entrada de las capas de análisis de red tienen un conjunto de campos de entrada que se pueden rellenar para modificar o controlar el comportamiento de análisis. Al agregar ubicaciones a la subcapa, puede utilizar este parámetro para asignar valores de campo de la tabla de entrada a estos campos de la subcapa. También puede utilizar asignaciones de campo para especificar un valor predeterminado constante para cada propiedad. Si no se especifican ni el valor de campo ni el valor predeterminado para una propiedad, los objetos de análisis de red resultantes tendrán valores nulos para esa propiedad. En la documentación de cada capa hay disponible una lista completa de campos de entrada para cada subcapa de cada tipo de capa de análisis de red. Por ejemplo, examine los campos de entrada de la subcapa Paradas de la capa de ruta. Si los datos que está cargando contienen ubicaciones de red precalculadas o rangos de ubicaciones basados en la fuente de datos de red y el modo de viaje utilizados para el análisis, elija la opción Usar campos de ubicación de red del menú desplegable. Agregar los objetos de análisis de red usando los campos de ubicación de red es más rápido que cargarlos mediante la geometría. Más información sobre los campos de ubicación de red Nota: ArcGIS Online y algunos portales de ArcGIS Enterprise no admiten el uso de campos de ubicación de red. Para las capas de análisis de red que usan uno de estos portales como fuente de datos de red, todas las entradas se ubicarán en el momento de la resolución y se ignorarán todos los campos de ubicación asignados.	Network Analyst Class FieldMap
Tolerancia de búsqueda (Opcional)	La distancia de búsqueda máxima que se utilizará al localizar las entidades de entrada en la red. Las entidades que se encuentran fuera de la tolerancia de búsqueda quedan no ubicadas. El parámetro incluye un valor y unidades. El valor predeterminado para este parámetro viene determinado por las propiedades de ubicación almacenadas en la capa de análisis de red de entrada. Si la capa de análisis de red tiene invalidaciones de configuración de ubicación para la subcapa seleccionada, se utilizarán esas configuraciones. De lo contrario, se utilizará la configuración de ubicación predeterminada de la capa de análisis de red. La configuración de un valor no predeterminado para este parámetro actualiza las invalidaciones de configuración de ubicación de la capa de análisis de red para la subcapa seleccionada. El parámetro no se utiliza cuando se agregan ubicaciones a subcapas con geometría de línea o polígono, como Barreras de línea y Barreras de polígono. Este parámetro no se utiliza al agregar ubicaciones utilizando campos de ubicación de red existentes. Heredado: Este parámetro no se utiliza si la fuente de datos de red de la capa de análisis de red es un portal que ejecuta una versión de ArcGIS Enterprise anterior a la 11.0.	Linear Unit
Campo de ordenamiento (Opcional)	El campo en el que se ordenarán los objetos de análisis de red a medida que se agregan a la capa de análisis de red. El valor predeterminado es el campo `ObjectID` de la clase de entidad o tabla de entrada.	Field
Criterios de búsqueda (Opcional)	Las fuentes de eje y cruce en el dataset de red en las que se buscará al localizar entradas en la red. Por ejemplo, si el dataset de red hace referencia a clases de entidad separadas que representan calles y aceras, puede ubicar entradas en calles pero no en aceras. Precaución: Para un análisis de recogida de residuos, la operación de resolución fallará si se encuentra alguna parada en un cruce. No configure este parámetro para permitir la ubicación en fuentes de cruce al agregar paradas a una capa de análisis de recogida de residuos. El valor predeterminado para este parámetro viene determinado por las propiedades de ubicación almacenadas en la capa de análisis de red de entrada. Si la capa de análisis de red tiene invalidaciones de configuración de ubicación para la subcapa seleccionada, se utilizarán esas configuraciones. De lo contrario, se utilizará la configuración de ubicación predeterminada de la capa de análisis de red. La configuración de un valor no predeterminado para este parámetro actualiza las invalidaciones de configuración de ubicación de la capa de análisis de red para la subcapa seleccionada. Este parámetro no se utiliza al agregar ubicaciones utilizando campos de ubicación de red existentes. Este parámetro no se utiliza si la fuente de datos de red de la capa de análisis de red es ArcGIS Online. Heredado: Este parámetro no se utiliza si la fuente de datos de red de la capa de análisis de red es un portal que ejecuta una versión de ArcGIS Enterprise anterior a la 11.0. Columnas de la tabla de valores: Source—The edge and junction sources in the network dataset. Snap Type—Specifies the snap type options for each network source. None—The point will not locate on elements in this network source. Shape—The point will locate on the closest point of an element in this network source. Middle—This option is deprecated and behaves the same as Shape. End—This option is deprecated and behaves the same as Shape.	Value Table
Buscar el más cercano entre todas las clases (Opcional)	Heredado: Este parámetro está obsoleto y solo se mantiene para ofrecer compatibilidad con versiones anteriores. Las entradas siempre coincidirán con la fuente de red más cercana entre todas las fuentes utilizadas para la ubicación, que corresponden a un valor de parámetro de `MATCH_TO_CLOSEST` o `True`. Activado—Las entradas coinciden con la fuente de red más cercana entre todas las fuentes utilizadas para la localización. Desactivado—Esta opción está obsoleta y solo se mantiene para ofrecer compatibilidad con versiones anteriores. Las entradas coinciden con la fuente de red más cercana entre todas las fuentes utilizadas para la localización.	Boolean
Incorporar a ubicaciones existentes (Opcional)	Especifica si se incorporarán nuevos objetos de análisis de red a los objetos existentes. Activado—Los nuevos objetos de análisis de red se incorporarán al conjunto de objetos existentes en la subcapa seleccionada. Esta es la opción predeterminada. Desactivado—Los objetos de análisis de red existentes se eliminarán y remplazarán por los nuevos objetos.	Boolean
Ajustar a la red (Opcional)	Especifica si las entradas se alinearán con sus ubicaciones de red calculadas o si se representarán en su ubicación geográfica original. Para usar la aproximación a borde en el análisis y así controlar qué lado de la carretera debe utilizar un vehículo para aproximarse a una ubicación, no alinee las entradas con sus ubicaciones de red, o bien utilice un desplazamiento de alineación para asegurarse de que el punto permanezca claramente a un lado de la carretera. El parámetro no se utiliza cuando se agregan ubicaciones a subcapas con geometría de línea o polígono, como Barreras de línea y Barreras de polígono. Este parámetro no se utiliza cuando la fuente de datos de red de la capa de análisis de red de entrada es un servicio del portal. Activado—Las geometrías de las ubicaciones de red se alinearán con sus ubicaciones de red. Desactivado—Las geometrías de las ubicaciones de red se basarán en las geometrías de las entidades de entrada. Esta es la opción predeterminada.	Boolean
Desplazamiento del ajuste (Opcional)	Una distancia de desplazamiento que se aplicará al alinear un punto con la red. Una distancia de desplazamiento de cero significa que el punto coincidirá con la entidad de red (generalmente una línea). Para desplazar el punto desde la entidad de red, introduzca una distancia de desplazamiento. El desplazamiento se relaciona con la ubicación de punto original; esto es, si el punto original estaba en el lado izquierdo, su nueva ubicación se desplazará hacia la izquierda. Si originalmente estaba en el lado derecho, su nueva ubicación se desplazará hacia la derecha. El valor predeterminado es 5 metros. Sin embargo, este parámetro no se tiene en cuenta si Ajustar a la red está desactivado. El parámetro no se utiliza cuando se agregan ubicaciones a subcapas con geometría de línea o polígono, como Barreras de línea y Barreras de polígono. Este parámetro no se utiliza cuando la fuente de datos de red de la capa de análisis de red de entrada es un servicio del portal.	Linear Unit
Excluir las porciones restringidas de la red (Opcional)	Heredado: Este parámetro está obsoleto y solo se mantiene para ofrecer compatibilidad con versiones anteriores. Las entradas de análisis nunca se ubicarán en elementos de red restringidos, que corresponden a un valor de parámetro de `EXCLUDE` o `True`. Activado—Las entradas de análisis nunca se ubicarán en elementos de red restringidos. Desactivado—Esta opción está obsoleta y solo se mantiene para ofrecer compatibilidad con versiones anteriores. Las entradas de análisis nunca se ubicarán en elementos de red restringidos.	Boolean
Consulta de búsqueda (Opcional)	Una consulta que restringe la búsqueda a un subconjunto de entidades dentro de la clase de entidad de origen. Esto resulta útil si no desea encontrar entidades que puedan resultar inadecuadas para una ubicación de red. Por ejemplo, si no desea ubicar en rampas de autopista, puede definir una consulta para excluirlas. Se puede especificar una expresión SQL separada por clase de entidad de fuente de eje o cruce del dataset de red. No se aplicará ninguna consulta a las fuentes de red que no se especifiquen explícitamente en el panel Geoprocesamiento. El valor predeterminado para este parámetro viene determinado por las propiedades de ubicación almacenadas en la capa de análisis de red de entrada. Si la capa de análisis de red tiene invalidaciones de configuración de ubicación para la subcapa seleccionada, se utilizarán esas configuraciones. De lo contrario, se utilizará la configuración de ubicación predeterminada de la capa de análisis de red. La configuración de un valor no predeterminado para este parámetro actualiza las invalidaciones de configuración de ubicación de la capa de análisis de red para la subcapa seleccionada. Este parámetro no se utiliza al agregar ubicaciones utilizando campos de ubicación de red existentes. Este parámetro no se utiliza si la fuente de datos de red de la capa de análisis de red es ArcGIS Online. Heredado: Este parámetro no se utiliza si la fuente de datos de red de la capa de análisis de red es un portal que ejecuta una versión de ArcGIS Enterprise anterior a la 11.0. Columnas de la tabla de valores: Name—The edge and junction sources in the network dataset. Query—The query for each network source.	Value Table
Permitir reubicación automática en el momento de la resolución (Opcional)	Especifica si las entradas con campos de ubicación de red existentes se pueden reubicar automáticamente en el momento de la resolución para garantizar que se disponga de campos de ubicación enrutables y válidos para el análisis. El valor predeterminado para este parámetro viene determinado por las propiedades de ubicación almacenadas en la capa de análisis de red de entrada. Si la capa de análisis de red tiene invalidaciones de configuración de ubicación para la subcapa seleccionada, se utilizarán esas configuraciones. De lo contrario, se utilizará la configuración de ubicación predeterminada de la capa de análisis de red. La configuración de un valor no predeterminado para este parámetro actualiza las invalidaciones de configuración de ubicación de la capa de análisis de red para la subcapa seleccionada. Incluso aunque no se permita la reubicación automática en el momento de la resolución, las entradas sin campos de ubicación o con campos de ubicación incompletos se ubicarán en el momento de la resolución. Este parámetro no se utiliza si la fuente de datos de red de la capa de análisis de red es ArcGIS Online. Este parámetro no se utiliza si la fuente de datos de red de la capa de análisis de red es un portal de ArcGIS Enterprise que no admite el uso de campos de ubicación de red. Heredado: Este parámetro no se utiliza si la fuente de datos de red de la capa de análisis de red es un portal que ejecuta una versión de ArcGIS Enterprise anterior a la 11.0. Activado—Los puntos activados ubicados en elementos de red restringidos y los puntos afectados por las barreras se reubicarán en el momento de la resolución a la ubicación enrutable más cercana. Esta es la opción predeterminada. Desactivado—Los campos de ubicación de red que se utilizarán en el momento de la resolución tal y como están, aunque los puntos sean inaccesibles, lo que puede hacer que la resolución falle.	Boolean

Salida derivada

Etiqueta	Explicación	Tipo de datos
Capa de análisis de red de entrada actualizada	La capa de análisis de red actualizada.	Network Analyst Layer

arcpy.na.AddLocations(in_network_analysis_layer, sub_layer, in_table, {field_mappings}, {search_tolerance}, {sort_field}, {search_criteria}, {match_type}, {append}, {snap_to_position_along_network}, {snap_offset}, {exclude_restricted_elements}, {search_query}, {allow_auto_relocate})

Nombre	Explicación	Tipo de datos
in_network_analysis_layer	La capa de análisis de red a la que se agregarán los objetos de análisis de red.	Network Analyst Layer
sub_layer	El nombre de la subcapa de la capa de análisis de red a la que se agregarán los objetos de análisis de red.	String
in_table	La tabla o clase de entidad que contiene las ubicaciones que se agregarán a la subcapa de análisis de red.	Table View
field_mappings (Opcional)	La asignación entre los campos de entrada de la subcapa de análisis de red a la que se agregarán ubicaciones y los campos de los datos de entrada o constantes especificadas. Las subcapas de entrada de las capas de análisis de red tienen un conjunto de campos de entrada que se pueden rellenar para modificar o controlar el comportamiento de análisis. Al agregar ubicaciones a la subcapa, puede utilizar este parámetro para asignar valores de campo de la tabla de entrada a estos campos de la subcapa. También puede utilizar asignaciones de campo para especificar un valor predeterminado constante para cada propiedad. Si no se especifican ni el valor de campo ni el valor predeterminado para una propiedad, los objetos de análisis de red resultantes tendrán valores nulos para esa propiedad. En la documentación de cada capa hay disponible una lista completa de campos de entrada para cada subcapa de cada tipo de capa de análisis de red. Por ejemplo, examine los campos de entrada de la subcapa Paradas de la capa de ruta. Se utiliza un objeto `NAClassFieldMappings` obtenido de la clase `NAClassFieldMappings` para especificar el valor del parámetro. El objeto `NAClassFieldMappings` es una colección de objetos `NAClassFieldMap` que le permite especificar los valores predeterminados o asignar un nombre de campo de las entidades de entrada para las propiedades del objeto de análisis de red. Si los datos que está cargando contienen ubicaciones de red o rangos de ubicaciones basados en el dataset de red utilizado para el análisis, asigne los campos de ubicación de red de las entidades de entrada a las propiedades de ubicación de red. Especificar los campos de ubicación de red en las asignaciones de campos es similar a utilizar el parámetro Usar campos de ubicación de red del cuadro de diálogo de la herramienta. Más información sobre los campos de ubicación de red Nota: ArcGIS Online y algunos portales de ArcGIS Enterprise no admiten el uso de campos de ubicación de red. Para las capas de análisis de red que usan uno de estos portales como fuente de datos de red, todas las entradas se ubicarán en el momento de la resolución y se ignorarán todos los campos de ubicación asignados.	Network Analyst Class FieldMap
search_tolerance (Opcional)	La distancia de búsqueda máxima que se utilizará al localizar las entidades de entrada en la red. Las entidades que se encuentran fuera de la tolerancia de búsqueda quedan no ubicadas. El parámetro incluye un valor y unidades. El valor predeterminado para este parámetro viene determinado por las propiedades de ubicación almacenadas en la capa de análisis de red de entrada. Si la capa de análisis de red tiene invalidaciones de configuración de ubicación para la subcapa seleccionada, se utilizarán esas configuraciones. De lo contrario, se utilizará la configuración de ubicación predeterminada de la capa de análisis de red. La configuración de un valor no predeterminado para este parámetro actualiza las invalidaciones de configuración de ubicación de la capa de análisis de red para la subcapa seleccionada. El parámetro no se utiliza cuando se agregan ubicaciones a subcapas con geometría de línea o polígono, como Barreras de línea y Barreras de polígono. Este parámetro no se utiliza al agregar ubicaciones utilizando campos de ubicación de red existentes. Heredado: Este parámetro no se utiliza si la fuente de datos de red de la capa de análisis de red es un portal que ejecuta una versión de ArcGIS Enterprise anterior a la 11.0.	Linear Unit
sort_field (Opcional)	El campo en el que se ordenarán los objetos de análisis de red a medida que se agregan a la capa de análisis de red. El valor predeterminado es el campo `ObjectID` de la clase de entidad o tabla de entrada.	Field
search_criteria [[Source, SnapType],...] (Opcional)	Las fuentes de eje y cruce en el dataset de red en las que se buscará al localizar entradas en la red. Por ejemplo, si el dataset de red hace referencia a clases de entidad separadas que representan calles y aceras, puede ubicar entradas en calles pero no en aceras. El valor de parámetro se especifica como una lista con listas anidadas. La lista anidada está compuesta por dos valores que indican el nombre y el tipo de alineación de cada fuente de red. Por ejemplo, el valor de parámetro `[["Streets","SHAPE"],["Streets_ND_Junctions","NONE"]]` especifica que se puede buscar en la forma de la fuente `Streets`, pero no en la fuente `Streets_ND_Junctions`. Las fuentes de eje o cruce de red que no se incluyan en esta lista utilizarán su tipo de alineación predeterminado. Se recomienda incluir todas las fuentes de redes en la lista y establecer de forma explícita el tipo de alineación de cada una. Heredado: Históricamente, la herramienta admitía las opciones de tipo de alineación `MIDDLE`, `END` y `MIDDLE_END`. Estas opciones están obsoletas y solo se mantienen para ofrecer compatibilidad con versiones anteriores. Si se especifica una de estas opciones, la herramienta vuelve a la opción `SHAPE` para esa fuente de red. Precaución: Para un análisis de recogida de residuos, la operación de resolución fallará si se encuentra alguna parada en un cruce. No configure este parámetro para permitir la ubicación en fuentes de cruce al agregar paradas a una capa de análisis de recogida de residuos. El valor predeterminado para este parámetro viene determinado por las propiedades de ubicación almacenadas en la capa de análisis de red de entrada. Si la capa de análisis de red tiene invalidaciones de configuración de ubicación para la subcapa seleccionada, se utilizarán esas configuraciones. De lo contrario, se utilizará la configuración de ubicación predeterminada de la capa de análisis de red. La configuración de un valor no predeterminado para este parámetro actualiza las invalidaciones de configuración de ubicación de la capa de análisis de red para la subcapa seleccionada. Este parámetro no se utiliza al agregar ubicaciones utilizando campos de ubicación de red existentes. Este parámetro no se utiliza si la fuente de datos de red de la capa de análisis de red es ArcGIS Online. Heredado: Este parámetro no se utiliza si la fuente de datos de red de la capa de análisis de red es un portal que ejecuta una versión de ArcGIS Enterprise anterior a la 11.0. Columnas de la tabla de valores: `Source`—The edge and junction sources in the network dataset. `Snap Type`—Specifies the snap type options for each network source. `NONE`—The point will not locate on elements in this network source. `SHAPE`—The point will locate on the closest point of an element in this network source. `MIDDLE`—This option is deprecated and behaves the same as Shape. `END`—This option is deprecated and behaves the same as Shape.	Value Table
match_type (Opcional)	Heredado: Este parámetro está obsoleto y solo se mantiene para ofrecer compatibilidad con versiones anteriores. Las entradas siempre coincidirán con la fuente de red más cercana entre todas las fuentes utilizadas para la ubicación, que corresponden a un valor de parámetro de `MATCH_TO_CLOSEST` o `True`. `MATCH_TO_CLOSEST`—Las entradas coinciden con la fuente de red más cercana entre todas las fuentes utilizadas para la localización. `PRIORITY`—Esta opción está obsoleta y solo se mantiene para ofrecer compatibilidad con versiones anteriores. Las entradas coinciden con la fuente de red más cercana entre todas las fuentes utilizadas para la localización.	Boolean
append (Opcional)	Especifica si se incorporarán nuevos objetos de análisis de red a los objetos existentes. `APPEND`—Los nuevos objetos de análisis de red se incorporarán al conjunto de objetos existentes en la subcapa seleccionada. Esta es la opción predeterminada. `CLEAR`—Los objetos de análisis de red existentes se eliminarán y remplazarán por los nuevos objetos.	Boolean
snap_to_position_along_network (Opcional)	Especifica si las entradas se alinearán con sus ubicaciones de red calculadas o si se representarán en su ubicación geográfica original. Para usar la aproximación a borde en el análisis y así controlar qué lado de la carretera debe utilizar un vehículo para aproximarse a una ubicación, no alinee las entradas con sus ubicaciones de red, o bien utilice un desplazamiento de alineación para asegurarse de que el punto permanezca claramente a un lado de la carretera. El parámetro no se utiliza cuando se agregan ubicaciones a subcapas con geometría de línea o polígono, como Barreras de línea y Barreras de polígono. Este parámetro no se utiliza cuando la fuente de datos de red de la capa de análisis de red de entrada es un servicio del portal. `SNAP`—Las geometrías de las ubicaciones de red se alinearán con sus ubicaciones de red. `NO_SNAP`—Las geometrías de las ubicaciones de red se basarán en las geometrías de las entidades de entrada. Esta es la opción predeterminada.	Boolean
snap_offset (Opcional)	Una distancia de desplazamiento que se aplicará al alinear un punto con la red. Una distancia de desplazamiento de cero significa que el punto coincidirá con la entidad de red (generalmente una línea). Para desplazar el punto desde la entidad de red, introduzca una distancia de desplazamiento. El desplazamiento se relaciona con la ubicación de punto original; esto es, si el punto original estaba en el lado izquierdo, su nueva ubicación se desplazará hacia la izquierda. Si originalmente estaba en el lado derecho, su nueva ubicación se desplazará hacia la derecha. El valor predeterminado es 5 metros. Sin embargo, este parámetro no se tiene en cuenta si `snap_to_position_along_network` tiene el valor `NO_SNAP`. El parámetro no se utiliza cuando se agregan ubicaciones a subcapas con geometría de línea o polígono, como Barreras de línea y Barreras de polígono. Este parámetro no se utiliza cuando la fuente de datos de red de la capa de análisis de red de entrada es un servicio del portal.	Linear Unit
exclude_restricted_elements (Opcional)	Heredado: Este parámetro está obsoleto y solo se mantiene para ofrecer compatibilidad con versiones anteriores. Las entradas de análisis nunca se ubicarán en elementos de red restringidos, que corresponden a un valor de parámetro de `EXCLUDE` o `True`. `EXCLUDE`—Las entradas de análisis nunca se ubicarán en elementos de red restringidos. `INCLUDE`—Esta opción está obsoleta y solo se mantiene para ofrecer compatibilidad con versiones anteriores. Las entradas de análisis nunca se ubicarán en elementos de red restringidos.	Boolean
search_query [[Source, Expression],...] (Opcional)	Una consulta que restringe la búsqueda a un subconjunto de entidades dentro de la clase de entidad de origen. Esto resulta útil si no desea encontrar entidades que puedan resultar inadecuadas para una ubicación de red. Por ejemplo, si no desea ubicar en rampas de autopista, puede definir una consulta para excluirlas. Se puede especificar una expresión SQL separada por clase de entidad de fuente de eje o cruce del dataset de red. El valor de parámetro se especifica como una lista con listas anidadas, con una entrada por fuente de red. Cada lista interior se compone de dos valores que indican el nombre de la fuente de red y la expresión SQL utilizada como consulta para esa fuente. Una cadena vacía, `""`, indica que no hay consulta para una fuente en particular. Por ejemplo, el valor `[["Streets", "ROAD_CLASS <> 3"], ["Streets_ND_Junctions", ""]]` especifica una expresión SQL para la clase de entidad de origen `Streets`, pero no especifica ninguna expresión para la clase de entidad de origen `Streets_ND_Junctions`. Si una fuente de red no está incluida en la lista, se interpreta como que no tiene ninguna consulta. Este valor `[["Streets", "ROAD_CLASS <> 3"]]` es equivalente a `[["Streets", "ROAD_CLASS <> 3"], ["Streets_ND_Junctions", ""]]`. Para obtener más información sobre la sintaxis SQL, consulte Referencia SQL para las expresiones de consulta utilizadas en ArcGIS. El valor predeterminado para este parámetro viene determinado por las propiedades de ubicación almacenadas en la capa de análisis de red de entrada. Si la capa de análisis de red tiene invalidaciones de configuración de ubicación para la subcapa seleccionada, se utilizarán esas configuraciones. De lo contrario, se utilizará la configuración de ubicación predeterminada de la capa de análisis de red. La configuración de un valor no predeterminado para este parámetro actualiza las invalidaciones de configuración de ubicación de la capa de análisis de red para la subcapa seleccionada. Este parámetro no se utiliza al agregar ubicaciones utilizando campos de ubicación de red existentes. Este parámetro no se utiliza si la fuente de datos de red de la capa de análisis de red es ArcGIS Online. Heredado: Este parámetro no se utiliza si la fuente de datos de red de la capa de análisis de red es un portal que ejecuta una versión de ArcGIS Enterprise anterior a la 11.0. Columnas de la tabla de valores: `Name`—The edge and junction sources in the network dataset. `Query`—The query for each network source.	Value Table
allow_auto_relocate (Opcional)	Especifica si las entradas con campos de ubicación de red existentes se pueden reubicar automáticamente en el momento de la resolución para garantizar que se disponga de campos de ubicación enrutables y válidos para el análisis. El valor predeterminado para este parámetro viene determinado por las propiedades de ubicación almacenadas en la capa de análisis de red de entrada. Si la capa de análisis de red tiene invalidaciones de configuración de ubicación para la subcapa seleccionada, se utilizarán esas configuraciones. De lo contrario, se utilizará la configuración de ubicación predeterminada de la capa de análisis de red. La configuración de un valor no predeterminado para este parámetro actualiza las invalidaciones de configuración de ubicación de la capa de análisis de red para la subcapa seleccionada. Incluso aunque no se permita la reubicación automática en el momento de la resolución, las entradas sin campos de ubicación o con campos de ubicación incompletos se ubicarán en el momento de la resolución. Este parámetro no se utiliza si la fuente de datos de red de la capa de análisis de red es ArcGIS Online. Este parámetro no se utiliza si la fuente de datos de red de la capa de análisis de red es un portal de ArcGIS Enterprise que no admite el uso de campos de ubicación de red. Heredado: Este parámetro no se utiliza si la fuente de datos de red de la capa de análisis de red es un portal que ejecuta una versión de ArcGIS Enterprise anterior a la 11.0. `ALLOW`—Los puntos activados ubicados en elementos de red restringidos y los puntos afectados por las barreras se reubicarán en el momento de la resolución a la ubicación enrutable más cercana. Esta es la opción predeterminada. `NO_ALLOW`—Los campos de ubicación de red que se utilizarán en el momento de la resolución tal y como están, aunque los puntos sean inaccesibles, lo que puede hacer que la resolución falle.	Boolean

Salida derivada

Nombre	Explicación	Tipo de datos
output_layer	La capa de análisis de red actualizada.	Network Analyst Layer

Muestra de código

Sugerencia:

Aunque esta herramienta se puede utilizar en un script de Python, la práctica recomendada para realizar análisis de redes en Python es utilizar las clases de resolución del módulo arcpy.nax. Más información sobre cómo realizar el análisis de red en Python.

Ejemplo 1 de AddLocations (ventana de Python)

Ejecutar la herramienta en la ventana de Python para agregar paradas a una capa de análisis de ruta denominada Route.

import arcpy
hospitals = "C:/Data/SanFrancisco.gdb/Analysis/Hospitals"
arcpy.na.AddLocations("Route", "Stops", hospitals)

Ejemplo 2 de AddLocations (flujo de trabajo)

En el siguiente script de Python independiente se muestra cómo se puede utilizar la función AddLocations para cargar orígenes y destinos en una capa de Matriz de coste OD.

Heredado:

La función GetNASublayer se puede utilizar para recuperar las subcapas de una capa de análisis de red. Se introdujo en ArcGIS Pro 2.7. En versiones de software anteriores, la mejor forma de recuperar un objeto de subcapa de una capa de análisis de red era utilizar el método listLayers del objeto de análisis de red Layer utilizando el nombre de subcapa como comodín.

# Name: AddLocations_Workflow.py
# Description: Calculate a travel time matrix between stores. Use the Add
#               Locations tool to load origins and destinations into an OD Cost
#               Matrix layer. Since the origins and destinations are the same in
#               this case, the origins are first loaded from the stores feature
#               class using geometry, and the destinations are loaded from the
#               origins using network location fields in order to speed up the
#               load times.
# 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 inputs and outputs
    input_gdb = "C:/Data/SanFrancisco.gdb"
    network = os.path.join(input_gdb, "Transportation", "Streets_ND")
    layer_name = "StoreTravelTimeMatrix"
    travel_mode = "Driving Time"
    stores = os.path.join(input_gdb, "Analysis", "Stores")
    search_tolerance = "500 Meters"
    search_query = [["Streets", '"FREEWAY" = 0'], ["Streets_ND_Junctions", ""]]
    output_layer_file = os.path.join(output_dir, layer_name + ".lyrx")

    # Create a new OD cost matrix analysis layer. For this scenario, the default
    # value for all the remaining parameters statisfies the analysis requirements
    result_object = arcpy.na.MakeODCostMatrixAnalysisLayer(
        network, layer_name, travel_mode
    )

    # Get the layer object from the result object. The OD cost matrix layer can
    # now be referenced using the layer object.
    layer_object = result_object.getOutput(0)

    # Get the names of all the sublayers within the OD layer.
    sublayer_names = arcpy.na.GetNAClassNames(layer_object)
    # Store the layer names for later use
    origins_layer_name = sublayer_names["Origins"]
    destinations_layer_name = sublayer_names["Destinations"]

    # Load store features as origins using the geometry of store features.
    # Ensure that the stores are not located on freeways by using a search query.
    arcpy.na.AddLocations(
        layer_object, origins_layer_name, stores, "",
        search_tolerance, search_query=search_query
    )

    # Because we want our origins and destinations to be the same, load the
    # origins as destinations using the network locations fields. Loading using
    # existing network location fields is much faster than loading using geometry
    # because the network locations have already been calculated.
    # Create a field mappings object that supports network location fields using
    # the candidate fields from origins
    origins_sublayer = arcpy.na.GetNASublayer(layer_object, "Origins")
    candidate_fields = arcpy.ListFields(origins_sublayer)
    field_mappings = arcpy.na.NAClassFieldMappings(
        layer_object, destinations_layer_name, True, candidate_fields
    )
    arcpy.na.AddLocations(
        layer_object, destinations_layer_name, origins_sublayer, field_mappings
    )

    # Solve the od cost matrix layer. Halt the execution if there is an
    # invalid location
    arcpy.na.Solve(layer_object, "HALT")

    # Save the solved OD cost matrix layer as a layer file on disk
    layer_object.saveACopy(output_layer_file)

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

Entornos

Espacio de trabajo actual

Información de licenciamiento

Basic: Sí
Standard: Sí
Avanzado: Sí

Agregar ubicaciones (Herramientas de Network Analyst)

Resumen

Uso

Parámetros

Nota:

Heredado:

Precaución:

Heredado:

Heredado:

Heredado:

Heredado:

Heredado:

Salida derivada

Entornos

Información de licenciamiento

Temas relacionados