Kombinierten Adressen-Locator erstellen (Geocoding Tools)

Zusammenfassung

Erstellt einen kombinierten Locator. Ein kombinierter Locator besteht aus mindestens zwei einzelnen Locators, die das Abgleichen von Adressen und Orten mithilfe mehrerer Locators ermöglichen.

Weitere Informationen zu kombinierten Locators

Verwendung

Verwenden Sie vor dem Erstellen von kombinierten Locators das Werkzeug Locator erstellen oder Feature-Locator erstellen, um die beteiligten Locators zu erstellen.
Der kombinierte Locator muss einen gültigen Raumbezug aufweisen. Der Raumbezug des ersten beteiligten Locators wird verwendet, sofern Sie nicht in den Umgebungseinstellungen des Werkzeugs ein anderes Ausgabekoordinatensystem angeben.
Verwenden Sie die Option Nach Rolle und Punktzahl anordnen für den Parameter Ergebnisreihenfolge für einen Mehrfachrollen-Locator, einen ArcGIS StreetMap Premium-Locator (zum Beispiel) und mehrere Einzelrollen-Locators. Mit dieser Option werden die Locators und Rollen nach einer optimalen Prioritätsreihenfolge angeordnet.
Führen Sie zum Generieren der richtigen Python-Syntax für den Parameter in_result_ordering zuerst das Werkzeug im Bereich Geoverarbeitung mit der entsprechenden Option für den Parameter Ergebnisreihenfolge aus. Öffnen Sie anschließend das Menü Ausführen, und wählen Sie Python-Befehl kopieren aus.

