Nächstgelegene Positionen suchen (Business Analyst Tools)

Zusammenfassung

Mithilfe des ausgewählten Entfernungstyps können Sie Positionen suchen, die den Eingabe-Features am nächsten liegen. Die Anzahl der Punkte in der Ausgabe wird festgelegt, indem die Anzahl bzw. der Prozentsatz an zurückzugebenden Positionspunkten begrenzt oder die Entfernung von den Eingabepunkten eingeschränkt wird.

Verwendung

Der Wert des Parameters Eingabe-Features muss eine Point-Feature-Class sein. Die Eingabe-Features stellen die zu analysierenden Standorte wie Filialen oder Einrichtungen dar.
Der Parameter Positionspunkte enthält die Ursprungspunkte, z. B. Filialstandorte.
Der Wert des Parameters Positionspunkte muss eine Point-Feature-Class sein. Die Positionspunkte sind alle Positionen in der Nähe, die in den Berechnungen des Werkzeugs verwendet werden.
Der Parameter Ausgabe-Feature-Class enthält alle Attribute der Parameter Eingabe-Features und Positionspunkte sowie berechnete Felder mit Entfernungs- und Richtungswerten.
Bei ["Interpretieren des Berichts zu 'Nächstgelegene Positionen suchen'"] (https://links.esri.com/business-analyst/pro/report/interpret-find-nearby-locations) handelt es sich um ein PDF-Dokument, in dem die unterschiedlichen Abschnitte und Elemente des Berichts zu "Nächstgelegene Positionen suchen" erklärt werden.

Beschriftung	Erläuterung	Datentyp
Eingabe-Features	Der Layer, der die Punkte enthält, die in Relation zum Layer Positionspunkte gemessen werden sollen. Dieser Layer enthält Ursprungspunkte wie Filialstandorte.	Feature Layer
ID-Feld	Ein Feld mit eindeutigen Identifikatoren für die einzelnen Eingabe-Features.	Field
Positionspunkte	Der Layer, der die Punkte enthält, die im Hinblick auf Entfernung und Richtung in Relation zum Parameterwert Eingabe-Features gemessen werden sollen. Dieser Layer enthält in der Nähe gelegene Punkte wie Kundenstandorte.	Feature Layer
Ausgabe-Feature-Class	Die Ausgabe-Positionspunkt-Features.	Feature Class
Entfernungstyp (Optional)	Die basierend auf der Art der Anfahrt berechnete Entfernung. Der Standardwert lautet Gerade Linie.	String
Entfernungseinheiten (Optional)	Die Maßeinheiten für Entfernung oder Zeit, die bei der Berechnung von Positionen in der Nähe verwendet werden.	String
Entfernungslimit (Optional)	Die hinsichtlich Entfernung oder Zeit gemessene Analyseausdehnung.	Double
Limit für die Anzahl der Positionen	Das numerische Limit für den Wert von Positionspunkte.	Long
Limit für den Prozentsatz der Positionen	Die nächstgelegenen Punkte als Prozentsatz des Wertes für Positionspunkte.	Double
Bericht erstellen (Optional)	Gibt an, ob ein Ausgabebericht erstellt wird. Aktiviert—A report will be created. Deaktiviert—A report will not be created. This is the default.	Boolean
Berichtstitel (Optional)	Der Titel des Ausgabeberichts.	String
Ausgabeordner für den Bericht (Optional)	Das Verzeichnis, das den Ausgabebericht enthält.	Folder
Berichtsausgabeformate (Optional)	Die Formate für den Ausgabebericht. Der Standardwert ist PDF. Zusätzliche verfügbare Formate sind XLSX, S.XLSX, HTML, S.XML, ZIP, CVS und PAGX.	String
Berichtsfelder (Optional)	Die zusätzlichen Felder, die dem Bericht hinzugefügt werden.	Field
Reiserichtung (Optional)	Gibt an, ob die Reisezeiten oder -entfernungen von den Positionspunkten zu den Eingabe-Features oder von den Eingabe-Features zu den Positionspunkten gemessen werden. Toward Input Features—The direction of travel will be from location points to input features. This is the default. Away from Input Features—The direction of travel will be from input features to location points.	String
Zeitpunkt (Optional)	Die Uhrzeit, zu der die Reise beginnt.	Date
Zeitzone (Optional)	Gibt die Zeitzone an, die für den Parameter Zeitpunkt verwendet werden soll. UTC—Coordinated universal time (UTC) will be used. Choose this option if you want the best location for a specific time, such as now, but aren't certain of the time zone in which the Location Points value will be located. Local time at locations—The time zone in which the Location Points value is located will be used. This is the default.	String
Suchtoleranz (Optional)	Die maximale Entfernung der Eingabe-Punkte vom Netzwerk. Punkte außerhalb der Suchtoleranz werden von der Verarbeitung ausgeschlossen.	Linear Unit
Verzeichnisname (Optional)	Ein Feld aus dem Eingabeparameter Positionspunkte. Dieses Feld enthält den Namen oder die ID der einzelnen Eingabepunkte, die im Bericht zu "Nächstgelegene Positionen suchen" verwendet werden.	Field

Abgeleitete Ausgabe

Beschriftung	Erläuterung	Datentyp
Ausgabebericht	Die Ausgabeberichtsdatei.	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})

