Resumen
Importa registros de telefonía móvil de proveedores de red inalámbrica y asocia dichos registros a clases de entidad de torre de comunicaciones y sector generadas por la herramienta De registros de torre de telecomunicaciones a clase de entidad según los campos de identificador.
Uso
Los valores del parámetro Puntos de torres de telecomunicaciones de entrada se deben generar con la herramienta De registros de torre de telecomunicaciones a clase de entidad.
Los parámetros Puntos de torres de registros telefónicos de salida y Sectores de registros telefónicos de salida solo contendrán los registros telefónicos que se vincularon correctamente a los sectores y torres de telecomunicaciones de entrada, en función de los campos de Id. coincidentes. Los valores de los parámetros Puntos de torres de registros telefónicos de salida y Sectores de registros telefónicos de salida no representan la ubicación real de un teléfono móvil.
Los proveedores de red inalámbrica proporcionan registros de telefonía móvil o registros de detalles de llamadas (CDR, por sus siglas en inglés) en una variedad de formatos y estilos. No es raro recibir datos en un esquema o formato no tabular. El valor del parámetro Tabla de registros telefónicos de entrada debe ser una tabla con nombres de columna en la parte superior.
La tabla proporcionada por el proveedor de red inalámbrica puede contener información de torres de telecomunicaciones o CDR en una fila. Cuando la tabla tiene esta estructura, debe estar separada en dos tablas. Use la tabla que contiene la información de llamada (identificadores, números de teléfono, fechas, horas, duración de llamada y coordenadas) como entrada a esta herramienta.
Se crea una entidad en las clases de entidad de salida para cada registro (evento de datos o llamada) del parámetro Tabla de registros telefónicos de entrada.
Los campos siguientes se agregarán a las clases de entidad de salida:
- SUBSCRIBER: el número de teléfono de suscriptor del parámetro Tabla de registros telefónicos de entrada. Se eliminan todos los caracteres no numéricos de la salida.
- UNIQUEID: el identificador único de las antenas del sector móvil.
Los siguientes campos se agregarán a la salida cuando se utilice el parámetro especificado:
- DESTPHONE: el número de teléfono del receptor de la llamada del parámetro Tabla de registros telefónicos de entrada. Se agrega a la salida cuando se utiliza el parámetro Campo de número de teléfono de destino. Se eliminan todos los caracteres no numéricos de la salida.
- STARTTIME: el campo de hora y fecha de inicio del parámetro Tabla de registros telefónicos de entrada. Se agrega a la salida cuando se utiliza el parámetro Campo de hora y fecha de inicio.
- DURATION: la duración de la llamada telefónica, en segundos, del parámetro Tabla de registros telefónicos de entrada. Los valores de duración con el formato HH:MM:SS se convertirán a segundos totales. Se agrega a la salida cuando se utiliza el parámetro Campo de duración o cuando se utilizan los parámetros Campo de hora y fecha de inicio y Campo de hora y fecha de finalización.
- ENDTIME: el campo de hora y fecha de finalización del parámetro Tabla de registros telefónicos de entrada. Se agrega a la salida cuando se utiliza el parámetro Campo de hora y fecha de finalización o cuando se utilizan los parámetros Campo de hora y fecha de inicio y Duración.
La tabla proporcionada por el proveedor de red inalámbrica puede contener una tabla de información de torres de telecomunicaciones con un solo campo de Id. único para definir todos los registros únicos o una combinación de campos de identificador para definir los registros únicos de la tabla. Por ejemplo, una tabla puede contener campos de identificador de sector y de torre para definir de manera única algunos registros, pero otros registros de la tabla están definidos de manera única con campos identificador de Código de área de localización y de célula.
- Cuando se proporciona un campo de Id. único para la tabla de entrada, defina la opción Tipo de Id. en Id. único en el parámetro Campos de Id. de sector móvil o Campos de Id. de sectores móviles adicionales y, en el mismo parámetro, rellene la opción Campo con el campo que represente ese Id. único.
- Cuando se proporcionan muchos campos de Id. para que la tabla indique la unicidad, todos los campos de ID. se deben agregar a la salida. Para cada campo de Id., elija el Tipo de Id. que defina el tipo de Id. en el parámetro Campos de Id. de sector móvil o Campos de Id. de sectores móviles adicionales y, en el mismo parámetro, rellene la opción Campo con el campo relacionado que contiene la información de Id. La herramienta combinará estos campos de Id. y rellenará un único campo de Id. único en las clases de entidad de salida, denominado UNIQUEID.
Los siguientes campos se agregarán a la salida si se especifican en los parámetros Campos de Id. de sector móvil o Campos de Id. de sectores móviles adicionales:
- SITEID: el identificador único de una torre de telecomunicaciones
- SECTORID: el identificador único de un sector móvil
- SWITCHID: el identificador único de un switch de red inalámbrica
- LACID: el identificador único de un Código de área de localización
- CASCADEID: el identificador único del sector dentro de la cascada de red inalámbrica
- CELLID: el identificador único del sector dentro de un Código de área de localización
Si la tabla de registros telefónicos de entrada contiene registros de llamadas que abarcan varios sectores móviles, se deben rellenar los parámetros Campos de Id. de sector móvily Campos de Id. de sectores móviles adicionales. El parámetro Campos de Id. de sector móvil debe contener los identificadores asociados con el sector inicial, y el parámetro Campos de Id. de sectores móviles adicionales debe contener el sector final o cualquier sector que no sea el sector inicial del registro de llamadas.
Si la tabla de registros telefónicos de entrada contiene registros de eventos de datos o solo se hace referencia a un sector en el registro de llamadas, solo se debe rellenar el parámetro Campos de Id. de sector móvil.
El siguiente campo y valores se generan cuando se utiliza el parámetro Campos de Id. de sectores móviles adicionales:
- IDTYPE: el campo que identifica si un registro de llamadas es del sector principal o adicional de un registro de llamadas.
- PRINCIPAL: el valor asignado cuando un registro de telefonía móvil está vinculado a un sector al inicio de una llamada.
- ADICIONAL: el valor asignado cuando un registro de telefonía móvil está vinculado a un sector al final de una llamada o a cualquier sector durante toda la llamada cuando el sector es distinto al sector del inicio de la llamada.
Si la herramienta determina que un registro de telefonía móvil está vinculado al mismo sector al comienzo y al final de una llamada, no se crea ninguna entidad separada para el sector móvil que representa el final de una llamada.
- IDTYPE: el campo que identifica si un registro de llamadas es del sector principal o adicional de un registro de llamadas.
Los puntos de llamada estimados de salida contendrán todos los campos asociados de los parámetros Puntos de torres de registros telefónicos de saliday Sectores de torres de registros telefónicos de salida.
También se agregarán los siguientes campos al parámetro Puntos de llamada estimados de salida:
- PHONEX: la coordenada x estimada de la ubicación de la llamada tal y como la proporciona el proveedor de red inalámbrica.
- PHONEY: la coordenada y estimada de la ubicación de la llamada tal y como la proporciona el proveedor de red inalámbrica.
El registro del campo SUBSCRIBER es nulo, se ignorará y no se importará a las clases de entidad de salida.
Si los campos STARTTIME y DURATION tienen valores y el campo ENDTIME no, la herramienta generará un valor de ENDTIME en las clases de entidad de salida.
Si los campos STARTTIME y ENDTIME tienen valores y el campo DURATION no, la herramienta generará un valor de DURATION en las clases de entidad de salida.
Sintaxis
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})| Parámetro | Explicación | Tipo de datos |
in_table | La tabla de entrada contiene registros de llamadas o registros de eventos de datos telefónicos proporcionados por el proveedor de red inalámbrica. | Table View |
in_site_features | La clase de entidad que contiene puntos de torres de telecomunicaciones generados por la herramienta De registros de torre de telecomunicaciones a clase de entidad. | Feature Layer |
in_sector_features | La clase de entidad que contiene sectores de torres de telecomunicaciones generados por la herramienta De registros de torre de telecomunicaciones a clase de entidad. | Feature Layer |
out_site_feature_class | La clase de entidad de puntos que contiene puntos de torres de registros telefónicos. Se generará un punto por cada registro telefónico vinculado a puntos de torres de telecomunicaciones. | Feature Class |
out_sector_feature_class | La clase de entidad poligonal que contiene sectores de registros telefónicos. Se generará un polígono de sector por cada registro telefónico vinculado a sectores de torres de telecomunicaciones. | Feature Class |
id_fields [id_fields,...] | Especifica el tipo de campo de Id. único y los campos que se agregarán a la entidad de salida. Use el tipo Id. único cuando Tabla de registros telefónicos de entrada tenga un identificador único para todas las antenas de sectores móviles. Use una combinación de otros valores de Tipo de Id. cuando la Tabla de registros telefónicos de entrada no contenga un identificador único universal para todas las antenas de sectores móviles.
Las opciones de Tipo de Id. son las siguientes:
| Value Table |
subscriber_field | El campo de la tabla de entrada que contiene el número de teléfono o identificador del suscriptor. | Field |
destination_field (Opcional) | El campo de la tabla de entrada que contiene el número de teléfono o identificador del receptor de la llamada. | Field |
additional_id_fields [additional_id_fields,...] (Opcional) | Especifica el tipo de campo de Id. único adicional y los campos que se agregarán a la entidad de salida. Use el tipo Id. único cuando Tabla de registros telefónicos de entrada tenga un identificador único para todas las antenas de sectores móviles. Use una combinación de otros valores de Tipo de Id. cuando la Tabla de registros telefónicos de entrada no contenga un identificador único universal para todas las antenas de sectores móviles.
Las opciones de Tipo de Id. son las siguientes:
| Value Table |
start_time_field (Opcional) | El campo de la tabla de entrada que contiene el campo de hora y fecha de inicio del evento de datos o llamada telefónica. | Field |
duration_field (Opcional) | El campo de la tabla de entrada que contiene la duración de la llamada telefónica en segundos. | Field |
end_time_field (Opcional) | El campo de la tabla de entrada que contiene la hora y fecha de finalización del evento de datos o llamada telefónica. | Field |
convert_utc (Opcional) | Especifica si la hora y fecha de inicio y finalización de los registros de entrada se convertirán a la zona horaria del sistema local o si se mantendrán en hora universal coordinada (UTC).
| Boolean |
location_x_field (Opcional) | El campo de la tabla de entrada que contiene la coordenada x de la ubicación estimada del teléfono tal y como la proporciona el proveedor de red inalámbrica. | Field |
location_y_field (Opcional) | El campo de la tabla de entrada que contiene la coordenada y de la ubicación estimada del teléfono tal y como la proporciona el proveedor de red inalámbrica. | Field |
location_coordinate_system (Opcional) | El sistema de coordenadas de la ubicación estimada del teléfono de las coordenadas x,y. El sistema de coordenadas predeterminado es WGS84. | Coordinate System |
out_call_points (Opcional) | La clase de entidad de punto que contiene las ubicaciones estimadas de una llamada tal y como las proporciona el proveedor de red inalámbrica. | Feature Class |
Muestra de código
El siguiente script de la ventana de Python muestra cómo utilizar la función CellPhoneRecordsToFeatureClass en el modo inmediato:
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")El siguiente script independiente es un ejemplo de cómo utilizar la función CellPhoneRecordsToFeatureClass en un script:
# 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)Entornos
Información de licenciamiento
- Basic: Sí
- Standard: Sí
- Advanced: Sí