Étiquette | Explication | Type de données |
Pays ou région | Indique la structure d’adressage de pays utilisée pour fractionner les adresses en composants. La valeur par défaut correspond au paramètre régional du système d’exploitation.
| String |
Données d’adresses en entrée | Table ou classe d'entités contenant les adresses postales à fractionner en composants d'adresse individuels. Les informations de zone, telles que la ville, le quartier, le département et le code postal, ne sont pas prises en charge. | Table View |
Champs des adresses en entrée | Champ ou champs de la table ou de la classe d'entités en entrée qui, lorsqu'ils sont concaténés, composent l'adresse postale à fractionner. Les informations de zone, telles que la ville, le quartier, le département et le code postal, ne sont pas prises en charge. L'ordre dans lequel les champs sont sélectionnés correspond à l'ordre de concaténation des champs. | String |
Données d’adresses en sortie | Table ou classe d’entités en sortie qui contient les données d'adresse postale fractionnées. | Dataset |
Fichier d’exceptions (Facultatif) | Table qui contient les exceptions d'analyse des rues. La table peut être enregistrée dans tout format de table pris en charge. | Table View |
Synthèse
Fractionne les adresses postales en composants d'adresse et crée une table ou une classe d'entités avec les composants supplémentaires ajoutés comme champs uniques.
Illustration
Utilisation
Les données d'adresse en entrée peuvent correspondre à une table ou une classe d'entités qui contient des attributs d'adresse postale pouvant être analysés ou fractionnés en composants d'adresse postale individuels.
Vous pouvez stocker l'adresse postale en entrée à fractionner dans un champ unique, tel que StreetName ou Address, que vous sélectionnez comme champ d'adresse en entrée dans l'outil.
L'adresse postale en entrée peut également être stockée dans plusieurs champs, par exemple, si le numéro de maison et les informations d'unité se trouvent dans des champs distincts. Dans ce cas, les champs sont concaténés à la volée selon l'ordre dans lequel ils sont sélectionnés et l'adresse postale est fractionnée entre ses composants.
N'incluez pas d'informations de zone, telles que la ville, le quartier, le département et le code postal, dans l'adresse postale en entrée. Ces composants ne sont pas analysés lors du traitement et génèrent des résultats incorrects s'ils sont inclus.
Vérifiez que la valeur du paramètre Fichiers d’exceptions contient une ligne pour chaque enregistrement qui aura un modèle d’analyse personnalisé. Formatez le fichier de sorte qu'il contienne le champ d'adresse en entrée (s'il existe plusieurs champs, concaténez les valeurs en une chaîne unique) suivi des composants d'adresse fractionnés attendus. Les noms de champ des composants d'adresse fractionnés doivent correspondre aux suivants :
- AddNum
- StPreDir
- StPreType
- StName
- StType
- StDir
- UnitType
- UnitName
- BuildingType
- BuildingUnit
- LevelType
- LevelName
Remarque :
Les champs ne sont pas tous requis ; seuls ceux nécessaires en fonction de l'adresse personnalisée lorsqu'elle est fractionnée en composants sont requis.
Remarque :
Pour plus d’informations, téléchargez un exemple de fichier d'exceptions.
La première adresse du fichier, 123 South Beach Avenue, est généralement fractionnée dans les champs suivants :
AddNum StPreDir StName StType 123
Sud
Plage
Avenue
Toutefois, le fichier d'exceptions crée le fractionnement personnalisé suivant :
AddNum StName StType 123
South Beach
Avenue
Cet outil prend en charge le traitement parallèle. Il est possible d’obtenir de meilleures performances, en particulier lors du fractionnement des adresses dans les jeux de données volumineux, si votre ordinateur est doté de plusieurs processeurs ou de processeurs multicœurs. Si l’environnement Facteur de traitement parallèle n’est pas défini (par défaut), le traitement parallèle est mis à l’échelle en fonction de la taille de la table et du nombre de cœurs logiques. Un seul traitement est utilisé pour les tables comportant moins de 50 lignes, mais l’outil met à l’échelle le nombre de traitements utilisés en fonction du nombre de processeurs logiques de la machine pour les tables comportant beaucoup de lignes. Si vous définissez l’environnement sur 0, le traitement parallèle est désactivé. Si vous spécifiez un facteur compris entre 1 et 99, l’outil identifie le pourcentage de cœurs logiques à utiliser en appliquant la formule (Facteur de traitement parallèle / 100 * Cœurs logiques) arrondie à l’entier le plus proche. Si le résultat de cette formule est 0 ou 1, le traitement parallèle n’est pas activé.
Vous pouvez examiner et mettre à jour le fichier généré en sortie par cet outil dans la fenêtre Vérification du fractionnement des adresses. Ce processus vous permet également de générer ou d’ajouter un fichier d’exceptions mis à jour qui peut être utilisé dans le paramètre Fichier d’exceptions lors du fractionnement ultérieur des données à l’aide de cet outil.
Paramètres
arcpy.geocoding.SplitAddressIntoComponents(country_code, in_address_data, in_address_fields, out_address_data, {in_exceptions})
Nom | Explication | Type de données |
country_code | Indique la structure d’adressage de pays utilisée pour fractionner les adresses en composants. La valeur par défaut correspond au paramètre régional du système d’exploitation.
| String |
in_address_data | Table ou classe d'entités contenant les adresses postales à fractionner en composants d'adresse individuels. Les informations de zone, telles que la ville, le quartier, le département et le code postal, ne sont pas prises en charge. | Table View |
in_address_fields [in_address_fields,...] | Champ ou champs de la table ou de la classe d'entités en entrée qui, lorsqu'ils sont concaténés, composent l'adresse postale à fractionner. Les informations de zone, telles que la ville, le quartier, le département et le code postal, ne sont pas prises en charge. L'ordre dans lequel les champs sont sélectionnés correspond à l'ordre de concaténation des champs. | String |
out_address_data | Table ou classe d’entités en sortie qui contient les données d'adresse postale fractionnées. | Dataset |
in_exceptions (Facultatif) | Table qui contient les exceptions d'analyse des rues. La table peut être enregistrée dans tout format de table pris en charge. | Table View |
Exemple de code
Fractionnez une table avec des chaînes d'adresse sur un champ en composants distincts.
import arcpy
atlanta_addresses = r"C:\AtlantaAddresses.csv"
arcpy.geocoding.SplitAddressIntoComponents("USA", atlanta_addresses, "Address",
r"C:\MySplitAddresses.csv",
"ExceptionsFile.csv")
Environnements
Vous avez un commentaire à formuler concernant cette rubrique ?