ArcGIS Desktop

  • ArcGIS Pro
  • ArcMap

  • My Profile
  • Aide
  • Sign Out
ArcGIS Desktop

ArcGIS Online

La plateforme cartographique de votre organisation

ArcGIS Desktop

Un SIG professionnel complet

ArcGIS Enterprise

SIG dans votre entreprise

ArcGIS for Developers

Outils de création d'applications de localisation

ArcGIS Solutions

Modèles d'applications et de cartes gratuits pour votre secteur d'activité

ArcGIS Marketplace

Téléchargez des applications et des données pour votre organisation.

  • Documentation
  • Support
Esri
  • Se connecter
user
  • Mon profil
  • Déconnexion

ArcMap

  • Accueil
  • Commencer
  • Carte
  • Analyser
  • Gérer les données
  • Outils
  • Extensions

Sélectionner une couche par emplacement

  • Résumé
  • Utilisation
  • Syntaxe
  • Exemple de code
  • Environnements
  • Informations de licence

Résumé

Sélectionne des entités dans une couche en fonction de leur relation spatiale avec les entités d'une autre couche.

Chaque entité de la Couche d'entités en entrée est évaluée par rapport aux entités de la Couche de sélection ou de la classe d'entités ; si la Relation répond aux critères définis, l'entité en entrée est sélectionnée.

Exemples graphiques de relations

