Géocodage inverse (Outils de géocodage)

Résumé

Crée des adresses à partir des localisations ponctuelles d’une classe d’entités. Le processus de géocodage inverse recherche l’adresse, le lieu ou l’intersection les plus proches de la localisation ponctuelle, d’après les valeurs de distance optimisées pour les localisateurs créés avec l’outil Create Locator (Créer un localisateur).

Pour réaliser des opérations de géocodage à l’aide d’ArcGIS World Geocoding Service, vous avez besoin d’un compte d’organisation ArcGIS et de crédits. Le compte d’organisation doit disposer de suffisamment de crédits pour satisfaire à la totalité de la demande de géocodage.

Remarque :

L’estimation des crédits est accessible en haut de l’outil si le portail actif est ArcGIS Online et que le localisateur en entrée est ArcGIS World Geocoding Service.

Utilisation

La classe d’entités en entrée doit contenir des formes de point dotées de coordonnées x,y valides. Les résultats ne sont pas retournés sur les points aux coordonnées nulles.
La classe d’entités en sortie contient le même nombre d’enregistrements que la classe d’entités en entrée. Des champs supplémentaires contenant les adresses ou les lieux résultants sont ajoutés à la classe d’entités. Le préfixe REV_ est ajouté aux noms des champs. Si une adresse ou un lieu d’appariement est introuvable, les champs contiennent des valeurs NULL.
Si la référence spatiale de la classe d’entités en entrée est différente de celle du localisateur, celui-ci transforme les coordonnées à la volée et tente de trouver une correspondance. La classe d’entités en sortie est enregistrée dans la même référence spatiale que la classe d’entités en entrée. Pour modifier la référence spatiale de la classe d’entités en sortie, définissez l’environnement Output Coordinate System (Système de coordonnées en sortie).
Si un point dans la classe d’entités en entrée ne renvoie pas d’adresse ou de lieu correspondant, cela signifie qu’aucune entité dans le localisateur ne peut être associée au point en entrée. Voici les raisons courantes du non-appariement des points :
- Le point contient des coordonnées nulles.
- Les coordonnées du point sont incorrectes et ne peuvent pas être transformées dans la référence spatiale utilisée dans le localisateur.
- Le localisateur ne contient aucune entité de référence dans la zone pouvant être associée au point.
- Il n’existe aucune correspondance appropriée située à une distance raisonnable pour le type d’entité spécifié. Pour plus d’informations, reportez-vous à la rubrique Conditions de correspondance des types d’entités.
Si une distance inverse est spécifiée dans les propriétés du localisateur, elle remplace les valeurs de distance hiérarchiques optimisées utilisées en fonction des rôles pris en charge par le localisateur.
Un abonnement ArcGIS Online pour les organisations est requis pour effectuer le géocodage inverse d’une classe d’entités à l’aide d’ArcGIS World Geocoding Service.
Lorsqu’un localisateur créé avec des données de type z est utilisé en entrée, l’outil renvoie une sortie qui n’est pas de type z. Seule les sorties 2D sont prises en charge dans cet outil.

