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 は、標準的な住所情報に加え、セグメントの範囲、近似の家番号、住所範囲の奇遇性なども返します。

注: 標準住所マッチングの出力は、大部分がリバースジオコーディングオプションに適用されますが、いくつかの出力 (LACS^Link 情報や単位番号など) は使用できません。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>