Near (Analysis Tools)

Zusammenfassung

Berechnet die Entfernung und andere Nachbarschaftsinformationen zwischen Features in einer oder mehreren Feature-Classes oder Layern.

Weitere Informationen zum Berechnen der Nähe mit Geoverarbeitungswerkzeugen

Abbildung

Verwendung

Die folgenden Felder werden der Eingabe hinzugefügt. Wenn die Felder bereits vorhanden sind, werden die Feldwerte aktualisiert. Diese Feldnamen können mit dem Parameter Feldnamen konfiguriert werden.
- NEAR_FID—Die Objekt-ID des nächstgelegenen Features. Wenn kein Near-Feature gefunden wird, ist der Wert -1.
- NEAR_DIST—Die Entfernung vom Eingabe-Feature zum Near-Feature. Der Wert wird in der linearen Einheit des Koordinatensystems des Eingabe-Features oder in Metern angegeben, wenn für den Parameter Methode der Wert Geodätisch festgelegt wurde und die Eingabe sich in einem geographischen Koordinatensystem befindet. Wenn kein Near-Feature gefunden wird, ist der Wert -1.
- NEAR_FC—Der Pfad der Quell-Feature-Class, die das nächstgelegene gefundene Feature enthält. Der Layer-Name wird verwendet, wenn Layer als Eingabe verwendet werden, und der Katalogpfad zur Feature-Class wird verwendet, wenn Pfade als Eingabe verwendet werden. Dieses Feld wird nur dann der Ausgabetabelle hinzugefügt, wenn mehrere Near-Features angegeben wurden. Wenn kein Near-Feature gefunden wird, ist der Wert eine leere Zeichenfolge oder Null.
Die folgenden Felder werden der Eingabe hinzugefügt, wenn der Parameter Position aktiviert ist. Die Feldwerte werden aktualisiert, wenn die Felder bereits vorhanden sind. Die Einheiten der Feldwerte hängen von dem Wert des Parameters Methode ab. Wenn der Parameter Methode auf Planar festgelegt ist, liegt der Feldwert in der linearen Einheit des Koordinatensystems des Eingabe-Features vor. Bei Festlegung auf Geodätisch wird er in dem geographischen Koordinatensystem angegeben, das mit dem Koordinatensystem des Eingabe-Features verknüpft ist.
- NEAR_X—Die X-Koordinate der Position im Near-Feature, das dem Eingabe-Feature am nächsten liegt. Wenn kein Near-Feature gefunden wird, ist der Wert -1.
- NEAR_Y—Die Y-Koordinate der Position im Near-Feature, das dem Eingabe-Feature am nächsten liegt Wenn kein Near-Feature gefunden wird, ist der Wert -1.
Das folgende Feld wird den Eingabe-Features hinzugefügt, wenn der Parameter Winkel aktiviert ist. Der Feldwert wird aktualisiert, wenn das Feld bereits vorhanden ist.
- NEAR_ANGLE—Der Winkel der Linie an der FROM_X- und FROM_Y-Position, die die Eingabe-Features mit dem Near-Feature verbindet. Wenn kein Near-Feature gefunden wird oder das Near-Feature sich mit dem Eingabe-Feature überschneidet, ist der Wert 0.
Der Wert für NEAR_FID und NEAR_DIST ist -1, wenn kein Feature innerhalb eines Suchradius gefunden wird.
Die Eingabe- und Near-Features können Punkt, Multipoint, Linie oder Polygon sein.
Der Parameterwert Near-Features kann eine oder mehrere Feature-Classes mit unterschiedlichen Shape-Typen (Punkt, Multipoint, Linie oder Polygon) umfassen.
Um die Entfernung und weitere Nachbarschaftsinformationen in einer einzelnen Feature-Class oder in einem einzelnen Feature-Layer zu berechnen, kann dieselbe Feature-Class bzw. derselbe Feature-Layer verwendet werden. In diesem Fall wird das ausgewertete Eingabe-Feature aus den Near-Feature-Kandidaten ausgeschlossen, um zu vermeiden, dass die Features jeweils das nächstgelegene Feature für sich selbst darstellen.
Eingabe-Features können ein Layer sein, bei dem Sie eine Auswahl getroffen haben. Die ausgewählten Features werden während der Werkzeuganwendung verwendet und aktualisiert. Bei den übrigen Features werden die Werte der neu erstellten Felder (z. B. NEAR_FID und NEAR_DIST) auf -1 gesetzt.
Wenn mehr als ein Near-Feature die gleiche kürzeste Entfernung vom Eingabe-Feature aufweist, wird eines davon nach dem Zufallsprinzip als nächstgelegenes Feature ausgewählt.
Verwenden Sie bei Verwendung der Option Planar für den Parameter Methode für die Eingabe-Features eine Projektion, die für den Entfernungsmesswert geeignet ist, z. B. eine äquidistante Projektion.

