Registres de téléphone portable vers classe d’entités (Analyse criminelle et sécurité)—ArcGIS Pro

Résumé

Importe les registres de téléphone portable des opérateurs de téléphonie mobile et associe ces registres à un site cellulaire et aux classes d’entités sectorielles tels qu’il sont générés par l’outil Relevés de site cellulaire vers classe d’entités sur la base des champs d’identifiants.

Utilisation

Les valeurs du paramètre Input Cell Site Points (Points du site cellulaire en entrée) doivent être générées à l’aide de l’outil Relevés de site cellulaire vers classe d’entités.
Les paramètres Output Phone Record Site Points (Points des sites de registres téléphoniques en sortie) et Output Phone Record Sectors (Secteurs de registres téléphoniques en sortie) incluront uniquement les registres téléphoniques qui ont bien été liés au site cellulaire et secteurs en entrée sur la base des champs d’ID appariés. Les valeurs des paramètres Output Phone Record Site Points (Points des sites de registres téléphoniques en sortie) et Output Phone Record Sectors (Secteurs de registres téléphoniques en sortie) ne représentent pas l’emplacement réel du téléphone portable.
Les registres téléphoniques ou registres détaillés des appels sont transmis par les opérateurs de téléphonie mobile dans différents formats et styles. Il n’est pas inhabituel que ces données soient transmises dans un format non tabulaire ou sous forme de schéma. La valeur du paramètre Input Phone Records Table (Table des registres téléphoniques en entrée) doit être une table dans laquelle les noms des colonnes apparaissent en haut.
La table transmise par l’opérateur de téléphonie mobile peut contenir des registres détaillés des appels et des informations de site cellulaire dans une même ligne. Les tables structurées de cette façon doivent être séparées en deux tables. Utilisez la table contenant les informations relatives aux appels (identifiants, numéros de téléphone, dates, heure, durée d’appel et coordonnées) comme entrée pour cet outil.
Une entité est créée dans les classes d’entités en sortie pour chaque registre (appel ou événement de données) du paramètre Input Phone Records Table (Table des registres téléphoniques en entrée).
Les champs suivants sont ajoutés aux classes d’entités en sortie :
- SUBSCRIBER : le numéro de téléphone de l’abonné du paramètre Input Phone Records Table (Table des registres téléphoniques en entrée). Tous les caractères non numériques sont supprimés de la sortie.
- UNIQUEID : l’identifiant unique des antennes des secteurs.
Les champs suivants sont ajoutés à la sortie lorsque le paramètre spécifié est utilisé :
- DESTPHONE : le numéro de téléphone appelé du paramètre Input Phone Records Table (Table des registres téléphoniques en entrée). Cette information est ajoutée à la sortie lorsque le paramètre Destination Phone Number Field (Champ du numéro de téléphone de destination) est utilisé. Tous les caractères non numériques sont supprimés de la sortie.
- STARTTIME : le champ Date et heure de début du paramètre Input Phone Records Table (Table des registres téléphoniques en entrée). Cette information est ajoutée à la sortie lorsque le paramètre Start Date and Time Field (Champ Date et heure de début) est utilisé.
- DURATION : la durée en secondes de l’appel téléphonique, du paramètre Input Phone Records Table (Table des registres téléphoniques en entrée). Les valeurs de durée au format HH:MM:SS seront converties en secondes totales. Cette information est ajoutée à la sortie lorsque le paramètre Duration Field (Champ Durée) est utilisé ou lorsque les paramètres Start Date and Time Field (Champ Date et heure de début) et End Date and Time Field (Champ Date et heure de fin) sont tous les deux utilisés.
- ENDTIME : le champ Date et heure de fin du paramètre Input Phone Records Table (Table des registres téléphoniques en entrée). Cette information est ajoutée à la sortie lorsque le paramètre End Date and Time Field (Champ Date et heure de fin) est utilisé ou lorsque les paramètres Start Date and Time Field (Champ Date et heure de début) et Duration (Durée) sont tous les deux utilisés.
La table fournie par le fournisseur de réseau sans fil peut inclure une table des informations de site cellulaire avec un champ d’ID unique pour définir tous les enregistrements uniques ou une combinaison de champs d’identifiants pour définir des enregistrements uniques dans la table. Par exemple, une table peut contenir des champs d’identifiant de site et d’identifiant de secteur pour définir de manière unique certains enregistrements, mais d’autres enregistrements de la table sont définis de manière unique avec des champs d’identifiant LAC (Location Area Code) et d’identifiant cellulaire.
- Lorsqu’un champ d’ID unique est fourni pour la table en entrée, définissez l’option ID Type (Type d’ID) sur Unique ID (ID unique) dans le paramètre Cell Sector ID Fields (Champs d’ID de secteur cellulaire) ou Additional Cell Sector ID Fields (Champs d’ID de secteur cellulaire supplémentaire). Dans le même paramètre, renseignez l’option Field (Champ) avec le champ qui représente cet ID unique.
- Lorsque de nombreux champs d’ID sont fournis pour la table afin d’indiquer l’unicité, tous les champs d’ID doivent être ajoutés à la sortie. Pour chaque champ d’ID choisissez la valeur de ID Type (Type d’ID) qui définit le type d’ID dans le paramètre Cell Sector ID Fields (Champs d’ID de secteur cellulaire) ou Additional Cell Sector ID Fields (Champs d’ID de secteur cellulaire supplémentaire). Dans le même paramètre, renseignez l’option Field (Champ) avec le champ associé qui contient les informations de cet ID. L’outil combine des champs d’ID et renseigne un champ d’ID unique dans les classes d’entités en sortie nommé UNIQUEID.
Les champs suivants seront ajoutés à la sortie s’ils sont spécifiés dans le paramètre Cell Sector ID Fields (Champs ID de secteur cellulaire) ou Additional Cell Sector ID Fields (Champs ID de secteur cellulaire supplémentaire) :
- SITEID : identifiant unique d’un site cellulaire
- SECTORID : identifiant unique d’un secteur cellulaire
- SWITCHID : identifiant unique d’un commutateur réseau sans fil
- LACID : identifiant unique d’un code LAC (Location Area Code)
- CASCADEID : identifiant unique du secteur dans la cascade de réseau sans fil
- CELLID : identifiant unique du secteur dans un code LAC (Location Area Code)
Lorsque la table de registres téléphoniques en entrée contient des registres d’appel qui couvrent plusieurs secteurs cellulaires, les paramètres Cell Sector ID Fields (Champs ID de secteur cellulaire) et Additional Cell Sector ID Fields (Champs ID de secteur cellulaire supplémentaire) doivent être renseignés. Le paramètre Cell Sector ID Fields (Champs ID de secteur cellulaire) doit contenir les identifiants associés au secteur de départ, et le paramètre Additional Cell Sector ID Fields (Champs ID de secteur cellulaire supplémentaire) doit contenir le secteur de fin ou tout autre secteur que le secteur de départ du registre d’appel.
Lorsque la table des registres téléphoniques en entrée contient des registres d’événements de données ou que le registre d’appel ne recense qu’un seul secteur, seul le paramètre Cell Sector ID Fields (Champs ID de secteur cellulaire) doit être renseigné.
Le champ et les valeurs suivants sont générés lorsque le paramètre Additional Cell Sector ID Fields (Champs ID de secteur cellulaire supplémentaire) est utilisé :
- IDTYPE : le champ indiquant si un registre d’appel correspond au secteur primaire ou à un secteur supplémentaire d’un registre d’appel.
  - PRIMAIRE : la valeur attribuée lorsqu’un registre de téléphone portable est associé à un secteur au début d’un appel.
  - SUPPLÉMENTAIRE : la valeur attribuée lorsqu’un registre de téléphone portable est associé à un secteur à la fin d’un appel ou à tout autre secteur que le secteur de départ au cours d’un appel.
