Distance entre les points (Analyse)

Niveau de licence :BasicStandardAdvanced

Récapitulatif

Détermine les distances entre les entités ponctuelles en entrée et tous les points des entités de proximité, dans un rayon de recherche spécifié.

Pour en savoir plus sur le calcul de la proximité dans les outils de géotraitement

Illustration

Illustration de l'outil Distance entre les points

Utilisation

Syntaxe

PointDistance_analysis (in_features, near_features, out_table, {search_radius})
ParamètreExplicationType de données
in_features

Entités ponctuelles de départ du calcul des distances jusqu'aux entités de proximité.

Feature Layer
near_features

Points d'arrivée du calcul des distances à partir des entités en entrée. Les distances entre les points compris dans une même couche ou classe d'entités peuvent être déterminées en spécifiant la même couche ou classe d'entités pour les entités en entrée et les entités de proximité.

Feature Layer
out_table

Table contenant la liste des entités en entrée et des informations sur toutes les entités de proximité dans le rayon de recherche. Si aucun rayon de recherche n'est spécifié, les distances séparant toutes les entités en entrée et celles de proximité sont calculées.

Table
search_radius
(Facultatif)

Spécifie le rayon utilisé pour rechercher les entités de proximité candidates. Les entités de proximité dans ce rayon sont prises en compte pour le calcul de l'entité la plus proche. Si aucune valeur n'est spécifiée, autrement dit si le rayon par défaut (vide) est utilisé, toutes les entités de proximité sont prises en compte dans le calcul. Par défaut, l'unité du rayon de recherche correspond aux unités des entités en entrée. Vous pouvez changer les unités. Par défaut, cela n'a aucun impact sur les unités du champ DISTANCE qui est basé sur les unités du système de coordonnées des entités en entrée.

Linear unit

Exemple de code

Exemple 1 d'utilisation de l'outil PointDistance (fenêtre Python)

Le script de fenêtre interactive Python ci-dessous illustre l'utilisation de la fonction PointDistance en mode immédiat.

import arcpy
arcpy.env.workspace = "C:/data/pointdistance.gdb"
  
arcpy.PointDistance_analysis("police_stations", "crime_location", "crime_distances")
Exemple 2 d'utilisation de l'outil PointDistance (script Python autonome)

Le script Python ci-dessous illustre l'utilisation de la fonction PointDistance dans un script autonome.

# Description: Finds distance of each near point from each input point and outputs to a table.
  
# import system modules
import arcpy
  
# set workspace environment
arcpy.env.workspace = "C:/data/pointdistance.gdb"
  
# set variables
in_features = "police_stations"
near_features = "crime_location"
out_table = "crime_distance4"
search_radius = "22000 Feet"
  
try:
    # find crime locations within the search radius
    arcpy.PointDistance_analysis(in_features, near_features, out_table, search_radius)
    print arcpy.GetMessages(0)
    
except arcpy.ExecuteError:
    print arcpy.GetMessages(2)
    
except Exception as ex:
    print ex.args[0]

Environnements

Thèmes connexes

Informations de licence

ArcGIS for Desktop Basic: Annuler
ArcGIS for Desktop Standard: Annuler
ArcGIS for Desktop Advanced: Oui
5/10/2014