ArcMap

Buscar instalaciones más cercanas

Resumen

Encuentra una o más instalaciones más próximas a un incidente en función del tiempo de viaje, la distancia u otros costes y da como resultado la mejor ruta, la instalación elegida y las indicaciones sobre cómo llegar entre el incidente y la instalación. Por ejemplo, esta herramienta se puede usar para encontrar el hospital más cercano a un accidente, la patrulla de policía más próxima a la escena de un crimen o el almacén más cercano a la dirección de un cliente.

Cuando busque las instalaciones más cercanas, puede especificar cuántas instalaciones se deben buscar y si la dirección de viaje es acercándose o alejándose de ellas. Si su dataset de red admite tráfico, también se puede especificar la hora del día para tener en cuenta los tiempos de viaje en esa fecha y hora. Por ejemplo, se puede usar esta herramienta para buscar hospitales en un radio de tiempo de conducción de 15 minutos del lugar de un accidente a una hora específica del día. Los hospitales que estén a más de 15 minutos con esas condiciones del tráfico no se incluirán en los resultados.

Más información sobre el resultado de Buscar instalaciones más cercanas

Uso

  • El cuadro de diálogo de la herramienta agrupa los diversos parámetros opcionales en las siguientes seis categorías para hacer que sea más fácil administrarlos:

    • Análisis avanzado
    • Barreras
    • Modo de viaje personalizado
    • Dataset de red
    • Ubicaciones de red
    • Salida
    • Capacidades de servicio

Sintaxis

FindClosestFacilities_na (Incidents, Facilities, Measurement_Units, Network_Dataset, Output_Geodatabase, Output_Routes_Name, Output_Directions_Name, Output_Closest_Facilities_Name, {Number_of_Facilities_to_Find}, {Default_Cutoff}, {Travel_Direction}, {Time_of_Day}, {Time_of_Day_Usage}, {Time_Zone_for_Time_of_Day}, {UTurn_Policy}, {Point_Barriers}, {Line_Barriers}, {Polygon_Barriers}, {Time_Attribute}, {Time_Attribute_Units}, {Distance_Attribute}, {Distance_Attribute_Units}, {Use_Hierarchy_in_Analysis}, {Restrictions}, {Attribute_Parameter_Values}, {Accumulate_Attributes}, {Maximum_Snap_Tolerance}, {Feature_Locator_WHERE_Clause}, {Route_Shape}, {Route_Line_Simplification_Tolerance}, {Populate_Directions}, {Directions_Language}, {Directions_Distance_Units}, {Directions_Style_Name}, {Maximum_Features_Affected_by_Point_Barriers}, {Maximum_Features_Affected_by_Line_Barriers}, {Maximum_Features_Affected_by_Polygon_Barriers}, {Maximum_Facilities}, {Maximum_Facilities_to_Find}, {Maximum_Incidents}, {Force_Hierarchy_Beyond_Distance}, {Save_Output_Network_Analysis_Layer}, {Travel_Mode}, {Overrides}, {Save_Route_Data})
ParámetroExplicaciónTipo de datos
Incidents

Esta herramienta determina qué instalaciones son las más próximas a un incidente y este parámetro especifica los incidentes. Para resolver un análisis se necesita por lo menos un incidente.

Al especificar los incidentes, se pueden definir propiedades para cada una de ellas, como su nombre o la hora del servicio, mediante el uso de atributos. Los incidentes se pueden especificar con los siguientes atributos:

OBJECTID: Campo de Id. administrado por el sistema.

SHAPE: Campo de geometría que indica la ubicación geográfica del incidente.

Name: nombre del incidente. El nombre se utiliza en las indicaciones sobre cómo llegar. Si no se especifica el nombre, se genera automáticamente un nombre único con Location en las rutas e indicaciones de salida.

ID: identificador único del incidente. El identificador se incluye en las rutas de salida (como campo IncidentID) y puede ayudar a unir información adicional de las rutas de salida como, por ejemplo, el tiempo total de viaje o la distancia total, con atributos de los incidentes o viceversa. Si no se especifica el Id., el servicio genera automáticamente un identificador único para cada incidente.

AdditionalTime: cantidad de tiempo pasado en el incidente, que se añade al tiempo total de la ruta. Las unidades de este valor de atributo se especifican con el parámetro Unidades de medida. El valor del atributo se incluye en el análisis solo cuando las unidades de medida se basan en el tiempo. El valor predeterminado es 0.

Si va a buscar los parques de bomberos más próximos a incidentes de incendios para estimar los tiempos de respuesta, el atributo AdditionalTime puede almacenar el tiempo que necesitan los bomberos para preparar su equipo en la ubicación del incidente antes de empezar a atajar el fuego.

AdditionalDistance: distancia adicional de viaje en el incidente, que se añade a la distancia total de la ruta. Las unidades de este valor de atributo se especifican con el parámetro Unidades de medida. El valor del atributo se incluye en el análisis solo cuando las unidades de medida se basan en la distancia. El valor predeterminado es 0.

Por lo general, la localización de un incidente, como un hogar, no se encuentra exactamente en las calles, sino ligeramente apartada de la calle. Este valor de atributo se puede usar para modelizar la distancia entre la localización real del incidente y su localización en la calle, si es importante incluir esa distancia en la distancia total de viaje.

CurbApproach: especifica la dirección en la que un vehículo puede llegar al incidente y partir de él. El valor de campo se especifica como uno de los siguientes enteros (use el código numérico, no el nombre entre paréntesis):

  • 0 (Cualquier lado del vehículo): el vehículo puede aproximarse al incidente y abandonarlo en cualquier dirección, de modo que se admite un cambio de sentido en el incidente. Puede elegir esta configuración si es posible y práctico que su vehículo dé la vuelta en el incidente. Esta decisión puede depender del ancho del camino y del volumen de tráfico, o de si el incidente dispone de una zona estacionamiento en la que los vehículos pueden maniobrar.
  • 1 (Lado derecho del vehículo): cuando el vehículo se aproxima al incidente y lo abandona, el incidente debe estar en el lado derecho del vehículo. Los cambios de sentido están prohibidos. Esto se usa normalmente para vehículos como los autobuses que deben llegar con la parada a la derecha.
  • 2 (Lado izquierdo del vehículo): cuando el vehículo se aproxima al incidente y lo abandona, el bordillo debe estar en el lado izquierdo del vehículo. Los cambios de sentido están prohibidos. Esto se usa normalmente para vehículos como los autobuses que deben llegar con la parada a la izquierda.
  • 3 (Sin cambios de sentido): cuando el vehículo se aproxima al incidente, el bordillo puede estar a uno otro lado del vehículo; no obstante, el vehículo debe partir sin cambiar de sentido.

