Résumé
Identifie les entités qui se trouvent à une certaine distance des entités dans la couche en entrée et calcule les statistiques des entités à proximité. La distance peut être mesurée par une distance en ligne droite, par une distance en durée de trajet (par exemple, à moins de 10 minutes) ou par une distance à parcourir (un rayon de 5 kilomètres). Pour mesurer le temps de trajet et la distance à parcourir, vous devez être connecté à un compte d'organisation ArcGIS Online avec des privilèges d'analyse du réseau. En outre, ces mesures utilisent des crédits.
Exemples de scénarios avec Synthétiser - A proximité :
- Calcule la population totale qui se trouve à un temps de trajet de moins de 5 minutes d'un nouvel emplacement suggéré de point de vente.
- Calcule le nombre de bretelles d'accès d'autoroute qui se trouvent à une distance de moins d'1 mile d'un nouvel emplacement suggéré de point de vente afin d'en mesurer l'accessibilité.
Illustration
Utilisation
Vous pouvez spécifier plusieurs distances. Chaque valeur de distance entraînera la génération d'une zone autour de chaque entité en entrée. Par exemple, si vous spécifiez deux distances, chaque entité en entrée est bufferisée deux fois et la sortie contient deux zones pour cette entité en entrée, une pour chaque distance.
Les outils Synthétiser - À l’intérieur et Synthétiser - À proximité sont conceptuellement identiques. Avec l’outil Synthétiser - À l’intérieur, vous pouvez synthétiser des entités au sein de polygones existants, tandis que l’outil Synthétiser - À proximité vous permet de générer des zones autour de points, de lignes ou de polygones et de synthétiser des entités dans ces zones obtenues.
Vous pouvez créer des groupes en spécifiant un champ de groupe à partir des points en entrée. Si, par exemple, vous synthétisez des crimes à une certaine distance des limites de voisinage, vous pouvez avoir un attribut Crime_type avec cinq types de crimes différents. Chaque type de crime unique forme un groupe, et les statistiques que vous choisissez seront calculées pour chaque valeur unique de Crime_type.
Licence :
Pour utiliser les options de mesure du temps de trajet et de la distance à parcourir, vous devez être connecté à un compte d'organisation ArcGIS Online avec des privilèges d'analyse du réseau. A chaque exécution de l'outil, des crédits de service sont débités de votre abonnement en fonction du service utilisé et des résultats obtenus du service. La page Crédits de service ArcGIS Online fournit des détails sur les crédits de service.
Syntaxe
arcpy.analysis.SummarizeNearby(in_features, in_sum_features, out_feature_class, distance_type, distances, {distance_units}, {time_of_day}, {time_zone}, {keep_all_polygons}, {sum_fields}, {sum_shape}, {shape_unit}, {group_field}, {add_min_maj}, {add_group_percent}, {Output_Grouped_Table})
Paramètre | Explication | Type de données |
in_features | Entités ponctuelles, linéaires ou surfaciques qui seront bufférisées et les zones tampon qui seront utilisées pour synthétiser les entités de synthèse en entrée. | Feature Layer |
in_sum_features | Entités ponctuelles, linéaires ou surfaciques qui seront synthétisées. | Feature Layer |
out_feature_class | La classe d'entités surfaciques en sortie contenant les entités en entrée bufferisées, les attributs des entités en entrée et les nouveaux attributs concernant le nombre de points, la longueur de lignes et la surface des polygones au sein de chaque zone tampon, ainsi que des statistiques sur ces entités. | Feature Class |
distance_type | Définit le type de mesure de la distance à utiliser lors de la génération des zones tampon autour des entités en entrée. La distance à parcourir et le temps de trajet à parcourir utilisent tous les deux le réseau routier et respectent les restrictions comme les rues à sens unique. Le temps de trajet respecte quant à lui les limitations de vitesse en vigueur. Pour utiliser les options de mesure du temps de trajet et de la distance à parcourir, vous devez être connecté à un compte d'organisation ArcGIS Online avec des privilèges d'analyse du réseau. A chaque exécution de l'outil, des crédits de service sont débités de votre abonnement en fonction du service utilisé et des résultats obtenus du service. La page Crédits de service ArcGIS Online fournit des détails sur les crédits de service. Tous les types de distance, à l'exception de la distance en ligne droite, utilisent les services de calcul d'itinéraire et de réseau ArcGIS Online.
| String |
distances [distance,...] | Les valeurs de distance définissent une distance de recherche (pour la distance en ligne droite, distance à parcourir, distance pour camions ou distance à pied) ou un temps de trajet (distance à parcourir, camions ou distance à pied). Les entités qui se trouvent au sein (ou qui sont égales à) des distances que vous entrez seront synthétisées. Plusieurs valeurs peuvent être spécifiées. Une zone est générée autour de chaque entité en entrée pour chaque distance. | Double |
distance_units (Facultatif) | Unités des valeurs de distance.
| String |
time_of_day (Facultatif) | Précisez si les temps de trajet doivent prendre en compte les conditions de trafic. Les conditions de trafic, en particulier dans les zones urbanisées, peuvent avoir une grande influence sur la zone couverte dans un temps de trajet spécifié. Si aucune date ou heure n'est spécifiée, la distance couverte au cours d'un temps de trajet spécifié n'est pas influencée par le trafic. Les conditions de trafic peuvent être réelles ou typiques (historiques), selon la date et l'heure spécifiées pour ce paramètre. Esri enregistre les données de trafic réel pendant 12 heures et référence les données de prévision jusqu'à 12 heures dans le futur. Si l'heure et la date que vous spécifiez se trouvent dans une fenêtre horaire de 24 heures, le trafic réel est utilisé. Dans le cas contraire, le trafic typique ou historique est utilisé. | Date |
time_zone (Facultatif) | Fuseau horaire de l'heure du jour. Les fuseaux horaires peuvent être spécifiés en heure locale ou en heure UTC (Temps Universel Coordonné).
| String |
keep_all_polygons (Facultatif) | Détermine si toutes les zones tampon des entités en entrée ou uniquement celles qui intersectent ou contiennent au moins une entité de synthèse en entrée seront copiées dans la classe d'entités en sortie.
| Boolean |
sum_fields [[summary_field, statistic_type],...] (Facultatif) | Liste des noms de champs attributaires émanant des entités de synthèse en entrée, et types de synthèse statistiques que vous voulez calculer pour ces champs attributaires concernant tous les points au sein de chaque zone tampon des entités en entrée. Les champs de récapitulation doivent être numériques. Les champs de texte ou d'autres types attributaires ne sont pas pris en charge. Les types de statistiques sont notamment :
| Value Table |
sum_shape (Facultatif) | Détermine si la classe d'entités en sortie contiendra les attributs du nombre de points, de la longueur de lignes et de la surface des entités surfaciques synthétisés dans chaque zone tampon des entités en entrée.
| Boolean |
shape_unit (Facultatif) | Unité dans laquelle les attributs de récapitulation de forme sont calculés. Si les entités de récapitulation en entrée sont des points, aucune unité de forme n'est utilisée, car seul le nombre de points au sein de la zone tampon de chaque entité en entrée est ajouté. Si les entités de récapitulation en entrée sont des lignes, spécifiez une unité linéaire. Si les entités de récapitulation en entrée sont des polygones, spécifiez une unité surfacique.
| String |
group_field (Facultatif) | Champ attributaire issu des entités de récapitulation en entrée utilisé pour le regroupement. Les entités qui possèdent la même valeur de champ de regroupement seront associées et récapitulées avec d'autres entités dotées de la même valeur de champ de regroupement. Lorsque vous choisissez un champ de regroupement, une table groupée en sortie supplémentaire est créée et vous devez spécifier son emplacement dans le paramètre out_grouped_table. | Field |
add_min_maj (Facultatif) | Cette option est disponible uniquement si vous avez sélectionné un champ de regroupement. Elle vous permet de déterminer la valeur du champ de regroupement qui est minoritaire (la moins dominante) et majoritaire (la plus dominante), dans la zone tampon de chaque entité en entrée.
| Boolean |
add_group_percent (Facultatif) | Cette option est disponible uniquement si vous avez sélectionné un champ de regroupement. Elle vous permet de déterminer le pourcentage de chaque valeur attributaire au sein de chaque groupe.
| Boolean |
Output_Grouped_Table (Facultatif) | Si un champ de regroupement est spécifiée, la table groupée en sortie est nécessaire. Table en sortie qui comprend des champs de récapitulation pour chaque groupe d'entités de récapitulation pour la zone tampon de chaque entité en entrée. La table contiendra les champs attributaires suivants :
| Table |
Exemple de code
Le script de fenêtre Python ci-dessous illustre l'utilisation de la fonction SummarizeNearby.
import arcpy
arcpy.env.workspace = "C:/data/city.gdb"
arcpy.SummarizeNearby_analysis("new_store_location", "census_blocks",
"new_store_population", "STRAIGHT_LINE", "1;2",
"Miles", "", "", "KEEP_ALL", "Pop2014 SUM")
Le script autonome suivant est un exemple d'utilisation simple de la fonction SummarizeNearby dans un environnement de scripts.
# Description: Use SummarizeNearby to summarize population
# import system modules
import arcpy
# Set environment settings
arcpy.env.workspace = "C:/data/city.gdb"
# Set local variables
newStore = "new_store_location"
censusInfo = "census_blocks"
outFeatureClass = "crimes_aggregated"
distanceType = "TRAVEL_TIME"
distance = "10;20"
distanceUnit = "Minutes"
time = "10/15/2014 2:14:19 PM"
timeZone = "GEOLOCAL"
keepPolys = True
sumFields = [["Pop2010", "Sum"],["OWNERS", "Sum"]]
addShapeSum = True
arcpy.SummarizeNearby_analysis(newStore, censusInfo, outFeatureClass,
distanceType, distance, distanceUnit,
time, timeZone, keepPolys, sumFields,
addShapeSum)
Environnements
Informations de licence
- Basic: Oui
- Standard: Oui
- Advanced: Oui
Rubriques connexes
Vous avez un commentaire à formuler concernant cette rubrique ?