ReverseGeocodeUSLocation
ReverseGeocodeUSLocation は、緯度と経度のポイントを入力として受け取り、そのポイントに最も近い住所を返します。例えば、次の情報を入力したとします。
Longitude: -105239771 Latitude: 40018912 Search Distance: 150 feet
この入力からは、次の出力が得られます。
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 は、次の手順でジオコードを処理します。
- ReverseGeocodeUSLocation は、入力されたジオコードと検索距離に基づいて小さな四角形を定義します。
- ReverseGeocodeUSLocation は、各通りセグメントから入力された場所までの距離を計算します。
- 最も近いセグメントを特定したら、ReverseGeocodeUSLocation は、オフセットと補完率を (圧縮係数を使って) 決定し、場所が通りのどちらの側かを判断します。次に、この情報を基にして近似の家番号を計算します。
入力された場所への距離が等しいセグメントが複数見つかった場合は、複数マッチが発生します。ReverseGeocodeUSLocation は、距離が等しいすべてのセグメントの情報を返すので、その中から適切なセグメントを判断できます。
- ReverseGeocodeUSLocation は、標準的な住所情報に加え、セグメントの範囲、近似の家番号、住所範囲の奇遇性なども返します。
ReverseGeocodeUSLocation を使うには、GSX ファイルという追加のデータ ファイルが必要です。ジオコーディング データベースをインストールする際に、これらのファイルをインストールするオプションを利用できます。GSX ファイルは、ジオコーディング データベースの GSX サブディレクトリに常にインストールします。Centrus Enhanced Points、Centrus Premium Points、または Centrus TomTom Points データベースをインストールする場合は、GSX ファイルを再作成する必要があります。GSX ファイルの詳細については、Pitney Bowes Software のテクニカル サポートにお問い合わせください。
リソース URL
JSON エンドポイント:
http://server:port/rest/ReverseGeocodeUSLocation/results.json
XML エンドポイント:
http://server:port/rest/ReverseGeocodeUSLocation/results.xml
JSON 応答の例
次の例では、JSON 応答を要求します。
http://myserver:8080/rest/ReverseGeocodeUSLocation/results.json?Data.Longitude=-73549161&Data.Latitude=41071067
この要求から次のような JSON が返されます。
{"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": []
}]}
XML 応答の例
次の例では、XML 応答を要求します。
http://myserver:8080/rest/ReverseGeocodeUSLocation/results.xml?Data.Latitude=41071067&Data.Longitude=-73549161
この要求から次のような XML が返されます。
<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>