ReverseGeocodeServiceResponse-Objekt

Eine Anforderung an den Reverse Geocode-Dienst gibt ein GeocodeServiceResponse-Objekt mit dem folgenden Inhalt zurück:
  • totalPossibleCandidates: Die Gesamtzahl der möglichen Kandidaten.
  • totalMatches: Die Gesamtzahl der Übereinstimmungen.
  • candidates-Objekt: Führt einen oder mehrere Kandidaten auf, die mit Ihrer Eingabekoordinate/Ihren Eingabekoordinaten übereinstimmen. Vergleichs- und Adressinformationen werden für jeden Kandidaten zurückgegeben.
Tabelle 1. Definitionen der GeocodeServiceResponse-Elemente
Name Typ Beschreibung
totalPossibleCandidates Ganze Zahl Gibt die Gesamtzahl der möglichen Kandidaten an.
totalMatches Ganze Zahl Gibt die Gesamtzahl der Übereinstimmungen an.
candidates: Objekt vom Typ Candidate, das aus einem Array mit einem oder mehreren übereinstimmenden Kandidaten und zugehörigen Adress-, Vergleichs- und Standortinformationen zusammengesetzt ist Enthält die folgenden Elemente:
precisionLevel Ganze Zahl Ein Code, der die Genauigkeit des Geocodes angibt. Zur Auswahl stehen:
0
Es sind keine Koordinateninformationen zu dieser Adresse verfügbar.
1
Interpolierte Straßenanschrift.
2
Mittelpunkt des Straßensegments.
3
Mittelpunkt von Postleitzahl 1.
4
Mittelpunkt der Teil-Postleitzahl 2.
5
Mittelpunkt von Postleitzahl 2.
6
Kreuzung.
7
Point of Interest. (Wenn die Datenbank POI-Daten enthält.)
8
Bundesland-/Kantonmittelpunkt.
9
Bezirksmittelpunkt.
10
Ortsmittelpunkt.
11
Lokalitätsmittelpunkt.
12-15
Für unbestimmte benutzerdefinierte Elemente reserviert.
16
Das Ergebnis ist ein Adresspunkt.
17
Das Ergebnis wurde generiert, indem die Segmentdaten des Kandidaten mithilfe von Adresspunktdaten geändert wurden.
18
Das Ergebnis ist ein Adresspunkt, der mithilfe des Features „Versatz von Mittellinie“ projiziert wurde. Zur Verwendung des Features „Versatz von Mittellinie“ müssen Sie eine Punkt- und Straßenbereichsdatenbank haben.
Anmerkung: Dieses Feld wird für die USA nicht zurückgegeben. Informationen zur Geocode-Genauigkeit für die USA erhalten Sie unter Positionscodes.
formattedStreetAddress Zeichenfolge

Die formatierte Hauptadresszeile.

formattedLocationAddress Zeichenfolge Die formatierte letzte Adresszeile.
precisionCode Zeichenfolge Der zurückgegebene Reverse Geocoding-Ergebniscode. Die Definitionen finden Sie im Anhang. Für USA lesen Sie weiter unter Adresspositionscodes, für alle anderen Länder unter R-Ergebniscodes für Reverse Geocoding.
sourceDictionary Zeichenfolge Identifiziert das Wörterbuch, das die Quelle für die Kandidateninformationen und -daten ist. Bei dem Quellwörterbuch handelt es sich um einen nullbasierten Ganzzahlwert, der angibt, aus welchem konfigurierten Wörterbuch der Kandidat stammt. Wenn Sie nur ein einzelnes Wörterbuch haben, wird dieser Wert immer „0“ sein.
geometry-Objekt. Zurückgegebener Geocode, der die folgenden Elemente umfasst:
coordinates Double Der Geocode des Kandidaten, der als X-Koordinate (Längengrad) und Y-Koordinate (Breitengrad) angegeben wird, die durch ein Komma getrennt sind.
crs Zeichenfolge Das referenzierte Koordinatensystem, das für den Geocode des Kandidaten verwendet wird.
type Zeichenfolge Geometry-Typ. Der Rückgabewert lautet stets Point.
address-Objekt. Zurückgegebene Kandidatenadresse, die einige der folgenden Elemente enthalten kann:
mainAddressLine Zeichenfolge Adresszeile des Kandidaten.
addressLastLine Zeichenfolge Letzte Adresszeile des Kandidaten.
placeName Zeichenfolge Name der Firma, der Organisation, des Unternehmens oder Gebäudes.
areaName1 Zeichenfolge Bundesland, Kanton oder Region.
areaName2 Zeichenfolge Bezirk oder Landkreis.
areaName3 Zeichenfolge Ort, Stadt oder Vorort.
areaName4 Zeichenfolge Lokalität
postCode1 Zeichenfolge Hauptpostleitzahl.
postCode2 Zeichenfolge Sekundäre Postleitzahl, soweit vorhanden.
country Zeichenfolge Land
addressNumber Zeichenfolge Haus- oder Gebäudenummer.
streetName Zeichenfolge Straßenname.
unitType Zeichenfolge Der Typ der Einheit, z. B. Apt, Etage und Gebäude.
unitValue Zeichenfolge Der Wert/die Nummer der Einheit, z. B. „3B“.
customFields Objekt Die Felder und entsprechenden Rückgabewerte sind landesspezifisch. Informationen finden Sie in den Abschnitten Landesspezifische Informationen im Anhang.
ranges:CandidateRange-Objekt. Enthält Informationen zu den Bereichen eines Kandidaten, bestehend aus den folgenden Elementen:
placeName Zeichenfolge Gibt den Namen des Ortes oder Gebäudes des Kandidaten an, falls zutreffend.
lowHouse Zeichenfolge Gibt die niedrigste Hausnummer im Straßenbereich des Kandidaten an.
highHouse Zeichenfolge Gibt die höchste Hausnummer im Straßenbereich des Kandidaten an.
side Zeichenfolge Stellt Informationen zur Straßenseite zur Verfügung, auf der sich der Bereich des Kandidaten befindet.
LEFT
Der Bereich befindet sich auf der linken Seite der Straße.
RIGHT
Der Bereich befindet sich auf der rechten Seite der Straße.
BOTH
Der Bereich befindet sich auf der linken und rechten Seite der Straße.
UNKNOWN
Es sind keine Informationen zur Straßenseite verfügbar, auf der sich dieser Bereich befindet.
oddEvenIndicator Zeichenfolge Stellt Informationen zur Hausnummerierung des Kandidatenbereichs zur Verfügung.
ODD
Der Bereich umfasst ungerade Hausnummern.
EVEN
Der Bereich umfasst gerade Hausnummern.
BOTH
Der Bereich umfasst ungerade und gerade Hausnummern.
IRREGULAR
Der Bereich umfasst gerade und ungerade Hausnummern in einer unregelmäßigen Sortierung.
UNKNOWN
Es sind keine Informationen zur ungeraden/geraden Hausnummerierung für diesen Bereich verfügbar.
customValues Karte Eine Zuordnung lokaler Werte, die mit dem Kandidatenbereich verknüpft sind.