Calcular ubicaciones (Network Analyst)

Resumen

Localiza entidades de entrada en una red y agrega campos que describen estas ubicaciones de red a las entidades de entrada. La herramienta se utiliza para precalcular las ubicaciones de red de entradas que se utilizarán en un flujo de trabajo de Network Analyst, y así mejorar el rendimiento del análisis en el momento de la resolución. La herramienta almacena las ubicaciones de red calculadas de las entradas en los campos de los datos de entrada.

Obtener más información sobre la localización de entidades en una red

Más información sobre cómo calcular previamente las ubicaciones de red

Uso

  • De forma predeterminada, esta herramienta almacena las ubicaciones de red calculadas en un conjunto de campos con nombres de campos de ubicación de red reconocidos por todos los flujos de trabajo de Network Analyst. Sin embargo, puede cambiar los nombres de los campos en los que se almacenan las ubicaciones de red calculadas. En este caso, al utilizar las ubicaciones de red precalculadas en un flujo de trabajo, utilice la asignación de campos para asignar los campos de ubicación no predeterminados a las propiedades de ubicación de red correctas.

    La única razón para cambiar los nombres de campo es almacenar un conjunto independiente de campos de ubicación para distintas redes o modos de viaje en la misma clase de entidad. De lo contrario, utilice siempre los nombres de campo predeterminados.

    Puede especificar nombres de campo alternativos con los parámetros Campo de Id. de origen, Campo OID de origen, Campo Porcentaje a lo largo, Campo Lado de eje, Campo Coordenada X ubicada, Campo Coordenada Y ubicada, Campo Distancia desde entidad, Campo Coordenada Z ubicada y Campo de rangos de ubicación.

  • Esta herramienta solo calcula las ubicaciones de red de las entradas mediante un dataset de red. No puede calcular ubicaciones de red para un servicio de análisis de red.

  • Si las entidades de entrada son una subcapa de una capa de análisis de red, 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 las entidades de entrada son una subcapa de una capa de análisis de red y 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 utilice la misma configuración de ubicación que utilizó al calcular inicialmente las ubicaciones de red.

Parámetros

EtiquetaExplicaciónTipo de datos
Entidades de entrada

Las entidades de entrada para las que se calcularán las ubicaciones de red.

Para las entidades poligonales y de línea, puesto que la información de ubicación de red se almacena en un campo BLOB, solamente se admiten clases de entidad de geodatabase.

Table View
Red de análisis de entrada
(Opcional)

El dataset de red que se utilizará para calcular las ubicaciones.

Este parámetro es obligatorio a menos que se utilice una subcapa de la capa de análisis de red como entidades de entrada. En ese caso, el parámetro se oculta y se establece automáticamente en el dataset de red al que hace referencia la capa de análisis de red.

Network Dataset Layer
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 es 5000 metros.

Si las entidades de entrada son una subcapa de una capa de análisis de red, el valor predeterminado para este parámetro se determina 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 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 al calcular las ubicaciones para entidades poligonales o de línea.

Linear Unit
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.

Las siguientes son las opciones de tipo de alineación disponibles para cada fuente de red:

  • Ninguna: el punto no se ubicará en elementos de esta fuente de red.
  • Forma: el punto se ubicará en el punto más cercano de un elemento de esta fuente de red.
  • Centro: esta opción está obsoleta y se comporta igual que Forma.
  • Final: esta opción está obsoleta y se comporta igual que Forma.

El valor predeterminado es ubicar en todas las fuentes de red, excepto los cruces de excepción creados al ejecutar la herramienta Disolver red y los cruces de sistema.

Si las entidades de entrada son una subcapa de una capa de análisis de red, el valor predeterminado para este parámetro se determina 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 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.

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.

Boolean
Campo de Id. de origen
(Opcional)

El nombre del campo que se creará o actualizará y que se rellenará con el Id. de la clase de entidad de origen del dataset de red para la ubicación de red calculada de la entidad de entrada. El valor predeterminado es SourceID.

El parámetro no se utiliza al calcular las ubicaciones para entidades poligonales o de línea.

No utilice este parámetro cuando las entidades de entrada sean una subcapa de una capa de análisis de red. Las ubicaciones de red en una subcapa se deben almacenar en campos de ubicación con los nombres predeterminados o no se usarán cuando se resuelva la capa.

Field
Campo OID de origen
(Opcional)

El nombre del campo que se creará o actualizará y que se rellenará con el valor del campo ObjectID de la clase de entidad de origen del dataset de red para la ubicación de red calculada de la entidad de entrada. El valor predeterminado es SourceOID.