Weitere Informationen zu Koordinatensystemen und Projektionen
Um die Positionen NEAR_X und NEAR_Y zu visualisieren, kann die Ausgabetabelle als Eingabe für das Werkzeug XY-Ereignis-Layer erstellen oder XY in Linie verwendet werden.
You can set a unit of measurement for the NEAR_DIST festlegen, z. B. Meter, Kilometer oder Meilen, indem Sie den Parameter Entfernungseinheit verwenden.
Dieses Werkzeug unterstützt die Suche nach dem nächstgelegenen Feature für jede Eingabe mehrerer Parameterwerte für Near-Features.

Beschriftung	Erläuterung	Datentyp
Eingabe-Features	Die Eingabe-Features können vom Typ "Punkt", "Polylinie", "Polygon" oder "Multipoint" sein.	Feature Layer
Near-Features	Ein oder mehrere Feature-Layer oder Feature-Classes mit Near-Feature-Kandidaten. Die Near-Features können vom Typ "Punkt", "Polylinie", "Polygon" oder "Multipoint" sein. Wenn mehrere Layer oder Feature-Classes angegeben werden, wird der Eingabetabelle das Feld `NEAR_FC` hinzugefügt. Darin werden die Pfade der Quell-Feature-Class mit dem nächstgelegenen Feature gespeichert. Eine Feature-Class oder ein Layer kann sowohl als Eingabe-Feature als auch als Near-Feature verwendet werden.	Feature Layer
Suchradius (Optional)	Der zum Suchen nach Near-Features verwendete Radius. Wenn kein Wert angegeben wird, werden alle Near-Features berücksichtigt. Wenn eine Entfernung eingegeben, jedoch keine Einheit oder "Unbekannt" angegeben wurde, werden die Einheiten des Koordinatensystems der Eingabe-Features verwendet. Bei Verwendung der Option Geodätisch für den Parameter Methode ist eine lineare Einheit wie Kilometer oder Meilen zu verwenden.	Linear Unit
Position (Optional)	Gibt an, ob X- und Y-Koordinaten der nächstgelegenen Position des nächsten Near-Features in die Felder `NEAR_X` und `NEAR_Y` geschrieben werden. Aktiviert—Die Positionen werden in die Felder geschrieben. Deaktiviert—Die Positionen werden nicht in die Felder geschrieben. Dies ist die Standardeinstellung.	Boolean
Winkel (Optional)	Gibt an, ob der nächstgelegene Winkel berechnet und in das Feld `NEAR_ANGLE` der Ausgabetabelle geschrieben wird. Der nächstgelegene Winkel misst die Richtung der Linie, die ein Eingabe-Feature mit dem diesem zunächst liegenden Feature an der nächstgelegenen Position verbindet. Bei Verwendung der Methode `PLANAR` für den Parameter `method` liegt der Winkel im Bereich -180° bis 180°, wobei 0° Osten, 90° Norden, 180° (oder -180°) Westen und -90° Süden bedeutet. Bei Verwendung der Methode `GEODESIC` für den Parameter `method` liegt der Winkel im Bereich -180° bis 180°, wobei 0° Norden, 90° Osten, 180° (oder -180°) Süden und -90° Westen bedeutet. Aktiviert—Der nächstgelegene Winkel wird berechnet und in das Feld `NEAR_ANGLE` geschrieben. Deaktiviert—Der nächstgelegene Winkel wird nicht berechnet oder in das Feld `NEAR_ANGLE` geschrieben. Dies ist die Standardeinstellung.	Boolean
Methode (Optional)	Gibt an, ob der kürzeste Pfad für einen Sphäroiden (geodätisch) oder eine Ebene (planar) als Entfernungsmethode verwendet werden soll. Es wird dringend empfohlen, für Daten, die in einem nicht für Entfernungsmesswerte geeigneten Koordinatensystem (z. B. Web Mercator und geographische Koordinatensysteme) gespeichert sind, sowie für Datasets, die einen großen geographischen Bereich umfassen, die Methode Geodätisch zu verwenden. Planar—Zwischen Features wird die planare Entfernung verwendet. Dies ist die Standardeinstellung. Geodätisch—Zwischen den Features wird die geodätische Entfernung verwendet. Bei dieser Methode wird die Krümmung des Sphäroiden berücksichtigt, und die Daten in der Nähe der internationalen Datumsgrenze und der Pole werden richtig verarbeitet.	String
Feldnamen (Optional)	Die Namen der Attributfelder an, die bei der Verarbeitung hinzugefügt werden. Wenn dieser Parameter nicht verwendet wird oder Felder hinzugefügt werden, die von diesem Parameter ausgeschlossen sind, werden die standardmäßigen Feldnamen verwendet. Standardmäßig werden die Felder `NEAR_FID` und `NEAR_DIST` hinzugefügt. Die Felder `NEAR_X` und `NEAR_Y` werden hinzugefügt, wenn der Parameter Position aktiviert ist. Das Feld `NEAR_ANGLE` wird hinzugefügt, wenn der Parameter Winkel aktiviert ist, und das Feld `NEAR_FC` wird hinzugefügt, wenn mehrere Eingaben verwendet werden. Optional können Sie bei mehreren Parameterwerten für Near-Features eine `Near Features`-Spalte angeben, um die Eingabe festzulegen, auf der das Feld basieren soll. Spalten der Wertetabelle: Property—The property type. Feature ID—The object ID of the feature that is nearest will be added. Distance—The distance to the feature that is nearest will be added. Location x-coordinate—The x-coordinate of the feature that is nearest will be added. Location y-coordinate—The y-coordinate of the feature that is nearest will be added. Angle—The angle to the feature that is nearest will be added. Feature class—The name of the feature class with the nearest feature will be added. Field Name—The name of the attribute field to add to contain the specified Near property. Near Features—The near features that the field values will be based on.	Value Table
Entfernungseinheit (Optional)	Gibt die Messeinheit für das Feld `NEAR_DIST` an. Wenn keine Messeinheit angegeben ist, werden die Werte in dem Feld `NEAR_DIST` in der linearen Einheit des Koordinatensystems des Eingabe-Features angegeben. Wenn sich die Eingabe in einem geographischen Koordinatensystem befindet und die geodätische Methode verwendet wird, lauten die Einheiten des Feldes `NEAR_DIST` Meter. Kilometer—Die Einheit ist Kilometer. Meter—Die Einheit ist Meter. Seemeilen (International)—Die Einheit ist Seemeilen (International). Meilen (Britisch)—Die Einheit ist Meilen (Britisch). Yards (International)—Die Einheit ist Yards (International). Fuß (International)—Die Einheit ist Fuß (International). Seemeilen (US Survey)—Die Einheit ist Seemeile (US Survey). Meilen (US Survey)—Die Einheit ist Meile (US Survey). Yards (US Survey)—Die Einheit ist Yard (US Survey). Fuß (US Survey)—Die Einheit ist Fuß (US Survey).	String
Felder abgleichen (Optional)	Die Feldpaare aus den Eingabe-Features und den Near-Features, die für den Attributabgleich verwendet werden. In der Near-Berechnung werden nur Near-Features verwendet, die gemeinsame Abgleich-Feldwerte mit den Eingabe-Features aufweisen. Spalten der Wertetabelle: Input Fields—Fields from the input features that will be used for attribute matching. Near Fields—Fields from the near features that will be used for attribute matching.	Value Table