Etiqueter	Explication	Type de données
Classe ou couche d’entités en entrée	Classe ou couche d’entités ponctuelles à partir de laquelle les adresses ou les lieux correspondants sont retournés, d’après la localisation ponctuelle des entités.	Feature Layer
Localisateur d’adresses en entrée requis	Localisateur à utiliser pour inverser le géocodage de la couche ou classe d’entités en entrée.	Address Locator
Classe d’entités en sortie	Classe d’entités en sortie. Remarque : L’enregistrement de la sortie au format shapefile n’est pas pris en charge en raison de limitations liées aux shapefiles.	Feature Class
Type d’adresse en sortie (Facultatif)	Héritage : Ce paramètre est obsolète et conservé uniquement en vue de la rétrocompatibilité. Par défaut, les types d’entités pris en charge par le localisateur sont utilisés.	String
Distance de recherche (Facultatif)	Héritage : Ce paramètre est obsolète et conservé uniquement en vue de la rétrocompatibilité. Par défaut, les valeurs de distance hiérarchiques optimisées sont utilisées en fonction des rôles pris en charge par le localisateur et ne peuvent pas être remplacées.	Linear Unit
Type d’entités (Facultatif)	Indique les types d’appariement possibles renvoyés. Une valeur unique ou plusieurs valeurs peuvent être spécifiées. Si vous spécifiez une seule valeur, la tolérance de recherche pour le type d’entité en entrée est de 500 mètres. Si plusieurs valeurs sont sélectionnées, les distances de recherche par défaut spécifiées dans la table hiérarchique du type d’entité s’appliquent. Reportez-vous à la rubrique Types d’entités pour plus d’informations sur l’utilisation de ce paramètre dans le cadre du géocodage inverse. Ce paramètre n’est pas pris en charge pour tous les localisateurs. Sous-adresse—L’appariement est limité à une adresse reposant sur des points qui représentent les emplacements de sous-adresse de domiciles et de bâtiments. Cette option nécessite un localisateur créé dans ArcGIS Pro 2.8 ou version ultérieure et ArcGIS Enterprise 10.9 ou version ultérieure en cas de publication en tant que service. Adresse du point—L’appariement est limité à une adresse reposant sur des points qui représentent les emplacements de domiciles et de bâtiments. Parcelle—L’appariement est limité à une parcelle de terrain considérée comme un bien immobilier et qui peut inclure une ou plusieurs maisons ou autres structures. Cette option est généralement associée à une adresse et à un numéro d’identification de parcelle. Elle est uniquement prise en charge par les localisateurs personnalisés intégrés au rôle Parcel (Parcelle). Elle n’est pas prise en charge par les localisateurs ArcGIS World Geocoding Service ou ArcGIS StreetMap Premium. Adresse de rue—La correspondance est limitée à une adresse postale différente de Point Address (Adresse du point) car le numéro d’habitation est interpolé à partir d’une plage de numéros. Les correspondances Street Address (Adresse postale) incluent la plage de numéros d’habitation pour le segment de rue correspondant au lieu de la valeur du numéro d’habitation interpolé. Intersection de rue—L’appariement est limité à une adresse qui se compose d’une intersection de rues, ainsi que de la ville et d’informations facultatives sur l’État et le code postal. Cela provient des données de référence Street Address (Adresse postale) (par exemple, Redlands Blvd & New York St, Redlands, CA, 92373). Nom de rue—L’appariement est limité à une adresse postale similaire à Street Address (Adresse postale), mais sans les numéros de maison et avec les divisions administratives et un code postal facultatif (par exemple, W Olive Ave, Redlands, CA, 92373). Localité—L’appariement est limité à un nom de lieu représentant un lieu habité. Postal—L’appariement est limité à un code postal. Les données de référence correspondent à des points de code postal, par exemple, 90210 USA. Point d’intérêt—L’appariement est limité à un point d’intérêt. Les données de référence se composent d’une division administrative, de noms de lieux, de commerces, de lieux d’intérêt et d’entités géographiques, par exemple, Starbucks. Symbole ponctuel de distance—L’appariement est limité à une adresse qui représente la distance linéaire dans une rue, généralement en kilomètres ou en miles, depuis une localisation d’origine désignée, par exemple, Mile 25 I-5 N, San Diego, CA.	String
Type d’emplacement préféré (Facultatif)	Spécifie la géométrie en sortie privilégiée qui est renvoyée pour les correspondances `PointAddress`. Si l’emplacement préféré n’existe pas dans les données, l’emplacement par défaut de Address location (Localisation d’adresse) est renvoyé. Consultez l’aide Web d’ArcGIS REST API pour en savoir plus sur le paramètre `locationType` dans le cadre de l’opération `geocodeAddresses`. Emplacement d’adresse—La géométrie des résultats de géocodage qui représentent une localisation d’adresse, comme le toit, le centroïde de la parcelle ou la porte principale, est renvoyée. Il s’agit de l’option par défaut. Emplacement d’itinéraire—La géométrie des résultats de géocodage représentant un emplacement proche du côté de la rue qui peut servir dans le cadre du calcul d’itinéraire est renvoyé.	String

arcpy.geocoding.ReverseGeocode(in_features, in_address_locator, out_feature_class, {address_type}, {search_distance}, {feature_type}, {location_type})

