ジオコーディング オプション
以下の表に、特定の場所の座標を決定する方法を制御するためのオプションを示します。
パラメータ |
説明 |
---|---|
Option.GeocodeLevel |
住所のジオコーディングをどのレベルの精度で行うかを指定します。次のいずれかです。
|
Option.Interpolation |
住所ポイント補間を行うかどうかを指定します。このオプションは、ポイント データベースがインストールされている場合のみ機能します。このオプションは選択された国でのみ使用できます。
|
Option.FallbackToGeographic |
住所レベルのジオコードを決定できない場合に、地理的セントロイドを決定しようとするかどうかを指定します。
|
Option.FallbackToPostal |
住所レベルのジオコードを決定できない場合に郵便番号セントロイドを決定しようとするかどうかを指定します。
|
Option.OffsetFromStreet |
ストリートレベルのジオコーディングに使うストリートセグメントからのオフセット距離を指定します。距離の指定は、OffsetUnits オプションで指定した単位で行います。 デフォルト値は国によって異なります。ほとんどの国では、デフォルト値は 7 メートルです。 オフセット距離は、ジオコードがストリートの中央に位置付けられるのを防ぐために、ストリートレベルのジオコーディングで使われます。ストリートレベルのジオコーディングを行うと、住所が位置するストリートの中心点の緯度/経度が返されますが、これを補正するのがオフセットです。住所が指し示す建物はストリートの真上に建っているわけではないので、路上のポイントに相当する住所のジオコードが返されるのは不都合です。ジオコードは、ストリートに面して建つ建物の場所を表している必要があります。例えば、50 フィートのオフセットは、ジオコードがストリートの中心から 50 フィート離れた場所を表すことを意味します。距離は、住所のストリートセグメントから垂直方向に計算されます。また、オフセットは、ストリートをはさんで向かい合う住所が同じポイントになるのを防ぐ目的にも使われます。以下に、オフセット ポイントと元のポイントとの比較図を示します。 ストリートの座標は 1/10,000 度の精度で決定され、補間ポイントは 1/1,000,000 度の精度で決定されます。 |
Option.OffsetFromCorner |
ストリートレベルでのマッチングに使うストリートの終端からのオフセットを指定します。距離の指定は、OffsetUnits オプションで指定した単位で行います。この値は、ストリートの角の住所に交差点と同じジオコードが与えられるのを防ぐために使われます。 注: オフセットは英国 (GBR) および日本 (JPN) ではサポートされません。
デフォルト値は国よって異なります。
以下に、ストリートの終点とオフセット終点の比較図を示します。 |
Option.OffsetUnits |
ストリートオフセットと角オフセットのオプションに使う距離単位を指定します。次のいずれかです。
デフォルトは、メートルです。 |
Option.CoordinateSystem |
座標系は、空間におけるポイントの位置を一意に表すリファレンス システムです。カルテシアン (二次元) 座標、測地 (地理) 座標などが、ユークリッド幾何学に基づくリファレンス システムとして挙げられます。Spectrum™ Technology Platformは、European Petroleum Survey Group (EPSG) によって認識されるシステムをサポートしています。 国によって異なる座標系が採用されています。国によっては、次のオプションを 1 つ以上使用できます。
|
Option.IncludeInputs |
書式を整えた入力ストリート住所と、個別のフィールドに分けられた各入力住所要素を返すかどうかを指定します。この機能により、入力住所がどのように解釈されたかを理解し、どの入力要素がジオコーディングできなかったかを把握することができます。例えば、返された HouseNumber.Input には、入力住所の無効な家番号が含まれている可能性があります。 特定の国に対してパース済みの入力を返すように指定できます。例えば、カナダに対する REST API の例は次のようになります。
注: パース済み住所入力を返すには、データ ヴィンテージは 2014 Q4 以降でなければなりません。また、パース済み住所入力要素はすべての国に対して返されるわけではないことにも注意してください。
パース済み住所入力要素は、.Input の拡張子を持つ名前でラベル付けされた個別のフィールドに返されます。例:
|