代替ジオコーディング
代替ジオコーディング オプションにより、ジオコーダは住所レベルのジオコードを決定できない場合により精度の低いジオコードを返そうとすることができます。
次の代替ジオコーディング オプションがあります。
- 郵便番号にフォールバック - 郵便番号セントロイドを返すことを試みます。
- 地理的なエリアにフォールバック - 地理的エリアのセントロイドを返すことを試みます。
国ジオコーダがインストールされていないか、国ジオコーダは使用できるがジオコーディング データセットがインストールされていない場合に、以下のように追加の代替ジオコーディング オプションを実装できます。
- ///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 リクエストを参照してください。