Utilisation

  • L'entrée doit être un couche d'entités ; il ne peut s'agit d'une classe d'entités.

  • Cet outil fonctionne sur les couches dans ArcMap, ArcGlobe ou ArcScene, ainsi que sur les couches créées dans des modèles et des scripts à l'aide de l'outil Générer une couche.

  • Le système de coordonnées dans lequel la relation spatiale est évaluée peut affecter le résultat. Les entités qui intersectent dans un système de coordonnées peuvent ou non intersecter une autre.

    • Cet outil permet d'évaluer une relation spatiale dans le système de coordonnées de la source de données de la Couche d'entités en entrée (classe d'entités sur le disque). Définissez l'environnement du système de coordonnées en sortie pour évaluer la relation spatiale dans un autre système de coordonnées.

  • Cet outil permet de sélectionner des entités en fonction de leurs relations spatiales avec d'autres entités dans la même couche. Pour consulter des exemples, reportez-vous à Sélectionner selon l'emplacement : sélectionner en fonction d'une relation spatiale dans la couche.

  • L'outil Compter permet de recherche le nombre d'entités sélectionnées par l'outil Sélectionner une couche par emplacement. Cela peut être utile pour déterminer si des entités correspondent à la relation spatiale souhaitée avant de procéder à une analyse supplémentaire dans le cadre d'un workflow automatisé (c'est-à-dire, un script ou un modèle).

  • Pour plus d'informations sur l'utilisation des relations spatiales tridimensionnelles INTERSECT_3D et WITHIN_A_DISTANCE_3D, reportez-vous à la rubrique Sélectionner selon l'emplacement et relations 3D.

Syntaxe

SelectLayerByLocation_management (in_layer, {overlap_type}, {select_features}, {search_distance}, {selection_type}, {invert_spatial_relationship})
ParamètreExplicationType de données
in_layer

Couche contenant les entités qui seront évaluées par rapport à la select_features. La sélection sera appliquée à cette couche. L'entrée ne peut pas être le chemin d'accès à une classe d'entités sur le disque.

Feature Layer; Mosaic Layer; Raster Catalog Layer
overlap_type
(Facultatif)

Relation spatiale à évaluer.

  • INTERSECT —Les entités de la couche en entrée sont sélectionnées si elles intersectent une entité de la couche de sélection. Il s'agit de l'option par défaut.
  • INTERSECT_3D —Les entités dans la couche en entrée sont sélectionnées si elles intersectent une entité de la couche de sélection dans un espace tridimensionnel (x, y et z).
  • WITHIN_A_DISTANCE —Les entités de la couche en entrée sont sélectionnées si elles se trouvent à une distance donnée d'une entité de la couche de sélection. Indiquez une distance dans le paramètre Distance de recherche.
  • WITHIN_A_DISTANCE_3D —Les entités de la couche en entrée sont sélectionnées si elles se trouvent à une distance donnée d'une entité de la couche de sélection dans un espace tridimensionnel. Indiquez une distance dans le paramètre Distance de recherche.
  • WITHIN_A_DISTANCE_GEODESIC —Les entités de la couche en entrée sont sélectionnées si elles se trouvent à une distance donnée d'une entité de la couche de sélection. La distance entre les entités sera calculée à l'aide de la méthode géodésique qui prend en compte la courbure de la Terre et gère correctement les données situées près de la ligne de changement de jour et des pôles.
  • CONTAINS —Les entités de la couche en entrée sont sélectionnées si elles contiennent une entité de la couche de sélection.
  • COMPLETELY_CONTAINS —Les entités de la couche en entrée sont sélectionnées si elles contiennent complètement une entité de la couche de sélection.
  • CONTAINS_CLEMENTINI —Cette relation spatiale renvoie les mêmes résultats que COMPLETELY_CONTAINS, excepté que si la couche de sélection se trouve entièrement à la limite de l'entité en entrée (sans aucune partie véritablement à l'intérieur ou à l'extérieur), l'entité n'est pas sélectionnée. Clementini définit le polygone de limite comme la ligne qui sépare l'intérieur et l'extérieur ; la limite d'une ligne est définie par ses extrémités et la limite d'un point est toujours vide.
  • WITHIN —Les entités de la couche en entrée sont sélectionnées si elles se trouvent dans une entité de la couche de sélection.
  • COMPLETELY_WITHIN —Les entités de la couche en entrée sont sélectionnées si elles se trouvent complètement dans ou sont contenues par les entités de la couche de sélection.
  • WITHIN_CLEMENTINI —Le résultat est identique à celui obtenu avec WITHIN, excepté que si la totalité de l'entité dans la couche en entrée est à la limite de l'entité dans la couche de sélection, l'entité n'est pas sélectionnée. Clementini définit le polygone de limite comme la ligne qui sépare l'intérieur et l'extérieur ; la limite d'une ligne est définie par ses extrémités et la limite d'un point est toujours vide.
  • ARE_IDENTICAL_TO —Les entités de la ou des couches en entrée sont sélectionnées si elles sont identiques (en géométrie) à une entité de la couche de sélection.
  • BOUNDARY_TOUCHES —Les entités de la couche en entrée sont sélectionnées si une de leurs limites touche une entité de la couche de sélection. Lorsque les entités en entrée sont des lignes ou des polygones, la limite de l'entité en entrée ne peut toucher que la limite de l'entité sélectionnée, et aucune partie de l'entité en entrée ne peut traverser la limite de l'entité sélectionnée.
  • SHARE_A_LINE_SEGMENT_WITH —Les entités de la couche en entrée sont sélectionnées si elles partagent un segment de ligne avec une entité de la couche de sélection. Les entités de la couche en entrée et de la couche de sélection doivent être des lignes ou des polygones.
  • CROSSED_BY_THE_OUTLINE_OF —Les entités de la ou des couches en entrée sont sélectionnées si elles sont croisées par le contour d'une entité de la couche de sélection. Les entrées et les entités de la couche de sélection doivent être des lignes ou des polygones. Si des polygones sont utilisés pour la couche en entrée ou la couche de sélection, la limite (ligne) du polygone sera utilisée. Les lignes qui se croisent au niveau d'un point sont sélectionnées, contrairement à celles qui partagent un segment de ligne.
  • HAVE_THEIR_CENTER_IN —Les entités de la couche en entrée sont sélectionnées si leur centre se trouve dans une entité de la couche de sélection. Le centre de l'entité est calculé comme suit : pour les polygones et multi-points, c'est le centroïde de la géométrie qui est utilisé et pour les lignes en entrée, le centre de la géométrie.
String
select_features
(Facultatif)

Les entités de la couche d'entités en entrée sont sélectionnées en fonction de leur relation avec les entités de cette couche ou classe d'entités.

Feature Layer
search_distance
(Facultatif)

Ce paramètre est valide uniquement si le paramètre overlap_type est défini sur l'une des valeurs suivantes : WITHIN_A_DISTANCE_GEODESIC, WITHIN_A_DISTANCE, WITHIN_A_DISTANCE_3D, INTERSECT, INTERSECT_3D, HAVE_THEIR_CENTER_IN, CONTAINS, ou WITHIN.

Si l'option WITHIN_A_DISTANCE_GEODESIC est utilisée, vous devez utiliser une unité linéaire telle que le kilomètre ou le mètre.

Linear unit
selection_type
(Facultatif)

Détermine comment la sélection sera appliquée à l'entrée et comment la combiner avec une sélection existante. Notez qu'aucune option n'est disponible ici pour désactiver une sélection existante. Pour désactiver une sélection, utilisez l'option CLEAR_SELECTION de l'outil Sélectionner une couche par attributs.

  • NEW_SELECTION —La sélection obtenue remplace toute sélection existante. Il s'agit de l'option par défaut.
  • ADD_TO_SELECTION —La sélection obtenue est ajoutée à l'éventuelle sélection existante. S'il n'existe aucune sélection, elle est identique à celle de l'option NEW_SELECTION.
  • REMOVE_FROM_SELECTION —La sélection obtenue est supprimée d'une sélection existante. Si aucune sélection n'existe, l'opération n'aura aucun effet.
  • SUBSET_SELECTION —La sélection obtenue est associée à la sélection existante. Seuls les enregistrements communs aux deux restent sélectionnés.
  • SWITCH_SELECTION —Inverse la sélection. Tous les enregistrements qui étaient sélectionnés sont supprimés de la sélection. Tous les enregistrements qui n'étaient pas sélectionnés sont ajoutés à la sélection. Les paramètres select_features et overlap_type sont ignorés lorsque cette option est sélectionnée.
String
invert_spatial_relationship
(Facultatif)

Une fois la relation spatiale évaluée, cette option détermine si le résultat doit être utilisé en l'état ou inversé. Par exemple, cette option peut servir à obtenir rapidement une liste des entités qui ne s'intersectent pas ou ne se trouvent pas à une certaine distance des entités d'un autre jeu de données.

  • NOT_INVERT —Le résultat de la requête ne sera pas inversé. Il s'agit de l'option par défaut.
  • INVERT —Le résultat de la requête sera inversé. Si une option selection_type est utilisée, l'inversion se produit avant que la sélection ne soit associée aux sélections existantes.
Boolean

Sortie dérivée

NomExplicationType de données
out_layer_or_view

Exemple de code

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

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

import arcpy

# First, make a layer from the feature class
arcpy.MakeFeatureLayer_management("c:/kamsack.gdb/parcel", "parcel_lyr")

# Then add a selection to the layer based on location to features in another feature class 
arcpy.SelectLayerByLocation_management ("parcel_lyr", "have_their_center_in", "c:/kamsack.gdb/city_limits")
Exemple 2 d'utilisation de l'outil SelectLayerByLocation (script autonome)

Le script autonome suivant indique comment utiliser la fonction SelectLayerByLocation dans un workflow permettant d'extraire des entités vers une nouvelle classe d'entités en fonction d'un emplacement et une requête attributaire.

# Name: ExtactFeaturesByLocationAndAttribute.py
# Description: Extract features to a new feature class based on a Location and an attribute query

# Import arcpy and set path to data
import arcpy
arcpy.env.workspace = "c:/data/mexico.gdb"

# Make a layer and select cities which overlap the chihuahua polygon
arcpy.MakeFeatureLayer_management('cities', 'cities_lyr') 
arcpy.SelectLayerByLocation_management('cities_lyr', 'intersect', 'chihuahua')
 
# Within the previous selection sub-select cities which have population > 10,000
arcpy.SelectLayerByAttribute_management('cities_lyr', 
                                        'SUBSET_SELECTION', 
                                        '"population" > 10000')

# If features matched criteria write them to a new feature class
matchcount = int(arcpy.GetCount_management('cities_lyr')[0]) 
if matchcount == 0:
    print('no features matched spatial and attribute criteria')
else:
    arcpy.CopyFeatures_management('cities_lyr', 'chihuahua_10000plus')
    print('{0} cities that matched criteria written to {0}'.format(
                                                  matchcount, chihuahua_10000plus))

Environnements

  • Espace de travail courant
  • Système de coordonnées en sortie

Informations de licence

  • ArcGIS Desktop Basic: Oui
  • ArcGIS Desktop Standard: Oui
  • ArcGIS Desktop Advanced: Oui

Rubriques connexes

  • Vue d'ensemble du jeu d'outils Couches et vues tabulaires
  • Utilisation des couches et des vues tabulaires
  • Utilisation des couches et des vues tabulaires
  • Création et utilisation de sélections de couches
  • utilisation de Sélectionner selon l'emplacement (boîte de dialogue ArcMap)

ArcGIS Desktop

  • Accueil
  • Documentation
  • Support

ArcGIS Platform

  • ArcGIS Online
  • ArcGIS Desktop
  • ArcGIS Enterprise
  • ArcGIS for Developers
  • ArcGIS Solutions
  • ArcGIS Marketplace

A propos d'Esri

  • A propos de la société
  • Carrières
  • Blog d’Esri
  • Conférence des utilisateurs
  • Sommet des développeurs
Esri
Donnez-nous votre avis.
Copyright © 2019 Esri. | Confidentialité | Légal