Geokodierung und Geosearch

Locators ermöglichen Ihnen das Suchen von Adressen und Orten, die Sie auf einer Karte visualisieren, als Stopps für eine Route einfügen und als Eingabe für räumliche Analysen nutzen können. ArcGIS Online-Locators verwenden Geosearch und Geokodierung wie folgt:

  • Geosearch (wird auch als Positionssuche bezeichnet): Ermöglicht die Suche einer Adresse oder einer Sehenswürdigkeit und das Zoomen der Karte auf diese Position. Das Ergebnis kann auf der Karte angezeigt werden, wird jedoch nicht zur späteren Verwendung gespeichert. Geosearch ist für jeden verfügbar, der auf Map Viewer, Map Viewer Classic oder eine öffentliche App zugreift, die eine Positionssuche auf einer Karte verwendet. Hierzu ist weder ein Organisationskonto erforderlich noch werden Credits verbraucht (es besteht jedoch eine Beschränkung von 1 Mio. Geosearch-Vorgängen pro Monat).
  • Geokodierung: Ermöglicht die Konvertierung einer Adresse oder eines Ortes in XY-Koordinaten und das Anhängen des Ergebnisses an einen vorhandenen Datensatz in einer Datenbank. Die Kartenerstellung ist nicht immer involviert, das Platzieren der Ergebnisse auf einer Karte kann jedoch Teil eines Workflows sein. Batch-Geokodierung und Rückwärts-Geokodierung zählen zu dieser Kategorie. Ein Organisationskonto mit Premium-Content-Geokodierungsberechtigung ist erforderlich, um für die Batch-Geokodierung auf den ArcGIS World Geocoding Service und die darin enthaltenen Sichten zuzugreifen.

    Hinweis:

    Einige Eigenschaften von Locator-Sichten werden nicht bei der Rückwärts-Geokodierung unterstützt.

Standardmäßig verwendet ArcGIS Online den ArcGIS World Geocoding Service, um Adressen, Städte, Landmarks, Namen von Unternehmen und Postleitzahlen in über 100 Ländern weltweit zu suchen. Zusätzlich wird der ArcGIS World Geocoding Service verwendet, um mit Längengrad und Breitengrad und mit Koordinatenreferenzsystemen wie Military Grid Reference System (MGRS) und United States National Grid (USNG) die Position von XY-Koordinaten zu suchen.

Wenn Ihre Organisation Suchergebnisse für Adressen und Orte optimieren möchte, können Mitglieder mit Berechtigungen zum Erstellen von Inhalten eine neue Sicht des ArcGIS World Geocoding Service erstellen, um in einem Interessenbereich nur nach Positionen bestimmter Typen zu suchen. Sie können z. B. eine Locator-Sicht erstellen, um die Suchergebnisse auf ein bestimmtes Land oder Gebiet zu beschränken oder um nur Suchergebnisse zurückzugeben, die mit einer bestimmten Kategorie wie Straßenadressen oder Flughäfen übereinstimmen. Wenn Sie eine Locator-Sicht erstellt haben, können Mitglieder der Standardadministratorrolle die Organisation so konfigurieren, dass Ihre Locator-Sicht verwendet wird, wenn Mitglieder Geosearch-Vorgänge ausführen.

Hinweis:

Bei der Verwendung des ArcGIS World Geocoding Service oder von Sichten dieses Locators für die Batch-Geokodierung (mit Veröffentlichen von CSV- oder Microsoft Excel-Dateien als gehostete Feature-Layer) werden Credits verbraucht. Bei der Verwendung von Locators für die Geosearch werden keine Credits verbraucht.

Um Locator-Ansichten für die Batch-Geokodierung verwenden zu können, ist ein Organisationskonto mit Premium-Content-Geokodierungsberechtigung erforderlich.

Wenn Ihre Organisation Adressen oder Orte basierend auf eigenen Daten geokodieren muss, können Administratoren Ihre Organisation zudem so konfigurieren, dass eigene Locators, die auf einer ArcGIS Server-Site ausgeführt werden, für Geosearch, Geokodierung oder beides verwendet werden. Ein Ölunternehmen kann beispielsweise Locators hinzufügen, um eigene Ölquellen zu suchen, oder eine Stadt kann einen Locator hinzufügen, um eigene Löschwasserhydranten zu suchen.

Wenn Sie zusätzliche Locators oder Locator-Sichten hinzufügen, wird Mitgliedern im Geosearch-Suchfeld ein Pfeil angezeigt, und sie können auswählen, welcher Locator oder welche Sicht verwendet werden soll.

Positionstypen und -kategorien

In diesem Abschnitt werden die Typen, Kategorien und Unterkategorien von Positionen beschrieben, die zum Konfigurieren der Locator-Sicht zur Verfügung stehen.

Adressen, Postleitzahlen und besiedelte Orte

Wenn Sie als gesuchte Positionstypen Adressen, Postleitzahlen und besiedelte Orte auswählen, können Sie die Suchergebnisse der Locator-Sicht weiter verfeinern, indem Sie die Kategorien und Unterkategorien auswählen, nach denen Sie suchen möchten. Die folgenden Kategorien sind für Adressen, Postleitzahlen und besiedelte Orte verfügbar:

  • Adresse: Durch Auswahl dieser Kategorie werden automatisch alle in der folgenden Tabelle aufgeführten Unterkategorien für Adressen aufgenommen. Mit dieser Kategorie werden die Suchergebnisse auf Orte beschränkt, die als Adressen kategorisiert werden können. Ergebnisse für Sehenswürdigkeiten, Postleitzahlen, Länder oder Bundesländer werden dagegen herausgefiltert. Genauere Ergebnisse erhalten Sie, wenn Sie eine Kombination der Unterkategorien für Adressen auswählen, die zu Ihren Suchanforderungen passen.
  • Postleitzahl: Durch Auswahl dieser Kategorie werden die Suchergebnisse auf Übereinstimmungen für Postleitzahlen beschränkt, einschließlich fünfstelliger und längerer Formate von Postleitzahlen. Um die Suchergebnisse auf Übereinstimmungen zu beschränken, die zumindest diesen Grad an Genauigkeit aufweisen, wählen Sie die Kategorie Postleitzahl und die übergeordnete Kategorie Adresse aus.
  • Besiedelter Ort: Durch Auswahl dieser Kategorie werden automatisch alle in der folgenden Tabelle aufgeführten Unterkategorien für besiedelte Orte aufgenommen. Mit dieser Kategorie werden die Suchergebnisse auf Verwaltungsgebiete (oder Grenzen) wie Städte, Kantone oder Länder beschränkt. Ergebnisse für Adressen, Sehenswürdigkeiten und Postleitzahlen werden dagegen herausgefiltert. Genauere Ergebnisse erhalten Sie, wenn Sie eine Kombination der Unterkategorien für besiedelte Orte auswählen, die zu Ihren Suchanforderungen passen.