La propiedad CurbApproach se ha diseñado para trabajar con los dos tipos de estándares nacionales de circulación: por la derecha (Estados Unidos) y por la izquierda (Reino Unido). En primer lugar, considere un incidente en el lado izquierdo de un vehículo. Siempre estará situada el lado izquierdo, independientemente de si el vehículo circula por la mitad izquierda o derecha del camino. Los estándares de circulación nacionales pueden influir en su decisión de aproximarse al incidente por una de las dos direcciones posibles, de modo que quede en el lado derecho o en el lado izquierdo del vehículo. Por ejemplo, si desea llegar a un incidente y no hay un carril entre el vehículo y el incidente, elegiría 1 (Lado derecho del vehículo) en Estados Unidos y 2 (Lado izquierdo del vehículo) en el Reino Unido.

Feature Set
Facilities

Esta herramienta encuentra las instalaciones más próximas a incidentes y este parámetro las especifica. Para resolver el análisis se necesita por lo menos una instalación.

Al especificar las instalaciones, se pueden definir propiedades para cada una de ellas, como su nombre o la hora del servicio, mediante el uso de atributos. Las instalaciones se pueden especificar con los siguientes atributos:

Name: nombre de la instalación. El nombre se utiliza en las indicaciones sobre cómo llegar. Si no se especifica el nombre, se genera automáticamente un nombre único con Location en las rutas e indicaciones de salida.

ID: identificador único de la instalación. El identificador se incluye en las rutas de salida (como el campo FacilityID) y en las instalaciones más próximas de salida como campos FacilityID. El campo FacilityID se puede usar para unir información adicional de las rutas de salida como, por ejemplo, el tiempo total de viaje o la distancia total, con atributos de las instalaciones. Si no se especifica el Id., el servicio genera automáticamente un identificador único para cada instalación.

AdditionalTime: cantidad de tiempo pasado en la instalación, que se añade al tiempo total de la ruta. Las unidades de este valor de atributo se especifican con el parámetro Unidades de medida. El valor del atributo se incluye en el análisis solo cuando las unidades de medida se basan en el tiempo. El valor predeterminado es 0.

Si busca los parques de bomberos más próximos a incidentes de incendios, AdditionalTime puede almacenar el tiempo que tarda una cuadrilla en preparar los equipos protectores necesarios para salir del parque de bomberos.

AdditionalDistance: distancia adicional de viaje en la instalación, que se añade a la distancia total de la ruta. Las unidades de este valor de atributo se especifican con el parámetro Unidades de medida. El valor del atributo se incluye en el análisis solo cuando las unidades de medida se basan en la distancia. El valor predeterminado es 0.

Por lo general, la localización de una instalación, como un parque de bomberos, no se encuentra exactamente en la calle, sino ligeramente apartada de la calle. AdditionalDistance puede modelar la distancia entre la ubicación real de la instalación y su ubicación en la calle, si es importante incluir esa distancia en la distancia total de viaje.

CurbApproach: especifica la dirección en la que un vehículo puede llegar a la instalación y salir de ella. El valor de campo se especifica como uno de los siguientes enteros (use el código numérico, no el nombre entre paréntesis):

  • 0 (Cualquier lado del vehículo): el vehículo puede aproximarse a la instalación y abandonarla en cualquier dirección, de modo que se admite un cambio de sentido en la instalación. Puede elegir esta configuración si es posible y práctico que su vehículo dé la vuelta en la instalación. Esta decisión puede depender del ancho del camino y del volumen de tráfico, o de si la instalación dispone de una zona estacionamiento en la que los vehículos pueden maniobrar.
  • 1 (Lado derecho del vehículo): cuando el vehículo se aproxima a la instalación y la abandona, la instalación debe estar en el lado derecho del vehículo. Los cambios de sentido están prohibidos. Esto se usa normalmente para vehículos como los autobuses que deben llegar con la parada a la derecha.
  • 2 (Lado izquierdo del vehículo): cuando el vehículo se aproxima a la instalación y la abandona, el bordillo debe estar en el lado izquierdo del vehículo. Los cambios de sentido están prohibidos. Esto se usa normalmente para vehículos como los autobuses que deben llegar con la parada a la izquierda.
  • 3 (Sin cambios de sentido): cuando el vehículo se aproxima a la instalación, el bordillo puede estar a uno otro lado del vehículo; no obstante, el vehículo debe partir sin cambiar de sentido.

La propiedad CurbApproach se diseñó para trabajar con los dos tipos de estándares nacionales de circulación: por la derecha (Estados Unidos) y por la izquierda (Reino Unido). En primer lugar, considere una instalación en el lado izquierdo de un vehículo. Siempre estará situada el lado izquierdo, independientemente de si el vehículo circula por la mitad izquierda o derecha del camino. Los estándares de circulación nacionales pueden influir en su decisión de aproximarse a una instalación por una de las dos direcciones posibles, de modo que quede en el lado derecho o en el lado izquierdo del vehículo. Por ejemplo, si desea llegar a una instalación y no tiene un carril entre el vehículo y la parada, elegiría Lado derecho del vehículo (1) en los Estados Unidos pero Lado izquierdo del vehículo (2) en el Reino Unido.

Feature Set
Measurement_Units

Especifique las unidades que se deben usar para medir e indicar el tiempo o la distancia total de viaje de las rutas de salida. La herramienta encuentra la instalación más próxima midiendo el tiempo de viaje o la distancia de viaje a lo largo de las calles.

