Crear la capa de área de servicio (Network Analyst)

Resumen

Crea una capa de análisis de red de área de servicio y establece sus propiedades de análisis. Una capa de análisis del área de servicio es útil para determinar el área de accesibilidad dentro de un coste de valor límite dado desde la ubicación de una instalación.

Uso

Sintaxis

MakeServiceAreaLayer_na (in_network_dataset, out_network_analysis_layer, impedance_attribute, {travel_from_to}, {default_break_values}, {polygon_type}, {merge}, {nesting_type}, {line_type}, {overlap}, {split}, {excluded_source_name}, {accumulate_attribute_name}, {UTurn_policy}, {restriction_attribute_name}, {polygon_trim}, {poly_trim_value}, {lines_source_fields})
ParámetroExplicaciónTipo de datos
in_network_dataset

El dataset de red en el que se realizará el análisis del área de servicio.

Network Dataset Layer
out_network_analysis_layer

Nombre de la capa de análisis de red de área del servicio que se creará.

String
impedance_attribute

El atributo de coste que se usará como impedancia en el análisis.

String
travel_from_to
(Opcional)

Especifica la dirección de viaje hacia o desde las instalaciones.

  • TRAVEL_FROMEl área de servicio se crea en una dirección alejada de las instalaciones.
  • TRAVEL_TOEl área de servicio se crea en una dirección cercana a las instalaciones.

Utilizando esta opción se pueden encontrar distintas áreas de servicio en una red con restricciones unidireccionales e impedancias diferentes basadas en la dirección del viaje. El área de servicio de una tienda de entrega de pizzas, por ejemplo, se debe crear alejada de la instalación, mientras que el área de servicio de un hospital se debe crear cerca de la instalación.

String
default_break_values
(Opcional)

Los valores predeterminados de impedancia que indican la extensión del área de servicio que se calculará. El valor predeterminado se puede invalidar especificando el valor de los cortes en las instalaciones.

Se pueden establecer varios cortes de polígonos para crear áreas de servicio concéntricas. Por ejemplo, para encontrar áreas de servicio de 2, 3 y 5 minutos para la misma instalación, especifique "2 3 5" como el valor para el parámetro de valores de Corte predeterminado (los números 2, 3 y 5 deben estar separados por un espacio).

String
polygon_type
(Opcional)

Especifica el tipo de polígonos que se generarán.

  • SIMPLE_POLYSCrea polígonos generalizados que se generan rápidamente y son bastante exactos, excepto en los márgenes. Esta es la opción predeterminada.
  • DETAILED_POLYSCrea polígonos detallados, que modelan con exactitud las líneas del área de servicio y pueden contener islas de áreas no alcanzadas. Es una opción mucho más lenta que la generación de polígonos generalizados.
  • NO_POLYSDesactiva la generación de polígonos cuando se desea obtener sólo líneas de área de servicio.

Si sus datos corresponden a un área urbana con una red semejante a una cuadrícula, la diferencia entre los polígonos generalizados y detallados sería mínima. Sin embargo, para los caminos rurales y de montaña, los polígonos detallados pueden presentar resultados significativamente más precisos que los polígonos generalizados.

String
merge
(Opcional)

Especifica las opciones para fusionar polígonos que comparten valores de corte similares. Esta opción se puede aplicar sólo cuando se generan polígonos para varias instalaciones.

  • NO_MERGECrea polígonos individuales para cada instalación. Los polígonos se pueden superponer entre sí.
  • NO_OVERLAPCrea polígonos individuales que son más cercanos a cada instalación. Los polígonos no se superponen entre sí.
  • MERGE Une los polígonos de varias instalaciones que poseen los mismos valores de corte.
String
nesting_type
(Opcional)

Especifica la opción para crear polígonos de área de servicio concéntricos como discos o anillos. Esta opción se puede aplicar sólo cuando se especifican varios valores de corte para las instalaciones.

  • RINGSNo incluyen el área de los cortes más pequeños. Esto crea polígonos entre cortes consecutivos. Use esta opción si desea buscar el área desde un corte a otro.
  • DISKS Crea los polígonos que se encuentran desde la instalación hasta el corte. Por ejemplo, si crea áreas de servicio de 5 y 10 minutos, el polígono de área de servicio de 10 minutos incluirá el área bajo el polígono de área de servicio de 5 minutos. Use esta opción si desea buscar el área completa desde una instalación hasta el corte para cada corte.