KategorieUnterkategorieBeschreibung

Adresse

Punktadresse

Eine Punktadresse ist eine Straßenadresse basierend auf Punkten, die Haus- oder Gebäudestandorte darstellen. Punktadressen stellen die Gebäudeadresse oder die tatsächliche Position der Adresse dar. Dies ist in der Regel die räumlich genaueste Abgleichebene. Referenzdaten enthalten Adresspunkte mit zugehörigen Hausnummern und Straßennamen sowie Angaben zu Verwaltungsgebieten und optionalen Postleitzahlen, z. B.380 New York St, Redlands, CA, 92373.

Eine mit dieser Unterkategorie konfigurierte Locator-Sicht beschränkt die Ergebnisse auf diese sehr genauen Adresspunkte. Dadurch entfällt der Abgleich mit weniger genauen Adresspunkten, wenn genaue Übereinstimmungen erforderlich sind.

Straßenadresse

Eine Straßenadresse unterscheidet sich von einer Punktadresse dadurch, dass die Hausnummer in einer Straßenadresse aus einem Zahlenbereich interpoliert wird. Referenzdaten enthalten Straßenmittelachsen mit Hausnummernbereichen sowie Verwaltungsgebieten und optionaler Postleitzahl, z. B. 647 Haight St, San Francisco, CA, 94117.

Eine mit dieser Unterkategorie konfigurierte Locator-Sicht beschränkt die Ergebnisse auf ein interpoliertes Ergebnis. Wenn Sie die Ergebnisse auf Übereinstimmungen mit mindestens diesem Grad an Genauigkeit beschränken möchten, sollten Sie diese Unterkategorie und die Kategorie Punktadresse auswählen.

Kreuzung

Eine Kreuzung ist eine Straßenadresse, die aus einer Straßenkreuzung sowie Informationen zur Stadt und optionalen Angaben zum Bundesstaat und zur Postleitzahl besteht, z. B. Redlands Blvd und New York St, Redlands, CA, 92373.

Eine mit dieser Unterkategorie konfigurierte Locator-Sicht beschränkt die Ergebnisse auf Schnittpunkte statt auf vollständige Adressen, die nur zu einer Straße gehören.

Straßenname

Ein Straßenname ähnelt einer Straßenadresse, jedoch ohne die Hausnummer. Er enthält Straßenmittelachsen mit zugehörigen Straßennamen (keine nummerierten Adressbereiche) sowie Angaben zu Verwaltungsgebieten und optionalen Postleitzahlen, z. B. W Olive Ave, Redlands, CA, 92373.

Eine mit dieser Unterkategorie konfigurierte Locator-Sicht beschränkt die Ergebnisse auf Straßennamen. Wenn Sie die Ergebnisse auf Übereinstimmungen mit mindestens diesem Grad an Genauigkeit beschränken möchten, sollten Sie diese Unterkategorie und die Unterkategorien Punktadresse und Straßenadresse auswählen.

Unteradresse

Eine Unteradresse ist ein Teil einer Punktadresse, der für einen Teil eines Hauses oder Gebäudes (also für eine Wohnung oder eine Etage) oder für ein einzelnes Gebäude in einem Gebäudekomplex steht, z. B. 3836 Emerald Ave, Suite C, La Verne, CA, 91750.

Eine mit dieser Unterkategorie konfigurierte Locator-Sicht beschränkt die Ergebnisse auf Punkte einer Unteradresse, die eine Hausnummer, einen Straßennamen und Elemente der Unteradresse sowie Angaben zu Verwaltungsgebieten und optionalen Postleitzahlen enthalten, aber keine anderen Typen von Adressübereinstimmungen.

Postalisch

Keine Unterkategorien

Eine mit der Kategorie Postalisch konfigurierte Locator-Sicht gibt alle Typen von Übereinstimmungen für Postleitzahlen zurück, einschließlich fünfstelliger Formate (z. B. 92373) und anderer Formate für Postleitzahlen. Um die Ergebnisse auf Übereinstimmungen zu beschränken, die zumindest diesen Grad an Genauigkeit aufweisen, wählen Sie Postleitzahl und die übergeordnete Kategorie Adresse aus.

Besiedelter Ort

Nachbarschaft

Ein Stadtteil ist ein Unterabschnitt einer Stadt, kleiner als ein Bezirk und größer als ein Sektor.

Stadt

Ein mit dieser Unterkategorie konfigurierter Locator beschränkt die Ergebnisse auf Städte, z. B. die Stadt Venedig in Italien.

Subregion

Eine Subregion ist ein Teil eines Bundesstaates, Bundeslandes oder Kantons. In den Vereinigten Staaten ist es beispielsweise ein County wie Adams County im Bundesstaat Wisconsin.

Region

Eine Region ist ein Teil eines Landes, üblicherweise ein Bundesland/Kanton oder eine Provinz, z. B. die Provinz Ontario in Kanada.

Land

Ein Land ist das übergeordnete Verwaltungsgebiet und wird auch als Staat bezeichnet, z. B. Japan.

Sektor

Ein Sektor ist ein Verwaltungsgebiet, das größer als ein Block und kleiner als ein Stadtviertel ist. Er steht für einen Teil eines Viertels oder eines Bezirks oder für eine Reihe von Blocks.