El parámetro no se utiliza al calcular las ubicaciones para entidades poligonales o de línea.

No utilice este parámetro cuando las entidades de entrada sean una subcapa de una capa de análisis de red. Las ubicaciones de red en una subcapa se deben almacenar en campos de ubicación con los nombres predeterminados o no se usarán cuando se resuelva la capa.

Field
Campo Porcentaje a lo largo
(Opcional)

El nombre del campo que se creará o actualizará y que describe el porcentaje a lo largo del elemento de red donde se encontró de la ubicación de red calculada. El valor predeterminado es PosAlong.

El parámetro no se utiliza al calcular las ubicaciones para entidades poligonales o de línea.

No utilice este parámetro cuando las entidades de entrada sean una subcapa de una capa de análisis de red. Las ubicaciones de red en una subcapa se deben almacenar en campos de ubicación con los nombres predeterminados o no se usarán cuando se resuelva la capa.

Field
Campo Lado de eje
(Opcional)

El nombre del campo que se creará o actualizará y que describe el lado del eje de red en el que queda la ubicación de red calculada. El valor predeterminado es SideOfEdge.

El parámetro no se utiliza al calcular las ubicaciones para entidades poligonales o de línea.

No utilice este parámetro cuando las entidades de entrada sean una subcapa de una capa de análisis de red. Las ubicaciones de red en una subcapa se deben almacenar en campos de ubicación con los nombres predeterminados o no se usarán cuando se resuelva la capa.

Field
Campo Coordenada X ubicada
(Opcional)

El nombre del campo que se creará o actualizará con la coordenada x de la ubicación de red calculada. El valor predeterminado es SnapX.

El parámetro no se utiliza al calcular las ubicaciones para entidades poligonales o de línea.

No utilice este parámetro cuando las entidades de entrada sean una subcapa de una capa de análisis de red. Las ubicaciones de red en una subcapa se deben almacenar en campos de ubicación con los nombres predeterminados o no se usarán cuando se resuelva la capa.

Field
Campo Coordenada Y ubicada
(Opcional)

El nombre del campo que se creará o actualizará con la coordenada y de la ubicación de red calculada. El valor predeterminado es SnapY.

El parámetro no se utiliza al calcular las ubicaciones para entidades poligonales o de línea.

No utilice este parámetro cuando las entidades de entrada sean una subcapa de una capa de análisis de red. Las ubicaciones de red en una subcapa se deben almacenar en campos de ubicación con los nombres predeterminados o no se usarán cuando se resuelva la capa.

Field
Campo Distancia desde entidad
(Opcional)

El nombre del campo que se creará o actualizará y que describe la distancia en metros de la entidad de punto original desde su ubicación de red calculada. El valor predeterminado es DistanceToNetworkInMeters.

El parámetro no se utiliza al calcular las ubicaciones para entidades poligonales o de línea.

No utilice este parámetro cuando las entidades de entrada sean una subcapa de una capa de análisis de red. Las ubicaciones de red en una subcapa se deben almacenar en campos de ubicación con los nombres predeterminados o no se usarán cuando se resuelva la capa.

Field
Campo Coordenada Z ubicada
(Opcional)

El nombre del campo que se creará o actualizará con la coordenada z de la ubicación de red calculada. El valor predeterminado es SnapZ.

El parámetro se utiliza solo cuando el dataset de red de entrada es compatible con la conectividad basada en los valores de las coordenadas z de las fuentes de red.

El parámetro no se utiliza al calcular las ubicaciones para entidades poligonales o de línea.

No utilice este parámetro cuando las entidades de entrada sean una subcapa de una capa de análisis de red. Las ubicaciones de red en una subcapa se deben almacenar en campos de ubicación con los nombres predeterminados o no se usarán cuando se resuelva la capa.

Field
Campo de rangos de ubicación
(Opcional)

El nombre del campo que se creará o actualizará con los rangos de ubicación de las ubicaciones de red calculadas para entidades de línea o polígono. El valor predeterminado es Locations.

El parámetro se utiliza solo cuando se calculan ubicaciones para entidades de línea o polígono.

No utilice este parámetro cuando las entidades de entrada sean una subcapa de una capa de análisis de red. Las ubicaciones de red en una subcapa se deben almacenar en campos de ubicación con los nombres predeterminados o no se usarán cuando se resuelva la capa.

Field
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.

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.

De forma predeterminada, no se utiliza ninguna consulta para ningún origen.

