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.

  • Bei Interpretieren des Berichts zu "Nächstgelegene Positionen suchen" handelt es sich um ein PDF-Dokument, in dem die unterschiedlichen Abschnitte und Elemente des Berichts zu "Nächstgelegene Positionen suchen" erklärt werden.

Parameter

BeschriftungErläuterungDatentyp
Eingabe-Features

Der Punkt-Layer, für den eine Messung in Richtung oder ausgehend vom Parameterwert Positionspunkte 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 in Richtung bzw. ausgehend vom Parameterwert 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 -entfernungen 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 PositionenVerwendet 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 PositionenVerwendet wird die Zeitzone, in der sich der Wert für 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
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

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}, {location_name})
NameErläuterungDatentyp
in_features

Der Punkt-Layer, für den eine Messung in Richtung oder ausgehend vom Parameterwert 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 in Richtung bzw. ausgehend vom Parameterwert 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 -entfernungen 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
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

NameErläuterungDatentyp
output_report

Die Ausgabeberichtsdatei.

File

Codebeispiel

FindNearbyLocations – Beispiel (eigenständiges Skript)

Das folgende Skript für das 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