ReverseGeocodeUSLocation
ReverseGeocodeUSLocation verwendet einen Längengrad- und Breitengradpunkt als Eingabe und gibt die Adresse zurück, die am besten mit diesem Punkt übereinstimmt. Zum Beispiel könnten Sie die folgenden Daten eingeben:
Longitude: -105239771 Latitude: 40018912 Search Distance: 150 Fuß
Aus dieser Eingabe ergäbe sich die folgende Ausgabe:
4750 WALNUT ST BOULDER, CO 80301-2538
MatchCode = NS0
LocCode = AS0
Lon = -105239773
Lat = 40018911
Distances:
Search = 150
Offset = 50
Squeeze = 50
Nearest = 50.0
Pct Geocode = 94.0
SegID = 472881795
PtID = GDT
Block = 080130122032066
County Name = BOULDER COUNTY
DPBC = 50
ReverseGeocodeUSLocation verarbeitet Geocodes in der folgenden Reihenfolge:
- ReverseGeocodeUSLocation definiert ein kleines Rechteck basierend auf Ihrem eingegebenen Geocode und der Suchentfernung.
- ReverseGeocodeUSLocation berechnet die Entfernung zwischen jedem Straßensegment und der eingegebenen Position.
- Ist ein Segment am nächsten, sucht ReverseGeocodeUSLocation den Versatz, den interpolierten Prozentsatz (mithilfe des Verdichtungsfaktors) und die Straßenseite. Anschließend wird eine ungefähre Hausnummer auf Basis dieser Informationen berechnet.
Wenn es mehr als ein Segment gibt, das gleich nah zur eingegebenen Position ist, tritt eine Mehrfachübereinstimmung auf. ReverseGeocodeUSLocation gibt die Informationen für alle der gleich nahen Segmente zurück, sodass Sie das zutreffende Segment bestimmen können.
- ReverseGeocodeUSLocation gibt die Adressinformationen, einschließlich Segmentbereich, die ungefähre Hausnummer und die Parität des Bereichs zusammen mit anderen Standardadressinformationen zurück.
Für die Verwendung von ReverseGeocodeUSLocation benötigen Sie zusätzliche Datendateien, die als GSX-Dateien bezeichnet werden. Es gibt eine Option zur Installation dieser Dateien, wenn Sie die Geocoding-Datenbank installieren. Die GSX-Dateien müssen im GSX-Unterverzeichnis der Geocoding-Datenbank installiert werden. Wenn Sie die „Centrus Enhanced Points“-, „Centrus Premium Points“- oder „TomTom Points“-Datenbank installieren, müssen Sie die GSX-Dateien neu erstellen. Wenden Sie sich an den technischen Support von Pitney Bowes Software, wenn Sie weitere Informationen zu GSX-Dateien benötigen.
Ressourcen-URL
JSON-Endpunkt:
http://server:port/rest/ReverseGeocodeUSLocation/results.json
XML-Endpunkt:
http://server:port/rest/ReverseGeocodeUSLocation/results.xml
Beispiel mit JSON-Antwort
Im folgenden Beispiel wird eine JSON-Antwort angefordert:
http://myserver:8080/rest/ReverseGeocodeUSLocation/results.json?Data.Longitude=-73549161&Data.Latitude=41071067
Die von dieser Anforderung zurückgegebene JSON-Antwort würde wie folgt lauten:
{"output_port": [{
"Latitude": "41.071067",
"Longitude": "-73.549161",
"StreetSide": "R",
"Distance": "50.4",
"PercentGeocode": "50.0",
"FirmName": "",
"AddressLine1": "2995 Summer St",
"AddressLine2": "",
"LastLine": "Stamford, CT 06905",
"AdditionalInputData": "",
"City": "Stamford",
"StateProvince": "CT",
"PostalCode.Base": "06905",
"PostalCode.AddOn": "",
"PostalCode": "06905",
"USUrbanName": "",
"Country": "United States of America",
"LocationCode": "AS0",
"MatchCode": "NS1",
"StreetDataType": "TOMTOM",
"Confidence": "100.0",
"ProcessedBy": "KGL",
"PBKey": "",
"Status": "",
"Status.Code": "",
"Status.Description": "",
"user_fields": []
}]}
Beispiel mit XML-Antwort
Im folgenden Beispiel wird eine XML-Antwort angefordert:
http://myserver:8080/rest/ReverseGeocodeUSLocation/results.xml?Data.Latitude=41071067&Data.Longitude=-73549161
Die von dieser Anforderung zurückgegebene XML-Antwort würde wie folgt lauten:
<xml.ReverseGeocodeUSLocationResponse xmlns="http://www.pb.com/spectrum/services/ReverseGeocodeUSLocation">
<output_port>
<Address>
<Latitude>41.071067</Latitude>
<Longitude>-73.549161</Longitude>
<StreetSide>R</StreetSide>
<Distance>50.4</Distance>
<PercentGeocode>50.0</PercentGeocode>
<FirmName/>
<AddressLine1>2995 Summer St</AddressLine1>
<AddressLine2/>
<LastLine>Stamford, CT 06905</LastLine>
<AdditionalInputData/>
<City>Stamford</City>
<StateProvince>CT</StateProvince>
<PostalCode.Base>06905</PostalCode.Base>
<PostalCode.AddOn/>
<PostalCode>06905</PostalCode>
<USUrbanName/>
<Country>United States of America</Country>
<LocationCode>AS0</LocationCode>
<MatchCode>NS1</MatchCode>
<StreetDataType>TOMTOM</StreetDataType>
<Confidence>100.0</Confidence>
<ProcessedBy>KGL</ProcessedBy>
<PBKey/>
<Status/>
<Status.Code/>
<Status.Description/>
<user_fields/>
</Address>
</output_port>
</xml.ReverseGeocodeUSLocationResponse>