World Geocoder (XWG)

このセクションでは、World Geocoder でサポートされているジオコーディング データセット、操作、入力および出力フィールドの情報を示します。

サポートされているデータ セット

次の表に、World Geocoder でサポートされているジオコーディング データセットと使用可能なジオコーディング レベルを示します。

注: カスタム ユーザ辞書はサポートされていません。
データ セット 都市セントロイド 郊外/村セントロイド 郵便番号セントロイド ストリートセントロイド 補間されたストリート住所 ポイントレベル住所 POI (ポイント情報)
TomTom、GeoNames、Pitney Bowes World データ はい はい はい いいえ いいえ いいえ いいえ

サポートされている操作

World Geocoder では、以下の操作がサポートされています。
  • ジオコーディング — 1 つ以上の住所を入力として受け取り、それに対応する緯度/経度座標などの情報を返します。

郵便番号ジオコーディング

World Geocoder は、郵便番号情報がその国から提供されている場合、郵便セントロイドへのジオコーディングを行うことができます。郵便番号情報は、任意のデータ ソース (TomTom、GeoNames、または Pitney Bowes) から取得できます。郵便データの対象範囲の概要については、各国の郵便データの対象範囲を参照してください。国によっては、郵便番号ジオコーディングの方が、地理的ジオコーディングよりも正確な結果を生成する場合があります。郵便番号レベルのジオコーディングは、以下の条件が満たされる場合に可能です。
  • 入力住所に、有効な郵便番号が含まれている。
  • データ ソースに、その国の郵便番号情報が含まれている。すべての国に郵便番号データがあるとは限りません。

地理的ジオコーディング

World Geocoder は、行政区分 (町や村など) のセントロイドへのジオコーディングを行うことができます。World Geocoder は、以下の条件が満たされる場合、地理的レベルのジオコーディングが可能です。
  • 入力住所に、正確な地理情報が含まれており、住所コンテンツとして有効な郵便番号は含まれていない。対象の住所に有効な郵便番号が含まれている場合、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
Harare
areaName1 String

国により、次のいずれかの名前。

  • 使用しない — BEL、CHE、DNK、IRL、LIE、LUX、NLD、NOR、SGP
  • 連邦州 (Bundesland) — DEU
  • 州 (Province) — CAN
  • 県 (Province) (changwat) — THA
  • 県 (Province) (voivodship) — POL
  • 地域 (Region) — AUT、ESP、FRA、GBR、NZL、PRT
  • 地域 (Region) (län) — FIN
  • 地域 (Region) (lan) — SWE
  • 州 (State) — AUS、BRA
  • 州 (State) (negeri) — MYS
areaName2 String

国により、次のいずれかの名前。

  • 使用しない — AUT、BRA、CAN、FIN、GBR、MYS、PRT、SGP
  • 郡 (Department) — FRA
  • 地区 (District) (amphoe) — THA
  • 郡 (District) (fylke/counties) — NOR
  • 地区 (District) (poviat) — POL
  • コミューン (Kommun) — SWE
  • 郡 (Kreis) — DEU
  • 地方自治体 (Local Government Authority: LGA) — AUS
  • 州 (Province) — BEL、CHE、DNK、ESP、IRL、ITA、LIE、LUX、NLD
  • 地方行政区画 (Region) — NZL
areaName3 String 都市または町の名前を指定します。入力住所には正式な都市名を使用してください。最適なジオコーディング結果が得られます。

タイの住所では、このフィールドに従属する地区 (タムボン) が格納されます。
areaName4 String

国により、次のいずれかの名前。

  • 使用しない — AUS、AUT、BEL、CHE、DEU、DNK、FIN、FRA、IRL、LIE、LUX、MYS、NLD、NOR、POL、SGP、SWE、THA
  • 散布エリア (DA) および列挙エリア (EA) — CAN
  • 地方 (Locality) — BRA、GBR、ITA、PRT
  • 郊外 (Suburb) — NZL
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 で位置が特定された候補について返される住所フィールドの一覧を示します。

注: placeName、addressNumber、unitType および unitValue フィールド値は、ストリート住所の補間をサポートしているジオコーディング データセットがインストールされている場合にのみ返されます。
フィールド名 説明
mainAddressLine ストリート住所。会社名、家番号、建物名、ストリート名を含めることができます。
addressLastLine 住所の最終行。
placeName 住所に関連する建物名、場所名、POI (ポイント情報)、会社または企業名。
areaName1

意味は、次のように国によって異なります。

  • AUS — 州 (State)
  • AUT — 地域 (Region)
  • BEL — 使用せず
  • BRA — 州 (State)
  • CAD — 州 (Province)
  • CHE — 州 (State)
  • DEU — 連邦州 (Bundesland)
  • DNK — 使用せず
  • ESP — 地域 (Region)
  • FIN — 地域 (Region) (län)
  • FRA — 地域 (Region)
  • GBR — 地域 (Region)
  • IRL — 使用せず
  • ITA — 地域 (Region)
  • LIE — 州 (State)
  • LUX — 使用せず
  • MYS — 州 (State) (negeri)
  • NLD — 使用せず
  • NOR — 使用せず
  • NZL — 地域 (Region)
  • POL — 県 (Province) (voivodship)
  • PRT — 地域 (Region)
  • SGP — 使用せず
  • SWE — 地域 (Region) (lan)
  • THA — 県 (Province) (changwat)
areaName2

このフィールドには、州/省より小さく都市より大きいエリアが含まれます。特定のエリアは国によって異なります。

  • AUS — 地方自治体 (Local Government Authority: LGA)
  • AUT — 州 (Province)
  • BEL — 州 (Province)
  • BHS — 使用せず
  • BRA — 使用せず
  • CAN — 使用せず
  • CHE — 州 (Province)
  • DEU — 郡 (Kreis)
  • DNK — 州 (Province)
  • FIN — 州 (Province) (kommune)
  • FRA — 郡 (Department)
  • GBR — 郡 (County)
  • ITA — 州 (Province)
  • LIE — 州 (Province)
  • LUX — 州 (Province)
  • MYS — 地区 (District) (daerah)
  • NLD — 州 (Province)
  • NZL — 使用せず
  • POL — 地区 (District) (poviat)
  • PRT — 使用せず
  • SGP — 地区 (District)
  • SWE — 地域 (Region) (kommun)
  • THA — 地区 (District) (amphoe)
areaName3 都市または町。
areaName4 意味は、次のように国によって異なります。
  • 使用しない — AUS、AUT、BEL、CHE、DEU、DNK、FIN、FRA、IRL、LIE、LUX、MYS、NLD、NOR、POL、SGP、SWE、THA
  • 散布エリア (DA) および列挙エリア (EA) — CAN
  • 地方 (Locality) — BRA、GBR、ITA、PRT
  • 郊外 (Suburb) — NZL
postCode1 住所の郵便番号。郵便番号のフォーマットは国によって異なります。
postCode2 拡張郵便番号 (その国に適用可能な場合)
country 3 文字の ISO 3166-1 Alpha-3 国コード。World Geocoder の場合、国コードは XWG です。
addressNumber 住所番号。
streetName ストリートまたは道路の名前。
unitType ユニット タイプ (APT、STE など)。
unitValue ユニットの値/番号。"3B" など。
customFields World Geocoder のカスタム出力フィールドの一覧は、次のセクションにあります。

カスタム出力フィールド

以下の表に、XWG ジオコーダのみで使われる出力フィールドを示します。

名前 説明
CITYRANK このオプションは、1 (最高) から 10 (最低) までの都市ランクを返します。ゼロ (0) はランクが使用できないことを意味します。