Kombinierten Adressen-Locator erstellen (Geocoding)

Zusammenfassung

Erstellt einen kombinierten Locator. Ein kombinierter Locator besteht aus mindestens zwei einzelnen Locators, die das Abgleichen von Adressen und Orten anhand von mehreren Adressen-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 Ausgabe-Koordinatensystem angeben.

  • Verwenden Sie für den Parameter Ergebnisreihenfolge eines Mehrfachrollen-Locators, eines ArcGIS StreetMap Premium-Locators (Beispiel) und verschiedener Einzelrollen-Locators die Option Nach Rolle und Punktzahl anordnen. Mit dieser Option werden die Locators und Rollen in der optimalen Prioritätsreihenfolge angeordnet.

  • Um die richtige Python-Syntax für den Parameter in_result_ordering zu generieren, führen Sie zuerst das Werkzeug im Bereich Geoverarbeitung mit der entsprechenden Option des Parameters Ergebnisreihenfolge aus. Öffnen Sie anschließend 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 die Adresse mit allen beteiligten Adressen-Locators abgeglichen, sofern der Locator nicht mit einem Selektionskriterium 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 automatisch mit dem erstbesten Kandidaten aus den ersten beteiligten Locators abgeglichen. Wenn die Adresse oder der Ort nicht abgeglichen werden können, 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.

Dazu gehören die Felder und Feldinhalte, die von den beteiligten Locators generiert werden. Jedes eindeutige Eingabefeld ist im Parameter Feldzuordnung aufgelistet. Links in der Spalte Eingabefelder befindet sich eine Liste aller Eingabefelder für den kombinierten Locator. Wenn Sie ein Feld auswählen, sehen Sie in den Spalten Unterfeld und Eigenschaften die Felder aller beteiligten Locators, die diesem Feld zugeordnet sind. Diese Felder sind die Eingabefelder für den kombinierten Locator.

Vorsicht:

Es darf kein Locator-Feld aus dem Parameter Feldzuordnung gelöscht werden. Ein kombinierter Locator, der nicht mit allen Locator-Feldern erstellt wird, ist ungültig.

Field Mappings
Auswahlkriterien
(optional)

Die Selektionskriterien für jeden beteiligten Locator. Für jeden beteiligten Locator wird nur ein Selektionskriterium 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, empfiehlt es sich, alle Adressen oder Orte herauszufiltern, 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.

Um ein Selektionskriterium anzugeben, aktivieren Sie unter der Spalte Selektionskriterien das Kontrollkästchen des Locators, auf den 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.

Value Table
Kombinierter Ausgabe-Adressen-Locator

Der kombinierte Adressen-Locator, der erstellt wird. ArcGIS Pro unterstützt nur das Speichern von Locators in einem Dateiordner.

Address Locator
Ergebnisreihenfolge
(optional)

Gibt die Prioritätsreihenfolge der beteiligten Locators an, mit denen Adressen abgeglichen werden können, um die Wahrscheinlichkeit zu erhöhen, dass bei der Geokodierung die beste Übereinstimmung gefunden wird.

  • 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: Beteiligte Locators werden nach Rolle und Prioritätsreihenfolge gruppiert.
  • 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.
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 die Adresse mit allen beteiligten Adressen-Locators abgeglichen, sofern der Locator nicht mit einem Selektionskriterium 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 automatisch mit dem erstbesten Kandidaten aus den ersten beteiligten Locators abgeglichen. Wenn die Adresse oder der Ort nicht abgeglichen werden können, 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 folgendem Beispiel dargestellt: "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 Locator-Feldname für den kombinierten Locator.

    Ein Locator in der Kombination kann ein Address-Feld enthalten, und der andere Locator kann ein Street Address-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 ('Address or Intersection'): Der Alias des neuen Feldnamens für den kombinierten Locator.

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

  • isEditable (true): Gibt an, ob das neue kombinierte Locator-Feld editierbar ist. Die Optionen sind true bzw. false.
  • NULL-Werte erlauben (true): Gibt an, ob für das neue kombinierte Locator-Feld NULL-Werte zulässig sind. Die Optionen sind true bzw. false.
  • Erforderlich (false): Gibt an, ob das neue kombinierte Locator-Feld ein erforderliches Feld ist. Die Optionen sind true bzw. false.
  • Länge (4): Die Länge des neuen kombinierten Locator-Feldes.
  • Typ (Text): Der Datentyp des neuen kombinierten Locator-Feldes. Dieser Wert sollte für einen Locator immer Text entsprechen.
  • Maßstab (0): Der Maßstab des neuen kombinierten Locator-Feldes. Sie können beliebige Werte zwischen 1 und 100 verwenden. Dieser Wert gilt nicht für Locators, dennoch muss ein gültiger Wert verwendet werden.
  • Genauigkeit (0): Die Genauigkeit des neuen kombinierten Locator-Feldes. Sie können beliebige Werte zwischen 1 und 100 verwenden. Dieser Wert gilt nicht für Locators, dennoch muss ein gültiger Wert verwendet werden.
  • Vereinigungsregel (First): Die Vereinigungsregel für das neue kombinierte Locator-Feld. Sie können einen beliebigen Vereinigungsregelwert verwenden. Dieser Wert gilt nicht für Locators, dennoch muss ein gültiger Wert verwendet werden.
  • Trennzeichen ('#'): Das Trennzeichen für das neue kombinierte Locator-Feld. Sie können jedes unterstützte Trennzeichen verwenden.
  • Ursprünglicher Locator-Feldname (Street): Der Locator-Feldname im ursprünglichen beteiligten Locator.