Nom	Explication	Type de données
in_features	Classe ou couche d’entités ponctuelles à partir de laquelle les adresses ou les lieux correspondants sont retournés, d’après la localisation ponctuelle des entités.	Feature Layer
in_address_locator	Localisateur à utiliser pour inverser le géocodage de la couche ou classe d’entités en entrée.	Address Locator
out_feature_class	Classe d’entités en sortie. Remarque : L’enregistrement de la sortie au format shapefile n’est pas pris en charge en raison de limitations liées aux shapefiles.	Feature Class
address_type (Facultatif)	Héritage : Ce paramètre est obsolète et conservé uniquement en vue de la rétrocompatibilité. Par défaut, les types d’entités pris en charge par le localisateur sont utilisés.	String
search_distance (Facultatif)	Héritage : Ce paramètre est obsolète et conservé uniquement en vue de la rétrocompatibilité. Par défaut, les valeurs de distance hiérarchiques optimisées sont utilisées en fonction des rôles pris en charge par le localisateur et ne peuvent pas être remplacées.	Linear Unit
feature_type [feature_type,...] (Facultatif)	Indique les types d’appariement possibles renvoyés. Une valeur unique ou plusieurs valeurs peuvent être spécifiées. Si vous spécifiez une seule valeur, la tolérance de recherche pour le type d’entité en entrée est de 500 mètres. Si plusieurs valeurs sont sélectionnées, les distances de recherche par défaut spécifiées dans la table hiérarchique du type d’entité s’appliquent. Reportez-vous à la rubrique Types d’entités pour plus d’informations sur l’utilisation de ce paramètre dans le cadre du géocodage inverse. Ce paramètre n’est pas pris en charge pour tous les localisateurs. `SUBADDRESS`—L’appariement est limité à une adresse reposant sur des points qui représentent les emplacements de sous-adresse de domiciles et de bâtiments. Cette option nécessite un localisateur créé dans ArcGIS Pro 2.8 ou version ultérieure et ArcGIS Enterprise 10.9 ou version ultérieure en cas de publication en tant que service. `POINT_ADDRESS`—L’appariement est limité à une adresse reposant sur des points qui représentent les emplacements de domiciles et de bâtiments. `PARCEL`—L’appariement est limité à une parcelle de terrain considérée comme un bien immobilier et qui peut inclure une ou plusieurs maisons ou autres structures. Cette option est généralement associée à une adresse et à un numéro d’identification de parcelle. Elle est uniquement prise en charge par les localisateurs personnalisés intégrés au rôle Parcel (Parcelle). Elle n’est pas prise en charge par les localisateurs ArcGIS World Geocoding Service ou ArcGIS StreetMap Premium. `STREET_ADDRESS`—L’appariement est limité à une adresse qui diffère de `POINT_ADDRESS` car le numéro d’habitation est interpolé à partir d’une plage de numéros. Les correspondances du champ `STREET_ADDRESS` incluent la plage de numéros d’habitation pour le segment de rue correspondant, plutôt que la valeur interpolée du numéro d’habitation. `STREET_INTERSECTION`—L’appariement est limité à une adresse qui se compose d’une intersection de rues, ainsi que de la ville et d’informations facultatives sur l’État et le code postal. Ces informations proviennent des données de référence `STREET_ADDRESS` (par exemple, Redlands Blvd & New York St, Redlands, CA, 92373). `STREET_NAME`—L’appariement est limité à une adresse postale similaire à `STREET_ADDRESS`, mais sans les numéros d’habitation et avec les divisions administratives et un code postal facultatif (par exemple, W Olive Ave, Redlands, CA, 92373). `LOCALITY`—L’appariement est limité à un nom de lieu représentant un lieu habité. `POSTAL`—L’appariement est limité à un code postal. Les données de référence correspondent à des points de code postal, par exemple, 90210 USA. `POINT_OF_INTEREST`—L’appariement est limité à un point d’intérêt. Les données de référence se composent d’une division administrative, de noms de lieux, de commerces, de lieux d’intérêt et d’entités géographiques, par exemple, Starbucks. `DISTANCE_MARKER`—L’appariement est limité à une adresse qui représente la distance linéaire dans une rue, généralement en kilomètres ou en miles, depuis une localisation d’origine désignée, par exemple, Mile 25 I-5 N, San Diego, CA.	String
location_type (Facultatif)	Spécifie la géométrie en sortie privilégiée qui est renvoyée pour les correspondances `PointAddress`. Si la localisation privilégiée n’existe pas dans les données, la localisation par défaut de `ADDRESS_LOCATION` est renvoyée. Consultez l’aide Web d’ArcGIS REST API pour en savoir plus sur le paramètre `locationType` dans le cadre de l’opération `geocodeAddresses`. `ADDRESS_LOCATION`—La géométrie des résultats de géocodage qui représentent une localisation d’adresse, comme le toit, le centroïde de la parcelle ou la porte principale, est renvoyée. Il s’agit de l’option par défaut. `ROUTING_LOCATION`—La géométrie des résultats de géocodage représentant un emplacement proche du côté de la rue qui peut servir dans le cadre du calcul d’itinéraire est renvoyé.	String