Las unidades elegidas para este parámetro determinan si la herramienta medirá la distancia o el tiempo de recorrido para averiguar cuál es la más próxima. Elija una unidad de tiempo para medir el tiempo de recorrido. Para medir la distancia de recorrido, elija una unidad de distancia. La elección también determina en qué unidades indicará la herramienta el tiempo de recorrido o la distancia total en los resultados. Se incluyen las opciones siguientes:

  • Meters
  • Kilometers
  • Feet
  • Yards
  • Miles
  • NauticalMiles
  • Seconds
  • Minutes
  • Hours
  • Days

La herramienta selecciona si se debe usar el atributo de coste de red especificado en el parámetro de Atributo de tiempo o Atributo de distancia, dependiendo de si las unidades de medida elegidas se basan en el tiempo o la distancia.

La herramienta realiza la conversión de unidades necesaria cuando el valor de Unidades de medida difiere de las unidades del atributo de coste de distancia o de tiempo correspondiente.

String
Network_Dataset

El dataset de red en el que se realizará el análisis. La mayoría de las veces los datasets de red representan redes de calles pero también pueden representar otras redes de transporte. El dataset de red debe tener al menos un atributo de coste basado en el tiempo y uno basado en la distancia.

Network Dataset Layer
Output_Geodatabase

Espacio de trabajo de salida. Este espacio de trabajo ya debe existir. El espacio de trabajo de salida predeterminado es in_memory.

Workspace
Output_Routes_Name

Nombre de la clase de entidad de salida que contiene las rutas o las líneas que conectan los incidentes con sus instalaciones más próximas. Esta clase de entidad también contiene, como atributo, el coste total del viaje entre los incidentes y sus instalaciones más próximas.

El tema de ayuda El resultado de Buscar instalaciones más cercanas describe el esquema de esta clase de entidad de salida.

String
Output_Directions_Name

Nombre de la clase de entidad de salida que contiene las indicaciones.

El tema de ayuda El resultado de Buscar instalaciones más cercanas describe el esquema de esta clase de entidad de salida.

String
Output_Closest_Facilities_Name

Nombre de la clase de entidad de salida que contiene las instalaciones más próximas.

El tema de ayuda El resultado de Buscar instalaciones más cercanas describe el esquema de esta clase de entidad de salida.

String
Number_of_Facilities_to_Find
(Opcional)

Especifica al número de instalaciones más próximas que se buscarán por incidente. Esto es útil en situaciones tales como un incendio, donde pueden ser necesarios camiones de bomberos de diferentes estaciones. Por ejemplo, puede especificar que se busquen los tres parques de bomberos más próximos a un incendio.

Si va a configurar un servicio a partir de esta herramienta y desea limitar el uso de los recursos como, por ejemplo, el tiempo de procesamiento del servidor, utilice el parámetro Número máximo de instalaciones para buscar para limitar el número máximo de instalaciones que puede introducir un usuario en Cantidad de instalaciones a buscar.

Long
Default_Cutoff
(Opcional)

Especifica el valor del tiempo de viaje o la distancia de viaje en la cual se debe detener la búsqueda de instalaciones para un incidente determinado. Por ejemplo, al buscar los hospitales más cercanos al lugar de un accidente, un valor de tolerancia de 15 minutos significaría que la herramienta buscaría el hospital más cercano a menos de 15 minutos del incidente. Si el hospital más próximo se encuentra a 17 minutos, no se devolverá ninguna ruta como resultado. Un valor de tolerancia es especialmente útil al buscar varias instalaciones.

Las unidades de este parámetro se especifican con el parámetro Unidades de medida.

Double
Travel_Direction
(Opcional)

Especifica si se desea buscar la instalación más cercana midiendo desde el incidente hasta la instalación, o desde la instalación hasta el incidente.

  • TRAVEL_FROM —La dirección de viaje desde las instalaciones hasta los incidentes. Los departamentos de bomberos suelen utilizar esta configuración porque les preocupa el tiempo que se tarda en viajar desde la estación de bomberos (instalación) hasta la ubicación de la emergencia (incidente).
  • TRAVEL_TO —La dirección de viaje desde los incidentes hasta las instalaciones. Las tiendas minoristas suelen utilizar esta configuración porque les preocupa el tiempo que tardan los compradores (incidentes) en llegar a la tienda (instalación).

Utilizando uno de los valores de los parámetros se pueden encontrar distintas instalaciones ya que el tiempo de viaje a lo largo de ciertas calles puede variar según la dirección de viaje y las restricciones de circulación en un solo sentido. Por ejemplo, una instalación puede estar a una distancia de viaje de 10 minutos desde el incidente al viajar desde el incidente hasta la instalación, pero viajar desde la instalación hasta el incidente, puede llevar 15 minutos debido a que hay un tiempo de viaje distinto en esa dirección. Si establece un valor para Hora del día, el tráfico también puede hacer que las opciones Instalación a incidente e Incidente a instalación den resultados distintos.

String
Time_of_Day
(Opcional)

Especifica la hora y la fecha en la cual deben comenzar y terminar las rutas. El valor se utiliza como hora de inicio o fin de la ruta en función del valor del parámetro Uso en hora del día. Si se especifican la fecha y la hora actuales como valor para este parámetro, la herramienta utilizará las condiciones de tráfico en directo para determinar las instalaciones más próximas y el tiempo total de viaje se basará en las condiciones del tráfico.

Si su dataset de red contiene datos de tráfico en directo o históricos, al especificar una hora del día se obtiene una estimación más precisa del tiempo de viaje entre el incidente y las instalaciones porque los tiempos de viaje tienen en cuenta las condiciones del tráfico aplicables a esa fecha y hora.

El parámetro Zona horaria para hora del día especifica si la fecha y la hora se refieren a UTC o a la zona horaria en la cual se encuentra la instalación o el incidente.