Field Mappings
in_selection_criteria
[[in_address_locator, selection_criteria],...]
(optional)

Die Selektionskriterien für jeden beteiligten Locator. Für jeden beteiligten Locator wird nur ein Selektionskriterium unterstützt.

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. Weitere Informationen zum Verwenden von Selektionskriterien im Geokodierungsvorgang finden Sie unter Grundlagen zum Kombinieren mehrerer Locators zu einem kombinierten Locator.

Value Table
out_composite_address_locator

Der kombinierte Adressen-Locator, der erstellt wird. ArcGIS Pro unterstützt nur das Speichern von Locators in einem Dateiordner.

Address Locator
in_result_ordering
(optional)

Gibt die Prioritätsreihenfolge der beteiligten Locators an, mit denen Adressen abgeglichen werden können, um die Wahrscheinlichkeit zu erhöhen, dass bei der Geokodierung die beste Übereinstimmung gefunden wird.

  • 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 der Locator-Namen.
    • Für einen aus zwei Locators (z. B. Atlanta.loc und Memphis.loc) bestehenden kombinierten Locator lautet die Syntax: "Atlanta, Memphis".
  • Order by role and score: Beteiligte Locators werden nach Rolle und Prioritätsreihenfolge gruppiert.
    • Die Syntax ist eine durch Komma getrennte Zeichenfolge der gruppierten Rollen, die folgendermaßen angeordnet sind: [LocatorRole1](LocatorName1.LocatorRole1, LocatorName2.LocatorRole1).
    • Für einen aus zwei Mehrfachrollen-Locators (z. B. Atlanta.loc und Memphis.loc) mit je einer Rolle "PointAdress" und einer Rolle "StreetAddress" bestehenden kombinierten Locator lautet die Syntax: "[PointAddress](Atlanta.PointAddress, Memphis.PointAddress),[StreetAddress](Memphis.StreetAddress,Atlanta.StreetAddress)".
    • Die Rollen müssen absteigend nach Präzision angeordnet werden.
  • Custom order: Eine benutzerdefinierbare Prioritätsreihenfolge für beteiligte Locators ermöglicht es Ihnen, Locators zwischen den Rollen eines Mehrfachrollen-Locators einzufügen.
    • Die Syntax ist eine durch Komma getrennte Zeichenfolge der Locator-Namen und Rollen, die folgendermaßen angeordnet sind: LocatorName.LocatorRole.
    • Für einen aus zwei Mehrfachrollen-Locators (z. B. Atlanta.loc und Memphis.loc) mit je einer Rolle "PointAdress" und einer Rolle "StreetAddress" bestehenden kombinierten Locator lautet die Syntax: "Atlanta.StreetAddress,Memphis.PointAddress,Memphis.StreetAddres,Atlanta.PointAddress".
    • Locators und Rollen können beliebig angeordnet werden. Allerdings kann die Platzierung weniger präziser vor präziseren Rollen zu einem unerwarteten Verhalten führen.

Um die richtige Python-Syntax zu generieren, müssen Sie zuerst das Werkzeug im Bereich Geoverarbeitung ausführen. Ö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 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)

Lizenzinformationen

  • Basic: Ja
  • Standard: Ja
  • Advanced: Ja

Verwandte Themen