位置情報検索を設定する

Amplifyのgeoカテゴリを使用すると、「プレイスインデックス」リソースを使用してアプリケーション内で場所、住所、座標で検索できます。

新しい位置情報検索インデックスをセットアップする

プロジェクトのルートフォルダから以下のコマンドを実行して、新しい位置情報検索インデックスを追加できます:

amplify add geo

? Select which capability you want to add:
  Map (visualize the geospatial data)
> Location search (search by places, addresses, coordinates)

authカテゴリをまだセットアップしていない場合、Amplify CLIはauthカテゴリを有効にするようガイドします。 authカテゴリはアプリケーションで必須です。これにより、以下で説明するように、認証済みユーザーおよび/またはゲストユーザーが場所を検索するための適切な権限が付与されます。

次に、位置情報検索インデックスの名前を設定します:

? Provide a name for the location search index (place index):
> MyPlaceIndex

位置情報検索アクセス権限

次に、位置情報検索インデックスのアクセス権限を設定し、ユーザーが場所を検索することを許可します。個々のユーザーの認証ステータスに基づいて権限をスコープできます。

? Who can access this Search Index?
❯ Authorized users only
  Authorized and Guest users

認証されたユーザーのみが場所を検索できる場合は、Authorized users onlyを選択します。

認証済みおよび未認証のユーザーの両方が場所を検索できる場合は、Authorized and Guest usersを選択します。

詳細については、このリンクを参照してください。

位置情報検索インデックス価格プラン

検索インデックスの価格プランはRequestBasedUsageに設定されます。 価格プランの詳細については、ロケーションサービス価格およびロケーションサービス利用規約（82.5節）を確認することをお勧めします。

位置情報検索インデックス価格プランをRequestBasedUsageに更新する

プロジェクトメタデータファイル(amplify/backend/amplify-meta.json)のgeo/<searchIndexID>/pricingPlan属性から、検索インデックスの価格プランを確認できます。

"geo": {
    "MyPlaceIndex": {
      "isDefault": true,
      "providerPlugin": "awscloudformation",
      "service": "PlaceIndex",
      "dataProvider": "Esri",
      "dataSourceIntendedUse": "SingleUse",
      "pricingPlan": "MobileAssetManagement",
      "accessType": "AuthorizedUsers"
    }
}

amplify -vを使用してAmplify CLIバージョンを確認できます。

詳細設定

オプションで、位置情報検索インデックスのデータプロバイダーと結果ストレージの場所を設定できます。

位置情報検索データプロバイダー

ジオコーディング、逆ジオコーディング、検索のソースとしてデータプロバイダーを選択できます。 各プロバイダーは異なる手段を使用してデータを収集およびキュレーションしています。世界のさまざまな地域で異なる専門知識を持つこともあります。 利用可能な地理空間データのデータプロバイダーが表示されます。データプロバイダーの詳細については、ロケーションサービスドキュメントを参照してください。

? Specify the data provider of geospatial data for this Search Index:
  Esri
❯ HERE

このプロパティを明示的に設定しない場合、HEREは位置情報検索インデックスのデフォルトデータプロバイダーとして設定されます。

位置情報検索結果ストレージの場所

検索操作の結果がどのように保存されるかを指定できます。

? Do you want to cache or store the results of search operations?
> No

開発者がこのプロパティを明示的に設定したくない場合、Noがデフォルトとして選択されます。

詳細については、このロケーションサービスドキュメントを参照してください。

デフォルト位置情報検索インデックスを設定する

amplify add geo経由で複数の位置情報検索インデックスを追加した場合、最後に追加されたインデックスがデフォルトになります。 ただし、現在の検索インデックスをアプリケーションで使用されるデフォルトとするかどうかを選択できます:

Set this search index as the default? It will be used in Amplify Search API calls if no explicit reference is provided.
> No

Noと答えると、以前に設定されたデフォルトが保持されます。

以上です。これでアプリケーションで検索できます。検索の使用に関するドキュメントは、こちらに記載されています。