Block

Ein Block ist das kleinste Verwaltungsgebiet für ein Land. Er steht für einen Teil eines Sektors oder eines Stadtteils bzw. für einen Gebäudeblock mit einem eigenen Namen.

Bezirk

Ein Bezirk ist ein Verwaltungsgebiet, das kleiner als eine Stadt und größer als ein Stadtteil ist, z. B. ein Stadtbezirk.

Ballungsgebiet

Ein Ballungsgebiet ist ein städtisches Verdichtungsgebiet, das aus einer großen Stadt und umliegenden kleineren Städten besteht, z. B. der Großraum Tokio.

Gebiet

Ein Gebiet ist ein großes Verwaltungsgebiet, kleiner als ein Land und größer als ein Bundesland/Kanton oder eine Provinz, z. B. das Gebiet Yukon in Kanada.

Zone

Eine Zone ist eine Kategorie, die für ein nicht offizielles Verwaltungsgebiet steht, das nicht zu einem Land gehört, wie ein strittiges Gebiet oder eine Gruppierung anderer Verwaltungszonen, z. B. Mittelamerika.

Koordinaten

Wenn Sie als gesuchte Positionstypen Koordinaten auswählen, können Sie die Suchergebnisse der Locator-Sicht weiter verfeinern, indem Sie die Kategorien auswählen, nach denen Sie suchen möchten. Diese werden in der folgenden Tabelle näher beschrieben.

KategorieBeschreibung

Längengrad, Breitengrad

Diese Kategorie steht für die geographischen Koordinaten (X, Y). X bezeichnet den Längengrad (Ost-West-Koordinaten) und Y den Breitengrad (Nord-Süd-Koordinaten). Koordinaten werden im Format X,Y eingegeben und zurückgegeben.

Breitengrad, Längengrad

Diese Kategorie steht für die geographischen Koordinaten (X, Y). X bezeichnet den Längengrad (Ost-West-Koordinaten) und Y den Breitengrad (Nord-Süd-Koordinaten). Koordinaten werden im Format Y,X eingegeben und zurückgegeben.

MGRS

Diese Kategorie steht für Military Grid Reference System-Koordinaten (MGRS).

USNG

Diese Kategorie steht für das United States National Grid-Koordinatensystem (USNG).

Sehenswürdigkeiten

Wenn Sie als gesuchte Positionstypen Sehenswürdigkeiten auswählen, können Sie die Suchergebnisse der Locator-Sicht weiter verfeinern, indem Sie die Kategorien auswählen, nach denen Sie suchen möchten. Diese werden in der folgenden Tabelle näher beschrieben.

KategorieBeschreibung

Bildung

Diese Kategorie steht für alle Typen von Bildungseinrichtungen wie Universitäten, Grundschulen und Berufsschulen.

Essen

Diese Kategorie steht für alle Typen von Restaurants.

Geschäfte und Dienstleistungen

Diese Kategorie steht für alle Typen von Gewerbe- und Einzelhandelsbetrieben.

Flughafen

Diese Kategorie steht für Flughäfen, bezeichnet entweder mit dem Namen oder dem Flughafencode.

Anforderungen für das Konfigurieren eigener Locators

ArcGIS Online unterstützt Locators, die auf ArcGIS Server 10.0 und höher ausgeführt werden, als Locators für Geosearch-Vorgänge. Wenn Locators für Geosearch-Vorgänge verwendet werden, können sie intern oder extern sein. Interne Locators funktionieren nur für Geosearch-Vorgänge, wenn Map Viewer Classic oder andere ArcGIS Online-Clients über Zugriff auf diese internen Locators verfügen. Wenn Ihre Organisation beispielsweise Apps für die Öffentlichkeit freigibt, können nur Benutzer mit Zugriff auf Ihre internen Locators Orte mit diesen Apps suchen.

ArcGIS Online unterstützt zudem Locators, die auf ArcGIS Server 10.1 und höher ausgeführt werden, als Geocoder für die Batch-Geokodierung. Anders als bei Geosearch-Vorgängen sind externe Locators, die außerhalb der Firewall gehostet werden, für die Batch-Geokodierung erforderlich. Dies liegt daran, dass ArcGIS Online auf die Operation geocodeAddresses Ihres Locators zugreifen können muss, um die Batch-Geokodierung durchzuführen. Wenn der externe Locator sicher ist, müssen Sie zunächst ein sicheres Service-Element in ArcGIS Online erstellen, das die für den Zugriff auf den Locator erforderlichen Anmeldeinformationen speichert. Anschließend können Sie die Service-URL, die vom sicheren Service-Element bereitgestellt wird, als Locator konfigurieren.

Wenn Sie Ihren eigenen Locator für Batch-Geokodierung konfigurieren, sollten Sie ausreichend Rechenressourcen zur Berechnung für Ihren Locator bereitstellen. ArcGIS Online sendet bei der Batch-Geokodierung viele Anforderungen gleichzeitig, um die Performance zu verbessern. Daher sollten Ihre eigenen Locators über ausreichend Rechenressourcen verfügen, um gleichzeitige Anforderungen verarbeiten zu können, ohne die Verarbeitungszeit für die Anforderungen erheblich zu beeinträchtigen.

ArcGIS Online unterstützt Locators mit einem Feld aus ArcGIS Server 10.0 und höher. Locators aus ArcGIS Server 10.0 und interne Locators können für Geosearch-Vorgänge verwendet werden, aber nicht für die Batch-Geokodierung. Für die Batch-Geokodierung sind externe Locators aus ArcGIS Server 10.1 oder höher erforderlich. Interne Locators funktionieren nur für Geosearch-Vorgänge, wenn Map Viewer, Map Viewer Classic oder andere ArcGIS Online-Clients über Zugriff auf diese internen Locators verfügen. Wenn Ihre Organisation beispielsweise Apps für die Öffentlichkeit freigibt, können nur Benutzer mit Zugriff auf Ihre internen Locators Orte mit diesen Apps suchen. Gesicherte Service-Elemente in ArcGIS Online werden derzeit in ArcGIS Desktop nicht unterstützt. Um eine Batch-Geokodierung durchführen zu können, muss Ihr Locator außerhalb Ihrer Firewall gehostet werden, damit ArcGIS Online für die Batch-Geokodierung auf die Operation geocodeAddresses Ihres Locators zugreifen kann.