Si l’outil détermine que le secteur associé à un registre de téléphone portable est le même au début et à la fin de l’appel, aucune entité distincte n’est créée pour le secteur cellulaire représentant la fin de l’appel.
Les points d’appels en sortie estimés incluront tous les champs associés des paramètres Output Phone Records Site Points (Points des sites de registres téléphoniques en sortie) et Output Phone Records Site Sectors (Secteurs des sites de registres téléphoniques en sortie).
Les champs suivants sont également ajoutés au paramètre Output Estimated Call Points (Points d’appels estimés en sortie) :
- PHONEX : les coordonnées X estimées de l’emplacement de l’appel telles qu’elles sont fournies par l’opérateur de téléphonie mobile.
- PHONEY : les coordonnées Y estimées de l’emplacement de l’appel telles qu’elles sont fournies par l’opérateur de téléphonie mobile.
Lorsque le registre du champ SUBSCRIBER est nul, il est ignoré et n’est pas importé dans les classes d’entités en sortie.
Lorsque les champs STARTTIME et DURATION contiennent des valeurs mais que le champ ENDTIME n’en contient pas, l’outil génère une valeur ENDTIME dans les classes d’entités en sortie.
Lorsque les champs STARTTIME et ENDTIME contiennent des valeurs mais que le champ DURATION n’en contient pas, l’outil génère une valeur DURATION dans les classes d’entités en sortie.

Syntaxe

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})