Independientemente de la configuración de Zona horaria para hora del día, si las instalaciones y los incidentes están en más de una zona horaria, la herramienta aplica las reglas siguientes:

  • Todos los incidentes deben estar en la misma zona horaria cuando:

    • Especifica un tiempo de inicio y viaje del incidente a la instalación.
    • Especifica una hora de fin y viaje de la instalación al incidente.

  • Todas las instalaciones deben estar en la misma zona horaria cuando:

    • Especifica una hora de fin y viaje de la instalación al incidente.
    • Especifica una hora de fin y viaje del incidente a la instalación.

Date
Time_of_Day_Usage
(Opcional)

Indica si el valor del parámetro Hora del día representa la hora de llegada o salida de las rutas.

  • START_TIME — Al elegir esta opción, la herramienta busca la mejor ruta teniendo en cuenta el valor del parámetro Hora del día como el momento de salida desde la instalación o el incidente.
  • END_TIME — Al elegir esta opción, la herramienta considera el valor del parámetro Hora del día como el momento de llegada desde la instalación o el incidente. Esta opción es útil si desea conocer a qué hora debe salir de una ubicación para llegar al destino a la hora especificada en el parámetro Hora del día.
  • NOT_USED —Al elegir esta opción, la herramienta no utiliza ningún valor de Hora del día al calcular las instalaciones más próximas. Los datos históricos de tráfico y de tráfico en directo no se utilizarán.
String
Time_Zone_for_Time_of_Day
(Opcional)

Especifica la zona horaria del parámetro Hora del día.

  • GEO_LOCAL —El parámetro Time_of_Day hace referencia a la zona horaria en la cual se encuentran las instalaciones o los incidentes.
    • Si Time_of_Day_Usage está definido como START_TIME y la Travel_Direction está definida como TRAVEL_FROM, esta será la zona horaria de las instalaciones.
    • Si Time_of_Day_Usage está definido como START_TIME y la Travel_Direction está definida como TRAVEL_TO, esta será la zona horaria de los incidentes.
    • Si Time_of_Day_Usage está definido como END_TIME y la Travel_Direction está definida como TRAVEL_FROM, esta será la zona horaria de los incidentes.
    • Si Time_of_Day_Usage está definido como END_TIME y la Travel_Direction está definida como TRAVEL_TO, esta será la zona horaria de las instalaciones.
  • UTC —El parámetro Time_of_Day hace referencia al tiempo universal coordinado (UTC). Seleccione esta opción si desea encontrar qué es lo más próximo en una hora específica, como en instante presente, pero no está seguro de la zona horaria en la que se encuentran las instalaciones o los incidentes.

Independientemente de la configuración de Zona horaria para hora del día, si las instalaciones y los incidentes están en más de una zona horaria, la herramienta aplica las reglas siguientes:

  • Todos los incidentes deben estar en la misma zona horaria cuando:

    • Especifica un tiempo de inicio y viaje del incidente a la instalación.
    • Especifica una hora de fin y viaje de la instalación al incidente.

  • Todas las instalaciones deben estar en la misma zona horaria cuando:

    • Especifica una hora de fin y viaje de la instalación al incidente.
    • Especifica una hora de fin y viaje del incidente a la instalación.

String
UTurn_Policy
(Opcional)

Política de cambios de sentido en los cruces. Permitir cambios de sentido implica que el solucionador puede dar la vuelta en un cruce y regresar por la misma calle. Debido a que los cruces representan intersecciones de calles y callejones sin salida, los diferentes vehículos pueden ser capaces de dar la vuelta en algunos cruces, pero no en otros, depende de que el cruce sea una intersección o un callejón sin salida. Para acomodar, el parámetro de la política de cambios de sentido se especifica implícitamente por la cantidad de bordes que se conectan en el cruce, que se conoce como valencia de cruce. Los valores aceptables para este parámetro se enumeran a continuación; cada uno seguido de una descripción de su significado en términos de valencia de cruce.

  • ALLOW_UTURNS —Se permiten los cambios de sentido en los cruces con cualquier cantidad de bordes adyacentes. Este es el valor predeterminado.
  • NO_UTURNS —Los cambios de sentido están prohibidos en todos los cruces, independientemente de la valencia de cruce. Tenga en cuenta, sin embargo, que los cambios de sentido seguirán estando permitidos en las ubicaciones de red aunque haya elegido esta configuración; sin embargo, puede establecer la propiedad CurbApproach de cada ubicación de red individual para prohibir los cambios de sentido en ella.
  • ALLOW_DEAD_ENDS_ONLY —Los cambios de sentido están prohibidos en todos los cruces, excepto los que tienen solo un borde adyacente (una calle sin salida).
  • ALLOW_DEAD_ENDS_AND_INTERSECTIONS_ONLY —Los cambios de sentido están prohibidos en los cruces donde se encuentran dos bordes adyacentes pero están permitidos en las intersecciones (cruces con tres o más bordes adyacentes) o calles sin salida (cruces con exactamente un borde adyacente). A menudo, las redes tienen cruces extraños en medio de segmentos de carretera. Esta opción evita que los vehículos hagan cambios de sentido en estas ubicaciones.

El valor de este parámetro se invalida cuando Modo de viaje (Travel_Mode en Python) está establecido en cualquier otro valor que no sea personalizado.

String
Point_Barriers
(Opcional)

Especifica barreras de punto, que se dividen en dos tipos: barreras de restricción y barreras de punto de coste añadido. Restringen temporalmente el trazado poligonal en toda la red o agregan impedancia a puntos de la red. Las barreras de punto se definen mediante un conjunto de entidades, y los valores de atributo que especifica para las entidades de punto determinan si son barreras de restricción o de coste agregado. Los campos en la tabla de atributos se muestran y describen a continuación.

ObjectID:

Campo ID administrado por el sistema.

Forma:

Campo de geometría que indica la ubicación geográfica del objeto de análisis de red.

Nombre:

El nombre de la barrera.

BarrierType:

Especifica si la barrera restringe completamente el viaje o agrega coste cuando se viaja a través de ella. Existen dos opciones:

  • Restricción (0): prohíbe atravesar la barrera. Este es el valor predeterminado.
  • Coste agregado (2): atravesar la barrera aumenta el coste de la red por el valor especificado en los campos Additional_Time y Additional_Distance.

