Nächstgelegene Positionen suchen (Business Analyst)

Mit der Business Analyst-Lizenz verfügbar.

Zusammenfassung

Identifiziert basierend auf einem ausgewählten Entfernungstyp Positionen, 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 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.

  • Für die Berichtserstellung müssen Sie den Parameter Bericht erstellen aktivieren.

Parameter

BeschriftungErläuterungDatentyp
Eingabe-Features

Der Punkt-Layer, für den eine Messung in Richtung oder weg von Positionspunkten durchgeführt wird

Feature Layer
ID-Feld

Ein Feld mit eindeutigen Identifikatoren für die einzelnen Eingabe-Features

Field
Positionspunkte

Der Layer, aus dem die Ausgabe erstellt wird, die Entfernungs- und Richtungsattribute zu bzw. ausgehend von den Eingabe-Features enthält

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: Es wird ein Bericht erstellt.
  • Deaktiviert: Es wird kein Bericht erstellt. Dies ist die Standardeinstellung.
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 lautet "InfographicHTML". Folgende Formate sind ebenfalls verfügbar: PDF, XLSX, S.XLSX, HTML, S.XML, ZIP, CVS, PAGX und InfographicPDF.

String
Berichtsfelder
(optional)

Die zusätzlichen Felder, die dem Bericht hinzugefügt werden

Field
Reiserichtung
(optional)

Gibt an, ob die Reisezeiten oder -strecken von den Positionspunkten zu den Eingabe-Features oder von den Eingabe-Features zu den Positionspunkten gemessen werden.

  • In Richtung Eingabe-FeaturesEs wird die Reiserichtung von Positionspunkten zu Eingabe-Features verwendet. Dies ist die Standardeinstellung.
  • Weg von Eingabe-FeaturesEs wird die Reiserichtung von Eingabe-Features zu Positionspunkten verwendet.
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.

  • UTCVerwendet wird die koordinierte Weltzeit (UTC). Wählen Sie diese Option aus, wenn Sie den besten Standort für einen bestimmten Zeitpunkt (z. B. jetzt) finden möchten, sich jedoch nicht sicher sind, in welcher Zeitzone sich der Wert für in_location_points befindet.
  • Lokale Zeit an StandortenVerwendet wird die Zeitzone, in der sich der Wert für in_location_points befindet. Wenn die gewählte Reiserichtung von den Eingabe-Features zu den Positionspunkten führt, entspricht dieser Parameter der Zeitzone der Eingabe-Features. Wenn die gewählte Reiserichtung von den Positionspunkten zu den Eingabe-Features führt, entspricht dieser Parameter der Zeitzone der Positionspunkte. Dies ist die Standardeinstellung.
  • UTCVerwendet wird die koordinierte Weltzeit (UTC). Wählen Sie diese Option aus, wenn Sie den besten Standort für einen bestimmten Zeitpunkt (z. B. jetzt) finden möchten, sich jedoch nicht sicher sind, in welcher Zeitzone sich der Wert für die Positionspunkte befindet.
  • Lokale Zeit an StandortenVerwendet wird die Zeitzone, in der sich der Wert für die Positionspunkte befindet. Wenn die gewählte Reiserichtung von den Eingabe-Features zu den Positionspunkten führt, entspricht dieser Parameter der Zeitzone der Eingabe-Features. Wenn die gewählte Reiserichtung von den Positionspunkten zu den Eingabe-Features führt, entspricht dieser Parameter der Zeitzone der Positionspunkte. Dies ist die Standardeinstellung.
String
Suchtoleranz
(optional)

Die maximale Entfernung der Eingabe-Punkte vom Netzwerk. Punkte außerhalb der Suchtoleranz werden von der Verarbeitung ausgeschlossen.

Linear Unit

Abgeleitete Ausgabe

BeschriftungErläuterungDatentyp
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})
NameErläuterungDatentyp
in_features

Der Punkt-Layer, für den eine Messung in Richtung oder weg von in_location_points durchgeführt wird

Feature Layer
id_field

Ein Feld mit eindeutigen Identifikatoren für die einzelnen Eingabe-Features

Field
in_location_points

Der Layer, aus dem die Ausgabe erstellt wird, die Entfernungs- und Richtungsattribute zu bzw. ausgehend von in_features enthält

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_REPORTEs wird ein Bericht erstellt.
  • DO_NOT_CREATE_REPORTEs wird kein Bericht erstellt. Dies ist die Standardeinstellung.
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 lautet "InfographicHTML". Folgende Formate sind ebenfalls verfügbar: PDF, XLSX, S.XLSX, HTML, S.XML, ZIP, CVS, PAGX und InfographicPDF.

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 -strecken von den Positionspunkten zu den Eingabe-Features oder von den Eingabe-Features zu den Positionspunkten gemessen werden.

  • TOWARD_STORESEs wird die Reiserichtung von Positionspunkten zu Eingabe-Features verwendet. Dies ist die Standardeinstellung.
  • AWAY_FROM_STORESEs wird die Reiserichtung von Eingabe-Features zu Positionspunkten verwendet.
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.

  • UTCVerwendet wird die koordinierte Weltzeit (UTC). Wählen Sie diese Option aus, wenn Sie den besten Standort für einen bestimmten Zeitpunkt (z. B. jetzt) finden möchten, sich jedoch nicht sicher sind, in welcher Zeitzone sich der Wert für in_location_points befindet.
  • TIME_ZONE_AT_LOCATIONVerwendet wird die Zeitzone, in der sich der Wert für in_location_points befindet. Wenn die gewählte Reiserichtung von den Eingabe-Features zu den Positionspunkten führt, entspricht dieser Parameter der Zeitzone der Eingabe-Features. Wenn die gewählte Reiserichtung von den Positionspunkten zu den Eingabe-Features führt, entspricht dieser Parameter der Zeitzone der Positionspunkte. Dies ist die Standardeinstellung.
String
search_tolerance
(optional)

Die maximale Entfernung der Eingabe-Punkte vom Netzwerk. Punkte außerhalb der Suchtoleranz werden von der Verarbeitung ausgeschlossen.

Linear Unit

Abgeleitete Ausgabe

NameErläuterungDatentyp
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_2020"
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")

Lizenzinformationen

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

Verwandte Themen