Abgeleitete Ausgabe

Beschriftung	Erläuterung	Datentyp
Aktualisierte Eingabe-Features	Die aktualisierten Eingabe-Features.	Feature Layer

arcpy.analysis.Near(in_features, near_features, {search_radius}, {location}, {angle}, {method}, {field_names}, {distance_unit}, {match_fields})

Name	Erläuterung	Datentyp
in_features	Die Eingabe-Features können vom Typ "Punkt", "Polylinie", "Polygon" oder "Multipoint" sein.	Feature Layer
near_features [near_features,...]	Ein oder mehrere Feature-Layer oder Feature-Classes mit Near-Feature-Kandidaten. Die Near-Features können vom Typ "Punkt", "Polylinie", "Polygon" oder "Multipoint" sein. Wenn mehrere Layer oder Feature-Classes angegeben werden, wird der Eingabetabelle das Feld `NEAR_FC` hinzugefügt. Darin werden die Pfade der Quell-Feature-Class mit dem nächstgelegenen Feature gespeichert. Eine Feature-Class oder ein Layer kann sowohl als Eingabe-Feature als auch als Near-Feature verwendet werden.	Feature Layer
search_radius (Optional)	Der zum Suchen nach Near-Features verwendete Radius. Wenn kein Wert angegeben wird, werden alle Near-Features berücksichtigt. Wenn eine Entfernung eingegeben, jedoch keine Einheit oder "Unbekannt" angegeben wurde, werden die Einheiten des Koordinatensystems der Eingabe-Features verwendet. Bei Verwendung der Option `GEODESIC` für den Parameter `method` ist eine lineare Einheit wie Kilometer oder Meilen zu verwenden.	Linear Unit
location (Optional)	Gibt an, ob X- und Y-Koordinaten der nächstgelegenen Position des nächsten Near-Features in die Felder `NEAR_X` und `NEAR_Y` geschrieben werden. `LOCATION`—Die Positionen werden in die Felder geschrieben. `NO_LOCATION`—Die Positionen werden nicht in die Felder geschrieben. Dies ist die Standardeinstellung.	Boolean
angle (Optional)	Gibt an, ob der nächstgelegene Winkel berechnet und in das Feld `NEAR_ANGLE` der Ausgabetabelle geschrieben wird. Der nächstgelegene Winkel misst die Richtung der Linie, die ein Eingabe-Feature mit dem diesem zunächst liegenden Feature an der nächstgelegenen Position verbindet. Bei Verwendung der Methode `PLANAR` für den Parameter `method` liegt der Winkel im Bereich -180° bis 180°, wobei 0° Osten, 90° Norden, 180° (oder -180°) Westen und -90° Süden bedeutet. Bei Verwendung der Methode `GEODESIC` für den Parameter `method` liegt der Winkel im Bereich -180° bis 180°, wobei 0° Norden, 90° Osten, 180° (oder -180°) Süden und -90° Westen bedeutet. `ANGLE`—Der nächstgelegene Winkel wird berechnet und in das Feld `NEAR_ANGLE` geschrieben. `NO_ANGLE`—Der nächstgelegene Winkel wird nicht berechnet oder in das Feld `NEAR_ANGLE` geschrieben. Dies ist die Standardeinstellung.	Boolean
method (Optional)	Gibt an, ob der kürzeste Pfad für einen Sphäroiden (geodätisch) oder eine Ebene (planar) als Entfernungsmethode verwendet werden soll. Es wird dringend empfohlen, für Daten, die in einem nicht für Entfernungsmesswerte geeigneten Koordinatensystem (z. B. Web Mercator und geographische Koordinatensysteme) gespeichert sind, sowie für Datasets, die einen großen geographischen Bereich umfassen, die Methode `GEODESIC` zu verwenden. `PLANAR`—Zwischen Features wird die planare Entfernung verwendet. Dies ist die Standardeinstellung. `GEODESIC`—Zwischen den Features wird die geodätische Entfernung verwendet. Bei dieser Methode wird die Krümmung des Sphäroiden berücksichtigt, und die Daten in der Nähe der internationalen Datumsgrenze und der Pole werden richtig verarbeitet.	String
field_names [[property, fieldname],...] (Optional)	Die Namen der Attributfelder an, die bei der Verarbeitung hinzugefügt werden. Wenn dieser Parameter nicht verwendet wird oder Felder hinzugefügt werden, die von diesem Parameter ausgeschlossen sind, werden die standardmäßigen Feldnamen verwendet. Standardmäßig werden die Felder `NEAR_FID` und `NEAR_DIST` hinzugefügt. Die Felder `NEAR_X` und `NEAR_Y` werden hinzugefügt, wenn der Parameter `location` auf `LOCATION` gesetzt ist. Das Feld `NEAR_ANGLE` wird hinzugefügt, wenn der Parameter `angle` auf `ANGLE` gesetzt ist. Und das Feld `NEAR_FC` wird hinzugefügt, wenn mehrere Eingaben verwendet werden. Optional können Sie bei mehreren Parameterwerten für `near_features` die Feature-Class oder den Feature-Layer einbeziehen, um die Eingabe festzulegen, auf der das Feld basieren soll. Spalten der Wertetabelle: `Property`—The property type. `NEAR_FID`—The object ID of the feature that is nearest will be added. `NEAR_DIST`—The distance to the feature that is nearest will be added. `NEAR_X`—The x-coordinate of the feature that is nearest will be added. `NEAR_Y`—The y-coordinate of the feature that is nearest will be added. `NEAR_ANGLE`—The angle to the feature that is nearest will be added. `NEAR_FC`—The name of the feature class with the nearest feature will be added. `Field Name`—The name of the attribute field to add to contain the specified Near property. `Near Features`—The near features that the field values will be based on.	Value Table
distance_unit (Optional)	Gibt die Messeinheit für das Feld `NEAR_DIST` an. Wenn keine Messeinheit angegeben ist, werden die Werte in dem Feld `NEAR_DIST` in der linearen Einheit des Koordinatensystems des Eingabe-Features angegeben. Wenn sich die Eingabe in einem geographischen Koordinatensystem befindet und die geodätische Methode verwendet wird, lauten die Einheiten des Feldes `NEAR_DIST` Meter. `Kilometers`—Die Einheit ist Kilometer. `Meters`—Die Einheit ist Meter. `NauticalMilesInt`—Die Einheit ist Seemeilen (International). `MilesInt`—Die Einheit ist Meilen (Britisch). `YardsInt`—Die Einheit ist Yards (International). `FeetInt`—Die Einheit ist Fuß (International). `NauticalMiles`—Die Einheit ist Seemeile (US Survey). `Miles`—Die Einheit ist Meile (US Survey). `Yards`—Die Einheit ist Yard (US Survey). `Feet`—Die Einheit ist Fuß (US Survey).	String
match_fields [[input_field, near_field],...] (Optional)	Die Feldpaare aus den Eingabe-Features und den Near-Features, die für den Attributabgleich verwendet werden. In der Near-Berechnung werden nur Near-Features verwendet, die gemeinsame Abgleich-Feldwerte mit den Eingabe-Features aufweisen. Spalten der Wertetabelle: `Input Fields`—Fields from the input features that will be used for attribute matching. `Near Fields`—Fields from the near features that will be used for attribute matching.	Value Table