Utilice el valor 0 para Restricción y 2 para Coste agregado.

Additional_Time:

Indica cuánto tiempo de viaje se agrega al atravesar la barrera. Este campo solo es aplicable para barreras con coste añadido y solo si las unidades de medida se basan en el tiempo. El valor de este campo debe ser mayor o igual que cero y sus unidades son las mismas que las especificadas en el parámetro unidades de medida.

Additional_Distance:

Indica cuánta distancia se agrega al atravesar la barrera. Este campo solo se aplica a barreras con coste agregado y solo si las unidades de medida se basan en distancias. El valor del campo debe ser mayor o igual que cero y sus unidades son las mismas que las especificadas en el parámetro unidades de medida.

Feature Set
Line_Barriers
(Opcional)

Especifica las barreras de línea, que restringen temporalmente el trazado poligonal en ellos. Las barreras de línea se definen mediante un conjunto de entidades. Los campos en la tabla de atributos se muestran y describen a continuación.

ObjectID:

Campo ID administrado por el sistema.

Forma:

Campo de geometría que indica la ubicación geográfica del objeto de análisis de red.

Nombre:

El nombre de la barrera.

Feature Set
Polygon_Barriers
(Opcional)

Especifica barreras de polígono, que se dividen en dos tipos: barreras de restricción y barreras de polígono de coste escalado. Restringen temporalmente el trazado poligonal o la impedancia de escala en las partes de la red que cubren. Las barreras de polígono se definen mediante un conjunto de entidades, y los valores de atributo que especifica para las entidades de polígono determinan si son barreras de restricción o de coste de escala. Los campos en la tabla de atributos se muestran y describen a continuación.

ObjectID:

Campo ID administrado por el sistema.

Forma:

Campo de geometría que indica la ubicación geográfica del objeto de análisis de red.

Nombre:

El nombre de la barrera.

BarrierType:

Especifica si la barrera restringe completamente el viaje o escala el coste de viajar a través de ella. Existen dos opciones:

  • Restricción (0): prohíbe recorrer cualquier parte de la barrera. Este es el valor predeterminado.
  • Coste en escala (1): escala la impedancia de los bordes subyacentes multiplicándola por el valor de la propiedad ScaledCostFactor. Si la barrera cubre parcialmente los bordes, la impedancia se prorratea y se multiplica.

Utilice el valor 0 para Restricción y 1 para Coste en escala.

ScaledTimeFactor:

Este es el factor por el cual se multiplica el tiempo de viaje de las calles que intersecan con la barrera. Este campo solo tiene validez para barreras con coste en escala y solo si las unidades de medida se basan en el tiempo. El valor del campo debe ser mayor que cero.

ScaledDistanceFactor:

Este es el factor por el cual se multiplica la distancia de las calles que intersecan con la barrera. Este atributo solo tiene validez para barreras con coste en escala y solo si las unidades de medida se basan en distancias. El valor del atributo debe ser mayor que cero.

Feature Set
Time_Attribute
(Opcional)

Define el atributo de coste de red que se debe utilizar cuando el valor de las unidades de medida sea una unidad de tiempo.

La herramienta realiza la conversión necesaria de unidades de tiempo cuando el valor de las unidades de medida difiere de las unidades del atributo de coste definido aquí. Es decir, no es necesario que las unidades de tiempo del límite predeterminado y del atributo de coste de red sean las mismas.

El valor de este parámetro se invalida cuando Modo de viaje (Travel_Mode en Python) está establecido en cualquier otro valor que no sea Personalizado.

String
Time_Attribute_Units
(Opcional)

Unidades del atributo de tiempo. Las unidades del atributo de tiempo se pueden establecer explícitamente pero se recomienda no pasar nada o pasar "#" y dejar que el solucionador determine las unidades.

El valor de este parámetro se invalida cuando Travel_Mode está establecido en cualquier otro valor que no sea CUSTOM.

String
Distance_Attribute
(Opcional)

Define el atributo de coste de red que se debe utilizar cuando el valor de las unidades de medida sea una unidad de distancia.

La herramienta realiza la conversión necesaria de unidades de distancia cuando el valor de las unidades de medida difiere de las unidades del atributo de coste definido aquí. Es decir, no es necesario que las unidades de medida y las unidades de distancia del atributo de coste de red sean las mismas.

El valor de este parámetro se invalida cuando Modo de viaje (Travel_Mode en Python) está establecido en cualquier otro valor que no sea Personalizado.

String
Distance_Attribute_Units
(Opcional)

Unidades del atributo de distancia. Las unidades del atributo de distancia se pueden establecer explícitamente pero se recomienda no pasar nada o pasar "#" y dejar que el solucionador determine las unidades.

El valor de este parámetro se invalida cuando Travel_Mode está establecido en cualquier otro valor que no sea CUSTOM.

String
Use_Hierarchy_in_Analysis
(Opcional)

Especifique si es necesario usar la jerarquía para buscar las rutas más cortas entre puntos.

  • USE_HIERARCHY — Utiliza la jerarquía para buscar rutas. Cuando se usa una jerarquía, la herramienta da preferencia a las calles de orden superior (como las autovías) frente a las de orden inferior (como las carreteras locales), y se puede usar para simular la preferencia del conductor por viajar por autovías en lugar de carreteras locales aunque esto suponga un viaje más largo. Esto es especialmente cierto al buscar rutas hasta instalaciones lejanas, porque los conductores que realizan viajes a larga distancia prefieren viajar por autovías y así evitar paradas, intersecciones y giros. Desde el punto de vista computacional, usar la jerarquía es más rápido, especialmente en rutas a largas distancias, porque la herramienta debe seleccionar la mejor ruta sobre un subconjunto relativamente menor de calles.
  • NO_HIERARCHY — No utiliza la jerarquía para buscar rutas. Si no se utiliza la jerarquía, la herramienta tiene en cuenta todas las calles y no da preferencia a las calles de mayor orden al buscar una ruta. A menudo esto se usa al buscar rutas a corta distancia dentro de una ciudad.

El parámetro no se utiliza si no se definen atributos de jerarquía en el dataset de red utilizado para realizar el análisis. En tales caso, utilice «#» como el valor de parámetro.