Si las entidades de entrada son una subcapa de una capa de análisis de red, el valor predeterminado para este parámetro se determina 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 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.

Value Table
Modo de viaje
(Opcional)

El nombre del modo de viaje que se utilizará.

Si selecciona un modo de viaje, se tendrá en cuenta la configuración del modo de viaje (por ejemplo, las restricciones y los atributos de impedancia) a la hora de calcular la ubicación de red. Por ejemplo, si el eje de red más cercano a uno de los puntos de entrada está restringido cuando se aplica el modo de viaje seleccionado, la herramienta localizará el punto en el siguiente eje de red más cercano que no esté restringido.

Los modos de viaje disponibles dependen del valor del parámetro Red de análisis de entrada.

Si una subcapa de una capa de análisis de red se utiliza como entidades de entrada, este parámetro se oculta y no se debe utilizar. Cuando se calculan ubicaciones de red, se utilizará automáticamente el modo de viaje actual de la capa de análisis de red.

String

Salida derivada

EtiquetaExplicaciónTipo de datos
Entidades de entrada actualizadas

Las entidades de entrada actualizadas.

Table View
Capa de Network Analyst

Si el valor del parámetro Entidades de entrada era una subcapa de una capa de análisis de red, este parámetro de salida derivado devuelve la capa de análisis de red principal de la subcapa. De lo contrario, no se devuelve ningún valor.

Network Analyst Layer

arcpy.management.CalculateLocations(in_point_features, {in_network_dataset}, {search_tolerance}, {search_criteria}, {match_type}, {source_ID_field}, {source_OID_field}, {position_field}, {side_field}, {snap_X_field}, {snap_Y_field}, {distance_field}, {snap_Z_field}, {location_field}, {exclude_restricted_elements}, {search_query}, {travel_mode})
NombreExplicaciónTipo de datos
in_point_features

Las entidades de entrada para las que se calcularán las ubicaciones de red.

Para las entidades poligonales y de línea, puesto que la información de ubicación de red se almacena en un campo BLOB, solamente se admiten clases de entidad de geodatabase.

Table View
in_network_dataset
(Opcional)

El dataset de red que se utilizará para calcular las ubicaciones.

Este parámetro es obligatorio a menos que se utilice una subcapa de la capa de análisis de red como entidades de entrada. En ese caso, no especifique un valor para este parámetro, o defínalo en el dataset de red al que hace referencia la capa de análisis de red.

Network Dataset Layer
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 es 5000 metros.

Si las entidades de entrada son una subcapa de una capa de análisis de red, el valor predeterminado para este parámetro se determina 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 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 al calcular las ubicaciones para entidades poligonales o de línea.

Linear Unit
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.

Las siguientes son las opciones de tipo de alineación disponibles para cada fuente de red:

  • NONE: el punto no se ubicará en los elementos de esta fuente de red.
  • SHAPE: el punto se ubicará en el punto más cercano de un elemento en esta 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.

El valor predeterminado es ubicar en todas las fuentes de red, excepto los cruces de excepción creados al ejecutar la herramienta Disolver red y los cruces de sistema.

Si las entidades de entrada son una subcapa de una capa de análisis de red, el valor predeterminado para este parámetro se determina 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 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.

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.

Boolean
source_ID_field
(Opcional)

El nombre del campo que se creará o actualizará y que se rellenará con el Id. de la clase de entidad de origen del dataset de red para la ubicación de red calculada de la entidad de entrada. El valor predeterminado es SourceID.

El parámetro no se utiliza al calcular las ubicaciones para entidades poligonales o de línea.

No utilice este parámetro cuando las entidades de entrada sean una subcapa de una capa de análisis de red. Las ubicaciones de red en una subcapa se deben almacenar en campos de ubicación con los nombres predeterminados o no se usarán cuando se resuelva la capa.

Field
source_OID_field
(Opcional)

El nombre del campo que se creará o actualizará y que se rellenará con el valor del campo ObjectID de la clase de entidad de origen del dataset de red para la ubicación de red calculada de la entidad de entrada. El valor predeterminado es SourceOID.

El parámetro no se utiliza al calcular las ubicaciones para entidades poligonales o de línea.

No utilice este parámetro cuando las entidades de entrada sean una subcapa de una capa de análisis de red. Las ubicaciones de red en una subcapa se deben almacenar en campos de ubicación con los nombres predeterminados o no se usarán cuando se resuelva la capa.

Field
position_field
(Opcional)

El nombre del campo que se creará o actualizará y que describe el porcentaje a lo largo del elemento de red donde se encontró de la ubicación de red calculada. El valor predeterminado es PosAlong.

