Zusammenfassung
Geokodiert gehostete Tabellen mit in einem ArcGIS Enterprise-Portal gehosteten Locators. Dadurch wird ein gehosteter Feature-Layer mit den geokodierten Ergebnissen erstellt.
Dieses Werkzeug automatisiert den Prozess zur Geokodierung von Tabellen, die im Portal veröffentlicht wurden, und speichert die Ausgabe im Portal. Wenn Sie die Geokodierungsergebnisse nicht im Portal speichern müssen, verwenden Sie den Bereich Tabelle geokodieren oder das Werkzeug Adressen geokodieren.
Hinweis:
Zum Ausführen dieses Werkzeugs müssen Sie über Publisher- oder Administratorberechtigungen im Portal verfügen. Wenn Sie Mitglied einer benutzerdefinierten Rolle sind, müssen Sie sicherstellen, dass Ihnen vom Portal-Administrator die Berechtigung zum Veröffentlichen gehosteter Web-Layer erteilt wurde.
Verwendung
Sie können Adressen geokodieren, die in einem einzelnen Feld oder in mehreren Feldern gespeichert sind. Die vollständige Adresse ist in einem einzelnen Eingabefeld gespeichert, z. B. 303 Peachtree St NE, Atlanta, GA 30308. Mehrere Felder werden unterstützt, wenn die Eingabeadressen in mehrere Felder wie "Address", "City", "State" und "ZIP" für eine allgemeine US-amerikanische Adresse unterteilt sind.
Einige Locators unterstützen mehrere Eingabe-Adressfelder wie "Address", "Address2" und "Address3". In diesem Fall kann das Adressenelement auf mehrere Felder aufgeteilt werden. Zum Zeitpunkt der Geokodierung werden die Adressfelder dann verkettet. Beispielsweise werden sowohl "100", "Main st" und "Apt 140" als Angabe in drei Feldern als auch "100 Main st" und "Apt 140" in zwei Feldern bei der Geokodierung zu "100 Main st Apt 140" verkettet.
Zur Verwendung dieses Werkzeugs ist ArcGIS Enterprise 10.6 oder höher erforderlich.
Durch Verwenden eines Locators in dem ArcGIS Enterprise-Portal, das für die Verwendung von mehreren Threads konfiguriert wurde, lässt sich die Performance der Geokodierung verbessern.
Für dieses Werkzeug muss eine gehostete oder in einem ArcGIS Enterprise-Portal veröffentlichte Tabelle als Eingabetabelle verwendet werden. Gehostete Tabellen werden als Teil von gehosteten Feature-Layern betrachtet und müssen als Element im Portal erstellt werden, bevor sie im Werkzeug verwendet werden können. Weitere Informationen finden Sie unter Veröffentlichen von gehosteten Feature-Layern.
Der gehostete Ausgabe-Feature-Layer wird im gleichen Raumbezug wie der Adressen-Locator gespeichert. Sie können den Raumbezug des Ausgabe-Feature-Layer ändern, indem Sie in den Umgebungseinstellungen des Werkzeugs ein anderes Ausgabe-Koordinatensystem festlegen.
Der gehostete Ausgabe-Feature-Layer enthält alle relevanten Geokodierungsinformationen, z. B. Punktzahl, Status und die abgeglichenen Adressen der einzelnen Datensätze, sowie die Werte aus der ursprünglichen Eingabetabelle. Die Adressen können mithilfe des Werkzeugs Adressen erneut abgleichen oder der Option Adressen erneut abgleichen, die im Bereich Adressen erneut abgleichen aufgerufen wird, erneut abgeglichen werden. Die Geokodierungsergebnisse aus diesem Werkzeug enthalten einen statischen Snapshot der ursprünglichen Eingabetabelle. Deshalb werden die Ergebnisse im Ausgabe-Feature-Service nach dem Hinzufügen oder Aktualisieren von Werten in der ursprünglichen Tabelle nicht aktualisiert. Das Werkzeug muss erneut ausgeführt werden, um einen neuen Ausgabe-Feature-Service mit diesen Änderungen zu erstellen.
Weitere Informationen zum erneuten Abgleichen von Geokodierungsergebnissen.
Syntax
arcpy.geocoding.GeocodeLocationsFromTable(in_table, in_address_locator, address_fields, output_name, {country}, {location_type}, {category}, {output_fields})| Parameter | Erklärung | Datentyp |
in_table | Die Tabelle im Portal mit den Adressen oder Orten, die geokodiert werden sollen. | Record Set |
in_address_locator | Der Portal-Locator, der für die Geokodierung der Eingabetabelle aus dem Portal verwendet wird. Sie können einen Locator aus der Liste der Locators im aktiven Portal auswählen oder im aktiven Portal nach anderen verfügbaren Locators suchen. Locators, die im aktiven Portal als Utility-Services festgelegt wurden, sind standardmäßig verfügbar. Wenn sich der Portal-Locator, den Sie verwenden möchten, nicht in der ausgefüllten Liste befindet, bitten Sie den Portal-Administrator darum, den Locator als Portal-Utility-Service hinzuzufügen, und konfigurieren Sie Batch-Geokodierung im Locator. Hinweis:Der ArcGIS World Geocoding Service ist für dieses Werkzeug deaktiviert. Verwenden Sie das Werkzeug Adressen geokodieren, wenn Sie den ArcGIS World Geocoding Service verwenden möchten. | Address Locator |
address_fields [input_locator_field, table_field_name] | Jede Feldzuordnung dieses Parameters weist das Format input_locator_field, table_field_name auf. Hierbei ist input_locator_field der Name des vom Locator verwendeten Eingabe-Adressfeldes und table_field_name der Name des entsprechenden Feldes in der Adresstabelle, die Sie geokodieren möchten. Sie können ein einzelnes Eingabefeld festlegen, in dem die vollständige Adresse gespeichert wird, zum Beispiel "303 Peachtree St NE, Atlanta, GA 30308". Sie haben auch die Möglichkeit, mehrere Felder anzugeben, wenn die Eingabeadressen in mehrere Felder wie "Address", "City", "State" und "ZIP" für eine allgemeine US-amerikanische Adresse unterteilt sind. Einige Locators unterstützen mehrere Eingabe-Adressfelder wie "Address", "Address2" und "Address3". In diesem Fall kann das Adressenelement auf mehrere Felder aufgeteilt werden. Zum Zeitpunkt der Geokodierung werden die Adressfelder dann verkettet. Beispielsweise werden sowohl "100", "Main st" und "Apt 140" als Angabe in drei Feldern als auch "100 Main st" und "Apt 140" in zwei Feldern bei der Geokodierung zu "100 Main st Apt 140" verkettet. Wenn Sie ein optionales, vom Locator verwendetes Eingabe-Adressfeld keinem Feld in der Eingabe-Adresstabelle zuordnen möchten, wählen Sie <None> anstelle eines Feldnamens. | Field Info |
output_name | Der Name des geokodierten Ausgabe-Feature-Layers, der im Portal erstellt wird. | String |
country [country,...] (optional) | Das Land oder die Länder für die Suche nach den geokodierten Adressen. Dieser Parameter ist für Locators verfügbar, die das Land als Parameter unterstützen. Damit wird die Geokodierung auf die ausgewählten Länder beschränkt. Durch die Auswahl von Ländern wird in den meisten Fällen die Genauigkeit der Geokodierung verbessert. Wenn ein Feld für Länder im Parameter Eingabetabelle dem Eingabe-Adressfeld Country zugeordnet wird, wird mit dem Landeswert des Parameters Eingabetabelle der Parameter Land überschrieben. Wenn kein Land angegeben wird, erfolgt die Geokodierung unter Verwendung aller unterstützten Länder des Locators. Geben Sie den Eingabewert als dreistelligen Ländercode gemäß ISO 3166-1 an. Der Parameter Land wird nicht für alle Locators unterstützt. | String |
location_type (optional) | Gibt die bevorzugte Ausgabegeometrie für POINT_ADDRESS-Übereinstimmungen an. Die Optionen für diesen Parameter lauten ROUTING_LOCATION, d. h. die Straßenseitenposition, die für das Routing verwendet werden kann, und ADDRESS_LOCATION, d. h. die Position, die den Dach- oder Flurstücksschwerpunkt für die Adresse oder den Hauseingang darstellt. Wenn die bevorzugte Position in den Daten nicht vorhanden ist, wird die Standardposition von ROUTING_LOCATION zurückgegeben. Bei Geokodierungsergebnissen mit Addr_type=PointAddress beschreiben die XY-Attributwerte die Koordinaten der Adresse entlang der Straße, während die DisplayX- und DisplayY-Werte die Koordinaten für den Dach- bzw. den Gebäudeschwerpunkt beschreiben. In der REST-API-Webhilfe finden Sie weitere Informationen zum Parameter locationType für reverseGeocode. Dieser Parameter wird nicht für alle Locators unterstützt.
| String |
category [category,...] (optional) | Begrenzt die Typen der Orte, nach denen der Locator sucht. Dadurch werden falsche positive Übereinstimmungen verhindert und der Suchvorgang potenziell beschleunigt. Wenn keine Kategorie verwendet wird, wird die Geokodierung unter Verwendung aller unterstützten Kategorien ausgeführt. Nicht alle Kategoriewerte werden für alle Positionen und Länder unterstützt. Generell kann der Parameter Kategorie für Folgendes verwendet werden:
Dieser Parameter wird nicht für alle Locators unterstützt. In der REST-API-Webhilfe finden Sie weitere Informationen zum Filtern von Kategorien. | String |
output_fields (optional) | Gibt an, welche Locator-Ausgabefelder in den Geokodierungsergebnissen zurückgegeben werden. Hinweis:Dieser Parameter kann mit Eingabe-Locators verwendet werden, die mit dem Werkzeug Locator erstellen oder mit dem Werkzeug Feature-Locator erstellen erstellt wurden, das in Enterprise 10.9 oder höher veröffentlicht wurde. Von kombinierten Locators, die mindestens einen Locator enthalten, der mit dem Werkzeug Adressen-Locator erstellen erstellt wurde, wird dieser Parameter nicht unterstützt.
| String |
Abgeleitete Ausgabe
| Name | Erklärung | Datentyp |
| output_layer | Ein Hyperlink zum geokodierten Ausgabe-Feature-Layer mit den Ergebnissen im Portal. Der Name des Feature-Layers wird von dem Wert für Name des Ausgabe-Feature-Layers abgeleitet. | Feature Set |
Codebeispiel
Das folgende eigenständige Skript veranschaulicht, wie die Funktion GeocodeLocationsFromTable zum Geokodieren einen gehosteten Tabellen-Layers verwendet wird.
import arcpy
arcpy.SignInToPortal("https://<machine_name>/<portal_web_adaptor_name>",
'<username>', '<password>')
# Input is a hosted table
input_table = "https://<machine_name>/server/rest/services/Hosted/<item_name>/FeatureServer/<table_number>"
# This tool works with locators on your Portal
in_locator = "https://<machine_name>/server/rest/services/<locator_name>/GeocodeServer/<locator_name>"
# The easiest way to generate a field mapping is by running the tool in ArcGIS
# Pro and Right-click the green success ribbon and click "Copy Python command"
field_mapping = "'Street or Intersection' address VISIBLE NONE;'City or Placename' <None> VISIBLE NONE;State <None> VISIBLE NONE;'ZIP Code' zip VISIBLE NONE"
output_name = "geocoding_output"
# Optional geocoding parameters. Only some are supported depending on the
# in_locator that you use.
country = None
location_type = None
category = None
# Note that the output is a hosted feature layer on your portal. To retrieve the
# output, go to your portal and look for a new item with the output_name that
# you entered.
arcpy.geocoding.GeocodeLocationsFromTable(input_table, in_locator,
field_mapping, output_name, country,
location_type, category)Umgebungen
Lizenzinformationen
- Basic: Erfordert Ihr Konto in ArcGIS Enterprise für die Berechtigung zum Durchführen von Analysen
- Standard: Erfordert Ihr Konto in ArcGIS Enterprise für die Berechtigung zum Durchführen von Analysen
- Advanced: Erfordert Ihr Konto in ArcGIS Enterprise für die Berechtigung zum Durchführen von Analysen