Géocodage inverse (Géocodage)

Synthèse

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 de ArcGIS World Geocoding Service, cette opération peut consommer des crédits.

Pour réaliser des opérations de géocodage à l’aide de ArcGIS World Geocoding Service, vous avez besoin d’un abonnement d’organisation ArcGIS Online 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.

Utilisation

  • La classe d'entités en entrée doit contenir des formes de points dotées de coordonnées x,y valides. Les résultats ne sont pas retournés 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 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 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. 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 en 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é.

  • Un abonnement à ArcGIS Online for organizations est nécessaire pour inverser le géocodage d’une classe d’entités à l’aide de ArcGIS World Geocoding Service.

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 sont retournés, d’après l’emplacement des points 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.

Feature Class
Type d’adresse en sortie
(Facultatif)

Indique si les adresses des points sont renvoyées sous forme d’adresses de rues ou d’adresses d’intersections si le localisateur prend en charge l’appariement d’intersections.

  • AdresseLes adresses sont retournées sous forme d’adresses de rues ou au format défini par le localisateur d’adresses en entrée. Il s’agit de l’option par défaut.
  • IntersectionLes adresses sont retournées sous forme d’adresses d’intersections. Cette option est disponible si le localisateur d'adresses prend en charge l'appariement d'adresses d'intersection.
Héritage :

Ce paramètre ne concerne que les localisateurs créés avec l’outil Créer un localisateur d’adresses ou les localisateurs composites contenant des localisateurs créés avec l’outil Créer un localisateur d’adresses.

String
Distance de recherche

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.

Héritage :

Ce paramètre ne concerne que les localisateurs créés avec l’outil Créer un localisateur d’adresses ou les localisateurs composites contenant des localisateurs créés avec l’outil Créer un localisateur d’adresses.

Linear Unit
Type d'entités
(Facultatif)

Indique les types d’appariement possibles renvoyés. Une value 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, alors les distances de recherche spécifiées dans la table hiérarchique du type d’entité s’appliquent.

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.
  • 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ée à 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 Street Address (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 des informations facultatives sur l’état et le code postal. Celles-ci découlent des données de référence Street Address (Adresse), par exemple, Redlands Blvd & New York St, Redlands, CA, 92373.
  • Nom de rueL’appariement est limité à une adresse similaire à l’Adresse postale mais sans les numéros de maison, ainsi que des 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 un emplacement d’origine désigné, par exemple, Mile 25 I-5 N, San Diego, CA.
String
Type d’emplacement préféré
(Facultatif)

Indique la géométrie en sortie privilégiée pour les appariements du champ Point Address (Adresse de point). 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. 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.

  • Emplacement d’adresseLa géométrie des résultats de géocodage qui représentent un emplacement d’adresse, tel que le toit, le centroïde de bâtiment ou la porte principale, est renvoyée.
  • Emplacement 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ée. 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 sont retournés, d’après l’emplacement des points 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.

Feature Class
address_type
(Facultatif)

Indique si les adresses des points sont renvoyées sous forme d’adresses de rues ou d’adresses d’intersections si le localisateur prend en charge l’appariement d’intersections.

Héritage :

Ce paramètre ne concerne que les localisateurs créés avec l’outil Créer un localisateur d’adresses ou les localisateurs composites contenant des localisateurs créés avec l’outil Créer un localisateur d’adresses.

  • ADDRESSLes adresses sont retournées sous forme d’adresses de rues ou au format défini par le localisateur d’adresses en entrée. Il s’agit de l’option par défaut.
  • INTERSECTIONLes adresses sont retournées sous forme d’adresses d’intersections. Cette option est disponible si le localisateur d'adresses prend en charge l'appariement d'adresses d'intersection.
String
search_distance

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.

Héritage :

Ce paramètre ne concerne que les localisateurs créés avec l’outil Créer un localisateur d’adresses ou les localisateurs composites contenant des localisateurs créés avec l’outil Créer un localisateur d’adresses.

Linear Unit
feature_type
[feature_type,...]
(Facultatif)

Indique les types d’appariement possibles renvoyés. Une value 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, alors les distances de recherche spécifiées dans la table hiérarchique du type d’entité s’appliquent. Consultez l’aide Web de l’API REST pour en savoir plus sur le paramètre featureTypes dans le cadre de l’opération reverseGeocode.

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.
  • 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ée à 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 appariements de STREET_ADDRESS incluent la plage de numéros de maisons 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 des 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 similaire à STREET_ADDRESS mais sans les numéros de maison, ainsi que des 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 un emplacement d’origine désigné, par exemple, Mile 25 I-5 N, San Diego, CA.
String
location_type
(Facultatif)

Indique la géométrie en sortie privilégiée pour les correspondances POINT_ADDRESS. Les options de ce paramètre sont ROUTING_LOCATION, le côté d’une rue qui peut être utilisé pour le calcul de l’itinéraire ou ADDRESS_LOCATION, l’emplacement représentant le toit, le centroïde de parcelle de l’adresse ou la porte principale. Si l’emplacement privilégié n’existe pas dans les données, l’emplacement par défaut ROUTING_LOCATION est renvoyé à la place. 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. Consultez 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 un emplacement d’adresse, tel que le toit, le centroïde de bâtiment ou la porte principale, est renvoyée.
  • ROUTING_LOCATIONLa 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ée. Il s’agit de l’option par défaut.
String

Exemple de code

Exemple d’utilisation de l'outil ReverseGeocode (fenêtre Python)

Le script ci-dessous pour la fenêtre Python 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"
result_feature_class = "customers_with_address"

arcpy.ReverseGeocode_geocoding(input_feature_class, address_locator, 
                               result_feature_class, "ADDRESS")
Exemple d’utilisation de l’outil ReverseGeocode (script autonome)

Le script Python ci-dessous illustre l’utilisation de l’outil 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"

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

Environnements

Cas particuliers

Informations de licence

  • Basic: Oui
  • Standard: Oui
  • Advanced: Oui

Rubriques connexes