Abgeleitete Ausgabe

Name	Erläuterung	Datentyp
out_feature_class	Die aktualisierten Eingabe-Features.	Feature Layer

Codebeispiel

Near: Beispiel 1 (Python-Fenster)

Das folgende Skript für das interaktive Python-Fenster veranschaulicht, wie die Funktion Near im unmittelbaren Modus verwendet wird.

import arcpy
arcpy.env.workspace = "C:/data/city.gdb"

# Find the nearest road from each house
arcpy.analysis.Near('houses', 'roads')

Near: Beispiel 2 (eigenständiges Skript)

Das folgende Python-Skript veranschaulicht die Verwendung der Funktion Near in einem eigenständigen Skript.

# Name: Near.py
# Description: Finds nearest features from input feature class to near feature class.

import arcpy

# Set workspace environment
arcpy.env.workspace = "C:/data/city.gdb"

try:
    # set local variables
    in_features = "houses"
    near_features = "parks"

    # find features only within search radius
    search_radius = "5000 Meters"

    # find location nearest features
    location = "LOCATION"

    # avoid getting angle of neares features
    angle = "NO_ANGLE"

    # run the function
    arcpy.analysis.Near(in_features, near_features, search_radius, location, angle)

    # get geoprocessing messages
    print(arcpy.GetMessages())