Layer mit Adresseninformation anreichern

Wenn Sie einen gehosteten Feature-Layer aus einer Datei mit kommagetrennten Werten veröffentlichen, können Sie Informationen aus dem Geokodierungsprozess als Teil des gehosteten Feature-Layers aufnehmen. Diese Informationen werden vom Locator generiert und in Feldern im gehosteten Feature-Layer gespeichert.

Standardmäßig sind nur die Positionsinformationen (die XY-Koordinaten) im gehosteten Feature-Layer enthalten. Es gibt zwei Optionen zum Aufnehmen zusätzlicher Informationen in den gehosteten Feature-Layer:

  • Hängen Sie vier Felder an, mit denen der Grad der Übereinstimmung angezeigt wird: Enthält die Felder und Werte status, score, match_addr und addr_type. Diese Felder und Werte werden in der folgenden Tabelle beschrieben.
  • Hängen Sie zur Anzeige aller Positionsinformationen 50 Felder an: Enthält alle Felder aus der folgenden Tabelle.

Beachten Sie, dass diese zusätzlichen Felder und Werte die Größe des gehosteten Feature-Layers erhöhen. Um welchen Wert die Layer-Größe zunimmt, hängt von der Anzahl der Datensätze in der Eingabedatei sowie von der ausgewählten Option ab. In der folgenden Tabelle sind die Felder beschrieben, die Sie an einen gehosteten Feature-Layer anhängen können, der aus einer .csv-Datei veröffentlicht wird:

FeldBeschreibungUnterstützte Anforderungstypen

spatialReference

Der Raumbezug der Positionskoordinaten der ausgegebenen Übereinstimmung, wie durch die Eigenschaften wkid Und latestWkid festgelegt. Der Raumbezug wird durch den Eingabeparameter outSR bestimmt.

findAddressCandidates

geocodeAddresses

reverseGeocode

address

Die vollständige Adresse der Übereinstimmung, die für findAddressCandidates- und geocodeAddresses- Geokodierungsanforderungen zurückgegeben wird.

Beispiel: 380 New York St, Redlands, California, 92373

findAddressCandidates

geocodeAddresses

address (reverseGeocode only)

Die vollständige Straßenadresse für einen Ort mit Hausnummer und Straßenname.

Beispiel: 380 New York St

Hinweis:
Dieses Feld unterscheidet sich von dem Feld address, das auf die Anforderungen findAddressCandidates und geocodeAddresses zurückgegeben wird. Es wird nur für reverseGeocode zurückgegeben. Es entspricht dem Ausgabefeld StAddr für findAddressCandidates und geocodeAddresses.

reverseGeocode

location

Die Punktkoordinaten der ausgegebenen Übereinstimmungsposition, wie durch die X- und Y-Eigenschaften festgelegt. Der Raumbezug der X- und Y-Koordinaten wird durch das Ausgabefeld spatialReference bestimmt. Weitere Informationen zur Beziehung zwischen dem Positionsausgabefeld und den Ausgabeattributen X und Y finden Sie in der Beschreibung des Parameters locationType.

findAddressCandidates

geocodeAddresses

reverseGeocode

ResultID

Dieser Wert wird nur für Anforderungen vom Typ geocodeAddresses zurückgegeben. Jeder Datensatz in einer Batch-Geokodierungsantwort enthält den Wert ResultID, der dem Wert OBJECTID des jeweiligen Eingabe-Adressdatensatzes entspricht. Damit können die Ausgabefelder in der Antwort mit den Attributen in der ursprünglichen Adressentabelle verbunden werden.

geocodeAddresses

Loc_name

Der Name des Locators, der für die Rückgabe eines bestimmten Abgleichergebnisses verwendet wird.

Hinweis:

Das Feld Loc_name wird intern von der ArcGIS-Software verwendet und ist nicht für die Nutzung durch Client-Anwendungen vorgesehen.

findAddressCandidates

geocodeAddresses

Status

Gibt an, ob eine Geokodierungsanforderung eine Übereinstimmung, gleichwertige Übereinstimmungen oder keine Übereinstimmung ergibt.

Die möglichen Werte lauten wie folgt:

  • M: übereinstimmend. Die zurückgegebene Adresse stimmt mit der Anforderung überein und ist der Kandidat mit der höchsten Punktzahl.
  • T: gleichwertig. Die zurückgegebene Adresse stimmt mit der Anforderung überein, aber weist dieselbe Punktzahl wie mindestens ein weiterer Kandidat auf.
  • U: ohne Übereinstimmung. Keine Adresse stimmt mit der Anforderung überein.

findAddressCandidates

geocodeAddresses

Score

Eine Zahl von 1 bis 100, die angibt, inwieweit die Eingabetoken in einer Geokodierungsanforderung mit den Adressenelementen in einem Kandidatendatensatz übereinstimmen. 100 stellt eine perfekte Übereinstimmung dar, während niedrigere Werte für eine geringere Übereinstimmungsgenauigkeit stehen.

findAddressCandidates

geocodeAddresses

Match_addr

Die vollständige Adresse, die für die Geokodierungsanforderung zurückgegeben wird. Das Format basiert auf den Adressstandards des Landes, in dem sich die Adresse befindet.

findAddressCandidates

geocodeAddresses

reverseGeocode

LongLabel

Eine längere Version des Wertes Match_addr mit weiteren administrativen Informationen.

findAddressCandidates

geocodeAddresses

reverseGeocode

ShortLabel

Eine kürzere Version des Wertes Match_addr.

findAddressCandidates

geocodeAddresses

reverseGeocode

Addr_type

Die Übereinstimmungsebene für eine Geokodierungsanforderung. Die unterstützten Abgleichebenen sind in verschiedenen Ländern unterschiedlich.