Puede utilizar el parámetro Force_Hierarchy_Beyond_Distance para forzar que el solucionador utilice la jerarquía incluso si Use_Hierarchy_in_Analysis está establecido en False.

Este parámetro se ignora a menos que Travel_Mode esté establecido en CUSTOM. Cuando se modela un modo a pie personalizado, se recomienda desactivar la jerarquía, ya que está diseñada para vehículos motorizados.

Boolean
Restrictions
[restriction,...]
(Opcional)

Indica qué atributos de restricción de red se respetan en el momento de la resolución.

El valor de este parámetro se invalida cuando Modo de viaje (Travel_Mode en Python) está establecido en cualquier otro valor que no sea personalizado.

String
Attribute_Parameter_Values
(Opcional)

Especifica los valores de parámetro de atributos de red que tienen parámetros. El conjunto de registros tiene dos columnas que trabajan juntas para identificar parámetros de forma única y otra columna que especifica el valor del parámetro.

El valor de este parámetro se invalida cuando Modo de viaje (Travel_Mode en Python) está establecido en cualquier otro valor que no sea personalizado.

El conjunto de registros de valores de parámetro tiene atributos asociados. Los campos en la tabla de atributos se enumeran y describen a continuación.

ObjectID:

Campo ID administrado por el sistema.

AttributeName:

El nombre del atributo de red cuyo parámetro de atributos se establece por la fila de tabla.

ParameterName:

El nombre del parámetro de atributos cuyo valor se establece por la fila de tabla. (Los parámetros de tipo Objeto no se pueden actualizar utilizando esta herramienta).

ParameterValue:

El valor que desea para el parámetro de atributos. Si no se especifica el valor, el valor de los parámetros de atributos se establecerá en Nulo.

Record Set
Accumulate_Attributes
[attribute,...]
(Opcional)

Lista de los atributos de coste que se acumularán durante el análisis. Estos atributos de acumulación se usan exclusivamente como referencia; el solucionador solo utiliza los atributos de coste especificados por los parámetros Atributo de tiempo (Time_Attribute en Python) o Atributo de distancia (Distance_Attribute en Python) para calcular las rutas más cortas.

Para cada atributo de coste acumulado, se agrega una propiedad Total_[attribute] a las rutas generadas por el solucionador.

String
Maximum_Snap_Tolerance
(Opcional)

La máxima tolerancia de alineación es la distancia más lejana que busca Network Analyst al ubicar o reubicar un punto en la red. La búsqueda busca bordes o cruces adecuados y alinea el punto con el más cercano. Si no se encuentra una ubicación adecuada dentro de la máxima tolerancia de alineación, el objeto se marca como no ubicado.

Linear Unit
Feature_Locator_WHERE_Clause
(Opcional)

Una expresión SQL utilizada para seleccionar un subconjunto de entidades de origen que limita los elementos de red en que se pueden ubicar las instalaciones. La sintaxis para este parámetro consta de dos partes: la primera es el nombre de la clase de entidad de origen (seguido de un espacio) y la segunda es la expresión SQL. Al escribir una expresión SQL para dos o más clases de entidad de origen, sepárelas con un punto y coma.

Para garantizar que las instalaciones no se encuentran en autopistas de acceso limitado, por ejemplo, se debe escribir una expresión SQL como la siguiente para excluir esas entidades de origen: "Streets" "FUNC_CLASS not in('1', '2')".

Tenga en cuenta que durante la carga las barreras ignoran la cláusula WHERE del localizador de entidad.

String
Route_Shape
(Opcional)

Especifica el tipo de forma para las entidades de ruta que son la salida de la herramienta. El parámetro se puede especificar usando uno de los siguientes valores:

  • TRUE_LINES_WITH_MEASURES — Devuelve la forma exacta de la ruta resultante basada en las calles subyacentes. Adicionalmente, construya las mediciones de tal modo que la forma se pueda usar para referenciación lineal.
  • TRUE_LINES_WITHOUT_MEASURES — Devuelve la forma exacta de la ruta resultante basada en las calles subyacentes.
  • STRAIGHT_LINES — Devuelve una línea recta entre el incidente y la instalación.
  • NO_LINES — No devuelve ninguna forma para las rutas. Este valor puede ser útil en casos en los cuales solo le interese determinar el tiempo total de viaje o la distancia de viaje entre la instalación más próxima y el incidente.

Cuando el parámetro Forma de la ruta se ha definido como Forma verdadera, la generalización de la forma de la ruta se puede controlar mejor usando los valores apropiados para el parámetro Tolerancia de simplificación de línea de ruta.

Cualquiera que sea el valor elegido para el parámetro Forma de ruta, la mejor ruta siempre se determina minimizando el tiempo de viaje o la distancia de viaje; nunca usando la distancia en línea recta entre incidentes e instalaciones. Esto significa que solo las formas de la ruta son diferentes, no las calles subyacentes en las que se realizan las búsquedas para encontrar la ruta.

String
Route_Line_Simplification_Tolerance
(Opcional)

Especificar cuánto desea simplificar la geometría de la ruta.

La herramienta ignora este parámetro si el parámetro Route_Shape no está establecido en TRUE_LINES_WITH_MEASURES o TRUE_LINES_WITHOUT_MEASURES.

La simplificación mantiene puntos críticos de una ruta, como los giros en intersecciones, para definir la forma esencial de la ruta y quita el resto de los puntos. La distancia de simplificación que especifique será el desplazamiento máximo permisible que puede apartarse la línea simplificada de la línea original. La simplificación de una línea reduce el número de vértices que forman parte de la geometría de la ruta. Esto mejora el tiempo de ejecución de la herramienta.

El valor de este parámetro se invalida cuando Modo de viaje (Travel_Mode en Python) está establecido en cualquier otro valor que no sea personalizado.

Linear Unit
Populate_Directions
(Opcional)

