場所検索

Amazon Location Service の主な機能は、地理位置情報を検索する機能です。Amazon Location は、Place Indexリソースを通じてこの機能を提供します。

注記

Place Index を使用して実際に検索する方法の詳細については、「Amazon Location を使用して場所と位置情報を検索する」を参照してください。

Place Index API を使用して以下を検索できます。

• レストランやランドマークなど、興味のあるポイント。名前で検索したり、検索したい場所を指定したりすると、関連性の高い順に並んだオプションのリストが表示されます。

• 住所。その住所の緯度と経度が表示されます。これはジオコーディングと呼ばれます。

• 緯度と経度の位置で、関連する住所やその場所に関するその他の情報を受け取ります。これはリバースジオコーディングと呼ばれます。

• 部分的またはスペルが間違っている自由形式のテキストクエリ (通常はユーザーが入力したもの)。これはオートコンプリート、オートサジェスト、またはファジーマッチングと呼ばれます。

Place Index には、検索に使用するデータプロバイダーが含まれます。

注記

地図データやその他の位置情報 (正確な位置情報を含む) は、データプロバイダーによって異なる場合があります。ベストプラクティスとして、Place Index、マップ、その他の Amazon Location リソースには同じデータプロバイダを使用してください。たとえば、Place Indexによって返される場所が、マップリソースによって提供される同じ場所の位置と一致しない場合、マップ上の間違った場所と思われる場所にマーカーを配置できます。

以下は、Place Index リソースを作成および使用する方法です。

1. まず、データプロバイダーを選択して、 AWS アカウントに場所インデックスリソースを作成します。

2. その後、開発環境とアプリケーションに合った SDK を選択してインストールできます。使用可能なオプションの詳細については、Amazon Location へのアクセスに関するトピックを参照してください。

3. Amazon Location Places API を使い始めましょう。詳細については、場所検索の使用に関するトピックを参照してください。

4. その後、Amazon CloudWatch や などのサービスを使用してモニタリングを統合できます AWS CloudTrail。詳細については、「Amazon による Amazon Location Service のモニタリング CloudWatch」および「 でのログ記録とモニタリング」を参照してください。

ジオコーディングの概念

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 側の位置を返します。補間された住所は正しい場所にたどり着くのに役立ちますが、既知の住所ではないことを覚えておくとよいでしょう。

ジオコード結果の保存

Place Index リソースを作成するときは、データストレージオプション (API で IntendedUse と呼ばれる) を指定する必要があります。これは、単独使用 または 保存結果のいずれかに設定できます。これは結果の使用目的について尋ねています。結果を (キャッシュ目的であっても) 保存する場合は、単独使用 オプションではなく、保存オプションを選択する必要があります。

注記

保存オプション（「はい」のラベルが付いている場合、結果はコンソールに保存されるか、または CreatePlaceIndex API storage で選択）を選択した場合、Amazon Location Service は結果を自動的に保存しません。これは、結果を保存する予定であることを示しています。

Amazon Location Service へのクエリ結果をどのように使用するかを検討する際には、適用される AWS サービス条件 を常に把握しておく必要があります。

場所の用語

Place Index リソース

検索クエリをサポートするデータソースを選択できます。たとえば、対象とする地点、住所、または座標を検索できます。検索クエリが Place Index リソースに送信されると、リソースの設定済みデータソースを使用して処理されます。

ジオコーディング

ジオコーディングは、テキスト入力を受け取り、それを Place Index で検索して、位置とともに結果を返すプロセスです。

リバースジオコーディング

リバースジオコーディングは、位置を取得し、その位置に関する情報 (その位置の住所、都市、事業所など) を Place Index から返すプロセスです。

Relevance

関連性とは、結果が入力とどの程度一致するかです。これは正確さの尺度ではありません。

Interpolation

補間とは、既知の住所位置をガイドポイントとして使用して、未知の住所を見つけるプロセスです。

ISO 3166 国コード

Amazon Location Service Places では、国際標準化機構 (ISO) 3166 国コードを使用して国または地域を参照します。

特定の国または地域のコードを検索するには、ISO Online Browsing Platform を使用してください。