Beschriftung	Erläuterung	Datentyp
Adressen-Locators	Die Locators, die zum Erstellen des kombinierten Locators verwendet werden. Die Reihenfolge der beteiligten Locators bestimmt, wie Kandidaten gesucht und Orte oder Adressen abgeglichen werden. Wenn Sie einen einzelnen Ort oder eine einzelne Adresse geokodieren, wird der Ort bzw. die Adresse mit allen beteiligten Locators abgeglichen, sofern der Locator nicht mit einem Auswahlkriterium angegeben wird. Alle gefundenen Kandidaten werden auf der Grundlage der Reihenfolge der aufgelisteten beteiligten Locators angezeigt. Wenn Sie eine Tabelle mit Adressen oder Orten geokodieren, werden die Adressen oder Orte automatisch mit dem ersten besten Kandidaten aus den ersten beteiligten Locators abgeglichen. Wenn die Adresse oder der Ort nicht abgeglichen werden kann, wird auf den nächsten Locator in der Liste zurückgegriffen. Für jeden beteiligten Locator ist ein Referenzname erforderlich. Dies ist der Name des Locators, auf den der kombinierte Locator verweist. Verwenden Sie im Namen keine Leerzeichen oder Sonderzeichen. Die Höchstlänge des Namens ist 14 Zeichen. Spalten der Wertetabelle: Beteiligte Adressen-Locators—Die beteiligten Adressen-Locators. Name—Für jeden beteiligten Locator ist ein Referenzname erforderlich.	Value Table
Feldzuordnung	Die Zuordnung der von jedem beteiligten Locator verwendeten Eingabefelder zu den Eingabefeldern des kombinierten Locators. Dies schließt die Felder und Feldinhalte ein, die von den beteiligten Locators generiert werden. Jedes der eindeutigen Eingabefelder wird im Parameter Feldzuordnung aufgeführt. Auf der linken Seite der Spalte Eingabefelder befindet sich eine Liste mit allen Eingabefeldern für den kombinierten Locator. Wenn Sie ein Feld auswählen, können Sie die Felder der einzelnen beteiligten Locators, die diesem Feld zugeordnet sind, in den Spalten Unterfeld und Eigenschaften anzeigen. Diese Felder sind die Eingabefelder für den kombinierten Locator. Achtung: Es darf kein Locator-Feld aus dem Parameter Feldzuordnung gelöscht werden. Kombinierte Locators, die nicht mit allen Locator-Feldern erstellt wurden, sind ungültig.	Field Mappings
Auswahlkriterien (Optional)	Die Auswahlkriterien für jeden beteiligten Locator. Für jeden beteiligten Locator wird nur ein Auswahlkriterium unterstützt. Beim Erstellen eines kombinierten Locators können Sie auch festlegen, welche Locators auf Basis der Werte in den Eingabe-Adressfeldern verwendet werden. Beispiel: Falls in Ihrem kombinierten Locator ein Locator mit Straßendaten für eine bestimmte Stadt enthalten ist, können Sie alle Adressen oder Orte herausfiltern, die diesen Stadtnamen nicht aufweisen. Wenn Sie Auswahlkriterien verwenden, werden die beteiligten Locators ausgeschlossen, die die Kriterien für eine bestimmte Adresse nicht erfüllen. Dies macht den Geokodierungsvorgang effizienter. Wenn ein Adressen-Locator beispielsweise mit dem Selektionskriterium `"City" = 'Atlanta'` angegeben ist, werden nur Adressen mit dem Stadtnamen "Atlanta" mit diesem Locator geokodiert. Hinweis: Die Selektionskriterien werden verwendet, wenn eine Adressentabelle mit mehreren Eingabe-Adressenfeldern geokodiert wird. Sie werden nicht angewendet, wenn eine Tabelle mit den Adressen in einem einzelnen Feld geokodiert wird oder wenn Adressen in einer einzeiligen Eingabe im Bereich Suchen gesucht werden. Um ein Auswahlkriterium anzugeben, aktivieren Sie das Kontrollkästchen unter der Spalte Auswahlkriterien, auf die Sie das Kriterium anwenden möchten. Sie können im Textfeld einen Ausdruck wie `"City" = 'Atlanta'` eingeben oder auf die Schaltfläche "Mehr" klicken, um das Dialogfeld Locator-Selektionskriterien angeben zu öffnen und die Kriterien festzulegen. Spalten der Wertetabelle: Adressen-Locators—Die beteiligten Locators. Auswahlkriterien—Auswahlkriterien für jeden beteiligten Locator.	Value Table
Kombinierter Ausgabe-Adressen-Locator	Der zu erstellende kombinierte Adressen-Locator. ArcGIS Pro unterstützt nur das Speichern von Locators in einem Dateiordner.	Address Locator
Ergebnisreihenfolge (Optional)	Gibt die Prioritätsreihenfolge für beteiligte Locators, mit denen Adressen abgeglichen werden können, an. So wird bei der Geokodierung mit hoher Wahrscheinlichkeit die beste Übereinstimmung gefunden. Locator-Reihenfolge verwenden: Die Reihenfolge beteiligter Locators entspricht der Reihenfolge, in der sie hinzugefügt wurden, und die Locators übernehmen die unter Kombinieren mehrerer Locators zu einem kombinierten Locator beschriebene Prioritätsreihenfolge. Dies ist die Standardeinstellung. Nach Rolle und Punktzahl anordnen: Einzelne Rollen beteiligter Locators werden gruppiert und nach ihrer Genauigkeit (von der höchsten bis zur geringsten Genauigkeit) angeordnet. Zuerst werden Ergebnisse für genauere Rollen zurückgegeben, gefolgt von weniger genauen Rollen, und für Ergebnisse, die für verschiedene Locators mit der gleichen Rolle zurückgegeben werden, werden die Ergebnisse auf der Punktzahl basierend zurückgegeben. Diese Option sollten Sie verwenden, wenn Sie einen Mehrfachrollen-Locator und mehrere Einzelrollen-Locators oder mehrere Mehrfachrollen-Locators verwenden. Dadurch werden die Locators und Rollen automatisch nach einer ratsamen optimalen Prioritätsreihenfolge angeordnet. Benutzerdefinierte Reihenfolge: Es wird eine benutzerdefinierbare Prioritätsreihenfolge für beteiligte Locators verwendet, die es Ihnen ermöglicht, Locators zwischen den Rollen eines Mehrfachrollen-Locators einzufügen.	String

