Étiquette | 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 | 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 |
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.
| String |
Type de localisation préféré (Facultatif) | Indique la géométrie en sortie privilégiée pour les appariements du champ Adresse du point. Les options de ce paramètre sont le côté d’une rue qui peut être utilisé pour le calcul d’itinéraires ou la localisation représentant le toit ou le centroïde de parcelle de l’adresse. Si la localisation préférée n’existe pas dans les données, la localisation par défaut est renvoyée à 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 dans 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.
| String |
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.
Paramètres
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 |
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.
| String |
location_type (Facultatif) | Indique la géométrie en sortie privilégiée pour les appariements du champ POINT_ADDRESS. Les options de ce paramètre sont ROUTING_LOCATION, le côté d’une rue qui peut être utilisé pour le calcul d’itinéraires ou ADDRESS_LOCATION, la localisation représentant le toit, le centroïde de parcelle de l’adresse ou la porte principale. Si la localisation préférée n’existe pas dans les données, la localisation par défaut ROUTING_LOCATION est renvoyée à 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 dans la rue, tandis que les valeurs DisplayX et DisplayY décrivent les coordonnées du toit ou du centroïde du bâtiment. Pour en savoir plus sur le paramètre locationType dans le cadre de l’opération reverseGeocode, reportez-vous à l’aide Web de l’API REST. Ce paramètre n’est pas pris en charge pour tous les localisateurs.
| String |
Exemple de code
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.loc"
result_feature_class = "customers_with_address"
arcpy.geocoding.ReverseGeocode(input_feature_class, address_locator,
result_feature_class, "ADDRESS")
Le script Python suivant 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)
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 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
Informations de licence
- Basic: Oui
- Standard: Oui
- Advanced: Oui
Rubriques connexes
Vous avez un commentaire à formuler concernant cette rubrique ?