Die möglichen Werte lauten wie folgt:

  • Subaddress: Eine Teilmenge eines PointAddress-Wertes, der den Standort der Unteradresse eines Hauses oder Gebäudes wie beispielsweise eines Appartments, Geschosses oder Einzelgebäudes in einem Komplex darstellt. Anhand der Feldwerte UnitName, UnitType, LevelName, LevelType, BldgName und BldgType können Unteradressen unterschieden werden, die ggf. mit demselben PointAddress-Wert verknüpft sind. Referenzdaten bestehen aus Punkt-Features mit zugehöriger Hausnummer, zugehörigem Straßennamen und zugehörigen Unteradressenelementen sowie Verwaltungsgebieten und optionaler Postleitzahl. Beispiel: 3836 Emerald Ave, Suite C, La Verne, CA, 91750.
  • PointAddress: Eine Straßenadresse auf Grundlage von Punkten, die Haus- oder Gebäudepositionen darstellen. Dies ist in der Regel die räumlich genaueste Abgleichebene. Referenzdaten enthalten Adressenpunkte mit zugehörigen Hausnummern und Straßennamen sowie administrativen Gebieten und optionaler Postleitzahl. Die Ausgabewerte X/Y und geometry für eine PointAddress-Übereinstimmung stellen die Position der Straßenangabe für die Adresse dar; dies ist die für Routing-Vorgänge verwendete Position. Die Werte DisplayX und DisplayY stellen den Dachpunkt oder die tatsächliche Position der Adresse dar. Beispiel: 380 New York St, Redlands, CA, 92373.
  • StreetAddress: Eine Hausanschrift, die nicht mit dem Wert PointAddress übereinstimmt, da die Hausnummer aus einem Nummernbereich interpoliert wird. Referenzdaten enthalten Straßenmittellinien mit Hausnummernbereichen sowie Angaben zu Verwaltungsgebieten und optionalen Postleitzahlen. Beispiel: 647 Haight St, San Francisco, CA, 94117.
  • StreetInt: Eine Adresse, die aus einer Straßenkreuzung sowie Informationen zur Stadt und optional zum Bundesstaat und zur Postleitzahl besteht. Dies wird aus den Referenzdaten für StreetAddress abgeleitet. Beispiel: Redlands Blvd & New York St, Redlands, CA, 92373.
  • StreetAddressExt: Eine interpolierte Straßenadressen-Übereinstimmung, die zurückgegeben wird, wenn matchOutOfRange=true und die Eingabe-Hausnummer den Hausnummernbereich für den übereinstimmenden Straßenabschnitt überschreitet.
  • DistanceMarker: Eine Straßenadresse, die die lineare Entfernung entlang einer Straße, üblicherweise in Kilometern oder Meilen, von einem bestimmten Ausgangsort angibt. Beispiel: Carr 682 KM 4, Barceloneta, 00617.
  • StreetMidBlock: Der geschätzte Mittelpunkt eines Hausnummernbereichs entlang eines Straßenabschnitts, der einem Gebäudeblock entspricht. Die Position, die für die Übereinstimmung mit einem StreetMidBlock zurückgegeben wird, ist präziser als bei einer StreetName-, aber weniger präzise als bei einer StreetAddress-Übereinstimmung. Dieser Wert ist derzeit nur für die USA verfügbar. Beispiel: 100 Block of Grant Ave, Millville, New Jersey.
  • StreetName: Dies ist ähnlich einer Hausanschrift, jedoch ohne die Hausnummer. Referenzdaten enthalten Straßenmittellinien mit zugehörigen Straßennamen (keine nummerierten Adressbereiche) sowie Verwaltungsgebiete und optional die Postleitzahl. Beispiel: W Olive Ave, Redlands, CA, 92373.
  • Locality: Ein Ortsname, der einen besiedelten Ort darstellt. Das Ausgabefeld Type liefert ausführlichere Informationen zum Typ des besiedelten Ortes. Mögliche Type-Werte für Locality-Übereinstimmungen sind Block, Sector, Neighborhood,District, City, MetroArea, County, State or Province,Territory, Country und Zone. Beispiel: Bogotá, COL
  • PostalLoc: Eine Kombination aus der Postleitzahl und dem Ortsnamen. Die Referenzdaten umfassen normalerweise eine Kombination aus Postleitzahlen- und Verwaltungs- bzw. Lokalitätsgrenzen. Beispiel: 7132 Frauenkirchen.
  • PostalExt: Eine Postleitzahl mit zusätzlicher Erweiterung, z. B. United States Postal Service ZIP+4. Die Referenzdaten umfassen Postleitzahlpunkte mit Erweiterungen. Beispiel: 90210-3841.
  • Postal: Eine Postleitzahl. Die Referenzdaten umfassen Postleitzahlpunkte. Beispiel: 90210 USA.
  • POI: Points of Interest. Die Referenzdaten enthalten Unternehmen, Landmarks und geographische Features. Beispiel: Starbucks.
  • LatLong: Ein XY-Koordinatenpaar. Der addr_type LatLong wird zurückgegeben, wenn ein XY-Koordinatenpaar, z. B. 117.155579,32.703761, als Sucheingabe verwendet wird.
  • XY: Die Übereinstimmung auf Basis der Annahme, dass die erste Eingabekoordinate der Längengrad und die zweite Koordinate der Breitengrad ist.
  • YX: Dieser Wert wird als Addr_type für den Kandidaten zurückgegeben, wenn davon ausgegangen wird, dass es sich bei der ersten Zahl in der Eingabe um den Breitengrad handelt, gefolgt vom Längengrad.
  • MGRS: Eine MGRS-Position (Military Grid Reference System), z. B. 46VFM5319397841.
  • USNG: Eine USNG-Position (United States National Grid), z. B. 15TXN29753883. Dieser Addr_type-Wert wird nur zurückgegeben, wenn der Parameter category in einer findAddressCandidates- oder geocodeAddresses-Anforderung auf USNG festgelegt ist.

findAddressCandidates

geocodeAddresses

reverseGeocode

Type

