Calcular ubicaciones (Herramientas de 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.
Si la clase de entidad de entrada tiene un campo CurbApproach de tipo Largo, los valores de este campo podrían utilizarse para influir en el comportamiento de localización. En particular, si los puntos se sitúan en una calle de una sola dirección y tienen una aproximación a borde en la que se especifica el lado derecho o izquierdo del vehículo, el valor del campo de ubicación SideOfEdge puede actualizarse para garantizar que se pueda alcanzar en la dirección correcta a lo largo de una calle de una sola dirección. El campo CurbApproach no se requiere en la entrada, pero se utilizará siempre que existe y sea del tipo Largo.

Si una fila tiene un valor de campo CurbApproach que no coincide con uno de los valores de dominio CurbApproach válidos, el valor del campo correspondiente a esa fila se ignorará al localizar el punto y se utilizará el valor predeterminado de 0 (cualquier lado del vehículo).

Más información sobre la aproximación a borde
Si la clase de entidad de entrada tiene un campo Status de tipo Largo, los valores del campo se actualizarán para reflejar el estado de localización de cada fila.

Si el campo Status de la clase de entidad de entrada se utiliza para otros fines y no desea que se sobrescriba, cambie el nombre del campo antes de ejecutar esta herramienta.

Etiqueta	Explicación	Tipo 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. 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. 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. 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. 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
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 se encuentra 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`. 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. 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. Columnas de la tabla de valores: Name—The name of the network source. Query—The SQL expression that will be used as the query for the source.	Value Table
Modo de viaje (Opcional)	El nombre del modo de viaje que se utilizará. Si especifica 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

Etiqueta	Explicación	Tipo 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.na.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})

Nombre	Explicación	Tipo 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. 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. 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. 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. 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
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 se encuentra 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`. `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. 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. Columnas de la tabla de valores: `Name`—The name of the network source. `Query`—The SQL expression that will be used as the query for the source.	Value Table
travel_mode (Opcional)	El nombre del modo de viaje que se utilizará. Si especifica 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 se puede utilizar como entrada de este 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

Nombre	Explicación	Tipo 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

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

Entornos

Espacio de trabajo actual

Información de licenciamiento

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

Calcular ubicaciones (Herramientas de Network Analyst)

Resumen

Uso

Parámetros

Precaución:

Heredado:

Heredado:

Salida derivada

Entornos

Información de licenciamiento

Temas relacionados