Rechercher les localisations à proximité (Business Analyst)

Disponible avec une licence Business Analyst.

Synthèse

Identifier les localisations les plus proches des entités en entrée selon le type de distance sélectionné. Le nombre de points dans la sortie est défini en limitant le nombre ou le pourcentage de points de localisation à renvoyer ou en limitant la distance par rapport aux points en entrée.

Utilisation

• La valeur du paramètre Entités en entrée doit être une classe d’entités ponctuelles. Les entités en entrée sont les sites que vous analysez, par exemple des points de vente ou des bâtiments.

• La valeur du paramètre Points de localisation doit être une classe d’entités ponctuelles. Les points de localisation sont toutes les localisations les plus proches qui seront utilisées par l’outil pour les calculs.

• Le paramètre Classe d’entités en sortie contient tous les attributs des paramètres Entités en entrée et Points de localisation, ainsi que les champs calculés contenant les valeurs de distance et de direction.

• Pour créer un rapport, cochez le paramètre Créer un rapport.

Paramètres

Boîte de dialogue

Étiquette	Explication	Type de données
Entités en entrée	Couche ponctuelle à mesurer depuis ou vers les Points de localisation.	Feature Layer
Champ d’ID	Champ contenant les identifiants uniques de chaque entité en entrée.	Field
Points de localisation	Couche qui sera utilisée pour générer la sortie avec les attributs de distance et de direction depuis ou vers les Entités en entrée.	Feature Layer
Classe d’entités en sortie	Entités de points de localisation en sortie.	Feature Class
Type de distance (Facultatif)	Distance calculée en fonction de la méthode de déplacement. Ligne droite est la valeur par défaut.	String
Unités de distance (Facultatif)	Unités de mesure, de la distance ou du temps, utilisées pour calculer les localisations à proximité.	String
Limite de distance (Facultatif)	Étendue d’analyse mesurée en distance ou temps.	Double
Limite de nombre de localisations	Limite numérique de la valeur Points de localisation.	Long
Limite de pourcentage de localisations	Points les plus proches, exprimés sous forme de pourcentage des points de la valeur Points de localisation.	Double
Créer un rapport (Facultatif)	Indique si un rapport en sortie sera créé. Activé : un rapport sera créé. Désactivé : aucun rapport ne sera créé. Il s’agit de l’option par défaut.	Boolean
Titre du rapport (Facultatif)	Titre du rapport en sortie.	String
Dossier du rapport en sortie (Facultatif)	Répertoire qui contiendra le rapport en sortie.	Folder
Formats en sortie du rapport (Facultatif)	Formats du rapport en sortie. La valeur par défaut est InfographicHTML. Les autres formats disponibles sont PDF, XLSX, S.XLSX, HTML, S.XML, ZIP, CVS, PAGX et InfographicPDF.	String
Champs de rapport (Facultatif)	Champs supplémentaires qui seront ajoutés au rapport.	Field
Sens de déplacement (Facultatif)	Spécifie si les temps ou distances de déplacement seront mesurés depuis les points de localisation vers les entités en entrée ou depuis les entités en entrée vers les points de localisation. Vers les entités en entrée—Le déplacement s’effectue des points de localisation vers les entités en entrée. Il s’agit de l’option par défaut. Depuis les entités en entrée—Le déplacement s’effectue des entités en entrée vers les points de localisation.	String
Heure du jour (Facultatif)	Heure à laquelle le déplacement commence.	Date
Fuseau horaire (Facultatif)	Spécifie le fuseau horaire qui sera utilisé pour le paramètre Heure du jour. UTC—Le temps universel coordonné (UTC) est utilisé. Choisissez cette option pour obtenir la meilleure localisation à une heure donnée (maintenant, par exemple), sans toutefois connaître avec certitude le fuseau horaire dans lequel se trouve la valeur in_location_points. Heure locale des localisations—Fuseau horaire dans lequel se trouve et est utilisée la valeur in_location_points. Si le déplacement s’effectue des entités en entrée vers les points de localisation, le fuseau horaire est celui des entités en entrée. Si le déplacement s’effectue des points de localisation vers les entités en entrée, le fuseau horaire est celui des points de localisation. Il s’agit de l’option par défaut. UTC—Le temps universel coordonné (UTC) est utilisé. Choisissez cette option pour obtenir la meilleure localisation à une heure donnée (maintenant, par exemple), sans toutefois connaître avec certitude le fuseau horaire dans lequel se trouve la valeur Points de localisation. Heure locale des localisations—Fuseau horaire dans lequel se trouve et est utilisée la valeur Points de localisation. Si le déplacement s’effectue des entités en entrée vers les points de localisation, le fuseau horaire est celui des entités en entrée. Si le déplacement s’effectue des points de localisation vers les entités en entrée, le fuseau horaire est celui des points de localisation. Il s’agit de l’option par défaut.	String
Tolérance de recherche (Facultatif)	Distance maximale des points en entrée par rapport au réseau. Les points situés au-delà de la tolérance de recherche sont exclus du traitement.	Linear Unit

