Beschriftung | Erläuterung | Datentyp |
Eingabe-Locator | Der Locator (.loc-Datei), der ausgeschnitten wird. Hinweis:Geokodierungsservices oder kombinierte Locators, die Geokodierungsservices enthalten, einschließlich Services von ArcGIS Enterprise oder ArcGIS Online, da beteiligte Locators nicht unterstützt werden. Handelt es sich bei dem Service um einen beteiligten Locator in einem kombinierten Locator, wird er nicht ausgeschnitten. | Address Locator |
Ausgabe-Locator | Der ausgeschnittene Ausgabe-Locator (.loc-Datei). | Address Locator |
Interessenbereich (optional) | Der Polygon-Layer, der einen Interessenbereich definiert, der für das Ausschneiden des Locators verwendet wird. Dieser Parameter überschreibt den Parameter Ausdehnung. | Feature Layer |
Ausdehnung (optional) | Gibt die Ausdehnung an, die für das Ausschneiden des Locators verwendet wird.
| Extent |
Zusammenfassung
Schneidet einen Locator basierend auf einem Interessenbereich oder einer Ausdehnung aus und erstellt einen Locator mit kleiner Ausdehnung und geringerer Größe.
Verwendung
Dieses Werkzeug kann einen Locator basierend auf Features in einem Layer, ausgewählten Features in einem Layer oder einer Ausdehnung ausschneiden. Die Ausgabe ist ein neuer Locator mit kleinerer Ausdehnung.
Wenn Sie Orte in einem bestimmten Untersuchungsgebiet geokodieren, schneiden Sie mit diesem Werkzeug den Locator auf dieses Gebiet aus, um die Größe des Locators zu reduzieren und nur Geokodierungsergebnisse innerhalb der kleineren Ausdehnung zurückzugeben. Wenn der Locator ausgeschnitten ist, werden die im Locator indizierten Referenzdaten auch ausgeschnitten. Wenn Adressen außerhalb der Ausdehnung des ausgeschnittenen Locators gesucht werden, werden keine Ergebnisse zurückgegeben.
Um Locators in ArcGIS StreetMap Premium auszuschneiden, ist eine ArcGIS StreetMap Premium Lizenz erforderlich.
Wenn der Wert für den Eingabe-Locator ein kombinierter Locator ist, werden die beteiligten Locators eines kombinierten Locators ausgeschnitten und in einem Unterordner des Ausgabeverzeichnisses gespeichert. Der kombinierte Locator wird in dem Ausgabeverzeichnis gespeichert.
Geokodierungsservices, die beteiligte Locators in einem kombinierten Locator sind, werden nicht ausgeschnitten.
Parameter
arcpy.geocoding.ClipLocator(in_locator, out_locator, {area_of_interest}, {extent})
Name | Erläuterung | Datentyp |
in_locator | Der Locator (.loc-Datei), der ausgeschnitten wird. Hinweis:Geokodierungsservices oder kombinierte Locators, die Geokodierungsservices enthalten, einschließlich Services von ArcGIS Enterprise oder ArcGIS Online, da beteiligte Locators nicht unterstützt werden. Handelt es sich bei dem Service um einen beteiligten Locator in einem kombinierten Locator, wird er nicht ausgeschnitten. | Address Locator |
out_locator | Der ausgeschnittene Ausgabe-Locator (.loc-Datei). | Address Locator |
area_of_interest (optional) | Der Polygon-Layer, der einen Interessenbereich definiert, der für das Ausschneiden des Locators verwendet wird. Dieser Parameter überschreibt den Parameter extent. | Feature Layer |
extent (optional) | Gibt die Ausdehnung an, die für das Ausschneiden des Locators verwendet wird.
| Extent |
Codebeispiel
Schneiden Sie den USA-Locator mit einem Landkreis-Polygon aus.
import arcpy
usa_locator = r"C:\Data\USA.loc"
my_clipped_locator = r"C:\Data\SanDiego.loc"
my_san_diego_polygon_layer = r"C:\Data\SanDiegoCounty.shp"
# Run ClipLocator
arcpy.geocoding.ClipLocator(usa_locator, my_clipped_locator, my_san_diego_polygon_layer)
Schneiden Sie den USA-Locator mit einer Ausdehnung aus.
import arcpy
usa_locator = r"C:\Data\USA.loc"
my_clipped_locator = r"C:\Data\SanDiego.loc"
# Define the extent using an arcpy Extent object
my_san_diego_extent = arcpy.Extent(
-13115569.084655, 3826591.24577018, -12897364.810527, 3969918.09780486,
spatial_reference=arcpy.SpatialReference('WGS 1984 Web Mercator (auxiliary sphere)'))
# Run ClipLocator
arcpy.geocoding.ClipLocator(usa_locator, my_clipped_locator, None, my_san_diego_extent)