Kombinierten Adressen-Locator erstellen (Geocoding)

Zusammenfassung

Mit diesem Werkzeug wird ein kombinierter Locator erstellt. 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 dann das Menü Ausführen, und wählen Sie Python-Befehl kopieren aus.

Parameter

BeschriftungErläuterungDatentyp
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.

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.

Vorsicht:

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 festlegen, welche Locators auf der Basis der Werte in den Eingabeadressenfeldern verwendet werden sollen. 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 Auswahlkriterium "City" = 'Atlanta' angegeben ist, werden nur Adressen mit dem Stadtnamen Atlanta mit diesem Locator geokodiert.

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-Auswahlkriterien angeben zu öffnen und die Kriterien festzulegen.

Value Table
Kombinierter Ausgabe-Adressen-Locator

Der zu erstellende kombinierte Adressen-Locator. ArcGIS AllSource 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})
NameErläuterungDatentyp
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.

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 bestehen aus den folgenden Elementen:

  • Neuer Feldname (Address): Der neue Name des Locator-Feldes für den kombinierten Locator.

    Ein Locator in der Kombination kann ein Address-Feld enthalten und ein anderer Locator ein Street Address-Feld. Sie können Address als neues Feld für den kombinierten Locator festlegen. Damit wird auf beide ursprüngliche Locator-Felder verwiesen.

  • Alias für den neuen Feldnamen ('Address or Intersection'): Der Alias für den neuen Namen des Locator-Feldes für den kombinierten Locator.

    Bei einem kombinierten Locator mit dem neuen Feldnamen Address können Sie für das Feld den Alias 'Address or Intersection' festlegen.

  • isEditable (true): Gibt an, ob das neue Feld des kombinierten Locators editierbar ist. Die Optionen sind true bzw. false.
  • NULL-Werte erlauben (true): Gibt an, ob im neuen Feld des kombinierten Locators NULL-Werte zulässig sind. Die Optionen sind true bzw. false.
  • Erforderlich (false): Gibt an, ob das neue Feld des kombinierten Locators ein erforderliches Feld ist. Die Optionen sind 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.

Value Table
out_composite_address_locator

Der zu erstellende kombinierte Adressen-Locator. ArcGIS AllSource 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.

  • Use locator order: 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 von Locator-Namen.
    • Die Syntax für einen kombinierten Locator, der zwei Locators (z. B. "Atlanta.loc" und "Memphis.loc") enthält, sollte "Atlanta, Memphis" lauten.
  • Order by role and score: 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)".
    • 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, sollte "[PointAddress](Atlanta.PointAddress, Memphis.PointAddress),[StreetAddress](Memphis.StreetAddress,Atlanta.StreetAddress)" lauten.
    • Die Rollen müssen nach ihrer Genauigkeit (von der höchsten bis zur geringsten Genauigkeit) angeordnet sein.
  • Custom order: 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.
    • Die Syntax ist eine durch Komma getrennte Zeichenfolge von Locator-Namen und -Rollen, die wie folgt strukturiert ist: "Locator-Name.Locator-Rolle".
    • 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, sollte "Atlanta.StreetAddress,Memphis.PointAddress,Memphis.StreetAddres,Atlanta.PointAddress" lauten.
    • 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 dann 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 unmittelbaren Modus verwendet wird.

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

# Import system modules
import arcpy 

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

# Set local variables:
US_Streets_locator = "C:/dm_stmap_dvd/streetmap_na/data/Street_Addresses_US"
Atlanta_locator = Atlanta
Atlanta_Composite = US_Atlanta_Composite

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

composite_locator_field_map = address_field_map + city_field_map + state_field_map + zip_field_map

arcpy.geocoding.CreateCompositeAddressLocator("Atlanta_locator Atlanta;US_Streets_locator US_Streets", composite_loactor_field_map,"Atlanta '\"City\" = 'Atlanta'';US_Streets #",Atlanta_Composite)