Géocodage inverse (Géocodage)

Synthèse

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 le plus proche pour la localisation ponctuelle, d’après les valeurs de distance optimisées pour les localisateurs créés avec l’outil Créer un localisateur.

Pour réaliser des opérations de géocodage à l’aide de 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 disponible en haut de l’outil lorsque 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 correspondant est introuvable, les champs contiennent 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, 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 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 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.

  • Un abonnement à ArcGIS Online for organizations est nécessaire pour procéder au 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.

Paramètres

ÉtiquetteExplicationType 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

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, des 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é
(Facultatif)

Indique les types d’appariement possibles renvoyés. Une valeur unique ou plusieurs valeurs peuvent être sélectionnées. Si vous sélectionnez 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. Pour plus d’informations sur le paramètre Type d’entité pour le géocodage inverse, reportez-vous à la rubrique Types d’entités.

Ce paramètre n’est pas pris en charge pour tous les localisateurs.

  • Sous-adresseL’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 pointL’appariement est limité à une adresse reposant sur des points qui représentent les emplacements de domiciles et de bâtiments.
  • ParcelleL’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. Ce type d’appariement est généralement associé à une adresse et à un numéro d’identification de parcelle.
  • AdresseL’appariement est limité à une adresse qui diffère de l’adresse du point car le numéro de maison est interpolé à partir d’une plage de numéros. Les correspondances du champ Adresse incluent la plage de numéros de maison pour le segment de rue correspondant, plutôt que la valeur interpolée du numéro de maison.
  • Intersection de rueL’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 Adresse (par exemple, Redlands Blvd & New York St, Redlands, CA, 92373).
  • Nom de rueL’appariement est limité à une adresse postale similaire à Adresse, 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é.
  • PostalL’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êtL’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 distanceL’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 de localisation préféré
(Facultatif)

Indique la géométrie en sortie privilégiée à renvoyer pour les appariements du champ Adresse du point. Les options de ce paramètre sont une localisation côté rue pouvant être utilisée pour le calcul d’itinéraire ou la localisation qui représente le centroïde de toit ou de parcelle de l’adresse. Si l’emplacement favori n’existe pas dans les données, l’emplacement par défaut est renvoyé. Pour les résultats de géocodage avec Addr_type=PointAddress, les valeurs attributaires x,y décrivent les coordonnées de l’adresse le long de la rue, tandis que les valeurs DisplayX et DisplayY décrivent les coordonnées du toit ou du centroïde du bâtiment.

Ce paramètre n’est pas pris en charge pour tous les localisateurs.

  • Localisation d’adresseLa géométrie des résultats de géocodage qui représentent une localisation d’adresse, telle qu’un toit, un centroïde de bâtiment ou une porte principale, est renvoyée.
  • Localisation d’itinéraireLa 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é. Il s’agit de l’option par défaut.
String

arcpy.geocoding.ReverseGeocode(in_features, in_address_locator, out_feature_class, {address_type}, {search_distance}, {feature_type}, {location_type})
NomExplicationType 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, des 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 sélectionnées. Si vous sélectionnez 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. Pour plus d’informations sur le paramètre feature_type pour le géocodage inverse, reportez-vous à la rubrique Types d’entités.

Ce paramètre n’est pas pris en charge pour tous les localisateurs.

  • SUBADDRESSL’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_ADDRESSL’appariement est limité à une adresse reposant sur des points qui représentent les emplacements de domiciles et de bâtiments.
  • PARCELL’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. Ce type d’appariement est généralement associé à une adresse et à un numéro d’identification de parcelle.
  • STREET_ADDRESSL’appariement est limité à une adresse qui diffère de POINT_ADDRESS car le numéro de maison est interpolé à partir d’une plage de numéros. Les correspondances du champ STREET_ADDRESS incluent la plage de numéros de maison pour le segment de rue correspondant, plutôt que la valeur interpolée du numéro de maison.
  • STREET_INTERSECTIONL’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_NAMEL’appariement est limité à une adresse postale similaire à STREET_ADDRESS, 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).
  • LOCALITYL’appariement est limité à un nom de lieu représentant un lieu habité.
  • POSTALL’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_INTERESTL’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_MARKERL’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 de votre choix allant être renvoyée pour les correspondances POINT_ADDRESS. Les options de ce paramètre sont ROUTING_LOCATION, ce qui correspond au côté d’une rue qui peut être utilisé pour le calcul de l’itinéraire ou ADDRESS_LOCATION, c’est-à-dire l’emplacement représentant le toit, le centroïde de parcelle de l’adresse ou la porte principale. Si l’emplacement favori n’existe pas dans les données, l’emplacement par défaut ROUTING_LOCATION est renvoyé. Pour les résultats de géocodage avec Addr_type=PointAddress, les valeurs attributaires x,y décrivent les coordonnées de l’adresse le long de la rue, tandis que les valeurs DisplayX et DisplayY décrivent les coordonnées du toit ou du centroïde du bâtiment. Voir l’aide Web de l’API REST pour en savoir plus sur le paramètre locationType dans le cadre de l’opération reverseGeocode.

Ce paramètre n’est pas pris en charge pour tous les localisateurs.

  • ADDRESS_LOCATIONLa géométrie des résultats de géocodage qui représentent une localisation d’adresse, telle qu’un toit, un centroïde de bâtiment ou une porte principale, est renvoyée.
  • ROUTING_LOCATIONLa géométrie des résultats de géocodage représentant une localisation proche du côté de la rue et pouvant servir dans le cadre du calcul d’itinéraire est renvoyée. Il s’agit de l’option par défaut.
String

Exemple de code

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

Le script ci-dessous pour la fenêtre Python montre comment utiliser 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-dessous 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 ci-dessous 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 AllSource. 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)