Kombinierten Adressen-Locator erstellen (Geocoding)

Zusammenfassung

Mit diesem Werkzeug wird ein neuer kombinierter Adressen-Locator erstellt. Ein kombinierter Locator besteht aus mindestens zwei einzelnen Locators, die das Abgleichen von Adressen mit mehreren Locators ermöglichen.

Weitere Informationen zu kombinierten Locators

Verwendung

  • Verwenden Sie vor dem Erstellen von kombinierten Adressen-Locators das Werkzeug Locator erstellen, um die beteiligten Adressen-Locators zu erstellen.

  • Der kombinierte Adressen-Locator muss einen gültigen Raumbezug aufweisen. Der Raumbezug des ersten beteiligten Adressen-Locators wird verwendet, sofern Sie nicht in den Umgebungseinstellungen des Werkzeugs ein anderes Ausgabe-Koordinatensystem angeben.

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 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 oder Orte automatisch mit dem ersten besten Kandidaten aus dem ersten beteiligten Locator 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.

Die Felder und Feldinhalte, die von den beteiligten Locators generiert werden. Die einzelnen eindeutigen Eingabefelder werden im Abschnitt Feldzuordnung aufgeführt. Wenn Sie den Abschnitt erweitern, wird für jeden beteiligten Adressen-Locator eine Liste aller Vorkommen der Eingabefelder (Unterfelder) angezeigt. Diese Felder sind die Eingabefelder für den kombinierten Adressen-Locator. Wenn aufgrund der von den beteiligten Adressen-Locators übernommenen eindeutigen Namen doppelte Felder vorhanden sind, z. B. "PLZ" und "Postleitzahl", können Sie die Unterfelder per Drag & Drop im entsprechenden Feld gruppieren oder das Unterfeld mit den Schaltflächen Pfeil nach oben oder Pfeil nach unten verschieben.

Field Mappings
Selektionskriterien
(optional)

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

Beim Erstellen eines kombinierten Adressen-Locators können Sie auch festlegen, welche Adressen-Locators auf der Basis der Werte in den Eingabe-Adressenfeldern verwendet werden sollen. Beispiel: Falls im kombinierten Adressen-Locator ein Locator mit Straßendaten für eine bestimmte Stadt enthalten ist, können Sie alle Adressen herausfiltern, die diesen Stadtnamen nicht aufweisen. Wenn Sie Selektionskriterien verwenden, werden die beteiligten Adressen-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

arcpy.geocoding.CreateCompositeAddressLocator(in_address_locators, in_field_map, {in_selection_criteria}, out_composite_address_locator)
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 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 oder Orte automatisch mit dem ersten besten Kandidaten aus dem ersten beteiligten Locator 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.

Die Feldinformationen für die einzelnen Locator-Eingabefelder sollten wie in dieser Beispielzeichenfolge formatiert sein: "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)

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

Wenn Sie Selektionskriterien verwenden, werden die beteiligten Adressen-Locators ausgeschlossen, die die Kriterien für eine bestimmte Adresse oder einen bestimmten Ort 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

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.CreateCompositeAddressLocator_geocoding("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