Der Feature-Typ für Ergebnisse, die von einer Suche zurückgegeben werden. Das Feld Type enthält nur einen Wert für Kandidaten, wenn Addr_type gleich POI oder Locality lautet. Als Beispiel für Starbucks, Type=Coffee Shop.

findAddressCandidates

geocodeAddresses

reverseGeocode

PlaceName

Der formelle Name eines Kandidaten für übereinstimmende Geokodierung. Beispiel: Paris oder Starbucks.

findAddressCandidates

geocodeAddresses

reverseGeocode

Place_addr

Die vollständige Adresse eines Ortes, einschließlich Straße, Stadt und Region. Beispiel: 275 Columbus Ave, New York, New York.

findAddressCandidates

geocodeAddresses

Phone

Die primäre Telefonnummer eines Point of Interest (POI). Beispiel: Knott's Berry Farm, Phone=(714)220-5200. Bei anderen Suchvorgängen, z. B. nach Adresse, Kreuzung und Postleitzahl, ist das Feld leer.

findAddressCandidates

geocodeAddresses

URL

Die URL der primären Website für einen Point of Interest (POI). Beispiel: the University of Georgia, URL =http://www.uga.edu/. Bei anderen Suchvorgängen, z. B. nach Adresse, Kreuzung und Postleitzahl, ist das Feld leer.

findAddressCandidates

geocodeAddresses

Rank

Ein Gleitkommawert, der die Priorität eines Ergebnisses im Vergleich zu anderen Ergebnissen mit dem gleichen Namen anzeigt. Beispielsweise gibt es in Frankreich und Texas Städte mit dem Namen Paris. Paris, Frankreich, hat eine höhere Bevölkerungszahl als Paris, Texas, weswegen es einen höheren Rang erhält. Das Feld Rank wird zur Sortierung von Ergebnissen aus mehrdeutigen Abfragen verwendet, z. B. "Lincoln", bei denen keine zusätzlichen Informationen (Bundesstaat) vorliegen. Rank-Werte basieren auf der Bevölkerung oder dem Feature-Typ.

findAddressCandidates

geocodeAddresses

AddBldg

Der Name eines Gebäudes. Beispiel: Empire State Building.

findAddressCandidates

geocodeAddresses

AddNum

Der alphanumerische Wert, der den Teil einer Adresse darstellt, die generell als Hausnummer oder Gebäudenummer bekannt ist. Beispiel: AddNum = 380 in der Adresse 380 New York Street.

Dieser Wert wird nur für PointAddress- und StreetAddress-Übereinstimmungen zurückgegeben.

findAddressCandidates

geocodeAddresses

reverseGeocode

AddNumFrom

Ein Wert, der die Anfangszahl eines Straßenadressenbereichs angibt. Er wird relativ zur Digitalisierungsrichtung des Features angegeben und muss nicht zwingend die kleinste Zahl des Bereichs sein. Dieser Wert wird für Ergebnisse vom Typ StreetAddress zurückgegeben.

findAddressCandidates

geocodeAddresses

AddNumTo

Ein Wert, der die letzte Zahl eines Straßenadressenbereichs angibt. Er wird relativ zur Digitalisierungsrichtung des Features angegeben und muss nicht zwingend die größte Zahl des Bereichs sein. Dieser Wert wird für Ergebnisse vom Typ StreetAddress zurückgegeben.

findAddressCandidates

geocodeAddresses

AddRange

Der vollständige Hausnummernbereich für das Straßensegment, an dem eine Adresse liegt, im Format AddNumFrom-AddNumTo. Beispielsweise kann AddRange für die Adresse "123 Main St." den Wert "101-199" aufweisen.

findAddressCandidates

geocodeAddresses

Side

Die Straßenseite, auf der sich eine Adresse befindet, relativ zur Digitalisierungsrichtung des Features. Dieser Wert ist nicht relativ zur Fahrtrichtung entlang der Straße. Mögliche Werte sind R (rechts) und L (links).

Hinweis:

Side ist ein Feld aus einer Vorversion, das lediglich zur Unterstützung von Anwendungen, die das Feld in der REST-Antwort erwarten, beibehalten wird. In den meisten Adressen, die vom Geokodierungsservice zurückgegeben werden, ist das Feld leer. Es darf nicht zu Analysezwecken verwendet werden.

findAddressCandidates

geocodeAddresses

StPreDir

Ein Adressenelement, das die Richtung einer Straße definiert und vor dem primären Straßennamen steht. Beispiel: "North" in North Main Street.

findAddressCandidates

geocodeAddresses

StPreType

Ein Adressenelement, das den vorangestellten Typ einer Straße definiert. Beispiel: der spanische Begriff "Avenida" in Avenida Central oder der französische Begriff "Rue" in Rue Lapin.

findAddressCandidates

geocodeAddresses

StName

Ein Adressenelement, das den primären Namen einer Straße definiert. Beispiel: "Main" in North Main Street.

findAddressCandidates

geocodeAddresses

StType

Ein Adressenelement, das den nachgestellten Typ einer Straße definiert. Beispiel: "Street" in Main Street.

findAddressCandidates

geocodeAddresses

StDir

Ein Adressenelement, das die Richtung einer Straße definiert und dem primären Straßennamen nachgestellt ist. Beispiel: "North" in Main Street North.

findAddressCandidates

geocodeAddresses

BldgName

Der Name oder die Nummer einer Gebäudeuntereinheit. Beispiel: A in Gebäude A.

findAddressCandidates

geocodeAddresses

BldgType

Die Klassifizierung einer Gebäudeuntereinheit. Beispiele sind Gebäude, Hangar und Turm.

findAddressCandidates

geocodeAddresses

LevelType

Die Klassifizierung einer Geschossuntereinheit. Beispiele sind Etage, Stockwerk, Bereich und Flügel.

findAddressCandidates

geocodeAddresses

LevelName

Der Name oder die Nummer einer Etagenuntereinheit. Beispiel: 3 in Etage 3.

findAddressCandidates

geocodeAddresses

UnitType

Die Klassifizierung einer Einheitenuntereinheit. Beispiele sind Einheit, Appartment, Wohnung, Büro und Suite.