arcpy.geocoding.CreateCompositeAddressLocator(in_address_locators, in_field_map, {in_selection_criteria}, out_composite_address_locator, {in_result_ordering})

Name	Erläuterung	Datentyp
in_address_locators [[in_address_locator, name],...]	Die Locators, die zum Erstellen des kombinierten Locators verwendet werden. Die Reihenfolge der beteiligten Locators bestimmt, wie Kandidaten gesucht und Orte oder Adressen abgeglichen werden. Wenn Sie einen einzelnen Ort oder eine einzelne Adresse geokodieren, wird der Ort bzw. die Adresse mit allen beteiligten Locators abgeglichen, sofern der Locator nicht mit einem Auswahlkriterium angegeben wird. Alle gefundenen Kandidaten werden auf der Grundlage der Reihenfolge der aufgelisteten beteiligten Locators angezeigt. Wenn Sie eine Tabelle mit Adressen oder Orten geokodieren, werden die Adressen oder Orte automatisch mit dem ersten besten Kandidaten aus den ersten beteiligten Locators abgeglichen. Wenn die Adresse oder der Ort nicht abgeglichen werden kann, wird auf den nächsten Locator in der Liste zurückgegriffen. Für jeden beteiligten Locator ist ein Referenzname erforderlich. Dies ist der Name des Locators, auf den der kombinierte Locator verweist. Verwenden Sie im Namen keine Leerzeichen oder Sonderzeichen. Die Höchstlänge des Namens ist 14 Zeichen. Spalten der Wertetabelle: `Participating Address Locators`—Die beteiligten Adressen-Locators. `Name`—Für jeden beteiligten Locator ist ein Referenzname erforderlich.	Value Table
in_field_map	Die Zuordnung der von jedem beteiligten Locator verwendeten Eingabefelder zu den Eingabefeldern des kombinierten Adressen-Locators. Formatieren Sie die Feldinformationen für jedes Locator-Eingabefeld wie in dieser Beispielzeichenfolge: `"Address 'Address or Intersection' true true false 4 Text 0 0 ,First,'#',Street"`. Die Informationen in dieser Zeichenfolge setzen sich wie folgt zusammen: Neuer Feldname (`Address`): Der neue Locator-Feldname für den kombinierten Locator. Ein Locator in der Kombination kann ein `Address`-Feld enthalten, und der andere Locator kann ein `Straße`-Feld enthalten. Sie können das neue kombinierte Locator-Feld als `Address` festlegen. Damit werden beide ursprüngliche Locator-Felder referenziert. Alias für den neuen Feldnamen (`'Adresse oder Kreuzung'`): Der Alias für den neuen Namen des Locator-Feldes für den kombinierten Locator. Für einen kombinierten Locator mit dem neuen Feldnamen `Address` können Sie den Alias `'Adresse oder Kreuzung'` für das Feld festlegen. isEditable (`true`): Gibt an, ob das neue kombinierte Locator-Feld editierbar ist. Die Optionen lauten `true` bzw. `false`. NULL-Werte erlauben (`true`): Gibt an, ob im neuen Feld des kombinierten Locators NULL-Werte zulässig sind. Die Optionen lauten `true` bzw. `false`. Erforderlich (`false`): Gibt an, ob das neue Feld des kombinierten Locators ein erforderliches Feld ist. Die Optionen lauten `true` bzw. `false`. Länge (`4`): Die Länge des neuen Feldes des kombinierten Locators. Typ (`Text`): Der Datentyp des neuen Feldes des kombinierten Locators. Dieser Wert sollte für einen Locator immer `Text` lauten. Maßstab (`0`): Der Maßstab des neuen Feldes des kombinierten Locators. Sie können einen beliebigen Wert zwischen 1 und 100 verwenden. Dieser Wert gilt nicht für Locators, aber es muss ein gültiger Wert verwendet werden. Genauigkeit (`0`): Die Genauigkeit des neuen Feldes des kombinierten Locators. Sie können einen beliebigen Wert zwischen 1 und 100 verwenden. Dieser Wert gilt nicht für Locators, aber es muss ein gültiger Wert verwendet werden. Vereinigungsregel (`First`): Die Vereinigungsregel für das neue Feld des kombinierten Locators. Sie können einen beliebigen Wert für die Vereinigungsregel verwenden. Dieser Wert gilt nicht für Locators, aber es muss ein gültiger Wert verwendet werden. Trennzeichen (`'#'`): Das Trennzeichen für das neue Feld des kombinierten Locators. Sie können ein beliebiges unterstütztes Trennzeichen verwenden. Ursprünglicher Locator-Feldname (`Street`): Der Name des Locator-Feldes im ursprünglichen beteiligten Locator.	Field Mappings
in_selection_criteria [[in_address_locator, selection_criteria],...] (Optional)	Die Auswahlkriterien für jeden beteiligten Locator. Für jeden beteiligten Locator wird nur ein Auswahlkriterium unterstützt. Wenn Sie Auswahlkriterien verwenden, werden die beteiligten Locators ausgeschlossen, die die Kriterien für eine bestimmte Adresse oder einen bestimmten Ort nicht erfüllen. Dies macht den Geokodierungsvorgang effizienter. Weitere Informationen zur Verwendung von Auswahlkriterien im Geokodierungsvorgang finden Sie unter "Kombinieren mehrerer Locators zu einem kombinierten Locator". Hinweis: Die Selektionskriterien werden verwendet, wenn eine Adressentabelle mit mehreren Eingabe-Adressenfeldern geokodiert wird. Sie werden nicht angewendet, wenn eine Tabelle mit den Adressen in einem einzelnen Feld geokodiert wird oder wenn Adressen in einer einzeiligen Eingabe im Bereich Suchen gesucht werden. Spalten der Wertetabelle: `Address Locators`—Die beteiligten Locators. `Selection Criteria`—Auswahlkriterien für jeden beteiligten Locator.	Value Table
out_composite_address_locator	Der zu erstellende kombinierte Adressen-Locator. ArcGIS Pro unterstützt nur das Speichern von Locators in einem Dateiordner.	Address Locator
in_result_ordering (Optional)	Gibt die Prioritätsreihenfolge für beteiligte Locators, mit denen Adressen abgeglichen werden können, an. So wird bei der Geokodierung mit hoher Wahrscheinlichkeit die beste Übereinstimmung gefunden. `Locator-Reihenfolge verwenden`: Die Reihenfolge beteiligter Locators entspricht der Reihenfolge, in der sie hinzugefügt wurden, und die Locators übernehmen die unter Kombinieren mehrerer Locators zu einem kombinierten Locator beschriebene Prioritätsreihenfolge. Dies ist die Standardeinstellung. Die Syntax ist eine durch Komma getrennte Zeichenfolge der Locator-Namen. Die Syntax für einen kombinierten Locator, der zwei Locators (z. B. "Atlanta.loc" und "Memphis.loc") enthält, sollte beispielsweise `"Atlanta, Memphis"` lauten. `Nach Rolle und Punktzahl anordnen`: Einzelne Rollen beteiligter Locators werden gruppiert und nach ihrer Genauigkeit (von der höchsten bis zur geringsten Genauigkeit) angeordnet. Zuerst werden Ergebnisse für genauere Rollen zurückgegeben, gefolgt von weniger genauen Rollen, und für Ergebnisse, die für verschiedene Locators mit der gleichen Rolle zurückgegeben werden, werden die Ergebnisse auf der Punktzahl basierend zurückgegeben. Diese Option sollten Sie verwenden, wenn Sie einen Mehrfachrollen-Locator und mehrere Einzelrollen-Locators oder mehrere Mehrfachrollen-Locators verwenden. Dadurch werden die Locators und Rollen automatisch nach einer ratsamen optimalen Prioritätsreihenfolge angeordnet. Die Syntax ist eine durch Komma getrennte Zeichenfolge von Rollengruppierungen, die wie folgt strukturiert ist: `[Locator-Rolle1](Locator-Name1.Locator-Rolle1, Locator-Name2.Locator-Rolle1)`. Beispielsweise sollte die Syntax für einen kombinierten Locator, der zwei Mehrfachrollen-Locators (z. B. "Atlanta.loc" und "Memphis.loc") mit jeweils einer PointAddress-Rolle und einer StreetAddress-Rolle enthält, wie folgt lauten: `"[PointAddress](Atlanta.PointAddress, Memphis.PointAddress),[StreetAddress](Memphis.StreetAddress,Atlanta.StreetAddress)"`. Die Rollen müssen nach ihrer Genauigkeit (von der höchsten bis zur geringsten Genauigkeit) angeordnet sein. `Benutzerdefinierte Reihenfolge`: Eine benutzerdefinierbare Prioritätsreihenfolge für beteiligte Locators wird verwendet, die es Ihnen ermöglicht, Locators zwischen den Rollen eines Mehrfachrollen-Locators einzufügen. Die Syntax ist eine durch Komma getrennte Zeichenfolge von Locator-Namen und -Rollen, die wie folgt strukturiert ist: `Locator-Name.Locator-Rolle`. Beispielsweise sollte die Syntax für einen kombinierten Locator, der zwei Mehrfachrollen-Locators (z. B. "Atlanta.loc" und "Memphis.loc") mit jeweils einer PointAddress-Rolle und einer StreetAddress-Rolle enthält, wie folgt lauten: `"Atlanta.StreetAddress,Memphis.PointAddress,Memphis.StreetAddres,Atlanta.PointAddress"`. Locators und Rollen können in beliebiger Reihenfolge angegeben werden, aber wenn Sie weniger genaue Rollen vor genaueren Rollen angeben, kann dies zu unerwartetem Verhalten führen. Führen Sie zum Generieren der richtigen Python-Syntax zuerst das Werkzeug im Bereich Geoverarbeitung aus. Öffnen Sie anschließend das Menü Ausführen, und wählen Sie Python-Befehl kopieren aus.	String

