| 标注 | 说明 | 数据类型 |
输入电话记录表 | 输入表，其中包含无线网络提供商提供的呼叫记录或电话数据事件记录。 | Table View |
输入蜂窝基站点 | 要素类，其中包含蜂窝基站记录转要素类工具生成的蜂窝基站点。 | Feature Layer |
输入蜂窝基站扇区 | 要素类，其中包含蜂窝基站记录转要素类工具生成的蜂窝基站扇区。 | Feature Layer |
输出电话记录基站点 | 包含电话记录基站点的点要素类。 将为链接到蜂窝基站点的每条电话记录生成一个点。 | Feature Class |
输出电话记录扇区 | 包含电话记录扇区的面要素类。 将为链接到蜂窝基站扇区的每条电话记录生成一个扇区面。 | Feature Class |
蜂窝扇区 ID 字段 | 指定唯一 ID 字段类型以及将添加到输出要素的字段。 当输入电话记录表参数值具有所有蜂窝扇区天线的唯一标识符时，使用唯一 ID类型。 当输入电话记录表参数值不包含所有蜂窝扇区天线的通用唯一标识符时，请结合使用其他 ID 类型值。
ID 类型选项如下：
| Value Table |
订阅者 ID 字段 | 输入表中的字段，该输入表包含订阅者的电话号码或标识符。 | Field |
目标电话号码字段 (可选) | 输入表中的字段，该输入表包含被呼叫者的电话号码或标识符。 | Field |
附加蜂窝扇区 ID 字段 (可选) |
指定附加唯一 ID 字段类型以及将添加到输出要素的字段。 当输入电话记录表参数值具有所有蜂窝扇区天线的唯一标识符时，使用唯一 ID类型。 当输入电话记录表参数值不包含所有蜂窝扇区天线的通用唯一标识符时，请结合使用其他 ID 类型值。
ID 类型选项如下：
| Value Table |
起始日期和时间字段 (可选) | 输入表中的字段，该输入表包含电话呼叫或数据事件的起始日期和时间字段。 | Field |
时长字段 (可选) | 输入表中的字段，该输入表包含电话通话时长，以秒为单位。 | Field |
结束日期和时间字段 (可选) | 输入表中的字段，该输入表包含电话呼叫或数据事件的结束日期和时间字段。 | Field |
将 UTC 日期转换为本地时区 (可选) | 指定将输入记录的起始及结束日期和时间转换为本地系统的时区，还是保留为协调世界时间 (UTC)。
| Boolean |
估计电话位置 X 字段 (可选) | 输入表中的字段，该输入表包含无线网络提供商提供的估计电话位置的 x 坐标。 | Field |
估计电话位置 Y 字段 (可选) | 输入表中的字段，该输入表包含无线网络提供商提供的估计电话位置的 y 坐标。 | Field |
估计电话位置坐标系 (可选) | x,y 坐标的估计电话位置坐标系。 默认坐标系为 WGS84。 | Coordinate System |
输出估计呼叫点 (可选) | 点要素类，其中包含无线网络提供商提供的估计呼叫位置。 | Feature Class |
起始定时提前量距离字段 (可选) | 输入表中包含呼叫开始时的定时提前量距离的字段。 | Field |
结束定时提前量距离字段 (可选) | 输入表中包含呼叫结束时的定时提前量距离的字段。 | Field |
定时提前量距离单位 (可选) | 指定将用于起始定时提前量距离字段和结束定时提前量距离字段参数值的线性测量单位。
| String |
定时提前量频段总宽度 (可选) | 定时提前量频段的全宽。 默认值为 78.07 米。 | Linear Unit |
输出定时提前量频段 (可选) | 将包含无线网络提供商提供的定时提前量频段的面要素类。 | Feature Class |
摘要
用于从无线网络提供商处导入手机记录，并将这些记录与蜂窝基站记录转要素类工具根据标识符字段生成的蜂窝基站和扇区要素类相关联。
使用情况
必须使用蜂窝基站记录转要素类工具生成输入蜂窝基站点参数值。
输出手机记录基站点和输出手机记录扇区参数将仅包含根据匹配的 ID 字段成功链接到输入蜂窝基站和扇区的手机记录。 输出电话记录基站点和输出电话记录扇区参数值不表示手机的实际位置。
无线网络提供商将以各种格式和样式提供手机记录或呼叫详细信息记录 (CDR)。 通常以非表格格式或方案接收数据。 输入电话记录表参数值必须为在顶部具有列名称的表。
无线网络提供商提供的表可能在一行中包含 CDR 和蜂窝基站信息。 以这种方式构造表时，必须将其分为两个表。 可以使用包含呼叫信息（标识符、电话号码、日期、时间、通话时长和坐标）的表作为此工具的输入。
将在输出要素类中为输入电话记录表参数的每个记录（呼叫或数据事件）创建一个要素。
以下字段将添加到输出要素类中：
- SUBSCRIBER- 输入电话记录表参数值的订阅者电话号码。 将从输出中移除所有非数值字符。
- UNIQUEID- 蜂窝扇区天线的唯一标识符。
如果使用指定参数，则以下字段将添加到输出中：
- DESTPHONE- 输入电话记录表参数值的被呼叫者电话号码。 如果使用目标电话号码字段参数，则其将添加到输出中。 将从输出中移除所有非数值字符。
- STARTTIME- 输入电话记录表参数值的起始日期和时间字段。 如果使用起始日期和时间字段参数，则其将添加到输出中。
- DURATION- 输入电话记录表参数值的电话通话时长，以秒为单位。 格式为 HH:MM:SS 的时长值将转换为总秒数。 如果使用时长字段参数，或者同时使用起始日期和时间字段和结束日期和时间字段参数，则其将添加到输出中。
- ENDTIME- 输入电话记录表参数值的结束日期和时间字段。 如果使用结束日期和时间字段参数，或者同时使用起始日期和时间字段和时长参数，则其将添加到输出中。
无线网络提供商提供的表格中可能包含蜂窝基站信息表，其中将使用唯一 ID 字段定义所有唯一记录，或使用标识符字段组合定义表中的唯一记录。例如，表中可能包含站点标识符和扇区标识符字段，以唯一定义一些记录，但是表中的其他记录将通过位置区号标识符和蜂窝标识符字段来唯一定义。
- 当为输入表提供唯一 ID 字段时，需要将蜂窝扇区 ID 字段或附加蜂窝扇区 ID 字段参数中的 ID 类型选项设置为唯一 ID。在同一参数中填充表示唯一 ID 的字段选项。
- 当为表提供多个 ID 字段以指示唯一性时，必须将所有 ID 字段均添加到输出中。对于每个 ID 字段，选择用于定义蜂窝扇区 ID 字段或附加蜂窝扇区 ID 字段参数中的 ID 类型的 ID 类型值。在同一参数中填充其中包含 ID 信息相关字段的字段选项。该工具将组合这些 ID 字段，并在名为 UNIQUEID 的输出要素类中填充单个唯一 ID 字段。
如果在蜂窝扇区 ID 字段或附加蜂窝扇区 ID 字段参数中指定了以下字段，则会将其添加到输出中：
- SITEID - 蜂窝基站唯一标识符
- SECTORID - 蜂窝扇区唯一标识符
- SWITCHID - 无线网络交换机唯一标识符
- LACID - 位置区号唯一标识符
- CASCADEID - 无线网络 Cascade 中扇区的唯一标识符
- CELLID - 位置区号中扇区的唯一标识符
如果输入电话记录表包含跨多个蜂窝扇区的呼叫记录，则必须填充蜂窝扇区 ID 字段和附加蜂窝扇区 ID 字段参数。 蜂窝扇区 ID 字段参数必须包含与起始扇区相关联的标识符，并且附加扇区 ID 字段参数必须包含结束扇区或者呼叫记录中起始扇区以外的任何扇区。
如果输入电话记录表包含数据事件记录或者呼叫记录中仅引用一个扇区，则必须仅填充蜂窝扇区 ID 字段参数。
如果填充附加蜂窝扇区 ID 字段参数，则将生成以下字段和值：
- IDTYPE- 标识呼叫记录是呼叫记录的主要扇区还是附加扇区的字段。
- PRIMARY - 在开始呼叫时，将手机记录链接到扇区时分配的值。
- ADDITIONAL - 如果扇区与呼叫开始时的扇区不同，则将手机记录链接到通话结束时的扇区或者链接到通话时长内的任何扇区时分配的值。
- LOCTIME- 根据 IDTYPE 字段是 PRIMARY 还是 ADDITIONAL 包含呼叫记录的唯一日期和时间值的字段。 当 IDTYPE 字段值为 PRIMARY 时，STARTTIME 字段的值将分配到 LOCTIME 字段。 当 IDTYPE 字段值为 ADDITIONAL 时，ENDTIME 字段的值将分配到 LOCTIME 字段。 LOCTIME 字段支持通过呼叫的唯一日期时间值和估计位置来可视化要素。
如果手机记录已链接到通话开始和结束时的相同扇区，则不会为表示通话结束的蜂窝扇区创建单独的要素。
- IDTYPE- 标识呼叫记录是呼叫记录的主要扇区还是附加扇区的字段。
输出估计呼叫点将包含输出电话记录基站点和输出电话记录基站扇区参数值的所有相关字段。
以下字段将添加到输出估计呼叫点参数值：
- PHONEX- 无线网络提供商提供的呼叫位置的估计 x 坐标
- PHONEY- 无线网络提供商提供的呼叫位置的估计 y 坐标
如果 SUBSCRIBER 字段记录为空，则其将被忽略并且将不会导入到输出要素类中。
如果 STARTTIME 和 DURATION 字段具有值，而 ENDTIME 字段没有值，则该工具将在输出要素类中生成 ENDTIME 值。
如果 STARTTIME 和 ENDTIME 字段具有值，而 DURATION 字段没有值，则该工具将在输出要素类中生成 DURATION 值。
定时提前量频段输出选项参数（开始定时提前量距离字段、结束定时提前量距离字段、定时提前量距离单位、定时提前量频段总宽度和输出定时提前量频段）为可选项，而不是将呼叫详细信息记录与蜂窝塔和扇区位置相关联所必需的。
一些手机记录包含定时提前量数据，这些数据可用于标识在呼叫时手机与蜂窝塔的距离。 如果记录中存在定时提前量数据，则此工具可以创建一个面要素类，其中包含一个频段，该频段表示沿着发生呼叫的扇区的波束宽度弧线，电话与蜂窝基站的距离。
输出定时提前量频段将包含输出电话记录基站点和输出电话记录基站扇区参数值的所有关联字段。
以下字段将添加到输出定时提前量频段参数中：
- TASTART- 无线网络提供商提供的呼叫开始时的定时提前量距离。 如果指定起始定时提前量距离字段参数，则此字段将添加到输出中。
- TAEND- 无线网络提供商提供的呼叫结束时的定时提前量距离。 如果指定结束定时提前量距离字段参数，则此字段将添加到输出中。
- TATYPE- 字段，用于标识定时提前量波段是位于距蜂窝基站的开始定时距离处，还是位于距蜂窝基站的结束定时距离处。 如果指定起始定时提前量距离字段和结束时间距离字段参数，则此字段将添加到输出中。
- START- 当频段位于起始定时距离时分配的值
- END- 当频段位于结束定时距离时分配的值
参数
arcpy.ca.CellPhoneRecordsToFeatureClass(in_table, in_site_features, in_sector_features, out_site_feature_class, out_sector_feature_class, id_fields, subscriber_field, {destination_field}, {additional_id_fields}, {start_time_field}, {duration_field}, {end_time_field}, {convert_utc}, {location_x_field}, {location_y_field}, {location_coordinate_system}, {out_call_points}, {start_timing_distance_field}, {end_timing_distance_field}, {timing_advance_unit}, {timing_band_width}, {out_timing_advance_bands})| 名称 | 说明 | 数据类型 |
in_table | 输入表，其中包含无线网络提供商提供的呼叫记录或电话数据事件记录。 | Table View |
in_site_features | 要素类，其中包含蜂窝基站记录转要素类工具生成的蜂窝基站点。 | Feature Layer |
in_sector_features | 要素类，其中包含蜂窝基站记录转要素类工具生成的蜂窝基站扇区。 | Feature Layer |
out_site_feature_class | 包含电话记录基站点的点要素类。 将为链接到蜂窝基站点的每条电话记录生成一个点。 | Feature Class |
out_sector_feature_class | 包含电话记录扇区的面要素类。 将为链接到蜂窝基站扇区的每条电话记录生成一个扇区面。 | Feature Class |
id_fields [id_fields,...] | 指定唯一 ID 字段类型以及将添加到输出要素的字段。 当输入电话记录表参数值具有所有蜂窝扇区天线的唯一标识符时，使用唯一 ID类型。 当输入电话记录表参数值不包含所有蜂窝扇区天线的通用唯一标识符时，请结合使用其他 ID 类型值。
ID 类型选项如下：
| Value Table |
subscriber_field | 输入表中的字段，该输入表包含订阅者的电话号码或标识符。 | Field |
destination_field (可选) | 输入表中的字段，该输入表包含被呼叫者的电话号码或标识符。 | Field |
additional_id_fields [additional_id_fields,...] (可选) |
指定附加唯一 ID 字段类型以及将添加到输出要素的字段。 当输入电话记录表参数值具有所有蜂窝扇区天线的唯一标识符时，使用唯一 ID类型。 当输入电话记录表参数值不包含所有蜂窝扇区天线的通用唯一标识符时，请结合使用其他 ID 类型值。
ID 类型选项如下：
| Value Table |
start_time_field (可选) | 输入表中的字段，该输入表包含电话呼叫或数据事件的起始日期和时间字段。 | Field |
duration_field (可选) | 输入表中的字段，该输入表包含电话通话时长，以秒为单位。 | Field |
end_time_field (可选) | 输入表中的字段，该输入表包含电话呼叫或数据事件的结束日期和时间字段。 | Field |
convert_utc (可选) | 指定将输入记录的起始及结束日期和时间转换为本地系统的时区，还是保留为协调世界时间 (UTC)。
| Boolean |
location_x_field (可选) | 输入表中的字段，该输入表包含无线网络提供商提供的估计电话位置的 x 坐标。 | Field |
location_y_field (可选) | 输入表中的字段，该输入表包含无线网络提供商提供的估计电话位置的 y 坐标。 | Field |
location_coordinate_system (可选) | x,y 坐标的估计电话位置坐标系。 默认坐标系为 WGS84。 | Coordinate System |
out_call_points (可选) | 点要素类，其中包含无线网络提供商提供的估计呼叫位置。 | Feature Class |
start_timing_distance_field (可选) | 输入表中包含呼叫开始时的定时提前量距离的字段。 | Field |
end_timing_distance_field (可选) | 输入表中包含呼叫结束时的定时提前量距离的字段。 | Field |
timing_advance_unit (可选) | 指定将用于 start_timing_distance_field 和结束定时提前量距离字段参数值的线性测量单位。
| String |
timing_band_width (可选) | 定时提前量频段的全宽。 默认值为 78.07 米。 | Linear Unit |
out_timing_advance_bands (可选) | 将包含无线网络提供商提供的定时提前量频段的面要素类。 | Feature Class |
代码示例
以下 Python 窗口脚本演示了如何在即时模式下使用 CellPhoneRecordsToFeatureClass 函数：
import arcpy
arcpy.env.workspace = r"C:/data/city_pd.gdb"
arcpy.ca.CellPhoneRecordsToFeatureClass("CDR_Phone_1",
"Phone_1_Sites",
"Phone_1_Sectors",
"CDR_Phone_1_Sites_out",
"CDR_Phone_1_Sectors_out",
"SWITCH_ID BEGSWITCH;SITE_ID BEGSITE;SECTOR_ID BEGSECTOR",
"SUBSCRIBERID")下面的独立脚本演示了如何在脚本中使用 CellPhoneRecordsToFeatureClass 函数：
# Name: CellPhoneRecordsToFeatureClass.py
# Description: Imports cell phone records then associates those records with a
# cell site and sector feature classes based on identifier fields.
# Import system modules
import arcpy
# Set environment settings
arcpy.env.workspace = r"C:\data\city_pd.gdb"
# Set local variables
in_table = "CDR_Phone_1"
in_sites = "Phone_1_Sites"
in_sectors = "Phone_1_Sectors"
out_cdr_sites = "CDR_Phone_1_Sites_out"
out_cdr_sectors = "CDR_Phone_1_Sectors_out"
# Set up Beginning of Phone IDs
# [ID Type, Field]
begin_switch_id = ["SWITCH_ID","BEGSWITCH"]
begin_site_id = ["SITE_ID","BEGSITE"]
begin_sector_id = ["SECTOR_ID","BEGSECTOR"]
begin_id_fields = [begin_switch_id, begin_site_id, begin_sector_id]
subscriber_field = "SUBSCRIBERID"
destination_field = "DESTNUM"
# Set up End of Phone Call IDs
# [ID Type, Field]
end_switch_id = ["SWITCH_ID","ENDSWITCH"]
end_site_id = ["SITE_ID","ENDSITE"]
end_sector_id = ["SECTOR_ID","ENDSECTOR"]
end_id_fields = [end_switch_id, end_site_id, end_sector_id]
# Input Table Contains information about the duration of the call
start_date_field = "DATETIME"
duration_field = "DURATION"
arcpy.ca.CellPhoneRecordsToFeatureClass(in_table,
in_sites,
in_sectors,
out_cdr_sites,
out_cdr_sectors,
begin_id_fields,
subscriber_field,
destination_field,
end_id_fields,
start_date_field,
duration_field)环境
许可信息
- Basic: 是
- Standard: 是
- Advanced: 是