Beschriftung | Erläuterung | Datentyp |
Eingabe-Features | Die Punkt-, Linien- oder Polygon-Features, die gepuffert werden sollen. Anhand dieser Puffer werden die Eingabe-Zusammenfassungs-Features zusammengefasst. | Feature Layer |
Eingabe-Zusammenfassungs-Features | Die Punkt-, Linien- oder Polygon-Features, die zusammengefasst werden. | Feature Layer |
Ausgabe-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 |
Entfernungsmessung | Gibt den Typ der Entfernungsmessung an, der zum Generieren von Pufferflächen verwendet wird. 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 Credits belastet. Nähere Informationen zu Credits finden Sie auf der Seite "Credits". Alle Entfernungstypen verwenden ArcGIS Online-Routing- und Netzwerkservices, mit Ausnahme von geradlinigen Entfernungen.
| String |
Entfernungen | Entfernungswerte, die eine Suchentfernung (für geradlinige, Fahr-, Lkw- oder Gehentfernung) oder Reisezeit (für Fahr-, Lkw- oder Gehzeit) definieren. Features, die innerhalb der angegebenen 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 |
Entfernungseinheiten (optional) | Gibt die für die Entfernungswerte verwendete Einheit an.
| String |
Zeitpunkt (optional) | Das Datum oder die Uhrzeit, zu dem bzw. zu der die Verkehrsbedingungen für die Fahrzeit berücksichtigt werden. 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. Die Verkehrsbedingungen können basierend auf dem mit Datum und Uhrzeit angegebenen Zeitpunkt für diesen Parameter live oder typisch (historisch) sein. Esri speichert Live-Verkehrsdaten 12 Stunden lang und referenziert Vorhersagedaten für die nächsten 12 Stunden. 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 |
Zeitzone (optional) | Gibt die Zeitzone an, die für den angegebenen Zeitpunkt verwendet werden soll. Zeitzonen können in lokaler Zeit oder in koordinierter Weltzeit (Coordinated Universal Time, UTC) angegeben werden.
| String |
Polygone ohne Punkte beibehalten (optional) | Legt fest, ob alle Puffer der Eingabe-Features in die Ausgabe-Feature-Class kopiert werden oder nur diejenigen, die sich überschneiden bzw. mindestens ein Eingabe-Zusammenfassungs-Feature enthalten.
| Boolean |
Zusammenfassungsfelder (optional) | Eine Liste der Attributfeldnamen aus den Eingabe-Zusammenfassungs-Features und statistische Zusammenfassungstypen, die für diese Attributfelder für alle Punkte in jedem Eingabe-Feature-Puffer berechnet werden. Zusammenfassungsfelder müssen numerisch sein. Text und andere Attributfeldtypen werden nicht unterstützt. Die folgenden Statistiktypen werden unterstützt:
| Value Table |
Shape-Zusammenfassungsattribute hinzufügen (optional) | Gibt an, ob der Ausgabe-Feature-Class Attribute für die Anzahl von Punkten, die Länge von Linien und die Fläche von Polygon-Features, die in jedem Eingabe-Feature-Puffer (Shape-Zusammenfassungsattribute) zusammengefasst werden, hinzufügt werden.
| Boolean |
Shape-Einheit (optional) | Gibt die Einheit an, die beim Berechnen der Shape-Zusammenfassungsattribute verwendet wird. Wenn die Eingabe-Zusammenfassungs-Features Punkte sind, ist keine Shape-Einheit erforderlich, 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 an. Wenn die Eingabe-Zusammenfassungs-Features Polygone sind, geben Sie eine Flächeneinheit an.
| String |
Gruppenfeld (optional) | Das 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. Wird ein Gruppenfeld angegeben, wird eine zusätzliche gruppierte Ausgabetabelle erstellt, deren Speicherort angegeben werden muss. Der Parameter Gruppierte Ausgabetabelle ist erforderlich, wenn ein Gruppenfeld verwendet wird. | Field |
Minderheits- und Mehrheitsattribute hinzufügen (optional) | Gibt an, ob der Ausgabe die Gruppenfeldwerte für die Minderheit (geringste Dominanz) und die Mehrheit (höchste Dominanz) in den einzelnen Eingabe-Feature-Puffern hinzugefügt werden. Dieser Parameter ist aktiv, wenn Sie einen Parameterwert für Gruppenfeld angegeben haben.
| Boolean |
Gruppenprozentsätze hinzufügen (optional) | Gibt an, ob der Ausgabe ein Prozentsatz-Attributfeld hinzugefügt wird. Mit diesem Parameter können Sie den Prozentsatz jedes Attributwertes in jeder Gruppe ermitteln. Dieser Parameter ist aktiv, wenn Sie einen Parameterwert für Gruppenfeld angegeben haben.
| Boolean |
Gruppierte Ausgabetabelle (optional) | Eine Ausgabetabelle, die alle Zusammenfassungsfelder für jede Gruppe von Zusammenfassungs-Features für jeden Eingabe-Feature-Puffer enthält. Wenn ein Gruppenfeld angegeben wird, ist eine gruppierte Ausgabetabelle erforderlich. Die Tabelle enthält die folgenden Attributfelder:
| Table |
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 (z. B. innerhalb von 5 Kilometern) gemessen werden. Zur Durchführung von Fahrzeit- und Fahrstreckenmessungen müssen Sie bei einem ArcGIS Online-Organisationskonto mit Netzwerkanalyse-Berechtigungen angemeldet sein. Für beide Messoptionen werden Credits verbraucht.
Es folgen Beispielszenarien mit Zusammenfassen (in der Nähe):
- Ermitteln Sie die Gesamtbevölkerungszahl innerhalb einer Fahrtzeit von fünf Minuten von einem vorgeschlagenen neuen Filialstandort.
- Ermitteln Sie die Anzahl der Autobahnzufahrten innerhalb einer Fahrstrecke von einem Kilometer von einem vorgeschlagenen neuen Filialstandort, 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 (in der Nähe) und Zusammenfassen (innerhalb) sind sich konzeptuell ähnlich. Mit dem Werkzeug Zusammenfassen (in der Nähe) können Sie Flächen um Punkte, Linien oder Polygone erstellen und Features in diesen abgeleiteten Flächen zusammenfassen. Mit dem Werkzeug Zusammenfassen (innerhalb) können Features in vorhandenen Polygonen zusammengefasst werden.
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 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.
NULL-Werte sind von allen statistischen Berechnungen ausgeschlossen. Beispiel: Der Durchschnittswert von 10, 5 und einem NULL-Wert ist 7,5 ((10+5)/2).
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 Credits belastet. Nähere Informationen zu Credits finden Sie auf der Seite "Credits".
Parameter
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})
Name | Erläuterung | Datentyp |
in_features | Die Punkt-, Linien- oder Polygon-Features, die gepuffert werden sollen. Anhand dieser Puffer werden die Eingabe-Zusammenfassungs-Features zusammengefasst. | 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 | Gibt den Typ der Entfernungsmessung an, der zum Generieren von Pufferflächen verwendet wird. 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 Credits belastet. Nähere Informationen zu Credits finden Sie auf der Seite "Credits". Alle Entfernungstypen verwenden ArcGIS Online-Routing- und Netzwerkservices, mit Ausnahme von geradlinigen Entfernungen.
| String |
distances [distance,...] | Entfernungswerte, die eine Suchentfernung (für geradlinige, Fahr-, Lkw- oder Gehentfernung) oder Reisezeit (für Fahr-, Lkw- oder Gehzeit) definieren. Features, die innerhalb der angegebenen 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) | Gibt die für die Entfernungswerte verwendete Einheit an.
| String |
time_of_day (optional) | Das Datum oder die Uhrzeit, zu dem bzw. zu der die Verkehrsbedingungen für die Fahrzeit berücksichtigt werden. 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. Die Verkehrsbedingungen können basierend auf dem mit Datum und Uhrzeit angegebenen Zeitpunkt für diesen Parameter live oder typisch (historisch) sein. Esri speichert Live-Verkehrsdaten 12 Stunden lang und referenziert Vorhersagedaten für die nächsten 12 Stunden. 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) | Gibt die Zeitzone an, die für den angegebenen Zeitpunkt verwendet werden soll. 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 in die Ausgabe-Feature-Class kopiert werden oder nur diejenigen, die sich überschneiden bzw. mindestens ein Eingabe-Zusammenfassungs-Feature enthalten.
| Boolean |
sum_fields [[summary_field, statistic_type],...] (optional) | Eine Liste der Attributfeldnamen aus den Eingabe-Zusammenfassungs-Features und statistische Zusammenfassungstypen, die für diese Attributfelder für alle Punkte in jedem Eingabe-Feature-Puffer berechnet werden. Zusammenfassungsfelder müssen numerisch sein. Text und andere Attributfeldtypen werden nicht unterstützt. Die folgenden Statistiktypen werden unterstützt:
| Value Table |
sum_shape (optional) | Gibt an, ob der Ausgabe-Feature-Class Attribute für die Anzahl von Punkten, die Länge von Linien und die Fläche von Polygon-Features, die in jedem Eingabe-Feature-Puffer (Shape-Zusammenfassungsattribute) zusammengefasst werden, hinzufügt werden.
| Boolean |
shape_unit (optional) | Gibt die Einheit an, die beim Berechnen der Shape-Zusammenfassungsattribute verwendet wird. Wenn die Eingabe-Zusammenfassungs-Features Punkte sind, ist keine Shape-Einheit erforderlich, 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 an. Wenn die Eingabe-Zusammenfassungs-Features Polygone sind, geben Sie eine Flächeneinheit an.
| String |
group_field (optional) | Das 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. Wird ein Gruppenfeld angegeben, wird eine zusätzliche gruppierte Ausgabetabelle erstellt, deren Speicherort im Parameter out_grouped_table angegeben werden muss. | Field |
add_min_maj (optional) | Gibt an, ob der Ausgabe die Gruppenfeldwerte für die Minderheit (geringste Dominanz) und die Mehrheit (höchste Dominanz) in den einzelnen Eingabe-Feature-Puffern hinzugefügt werden. Dieser Parameter ist aktiviert, wenn Sie einen Parameterwert für group_field angegeben haben.
| Boolean |
add_group_percent (optional) | Gibt an, ob der Ausgabe ein Prozentsatz der einzelnen Attributwerte in jeder Gruppe hinzugefügt wird. Mit diesem Parameter können Sie den Prozentsatz jedes Attributwertes in jeder Gruppe ermitteln. Dieser Parameter ist aktiviert, wenn Sie einen Parameterwert für group_field angegeben haben.
| Boolean |
Output_Grouped_Table (optional) | Eine Ausgabetabelle, die alle Zusammenfassungsfelder für jede Gruppe von Zusammenfassungs-Features für jeden Eingabe-Feature-Puffer enthält. Wenn ein Gruppenfeld angegeben wird, ist eine gruppierte Ausgabetabelle erforderlich. 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.analysis.SummarizeNearby("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.analysis.SummarizeNearby(newStore, censusInfo, outFeatureClass,
distanceType, distance, distanceUnit,
time, timeZone, keepPolys, sumFields,
addShapeSum)
Umgebungen
Lizenzinformationen
- Basic: Ja
- Standard: Ja
- Advanced: Ja