findAddressCandidates

geocodeAddresses

UnitName

Der Name oder die Nummer einer Einheitenuntereinheit. Beispiel: 2B in Appartement 2B.

findAddressCandidates

geocodeAddresses

SubAddr

Der vollständige Wert der Untereinheit für einen Kandidaten mit Addr_type=Subaddress, der <subunit type> + <subunit name> beinhaltet. Zum Beispiel ist SubAddr = UnitType + UnitName, wenn der Unteradressen-Kandidat eine Appartmenteinheit ist. Beispiel: Apt 4B.

findAddressCandidates

geocodeAddresses

StAddr

Die Straßenadresse eines Ortes ohne Angabe der Stadt und Region. Beispiel: 275 Columbus Ave.

findAddressCandidates

geocodeAddresses

Block

Der Name der Verwaltungseinheit auf Blockebene für einen Kandidaten. Der Wert Block ist das kleinste Verwaltungsgebiet eines Landes. Er kann als Unterteilung eines Sektors oder einer Nachbarschaft oder als ein benanntes Stadtviertel beschrieben werden. Er wird nur selten verwendet.

findAddressCandidates

geocodeAddresses

reverseGeocode

Sector

Der Name der Verwaltungseinheit auf Sektorebene für einen Kandidaten. Der Wert Sector ist eine Unterteilung einer Nachbarschaft oder eines Bezirks oder besteht aus einer Reihe von Blocks. Er wird nur selten verwendet.

findAddressCandidates

geocodeAddresses

reverseGeocode

Nbrhd

Der Name der Verwaltungseinheit auf Nachbarschaftsebene für einen Kandidaten. Der Wert Nbhrhd ist eine Untersektion einer Stadt oder eines Bezirks.

findAddressCandidates

geocodeAddresses

Neighborhood

Der Name der Verwaltungseinheit auf Nachbarschaftsebene für einen Kandidaten. Der Wert Neighborhood ist eine Untersektion einer Stadt oder eines Bezirks.

Hinweis:
Dieser entspricht dem Ausgabefeld Nbhrhd für findAddressCandidates- und geocodeAddresses-Anforderungen.

reverseGeocode

District

Der Name der Verwaltungseinheit auf Bezirksebene für einen Kandidaten. Z. B. eine Unterteilung einer Stadt.

findAddressCandidates

geocodeAddresses

reverseGeocode

City

Der Name der Verwaltungseinheit auf Stadtebene für einen Kandidaten. Der Wert City ist eine Unterteilung einer Unterregion oder Region.

findAddressCandidates

geocodeAddresses

reverseGeocode

MetroArea

Der Name der Verwaltungseinheit auf Ballungsgebietebene für einen Kandidaten. Es handelt sich um ein Stadtgebiet, bestehend aus einer großen Stadt und den darum befindlichen kleineren Städten. Dieser Wert kann potenziell mehrere Unterregionen oder Regionen schneiden. Ein Beispiel hierfür ist Kolkata Metropolitan Area in Indien.

findAddressCandidates

geocodeAddresses

reverseGeocode

Subregion

Der Name der Verwaltungseinheit auf Unterregionsebene für einen Kandidaten. Der Wert Subregion ist eine Unterteilung einer Region.

findAddressCandidates

geocodeAddresses

reverseGeocode

Region

Der Name der Verwaltungseinheit auf Regionsebene für einen Kandidaten. Es handelt sich um eine Unterteilung eines Landes oder Gebiets. Üblicherweise ist es die größte Verwaltungseinheit für ein Land, wenn die Verwaltungseinheit Territory nicht verwendet wird.

findAddressCandidates

geocodeAddresses

reverseGeocode

RegionAbbr

Der abgekürzte Name einer Region. Für Kalifornien lautet der Wert für RegionAbbr CA.

findAddressCandidates

geocodeAddresses

reverseGeocode

Territory

Der Name der Verwaltungseinheit auf Gebietsebene für einen Kandidaten. Es handelt sich um eine Unterteilung eines Landes. Er wird nur selten verwendet. Ein Beispiel wäre die brasilianische Makroregion Sudeste, die aus den Bundesstaaten Espírito Santo, Minas Gerais, Rio de Janeiro und São Paulo besteht.

findAddressCandidates

geocodeAddresses

reverseGeocode

Postal

Ein alphanumerisches Adressenelement, das die primäre Postleitzahl definiert. Beispiel: V7M 2B4 für eine kanadische Postleitzahl oder 92374 für eine Postleitzahl der USA.

findAddressCandidates

geocodeAddresses

reverseGeocode

PostalExt

Ein alphanumerisches Adressenelement, das die Postleitzahl-Erweiterung definiert. Beispiel: "8100" in der US-amerikanischen Postleitzahl 92373-8110.

findAddressCandidates

geocodeAddresses

reverseGeocode

Country

Ein aus drei Zeichen bestehender Ländercode. Beispiel: CAN für Kanada. Eine Liste der unterstützten Länder und Codes finden Sie unter Geocode data coverage. Das Feld wird von den Operationen findAddressCandidates und geocodeAddresses zurückgegeben.

findAddressCandidates

geocodeAddresses

CountryCode

Ein aus drei Zeichen bestehender Ländercode. Beispiel: CAN für Kanada. Eine Liste der unterstützten Länder und Codes finden Sie unter Geocode data coverage.

Hinweis:
Dieser entspricht dem Ausgabefeld Country für findAddressCandidates- und geocodeAddresses-Anforderungen.

reverseGeocode

CntryName

Der vollständige Ländername für einen Adresskandidaten. Beispiel: 日本 (Japan). Für den Namen kann die gleiche Sprache wie in der Eingabeadresse oder die mit dem Parameter langCode für die Anforderung angegebene Sprache verwendet werden. Wenn der vollständige Ländername in der angegebenen Sprache nicht verfügbar ist, wird die primäre Sprache des Landes verwendet, in dem sich der Adresskandidat befindet. Informationen zu unterstützten Sprachen nach Ländern finden Sie unter Geocode data coverage. Das Feld wird von den Operationen findAddressCandidates, geocodeAddresses und reverseGeocode zurückgegeben.

