World Geocoder (XWG)
このセクションでは、World Geocoder でサポートされているジオコーディング データセット、操作、入力および出力フィールドの情報を示します。
サポートされているデータ セット
次の表に、World Geocoder でサポートされているジオコーディング データセットと使用可能なジオコーディング レベルを示します。
データ セット | 都市セントロイド | 郊外/村セントロイド | 郵便番号セントロイド | ストリートセントロイド | 補間されたストリート住所 | ポイントレベル住所 | POI (ポイント情報) |
---|---|---|---|---|---|---|---|
TomTom、GeoNames、Pitney Bowes World データ | はい | はい | はい | いいえ | いいえ | いいえ | いいえ |
サポートされている操作
- ジオコーディング — 1 つ以上の住所を入力として受け取り、それに対応する緯度/経度座標などの情報を返します。
郵便番号ジオコーディング
- 入力住所に、有効な郵便番号が含まれている。
- データ ソースに、その国の郵便番号情報が含まれている。すべての国に郵便番号データがあるとは限りません。
地理的ジオコーディング
- 入力住所に、正確な地理情報が含まれており、住所コンテンツとして有効な郵便番号は含まれていない。対象の住所に有効な郵便番号が含まれている場合、World Geocoder は、郵便番号ジオコーディングを試みます。
- データ ソースに、その国の地理的レベルの情報が含まれている。地理情報は、任意のデータ ソース (TomTom、GeoNames、または Pitney Bowes) から取得できます。
国の対象範囲
World Geocoder は、世界中のほとんどすべての国を対象範囲としています。対象範囲の精度とスコープは、提供されているデータ ソースの品質に依存します。郵便番号データを含む国もあれば、地理的対象範囲のみを含む国もあります。国別の地理的対象範囲の全一覧については、次の表を参照してください。国別の地理的対象範囲の全一覧については、各国の地理的データの対象範囲を参照してください。国別の郵便番号の対象範囲については、各国の郵便データの対象範囲を参照してください。
入力フィールド
入力住所には、次の住所要素の一部またはすべてを含めることができます。
フィールド名 | タイプ | 説明 |
---|---|---|
placeName | String | 入力住所に関連する建物名、場所名、POI (ポイント情報)、会社または企業名を示します。これはオプションです。 注: World Geocoder は、このフィールド内に提供される情報を無視します。
|
mainAddress | String | 単一行入力 — 他の住所フィールドが全く入力されていない場合、mainAddress の内容は単一行入力として処理されます。単一行入力は、複数の入力住所フィールドで構成することができます。これらのフィールドは、その国の通常の住所の順序で入力する必要があります。詳細については、以下の「単一行入力」セクションを参照してください。 ストリート住所 — 郵便住所の一部 (都市、郵便番号など) が分けて入力されたり、LastLine フィールドに入力されたりする場合、mainAddress の内容がストリート住所の部分として処理され、会社名、家番号、建物名、ストリート名などを含めることができます。これはオプションです。 交差点の入力—交差点を入力するには、2 個のアンパサンド (&&) で区切られた 2 つのストリート名を指定します。 注: World Geocoder は、このフィールド内に提供される情報を無視します。
|
lastLine | String | 住所の最終行。これはオプションです。例: 2 Manchester Rd |
areaName1 | String |
国により、次のいずれかの名前。
|
areaName2 | String |
国により、次のいずれかの名前。
|
areaName3 | String | 都市または町の名前を指定します。入力住所には正式な都市名を使用してください。最適なジオコーディング結果が得られます。 タイの住所では、このフィールドに従属する地区 (タムボン) が格納されます。 |
areaName4 | String |
国により、次のいずれかの名前。
|
postalCode | String | 各国の標準フォーマットで表記された郵便番号。 |
country | String | 3 文字の ISO 3166-1 Alpha-3 国コード。World Geocoder の場合、国コードは XWG です。フォワード ジオコーディングに必須です。 |
World Geocoder の住所ガイドライン
最適なマッチングとジオコーディング結果が得られるように、次の推奨事項に従って、入力ストリート データをできる限り最良のフォーマットにしてください。
- 住所のエイリアス — 一部の国では、行政上の名称が複数存在します。例えば、都市や町には正式名称がありますが、その他に、同じ都市や町に対して、一般的に使用されているものの正式ではない別名が存在する場合があります。ソース データにエイリアス情報が存在する場合、World Geocoder では、データベースにこのエイリアスを含めます。これにより、World Geocoder は、入力住所に別名が使用されている場合に正しくジオコーディングすることができます。
- 言語のエイリアス — 一部の国では、複数の言語が正式に、または一般的に使用されています。例えば、同じ町に対し、ドイツ語の名前とイタリア語の名前がどちらも一般的に知られている場合があります。ソース データに言語のエイリアス情報が存在する場合、World Geocoder は、データベース内でこの情報を使用します。これにより、World Geocoder は、入力住所に別の言語による名前が使用されている場合に正しくジオコーディングすることができます。
- 州または省の略語 — 一部の国では、州または省が住所の重要な部分であり、この住所要素が省略形で示される場合がよくあります。特定の国については、こうした州/省の略語が World Geocoder によって認識されます。例えば、米国には各州を表す 2 文字の略語が存在します (カリフォルニア州に対する CA など)。同様に、オランダでは、州の略語 (ヘルデルラント州に対する GLD など) が認められています。
World Geocoder は、以下の国について州/省の略語を認識します。
- オーストラリア (AUS)
- カナダ (CAN)
- イタリア (ITA)
- メキシコ (MEX)
- オランダ (NLD)
- 米国 (USA)
単一行入力
各住所コンポーネントを個別のフィールドに入力する代わりに、各住所要素をその国の一般的な順序で並べた住所全体を mainAddress 入力フィールドに入力できます。以下に、一般的な住所要素の順序の例をいくつか示します。
[address_number][street_info][postal_code][area]
[address_number][street_info][area][postal_code]
[street_info][address_number][area][postal_code]
[street_info][address_number][postal_code][area]
[street_info][address_number][area]
[address_number][street_info][area]
- [street_info] は、ストリート名、ストリート タイプ、何らかの前置または後置方位記号 (例: East、West など) の情報で構成されます。これはオプションです。
- [address_number] は省略可能です。
- [area] は、都市のみ、または都市に補足情報 (州、省、地方など) を加えたものです。
- [postal_code] は郵便番号です。
- [area] または [postal_code] が必須です。
カスタム オプション
XWG ジオコーダにカスタム オプションはありません。
パース済み住所 出力フィールド
次の表に、World Geocoder で位置が特定された候補について返されるパース済み住所フィールドの一覧を示します。
- [パース済み住所] フィールドを返す場合: [Country Filters (国フィルタ)] ドロップダウン メニューで [グローバル デフォルト] を選択します。次に、[Return Values (戻り値)] タブで、[パース済み住所] を選択します。
- すべての出力フィールドを返す場合: [Country Filters (国フィルタ)] ドロップダウン メニューで [グローバル デフォルト] を選択します。次に、[Return Values (戻り値)] タブで、[すべての使用可能な情報を返す] を選択します。
フィールド名 | 説明 |
---|---|
mainAddressLine | ストリート住所。会社名、家番号、建物名、ストリート名を含めることができます。 |
addressLastLine | 住所の最終行。 |
placeName | 住所に関連する建物名、場所名、POI (ポイント情報)、会社または企業名。 |
areaName1 |
意味は、次のように国によって異なります。
|
areaName2 |
このフィールドには、州/省より小さく都市より大きいエリアが含まれます。特定のエリアは国によって異なります。
|
areaName3 | 都市または町。 |
areaName4 | 意味は、次のように国によって異なります。
|
postCode1 | 住所の郵便番号。郵便番号のフォーマットは国によって異なります。 |
postCode2 | 拡張郵便番号 (その国に適用可能な場合) |
country | 3 文字の ISO 3166-1 Alpha-3 国コード。World Geocoder の場合、国コードは XWG です。 |
addressNumber | 住所番号。 |
streetName | ストリートまたは道路の名前。 |
unitType | ユニット タイプ (APT、STE など)。 |
unitValue | ユニットの値/番号。"3B" など。 |
customFields | World Geocoder のカスタム出力フィールドの一覧は、次のセクションにあります。 |
カスタム出力フィールド
以下の表に、XWG ジオコーダのみで使われる出力フィールドを示します。
- これらのカスタム出力フィールドのうち 1 つ以上を返すには、Management Console で [国フィルタ] ドロップダウン メニューを使用して [World Geocoder XWG] を選択します。続いて [戻り値] タブで、必要な出力フィールドを選択します。
- すべてのカスタム出力フィールドを返すには、Management Console で [国フィルタ] ドロップダウン メニューを使用して [World Geocoder XWG] を選択します。続いて [戻り値] タブで、[すべての使用可能な情報を返す] チェック ボックスをオンにします。
名前 | 説明 |
---|---|
都市ランク | このオプションは、1 (最高) から 10 (最低) までの都市ランクを返します。ゼロ (0) はランクが使用できないことを意味します。 |