创建追踪图层 (Tracking Analyst)

摘要

此工具可根据包含时态数据的要素类或图层创建追踪图层。

用法

语法

MakeTrackingLayer_TA (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

如果您为数据选择了某个时区,则此参数可用于指定记录输入时间字段中的数据值时是否根据夏令时进行调整。

  • ADJUSTED_FOR_DST记录输入时间字段中的数据值时根据夏令时进行调整。
  • NOT_ADJUSTED_FOR_DST记录输入时间字段中的数据值时无需根据夏令时进行调整。
Boolean
storage_policy
(可选)

确定输出追踪图层的存储策略。

  • COPY_ALL_TO_MEMORY输出追踪图层将完全存储在内存中。
  • KEEP_ON_DISK输出追踪图层将采用基于磁盘的存储体系。仅在输入要素图层过大时,才使用此选项。
String
start_time_field

输入要素类或图层中含有日期和时间信息的字段。此工具要求日期和时间信息包含在同一字段中,并且字段的数据类型必须为 Short、Long、Float、Double、Text 或 Date。

Field
time_field_format
(可选)

如果时间字段的数据类型为除 Date 外的其他任何类型,则此参数可确定用于解释时间字段中数据值的格式。以下是一些格式的示例:

  • "yyyyMMdd"(适用于 Text 或数值时间字段的标准格式)
  • "yyyy/MM/dd HH:mm:ss"(适用于 Text 时间字段的标准格式)
  • "MM-dd-yyyy hh:mm:ss tt"(适用于 Text 时间字段的自定义格式)

如果时间字段的数据类型为 Text,那么既可以使用标准 ESRI 文本时间格式也可以指定自定义格式。但是,如果将存储策略指定为 KEEP_ON_DISK,则无法使用自定义格式。如果时间字段的数据类型为数值(Short、Long、Float 或 Double),那么只可以使用标准 ESRI 数值时间格式。如果时间字段的数据类型为 Date,则无需使用此参数。

String
locale_id
(可选)

如果时间字段的数据类型为 Text,则此参数可确定用于解释时间字段中数据值的区域设置。对于除 Text 外的所有时间字段数据类型,均无需使用此参数。如果未输入区域设置,则将使用操作系统当前的区域设置。打开该工具的对话框并展开该下拉列表便可获得系统支持的可用区域设置的列表。将区域设置作为参数输入时,建议您仅使用 Microsoft 指定的可按照长整型形式输入的区域设置 ID (LCID),例如 1033。也可将区域设置的完整字符串表达形式作为参数输入,例如 "01033-English_(United_States)",但必须用下划线字符代替空格。

Long; String
am_designator
(可选)

如果时间字段数据类型为 Text 并且时间格式为包含时间标记(“t”或“tt”)的 12 小时制表达形式,则此参数可确定用于指示时间字段数据值中 AM 的字符(“t”)或者字符(“tt”)。如果输入内容为空,则将使用所选区域设置的默认 AM 指示符。对于除 Text 外的所有时间字段数据类型,均无需使用此参数。

String
pm_designator
(可选)

如果时间字段数据类型为 Text 并且时间格式为包含时间标记(“t”或“tt”)的 12 小时制表达形式,则此参数可确定用于指示时间字段数据值中 PM 的字符(“t”)或者字符(“tt”)。如果输入内容为空,则将使用所选区域设置的默认 PM 指示符。对于除 Text 外的所有时间字段数据类型,均无需使用此参数。

String
track_id_field
(可选)

此字段中包含的数据值将用于将要素分组为输出追踪图层中的追踪。字段的数据类型可为 Short、Long、Float、Double、Text 或 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")

环境

相关主题

许可信息

ArcView: 需要 Tracking Analyst
ArcEditor: 需要 Tracking Analyst
ArcInfo: 需要 Tracking Analyst

7/10/2012