String
line_type
(Opcional)

Especifica el tipo de líneas que se generarán basadas en el análisis del área de servicio. Si selecciona la opción TRUE_LINES o TRUE_LINES_WITH_MEASURES para áreas de servicio grandes, aumentará la cantidad de memoria consumida por el análisis.

  • NO_LINESNo generar líneas. Esta es la opción predeterminada.
  • TRUE_LINESLas líneas se generan sin mediciones.
  • TRUE_LINES_WITH_MEASURESLas líneas se generan con mediciones. Los valores de medición generados en base al valor de impedancia en cada extremo del borde con los vértices intermedios interpolados. No use esta opción si desea lograr un rendimiento más veloz.
String
overlap
(Opcional)

Determines if overlapping lines are generated when the service area lines are computed.

  • OVERLAP Incluye una entidad de línea separada para cada instalación cuando las instalaciones tienen líneas de área de servicio que coinciden.
  • NON_OVERLAP Incluye cada línea de área de servicio como máximo una vez y la asocia con su instalación más cercana (menor impedancia).
Boolean
split
(Opcional)
  • SPLITDivide cada línea entre dos cortes en dos líneas, cada una dentro de su corte. Esto es útil si desea simbolizar las líneas de área de servicio por corte. De lo contrario, use la opción NO_SPLIT para lograr un rendimiento óptimo.
  • NO_SPLITLas líneas no se dividen en los límites de los cortes. Esta es la opción predeterminada.
Boolean
excluded_source_name
[excluded_source_name,...]
(Opcional)

Especifica la lista de fuentes de red que se excluirán cuando se generen los polígonos. La geometría de los elementos atravesados de las fuentes excluidas se omitirá en todos los polígonos.

Esta opción es útil cuando no desea incluir algunas fuentes de red en la generación de polígonos porque crean polígonos menos exactos o porque son intrascendentes para el análisis del área de servicio. Por ejemplo, mientras crea un área de servicio de tiempo de viaje en una red de varios modelos de calles y carriles, debe elegir excluir las líneas de carriles de la generación de polígonos para poder modelar correctamente la ruta por la que puede viajar un vehículo.

La exclusión de una fuente de red de los polígonos de las áreas de servicio no evita que dichas fuentes se atraviesen. Excluir las fuentes de los polígonos de las áreas de servicio solo influye en la forma poligonal de las áreas de servicio. Si desea evitar atravesar una determinada fuente de red, debe crear una restricción adecuada al definir su dataset de red.

String
accumulate_attribute_name
[accumulate_attribute_name,...]
(Opcional)

Lista de los atributos de coste que se acumularán durante el análisis. Estos atributos de acumulación se usan específicamente de referencia; el solucionador utiliza los atributos de coste especificados por el parámetro de atributos Impedancia para calcular la ruta.

For each cost attribute that is accumulated, a Total_[Impedance] property is added to the routes that are output by the solver.

String
UTurn_policy
(Opcional)

Restrinja o permita giros en U en cruces que pudieran ocurrir durante el trazado poligonal de la red entre las paradas.

  • ALLOW_UTURNSSe permiten los giros en U en los cruces con cualquier cantidad de bordes adyacentes.
  • NO_UTURNSLos cambios de sentido están prohibidos en todas las confluencias. Tenga en cuenta, sin embargo, que los cambios de sentido seguirán estando permitidos en las ubicaciones de red incluso aunque haya elegido este valor; sin embargo, puede utilizar la propiedad CurbApproach de cada ubicación de red individual para prohibir los cambios de sentido en ella.
  • ALLOW_DEAD_ENDS_ONLYLos giros en U están prohibidos en todos los cruces, excepto los que tienen sólo un borde adyacente (una calle sin salida).
  • ALLOW_DEAD_ENDS_AND_INTERSECTIONS_ONLYLos giros en U están prohibidos en los cruces donde se encuentran dos bordes adyacentes pero están permitidos en las intersecciones (todo cruce con tres o más bordes adyacentes) o calles sin salida (cruces con un borde adyacente).
String
restriction_attribute_name
[restriction_attribute_name,...]
(Opcional)

Lista de atributos de restricción que se aplicarán durante el análisis.

String
polygon_trim
(Opcional)
  • TRIM_POLYSAcorta los polígonos que contienen los bordes en la periferia del área de servicio para que estén dentro de la distancia especificada de estos bordes exteriores. Esto es útil si la red es muy dispersa y usted no desea que el área de servicio cubra grandes áreas en las que no hay entidades.
  • NO_TRIM_POLYSNo acorta los polígonos.
