Proche (Analyse)

ArcGIS Pro 3.4 | | Archive de l’aide

Synthèse

Calcule la distance et d’autres informations de proximité entre les entités en entrée et l’entité la plus proche dans une autre couche ou classe d’entités.

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

Illustration

Illustration de l’outil Proche
Illustration de la recherche d’entités de proximité par type de géométrie.

Utilisation

  • Les champs suivants seront ajoutés à l’entrée. Si les champs existent déjà, les valeurs de champ sont mises à jour. Ces noms de champ peuvent être configurés à l’aide du paramètre Field Names (Noms de champ).

    • NEAR_FID—ID d’objet de l’entité la plus proche. Si aucune entité en entrée n’est trouvée, la valeur est -1.
    • NEAR_DIST—Distance entre l’entrée en entrée et l’entité de proximité. La valeur est exprimée dans l’unité linéaire du système de coordonnées des entités en entrée ou en mètres si le paramètre Method (Méthode) est défini sur Geodesic (Géodésique) et que l’entrée est dans un système de coordonnées géographiques. Si aucune entité en entrée n’est trouvée, la valeur est -1.
    • NEAR_FC— chemin d’accès de la classe d’entités source qui contient l’entité la plus proche trouvée. Le nom de couche est utilisé si des couches sont utilisées en entrée et le chemin de catalogue vers la classe d’entités sera utilisé si vous utilisez des chemins en entrée. Ce champ n’est ajouté à la table en sortie que lorsque plusieurs entités de proximité sont spécifiées. Si aucune entité de proximité n’est détectée, la valeur sera une chaîne vide ou nulle.

    Les champs suivants sont ajoutés à l’entrée si le paramètre Location (Localisation) est sélectionné. Si les champs existent déjà, les valeurs de champ sont mises à jour. Les unités de valeur de champ dépendent de la valeur du paramètre Method (Méthode). Si le paramètre Method (Méthode) est défini sur Planar (Planaire), la valeur de champ est exprimée dans l’unité linéaire du système de coordonnées de l’entité en entrée. S’il est défini sur Geodesic (Géodésique), la valeur de champ est exprimée dans le système de coordonnées géographiques associé au système de coordonnées de l’entité en entrée.

    • NEAR_X—Coordonnée X de l’emplacement de l’entité de proximité la plus proche de l’entité en entrée. Si aucune entité en entrée n’est trouvée, la valeur est -1.
    • NEAR_Y—Coordonnée Y de l’emplacement de l’entité de proximité la plus proche de l’entité en entrée. Si aucune entité en entrée n’est trouvée, la valeur est -1.

    Le champ suivant est ajouté aux entités en entrée si le paramètre Angle est sélectionné. La valeur de champ est actualisée si le champ existe déjà.

    • NEAR_ANGLE—Angle de la ligne aux emplacements FROM_X et FROM_Y qui relie les entités en entrée à l’entité de proximité. Si aucune entité en entrée n’est trouvée ou si l’entité de proximité intersecte l’entité en entrée, la valeur est 0.

  • Les valeurs de NEAR_FID et NEAR_DIST sont égales à -1 si aucune entité n’est détectée dans le rayon de recherche.

  • Les entités en entrée et les entités de proximité peuvent être de type point, multi-point, ligne ou polygone.

  • La valeur du paramètre Near Features (Entités de proximité) peuvent comprendre une ou plusieurs classes d’entités ayant des types de forme différents (ponctuelle, multi-point, linéaire ou surfacique).

  • 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é. Dans ce cas, l’entité en entrée en cours d’évaluation est exclue des candidats d’entités de proximité, afin d’éviter que toutes les entités soient les plus proches d’elles-mêmes.

  • Les entités en entrée peuvent être une couche sur laquelle vous avez réalisé une sélection. Les entités sélectionnées sont utilisées et actualisées au cours de l’exécution de l’outil. Les entités restantes ont les valeurs des nouveaux champs créés (par exemple NEAR_FID et NEAR_DIST) définis sur -1.

  • Lorsque plusieurs entités de proximité présentent la même distance la plus courte jusqu’à l’entité en entrée, l’une d’elles est choisie de manière aléatoire comme entité la plus proche.

  • Lorsque vous utilisez l’option Planaire pour le paramètre Méthode, utilisez une projection pour les entités en entrée qui soit adéquate pour une mesure de distance, par exemple une projection équidistante.

    En savoir plus sur les systèmes de coordonnées et les projections

  • Pour visualiser les emplacements NEAR_X et NEAR_Y, la table en sortie peut être utilisée en tant qu’entrée pour l’outil Make XY Event Layer (Générer une couche d’événements XY) ou XY To Line (XY vers ligne).

  • Vous pouvez définir une unité de mesure pour le champ NEAR_DIST (par exemple, des mètres, des kilomètres ou des milles) à l’aide du paramètre Unité de distance.

