É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 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.
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.
| 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.
| String |
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, l’emplacement ou l’intersection le plus proche pour l’emplacement de point, d’après les valeurs de distance optimisées pour les localisateurs créés avec l’outil Créer un localisateur.
Remarque :
Les localisateurs créés avec d’anciens outils ne sont pas optimisés de la même manière et utilisent la valeur par défaut 100 pour la distance. Pour obtenir des résultats optimaux, mettez à jour les localisateurs créés avec d’anciens outils et créez-les 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.
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 pour les organisations est nécessaire pour inverser le géocodage d’une classe d’entités à l’aide de 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 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.
| 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.
| 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.
| 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.ReverseGeocode_geocoding(input_feature_class, address_locator,
result_feature_class, "ADDRESS")
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"
# Execute 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"
# Execute ReverseGeocode
arcpy.geocoding.ReverseGeocode(input_features, locator, reverse_output,
addr_type, None, feature_type, location_type)
Informations de licence
- Basic: Oui
- Standard: Oui
- Advanced: Oui
Rubriques connexes
Vous avez un commentaire à formuler concernant cette rubrique ?