Exemple de code

Exemple 1 d’utilisation de la fonction ReverseGeocode (fenêtre Python)

Le script de fenêtre Python ci-après illustre l’utilisation de la fonction ReverseGeocode en mode immédiat.

import arcpy

arcpy.env.workspace = "C:/data/locations.gdb"

# Set local variables:
input_feature_class = "customers"
address_locator = "e:/StreetMap/data/Street_Addresses_US.loc"
result_feature_class = "customers_with_address"

arcpy.geocoding.ReverseGeocode(input_feature_class, address_locator,
                               result_feature_class, "ADDRESS")

Exemple 2 d’utilisation de la fonction ReverseGeocode (script autonome)

Le script Python ci-après illustre l’utilisation de la fonction ReverseGeocode dans un script autonome.

# Description:
# Reverse Geocode customer point locations using a locator created with
# the Create Locator tool.

# Import system modules
import arcpy

# Set workspace
arcpy.env.workspace = "c:/data/Atlanta.gdb"

# Set local variables
input_features = "MyCustomers"
locator = "c:/data/Atlanta/Atlanta_StreetAddress.loc"
reverse_output = "MyCustomers_Reverse_Streets"
addr_type = "ADDRESS"
feature_type = "STREET_INTERSECTION;STREET_ADDRESS"
location_type = "ROUTING_LOCATION"

# Run ReverseGeocode
arcpy.geocoding.ReverseGeocode(input_features, locator, reverse_output,
                               addr_type, None, feature_type, location_type)

Exemple 3 d’utilisation de la fonction ReverseGeocode (script autonome)

Le script Python suivant illustre l’utilisation de la fonction ReverseGeocode avec ArcGIS World Geocoding Service dans un script autonome.

Remarque :

Si vous utilisez des localisateurs sur un portail, assurez-vous d’être connecté à celui-ci et de l’avoir défini comme portail actif dans ArcGIS Pro. Pour accéder à un localisateur situé sur un portail qui n’est pas votre portail actif, authentifiez-vous à l’aide de la fonction SignInToPortal.

# Description:
# Reverse Geocode customer point locations using the ArcGIS World Geocoding Service.

# Import system modules
import arcpy

# Set workspace
arcpy.env.workspace = "c:/data/Atlanta.gdb"

# Set local variables
input_features = "MyCustomers"
locator = "https://geocode.arcgis.com/arcgis/rest/services/World/GeocodeServer/ArcGIS World Geocoding Service"
reverse_output = "MyCustomers_Reverse_Streets"
addr_type = "ADDRESS"
feature_type = "STREET_INTERSECTION;STREET_ADDRESS"
location_type = "ROUTING_LOCATION"

# Run ReverseGeocode
arcpy.geocoding.ReverseGeocode(input_features, locator, reverse_output,
                               addr_type, None, feature_type, location_type)

Environnements

Système de coordonnées en sortie

Informations de licence

Basic: Oui
Standard: Oui
Advanced: Oui

Géocodage inverse (Outils de géocodage)

Résumé

Remarque :

Utilisation

Paramètres

Remarque :

Héritage :

Héritage :

Environnements

Informations de licence

Rubriques connexes