Paramètre	Explication	Type de données
in_table	Table en entrée contenant les registres d’appel ou registres d’événements de données téléphoniques fournis par l’opérateur de téléphonie mobile.	Table View
in_site_features	Classe d’entités contenant les points des sites cellulaires générés par l’outil Relevés de site cellulaire vers classe d’entités.	Feature Layer
in_sector_features	Classe d’entités contenant les secteurs des sites cellulaires générés par l’outil Relevés de site cellulaire vers classe d’entités.	Feature Layer
out_site_feature_class	Classe d’entités ponctuelles contenant les points des sites de registres téléphoniques. Un point est généré par registre téléphonique associé aux points des sites cellulaires.	Feature Class
out_sector_feature_class	Classe d’entités surfaciques contenant les secteurs de registres téléphoniques. Un polygone de secteur est généré par registre téléphonique associé aux secteurs des sites cellulaires.	Feature Class
id_fields [id_fields,...]	Specifies the unique ID field type and the fields that will be added to the output feature. Utilisez le type Unique ID (ID unique) lorsque Input Phone Records Table (Table des registres téléphoniques en entrée) possède un identifiant unique pour toutes les antennes de secteurs cellulaires. Utilisez une combinaison d’autres valeurs ID Type (Type d’ID) lorsque Input Phone Records Table (Table des registres téléphoniques en entrée) ne contient pas d’identifiant unique universel pour toutes les antennes de secteurs cellulaires. ID Type—The field name to be included in the output feature classes. Field—The name of the fields that uniquely identify the cell sector antennas. These will be added to the output feature class. ID Type options are as follows: Unique ID—Uniquely identifies a cell sector antenna Site ID—Uniquely identifies a cell site Sector ID—Uniquely identifies a cell sector Switch ID—Uniquely identifies a wireless network switch LAC ID—Uniquely identifies the Location Area Code Cascade ID—Uniquely identifies the sector in the wireless network cascade Cell ID—Identifies the sector within an Location Area Code	Value Table
subscriber_field	Champ de la table en entrée contenant le numéro de téléphone ou l’identifiant de l’abonné.	Field
destination_field (Facultatif)	Champ de la table en entrée contenant le numéro de téléphone ou l’identifiant de la personne appelée.	Field
additional_id_fields [additional_id_fields,...] (Facultatif)	Spécifie le type de champ d’ID unique supplémentaire et les champs qui seront ajoutés à l’entité en sortie. Utilisez le type Unique ID (ID unique) lorsque Input Phone Records Table (Table des registres téléphoniques en entrée) possède un identifiant unique pour toutes les antennes de secteurs cellulaires. Utilisez une combinaison d’autres valeurs ID Type (Type d’ID) lorsque Input Phone Records Table (Table des registres téléphoniques en entrée) ne contient pas d’identifiant unique universel pour toutes les antennes de secteurs cellulaires. ID Type—The field name to be included in the output feature classes. Field—The name of the fields that uniquely identify the cell sector antennas. These will be added to the output feature class. ID Type options are as follows: Unique ID—Uniquely identifies a cell sector antenna Site ID—Uniquely identifies a cell site Sector ID—Uniquely identifies a cell sector Switch ID—Uniquely identifies a wireless network switch LAC ID—Uniquely identifies the Location Area Code Cascade ID—Uniquely identifies the sector in the wireless network cascade Cell ID—Identifies the sector within an Location Area Code	Value Table
start_time_field (Facultatif)	Champ de la table en entrée contenant le champ de date et d’heure de début de l’appel téléphonique ou de l’événement de données.	Field
duration_field (Facultatif)	Champ de la table en entrée contenant la durée de l’appel téléphonique en secondes.	Field
end_time_field (Facultatif)	Champ de la table en entrée contenant la date et l’heure de fin de l’appel téléphonique ou de l’événement de données.	Field
convert_utc (Facultatif)	Spécifie si les dates et heures de début et de fin des registres en entrée seront converties selon le fuseau horaire du système local ou seront conservées au format UTC. CONVERT —Les dates et heures de début et de fin des registres en entrée seront converties à partir du format UTC au fuseau horaire du système local. NO_CONVERT —Les dates et heures de début et de fin des registres en entrée ne seront pas converties. Il s’agit de l’option par défaut.	Boolean
location_x_field (Facultatif)	Le champ de la table en entrée contenant les coordonnées X de l’emplacement estimé du téléphone, tel qu’il a été fourni par l’opérateur de téléphonie mobile.	Field
location_y_field (Facultatif)	Le champ de la table en entrée contenant les coordonnées Y de l’emplacement estimé du téléphone, tel qu’il a été fourni par l’opérateur de téléphonie mobile.	Field
location_coordinate_system (Facultatif)	Système de coordonnées (coordonnées x,y) de l’emplacement estimé du téléphone. Le système de coordonnées par défaut est WGS84.	Coordinate System
out_call_points (Facultatif)	Classe d’entités ponctuelles contenant les emplacements d’appels estimés tels qu’ils ont été fournis par l’opérateur de téléphonie mobile.	Feature Class

Exemple de code

Exemple 1 d’utilisation de l’outil CellPhoneRecordsToFeatureClass (fenêtre Python)

Le script de fenêtre Python ci-dessous illustre l’utilisation de la fonction CellPhoneRecordsToFeatureClass en mode immédiat :

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")

Exemple 2 d’utilisation de l’outil CellPhoneRecordsToFeatureClass (fenêtre autonome)

Le script autonome suivant est un exemple d’utilisation de la fonction CellPhoneRecordsToFeatureClass dans 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)

Informations de licence

Basic: Oui
Standard: Oui
Advanced: Oui

Rubriques connexes

Vous avez un commentaire à formuler concernant cette rubrique ?