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(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ámetro | Explicación | Tipo 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. Cuando se especifican los incidentes, se pueden definir propiedades para cada uno de ellos, como su nombre o el tiempo de 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: el 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 el campo IncidentID) y puede ayudar a unir información adicional de las rutas de salida, como el tiempo de viaje total o la distancia total, con los atributos de sus 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 agrega 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 las estaciones de bomberos más cercanas a incidentes de incendios para estimar tiempos de respuesta, el atributo AdditionalTime puede almacenar la cantidad de tiempo que tardan los bomberos en equiparse en la ubicación del incidente antes de que comiencen a extinguir el incendio. AdditionalDistance: distancia adicional de viaje en el incidente, que se agrega 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 ubicación de un incidente como, por ejemplo, una casa, 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):
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, contemple 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. Cuando se especifican las instalaciones, se pueden definir propiedades para cada una de ellas, como su nombre o el tiempo de servicio, mediante el uso de atributos. Las instalaciones se pueden especificar con los siguientes atributos: Name: el 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 las instalaciones de salida más cercanas como campos FacilityID. El campo FacilityID se puede usar para unir información adicional de las rutas de salida, como el tiempo de viaje total o la distancia total, con los atributos de sus 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 agrega 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 las estaciones de bomberos más cercanas a incidentes de incendios, AdditionalTime puede almacenar el tiempo que suele tardar un equipo en ponerse el equipo de protección adecuado y salir de la estación de bomberos. AdditionalDistance: distancia adicional de viaje en la instalación, que se agrega 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. En general, la ubicación de una instalación, como una estación de bomberos, no se encuentra exactamente en una 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, en caso de que sea importante incluir dicha distancia en la distancia de viaje total. CurbApproach: especifica la dirección por la que un vehículo puede llegar a una instalación y partir 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):
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 y reportar el tiempo o la distancia total de viaje de las rutas de salida. La herramienta encuentra la instalación más cercana midiendo el tiempo o la distancia de viaje a lo largo de las calles. Las unidades que seleccione para este parámetro determinan si la herramienta medirá la distancia de conducción o el tiempo de recorrido para encontrar lo que esté más cerca. 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:
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 Resultados 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 Resultados 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 Resultados de Buscar instalaciones más cercanas describe el esquema de esta clase de entidad de salida. | String |
Number_of_Facilities_to_Find (Opcional) | Especifique el número de instalaciones más cercanas 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) | Especifique el valor del tiempo de viaje o la distancia de viaje en el que se debe detener la búsqueda de instalaciones desde un incidente determinado. Por ejemplo, al buscar los hospitales más cercanos al lugar de un accidente, un valor límite 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 cercano está a 17 minutos, no se devolverá ninguna ruta en las rutas de salida. Un valor de tolerancia es especialmente útil al buscar varias instalaciones. Las unidades para este parámetro se especifican por el parámetro Unidades de medida. | Double |
Travel_Direction (Opcional) | Especifique si desea buscar la instalación más cercana midiendo desde el incidente hasta la instalación o desde la instalación hasta el incidente.
Si usa uno de los valores del parámetro, es posible encontrar distintas instalaciones, ya que el tiempo de viaje a lo largo de ciertas calles puede variar según la dirección del viaje y restricciones de sentidos únicos. 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, es posible que el tráfico haga que las opciones Instalación hacia incidente e Incidente hacia instalación devuelvan distintos resultados. | String |
Time_of_Day (Opcional) | Especifica la hora y la fecha en la cual deben comenzar y terminar las rutas. El valor se usa como el tiempo de inicio o finalización de la ruta en función del valor del parámetro Uso de 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 que se encuentra la instalación o incidente. Independientemente de la configuración de Zona horaria para hora del día, si sus instalaciones e incidentes se encuentran en varias zonas horarias, la herramienta aplica las siguientes reglas:
| 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.
| String |
Time_Zone_for_Time_of_Day (Opcional) | Especifica la zona horaria del parámetro Hora del día.
Independientemente de la configuración de Zona horaria para hora del día, si sus instalaciones e incidentes se encuentran en varias zonas horarias, la herramienta aplica las siguientes reglas:
| 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.
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. Shape: Campo de geometría que indica la ubicación geográfica del objeto de análisis de red. Name: 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:
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. Shape: Campo de geometría que indica la ubicación geográfica del objeto de análisis de red. Name: 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. Shape: Campo de geometría que indica la ubicación geográfica del objeto de análisis de red. Name: 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:
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.
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 un campo Total_[atributo] 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:
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íneas de ruta. Sea cual sea el valor elegido para el parámetro Forma de la 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.
| 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) | Especifique 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.
| String |
Directions_Style_Name (Opcional) | Especifique el nombre del estilo de formato de 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:
| 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) |
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) | Seleccione el modo de transporte para el análisis. CUSTOM siempre es 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 de modo de viaje configurados 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:
| 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.
| Boolean |
Salida derivada
| Nombre | Explicación | Tipo de datos |
| Output_Routes | La ruta o rutas resultantes entre las instalaciones y los incidentes. | Conjunto de entidades |
| Output_Directions | Indicaciones de conducción giro a giro para cada ruta resultante entre las instalaciones y los incidentes. | Conjunto de entidades |
| Solve_Succeeded | Indica si la solución del análisis de ubicación de instalaciones más cercanas se realizó correctamente. | Booleano |
| Output_Closest_Facilities | Las instalaciones más cercanas a los incidentes. | Conjunto de entidades |
| Output_Network_Analysis_layer | Capa de análisis de red con propiedades según se configuraron en los parámetros de la herramienta, que se puede utilizar para análisis posteriores o para depurar el mapa. | Archivo |
| Output_Route_Data | Archivo comprimido que contiene toda la información de una ruta concreta. | Archivo |
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 (script independiente)
En el script independiente de Python siguiente se muestra cómo puede determinar FindClosestFacilities las tiendas más próximas a un almacén. El script 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
- Basic: Requiere Network Analyst
- Standard: Requiere Network Analyst
- Advanced: Requiere Network Analyst