Especifique si la herramienta debe generar indicaciones de conducción para cada ruta.

  • DIRECTIONS —Indica que las indicaciones se generan y configuran en función de los valores de los parámetros Idioma de indicaciones, Nombre de estilo de direcciones y Unidades de distancia de las indicaciones.
  • NO_DIRECTIONS —No se generan las indicaciones y la herramienta devuelve una capa de indicaciones vacía.
Boolean
Directions_Language
(Opcional)

Especifique el idioma que se debe utilizar para generar las indicaciones de conducción.

Este parámetro solo se usa cuando el parámetro Completar direcciones está activado o definido como True.

Los idiomas disponibles para las indicaciones dependen de qué paquetes de idioma de ArcGIS están instalados en su ordenador. Los valores se introducen en forma de códigos de idioma de dos o cinco caracteres, como en para inglés o zh-CN para chino simplificado.

Si se especifica un código de idioma no admitido, la herramienta devuelve las indicaciones en el idioma predeterminado, el inglés.

String
Directions_Distance_Units
(Opcional)

Especifica las unidades para mostrar la distancia de viaje en las indicaciones de conducción. Este parámetro solo se usa cuando el parámetro Completar direcciones está activado o definido como True.

  • Miles
  • Kilometers
  • Meters
  • Feet
  • Yards
  • NauticalMiles
String
Directions_Style_Name
(Opcional)

Especifique el nombre del estilo de formato para las indicaciones. Este parámetro solo se usa cuando el parámetro Completar direcciones está activado o definido como True. El parámetro se puede especificar usando los valores siguientes:

  • NA Desktop — Genera indicaciones giro por giro adecuadas para imprimir.
  • NA Navigation — Genera instrucciones giro por giro diseñada para un dispositivo de navegación desde el vehículo.
  • NA Campus —Genera indicaciones adecuadas para redes peatonales, incluidas las aceras y los interiores de edificios.
String
Maximum_Features_Affected_by_Point_Barriers
(Opcional)

Restringe el número de entidades que pueden ser afectadas por las barreras de punto.

Este parámetro le ayuda a regir la cantidad de procesamiento que se produce al resolver. Por ejemplo, puede asignar un valor bajo para este parámetro para la versión gratuita del servicio que está creando y utilizar un valor más alto para la versión de suscripción de pago.

Un valor nulo indica que no hay ningún límite.

Long
Maximum_Features_Affected_by_Line_Barriers
(Opcional)

Restringe el número de entidades pueden ser afectadas por las barreras de línea.

Este parámetro le ayuda a regir la cantidad de procesamiento que se produce al resolver. Por ejemplo, puede asignar un valor bajo para este parámetro para la versión gratuita del servicio que está creando y utilizar un valor más alto para la versión de suscripción de pago.

Un valor nulo indica que no hay ningún límite.

Long
Maximum_Features_Affected_by_Polygon_Barriers
(Opcional)

Restringe el número de entidades que pueden ser afectadas por las barreras de polígono.

Este parámetro le ayuda a regir la cantidad de procesamiento que se produce al resolver. Por ejemplo, puede asignar un valor bajo para este parámetro para la versión gratuita del servicio que está creando y utilizar un valor más alto para la versión de suscripción de pago.

Un valor nulo indica que no hay ningún límite.

Long
Maximum_Facilities
(Opcional)

Limita la cantidad de instalaciones que se puede agregar al análisis de la instalación más próxima.

Este parámetro le ayuda a regir la cantidad de procesamiento que se produce al resolver. Por ejemplo, puede asignar un valor bajo para este parámetro para la versión gratuita del servicio que está creando y utilizar un valor más alto para la versión de suscripción de pago.

Un valor nulo indica que no hay ningún límite.

Long
Maximum_Facilities_to_Find
(Opcional)

Limita cuántas instalaciones puede solicitar el usuario para que el servicio las encuentre.

Este parámetro le ayuda a regir la cantidad de procesamiento que se produce al resolver. Por ejemplo, puede asignar un valor bajo para este parámetro para la versión gratuita del servicio que está creando y utilizar un valor más alto para la versión de suscripción de pago.

Un valor nulo indica que no hay ningún límite.

Long
Maximum_Incidents
(Opcional)

Limita cuántos incidentes se pueden agregar al análisis de instalaciones próximas.

Este parámetro le ayuda a regir la cantidad de procesamiento que se produce al resolver. Por ejemplo, puede asignar un valor bajo para este parámetro para la versión gratuita del servicio que está creando y utilizar un valor más alto para la versión de suscripción de pago.

Un valor nulo indica que no hay ningún límite.

Long
Force_Hierarchy_Beyond_Distance
(Opcional)

Especifica la distancia después de la cual el solucionador forzará la jerarquía, aunque la jerarquía no esté habilitada, al buscar las instalaciones más cercanas. Las unidades de este parámetro son las mismas que las que se muestran en el parámetro Unidades de atributo de distancia.

Buscar las instalaciones más próximas que están alejadas mientras se utiliza la jerarquía de red tiende a utilizar menos tiempo de procesamiento que buscar las mismas instalaciones más próximas sin usar la jerarquía. Este parámetro le ayuda a regir la cantidad de procesamiento que se produce al resolver.

Un valor nulo indica que la jerarquía nunca será aplicada y el valor del parámetro Utilizar jerarquía en el análisis siempre se respeta. Si el dataset de red de entrada no admite jerarquía, especificar un valor para este parámetro ocasionará un error. En este caso se debe utilizar un valor nulo.

Double
Save_Output_Network_Analysis_Layer
(Opcional)
  • NO_SAVE_OUTPUT_LAYER —La salida no incluye una capa de análisis de red.
  • SAVE_OUTPUT_LAYER —La salida incluye una capa de análisis de red con los resultados.

En cualquier caso, se devuelven clases de entidad con rutas e indicaciones. Sin embargo, un administrador del servidor puede elegir que la salida sea también una capa de análisis de red de salida para que el programa de instalación y los resultados de la herramienta puedan ser depurados utilizando los controles Network Analyst en el entorno de ArcGIS Desktop. Esto puede hacer que el proceso de depuración sea mucho más fácil.