El parámetro no se utiliza al calcular las ubicaciones para entidades poligonales o de línea.

No utilice este parámetro cuando las entidades de entrada sean una subcapa de una capa de análisis de red. Las ubicaciones de red en una subcapa se deben almacenar en campos de ubicación con los nombres predeterminados o no se usarán cuando se resuelva la capa.

Field
side_field
(Opcional)

El nombre del campo que se creará o actualizará y que describe el lado del eje de red en el que queda la ubicación de red calculada. El valor predeterminado es SideOfEdge.

El parámetro no se utiliza al calcular las ubicaciones para entidades poligonales o de línea.

No utilice este parámetro cuando las entidades de entrada sean una subcapa de una capa de análisis de red. Las ubicaciones de red en una subcapa se deben almacenar en campos de ubicación con los nombres predeterminados o no se usarán cuando se resuelva la capa.

Field
snap_X_field
(Opcional)

El nombre del campo que se creará o actualizará con la coordenada x de la ubicación de red calculada. El valor predeterminado es SnapX.

El parámetro no se utiliza al calcular las ubicaciones para entidades poligonales o de línea.

No utilice este parámetro cuando las entidades de entrada sean una subcapa de una capa de análisis de red. Las ubicaciones de red en una subcapa se deben almacenar en campos de ubicación con los nombres predeterminados o no se usarán cuando se resuelva la capa.

Field
snap_Y_field
(Opcional)

El nombre del campo que se creará o actualizará con la coordenada y de la ubicación de red calculada. El valor predeterminado es SnapY.

El parámetro no se utiliza al calcular las ubicaciones para entidades poligonales o de línea.

No utilice este parámetro cuando las entidades de entrada sean una subcapa de una capa de análisis de red. Las ubicaciones de red en una subcapa se deben almacenar en campos de ubicación con los nombres predeterminados o no se usarán cuando se resuelva la capa.

Field
distance_field
(Opcional)

El nombre del campo que se creará o actualizará y que describe la distancia en metros de la entidad de punto original desde su ubicación de red calculada. El valor predeterminado es DistanceToNetworkInMeters.

El parámetro no se utiliza al calcular las ubicaciones para entidades poligonales o de línea.

No utilice este parámetro cuando las entidades de entrada sean una subcapa de una capa de análisis de red. Las ubicaciones de red en una subcapa se deben almacenar en campos de ubicación con los nombres predeterminados o no se usarán cuando se resuelva la capa.

Field
snap_Z_field
(Opcional)

El nombre del campo que se creará o actualizará con la coordenada z de la ubicación de red calculada. El valor predeterminado es SnapZ.

El parámetro se utiliza solo cuando el dataset de red de entrada es compatible con la conectividad basada en los valores de las coordenadas z de las fuentes de red.

El parámetro no se utiliza al calcular las ubicaciones para entidades poligonales o de línea.

No utilice este parámetro cuando las entidades de entrada sean una subcapa de una capa de análisis de red. Las ubicaciones de red en una subcapa se deben almacenar en campos de ubicación con los nombres predeterminados o no se usarán cuando se resuelva la capa.

Field
location_field
(Opcional)

El nombre del campo que se creará o actualizará con los rangos de ubicación de las ubicaciones de red calculadas para entidades de línea o polígono. El valor predeterminado es Locations.

El parámetro se utiliza solo cuando se calculan ubicaciones para entidades de línea o polígono.

No utilice este parámetro cuando las entidades de entrada sean una subcapa de una capa de análisis de red. Las ubicaciones de red en una subcapa se deben almacenar en campos de ubicación con los nombres predeterminados o no se usarán cuando se resuelva la capa.

Field
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.

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.

De forma predeterminada, no se utiliza ninguna consulta para ningún origen.

Si las entidades de entrada son una subcapa de una capa de análisis de red, el valor predeterminado para este parámetro se determina 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 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.

Value Table
travel_mode
(Opcional)

El nombre del modo de viaje que se utilizará.

Si selecciona un modo de viaje, se tendrá en cuenta la configuración del modo de viaje (por ejemplo, las restricciones y los atributos de impedancia) a la hora de calcular la ubicación de red. Por ejemplo, si el eje de red más cercano a uno de los puntos de entrada está restringido cuando se aplica el modo de viaje seleccionado, la herramienta localizará el punto en el siguiente eje de red más cercano que no esté restringido.

Los modos de viaje disponibles dependen del valor del parámetro in_network_dataset.

