Crear capa Tracking (Tracking Analyst)
Resumen
Esta herramienta crea una capa de rastreo desde una capa o clase de entidad que contiene datos temporales.
Uso
-
Para que esta herramienta funcione, la capa o clase de entidad de entrada debe tener información de fecha y hora incluida en un campo de hora único del tipo de datos texto, corto, largo, flotante, doble o fecha. Si el tipo de datos del campo de hora es fecha, la herramienta detectará automáticamente el formato. Si el tipo de datos del campo de hora es cualquier otro que no sea fecha, se requerirá un formato de campo de hora (y posiblemente otro tipo de información para el tipo de datos del campo de hora texto) para analizar los valores de los datos correctamente.
Si el campo de hora seleccionado es texto, corto, largo, flotante o doble, el formato del campo de hora se puede seleccionar en una lista de formatos del campo de hora admitidos, o puede definir un formato del campo de hora personalizado para interpretar los valores de fecha u hora personalizados en un campo de texto. Para obtener más información acerca de los formatos personalizados para los campos de texto, consulte convertir valores de hora de cadena de texto en formato de fecha.
De ser posible, se recomienda utilizar un campo de hora de tipo de datos fecha con esta herramienta. La herramienta de geoprocesamiento Convertir campo de tiempo se puede utilizar para crear un campo de fecha en la capa o clase de entidad de entrada antes de utilizar esta herramienta.
Si la capa o clase de entidad contiene información de fecha y hora en dos campos de texto separados, se puede utilizar la herramienta Concatenar la fecha y la hora en los campos para combinar la información en un campo de texto único antes de utilizar esta herramienta.
-
Opcionalmente, se puede especificar un campo de identificación de recorrido para la capa de rastreo de salida.
-
Esta herramienta permite especificar una política de almacenamiento para la capa de rastreo de salida. La configuración predeterminada es almacenar la capa de rastreo de salida en la memoria, pero si elige la opción para almacenar la capa de rastreo de salida en el disco podrá crear capas de rastreo a partir de conjuntos de datos más grandes. Si elige almacenar la capa de salida en el disco y el campo de hora es un tipo de datos de texto o numérico, sólo se pueden utilizar los formatos de campo de hora admitidos.
Sintaxis
| Parámetro | Explicación | Tipo de datos |
in_features |
La capa o clase de entidad de entrada. | Feature Layer |
out_layer |
El nombre de la capa de rastreo que se va a crear. La capa de rastreo recientemente creada se puede utilizar como entrada para cualquier herramienta de geoprocesamiento que acepte una capa de entidad como entrada. | Feature Layer |
time_zone | La zona horaria en la que se registraron los datos de la clase de entidad de entrada. Para obtener una lista de las zonas horarias que se admiten en el sistema, puede abrir el cuadro de diálogo de la herramienta y expandir esta lista desplegable. Cuando introduce la zona horaria como parámetro, debe utilizar una representación de cadena de caracteres no localizada de la Id. de zona horaria de Microsoft y reemplazar cualquier espacio con guiones bajos. Por ejemplo, la representación de cadena de caracteres adecuada para la zona horaria del Pacífico en los Estos Unidos es "Pacific_Standard_Time". Puede utilizar "NO_TIME_ZONE" para no especificar la zona horaria para la capa de rastreo de salida. | String |
adjusted_for_dst | Si elige una zona horaria para los datos, este parámetro especifica si los valores de datos en el campo de tiempo de entrada se registraron con una adecuación para Horario de verano.
| Boolean |
storage_policy (Opcional) | Determina la política de almacenamiento para la capa de rastreo de salida.
| String |
start_time_field |
El campo en la capa o clase de entidad de entrada que contiene información de fecha y hora. Esta herramienta requiere que la información de fecha y hora estén en el mismo campo, y el tipo de datos del campo debe ser Corto, Largo, Flotante, Doble, Texto o Fecha. | Field |
time_field_format (Opcional) | Si el tipo de datos del campo de tiempo es distinto de Fecha, este parámetro determina el formato que se utilizará para interpretar los valores de datos en el campo de tiempo. Algunos ejemplos de formatos:
Si el tipo de datos del campo de hora es Texto, se puede utilizar un formato de hora de texto estándar de Esri o se puede especificar un formato personalizado. Sin embargo, los formatos personalizados no se pueden utilizar si especificó KEEP_ON_DISK para la política de almacenamiento. Si el tipo de datos del campo de hora es numérico (Corto, Largo, Flotante o Doble), sólo se puede utilizar los formatos de hora numéricos estándar de Esri. Si el tipo de datos del campo de tiempo es Fecha, este parámetro no es necesario. | String |
locale_id (Opcional) | Si el tipo de datos del campo de tiempo es Texto, este parámetro determina la configuración regional que se utilizará para interpretar los valores de datos en el campo de tiempo. Para todos los tipos de datos de campos de tiempo distintos de Texto, este parámetro no es necesario. Si no se introduce ninguna configuración regional, se utilizará la configuración regional actual del sistema operativo. Para obtener una lista de las configuraciones regionales compatibles con el sistema, abra el cuadro de diálogo de la herramienta y expanda esta lista desplegable. Cuando se introduce la configuración regional como parámetro, se recomienda utilizar sólo el Id. de configuración regional (LCID) asignado por Microsoft, que se puede introducir como un entero largo, como por ejemplo 1033. También puede introducir la representación de cadena de caracteres completa de la configuración regional como parámetro, como por ejemplo "01033-English_(United_States)", pero debe reemplazar los espacios por guiones bajos. | Long; String |
am_designator (Opcional) |
Si el tipo de datos del campo de hora es Texto y el formato de hora es una representación de reloj de 12 horas que incluye un marcador de hora ("t" o "tt"), este parámetro determina el carácter ("t") o los caracteres ("tt") que designan AM en los valores de datos del campo de hora. Si no se introduce nada, se utilizará la designación de AM predeterminada para la configuración regional seleccionada. Para todos los tipos de datos de campos de tiempo distintos de Texto, este parámetro no es necesario. | String |
pm_designator (Opcional) |
Si el tipo de datos del campo de hora es Texto y el formato de hora es una representación de reloj de 12 horas que incluye un marcador de hora ("t" o "tt"), este parámetro determinará el carácter ("t") o los caracteres ("tt") que designan PM en los valores de datos del campo de hora. Si no se introduce nada, se utilizará la designación de PM predeterminada para la configuración regional seleccionada. Para todos los tipos de datos de campos de tiempo distintos de Texto, este parámetro no es necesario. | String |
track_id_field (Opcional) |
El campo que contiene los valores de datos que se utilizarán para agrupar entidades en los recorridos de la capa de rastreo de salida. El tipo de datos del campo puede ser Corto, Largo, Flotante, Doble, Texto u OID. | Field |
Ejemplo de código
Este ejemplo muestra cómo ejecutar la herramienta en la clase de entidad cuyo campo de hora es de fecha del tipo de campo. Este ejemplo utiliza los datos tutoriales de Tracking Analyst.
import arcpy arcpy.CheckOutExtension("tracking") inputGDB = "C:/arcgis/ArcTutor/Tracking Analyst/Simple/Hurricanes.gdb/atlantic_hurricanes_2000" timezone = "Eastern_Standard_Time" arcpy.MakeTrackingLayer_ta( inputGDB, "Hurricanes", timezone, "ADJUSTED_FOR_DST", "COPY_ALL_TO_MEMORY", "Date_Time") Este ejemplo muestra cómo ejecutar la herramienta en un shapefile cuyo campo de hora es de tipo texto y contiene datos en el formato estándar de Esri.
import arcpy arcpy.CheckOutExtension("tracking") inputShapefile = "C:/vehicles/trains.shp" timezone = "Central_Standard_Time" arcpy.MakeTrackingLayer_ta( inputShapefile, "trains_layer", timezone, "ADJUSTED_FOR_DST", "COPY_ALL_TO_MEMORY", "text_date", "yyyy-MM-dd HH:mm:ss")Este ejemplo muestra cómo ejecutar la herramienta en un shapefile cuyo campo de hora es de tipo texto y contiene datos en un formato personalizado. Este ejemplo también especifica un Campo de Id. de recorrido para la capa de rastreo de salida.
import arcpy arcpy.CheckOutExtension("tracking") inputShapefile = "C:/vehicles/planes.shp" timezone = "Central_Standard_Time" arcpy.MakeTrackingLayer_ta( inputShapefile, "planes_layer", timezone, "ADJUSTED_FOR_DST", "COPY_ALL_TO_MEMORY", "cust_date", "MM/dd/yyyy HH:mm:ss", 1033,"AM", "PM", "EVENTID" ) Este ejemplo muestra cómo ejecutar la herramienta en un shapefile cuyo campo de hora es de tipo numérico y contiene datos en el formato estándar de Esri.
import arcpy arcpy.CheckOutExtension("tracking") inputShapefile = "C:/vehicles/trains.shp" timezone = "Central_Standard_Time" arcpy.MakeTrackingLayer_ta( inputShapefile, "trains_layer", timezone, "ADJUSTED_FOR_DST", "COPY_ALL_TO_MEMORY", "num_date", "yyyyMMdd")