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 für diese Kandidatenadresse verfügbar.                

1 Interpolierte Straßenadresse

2 Mittelpunkt des Straßensegments

3 Mittelpunkt von Postleitzahl 1

4 Teilweiser Mittelpunkt von Postleitzahl 2

5 Mittelpunkt von Postleitzahl 2

6 Kreuzung

7 Point of Interest (Wenn die Datenbank POI-Daten enthält.)

8 Mittelpunkt des Bundeslandes oder der Region

9 Mittelpunkt des Bezirks

10 Mittelpunkt der Stadt

11 Mittelpunkt des Ortes

12–15 Für nicht spezifizierte benutzerdefinierte Objekte 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 der Funktion „Mittellinienversatz“ projiziert wurde. Zur Verwendung der Funktion „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 Geometrietyp. 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.
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 The range is on the left side of the street.

RIGHT The range is on the right side of the street.

BOTH The range is on both the left and right side of the street.

UNKNOWN No information is available on the side of the street this range is located.
oddEvenIndicator Zeichenfolge Stellt Informationen zur Hausnummerierung des Kandidatenbereichs zur Verfügung.

ODD The range contains odd house numbers.

EVEN The range contains even house numbers.

BOTH The range contains both odd and even house numbers.

IRREGULAR The range contains both even and odd numbers in an irregular order.

UNKNOWN No information is available on the odd/even house numbering on this range.
customValues Mapping Ein Mapping lokaler Werte, die mit dem Kandidatenbereich verknüpft sind.