Paramètres

ÉtiquetteExplicationType de données
Entités en entrée

Les entités en entrée peuvent être de type point, polyligne, polygone ou multi-point.

Feature Layer
Entités de proximité

Une ou plusieurs couches d'entités ou classes d'entités contenant des candidats d'entités de proximité. Les entités 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 pour les entités en entrée et les entités de proximité.

Feature Layer
Rayon de recherche
(Facultatif)

Rayon utilisé pour rechercher les entités de proximité. Si aucune valeur n’est spécifiée, toutes les entités de proximité sont prises en compte. Si une distance sans unité ou inconnue est spécifiée, les unités du système de coordonnées des entités en entrée sont utilisées. Si l’option Geodesic (Géodésique) est utilisée pour le paramètre Method (Méthode), utilisez une unité linéaire, telle que le kilomètre ou le mile.

Linear Unit
Emplacement
(Facultatif)

Spécifie si les coordonnées x et y de l’emplacement le plus proche de l’entité de proximité sont écrites dans les champs NEAR_X et NEAR_Y.

  • Non sélectionné : les emplacements ne sont pas écrits. Il s’agit de l’option par défaut.
  • Sélectionné : les emplacements sont écrits.
Boolean
Angle
(Facultatif)

Spécifie si les valeurs d’angle de proximité sont 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 à leur emplacement le plus proche. Lorsque la méthode Planar (Planaire) est utilisée pour le paramètre Method (Méthode), 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 (Géodésique) 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.

  • Désactivé : l’angle de proximité n’est pas calculé et le champ NEAR_ANGLE n’est pas ajouté. Il s’agit de l’option par défaut.
  • Activé : l’angle de proximité est calculé et le champ NEAR_ANGLE est ajouté.
Boolean
Méthode
(Facultatif)

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

  • PlanaireUne distance planaire est utilisée entre les entités. Il s’agit de l’option par défaut.
  • GéodésiqueLa distance géodésique sera utilisée entre les entités. Cette méthode tient compte de la courbure du sphéroïde et gère correctement les données situées de la ligne de changement de date et près des pôles.
String
Noms de champs
(Facultatif)

Noms des champs attributaires qui vont être ajoutés pendant le traitement.

Si ce paramètre n’est pas utilisé ou si des champs allant être ajoutés sont exclus de ce paramètre, les noms de champ par défaut sont utilisés.

Par défaut, les champs NEAR_FID et NEAR_DISTsont ajoutés, les champs NEAR_X et NEAR_Y sont ajoutés lorsque le paramètre Location (Localisation) est activé, le champ NEAR_ANGLE est ajouté lorsque le paramètre Angle est activé et le champ NEAR_FC est ajouté lorsque plusieurs entrées sont utilisées.

Value Table
Unité de distance
(Facultatif)

Indique l’unité de mesure du champ NEAR_DIST. Si aucune unité de mesure n’est spécifiée, les valeurs dans le champ NEAR_DIST sont exprimées dans l’unité linéaire du système de coordonnées de l’entité en entrée. Si l’entrée est exprimée dans un système de coordonnées géographiques et que la méthode géodésique est utilisée, les unités du champ NEAR_DIST sont les mètres.

  • KilomètresLes kilomètres sont l’unité.
  • MètresLes mètres sont l’unité.
  • Milles nautiques internationauxL’unité est le mille nautique international.
  • Milles terrestresL’unité est le mille terrestre.
  • Yards internationauxL’unité est le yard international.
  • Pieds internationauxL’unité est le pied international.
  • Milles nautiques d’arpentage américainsL’unité est le mille nautique d’arpentage américain.
  • Miles d’arpentage américainsL’unité est le mille d’arpentage américain.
  • Yards d’arpentage américainsL’unité est le yard d’arpentage américain.
  • Pieds d’arpentage américainsL’unité est le pied d’arpentage américain.
String

Sortie obtenue

ÉtiquetteExplicationType de données
Entités en entrée mises à jour

Entités en entrée mises à jour.

Feature Layer

Informations de licence

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

Rubriques connexes