翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
Amazon Location を使用したジオコーディング
ジオコーディングは、住所、地域、会社名、対象地点などのテキストを一連の地理座標に変換するプロセスです。プレースインデックスリソースを使用してジオコーディングリクエストを送信し、ジオコーディングから取得したデータを組み込んでウェブまたはモバイルアプリケーションのマップ上にデータを表示することができます。
このセクションでは、簡単なジオコーディングリクエストを送信する方法と、オプション仕様でジオコーディングリクエストを送信する方法について説明します。
ジオコーディング
住所を座標セットに変換する SearchPlaceIndexForText オペレーションを使用して、ジオコーディングに簡単なリクエストを送信することができます。単純なリクエストには次の必須パラメータが含まれます。
-
Text— 座標セットに変換する住所、名前、都市、または地域。例えば、文字列Any Town。
1 ページあたりの結果の最大数を指定するには、以下のオプションパラメータを使用します。
-
MaxResults— クエリレスポンスで返される結果の最大数を制限します。
AWS CLI または Amazon Location を使用できますAPIs。
ある位置の近くのジオコード
ジオコーディングでは、以下のオプションパラメータを使用して特定の位置の近くをジオコーディングすることができます。
-
BiasPosition— 付近で検索したい位置。指定した位置に最も近い結果を検索して、検索範囲を絞り込みます。[longitude, latitude]と定義されます
次の例は、プレイスインデックスリソースで というアドレス、名前、都市、またはリージョンを検索するSearchPlaceIndexForTextリクエストです。Any
Town 位置の近く [-123.4567,45.6789].
POST /places/v0/indexes/ExamplePlaceIndex/search/text Content-type: application/json { "Text": "Any Town", "BiasPosition": [-123.4567,45.6789] }
境界ボックス内のジオコーディング
境界ボックス内でジオコーディングすると、次のオプションパラメータを使用して結果を特定の境界内の座標に絞り込むことができます。
-
FilterBBox— 検索結果をボックスの境界内の座標に絞り込むために指定する境界ボックス。[LongitudeSW, LatitudeSW, LongitudeNE, LatitudeNE]と定義されます注記
リクエストは
FilterBBoxとBiasPositionの両方のパラメータを含むことはできません。リクエストで両方のパラメータを指定するとValidationExceptionエラーが返されます。
次の例は、境界ボックス内で という名前の住所、名前、都市、またはリージョンを検索するSearchPlaceIndexForTextリクエストです。Any Town。 境界ボックスは次のようになります。
-
南西隅の経度は です。
-124.1450. -
南西隅の緯度は です。
41.7045. -
北東隅の経度は です。
-124.1387. -
北東隅の緯度は です。
41.7096.
POST /places/v0/indexes/ExamplePlaceIndex/search/text Content-type: application/json { "Text": "Any Town", "FilterBBox": [-124.1450,41.7045,-124.1387,41.7096] }
国内のジオコード
以下のオプションパラメータを使用することで、指定した 1 つまたは複数の国でジオコードを行うことができます。
-
FilterCountries— ジオコーディングする国または地域。ISO 3166 の 3 文字の国コードを使用して、1 つのリクエストで最大 100の国を定義できます。例えば、オーストラリアでは AUSです。
次の例は、 という住所、名前、都市、またはリージョンを検索するSearchPlaceIndexForTextリクエストです。Any Town ドイツとフランス。
POST /places/v0/indexes/ExamplePlaceIndex/search/text Content-type: application/json { "Text": "Any Town", "FilterCountries": ["DEU","FRA"] }
カテゴリによるフィルタリング
以下のオプションのパラメータを使用することで、ジオコードリクエストで返されるカテゴリをフィルタリングすることができます。
-
FilterCategories— クエリで返してほしい結果のカテゴリ。1 つのリクエストで最大 5 つのカテゴリを指定することができます。Amazon Location Service カテゴリのリストは、カテゴリセクションにあります。例えば、Hotelを指定することで、クエリで返されるホテルのみを指定することができます。
次の例は、 という名前のコーヒーショップを検索するSearchPlaceIndexForTextリクエストです。Hometown Coffee 米国で。
POST /places/v0/indexes/ExamplePlaceIndex/search/text Content-type: application/json { "Text": "Hometown Coffee", "FilterCategories": ["Coffee Shop"], "FilterCountries": ["USA"] }
カテゴリに基づくフィルタリングの詳細については、Amazon Location を使用してカテゴリを配置し、結果をフィルタリングする を参照してください
優先言語でのジオコーディング
オプション Language パラメータを使用して、検索結果の言語プリファレンスを設定できます。例えば、100 Main
St, Anytown, USA を検索するとデフォルトで 100 Main St, Any Town,
USA が返されるか可能性があります。ただし、fr として Language を選択した場合、結果は代わりに 100 Rue
Principale, Any Town, États-Unis を返す場合もあります。
-
Language— クエリの結果をレンダリングするために使用する言語コード。値は有効な BCP 47言語コードである必要があります。例えば、英語では enです。
注記
Language が指定されていない場合、または指定された言語が結果でサポートされていない場合、その結果ではパートナーのデフォルト言語が使用されます。
次の例は、優先言語を de に指定して、Any Town という場所を検索する SearchPlaceIndexforText リクエストである。
POST /places/v0/indexes/ExamplePlaceIndex/search/text Content-type: application/json { "Text": "Any Town", "Language": "de" }
レスポンスの例
以下は、Amazon Location Places から SearchPlaceIndexForTextオペレーションを呼び出すときのレスポンスの例ですAPIs。結果には、関連する場所とリクエストの概要が含まれます。Esri または HERE パートナーの選択に基づいて、2 つのレスポンスが表示されます。
