Résumé
Crée des adresses à partir des emplacements de points d’une classe d’entités. Le processus de géocodage inverse recherche l'adresse ou l'intersection la plus proche pour l'emplacement de point, d'après la distance de recherche spécifiée. Lors de l'utilisation du localisateur ArcGIS World Geocoding Service, cette opération peut consommer des crédits.
Utilisation
La classe d'entités en entrée doit contenir des formes de points dotées de coordonnées XY valides. Les adresses ne seront pas retournées sur des points aux coordonnées nulles.
La classe d'entités en sortie contiendra le même nombre d'enregistrements que la classe d'entités en entrée. Des champs supplémentaires contenant les adresses des résultats sont ajoutés à la classe d'entités. Le préfixe REV_ est ajouté aux noms des champs. Si une adresse est introuvable, les champs contiendront des valeurs vides.
Si la référence spatiale de la classe d'entités en entrée est différente de celle du localisateur d'adresses, ce dernier transforme les coordonnées à la volée et tente de trouver une correspondance. La référence spatiale de la classe d'entités en sortie sera enregistrée dans la même référence spatiale que celle de la classe d'entités en entrée. Il est possible de modifier la référence spatiale de la classe d'entités en sortie en définissant un système de coordonnées en sortie différent dans les paramètres d'environnement de l'outil.
Si un point dans la classe d'entités en entrée ne parvient pas à retourner une adresse, cela signifie qu'aucune entité dans le localisateur d'adresses ne peut être associée au point en entrée. Voici quelques raisons courantes à la non correspondance des points :
- La distance de recherche est trop réduite pour que le point puisse trouver les entités les plus proches.
- Le point contient des coordonnées nulles.
- Les coordonnées du point sont incorrectes et ne peuvent pas être transformées en référence spatiale utilisée dans le localisateur d'adresses.
- Le localisateur d'adresses ne contient aucune entité de référence dans la zone pouvant être associée au point.
Vous pouvez augmenter la distance de recherche pour accroître la possibilité de trouver l'adresse la plus proche ou utiliser un localisateur d'adresses différent qui contient davantage d'entités ou qui couvre une zone plus étendue, de manière à apparier les points en entrée.
Un abonnement à ArcGIS Online for organizations est indispensable si vous inversez le géocodage d'une classe d'entités géocodées à l'aide d'un service de ArcGIS World Geocoding Service. Pour plus d'informations, reportez-vous à la rubrique Utilisation du service de géocodage mondial ArcGIS Online.
Syntaxe
ReverseGeocode_geocoding (in_features, in_address_locator, out_feature_class, {address_type}, {search_distance}, {feature_type}, {location_type})
Paramètre | Explication | Type de données |
in_features | Classe ou couche d'entités ponctuelles à partir de laquelle les adresses sont retournées, d'après l'emplacement des points de l'entité. | Feature Class |
in_address_locator | Localisateur d'adresses à utiliser pour inverser le géocodage de la classe d'entités en entrée. | Address Locator |
out_feature_class | Classe d'entités en sortie. | Feature Class |
address_type (Facultatif) | Indique si retourner des adresses pour les points sous forme d'adresses de rues ou d'adresses d'intersections si le localisateur d'adresses prend en charge l'appariement d'intersections.
| String |
search_distance (Facultatif) | Distance utilisée pour rechercher l'adresse ou l'intersection la plus proche pour l'emplacement de point. Certains localisateurs utilisent des valeurs de distance optimisées qui ne permettent pas de remplacer le paramètre de distance de recherche. | Linear Unit |
feature_type [feature_type,...] (Facultatif) | Restreint les types de correspondance possibles. Une ou plusieurs valeurs peuvent être sélectionnées. Lorsqu'une seule valeur est sélectionnée, la tolérance de recherche pour le type d'entité en entrée est de 500 mètres. Si plusieurs valeurs sont incluses, les distances de recherche par défaut sont appliquées Ce paramètre n’est pas pris en charge pour tous les localisateurs.
| String |
location_type (Facultatif) | Ce paramètre est disponible pour les localisateurs qui prennent en charge le paramètre locationType. Indique la géométrie en sortie préférée pour les appariements PointAddress. Les options de ce paramètre sont le côté d’une rue qui peut être utilisé pour le calcul de l’itinéraire ou l’emplacement représentant le toit ou le centroïde de parcelle de l’adresse. Si l’emplacement préféré n’existe pas dans les données, l’emplacement par défaut est renvoyé à la place. Ce paramètre n’est pas pris en charge pour tous les localisateurs.
| String |
Exemple de code
Exemple d'utilisation de l'outil ReverseGeocode (fenêtre Python)
Le script de fenêtre Python ci-dessous illustre l'utilisation de la fonction ReverseGeocode en mode immédiat.
# Import system modules
import arcpy
arcpy.env.workspace = "C:/ArcTutor/Geocoding/atlanta.gdb"
# Set local variables:
input_feature_class = "geocode_result"
address_locator = "C:/ArcTutor/Geocoding/Atlanta.loc"
result_feature_class = "customers_with_address"
arcpy.ReverseGeocode_geocoding(input_feature_class, address_locator,
result_feature_class, "ADDRESS", "100 Meters")
Environnements
Informations de licence
- ArcGIS Desktop Basic: Oui
- ArcGIS Desktop Standard: Oui
- ArcGIS Desktop Advanced: Oui