翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
Amazon Location Service でのプレイス検索について説明します。
Amazon Location Service の主な機能は、地理位置情報を検索する機能です。Amazon Location は、プレースインデックスリソースを通じてこの機能を提供します。
注記
プレースインデックスリソースを使用して実際に検索する方法の詳細については、「Amazon Location を使用して場所と位置情報を検索する」を参照してください。
プレースインデックスを使用してAPIs、以下を検索できます。
-
レストランやランドマークなど、興味のあるポイント。名前で検索したり、検索したい場所を指定したりすると、関連性の高い順に並んだオプションのリストが表示されます。
-
住所。その住所の緯度と経度が表示されます。これはジオコーディングと呼ばれます。
-
緯度と経度の位置で、関連する住所やその場所に関するその他の情報を受け取ります。これはリバースジオコーディングと呼ばれます。
-
部分的またはスペルが間違っている自由形式のテキストクエリ (通常はユーザーが入力したもの)。これはオートコンプリート、オートサジェスト、またはファジーマッチングと呼ばれます。
Place Index には、検索に使用するデータプロバイダーが含まれます。
注記
地図データやその他の位置情報 (正確な位置情報を含む) は、データプロバイダーによって異なる場合があります。ベストプラクティスとして、Place Index、マップ、その他の Amazon Location リソースには同じデータプロバイダを使用してください。例えば、Place Index によって返される場所が、マップリソースによって提供される同じ場所の位置と一致しない場合、マップ上の間違った場所と思われる場所にマーカーを配置できます。
以下は、プレースインデックスリソースを作成および使用する方法です。
-
まず、データプロバイダーを選択して AWS 、アカウントにプレイスインデックスリソースを作成します。
-
その後、開発環境とアプリケーションSDKに一致する を選択してインストールできます。使用可能なオプションの詳細については、Amazon Location へのアクセスに関するトピックを参照してください。
-
Amazon Location Places APIs の使用を開始します。詳細については、場所検索の使用に関するトピックを参照してください。
-
その後、Amazon CloudWatch や などのサービスを使用してモニタリングを統合できます AWS CloudTrail。詳細については、「Amazon Location Service を Amazon でモニタリングする CloudWatch」および「によるログ記録とモニタリング AWS CloudTrail」を参照してください。
ジオコーディングの概念
Amazon Location Place Index には、SearchPlaceIndexForText
検索するテキストを指定できるアクションがあります。例えば、次のように検索できます。
-
場所 —
Paris
を検索すると、フランスの都市の位置が返される場合があります。 -
企業 —
coffee shop
を検索すると、名前や所在地を含むコーヒーショップのリストが返される場合があります。検索する場所や境界ボックスを指定して、結果をより関連性の高いものにすることもできます。この場合、ワシントン州シアトルのダウンタウンに店舗を指定すると、その地域のコーヒーショップが返されます。 -
住所 —
1600 Pennsylvania Ave, Washington D.C.
を検索すると、米国のホワイトハウス (その住所) の場所が返されます。
この方法でテキストを検索することを一般に「ジオコーディング」と呼び、住所または場所の地理的位置を検索します。
Amazon Location Service には、SearchPlaceIndexForPosition
という リバースジオコーディング アクションも用意されています。これは地理的位置を取得し、住所、勤務先、またはその場所にあるものに関するその他の情報を返します。
検索結果
Amazon Location Service で検索リクエストが成功すると、1 つ以上の結果が返されます。各結果には、結果の名前または説明であるラベルが含まれます。例えば、coffee shop
を検索すると、「Hometown Cafe」というコーヒーショップが見つかったというラベル Hometown Cafe
の付いた結果が返される場合があります。検索結果には通常、構造化された住所 (住所番号、ユニット、番地、郵便番号などのプロパティを含む) も含まれます。データプロバイダーによっては、国やタイムゾーンなどの他のメタデータも含まれる場合があります。
会社名やカテゴリ (coffee
shop
など) で検索する場合、返されたすべての結果を地図上に表示したい場合があります。住所検索では、最初の結果だけを自動的に使用したい場合があります。関連性については、次のトピックを参照してください。
複数の結果と関連性
テキストで検索する場合、Amazon Location Service は複数の結果を見つけることがよくあります。例えば、Paris
を検索すると、フランスの都市だけでなく、テキサス州の都市も返される場合があります。結果は、データプロバイダーによって決定された関連性で並び替えられます。
注記
結果は、すべてのプロバイダーから関連性の高い順に返されます。データプロバイダーとして Esri または Grab を選択した場合、結果には関連性の値が含まれます。これを使用して 1 つのリクエストの結果間の相対的な関連性を把握できます。
国名や検索する場所などの追加情報を指定すると、結果の順序が変わったり、結果の数が減ったり、返される結果セットが変更されたりする可能性があります。例えば、テキサスの場所を指定して Paris
を検索すると、Paris,
Texas
よりも Paris,
France
が最初の結果として返される可能性が高くなります。
インタラクティブなアプリケーションでは、関連性を利用して上位の結果を受け入れるかどうかを決定したり、返された複数の結果を区別するようユーザーに求めたりできます。最初の結果の関連性が高い場合は、それを正解として受け入れるだけでもかまいません。関連性の高い結果が複数ある場合や、関連性の高い結果がない場合は、結果を一覧表示して、ユーザーが最適な結果を選択できるようにするとよいでしょう。
結果に対処する
同じ SearchPlaceIndexForText
アクションを使用して Amazon Location Service で住所を検索できます。入力する情報が多いほど、返される住所は指定した住所と一致する可能性が高くなります。例えば、123 Main St
は、123 Main St, Anytown, California, 90210
より正しい結果が見つかる可能性は低くなります。
住所には、番地、通り、都市、地域、郵便番号などの複数の属性があります。これらの属性を使用して、できるだけ多くの要素に一致する住所を Place Index から検索します。見つかる属性が多いほど、その一致の関連性が高いと見なされ、返される可能性が高くなります。
注記
住所結果との関連性は、結果が入力とどの程度一致するかによって決まります。これは、一致した属性の数だけでなく、結果が入力とどの程度一致するかによっても異なります。例えば、123 Main
St
という入力は、Maine St
が唯一の結果である場合よりも、データ内に Main St
が見つかった場合の関連性が高くなります。 Maine St
は引き続き返されますが、関連性の値が低くなる可能性があります。
検索結果には、住所全体のラベル (123 Main St,
Anytown, California, 90210
) だけでなく、返された住所の個々の構造化属性も含まれます。これは、例えばデータベースの住所フィールドに値を入力したり、結果を調べて見つかった場所の都市、地域、または郵便番号を検索したりできるので便利です。
Interpolation
Place Index データ内の住所には、完全に一致する住所が含まれています。例えば、次の図に示すように、通り 9th street
があり、1 つのブロックに 2 つの家 220
と 240
があるとします。
データプロバイダーは、これら 2 つの既知の住所を使用して位置情報データを作成します。この 2 つの住所を検索すると、見つかります。データプロバイダーが地図データを作成した後に、最初の 2 つの住所の間に新しい家が追加されたとしましょう。この新しい家には住所 230
が割り当てられます。230 S 9th St
を検索しても、データプロバイダーは引き続き結果を見つけます。既知の住所を使用する代わりに、既知の住所を補間し、それらの住所から新しい住所の位置を推定します。この場合、230 は 220 と 240 の中間 (通りの同じ側) にあると仮定し、それに基づいておおよその位置を返します。
注記
データプロバイダーは、位置情報データを定期的に新しい住所で更新します。この場合、230 S 9th St
はデータプロバイダーデータに追加されますが、通常、新しい住所が作成されたが、まだデータに追加されていない期間があります。
この場合、データプロバイダーは、新しい住所がまだデータに含まれていないため、その新しい住所が世界中に存在するかどうかはわかりませんが、保有している情報からできる限り最善の回答を提供します。この結果は補間と呼ばれ、データプロバイダーが結果で返すことができます。interpolated
が false
を返した場合、それは既知のアドレスです。true
が返された場合、おおよその住所です。返されない場合、データプロバイダーは結果が補間によるものかどうかについての情報を提供していないことになります。
重要
データプロバイダーは、まったく存在しない住所の補間結果を返すこともあります。例えば、ユーザーが 232 S 9th
St
を入力すると、プロバイダーは存在しない住所を検索し、230 に近い 240 側の位置を返します。補間された住所は正しい場所にたどり着くのに役立ちますが、既知の住所ではないことを覚えておくとよいでしょう。
ジオコード結果の保存
プレイスインデックスリソースを作成するときは、データストレージオプション ( IntendedUse
で呼び出されますAPI) を指定する必要があります。これは、単独使用 または 保存結果のいずれかに設定できます。これは結果の使用目的について尋ねています。結果を (キャッシュ目的であっても) 保存する場合は、単独使用 オプションではなく、保存オプションを選択する必要があります。
注記
保存済みオプション (はいとラベル付け、結果はコンソールに保存されるか、 storage
で選択API) を選択した場合、Amazon Location Service CreatePlaceIndex
は結果を保存しません。これは、結果を保存する予定であることを示しています。
Amazon Location Service へのクエリ結果をどのように使用するかを検討する際には、適用される AWS サービス条件
場所の用語
- プレースインデックスリソース
-
検索クエリをサポートするデータソースを選択できます。例えば、対象とする地点、住所、または座標を検索できます。検索クエリがプレースインデックスリソースに送信されると、リソースの設定済みデータソースを使用して処理されます。
- ジオコーディング
-
ジオコーディングは、テキスト入力を受け取り、それを Place Index で検索して、位置とともに結果を返すプロセスです。
- リバースジオコーディング
-
リバースジオコーディングは、位置を取得し、その位置に関する情報 (その位置の住所、都市、事業所など) を Place Index から返すプロセスです。
- Relevance
-
関連性とは、結果が入力とどの程度一致するかです。これは正確さの尺度ではありません。
- Interpolation
-
補間とは、既知の住所位置をガイドポイントとして使用して、未知の住所を見つけるプロセスです。
- ISO 3166 国コード
-
Amazon Location Service Places は、国際標準化機構 (ISO) 3166
の国コードを使用して、国またはリージョンを参照します。 特定の国またはリージョンのコードを検索するには、ISOオンライン閲覧プラットフォーム
を使用します。