Codebeispiel

CreateCompositeAddressLocator: Beispiel (Python-Fenster)

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

# Create a composite address locator using the StreetMap USA and Tutorial Atlanta locators.

# Import system modules
import arcpy

arcpy.env.workspace = "C:/ArcTutor/Geocoding/atlanta/"

# Set local variables:
USA_locator = "C:/data/locators/StreetMap_Premium_for_ArcGIS/North_America_2024R3/USA.loc"
Atlanta_locator = "C:/ArcTutor/Geocoding/atlanta/Atlanta.loc"
Atlanta_Composite = "C:/ArcTutor/Geocoding/atlanta/US_Atlanta_Composite.loc"

# Field mapping
address_field_map = "Address 'Street or Intersection' true true false 100 Text 0 0 ,First,#,Atlanta_locator,Address,0,0,USA_locator,Street;"
city_field_map = "City 'City or Placename' true true false 40 Text 0 0 ,First,#,Atlanta_locator,City,0,0,USA_locator,City;"
state_field_map = "State 'State' true true false 20 Text 0 0 ,First,#,Atlanta_locator,State,0,0,USA_locator,State;"
zip_field_map = "Zip 'Zipcode' true true false 10 Text 0 0 ,First,#,Atlanta_locator,Zip,0,0,USA_locator,ZIP"

composite_locator_field_map = address_field_map + city_field_map + state_field_map + zip_field_map

arcpy.geocoding.CreateCompositeAddressLocator("Atlanta_locator Atlanta;USA_locator USA", composite_locator_field_map,"Atlanta '\"City\" = 'Atlanta'';USA #",Atlanta_Composite)

Umgebungen

Ausgabe-CONFIG-Schlüsselwort, Ausgabe-Koordinatensystem

Lizenzierungsinformationen

Basic: Ja
Standard: Ja
Advanced: Ja

Kombinierten Adressen-Locator erstellen (Geocoding Tools)

Zusammenfassung

Verwendung

Parameter

Achtung:

Hinweis:

Umgebungen

Lizenzierungsinformationen

Verwandte Themen