findAddressCandidates

geocodeAddresses

reverseGeocode

LangCode

Ein dreistelliger Sprachcode, der der Sprache der Adresse entspricht. Beispiel: ENG für Englisch.

findAddressCandidates

geocodeAddresses

Distance

Die physische Entfernung in Meter von einem Kandidaten zu einer angegebenen Position. Der Ausgabewert für Distance wird für jeden Kandidaten berechnet, wenn der Location-Eingabeparameter in einer Anforderung mit der Operation findAddressCandidates übergeben wird. Wenn der Parameter Location in einer Anforderung nicht übergeben wird, ist der Wert von Distance Null.

findAddressCandidates

X

Die primäre X-Koordinate einer Adresse, die vom ArcGIS World Geocoding Service zurückgegeben wird, im Raumbezug WGS84 (WKID 4326).

findAddressCandidates

geocodeAddresses

Y

Die primäre Y-Koordinate einer Adresse, die vom ArcGIS World Geocoding Service zurückgegeben wird, im Raumbezug WGS84 (WKID 4326).

findAddressCandidates

geocodeAddresses

DisplayX

Die angezeigte X-Koordinate einer Adresse, die vom ArcGIS World Geocoding Service zurückgegeben wird, im Raumbezug WGS84 (WKID 4326). Für die meisten Übereinstimmungstypen entsprechen sich die Werte für X und DisplayX. Bei Übereinstimmungen für Addr_type, PointAddress und Subaddress können sich unterschiedliche Werte ergeben. Bei PointAddress- und Subaddress-Übereinstimmungen steht DisplayX im Allgemeinen für den X-Koordinatenwert des Gebäudedachs oder Flurstücksschwerpunktes der Adresse und der X-Wert stellt die X-Koordinate der Straßenseitenposition der Adresse dar. Jedoch gibt es auch Ausnahmen. Von einigen der Adressendatenquellen, die vom ArcGIS World Geocoding Service verwendet werden, wird nur die Dachposition von PointAddress- und Subaddress-Features angegeben. Für manche PointAddress- und Subaddress-Features ist jedoch nur die Straßenseitenposition verfügbar. In diesen Fällen entsprechen die Werte für X und DisplayX einander.

findAddressCandidates

geocodeAddresses

DisplayY

Die angezeigte Y-Koordinate einer Adresse, die vom ArcGIS World Geocoding Service zurückgegeben wird, im Raumbezug WGS84 (WKID 4326). Für die meisten Übereinstimmungstypen entsprechen sich die Werte für Y und DisplayY. Bei Übereinstimmungen für Addr_type, PointAddress und Subaddress können sich unterschiedliche Werte ergeben. Bei PointAddress- und Subaddress-Übereinstimmungen steht DisplayY im Allgemeinen für den Y-Koordinatenwert des Gebäudedachs oder Flurstücksschwerpunktes der Adresse und der Y-Wert stellt die Y-Koordinate der Straßenseitenposition der Adresse dar. Jedoch gibt es auch Ausnahmen. Von einigen der Adressendatenquellen, die vom ArcGIS World Geocoding Service verwendet werden, wird nur die Dachposition von PointAddress- und Subaddress-Features angegeben. Für manche PointAddress- und Subaddress-Features ist jedoch nur die Straßenseitenposition verfügbar. In diesen Fällen entsprechen die Werte für Y und DisplayY einander.

findAddressCandidates

geocodeAddresses

Xmin

Die minimale X-Koordinate für die Anzeigeausdehnung eines vom ArcGIS World Geocoding Service zurückgegebenen Features. Die Werte Xmin, Xmax, Ymin und Ymax können miteinander kombiniert werden, um die Kartenausdehnung für die Anzeige eines Geokodierungsergebnisses festzulegen. Von den Ausdehnungskoordinaten wird der Raumbezug WGS84 verwendet.

findAddressCandidates

geocodeAddresses

Xmax

Die maximale X-Koordinate für die Anzeigeausdehnung eines vom ArcGIS World Geocoding Service zurückgegebenen Features. Die Werte Xmin, Xmax, Ymin und Ymax können miteinander kombiniert werden, um die Kartenausdehnung für die Anzeige eines Geokodierungsergebnisses festzulegen. Von den Ausdehnungskoordinaten wird der Raumbezug WGS84 verwendet.

findAddressCandidates

geocodeAddresses

Ymin

Die minimale Y-Koordinate für die Anzeigeausdehnung eines vom ArcGIS World Geocoding Service zurückgegebenen Features. Die Werte Xmin, Xmax, Ymin und Ymax können miteinander kombiniert werden, um die Kartenausdehnung für die Anzeige eines Geokodierungsergebnisses festzulegen. Von den Ausdehnungskoordinaten wird der Raumbezug WGS84 verwendet.

findAddressCandidates

geocodeAddresses

Ymax

Die maximale Y-Koordinate für die Anzeigeausdehnung eines vom ArcGIS World Geocoding Service zurückgegebenen Features. Die Werte Xmin, Xmax, Ymin und Ymax können miteinander kombiniert werden, um die Kartenausdehnung für die Anzeige eines Geokodierungsergebnisses festzulegen. Von den Ausdehnungskoordinaten wird der Raumbezug WGS84 verwendet.

findAddressCandidates

geocodeAddresses

ExInfo

Eine Sammlung von Eingabezeichenfolgen, die mit keinem Teil einer Adresse abgeglichen werden konnten und zum Bewerten oder Sanktionieren des Ergebnisses verwendet wurden.

findAddressCandidates

geocodeAddresses

extent

Das kleinste umgebende Rechteck des Ausgabe-Features, das durch die Feldwerte Xmin, Ymin, Xmax und Ymax festgelegt wird. Der Raumbezug der X- und Y-Koordinaten wird durch das Ausgabefeld spatialReference bestimmt. Dieser Wert wird nur für findAddressCandidates-Geokodierungsanforderungen immer standardmäßig zurückgegeben.

findAddressCandidates