マップを設定する

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 -vを使用してAmplify CLIバージョンを確認できます。

詳細設定

オプションで、マップのスタイルとデータプロバイダーを設定できます。

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

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

? 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に答えると、以前に設定されたデフォルトが保持されます。

これで完了です。アプリケーションでマップをレンダリングできるようになりました。ここにリストされているマップの操作に関するドキュメントに従ってください。