マップを設定する

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 Map:
> StreetsMap

マップアクセス権限

次に、マップリソースのアクセス権限を設定し、ユーザーにマップをレンダリングする権限を付与します。 個々のユーザーの認証ステータスに基づいて権限をスコープできます。

? Who can access this Map?
❯ Authorized users only
  Authorized and Guest users

認証されたユーザーのみがマップをレンダリングできる場合は、Authorized users onlyを選択します。

認証されたユーザーと認証されていないユーザーの両方がマップをレンダリングできる場合は、Authorized and Guest usersを選択します。

詳細については、リンク（ロケーションサービスページ）を参照してください。

マップ料金プラン

マップの料金プランはRequestBasedUsageに設定されます。 料金プランの詳細を確認するために、ロケーションサービスの料金およびロケーションサービスの利用規約（セクション82.5）を確認することをお勧めします。

マップ料金プランをRequestBasedUsageに更新する

プロジェクト内のamplify/backend/amplify-meta.jsonにあるプロジェクトメタデータファイルのgeo/<mapID>/pricingPlan属性からマップの料金プランを確認できます。

"geo": {
    "StreetsMap": {
      "isDefault": true,
      "providerPlugin": "awscloudformation",
      "service": "Map",
      "mapStyle": "VectorEsriStreets",
      "pricingPlan": "MobileAssetManagement",
      "accessType": "AuthorizedUsers"
    }
}

Amplify CLIのバージョンはamplify -vで確認できます。

詳細設定

必要に応じて、マップのスタイルとデータプロバイダーを設定できます。

マップスタイル＆マップデータプロバイダー

マップリソースのスタイルを選択できます。利用可能なマップスタイルと地理空間データのデータプロバイダーが表示されます。これらの各マップスタイルの詳細については、ロケーションサービスのドキュメントを参照してください。

? Specify the map style:
❯ Streets (data provided by Esri)
  Berlin (data provided by HERE)
  Explore (data provided by HERE)
  ExploreTruck (data provided by HERE)
  RasterSatellite (data provided by HERE)
  HybridSatellite (data provided by HERE)
  Topographic (data provided by Esri)
  Navigation (data provided by Esri)
  LightGrayCanvas (data provided by Esri)
  DarkGrayCanvas (data provided by Esri)
  Imagery (data provided by Esri)
  StandardLight (data provided by OpenStreetMap)

このプロパティを明示的に設定したくない場合、Streets (data provided by Esri) がマップスタイルを設定するためのデフォルトオプションになります。

デフォルトマップを設定する

amplify add geoを通じて複数のマップを追加した場合、最後に追加されたマップがデフォルトになります。 ただし、現在のマップをアプリケーションのデフォルトにするかどうかを選択できます。

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

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

完了です。これでアプリケーションでマップをレンダリングできます。こちらに記載されているマップの操作に関するドキュメントに従ってください。