Zusammenfassung
Sucht Features, die sich innerhalb einer angegebenen Entfernung von Features im Eingabe-Layer befinden und berechnet Statistiken für die nahe gelegenen Features. Die Entfernung kann als Linienentfernung, Fahrzeit (z. B. innerhalb von 10 Minuten) oder Fahrstrecke (innerhalb von 5 Kilometern) gemessen werden. Um Fahrzeit- und Fahrstreckenmessungen durchzuführen, müssen Sie bei einem ArcGIS Online-Organisationskonto mit Netzwerkanalyse-Berechtigungen angemeldet sein, für die Credits verbraucht werden.
Beispielszenarien mit Zusammenfassen (in der Nähe):
- Ermitteln Sie die Gesamtbevölkerungszahl innerhalb der Fahrzeit von fünf Minuten von einem vorgeschlagenen neuen Ladenstandort.
- Ermitteln Sie die Anzahl der Autobahnzufahrten innerhalb einer Fahrstrecke von einem Kilometer von einem vorgeschlagenen neuen Ladenstandort, um diese als Maß für die Erreichbarkeit des neuen Standorts zu verwenden.
Abbildung
Verwendung
Sie können mehrere Entfernungen angeben, und jeder Entfernungswert führt zu einer Fläche, die um jedes Eingabe-Feature erstellt wird. Wenn Sie beispielsweise zwei Entfernungen angeben, wird jedes Eingabe-Feature zweimal gepuffert, und die Ausgabe enthält zwei Flächen für dieses Eingabe-Feature, eine für jede Entfernung.
Die Werkzeuge Zusammenfassen (innerhalb) und Zusammenfassen (in der Nähe) sind konzeptuell ähnlich. Mit dem Werkzeug Zusammenfassen (innerhalb) können Features in vorhandenen Polygonen zusammengefasst werden, wohingegen mit dem Werkzeug Zusammenfassen (in der Nähe) Flächen um Punkte, Linien oder Polygone erstellt und Features in diesen abgeleiteten Flächen zusammengefasst werden können.
Sie können Gruppen erstellen, indem Sie ein Gruppenfeld aus den Eingabepunkten festlegen. Wenn Sie beispielsweise Straftaten innerhalb einer bestimmten Entfernung von Wohngebietsgrenzen zusammenfassen, haben Sie möglicherweise das Attribut Crime_type mit fünf verschiedenen Arten von Straftaten angelegt. Jede Art von Straftat bildet eine Gruppe und die Statistiken, die Sie auswählen, werden für jeden Einzelwert von Crime_type berechnet.
Lizenz:
Um die Optionen für Fahrzeit- und Fahrstreckenmessungen verwenden zu können, müssen Sie bei einem ArcGIS Online-Organisationskonto mit Netzwerkanalyse-Berechtigungen angemeldet sein. Bei jeder erfolgreichen Ausführung des Werkzeugs wird Ihre Subskription basierend auf dem verwendeten Service und dem vom Service zurückgegebenen Ergebnis mit Service-Credits belastet. Nähere Informationen zu Service-Credits finden Sie auf der Seite ArcGIS Online-Service-Credits.
Syntax
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})
Parameter | Erklärung | Datentyp |
in_features | Die Punkt-, Linien- oder Polygon-Features, die gepuffert werden, und die Puffer, die zum Zusammenfassen der Eingabe-Zusammenfassungs-Features verwendet werden. | Feature Layer |
in_sum_features | Die Punkt-, Linien- oder Polygon-Features, die zusammengefasst werden. | Feature Layer |
out_feature_class | Die Ausgabe-Polygon-Feature-Class, die die gepufferten Eingabe-Features, die Attribute der Eingabe-Features und neue Attribute zu der Anzahl von Punkten, der Länge von Linien und der Fläche von Polygonen in jedem Puffer sowie Statistiken zu diesen Features enthält. | Feature Class |
distance_type | Definiert, welche Art von Entfernungsmessung beim Erstellen von Pufferflächen um die Eingabe-Features verwendet werden sollen. Sowohl Fahrstrecke als auch Fahrzeit verwenden das Straßennetz und berücksichtigen Einschränkungen wie Einbahnstraßen. Die Fahrzeit berücksichtigt die aktuell veröffentlichten Geschwindigkeitsbegrenzungen. Um die Optionen für Fahrzeit- und Fahrstreckenmessungen verwenden zu können, müssen Sie bei einem ArcGIS Online-Organisationskonto mit Netzwerkanalyse-Berechtigungen angemeldet sein. Bei jeder erfolgreichen Ausführung des Werkzeugs wird Ihre Subskription basierend auf dem verwendeten Service und dem vom Service zurückgegebenen Ergebnis mit Service-Credits belastet. Nähere Informationen zu Service-Credits finden Sie auf der Seite ArcGIS Online-Service-Credits. Alle Entfernungstypen verwenden ArcGIS Online-Routing- und Netzwerkservices, mit Ausnahme von geradlinigen Entfernungen.
| String |
distances [distance,...] | Entfernungswerte definieren eine Suchentfernung (für geradlinige, Fahr-, Lkw- oder Gehentfernung) oder Reisezeit (für Fahr-, Lkw- oder Gehzeit). Features, die innerhalb der eingegebenen Entfernungen liegen (oder ihnen entsprechen), werden zusammengefasst. Es können mehrere Werte angegeben werden. Für jede Entfernung wird eine Fläche um jedes Eingabe-Feature erstellt. | Double |
distance_units (optional) | Die Einheiten der Entfernungswerte.
| String |
time_of_day (optional) | Legen Sie fest, ob Reisezeiten Verkehrsbedingungen berücksichtigen sollen. Verkehrsbedingungen, insbesondere in städtischen Gebieten, können erhebliche Auswirkungen auf das innerhalb einer angegebenen Reisezeit abgedeckte Gebiet haben. Wenn weder Datum noch Zeit angegeben werden, wird die während einer angegebenen Reisezeit festgelegte Entfernung nicht vom Verkehr beeinflusst. Verkehrsbedingungen können basierend auf dem Datum und der Uhrzeit, die für diesen Parameter angegeben wurden, live oder typisch (historisch) sein. Esri speichert Live-Verkehrsdaten 12 Stunden und verweist auf Vorhersagedaten bis zu 12 Stunden im Voraus. Wenn Ihre Zeit- und Datumsangabe innerhalb des 24-stündigen Zeitfensters liegt, wird Live-Verkehr verwendet. Liegt es außerhalb des Zeitfensters, wird typischer oder historischer Verkehr verwendet. | Date |
time_zone (optional) | Die Zeitzone für die angegebene Tageszeit. Zeitzonen können in lokaler Zeit oder in koordinierter Weltzeit (Coordinated Universal Time, UTC) angegeben werden.
| String |
keep_all_polygons (optional) | Legt fest, ob alle Puffer der Eingabe-Features oder nur diejenigen, die sich überschneiden oder mindestens ein Eingabe-Zusammenfassungs-Feature enthalten, in die Ausgabe-Feature-Class kopiert werden.
| Boolean |
sum_fields [[summary_field, statistic_type],...] (optional) | Eine Liste der Attributfeldnamen aus den Eingabe-Zusammenfassungs-Features und statistische Zusammenfassungstypen, die Sie für diese Attributfelder für alle Punkte in jedem Eingabe-Feature-Puffer berechnen möchten. Zusammenfassungsfelder müssen numerisch sein. Text und andere Attributfeldtypen werden nicht unterstützt. Die folgenden Statistiktypen sind verfügbar:
| Value Table |
sum_shape (optional) | Legt fest, ob die Ausgabe-Feature-Class Attribute für die Anzahl von Punkten, die Länge von Linien oder die Fläche von Polygon-Features enthält, die in jedem Eingabe-Feature-Puffer zusammengefasst werden.
| Boolean |
shape_unit (optional) | Die Einheit, in der Shape-Zusammenfassungsattribute berechnet werden. Wenn die Eingabe-Zusammenfassungs-Features Punkte sind, wird keine Shape-Einheit verwendet, da nur die Anzahl der Punkte in jedem Eingabe-Feature-Puffer hinzugefügt wird. Wenn die Eingabe-Zusammenfassungs-Features Linien sind, geben Sie eine lineare Einheit ein. Wenn die Eingabe-Zusammenfassungs-Features Polygone sind, geben Sie eine Flächeneinheit ein.
| String |
group_field (optional) | Attributfeld aus den Eingabe-Zusammenfassungs-Features, das für die Gruppierung verwendet wird. Features mit demselben Gruppenfeldwert werden kombiniert und mit anderen Features mit demselben Gruppenfeldwert zusammengefasst. Wenn Sie ein Gruppenfeld auswählen, wird eine zusätzliche gruppierte Ausgabetabelle erstellt, deren Speicherort im Parameter out_grouped_table angegeben werden muss. | Field |
add_min_maj (optional) | Diese Option ist nur aktiviert, wenn Sie ein Gruppenfeld ausgewählt haben. Sie ermöglicht es Ihnen, zu ermitteln, welcher Gruppenfeldwert der Minderheit (geringste Dominanz) und welcher der Mehrheit (höchste Dominanz) in jedem Eingabe-Feature-Puffer entspricht.
| Boolean |
add_group_percent (optional) | Diese Option ist nur aktiviert, wenn Sie ein Gruppenfeld ausgewählt haben. Sie ermöglicht es Ihnen, den Prozentsatz jedes Attributwertes in jeder Gruppe zu ermitteln.
| Boolean |
Output_Grouped_Table (optional) | Wenn ein Gruppenfeld angegeben wird, ist eine gruppierte Ausgabetabelle erforderlich. Eine Ausgabetabelle, die alle Zusammenfassungsfelder für jede Gruppe von Zusammenfassungs-Features für jeden Eingabe-Feature-Puffer enthält. Die Tabelle enthält die folgenden Attributfelder:
| Table |
Codebeispiel
Das folgende Skript im Python-Fenster veranschaulicht, wie Sie die Funktion SummarizeNearby verwenden.
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")
Das folgende eigenständige Skript ist ein Beispiel für die Verwendung der Funktion SummarizeNearby in einer Skriptumgebung.
# 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)
Umgebungen
Lizenzinformationen
- Basic: Ja
- Standard: Ja
- Advanced: Ja