Sortie obtenue

Étiquette	Explication	Type de données
Rapport en sortie	Fichier de rapport en sortie.	File

Python

arcpy.ba.FindNearbyLocations(in_features, id_field, in_location_points, out_feature_class, {distance_type}, {units}, {distance_limit}, number_limit, percent_limit, {create_report}, {report_title}, {report_folder}, {report_format}, {report_fields}, {travel_direction}, {time_of_day}, {time_zone}, {search_tolerance})

Nom	Explication	Type de données
in_features	Couche ponctuelle à mesurer depuis ou vers in_location_points.	Feature Layer
id_field	Champ contenant les identifiants uniques de chaque entité en entrée.	Field
in_location_points	Couche qui sera utilisée pour générer la sortie avec les attributs de distance et de direction depuis ou vers in_features.	Feature Layer
out_feature_class	Entités de points de localisation en sortie.	Feature Class
distance_type (Facultatif)	Distance calculée en fonction de la méthode de déplacement. Straight Line est la valeur par défaut.	String
units (Facultatif)	Unités de mesure, de la distance ou du temps, utilisées pour calculer les localisations à proximité.	String
distance_limit (Facultatif)	Étendue d’analyse mesurée en distance ou temps.	Double
number_limit	Limite numérique de la valeur in_location_points.	Long
percent_limit	Points les plus proches, exprimés sous forme de pourcentage des points de la valeur in_location_points.	Double
create_report (Facultatif)	Indique si un rapport en sortie sera créé. CREATE_REPORT—Un rapport sera créé. DO_NOT_CREATE_REPORT—Aucun rapport ne sera créé. Il s’agit de l’option par défaut.	Boolean
report_title (Facultatif)	Titre du rapport en sortie.	String
report_folder (Facultatif)	Répertoire qui contiendra le rapport en sortie.	Folder
report_format [report_format,...] (Facultatif)	Formats du rapport en sortie. La valeur par défaut est InfographicHTML. Les autres formats disponibles sont PDF, XLSX, S.XLSX, HTML, S.XML, ZIP, CVS, PAGX et InfographicPDF.	String
report_fields [report_fields,...] (Facultatif)	Champs supplémentaires qui seront ajoutés au rapport.	Field
travel_direction (Facultatif)	Spécifie si les temps ou distances de déplacement seront mesurés depuis les points de localisation vers les entités en entrée ou depuis les entités en entrée vers les points de localisation. TOWARD_STORES—Le déplacement s’effectue des points de localisation vers les entités en entrée. Il s’agit de l’option par défaut. AWAY_FROM_STORES—Le déplacement s’effectue des entités en entrée vers les points de localisation.	String
time_of_day (Facultatif)	Heure à laquelle le déplacement commence.	Date
time_zone (Facultatif)	Spécifie le fuseau horaire utilisé pour le paramètre time_of_day. UTC—Le temps universel coordonné (UTC) est utilisé. Choisissez cette option pour obtenir la meilleure localisation à une heure donnée (maintenant, par exemple), sans toutefois connaître avec certitude le fuseau horaire dans lequel se trouve la valeur in_location_points. TIME_ZONE_AT_LOCATION—Fuseau horaire dans lequel se trouve et est utilisée la valeur in_location_points. Si le déplacement s’effectue des entités en entrée vers les points de localisation, le fuseau horaire est celui des entités en entrée. Si le déplacement s’effectue des points de localisation vers les entités en entrée, le fuseau horaire est celui des points de localisation. Il s’agit de l’option par défaut.	String
search_tolerance (Facultatif)	Distance maximale des points en entrée par rapport au réseau. Les points situés au-delà de la tolérance de recherche sont exclus du traitement.	Linear Unit

Sortie obtenue

Nom	Explication	Type de données
output_report	Fichier de rapport en sortie.	File

Exemple de code

Exemple d’utilisation de la fonction FindNearbyLocation (script autonome)

Le script ci-dessous pour la fenêtre Python illustre l’utilisation de la fonction FindNearbyLocations.

import arcpy

# Access data locally.
arcpy.env.baDataSource = "LOCAL;;USA_ESRI_2020"
arcpy.ba.FindNearbyLocations("FindNearby.gdb/stores", "STORE_ID", "FindNearby.gdb/coffee", "FindNearby.gdb/Nearby_coffee_competitors", "STRAIGHT_LINE_DISTANCE", "MILES", None, "10", None, "DO_NOT_CREATE_REPORT", None, "#", None, None, "TOWARD_STORES", None, "TIME_ZONE_AT_LOCATION", None")

Environnements

Espace de travail courant, Source de données, Source de réseau

Cas particuliers

Informations de licence

• Basic: Nécessite Business Analyst
• Standard: Nécessite Business Analyst
• Advanced: Nécessite Business Analyst