En ArcGIS Desktop, la ubicación de salida predeterminada para la capa de análisis de red está en la carpeta temporal. Puede determinar la ubicación de la carpeta temporal mediante la evaluación del valor de entorno de geoprocesamiento arcpy.env.scratchFolder. La capa de análisis de red de salida se almacena como un archivo LYR cuyo nombre comienza con _ags_gpna y está seguido por un GUID alfanumérico.

Boolean
Travel_Mode
(Opcional)

Elija el modo de transporte para el análisis. CUSTOM es siempre una opción. Para que aparezcan otros nombres de modo de viaje, estos deben estar presentes en el dataset de red especificado en el parámetro Network_Dataset. (La función arcpy.na.GetTravelModes proporciona un diccionario de los objetos del modo de viaje configurado en un dataset de red, y la propiedad name devuelve el nombre de un objeto de modo de viaje).

Un modo de viaje se define en un dataset de red y proporciona valores de invalidación para los parámetros que, juntos, modelan coches, camiones, peatones u otros modos de viaje. Al elegir aquí un modo de viaje, no tiene que proporcionar valores para los siguientes parámetros, que se invalidan con los valores especificados en el dataset de red:

  • UTurn_Policy

  • Time_Attribute

  • Time_Attribute_Units

  • Distance_Attribute

  • Distance_Attribute_Units

  • Use_Hierarchy_in_Analysis

  • Restrictions

  • Attribute_Parameter_Values

  • Route_Line_Simplification_Tolerance

  • CUSTOM —Defina un modo de viaje que se ajuste a sus necesidades específicas. Cuando se elige CUSTOM, la herramienta no invalida los parámetros del modo de viaje mencionados anteriormente. Este es el valor predeterminado.
String
Overrides
(Opcional)

Especifique cualquier parámetro adicional que pueda influir en el comportamiento del solucionador al buscar soluciones para problemas de análisis de red.

Se debe especificar el valor para este parámetro en la notación de objetos JavaScript (JSON). Por ejemplo, un valor válido tiene el siguiente formato {"overrideSetting1" : "value1", "overrideSetting2" : "value2"}. El nombre del parámetro de invalidación siempre está incluido entre comillas dobles. Los valores pueden ser un número, operador booleano o cadena de caracteres.

El valor predeterminado para este parámetro es ningún valor, lo que indica que no se debe invalidar ningún parámetro del solucionador.

Las invalidaciones son parámetros avanzados que se deben utilizar solamente después de un análisis cuidadoso de los resultados obtenidos antes y después de aplicar los parámetros. Puede ponerse en contacto con el Soporte técnico de Esri para obtener una lista de los parámetros de invalidación compatibles para cada solucionador y sus valores aceptables.

String
Save_Route_Data
(Opcional)

Elija si la salida incluye un archivo zip que contiene una geodatabase de archivos con las entradas y salidas del análisis en un formato que se puede utilizar para compartir capas de ruta con el sistema en línea o con el portal.

En ArcGIS Desktop, la ubicación de salida predeterminada para este archivo de salida está en la carpeta temporal. Puede determinar la ubicación de la carpeta temporal mediante la evaluación del valor del entorno de geoprocesamiento arcpy.env.scratchFolder.

  • SAVE_ROUTE_DATA — Si está activado, la herramienta genera un archivo zip con un espacio de trabajo de la geodatabase de archivos que contiene las entradas y salidas del análisis.
  • NO_SAVE_ROUTE_DATA —Los datos de la ruta no se guardan. Esta es la opción predeterminada.
Boolean

Muestra de código

Ejemplo 1 de FindClosestFacilities (ventana de Python)

Ejecute la herramienta FindClosestFacilities utilizando los parámetros requeridos.

import arcpy
incidents = arcpy.FeatureSet()
incidents.load("Stores")
facilities = arcpy.FeatureSet()
facilities.load("Warehouses")
arcpy.na.FindClosestFacilities(incidents, facilities, "Minutes",
                                "Streets_ND", "in_memory", "Routes",
                                "Directions", "CLosestFacilities",
                                Number_of_Facilities_to_Find=1)
Ejemplo 2 de FindClosestFacilities (secuencia de comandos independiente)

En la secuencia de comandos independiente de Python siguiente se muestra cómo puede determinar FindClosestFacilities las tiendas más próximas a un almacén. La secuencia de comandos se puede modificar para usar otras entradas con el fin de encontrar la ambulancia más próxima a un accidente, la cuadrilla de trabajo más próxima a una línea eléctrica averiada, etc.

# Name: FindClosestFacilities_Workflow.py
# Description: For each store, find the closest warehouse. The output will show
#              the routes between stores and warehouses, driving directions,
#              and the subset of warehouses that were closest to stores.
# Requirements: Network Analyst Extension

#Import system modules
import arcpy
from arcpy import env

try:
    #Check out the Network Analyst extension license
    arcpy.CheckOutExtension("Network")

    #Set environment settings
    env.workspace = r'C:\arcgis\ArcTutor\Network Analyst\Tutorial\Paris.gdb'
    env.overwriteOutput = True

    #Set local variables
    inNetworkDataset = r'Transportation\ParisMultimodal_ND'
    inIncidents = r'Analysis\Stores'
    inFacilities = r'Analysis\Warehouses'
    outGeodatabase = r'C:\arcgis\ArcTutor\Network Analyst\Tutorial\Output.gdb'
    outRoutes = "Routes"
    outDirections = "Directions"
    outClosestFacilities = "ClosestFacilities"
    measurement_units = "Minutes"

    # Run FindClosestFacilities. Choose to find only the closest facility.
    arcpy.na.FindClosestFacilities(inIncidents, inFacilities, measurement_units,
                                    inNetworkDataset, outGeodatabase, outRoutes,
                                    outDirections, outClosestFacilities,
                                    Number_of_Facilities_to_Find=1)

    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 occured on line %i" % tb.tb_lineno
    print str(e)

Entornos

Información sobre licencias

  • ArcGIS Desktop Basic: Requiere Network Analyst
  • ArcGIS Desktop Standard: Requiere Network Analyst
  • ArcGIS Desktop Advanced: Requiere Network Analyst

Temas relacionados