代替ジオコーディング

代替ジオコーディングオプションにより、ジオコーダは住所レベルのジオコードを決定できない場合により精度の低いジオコードを返そうとすることができます。

次の代替ジオコーディングオプションがあります。

郵便番号にフォールバック - 郵便番号セントロイドを返すことを試みます。
地理的なエリアにフォールバック - 地理的エリアのセントロイドを返すことを試みます。

国ジオコーダがインストールされていないか、国ジオコーダは使用できるがジオコーディングデータセットがインストールされていない場合に、以下のように追加の代替ジオコーディングオプションを実装できます。

///Fallback to World///(World にフォールバック) - World Geocoder (XWG) を使用してジオコードを返すことを試みます。World Geocoder (XWG) は、XWG ジオコーディングデータセットのサポートレベルによって、郵便番号ジオコードまたは地理的ジオコードを返します。World Geocoder (XWG) はインストールに含まれています。この機能を実装するには、World Geocoder ジオコーディングデータセットをインストールする必要があります。以下の例では、World Geocoder ジオコーディングデータセットがインストールされている場合とされていない場合に、この機能を有効にした際の反応を示します。
シナリオ 1: World Geocoder (XWG) がデータなしでインストールされている場合
- FALLBACK_TO_WORLD = false– データがインストールされていない国に対してジオコーディングを試みると、例外 Error initializing data manager. が返されます。
- FALLBACK_TO_WORLD = true– World Geocoder (XWG) データがインストールされていない場合は、例外 Error initializing data manager. が返されます。
シナリオ 2: World Geocoder (XWG) がデータとともにインストールされている場合
- FALLBACK_TO_WORLD = false– 例外 Error initializing data manager. が返されます。
- FALLBACK_TO_WORLD = true– フォールバックが実行された場合に、可能であれば結果が返されます。

郵便番号にフォールバック

以下の表に、郵便ジオコーディングによる代替機能の実装方法に関する情報を示します。

REST API	機能の実装
サービス:	Geocode
リクエストの種類:	GET
パラメータ:	fallbackPostal = true
リクエストの種類:	POST
オブジェクト: 要素	preferences : fallbackToPostal = true

詳細については、Geocode GET リクエストおよびGeocode POST リクエストを参照してください。

地理的なエリアにフォールバック

以下の表に、地理的ジオコーディングによる代替機能の実装方法に関する情報を示します。

REST API	機能の実装
サービス:	Geocode
リクエストの種類:	GET
パラメータ:	fallbackGeo = true
リクエストの種類:	POST
オブジェクト: 要素	preferences: fallbackToGeographic = true

詳細については、Geocode GET リクエストおよびGeocode POST リクエストを参照してください。

///Fallback to World///(World にフォールバック)

以下の表に、///Fallback to World///(World にフォールバック) 機能の実装方法に関する情報を示します。

REST API	機能の実装
サービス:	Geocode
リクエストの種類:	POST
オブジェクト: 要素	customPreferences : FALLBACK_TO_WORLD = true

customPreferences オブジェクトは、preferences オブジェクトの中で指定されます。例えば、POST JSONリスエストでは、次のように指定されます。

"preferences" : {
    "customPreferences" : {
        "FALLBACK_TO_WORLD" : "true"
    }
}

POST XMLリスエストでは、次のように指定されます。

<preferences>
  <customPreferences>
    <entry>
      <key>FALLBACK_TO_WORLD</key>
      <value>true</value>
    </entry>
  </customPreferences>
</preferences>

詳細については、Geocode POST リクエストを参照してください。