

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# AWS と Amazon Location Service の統合
<a name="integration"></a>

Amazon Location Service は、効率的な認証、モニタリング、管理、開発のためにさまざまな AWS サービスと統合されています。

**モニタリング**  
+ **Amazon CloudWatch** — リクエスト、レイテンシー、障害、ログなど、サービスの使用状況と状態に関するメトリクスを表示します。詳細については、「[Amazon CloudWatch で   を監視する](cloudwatch.md)」を参照してください。
+ **AWS CloudTrail** — ユーザー、ロール、または AWS サービスが実行したアクションを含む API コールをログに記録してモニタリングします。詳細については、「[によるモニタリングとログ記録 AWS CloudTrail](cloudtrail.md)」を参照してください。

**管理**  
+ **AWS CloudFormation** – Amazon Location は、リソースとインフラストラクチャの作成と管理の所要時間を短縮できるように AWS リソースをモデル化して設定するためのサービスである AWS CloudFormation と統合されています。詳細については、「[を使用してリソースを作成する AWS CloudFormation](cloudformation.md)」を参照してください。
+ **Service Quotas** – Service Quotas コンソールと AWS CLI を使用して、調整可能なクォータの変更をリクエストします。詳細については、「[Service Quotas を使用してクォータを管理する](manage-quotas.md)」を参照してください。
+ **タグ** – Amazon Location のリソースタグを使用して、リソースを用途、所有者、環境、基準別に分類するタグを作成します。リソースにタグを付けると、リソースの管理、識別、整理、検索、フィルタリングに役立ちます。詳細については、「[タグでリソースを管理する](manage-resources.md)」を参照してください。

**Authenticate**  
+ **Amazon Cognito** – Amazon Cognito 認証は、フロントエンド SDK とダイレクト HTTPS リクエストの両方で AWS Identity and Access Management (IAM) を直接使用する代わりに使用できます。詳細については、「[Amazon Cognito を使用して認証する](authenticating-using-cognito.md)」を参照してください。
+ **IAM** – AWS Identity and Access Management (IAM) は、管理者が AWS リソースへのアクセスを安全にコントロールするのに役立つ AWS サービスです。IAM 管理者は、誰を認証 (サインイン) し、誰に対して Amazon Location Service リソースの使用を承認 (アクセス許可を付与する) するかを制御します。詳細については、「[を使用して認証 AWS Identity and Access Management する](security-iam.md)」を参照してください。

**追加された値**  
+ **Amazon EventBridge** — イベント駆動型アプリケーションアーキテクチャを有効にして、AWS Lambda 関数を使用してアプリケーションやワークフローの他の部分をアクティブ化できるようにします。詳細については、「[Amazon EventBridge を使用して Amazon Location Service イベントに対応する](location-events.md)」を参照してください。
+ **AWS IoT** – AWS IoT Core ルールエンジンは、デバイスのメッセージトピックに関するクエリを保存し、Amazon Location Service などの他の AWS サービスにメッセージを送信するためのアクションを定義できるようにします。位置を座標として認識するデバイスは、ルールエンジンを通じて Amazon Location に位置情報を転送できます。詳細については、「[Amazon Location Service により AWS IoT と MQTT を使ってトラッキングする](tracking-using-mqtt.md)」を参照してください。

