Générer la table de proximité (Analyse)

Niveau de licence :BasicStandardAdvanced

Récapitulatif

Calcule les distances et autres informations de proximité entre les entités dans une ou plusieurs classes d'entités ou couche. À la différence de l'outil Proche, qui modifie l'entrée, Générer la table de proximité écrit les résultats dans une nouvelle table autonome et permet de rechercher plusieurs entités.

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

Illustration

Générer la table de proximité

Utilisation

Syntaxe

GenerateNearTable_analysis (in_features, near_features, out_table, {search_radius}, {location}, {angle}, {closest}, {closest_count}, {method})
ParamètreExplicationType de données
in_features

Entités en entrée qui peuvent être de type point, polyligne, polygone ou multi-points.

Feature Layer
near_features
[near_features,...]

Une ou plusieurs couches ou classes d'entités contenant des candidats d'entités de proximité. Les entités en entrée de proximité peuvent être de type point, polyligne, polygone ou multi-points. Si plusieurs couches ou classes d'entités sont spécifiées, un champ nommé NEAR_FC est ajouté à la table en entrée pour stocker les chemins de la classe d'entités source contenant l'entité la plus proche trouvée. La même classe d'entités ou couche peut être utilisée à la fois sur des entités en entrée et de proximité.

Feature Layer
out_table

Table en sortie contenant le résultat de l'analyse.

Table
search_radius
(Facultatif)

Rayon utilisé pour rechercher les entités de proximité. Si aucun valeur n'est spécifiée, toutes les entités de proximité sont candidates. Si une distance est saisie, mais que l'unité est laissée vide ou définie comme étant inconnue, les unités du système de coordonnées des entités en entrée sont utilisées. Si l'option GEODESIC est utilisée dans le paramètre Method, vous devez utiliser une unité linéaire telle que le kilomètre ou le mètre.

Linear unit
location
(Facultatif)

Spécifie si les coordonnées x et y de l'emplacement de l'entité en entrée et de l'emplacement le plus proche de l'entité de proximité sont écrites dans les champs FROM_X, FROM_Y, NEAR_X et NEAR_Y.

  • NO_LOCATION — Les emplacements ne sont pas écrits dans la table en sortie. Il s'agit de l'option par défaut.
  • LOCATION — Les emplacements sont écrits dans la table en sortie.
Boolean
angle
(Facultatif)

Spécifie si les valeurs d'angle de proximité seront calculées et écrites dans un champ NEAR_ANGLE dans la table en sortie. Un angle de proximité mesure la direction de la ligne qui connecte une entité en entrée avec son entité la plus proche à leurs emplacements les plus proches. Lorsque la méthode PLANAR est utilisée dans le paramètre method, l'angle se situe dans la plage -180° à 180°, avec 0° à l'est, 90° au nord, 180° (ou -180°) à l'ouest et -90° au sud. Lorsque la méthode GEODESIC est utilisée, l'angle se situe dans la plage -180° à 180°, avec 0° au nord, 90° à l'est, 180° (ou -180°) au sud et -90° à l'ouest.

  • NO_ANGLE —La valeur NEAR_ANGLE n'est pas ajoutée à la table en sortie. Il s'agit de l'option par défaut.
  • ANGLE —La valeur NEAR_ANGLE est ajoutée à la table en sortie.
Boolean
closest
(Facultatif)

Indique si les entités les plus proches ou plusieurs entités uniquement doivent être retournées.

  • CLOSEST —Seul l'emplacement de l'entité la plus proche est écrit dans la table en sortie. Il s'agit de l'option par défaut.
  • ALL —Plusieurs entités de proximité sont écrites dans la table en sortie (vous pouvez préciser une limite dans le paramètre closest_count).
Boolean
closest_count
(Facultatif)

Limitez le nombre d'entités de proximité signalées pour chaque entité en entrée. Ce paramètre est ignoré si le paramètre closest est défini sur CLOSEST.

Long
method
(Facultatif)

Détermine s'il convient d'utiliser un plus court chemin sur une sphéroïde (géodésique) ou une terre plate (plane). Il est fortement conseillé d'utiliser la méthode GEODESIC avec des données stockées dans un système de coordonnées non approprié pour les mesures de distance (par exemple, Web Mercator et tout système de coordonnées géographiques) ou tout jeu de données couvrant une zone géographique importante.

  • PLANAR —Utilise des distances planes entre les entités. Il s'agit de l'option par défaut.
  • GEODESIC —Utilise des distances géodésiques entre les entités. Cette méthode tient compte de la courbure de la sphéroïde et gère correctement les données situées près de la ligne de changement de jour et des pôles.
String

Exemple de code

1er exemple d'utilisation de l'outil GenerateNearTable (fenêtre Python)

Voici une utilisation de la fonction GenerateNearTable dans la fenêtre Python.

import arcpy

arcpy.env.workspace = "C:/data/input/gnt.gdb"

arcpy.GenerateNearTable_analysis("campsites", ["parks", "trails"], "better_sites")
2e exemple d'utilisation de l'outil GenerateNearTable (script Python autonome)

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

# Name: GenerateNearTable.py
# Description: Finds 3 nearest in the near feature class from the input feature class.


# import system modules
import arcpy

# set workspace environment
arcpy.env.workspace = "C:/data/input/gnt.gdb"

# set required parameters 
in_features = "campsites"
near_features = ["parks", "trails"]
out_table = "near_parks_trails"

# optional parameters
search_radius = '1500 Meters'
location = 'NO_LOCATION'
angle = 'NO_ANGLE'
closest = 'ALL'
closest_count = 3

# find crime locations within the search radius
arcpy.GenerateNearTable_analysis(in_features, near_features, out_table, search_radius, 
                                 location, angle, closest, closest_count)

Environnements

Thèmes connexes

Vue d'ensemble du jeu d'outils Proximité

Informations de licence

ArcGIS for Desktop Basic: Annuler
ArcGIS for Desktop Standard: Annuler
ArcGIS for Desktop Advanced: Oui
Copyright © 1995-2014 Esri. All rights reserved.
5/10/2014