描述
此工具可根据包含时态数据的要素类或图层创建追踪图层。
使用方法
要使用此工具，输入要素类或图层的日期和时间信息必须包含在单个时间字段中（数据类型可为文本、短整型、长整型、浮点型、双精度型或日期）。如果时间字段数据类型为日期，则工具会自动检测格式。如果时间字段数据类型为除日期外的其他任何类型，则需要指定时间字段格式（如果时间字段数据类型为文本则可能还需要其他信息）才能正确分析数据值。
如果选择的时间字段为文本、短整型、长整型、浮点型或双精度型，可以从支持的时间字段格式列表中选择时间字段格式，也可以定义自定义时间字段格式来解释文本字段中的自定义日期和/或时间值。有关文本字段自定义格式的详细信息，请参阅将字符串时间值转换为日期格式。
如果可能，建议在此工具中使用数据类型为日期的时间字段。使用此工具前，可使用转换时间字段地理处理工具在输入要素类或图层中创建日期字段。
如果要素类或图层的日期和时间信息包含在两个单独的文本字段中，那么使用此工具之前，可使用串连日期和时间字段工具将这些信息合并为单个文本字段。
为输出追踪图层指定追踪标识符字段是可选操作。
此工具可用于为输出追踪图层指定存储策略。默认设置是将输出追踪图层存储在内存中，但是选择将输出追踪图层存储在磁盘中可以使您根据更大的数据集创建追踪图层。如果您选择将输出图层存储在磁盘中并且时间字段的数据类型为文本或数值，那么仅可使用支持的时间字段格式。
语法
arcpy.ta.MakeTrackingLayer(in_features, out_layer, time_zone, adjusted_for_dst, storage_policy, start_time_field, {time_field_format}, {locale_id}, {am_designator}, {pm_designator}, {track_id_field})| 参数 | 说明 | 数据类型 |
in_features | 输入要素类或图层。 | Feature Layer |
out_layer | 要创建的追踪图层的名称。新建的追踪图层可用作任何可接受要素图层作为输入的地理处理工具的输入。 | Feature Layer |
time_zone | 记录输入要素类中数据的时区。打开该工具的对话框并展开下拉列表，便可获得系统支持的可用时区的列表。将时区作为参数输入时，您必须使用正确的 Microsoft 时区 ID 的非本地化字符串表达形式，并且用下划线字符代替空格。例如，美国太平洋时区的正确字符串表达形式为“Pacific_Standard_Time”。可使用“NO_TIME_ZONE”将输出追踪图层的时区指定为“无时区”。 | String |
adjusted_for_dst | 如果您为数据选择了某个时区，则此参数可用于指定记录输入时间字段中的数据值时是否根据夏令时进行调整。
| Boolean |
storage_policy | 确定输出追踪图层的存储策略。
| String |
start_time_field | 输入要素类或图层中含有日期和时间信息的字段。此工具要求日期和时间信息包含在同一字段中，并且字段的数据类型必须为短整型、长整型、浮点型、双精度型、文本型或日期型。 | Field |
time_field_format （可选） | 如果时间字段的数据类型为除日期型外的其他任何类型，则此参数可确定用于解释时间字段中数据值的格式。以下是一些格式的示例：
如果时间字段的数据类型为文本类型，那么既可以使用标准 Esri 文本时间格式也可以指定自定义格式。但是，如果将存储策略指定为 KEEP_ON_DISK，则无法使用自定义格式。如果时间字段的数据类型为数值（短整型、长整型、浮点型或双精度型），那么只可以使用标准 Esri 数值时间格式。如果时间字段的数据类型为日期型，则无需使用此参数。 | String |
locale_id （可选） | 如果时间字段的数据类型为文本型，则此参数可确定用于解释时间字段中数据值的区域设置。对于除文本型外的所有时间字段数据类型，均无需使用此参数。如果未输入区域设置，则将使用操作系统当前的区域设置。打开该工具的对话框并展开该下拉列表便可获得系统支持的可用区域设置的列表。将区域设置作为参数输入时，建议您仅使用 Microsoft 指定的可按照长整型形式输入的区域设置 ID (LCID)，例如 1033。也可将区域设置的完整字符串表达形式作为参数输入，例如 "01033-English_(United_States)"，但必须用下划线字符代替空格。 | Long |
am_designator （可选） | 如果时间字段数据类型为文本型并且时间格式为包含时间标记（“t”或“tt”）的 12 小时制表达形式，则此参数可确定用于指示时间字段数据值中 AM 的字符（“t”）或者字符（“tt”）。如果输入内容为空，则将使用所选区域设置的默认 AM 指示符。对于除文本型外的所有时间字段数据类型，均无需使用此参数。 | String |
pm_designator （可选） | 如果时间字段数据类型为文本型并且时间格式为包含时间标记（“t”或“tt”）的 12 小时制表达形式，则此参数可确定用于指示时间字段数据值中 PM 的字符（“t”）或者字符（“tt”）。如果输入内容为空，则将使用所选区域设置的默认 PM 指示符。对于除文本型外的所有时间字段数据类型，均无需使用此参数。 | String |
track_id_field （可选） | 此字段中包含的数据值将用于将要素分组为输出追踪图层中的追踪。字段的数据类型可为短整型、长整型、浮点型、双精度型、文本型或 OID。 | Field |
代码示例
使用时间值存储于日期字段中的要素类的 MakeTrackingLayer 示例
此实例演示了如何对时间字段字段类型为日期的要素类运行此工具。此实例使用了 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")
使用时间值为标准文本格式的 shapefile 的 MakeTrackingLayer 示例
此示例演示了如何对时间字段为包含标准 Esri 格式数据的文本的 shapefile 运行此工具。
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")
使用时间值存储为自定义文本格式的 shapefile 的 MakeTrackingLayer 示例
此实例演示了如何对时间字段为包含自定义格式数据的文本的 shapefile 运行此工具。此示例也为输出追踪图层指定了“追踪 ID”字段。
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" )
使用时间值为标准数值格式的 shapefile 的 MakeTrackingLayer 示例
此示例演示了如何对时间字段为包含标准 Esri 格式数据的数值类型的 shapefile 运行此工具。
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")
环境
许可信息
- Basic: 需要 Tracking Analyst
- Standard: 需要 Tracking Analyst
- Advanced: 需要 Tracking Analyst