**デベロッパーツール**  
+ **SDK** – Amazon Location Service には、デベロッパーが位置情報対応アプリケーションを構築するためのさまざまなツールが用意されています。これには、標準 AWS SDK、モバイル SDK、ウェブ SDK が含まれます。詳細については、「[Amazon Location Service の SDK とフレームワーク](dev-sdks.md)」を参照してください。
+ **AWS CLI** – AWS Command Line Interface (AWS CLI) は、コマンドラインシェルでコマンドを使用して AWS サービスとやり取りするためのオープンソースツールです。最小限の設定で利用できます。詳細については、「[AWS Command Line Interface](https://docs.aws.amazon.com/cli/latest/reference/location/)」または「[AWS CLI](https://docs.aws.amazon.com/cli/) のドキュメント」を参照してください。
+ **サンプルコード** – サンプルコードは AWS SDK、モバイル SDK およびウェブ SDK、MapLibre を使用して、Amazon Location の使用方法を示します。詳細は、「[サンプル](https://location.aws.com/samples)」を参照してください。
+ **Amazon Location Service コンソール** – Amazon Location Service コンソールから、API、リソース、視覚的でインタラクティブな学習ツールの使用方法について学習できます。詳細は、[Amazon Location Service コンソール](https://console.aws.amazon.com/location/explore/home)を確認してください。

**コストと請求**  
+ **AWS Billing and Cost Management** – このサービスは、請求書の支払いとコストの最適化に役立ちます。Amazon Web Services はアカウントの使用料金を使用された分のみ請求します。詳細については「[料金モデル](pricing.md)」または「[Billing and Cost Management を使用して AWS 請求とコストを管理する](manage-billing.md)」を参照してください。

# リソース管理
<a name="resource-management"></a>

リソース管理は、AWS CloudFormation を使用してクォータの管理、タグを使用したリソースの整理、コストの制御、リソース作成の自動化を行うためのツールとプロセスを提供します。これらの機能により、Amazon Location 内のリソースを効率的に割り当て、モニタリング、管理できます。

これらのツールを使用して、サービス制限の設定、より良い組織のためのリソースのタグ付け、経費のモニタリング、CloudFormation でのコードとしてのインフラストラクチャを使用したリソースのプログラムによる作成と管理を行うことにより、運用効率を維持します。

**Topics**
+ [Service Quotas を使用してクォータを管理する](manage-quotas.md)
+ [タグでリソースを管理する](manage-resources.md)
+ [Billing and Cost Management を使用して AWS 請求とコストを管理する](manage-billing.md)
+ [を使用してリソースを作成する AWS CloudFormation](cloudformation.md)

# Service Quotas を使用してクォータを管理する
<a name="manage-quotas"></a>

Service Quotas コンソールでは、[調整可能なクォータのクォータの増減をリクエスト](https://console.aws.amazon.com/servicequotas/home#!/services/geo/quotas)できます。サービスクォータは、 AWS アカウントと AWS リージョンごとに持つことができる API コールまたはリソースの最大数です。クォータの引き上げをリクエストする場合は、ほとんどのクォータがリージョン固有であるため、クォータの引き上げが必要なリージョンを選択します。Amazon Location Service、Service Quotas を超える追加のリクエストを拒否します。

 レート制限 (Rate of... で始まるクォータ ) は 1 秒あたりの最大リクエスト数で、各 API オペレーションに定義されている 1 秒間の上限の 80% をバーストレートとします。Service Quotas を通じてアカウントのレート制限が引き上げられたオペレーションでは、バーストレートが引き上げられたレート制限の 80% を下回る場合があります。Amazon Location Service、オペレーションのレート制限を超えるリクエストを制限します。

## Amazon Location Service のサービスクォータを管理する
<a name="manage-quotas_how"></a>

 Amazon Location Service は Service Quotas と統合されています。Service Quotas は、クォータを一元的に表示および管理できる AWS サービスです。詳細は、*Service Quotas ユーザーガイド*の「[Service Quotas とは](https://docs.aws.amazon.com/servicequotas/latest/userguide/intro.html)」を参照してください。

 Service Quotas を使用すると、Amazon Location service のサービスクォータの値を簡単に調べることができます。

------
#### [ AWS マネジメントコンソール ]

1. [Service Quotas コンソール](https://console.aws.amazon.com/servicequotas) を開きます。

1. ナビゲーションペインで、**[AWS サービス**] を選択します。

1. **AWS サービス** リストから「**Amazon Location**」を検索して選択します。

1. **サービスクォータ**リストでは、サービスクォータ名、適用された値 (使用可能な場合）、 AWS デフォルトのクォータ、およびクォータ値が調整可能かどうかを確認できます。

1. 説明など、Service Quotas に関する追加情報を表示するには、クォータ名を選択します。

1. (オプション) クォータの引き上げをリクエストするには、**[Request quota increase (クォータ引き上げリクエスト)]** を選択、または必要な情報を入力または選択して、**[Request (リクエスト)]** を選択します。

 コンソールを使用してさらにサービスクォータの操作を行うには、*Service Quotas ユーザーガイド*を参照してください。クォータの引き上げをリクエストするには、「*Service Quotas ユーザーガイド*」の「[クォータ引き上げリクエスト](https://docs.aws.amazon.com/servicequotas/latest/userguide/request-quota-increase.html) を参照してください。

------
#### [ AWS CLI ]

次のコマンドを実行して、デフォルトの Amazon Location のクォータを表示します。

```
aws service-quotas list-aws-default-service-quotas \
    --query 'Quotas[*].{Adjustable:Adjustable,Name:QuotaName,Value:Value,Code:QuotaCode}' \
    --service-code geo \
    --output table
```

を使用してサービスクォータをさらに操作するには AWS CLI、*AWS CLI 「 コマンドリファレンス*」のService Quotas」セクションを参照してください。クォータの引き上げをリクエストするには、*AWS CLI コマンドリファレンス*の「[https://docs.aws.amazon.com/cli/latest/reference/service-quotas/request-service-quota-increase.html](https://docs.aws.amazon.com/cli/latest/reference/service-quotas/request-service-quota-increase.html)」を参照してください。

------

## よくある質問
<a name="manage-quotas_faq"></a>

**Amazon Location Service リソースのデフォルトのクォータは何ですか?**  
Amazon Location Service は API のデフォルトクォータを設定して、サービス容量を管理できるようにします。これは、[AWS Service Quotas 管理コンソール](https://console.aws.amazon.com/servicequotas/home#!/services/geo/quotas)で表示できます。すべてのデフォルトクォータへのリンクは、下の [Amazon Location Service のクォータのモニタリング](#manage-quotas_monitor)セクションにあります。

**Amazon Location Service のクォータの引き上げをリクエストするにはどうすればよいですか?**  
Amazon Location Service のクォータの引き上げをリクエストするには、[セルフサービスコンソール](https://console.aws.amazon.com/servicequotas/home#!/services/geo/quotas)を使用して、各 API のデフォルト制限の最大 2 倍までリクエストできます。デフォルトの制限の 2 倍を超えるクォータ制限については、セルフサービスコンソールでリクエストすると、サポートチケットが送信されます。または、プレミアムサポートチームに連絡します。

**Amazon Location Service のクォータ引き上げのリクエストに関連する追加コストはありますか?**  
クォータ引き上げリクエストには直接料金はかかりませんが、使用レベルが高くなると、消費される追加のリソースに基づいてサービスコストが増加する可能性があります。

## Amazon Location Service のクォータのモニタリング
<a name="manage-quotas_monitor"></a>

 Amazon CloudWatch を使用すると、クォータに対して使用状況をモニタリングできます。詳細については、「[Amazon CloudWatch で   を監視する](cloudwatch.md)」を参照してください。

[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/location/latest/developerguide/manage-quotas.html)

## 詳細情報
<a name="manage-quotas_learn"></a>

 Service Quotas の詳細は、[Service Quotas ドキュメント](https://docs.aws.amazon.com/servicequotas/latest/userguide/intro.html)を参照してください。

# タグでリソースを管理する
<a name="manage-resources"></a>

Amazon Location のリソースタグを使用して、リソースを用途、所有者、環境、基準別に分類するタグを作成します。リソースにタグを付けると、リソースの管理、識別、整理、検索、フィルタリングに役立ちます。たとえば、 AWS Resource Groups では、1 つ以上のタグまたはタグの一部に基づいて AWS リソースのグループを作成できます。 AWS CloudFormation スタックでの出現に基づいてグループを作成することもできます。リソースグループとタグエディタを使用すると、複数のサービス、リソース、リージョンで構成されるアプリケーションのデータを 1 か所にまとめて表示できます。[一般的なタグ付け戦略](https://docs.aws.amazon.com/tag-editor/latest/userguide/best-practices-and-strats.html)の詳細については、「*AWS 全般のリファレンス*」を参照してください。

各タグは、ユーザー自身が定義するキーと値で構成されるラベルです。
+ **タグキー** — タグ値を分類する一般的なラベル。例えば、`CostCenter`。
+ **タグ値** — タグキーカテゴリの説明 (オプション)。例えば、`MobileAssetTrackingResourcesProd`。

このトピックでは、タグ付けの制限を確認できるので、タグの使用を開始する上で役立ちます。また、コスト配分レポートを使用して、タグを作成し、タグを使用してアクティブな各タグ AWS のコストを追跡する方法も示します。

詳細については、以下を参照してください。
+ タグ付けのベストプラクティスについては、*AWS 「 全般のリファレンス*」の「 [AWS リソースのタグ付け](https://docs.aws.amazon.com/tag-editor/latest/userguide/best-practices-and-strats.html)」を参照してください。
+ タグを使用して AWS リソースへのアクセスを制御するには、*AWS 「 Identity and Access Management ユーザーガイド*[」の「タグを使用した AWS リソースへのアクセスの制御](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_tags.html)」を参照してください。

## 制限事項
<a name="manage-resources_restrictions"></a>

**注記**  
既存のタグとタグキーが同じ新しいタグを追加すると、既存のタグは新しいタグで上書きされます。

タグ付けにより、リソースをより効果的に整理し、管理できます。このページでは、Amazon Location Service 内でのタグの使用を規定する具体的なルールと制約について説明します。これらのタグ付けの制限事項を理解することで、位置情報ベースのリソースとアプリケーションのタグ付け戦略を実装する際に、ベストプラクティスに準拠し、潜在的な問題を回避できます。

タグには以下のベーシックな制限があります。
+ リソースあたりのタグの最大数: 50 
+ タグキーはリソースごとにそれぞれ一意である必要があります。また、各タグキーに設定できる値は 1 つのみです。
+ キーの最大長: 128 Unicode 文字 (UTF-8) 
+ 値の最大長: 256 Unicode文字 (UTF-8) 
+ すべてのサービスで使用できる文字は、UTF-8 で表現できる文字、数字、およびスペースに加えて、 \$1 - = . \$1 : / @ です。
+ タグキーと値は大文字と小文字が区別されます。
+ `aws:` プレフィックスは AWS 使用のために予約されています。タグにこのプレフィックスが付いたタグキーがある場合、タグのキーまたは値を編集、削除することはできません。aws: プレフィックスを持つタグは、リソースあたりのタグ数の制限にはカウントされません。

## リソースにタグを付けるアクセス許可を付与する
<a name="manage-resources_grant-permission"></a>

IAM ポリシーを使用して Amazon Location リソースへのアクセスを制御し、リソース作成時にタグを付けるアクセス許可を付与できます。ポリシーには、リソースを作成する権限を付与する他に、タグ付け操作を許可する Action 権限を含められます。
+ `geo:TagResource` — 指定された Amazon Location リソースに 1 つまたは複数のタグを付ける権限をユーザーに付与します。
+ `geo:UntagResource` — 指定された Amazon Location リソースから 1 つまたは複数のタグを削除する権限をユーザーに付与します。
+ `geo:ListTagsForResource` — Amazon Location リソースに付けられたタグの一覧を表示する権限をユーザーに付与します。

以下は、ジオフェンスコレクションの作成とリソースへのタグ付けをユーザーに許可するポリシーの例です。

```
{
"Version": "2012-10-17",		 	 	 
    "Statement": [
        {
"Sid": "AllowTaggingForGeofenceCollectionOnCreation",
            "Effect": "Allow",
            "Action": [
                "geo:CreateGeofenceCollection",
                "geo:TagResource"
            ],
            "Resource": "arn:aws:geo:region:accountID:geofence-collection/*"
    ]
}
```

## リソースにタグを追加する
<a name="manage-resources_add-tag"></a>

 Amazon Location コンソール、 CLI、または Amazon Location APIs AWS を使用して、リソースの作成時にタグを追加できます。
+ [ジオフェンスコレクションリソースを管理する](managing-geofence-collections.md) 
+ [トラッカーを作成する](start-create-tracker.md) 

**既存のリソースにタグを追加する、タグを編集、または削除するには**

1.  [Amazon Location コンソール](https://console.aws.amazon.com/location)を開きます。

1.  左側のナビゲーションペインで、タグを付けるリソースを選択します。ここでは例として、[**マップ**]を選択します。

1.  リストからリソースを選択します。

1.  次に **[タグの管理]** を選択して、タグの追加、編集または削除を行います。

## タグの使用方法
<a name="manage-resources_how-to"></a>

 タグを使用してコストを AWS 詳細に追跡できます。コスト配分タグを有効にすると、 はコスト配分タグ AWS を使用して、コスト配分レポートのリソース請求を整理します。これにより、使用コストを分類して追跡できます。

Amazon Location は[ユーザー定義](https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/custom-tags.html) – タグをサポートしています。これらは自分で作成するカスタムタグです。ユーザー定義タグには、`user:CostCenter` などのように `user:` プレフィックスを使用します。

 タグタイプごとに有効化する必要があります。タグがアクティブ化されたら、[AWS Cost Explorer を有効にする](https://docs.aws.amazon.com/cost-management/latest/userguide/ce-enable.html)か、毎月のコスト配分レポートを表示できます。

**ユーザー定義タグを有効化するには**

1.  [Billing and Cost Management コンソール](https://console.aws.amazon.com/billing)を開きます。

1.  左側のナビゲーションペインで、**[コスト配分タグ]** を選択します。

1.  [**ユーザー定義のコスト配分タグ**] タブで、有効化するタグキーを選択します。

1.  [**アクティブ化**] を選択します。

 タグをアクティブ化すると、 はリソースの使用状況とコストに関する[毎月のコスト配分レポート](https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/configurecostallocreport.html) AWS を生成します。このコスト配分レポートには、タグ付けされたリソースとタグ付けされていないリソースを含む、各請求期間のすべての AWS コストが含まれます。詳細については、*AWS 「請求ユーザーガイド*[」の「コスト配分タグを使用した AWS コストの整理と追跡](https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/cost-alloc-tags.html)」を参照してください。

### タグにより リソースへのアクセスを制御します
<a name="manage-resources_control-access"></a>

 AWS Identity and Access Management (IAM) ポリシーはタグベースの条件をサポートしているため、特定のタグキーと値に基づいてリソースの認可を管理できます。例えば、IAM ロールポリシーには、タグに基づいて特定の環境 (開発、テスト、本番など) へのアクセスを制限する条件を含めることができます。詳細については、[タグに基づくリソースアクセスの制御](https://docs.aws.amazon.com/location/latest/developerguide/security-iam.html#security_iam_id-based-policy-examples)に関するトピックを参照してください。

# Billing and Cost Management を使用して AWS 請求とコストを管理する
<a name="manage-billing"></a>

AWS Billing and Cost Management は、請求の支払いとコストの最適化に役立つ機能を提供するウェブサービスです。Amazon Web Services はアカウントの使用料金を使用された分のみ請求します。

**請求書の表示方法とコストの管理方法**

1. で[請求とコスト管理](https://console.aws.amazon.com/billing)を開きます AWS マネジメントコンソール。

1. Amazon Web Services, Inc. の料金でロケーションサービスをサービスで検索します 

1. **[\$1] ロケーションサービス**を選択します 

1. **[\$1] リージョン名**を選択します 

詳細については、 AWS マネジメントコンソールで「[請求とコスト管理](https://console.aws.amazon.com/costmanagement/home#/getting-started)」を参照してください。

# を使用してリソースを作成する AWS CloudFormation
<a name="cloudformation"></a>

Amazon Location Service は と統合されています。これは CloudFormation、 AWS リソースとインフラストラクチャの作成と管理に費やす時間を短縮できるように、リソースのモデル化とセットアップに役立つサービスです。Amazon Location リソースを含む必要なすべての AWS リソースを説明するテンプレートを作成すれば、 CloudFormation がユーザーに代わってこれらのリソースのプロビジョニングや設定を処理します。

を使用すると CloudFormation、テンプレートを再利用して Amazon Location リソースを一貫して繰り返しセットアップできます。リソースを一度記述し、同じリソースを複数の AWS アカウントとリージョンで何度もプロビジョニングします。

## 関連する CloudFormation テンプレート
<a name="cloudformation_templates"></a>

Amazon Location および関連サービスのリソースをプロビジョニングしてセットアップするには、[CloudFormation テンプレート](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/template-guide.html)について理解しておく必要があります。テンプレートは、JSON や YAML でフォーマットされたテキストファイルです。これらのテンプレートには、 CloudFormation スタックにプロビジョニングしたいリソースを記述します。JSON または YAML に慣れていない場合は、Infrastructure Composer を使用して CloudFormation テンプレートの使用を開始できます。詳細については、「 *CloudFormation ユーザーガイド*」の[「Infrastructure Composer](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/infrastructure-composer-for-cloudformation.html)」を参照してください。

Amazon Location は、 CloudFormationで次のリソースタイプの作成をサポートします。
+ [AWS::Location::Tracker](https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/aws-resource-location-tracker.html) 
+ [AWS::Location::TrackerConsumer](https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/aws-resource-location-trackerconsumer.html) 
+ [AWS::Location::GeofenceCollection](https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/aws-resource-location-geofencecollection.html) 

Amazon Location リソースの JSON テンプレートと YAML テンプレートの例を含む詳細については、「 テンプレートリファレンス」の[「Amazon Location Service リソースタイプの](https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/AWS_Location.html)*CloudFormation リファレンス*」を参照してください。

## の詳細 CloudFormation
<a name="cloudformation_learn"></a>

詳細については CloudFormation、次のリソースを参照してください。
+ [CloudFormation](https://aws.amazon.com/cloudformation) 
+ [CloudFormation ユーザーガイド](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/Welcome.html) 
+ [CloudFormation API リファレンス](https://docs.aws.amazon.com/AWSCloudFormation/latest/APIReference/Welcome.html) 
+ [CloudFormation コマンドラインインターフェイスユーザーガイド](https://docs.aws.amazon.com/cloudformation-cli/latest/userguide/what-is-cloudformation-cli.html) 

# モニタリングと監査
<a name="monitoring-auditing"></a>

モニタリングと監査は、Amazon Location Services 環境でアクティビティを追跡、モニタリング、ログ記録する機能を提供します。Amazon CloudWatch と AWS CloudTrail を使用すると、アプリケーションの信頼性、セキュリティ、コンプライアンスを確保できます。

これらのツールは、リソースパフォーマンスメトリクスの観察、異常の検出、監査とトラブルシューティングのための API アクティビティのログ記録に役立ちます。これらを使用して、運用上のインサイトを強化し、問題を診断して、コンプライアンス標準を確実に遵守します。

**Topics**
+ [Amazon CloudWatch で   を監視する](cloudwatch.md)
+ [によるモニタリングとログ記録 AWS CloudTrail](cloudtrail.md)

# Amazon CloudWatch で   を監視する
<a name="cloudwatch"></a>

Amazon CloudWatch は、 AWS リソースと AWS で実行するアプリケーションをほぼリアルタイムでモニタリングします。raw データを収集し、メトリクスをほぼリアルタイムで意味のある統計に処理する CloudWatch を使用して、Amazon Location リソースをモニタリングすることができます。最大 15 か月間の履歴情報が表示できます。また、メトリクスを Amazon CloudWatch コンソールで検索して、アプリケーションやサービスのパフォーマンスに関するより詳細な情報を確認することもできます。しきい値を定義してアラームを設定し、そのしきい値に達したときに通知を送信したりアクションを実行したりすることもできます。

 詳細については、「[Amazon CloudWatch ユーザーガイド](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/)」を参照してください

**Topics**
+ [Amazon Location Service メトリクスとディメンション](#metrics-exported-to-cloudwatch)
+ [Amazon Location Service のメトリクスを見る](#view-metrics)
+ [Amazon Location Service メトリクス用の CloudWatch アラームの作成](#create-alarms)
+ [CloudWatch を使用してクォータの使用量をモニタリングする](#alarms-on-quotas)
+ [Amazon Location Service の CloudWatch メトリクス例](#example-alarms)

## Amazon Location Service メトリクスとディメンション
<a name="metrics-exported-to-cloudwatch"></a>

メトリックスは、CloudWatch にエクスポートされる時系列のデータポイントです。ディメンションは、メトリクスを識別する名前と値のペアです。CloudWatch メトリクスの詳細については、[Amazon CloudWatch ユーザーガイド](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/cloudwatch_concepts.html#Dimension)の [Amazon CloudWatch メトリクスの使用](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/working_with_metrics.html)を参照してください。

**注記**  
Amazon Location Service の分散アーキテクチャにより、結果は概算になります。ほとんどの場合、カウントは送信される API オペレーションの実際の数に近い必要があります。

### Amazon Location Service のメトリクス
<a name="service-metrics"></a>

以下は、Amazon Location Service が `AWS/Location` 名前空間で CloudWatch にエクスポートするメトリクスは次のとおりです。


| メトリクス | 説明 | ディメンション | 
| --- | --- | --- | 
|  `CallCount`  |  特定の API エンドポイントに対して行われた呼び出しの回数。 有効な統計: Sum 単位: カウント  |  OperationName OperationName、ResourceName ApiKeyName、OperationName ApiKeyName、OperationName、ResourceName OperationName、OperationVersion OperationName、OperationVersion、ResourceName ApiKeyName、OperationName、OperationVersion ApiKeyName、OperationName、OperationVersion、ResourceName  | 
|  `ErrorCount`  |  特定の API エンドポイントに対して行われた呼び出しによるエラーレスポンスの数。 有効な統計: Sum 単位: カウント  |  OperationName OperationName、ResourceName ApiKeyName、OperationName ApiKeyName、OperationName、ResourceName  | 
|  `SuccessCount`  |  特定の API エンドポイントに対して成功した呼び出しの数。 有効な統計: Sum 単位: カウント  |  OperationName OperationName、ResourceName ApiKeyName、OperationName ApiKeyName、OperationName、ResourceName  | 
|  `CallLatency`  |  特定の API エンドポイントに対して呼び出しが行われたときに、オペレーションがレスポンスを処理して応答が返されるまでにかかる時間。 有効な統計: Average 単位: ミリ秒  |  OperationName OperationName、ResourceName ApiKeyName、OperationName ApiKeyName、OperationName、ResourceName  | 

### Amazon Location Service メトリクスのディメンション
<a name="service-dimensions"></a>

Amazon Location Service のメトリクスをフィルターするには、次の表のディメンションを使用できます。


| ディメンション | 説明 | 
| --- | --- | 
|  OperationName   |  指定されたオペレーション名を使用して、API オペレーションの Amazon Location メトリクスをフィルタリングします。  | 
|  OperationName、ResourceName  |  指定されたオペレーション名とリソース名を使用して、API オペレーションの Amazon Location メトリクスをフィルタリングします。  | 
|  ApiKeyName、OperationName  |  指定されたオペレーション名と指定された API キー名を使用して、API オペレーションの Amazon Location メトリクスをフィルタリングします。  | 
|  ApiKeyName、OperationName、ResourceName  |  指定されたオペレーション名、リソース名、および指定された API キー名を使用して、API オペレーションの Amazon Location メトリクスをフィルタリングします。  | 
|  OperationName、OperationVersion  |  指定されたオペレーション名を使用して、API オペレーションの Amazon Location メトリクスをフィルタリングします。 Amazon Location Service スタンドアロンのマップ、場所、ルートは、このディメンションへのエクスポートメトリクスになります。  | 
|  OperationName、OperationVersion、ResourceName   |  指定されたオペレーション名、バージョン、Amazon Location リソース名を使用して、API オペレーションの Amazon Location メトリクスをフィルタリングします。 Amazon Location スタンドアロンのマップ、場所、ルートは、このディメンションへのエクスポートメトリクスになります。  | 
|  ApiKeyName、OperationName、OperationVersion  |  指定されたオペレーション名、バージョン、および指定された API キー名を使用して、API オペレーションに対する Amazon Location メトリクスをフィルタリングします。 Amazon Location スタンドアロンのマップ、場所、ルートは、このディメンションへのエクスポートメトリクスになります。  | 
|  ApiKeyName、OperationName、OperationVersion、ResourceName   |  指定されたオペレーション名、バージョン、リソース名、および指定された API キー名を使用して、API オペレーションに対する Amazon Location メトリクスをフィルタリングします。 Amazon Location スタンドアロンのマップ、場所、ルートは、このディメンションへのエクスポートメトリクスになります。  | 

## Amazon Location Service のメトリクスを見る
<a name="view-metrics"></a>

Amazon Location Service のメトリクスは、 Amazon CloudWatch コンソールまたは Amazon CloudWatch API を使用して表示できます。

**CloudWatch コンソールを使用してメトリクスを表示するには**

**Example**  

1. CloudWatch コンソール ([https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/)) を開きます。

1. ナビゲーションペインで [**Metrics (メトリクス)**] を選択してください。

1. **[すべてのメトリクス]** タブで、**[Location]** 名前空間を選択します。

1. 表示するメトリクスのタイプを選択します。

1. メトリクスを選択してグラフに追加します。
詳細については、*Amazon CloudWatch ユーザーガイド*の「[使用可能なメトリクスの表示](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/viewing_metrics_with_cloudwatch.html)」を参照してください。

## Amazon Location Service メトリクス用の CloudWatch アラームの作成
<a name="create-alarms"></a>

CloudWatch を使って、Amazon Location Service のメトリクスにアラームを設定することができます。例えば、CloudWatch でアラームを作成し、エラーが急増するたびにメールを送信することができます。

以下のトピックでは、 を使用してアラームを設定する方法の概要について説明します。詳細な手順については、*Amazon CloudWatch ユーザーガイド*の「[Amazon CloudWatch でのアラームの使用](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch_Alarms.html)」を参照してください。

**CloudWatch コンソールを使用してアラームを設定するには**

**Example**  

1. CloudWatch コンソールの [https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/) を開いてください。

1. ナビゲーションペインで、**アラーム**を選択します。

1. **アラームの作成**(アラームの作成) を選択します。

1. **メトリクスの選択** を選択します。

1. **[すべてのメトリクス]** タブで、**[Location]** 名前空間を選択します。

1. メトリクスカテゴリを選択してくだい。

1. アラームを作成したいメトリクスのあるその行の横にあるチェックボックスを選択してください。

1. **メトリクスの選択** を選択します。

1. **[メトリクス]** に値を入力してください。

1. アラームの **[条件]** を指定してください。

1. [**次へ**] を選択します。

1. アラーム条件が満たされたときに通知を送信したい場合:
   + **アラーム状態のトリガー**で、通知の送信を促すアラーム状態を選択します。
   + **SNS トピックの選択**で**新しいトピックの作成**を選択し、新しい Amazon Simple Notiﬁcation Service (Amazon SNS) トピックを作成します。トピック名と通知の送信先のメールを入力します。
   + **通知を送信**で、通知の送信先となる追加のメールアドレスを入力します。
   + **通知を追加** をクリックします。このリストは保存され、今後のアラーム用のフィールドに表示されます。

1. 終了したら、**次へ**を選択します。

1. アラームの名前と説明を入力し、**次へ**を選択します。

1. アラームの詳細を確認して、**次へ**を選択します。

**注記**  
新しいAmazon SNS トピックを作成する場合、E メールアドレスを検証しなければ、そのアドレスで通知を受け取ることができません。メールが確認されていない場合、状態の変化によりアラームが開始されても、通知は受信されません。

CloudWatch コンソールを使用してアラームを設定する方法の詳細については、*Amazon CloudWatch ユーザーガイド*の「[メールを送信するアラームの作成](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch_Alarms.html)」を参照してください。

## CloudWatch を使用してクォータの使用量をモニタリングする
<a name="alarms-on-quotas"></a>

Amazon CloudWatch アラームを作成して、特定のクォータの使用率が設定可能なしきい値を超えた場合に通知することができます。これにより、割り当ての限界に近づいたことを認識し、コストオーバーを避けるために利用率を調整するか、必要であれば割り当ての増額を要求することができる。

CloudWatch を利用してクォータをモニタリングする方法については、*Amazon CloudWatch ユーザーガイド*の「[Service Quotas の可視化とアラームの設定](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Quotas-Visualize-Alarms.html)」を参照してください。

## Amazon Location Service の CloudWatch メトリクス例
<a name="example-alarms"></a>

[GetMetricData](https://docs.aws.amazon.com/AmazonCloudWatch/latest/APIReference/API_GetMetricData.html) API を利用して、Amazon Location のメトリクスを取得することができます。
+ 例えば、`CallCount` をモニタリングして、数値が低下したときのアラームを設定することができます。

  `SendDeviceLocation` の `CallCount` メトリクスをモニタリングすることで、追跡対象資産の全体像を把握しやすくなります。`CallCount` 値が下がった場合は、トラックのフリートなどの追跡対象資産が現在の位置の送信を停止したことを意味します。このアラームを設定することで、問題が発生したことを知らせるのに役立ちます。
+ 別の例では、`ErrorCount` をモニタリングして、数値の急上昇が起こったときにアラームを設定することができます。

  デバイスの位置をジオフェンスと照合して評価するには、トラッカーをジオフェンスコレクションに関連付ける必要があります。継続的な位置情報の更新を必要とするデバイスフリートがある場合、`BatchEvaluateGeofence` または `BatchPutDevicePosition` の `CallCount` がゼロになるのは、更新がもはや流れていないことを表示します。

以下は、マップリソースを作成するためのメトリクスとマップリソースを作成するための `CallCount` と `ErrorCount` のメトリックを含む [GetMetricData](https://docs.aws.amazon.com/AmazonCloudWatch/latest/APIReference/API_GetMetricData.html) のアウトプット例です。

```
{
"StartTime": 1518867432,
  "EndTime": 1518868032,
  "MetricDataQueries": [
    {
"Id": "m1",
      "MetricStat": {
"Metric": {
"Namespace": "AWS/Location",
          "MetricName": "CallCount",
          "Dimensions": [
            {
"Name": "SendDeviceLocation",
              "Value": "100"
            }
          ]
        },
        "Period": 300,
        "Stat": "SampleCount",
        "Unit": "Count"
      }
    },
    {
"Id": "m2",
      "MetricStat": {
"Metric": {
"Namespace": "AWS/Location",
          "MetricName": "ErrorCount",
          "Dimensions": [
            {
"Name": "AssociateTrackerConsumer",
              "Value": "0"
            }
          ]
        },
        "Period": 1,
        "Stat": "SampleCount",
        "Unit": "Count"
      }
    }
  ]
}
```

# によるモニタリングとログ記録 AWS CloudTrail
<a name="cloudtrail"></a>

AWS CloudTrail は、ユーザー、ロール、または サービスによって実行されたアクションを記録するサービスです AWS 。CloudTrail は、API コールをイベントとして記録します。CloudTrail で Amazon Location Service を使用して API コールをモニタリングできます。これには、Amazon Location Service コンソールからの呼び出しと、Amazon Location Service API オペレーションへの AWS SDK 呼び出しが含まれます。

CloudTrail は AWS 、アカウントの作成時に自動的に有効になります。Amazon Location Service でアクティビティが発生すると、そのアクティビティはイベント**履歴**の他の AWS サービスイベントとともに CloudTrail イベントに記録されます。 AWS リージョンごとに過去 90 日間のイベント履歴を表示、検索、ダウンロードできます。

CloudTrail の詳細については、「[AWS CloudTrail ユーザーガイド](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/)」を参照してください。**[イベント履歴]** の閲覧には CloudTrail の料金はかかりません。

Amazon Location Service からのイベントなど、過去 90 日間の AWS アカウントのイベントの継続的な記録については、証跡または [CloudTrail Lake](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-lake.html) データストアを作成します。

**CloudTrail 証跡**

証跡により、CloudTrail はログファイルを Amazon S3 バケットに配信できます。で証跡を作成すると AWS マネジメントコンソール、証跡はすべての AWS リージョンに適用されます。証跡は AWS 、パーティション内のすべてのリージョンからのイベントをログに記録し、指定した S3 バケットにログファイルを配信します。さらに、CloudTrail ログで収集されたイベントデータをさらに分析して処理するように他の AWS サービスを設定できます。

証跡の作成方法の詳細については、「[証跡を作成するための概要](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-create-and-update-a-trail.html)」を参照してください。

CloudTrail でサポートされているサービスと統合のリストについては、「[CloudTrail でサポートされているサービスと統合](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-aws-service-specific-topics.html#cloudtrail-aws-service-specific-topics-integrations)」を参照してください。

証跡を作成すると、進行中の管理イベントのコピーを 1 つ無料で CloudTrail から Amazon S3 バケットに配信できます。ただし、Amazon S3 ストレージ料金が発生します。

CloudTrail の料金の詳細については、「[AWS CloudTrail の料金](https://aws.amazon.com/cloudtrail/pricing/)」を参照してください。

Amazon S3 の料金に関する詳細については、「[Amazon S3 料金](https://aws.amazon.com/s3/pricing/)」を参照してください。

**CloudTrail Lake イベントデータストア**

[CloudTrail Lake] を使用すると、イベントに対して SQL ベースのクエリを実行できます。イベントは、*イベントデータストア*に集約されます。イベントデータストアは、[高度なイベントセレクタ](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-lake-concepts.html#adv-event-selectors)を適用することによって選択する条件に基づいた、イベントのイミュータブルなコレクションです。どのイベントが存続し、クエリに使用できるかは、イベントデータストアに適用するセレクタが制御します。

CloudTrail Lake の詳細については、「[AWS CloudTrail Lake の使用](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-lake.html)」を参照してください。

CloudTrail Lake のイベントデータストアとクエリにはコストがかかります。イベントデータストアを作成する際に、イベントデータストアに使用する[料金オプション](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-lake-manage-costs.html#cloudtrail-lake-manage-costs-pricing-option)を選択します。料金オプションによって、イベントの取り込みと保存にかかる料金、および、そのイベントデータストアのデフォルトと最長の保持期間が決まります。

CloudTrail の料金の詳細については、「[AWS CloudTrail の料金](https://aws.amazon.com/cloudtrail/pricing/)」を参照してください。

**Topics**
+ [CloudTrail の Amazon Location 管理イベント](#cloudtrail-management-events)
+ [CloudTrail の Amazon Location データイベント](#cloudtrail-data-events)
+ [Amazon Location Service のログファイルエントリについて](#cloudtrail-log-entries)
+ [例: Amazon Location 管理イベントの CloudTrail ログファイルエントリ](#cloudtrail-management-event-example)
+ [例: Amazon Location データイベントの CloudTrail ログファイルエントリ](#cloudtrail-data-event-example)

## CloudTrail の Amazon Location 管理イベント
<a name="cloudtrail-management-events"></a>

Amazon Location 管理イベントは、CloudTrail イベント履歴で表示できます。これらのイベントには、Amazon Location のリソースと設定を管理するすべての API コールが含まれます。サポートされているアクションの完全なリストについては、「[Amazon Location Service API リファレンス](https://docs.aws.amazon.com/location/latest/APIReference/Welcome.html)」を参照してください。

## CloudTrail の Amazon Location データイベント
<a name="cloudtrail-data-events"></a>

 データイベントでは、リソース上で直接実行されたオペレーションについての情報が得られます。これらのイベントは、データプレーンオペレーションとも呼ばれ、大量の場合があります。デフォルトで、CloudTrail はデータイベントをログに記録せず、CloudTrail イベント履歴にも記録されません。データイベントを有効にすると、追加料金が発生します。CloudTrail 料金の詳細については、「[AWS CloudTrail 料金表](https://aws.amazon.com/cloudtrail/pricing/)」を参照してください。

 CloudTrail コンソール、AWS CLI、または CloudTrail API オペレーションを使用して、Amazon Location リソースのタイプごとにデータイベントをログに記録するかどうかを選択できます。データイベントを有効化および管理する方法については、「[AWS マネジメントコンソールを使用したデータイベントのログ記録](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/logging-data-events-with-cloudtrail.html#logging-data-events-console)」および「[AWS コマンドラインインターフェイスを使用したデータイベントのログ記録](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/logging-data-events-with-cloudtrail.html#creating-data-event-selectors-with-the-AWS-CLI)」を参照してください。

次の表に、データイベントをログに記録できる Amazon Location リソースタイプを示します。


**サポートされている Amazon Location データイベント**  

| データイベントタイプ (コンソール) | resources.type 値 | CloudTrail にログ記録されたデータ API | 
| --- | --- | --- | 
| ジオマップ | AWS::GeoMaps::Provider | Amazon [GeoMaps API](https://docs.aws.amazon.com/location/latest/APIReference/Welcome.html#Welcome_Amazon_Location_Service_Maps) リファレンスを参照してください | 
| ジオプレイス | AWS::GeoPlaces::Provider | Amazon [GeoPlaces API](https://docs.aws.amazon.com/location/latest/APIReference/Welcome.html#Welcome_Amazon_Location_Service_Places) リファレンスを参照してください | 
| ジオルート | AWS::GeoRoutes::Provider | Amazon [GeoRoutes API](https://docs.aws.amazon.com/location/latest/APIReference/Welcome.html#Welcome_Amazon_Location_Service_Routes) リファレンスを参照してください | 

**注記**  
Amazon Location は、`GetStyleDescriptor`、`GetGlyphs`、および `GetSprites` の GeoMaps API の CloudTrail イベントを発行しません。これらの API は無料で、認証は必要ありません。

 高度なイベントセレクタを設定して、`eventName`、`readOnly`、および `resources.ARN` でイベントをフィルタリングできます。これにより、重要なイベントのみをログに記録できます。詳細については、「[AdvancedFieldSelector](https://docs.aws.amazon.com/awscloudtrail/latest/APIReference/API_AdvancedFieldSelector.html)」を参照してください。

## Amazon Location Service のログファイルエントリについて
<a name="cloudtrail-log-entries"></a>

 証跡を設定すると、CloudTrail はイベントをログファイルとして、指定した S3 バケットまたは Amazon CloudWatch Logs に配信します。詳細については、[「 ユーザーガイド」のCloudTrail ログファイルの使用](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-working-with-log-files.html)」を参照してください。 AWS CloudTrail 

 CloudTrail ログファイルには、1 つ以上のログエントリを含むことができます。各イベントエントリは任意の送信元からの単一のリクエストを表し、リクエストされたオペレーション、オペレーションの日時、リクエストパラメータなどに関する詳細を含みます。

**注記**  
CloudTrail ログファイルは、API コールの順序付けられたスタックトレースではありません。これらは時系列では表示されません。操作の順序を決定するには、`[eventTime](https://docs.aws.amazon.com/awscloudtrail/latest/APIReference/API_Event.html)` を使用します。

 各イベントまたはログエントリには、リクエストの作成者に関する情報が含まれます。この ID 情報は以下のことを確認するのに役立ちます。
+ リクエストが、ルートとユーザー認証情報のどちらを使用して送信されたか。
+ リクエストが、ロールとフェデレーションユーザーのどちらかの一時的なセキュリティ認証情報を使用して送信されたかどうか。
+ リクエストが別の AWS サービスによって行われたかどうか。

## 例: Amazon Location 管理イベントの CloudTrail ログファイルエントリ
<a name="cloudtrail-management-event-example"></a>

 次の例は、トラッカーリソースを作成する `CreateTracker` オペレーションの CloudTrail ログエントリを示しています。

```
{
    "eventVersion": "1.05",
    "userIdentity": {
        "type": "AssumedRole",
        "principalId": "111122223333",
        "arn": "arn:aws:geo:us-east-1:111122223333:tracker/ExampleTracker",
        "accountId": "111122223333",
        "accessKeyId": "AKIAIOSFODNN7EXAMPLE",
        "sessionContext": {
            "sessionIssuer": {
                "type": "Role",
                "principalId": "111122223333",
                "arn": "arn:aws:geo:us-east-1:111122223333:tracker/ExampleTracker",
                "accountId": "111122223333",
                "userName": "exampleUser"
            },
            "webIdFederationData": {},
            "attributes": {
                "mfaAuthenticated": "false",
                "creationDate": "2020-10-22T16:36:07Z"
            }
        }
    },
    "eventTime": "2020-10-22T17:43:30Z",
    "eventSource": "geo.amazonaws.com",
    "eventName": "CreateTracker",
    "awsRegion": "us-east-1",
    "sourceIPAddress": "SAMPLE_IP_ADDRESS",
    "userAgent": "aws-internal/3 aws-sdk-java/1.11.864 Linux/4.14.193-110.317.amzn2.x86_64 OpenJDK_64-Bit_Server_VM/11.0.8+10-LTS java/11.0.8 kotlin/1.3.72 vendor/Amazon.com_Inc. exec-env/AWS_Lambda_java11",
    "requestParameters": {
        "TrackerName": "ExampleTracker",
        "Description": "Resource description"
    },
    "responseElements": {
        "TrackerName": "ExampleTracker",
        "Description": "Resource description",
        "TrackerArn": "arn:partition:service:region:account-id:resource-id",
        "CreateTime": "2020-10-22T17:43:30.521Z"
    },
    "requestID": "557ec619-0674-429d-8e2c-eba0d3f34413",
    "eventID": "3192bc9c-3d3d-4976-bbef-ac590fa34f2c",
    "readOnly": false,
    "eventType": "AwsApiCall",
    "recipientAccountId": "111122223333"
}
```

## 例: Amazon Location データイベントの CloudTrail ログファイルエントリ
<a name="cloudtrail-data-event-example"></a>

 次の例は、`Geocode` オペレーションの CloudTrail ログエントリを示しています。このエントリは、座標、アドレス、および場所に関するその他の詳細を取得します。

```
{
  "eventVersion": "1.09",
  "userIdentity": {
    "type": "AssumedRole",
    "principalId": "AROA6ODU7M35SFGUCGXHMSAMPLE",
    "arn": "arn:aws:sts::111122223333:assumed-role/Admin/vingu-Isengard",
    "accountId": "111122223333",
    "accessKeyId": "ASIA6ODU7M352GLR5CFMSAMPLE",
    "sessionContext": {
      "sessionIssuer": {
        "type": "Role",
        "principalId": "AROA6ODU7M35SFGUCGXHMSAMPLE",
        "arn": "arn:aws:iam::111122223333:role/Admin",
        "accountId": "111122223333",
        "userName": "Admin"
      },
      "attributes": {
        "creationDate": "2024-09-16T14:41:33Z",
        "mfaAuthenticated": "false"
      }
    }
  },
  "eventTime": "2024-09-16T14:42:16Z",
  "eventSource": "geo-places.amazonaws.com",
  "eventName": "Geocode",
  "awsRegion": "us-west-2",
  "sourceIPAddress": "52.94.133.129",
  "userAgent": "Amazon CloudFront",
  "requestParameters": {
    "Query": "***",
    "Filter": {
      "IncludeCountries": [
        "USA"
      ]
    }
  },
  "responseElements": null,
  "requestID": "1ef7e0b8-c9fc-4a20-80c3-b5340d634c4e",
  "eventID": "913d256c-3a9d-40d0-9bdf-705f12c7659f",
  "readOnly": true,
  "resources": [
    {
      "accountId": "111122223333",
      "type": "AWS::GeoPlaces::Provider",
      "ARN": "arn:aws:geoplaces:us-west-2:111122223333:provider"
    }
  ],
  "eventType": "AwsApiCall",
  "managementEvent": false,
  "recipientAccountId": "111122223333",
  "eventCategory": "Data"
}
```

# ベストプラクティス
<a name="integration-best-practice"></a>

Amazon Location Service と統合する際のベストプラクティスを以下に示します。

## リソース管理
<a name="resource-best-practice"></a>

Amazon Location Service でロケーションリソースを効果的に管理するには、次のベストプラクティスを検討してください。

**注記**  
以下のベストプラクティスは、v1 APIs で使用されるスタンドアロンリソースに適用されます。v2 Maps、Places、Routes APIs、リソースの作成は必要ありません。
+ 予想されるユーザーベースの中心となるリージョナルエンドポイントを使用して、ユーザーエクスペリエンスを向上させましょう。リージョンエンドポイントの詳細については、「[Amazon Location がサポートされているリージョン](location-regions.md)」を参照してください。
+ マップリソースやプレースインデックスリソースなど、データプロバイダーを使用するリソースについては、必ず特定のデータプロバイダーの利用規約に従ってください。詳細については、「[利用規約とデータアトリビューション](data-attribution.md)」を参照してください。
+ マップ、Place Index 、ルートの構成ごとに 1 つのリソースを用意して、リソースの作成を最小限に抑えます。リージョン内では、通常、データプロバイダーまたはマップスタイルごとに必要なリソースは 1 つだけです。ほとんどのアプリケーションは既存のリソースを使用し、実行時にはリソースを作成しません。
+ マップリソースやルート計算ツールなど、1 つのアプリケーションで異なるリソースを使用する場合は、データが一致するように各リソースで同じデータプロバイダーを使用してください。例えば、ルートカリキュレータで作成したルートジオメトリが、マップリソースを使用して描画されたマップ上の道路と一致するとします。

## 請求情報とコスト管理
<a name="cost-best-practice"></a>

コストと請求を管理するには、次のベストプラクティスを検討してください。
+ Amazon CloudWatch などのモニタリングツールを使用して、リソースの使用状況を追跡します。使用量が指定した制限を超えそうになったときに通知するアラートを設定できます。詳細については、*Amazon CloudWatch ユーザーガイド*」の[「推定 AWS 請求額をモニタリングするための請求アラームの作成](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/monitor_estimated_charges_with_cloudwatch.html)」を参照してください。

## クォータと使用量
<a name="quota-best-practice"></a>

使用量のデフォルト制限を設定するクォータ AWS アカウント が含まれています。使用量が上限に近づいたときに通知するアラームを設定したり、必要なときにクォータの引き上げをリクエストしたりできます。クォータの使用方法については、次のトピックを参照してください。
+ [Service Quotas を使用してクォータを管理する](manage-quotas.md)
+ [Amazon Location Service メトリクス用の CloudWatch アラームの作成](cloudwatch.md#create-alarms)
+ *Amazon CloudWatch ユーザーガイド*の「[サービスクォータの可視化とアラームの設定](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Quotas-Visualize-Alarms.html)」。

制限を超えそうになったときに事前に警告するアラームを作成できます。Amazon Location AWS リージョン を使用する各 のクォータごとにアラームを設定することをお勧めします。例えば、`SearchPlaceIndexForText` オペレーションの使用状況をモニタリングし、現在のクォータの 80% を超えたらアラームを作成できます。

クォータに関するアラーム警告が表示されたら、何をすべきかを決める必要があります。顧客ベースが拡大したため、追加のリソースを使用している可能性があります。その場合は、そのリージョンでの API コールの割り当てを 50% 増やすなど、割り当ての増額をリクエストするとよいでしょう。あるいは、サービスにエラーがあり、Amazon Location に対して不必要な呼び出しを何度も行うことになる場合もあります。その場合は、サービスの問題を解決したいと思うでしょう。