Synthétiser - A proximité (Analyse)

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

Synthétiser - A proximité

Utilisation

    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.

  • 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.

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ètreExplicationType 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.

  • DRIVING_DISTANCEDistance couverte en voiture ou dans d'autres petits véhicules, tels que des pick-ups. Le déplacement suit toutes les règles propres aux voitures.
  • DRIVING_TIMEDistance couverte dans un délai imparti en voiture ou dans d'autres petits véhicules, tels que des pick-ups. Les vitesses de déplacement dynamique basées sur le trafic sont utilisées si elles sont disponibles lorsque vous spécifiez une heure du jour. Le déplacement suit toutes les règles propres aux voitures.
  • STRAIGHT_LINEDistance euclidienne ou en ligne droite.
  • TRUCKING_DISTANCEDistance couverte le long des itinéraires appropriés aux camions. Le déplacement suit toutes les règles propres aux voitures, ainsi que les règles spécifiques aux camions.
  • TRUCKING_TIMEDistance couverte dans un délai imparti lors d'un déplacement le long des itinéraires appropriés aux camions. Les vitesses de déplacement dynamique basées sur le trafic sont utilisées si elles sont disponibles lorsque vous spécifiez une heure du jour. Le déplacement suit toutes les règles propres aux voitures, ainsi que les règles spécifiques aux camions.
  • WALKING_DISTANCEDistance couverte le long des chemins et routes qui autorisent la circulation pédestre.
  • WALKING_TIMEDistance couverte dans un délai imparti lors d'une marche le long des chemins et routes qui autorisent la circulation pédestre.
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.

  • MILESMilles
  • KILOMETERSKilomètres
  • FEETPieds
  • YARDSYards
  • METERSMètres
  • HOURSHeures
  • MINUTESMinutes
  • SECONDSSecondes
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é).

  • GEOLOCALL'heure du jour se rapporte au fuseau horaire local dans lequel se trouvent les entités en entrée. Cette option peut provoquer un roulement des heures de départ de l'analyse sur différents fuseaux horaires. Il s’agit de l’option par défaut.Par exemple, si vous configurez une heure du jour géolocale sur 9 h 00, les temps de trajet des points situés dans le fuseau horaire de l'est débutent à 9 h 00 Heure de la côte est et 9 h 00 Heure du centre pour les points se trouvant dans le fuseau horaire du Centre. (Les heures de départ sont décalées d'une heure en heure UTC ou locale.
  • UTCL'heure du jour est exprimée en heure UTC (Temps Universel Coordonné). Les heures de départ de tous les points sont simultanées, quels que soient les fuseaux horaires.Par exemple, si vous configurez une heure du jour UTC sur 9 h 00, les temps de trajet des points situés dans le fuseau horaire de l'est débutent à 4 h 00 Heure de la côte est et 3 h 00 Heure du centre pour les points se trouvant dans le fuseau horaire du Centre. (Les heures de départ sont simultanées.)
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.

  • KEEP_ALLToutes les zones tampon seront copiées dans la classe d'entités en sortie. Il s’agit de l’option par défaut.
  • ONLY_INTERSECTINGSeules les zones tampon 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 :

  • Somme : ajoute la valeur totale de tous les points dans chaque zone tampon.
  • Moyenne : calcule la moyenne de tous les points dans chaque zone tampon.
  • Min : recherche la valeur la plus petite de tous les points dans chaque zone tampon.
  • Max : recherche la valeur la plus grande de tous les points dans chaque zone tampon.
  • Ecart type : recherche l'écart type de tous les points dans chaque zone tampon.

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.

  • ADD_SHAPE_SUMAjoute les attributs de récapitulation de forme à la classe d'entités en sortie. Il s’agit de l’option par défaut.
  • NO_SHAPE_SUMN'ajoute pas les attributs de récapitulation de forme à la classe d'entités en sortie.
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.

  • METERSMètres
  • KILOMETERSKilomètres
  • FEETPieds
  • YARDSYards
  • MILESMilles
  • ACRESAres
  • HECTARESHectares
  • SQUAREMETERSMètres carrés
  • SQUAREKILOMETERSKilomètres carrés
  • SQUAREFEETPieds carrés
  • SQUAREYARDSYards carrés
  • SQUAREMILESMiles carrés
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.

  • NO_MIN_MAJN'ajoute pas de champs minoritaires et majoritaires à la sortie. Il s’agit de l’option par défaut.
  • ADD_MIN_MAJAjoutez des champs minoritaires et majoritaires à la sortie.
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.

  • NO_PERCENTN'ajoute pas de champ attributaire de pourcentage à la sortie. Il s’agit de l’option par défaut.
  • ADD_PERCENTAjoute un champ attributaire de pourcentage à la sortie.
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 :

  • Join_ID : ID correspondant à un champ d’ID ajouté à la classe d’entités en sortie.
  • Champ de regroupement.
  • Champ de récapitulation de forme, tel que le nombre de points ou la longueur de lignes.
  • Un champ pour chacun des champs de récapitulation.
  • Champ de pourcentage.

Table

Exemple de code

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

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")
Exemple 2 d'utilisation de l'outil SummarizeNearby (script autonome)

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)

Informations de licence

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

Rubriques connexes