Boolean
poly_trim_value
(Opcional)

Especifica la distancia dentro de la que se acortarán los polígonos del área de servicio. El parámetro incluye un valor y unidades para la distancia. El valor predeterminado es 100 metros.

Linear unit
lines_source_fields
(Opcional)
  • LINES_SOURCE_FIELDS Agrega los campos SourceID, SourceOID, FromPosition y ToPosition a las líneas de área de servicio para retener información sobre las entidades de origen subyacentes atravesadas durante el análisis. Esto puede ser útil para unir los resultados de las líneas del área de servicio con los datos de origen originales.
  • NO_LINES_SOURCE_FIELDSNo agrega los campos de fuente (SourceID, SourceOID, FromPosition y ToPosition) a las líneas del área de servicio.
Boolean

Ejemplo de código

Ejemplo 1 de MakeServiceAreaLayer (ventana de Python)

Ejecutar la herramienta utilizando sólo los parámetros requeridos

import arcpy
arcpy.env.workspace = "C:/ArcTutor/Network Analyst/Tutorial/SanFrancisco.gdb"
arcpy.MakeServiceAreaLayer_na("Transportation/Streets_ND","FireStationCoverage",
                              "Minutes")
Ejemplo 2 de MakeServiceAreaLayer (ventana de Python)

Ejecutar la herramienta utilizando todos los parámetros

import arcpy
arcpy.env.workspace = "C:/ArcTutor/Network Analyst/Tutorial/Paris.gdb"
arcpy.MakeServiceAreaLayer_na("Transportation/ParisNet","WarehouseCoverage",
                              "Drivetime","TRAVEL_FROM","5 10 15", 
                              "SIMPLE_POLYS", "NO_OVERLAP","RINGS","TRUE_LINES",
                              "NON_OVERLAP","NO_SPLIT",
                              ["Metro_Lines","Transfer_Stations",
                               "Transfer_Street_Station"],
                              ["Meters","Drivetime"],"ALLOW_DEAD_ENDS_ONLY",
                              ["Oneway"],"NO_TRIM_POLYS","",
                              "LINES_SOURCE_FIELDS")
Ejemplo 3 de MakeServiceAreaLayer (flujo de trabajo)

La siguiente secuencia de comandos de Python independiente muestra cómo se puede utilizar la herramienta MakeServiceAreaLayer para generar áreas de servicio de 1, 2 y 3 minutos alrededor de estaciones de bomberos.

# Name: MakeServiceAreaLayer_Workflow.py
# Description: Generate 1-,2-,3- minute service area around fire stations and 
#              save the results to a layer file on disk. The service area 
#              polygons can be used to visualize the areas that do not have 
#              adequate coverage from the fire stations 
# 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 = "C:/data/SanFrancisco.gdb"
    env.overwriteOutput = True
    
    #Set local variables
    inNetworkDataset = "Transportation/Streets_ND"
    outNALayer = "FireStationCoverage"
    impedanceAttribute = "TravelTime"
    inFacilities = "Analysis/FireStations"
    outLayerFile = "C:/data/output" + "/" + outNALayer + ".lyr"
    
    #Create a new service area layer. We wish to generate the service area 
    #polygons as rings, so that we can easily visualize the coverage for any 
    #given location. We also want overlapping polygons as we can determine the 
    #number of fire stations that cover a given location. We will specify these
    #options while creating the new service area layer.
    arcpy.MakeServiceAreaLayer_na(inNetworkDataset, outNALayer, 
                                  impedanceAttribute, "TRAVEL_FROM", "1 2 3", 
                                  "SIMPLE_POLYS", "NO_MERGE", "RINGS")
    
    #Load the fire stations as facilities using deafult field mappings and 
    #default search tolerance
    arcpy.AddLocations_na(outNALayer, "Facilities", inFacilities, "","")    
    
    #Solve the service area layer
    arcpy.Solve_na(outNALayer)
    
    #Save the solved service area layer as a layer file on disk with relative
    #paths
    arcpy.SaveToLayerFile_management(outNALayer,outLayerFile,"RELATIVE")
    
    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

Temas relacionados

Información de licencia

ArcView: Sí
ArcEditor: Sí
ArcInfo: Sí

7/11/2012