Name	Erläuterung	Datentyp
in_features	Der Layer, der die Punkte enthält, die in Relation zum Layer `in_location_points` gemessen werden sollen. Dieser Layer enthält Ursprungspunkte wie Filialstandorte.	Feature Layer
id_field	Ein Feld mit eindeutigen Identifikatoren für die einzelnen Eingabe-Features.	Field
in_location_points	Der Layer, der die Punkte enthält, die im Hinblick auf Entfernung und Richtung in Relation zum Parameterwert `in_features` gemessen werden sollen. Dieser Layer enthält in der Nähe gelegene Punkte wie Kundenstandorte.	Feature Layer
out_feature_class	Die Ausgabe-Positionspunkt-Features.	Feature Class
distance_type (Optional)	Die basierend auf der Art der Anfahrt berechnete Entfernung. Der Standardwert lautet `Straight Line`.	String
units (Optional)	Die Maßeinheiten für Entfernung oder Zeit, die bei der Berechnung von Positionen in der Nähe verwendet werden.	String
distance_limit (Optional)	Die hinsichtlich Entfernung oder Zeit gemessene Analyseausdehnung.	Double
number_limit	Das numerische Limit für den Wert von `in_location_points`.	Long
percent_limit	Die nächstgelegenen Punkte als Prozentsatz des Wertes für `in_location_points`.	Double
create_report (Optional)	Gibt an, ob ein Ausgabebericht erstellt wird. `CREATE_REPORT`—A report will be created. `DO_NOT_CREATE_REPORT`—A report will not be created. This is the default.	Boolean
report_title (Optional)	Der Titel des Ausgabeberichts.	String
report_folder (Optional)	Das Verzeichnis, das den Ausgabebericht enthält.	Folder
report_format [report_format,...] (Optional)	Die Formate für den Ausgabebericht. Der Standardwert ist PDF. Zusätzliche verfügbare Formate sind XLSX, S.XLSX, HTML, S.XML, ZIP, CVS und PAGX.	String
report_fields [report_fields,...] (Optional)	Die zusätzlichen Felder, die dem Bericht hinzugefügt werden.	Field
travel_direction (Optional)	Gibt an, ob die Reisezeiten oder -entfernungen von den Positionspunkten zu den Eingabe-Features oder von den Eingabe-Features zu den Positionspunkten gemessen werden. `TOWARD_STORES`—The direction of travel will be from location points to input features. This is the default. `AWAY_FROM_STORES`—The direction of travel will be from input features to location points.	String
time_of_day (Optional)	Die Uhrzeit, zu der die Reise beginnt.	Date
time_zone (Optional)	Gibt die Zeitzone an, die für den Parameter `time_of_day` verwendet werden soll. `UTC`—Coordinated universal time (UTC) will be used. Choose this option if you want the best location for a specific time, such as now, but aren't certain of the time zone in which the `in_location_points` value will be located. `TIME_ZONE_AT_LOCATION`—The time zone in which the `in_location_points` value is located will be used. This is the default.	String
search_tolerance (Optional)	Die maximale Entfernung der Eingabe-Punkte vom Netzwerk. Punkte außerhalb der Suchtoleranz werden von der Verarbeitung ausgeschlossen.	Linear Unit
location_name (Optional)	Ein Feld aus dem Eingabeparameter `in_location_points`. Dieses Feld enthält den Namen oder die ID der einzelnen Eingabepunkte, die im Bericht zu "Nächstgelegene Positionen suchen" verwendet werden.	Field

Abgeleitete Ausgabe

Name	Erläuterung	Datentyp
output_report	Die Ausgabeberichtsdatei.	File

Codebeispiel

FindNearbyLocations: Beispiel (eigenständiges Skript)

Das folgende Skript im Python-Fenster veranschaulicht, wie Sie die Funktion FindNearbyLocations verwenden.

import arcpy

# Access data locally.
arcpy.env.baDataSource = "LOCAL;;USA_ESRI_2026"
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)

Umgebungen

Aktueller Workspace, Datenquelle, Netzwerkquelle

Lizenzierungsinformationen

Basic: Erfordert Business Analyst
Standard: Erfordert Business Analyst
Advanced: Erfordert Business Analyst

Nächstgelegene Positionen suchen (Business Analyst Tools)

Zusammenfassung

Verwendung

Parameter

Abgeleitete Ausgabe

Umgebungen

Lizenzierungsinformationen

Verwandte Themen