También puede utilizar como entrada del parámetro un objeto arcpy.na.TravelMode y una cadena que contenga la representación JSON válida de un modo de viaje.

Si una subcapa de una capa de análisis de red se utiliza como entidades de entrada, no establezca un valor para este parámetro. Cuando se calculan ubicaciones de red, se utilizará automáticamente el modo de viaje actual de la capa de análisis de red.

String

Salida derivada

NombreExplicaciónTipo de datos
out_point_feature_class

Las entidades de entrada actualizadas.

Table View
output_layer

Si el valor del parámetro in_point_features era una subcapa de una capa de análisis de red, este parámetro de salida derivado devuelve la capa de análisis de red principal de la subcapa. De lo contrario, no se devuelve ningún valor.

Network Analyst Layer

Muestra de código

Ejemplo 1 de CalculateLocations (ventana de Python)

Calcular ubicaciones para entidades de punto.

stores = "C:/Data/SanFrancisco.gdb/Analysis/Hospitals/Analysis/Stores"
network = "C:/Data/SanFrancisco.gdb/Transportation/Streets_ND"
arcpy.na.CalculateLocations(stores, network, "5000 Meters",
                            [["Streets", "SHAPE"],
                            ["Streets_ND_Junctions", "NONE"]])
Ejemplo 2 de CalculateLocations (flujo de trabajo)

La siguiente muestra de código presenta la función CalculateLocations para precalcular las ubicaciones de red y utilizar las ubicaciones de red precalculadas en un flujo de trabajo de arcpy.nax.

El parámetro use_location_fields del método fieldMappings se establece en True para garantizar que se utilicen los campos de ubicación de red precalculados al cargar las entradas de análisis. Además, los campos de ubicación de red se calculan utilizando el mismo dataset de red, modo de viaje y configuración de ubicación que se utilizan en el análisis del área de servicio para garantizar que los resultados sean válidos y coherentes.

"""Precalculate network locations with the Calculate Locations
geoprocessing tool, then run a Service Area workflow using
the arcpy.nax solver object. Map the precalculated network
locations using fieldMappings and load.
"""
import arcpy

arcpy.CheckOutExtension("network")

network = "C:/Data/Paris.gdb/Transportation/ParisMultimodal_ND"
input_facilities = "C:/Data/Paris.gdb/Analysis/Stores"
travel_mode = "Driving Time"

# Make a network dataset layer
nd_layer = arcpy.nax.MakeNetworkDatasetLayer(network).getOutput(0)

# Run Calculate Locations to calculate the network locations of
# the points in the input feature class. Use the same network,
# travel mode, and locate settings that will be used in the
# network analysis.
# Set a search_tolerance of 500 meters.
# Use search_criteria to locate only on streets and metro entrances.
# Use search_query to prevent locating on highways (FUNC_CLASS 1)
arcpy.nax.CalculateLocations(
    input_facilities,
    nd_layer,
    search_tolerance="500 Meters",
    search_criteria=[
        ["Streets", "SHAPE"],
        ["Metro_Lines", "NONE"],
        ["Transfer_Stations", "NONE"],
        ["Transfer_Street_Station", "NONE"],
        ["Metro_Entrances", "SHAPE"],
        ["Metro_Stations", "NONE"],
        ["ParisMultimodal_ND_Junctions", "NONE"]
    ],
    search_query=[["Streets", "FUNC_CLASS <> '1'"]],
    travel_mode=travel_mode
)

# Initialize the Service Area solver object
service_area = arcpy.nax.ServiceArea(nd_layer)

# Set the analysis properties. Use the same travel mode and
# locate settings that were used when precalculating the
# network locations
service_area.travelMode = travel_mode
service_area.searchTolerance = 500
service_area.searchToleranceUnits = arcpy.nax.DistanceUnits.Meters
service_area.searchSources = [
    ["Streets", "FUNC_CLASS <> '1'"],
    ["Metro_Entrances", "SHAPE"]
]
service_area.defaultImpedanceCutoffs = [5, 10]

# Construct a field mapping object with network location fields
field_mappings = service_area.fieldMappings(
    arcpy.nax.ServiceAreaInputDataType.Facilities,
    use_location_fields=True
)

# Load the input data using the field mappings
# Location fields are included automatically because
# of the field mappings.
service_area.load(
    arcpy.nax.ServiceAreaInputDataType.Facilities,
    input_facilities,
    field_mappings
)

# Solve the analysis
result = service_area.solve()
print(result.solveSucceeded)

# ...analysis of the results continues...