Rechercher les emplacements à proximité (Business Analyst)

Disponible avec une licence Business Analyst.

Synthèse

Identifier les emplacements 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 d'emplacement à 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 d'emplacement doit être une classe d’entités ponctuelles. Les points d'emplacement sont tous les emplacements les plus proches qui seront utilisés 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 d'emplacement, ainsi que les champs calculés contenant les valeurs de distance et de direction.

  • Le document Interpréter un rapport Rechercher les emplacements à proximité est un document PDF que vous pouvez utiliser pour comprendre les différentes sections et les différents éléments du rapport Rechercher les emplacements à proximité.

Paramètres

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

Couche ponctuelle à mesurer depuis ou vers la valeur du paramètre Points d'emplacement.

Feature Layer
Champ d’ID

Champ contenant les identifiants uniques de chaque entité en entrée.

Field
Points d'emplacement

Couche qui sera utilisée pour générer la sortie avec les attributs de distance et de direction depuis ou vers la valeur du paramètre Entités en entrée.

Feature Layer
Classe d’entités en sortie

Entités de points d'emplacement 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 type distance ou temps, qui seront utilisées lors des calculs d'emplacements à proximité.

String
Limite de distance
(Facultatif)

Étendue d’analyse mesurée en distance ou temps.

Double
Limite de nombre d'emplacements

Limite numérique de la valeur Points d'emplacement.

Long
Limite de pourcentage d'emplacements

Points les plus proches, exprimés sous forme de pourcentage des points de la valeur Points d'emplacement.

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 d'emplacement vers les entités en entrée ou depuis les entités en entrée vers les points d'emplacement.

  • Vers les entités en entréeLe déplacement s’effectue des points d'emplacement vers les entités en entrée. Il s’agit de l’option par défaut.
  • Depuis les entités en entréeLe déplacement s’effectue des entités en entrée vers les points d'emplacement.
String
Heure du jour
(Facultatif)

Heure à laquelle le déplacement commencera.

Date
Fuseau horaire
(Facultatif)

Spécifie le fuseau horaire qui sera utilisé pour le paramètre Heure du jour.

  • UTCLe 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 emplacementsFuseau 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 d'emplacement, le fuseau horaire est celui des entités en entrée. Si le déplacement s’effectue des points d'emplacement vers les entités en entrée, le fuseau horaire est celui des points d'emplacement. Il s’agit de l’option par défaut.
  • UTCLe temps universel coordonné (UTC) est utilisé. Choisissez cette option pour obtenir le meilleur emplacement à une heure donnée (maintenant, par exemple), sans toutefois connaître avec certitude le fuseau horaire dans lequel se trouve la valeur Points d'emplacement.
  • Heure locale des emplacementsFuseau horaire dans lequel se trouve et est utilisée la valeur Points d'emplacement. Si le déplacement s’effectue des entités en entrée vers les points d'emplacement, le fuseau horaire est celui des entités en entrée. Si le déplacement s’effectue des points d'emplacement vers les entités en entrée, le fuseau horaire est celui des points d'emplacement. 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
Nom d'emplacement
(Facultatif)

Champ provenant du paramètre Points d'emplacement en entrée. Ce champ contient le nom ou l’ID de chaque point en entrée utilisé dans le rapport Rechercher les emplacements à proximité.

Field

Sortie obtenue

ÉtiquetteExplicationType de données
Rapport en sortie

Fichier de rapport en sortie.

File

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}, {location_name})
NomExplicationType de données
in_features

Couche ponctuelle à mesurer depuis ou vers la valeur du paramètre 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 la valeur du paramètre in_features.

Feature Layer
out_feature_class

Entités de points d'emplacement 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 type distance ou temps, qui seront utilisées lors des calculs d'emplacements à 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_REPORTUn rapport sera créé.
  • DO_NOT_CREATE_REPORTAucun 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 d'emplacement vers les entités en entrée ou depuis les entités en entrée vers les points d'emplacement.

  • TOWARD_STORESLe déplacement s’effectue des points d'emplacement vers les entités en entrée. Il s’agit de l’option par défaut.
  • AWAY_FROM_STORESLe déplacement s’effectue des entités en entrée vers les points d'emplacement.
String
time_of_day
(Facultatif)

Heure à laquelle le déplacement commencera.

Date
time_zone
(Facultatif)

Spécifie le fuseau horaire qui sera utilisé pour le paramètre time_of_day.

  • UTCLe 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_LOCATIONFuseau 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 d'emplacement, le fuseau horaire est celui des entités en entrée. Si le déplacement s’effectue des points d'emplacement vers les entités en entrée, le fuseau horaire est celui des points d'emplacement. 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
location_name
(Facultatif)

Champ provenant du paramètre in_location_points en entrée. Ce champ contient le nom ou l’ID de chaque point en entrée utilisé dans le rapport Rechercher les emplacements à proximité.

Field

Sortie obtenue

NomExplicationType 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 suivant 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")

Informations de licence

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

Rubriques connexes