except arcpy.ExecuteError:
    print(arcpy.GetMessages(2))

except Exception as err:
    print(err.args[0])

Near: Beispiel 3 (eigenständiges Skript)

Das folgende Python-Skript veranschaulicht, wie der nächstgelegene Winkel in Azimut konvertiert wird.

# Name: near_angle_to_azimuth.py

import arcpy

# Near tool does not calculate angle in azimuths
# This script, using the output of the tool, converts the angles
# to azimuth angles.

in_table = r"C:/data/city.gdb/near_table"

angles = arcpy.da.SearchCursor(in_table, ["NEAR_ANGLE"])

azimuth_angles = []

with angles as rows:
    for row in rows:
        angle = row[0]
        if angle <= 180 and angle > 90:
            azimuth_angles.append(360.0 - (angle - 90))
        else:
            azimuth_angles.append(abs(angle - 90))

# Use these azimuth angles as necessary.

Near: Beispiel 4 (eigenständiges Skript)

Im folgenden Python-Skript wird die Nachbearbeitung mit der abgeleiteten Ausgabe der Funktion Near gezeigt. Das Skript ermittelt für jedes Near-Feature das nächstgelegene Eingabe-Feature.

# Name: features_closest_to_input.py

"""
    This script finds, for each input feature, a list of near feature it is closest to.
    If near features 6, 7, 10 are closest to input feature 3 then the
    resulting dictionary will have a list [6, 7, 10] as value for key 3
"""

import os
import arcpy

in_fc = r"C:\data\cities.gdb\cities_many"

# create a dictionary to hold the list of near ids for each input id
nearest_dict = dict()

with arcpy.da.SearchCursor(in_fc, ["OID@", "NEAR_FID"]) as rows:
    for row in rows:
        nearest_id = row[0]  # get OID value for that row
        input_id = row[1]    # get NEAR_FID value

        if input_id in nearest_dict:
            # if a dict key already exists, append near id to value list for that key
            nearest_dict[input_id].append(nearest_id)
        else:
            # if the key does not exist then create a new list with near id
            # and add it to the dictionary
            nearest_dict[input_id] = [nearest_id]

print(nearest_dict)

# output will look like:
# {1: [13, 28], 2: [2, 9, 14, 20, 22], 3: [11, 12, 24, 25]}

Umgebungen

Ausdehnung, Aktueller Workspace

Lizenzierungsinformationen

Basic: Ja
Standard: Ja
Advanced: Ja

Near (Analysis Tools)

Zusammenfassung

Abbildung

Verwendung

Parameter

Abgeleitete Ausgabe

Umgebungen

Lizenzierungsinformationen

Verwandte Themen