

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# Integração da AWS para o Amazon Location Service
<a name="integration"></a>

A Amazon Location Service é integrado a vários serviços da AWS para autenticação, monitoramento, gerenciamento e desenvolvimento eficientes.

**Monitor**  
+ **Amazon CloudWatch** – Visualize as métricas de uso e integridade do serviço, incluindo solicitações, latência, falhas e logs. Para obter mais informações, consulte [Monitore com a Amazon CloudWatch](cloudwatch.md).
+ **AWS CloudTrail** – Registre log e monitore suas chamadas de API, que incluem ações executadas por um usuário, um cargo ou um serviço da AWS. Para obter mais informações, consulte [Monitore e registre com AWS CloudTrail](cloudtrail.md).

**Gerencie**  
+ **AWS CloudFormation** – O Amazon Location está integrado a AWS CloudFormation, um serviço que ajuda a modelar e configurar seus recursos da AWS para que você possa gastar menos tempo criando e gerenciando seus recursos e infraestrutura. Para obter mais informações, consulte [Crie recursos com AWS CloudFormation](cloudformation.md).
+ **Service Quotas** — Use o console do Service Quotas e a AWS CLI para solicitar alterações em suas cotas ajustáveis. Para obter mais informações, consulte [Gerenciar cotas com o Service Quotas](manage-quotas.md).
+ **Marcações** – Use a marcação de recursos no Amazon Location para criar marcas para categorizar recursos por finalidade, proprietário, ambiente ou critérios. Marcar seus recursos ajuda você a gerenciar, identificar, organizar, pesquisar e filtrar seus recursos. Para obter mais informações, consulte [Gerenciar recursos com Marcações](manage-resources.md).

**Authenticate**  
+ **Amazon Cognito** – Você pode usar a autenticação do Amazon Cognito como alternativa ao uso direto do AWS Identity and Access Management (IAM) com SDKs de frontend e solicitações diretas de HTTPS. Para obter mais informações, consulte [Usar o Amazon Cognito para autenticação](authenticating-using-cognito.md).
+ **IAM** – O AWS Identity and Access Management (IAM) é um serviço da AWS que ajuda um administrador a controlar o acesso aos atributos da AWS de forma segura. Os administradores do IAM controlam quem pode ser autenticado (conectado) e autorizado (ter permissões) para utilizar os recursos do Amazon Location Service. Para obter mais informações, consulte [Use AWS Identity and Access Management para autenticar](security-iam.md).

**Valor agregado**  
+ **Amazon EventBridge**: habilite uma arquitetura de aplicativo orientada por eventos para que você possa usar funções AWS Lambda para ativar outras partes do seu aplicativo e fluxos de trabalho. Para obter mais informações, consulte [Reaja aos eventos do Amazon Location Service com a Amazon EventBridge](location-events.md).
+ **AWS IoT** – O mecanismo de regras do AWS IoT Core armazena consultas sobre os tópicos de mensagens de seus dispositivos e permite que você defina ações para enviar mensagens para outros serviços da AWS, como o Amazon Location Service. Dispositivos que estão cientes de sua localização como coordenadas podem ter suas localizações encaminhadas para a Amazon Location por meio do mecanismo de regras. Para obter mais informações, consulte [Rastrear usando AWS IoT e MQTT com o Amazon Location Service](tracking-using-mqtt.md).

**Ferramentas do desenvolvedor**  
+ **SDKs** – O Amazon Location Service oferece uma variedade de ferramentas para desenvolvedores criarem aplicativos habilitados para localização. Isso inclui os SDKs da AWS padrão, os SDKs móveis e da web. Para obter mais informações, consulte [SDKs e estruturas para Amazon Location Service](dev-sdks.md).
+ **AWS CLI** – A AWS Command Line Interface (AWS CLI) é uma ferramenta de código aberto que permite interagir com os serviços da AWS usando comandos no shell da linha de comando. Com configuração mínima. Para obter mais informações, consulte [AWS Command Line Interface](https://docs.aws.amazon.com/cli/latest/reference/location/) ou saiba mais sobre a [AWS CLI](https://docs.aws.amazon.com/cli/).
+ **Código de amostra** — O código de amostra usa SDKs, SDKs móveis e web, o MapLibre da AWS para demonstrar como você pode usar o Amazon Location. Para obter mais informações consulte os [exemplos](https://location.aws.com/samples).
+ **Console do Amazon Location Service** – Use o console do Amazon Location para aprender sobre recursos e começar a usar uma ferramenta de aprendizado visual e interativa. Para obter mais informações, consulte o [console do Amazon Location Service](https://console.aws.amazon.com/location/explore/home).

**Cobrança e custos**  
+ **Gerenciamento de cobrança e custos da AWS** — O serviço que ajuda você a pagar suas contas e otimizar seus custos. A Amazon Web Services cobra apenas o uso da sua conta, o que garante que você pague somente pelo que utilizar. Para ter mais informações, consulte [Modelo de definição de preços](pricing.md) ou [Gerencie o faturamento e os custos com o AWS Billing and Cost Management](manage-billing.md).

# Gerenciamento de recursos
<a name="resource-management"></a>

O gerenciamento de recursos fornece ferramentas e processos para gerenciar cotas, organizar recursos com marcações, controlar custos e automatizar a criação de recursos usando o CloudFormation da AWS. Esses recursos permitem que você aloque, monitore e gerencie com eficiência seus recursos no Amazon Location.

Use essas ferramentas para manter a eficiência operacional definindo limites de serviço, marcando recursos para uma melhor organização, monitorando despesas e usando a infraestrutura como código com o CloudFormation para criar e gerenciar recursos de forma programática.

**Topics**
+ [Gerenciar cotas com o Service Quotas](manage-quotas.md)
+ [Gerenciar recursos com Marcações](manage-resources.md)
+ [Gerencie o faturamento e os custos com o AWS Billing and Cost Management](manage-billing.md)
+ [Crie recursos com AWS CloudFormation](cloudformation.md)

# Gerenciar cotas com o Service Quotas
<a name="manage-quotas"></a>

O console Service Quotas permite que você [solicite aumentos de cota ou diminua a cota para cotas ajustáveis](https://console.aws.amazon.com/servicequotas/home#!/services/geo/quotas). As cotas de serviço são o número máximo de chamadas ou recursos de API que você pode ter por AWS conta e AWS região. Ao solicitar um aumento de cota, selecione a região na qual você deseja aumentar a cota, pois a maioria das cotas é específica da região. O Amazon Location Service nega solicitações adicionais que excedam a Cota de serviço.

 Limites de taxas (cotas que começam com Taxa de...) são o número máximo de solicitações por segundo, com uma taxa de intermitência de 80% do limite em qualquer parte do segundo, definida para cada operação da API. As operações com limites de taxa aumentados para uma conta por meio de Quotas de Serviço podem ter uma taxa de pico inferior a 80% do limite de taxa aumentado. O Amazon Location Service controla a utilização de solicitações que excedem o limite de taxa da operação. 

## Gerenciar suas cotas do Amazon Location Service
<a name="manage-quotas_how"></a>

 O Amazon Location Service é integrado ao Service Quotas, um AWS serviço que permite que você visualize e gerencie suas cotas a partir de um local central. Para obter mais informações, consulte [O que é o Service Quotas?](https://docs.aws.amazon.com/servicequotas/latest/userguide/intro.html) no *Guia do usuário do Service Quotas*.

 O Service Quotas facilita a pesquisa do valor das cotas do seu Amazon Location Service. 

------
#### [ Console de gerenciamento da AWS ]

1. Abra o [console do Service Quotas](https://console.aws.amazon.com/servicequotas).

1. No painel de navegação, escolha **Serviços da AWS **.

1. Na lista de **AWS serviços**, procure e selecione **Amazon Location**.

1. Na lista **de cotas de serviço**, você pode ver o nome da cota de serviço, o valor aplicado (se estiver disponível), a cota AWS padrão e se o valor da cota é ajustável.

1. Para visualizar informações adicionais sobre uma service quota, como descrição, escolha o nome da cota.

1. (Opcional) Para solicitar um aumento de cota, selecione a cota que deseja aumentar, selecione **Solicitar Aumento de Cota**, insira ou selecione as informações necessárias e, por fim, selecione **Solicitar**.

 Para trabalhar mais com o Service Quotas usando o console, consulte o *Guia do usuário de Service Quotas*. Para solicitar um aumento da cota, consulte [Requesting a quota increase](https://docs.aws.amazon.com/servicequotas/latest/userguide/request-quota-increase.html) no *Guia do usuário do Service Quotas*. 

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

Execute o comando a seguir para visualizar as quotas padrão do 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
```

Para trabalhar mais com cotas de serviço usando o AWS CLI, consulte a seção Cotas de serviço *AWS CLI na* Referência de comandos. Para solicitar um aumento de quotas, consulte o comando [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) na *Referência de comandos da AWS CLI *. 

------

## Perguntas frequentes
<a name="manage-quotas_faq"></a>

**Quais são as cotas padrão dos recursos do Amazon Location Service?**  
O Amazon Location Service define cotas padrão APIs para ajudar a gerenciar a capacidade do serviço, que podem ser visualizadas no console de gerenciamento de [quotas de AWS serviços](https://console.aws.amazon.com/servicequotas/home#!/services/geo/quotas). Você pode descobrir links para tudo isso na seção [Gerenciar suas cotas do Amazon Location Service](#manage-quotas_monitor).

**Como posso solicitar um aumento nas cotas do Amazon Location Service?**  
Você pode solicitar um aumento nas cotas do Amazon Location Service por meio do [console de autoatendimento](https://console.aws.amazon.com/servicequotas/home#!/services/geo/quotas), em até duas vezes o limite padrão para cada API. Para limites de cota que excedam o dobro do limite padrão, solicite no console de autoatendimento e ele enviará um tíquete de suporte. Como alternativa, você pode conectar sua equipe de suporte premium 

**Há custos adicionais associados à solicitação de cotas mais altas para o Amazon Location Service?**  
Não há cobranças diretas para solicitações de aumento de cota, mas níveis mais altos de uso podem levar ao aumento dos custos de serviço com base nos recursos adicionais consumidos. 

## Gerenciar suas cotas do Amazon Location Service
<a name="manage-quotas_monitor"></a>

 Você pode monitorar seu uso em relação às suas cotas com a Amazon CloudWatch. Para obter mais informações, consulte [Monitore com a Amazon CloudWatch](cloudwatch.md).

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

## Saiba mais
<a name="manage-quotas_learn"></a>

 Para saber mais sobre o Service Quotas, consulte a [documentação do Service Quotas](https://docs.aws.amazon.com/servicequotas/latest/userguide/intro.html). 

# Gerenciar recursos com Marcações
<a name="manage-resources"></a>

Use a marcação de recursos no Amazon Location para criar tags para categorizar recursos por finalidade, proprietário, ambiente ou critérios. Marcar seus recursos ajuda você a gerenciar, identificar, organizar, pesquisar e filtrar seus recursos. Por exemplo, com AWS Resource Groups, você pode criar grupos de AWS recursos com base em uma ou mais tags ou partes de tags. Você também pode criar grupos com base em sua ocorrência em uma AWS CloudFormation pilha. Usando o Resource Groups e o Tag Editor, é possível consolidar e visualizar dados de aplicações que consistem em múltiplos serviços, recursos e regiões em um só lugar. Para obter mais informações sobre [estratégias comuns de marcação](https://docs.aws.amazon.com/tag-editor/latest/userguide/best-practices-and-strats.html), consulte a *Referência geral da AWS *.

Cada tag é um rótulo que consiste em uma chave e um valor definidos por você: 
+ **Chave de tag**: um rótulo geral que categoriza os valores da tag. Por exemplo, .`CostCenter` 
+ **Valor da tag**: uma descrição opcional para a categoria da chave da tag. Por exemplo, .`MobileAssetTrackingResourcesProd` 

Este tópico ajuda você a começar a marcar por meio da revisão das restrições de marcação. Também mostra como criar tags e usar tags para monitorar o AWS custo de cada tag ativa usando relatórios de alocação de custos. 

Para obter mais informações sobre: 
+ Práticas recomendadas de [marcação, consulte AWS Recursos de marcação](https://docs.aws.amazon.com/tag-editor/latest/userguide/best-practices-and-strats.html) na Referência *AWS geral*.
+ Usando tags para controlar o acesso aos AWS recursos, consulte [Controle do acesso a AWS recursos usando tags](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_tags.html) no *Guia do usuário do AWS Identity and Access Management*. 

## Restrições
<a name="manage-resources_restrictions"></a>

**nota**  
Se você adicionar uma nova tag com a mesma chave de uma tag existente, a nova sobrescreverá a tag existente.

A marcação permite que você organize e gerencie seus recursos com mais eficiência. Esta página descreve as regras e restrições específicas que regem o uso de tags no Amazon Location Service. Ao compreender essas restrições de marcação, você pode garantir a conformidade com as práticas recomendadas e evitar possíveis problemas ao implementar estratégias de marcação para seus recursos e aplicações baseados em localização. 

As restrições básicas a seguir se aplicam a tags: 
+ Máximo de marcações por recurso: 50 
+ Em todos os recursos, cada chave de tag deve ser exclusiva e possuir apenas um valor. 
+ Comprimento máximo da chave: 128 caracteres Unicode em UTF-8 
+ Valor máximo da chave: 256 caracteres Unicode em UTF-8 
+ Os caracteres permitidos nos serviços são: letras, números e espaços representáveis em UTF-8 e os seguintes caracteres: \$1 - = . \$1 : / @. 
+ As chaves e os valores de marcas diferenciam maiúsculas de minúsculas. 
+ O `aws:` prefixo está reservado para AWS uso. Não é possível editar nem excluir a chave ou o valor de uma tag quando ela tem uma chave de tag com esse prefixo. As marcações com o prefixo não contam em relação às marcações por limite de recurso. 

## Conceder permissão para marcar recursos
<a name="manage-resources_grant-permission"></a>

Você pode usar as políticas do IAM para controlar o acesso aos seus recursos do Amazon Location e conceder permissão para marcar um recurso na criação. Além de conceder permissão para criar recursos, a política pode incluir permissões Ação para permitir operações de marcação: 
+ `geo:TagResource`: Permite que um usuário atribua uma ou mais tags a um recurso do Amazon Location especificado. 
+ `geo:UntagResource`: Permite que um usuário remova uma ou mais tags de um recurso do Amazon Location especificado. 
+ `geo:ListTagsForResource`: Permite que um usuário liste todas as tags atribuídas a um recurso do Amazon Location. 

Veja a seguir um exemplo de política para permitir que um usuário crie uma coleção de geocercas e marque recursos: 

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

## Adicionar uma tag a um recurso
<a name="manage-resources_add-tag"></a>

 Você pode adicionar tags ao criar seus recursos usando o console de localização da Amazon, a AWS CLI ou a localização da Amazon: APIs 
+ [Gerencie os recursos de coleta de geocercas](managing-geofence-collections.md) 
+ [Criar um rastreador](start-create-tracker.md) 

**Para marcar recursos existentes, editar ou excluir tags**

1.  Abra o [console do Amazon Location](https://console.aws.amazon.com/location). 

1.  No painel de navegação à esquerda, escolha o recurso o qual você deseja atribui uma tag. Por exemplo, **Mapas**. 

1.  Escolha um recurso na lista. 

1.  Escolha **Gerenciar tags** para adicionar, editar ou excluir tags. 

## Como usar marcações
<a name="manage-resources_how-to"></a>

 Você pode usar tags para alocação de custos para monitorar seus AWS custos em detalhes. Depois de ativar as tags de alocação de custos, AWS use as tags de alocação de custos para organizar seu faturamento de recursos em seu relatório de alocação de custos. Isso ajuda você a categorizar e monitorar seus custos de uso. 

O Amazon Location oferece suporte a marcações [definidas pelo usuário](https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/custom-tags.html). Essas são marcações personalizadas que você cria. As tags definidas pelo usuário usam o prefixo `user:`, por exemplo, `user:CostCenter`.

 Você deve ativar cada tipo de tag individualmente. Depois que suas tags forem ativadas, você poderá [ativar o AWS Cost Explorer](https://docs.aws.amazon.com/cost-management/latest/userguide/ce-enable.html) ou visualizar seu relatório mensal de alocação de custos. 

**Para ativar tags definidas pelo usuário**

1.  Abra o console do [Billing and Cost Management](https://console.aws.amazon.com/billing). 

1.  No painel de navegação à esquerda, escolha **Tags de alocação de custos**. 

1.  Na guia **Tags de alocação de custos definidas pelo usuário**, selecione as chaves de tag que você deseja ativar. 

1.  Selecione **Ativar**. 

 Depois de ativar suas tags, AWS gera um [relatório mensal de alocação de custos](https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/configurecostallocreport.html) para o uso e o custo de seus recursos. Esse relatório de alocação de custos inclui todos os AWS custos de cada período de cobrança, incluindo recursos marcados e não marcados. Para obter mais informações, consulte [Organização e controle de custos usando etiquetas de alocação de AWS custos](https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/cost-alloc-tags.html) no Guia do *usuário de AWS faturamento*. 

### Controlar o acesso a recursos da usando tags
<a name="manage-resources_control-access"></a>

 AWS Identity and Access Management As políticas (IAM) oferecem suporte a condições baseadas em tags, o que permite gerenciar a autorização de seus recursos com base na chave e nos valores específicos das tags. Por exemplo, uma política de função IAM pode incluir condições para limitar o acesso a ambientes específicos, como desenvolvimento, teste ou produção, com base nas tags. Para obter mais informações, consulte o tópico sobre [controle de acesso a recursos com base em tags](https://docs.aws.amazon.com/location/latest/developerguide/security-iam.html#security_iam_id-based-policy-examples). 

# Gerencie o faturamento e os custos com o AWS Billing and Cost Management
<a name="manage-billing"></a>

AWS O Billing and Cost Management é um serviço web que fornece recursos que ajudam você a pagar suas contas e otimizar seus custos. A Amazon Web Services cobra apenas o uso da sua conta, o que garante que você pague somente pelo que utilizar. 

**Como ver as contas e gerenciar os custos**

1. Abra o [Billing and Cost](https://console.aws.amazon.com/billing) Management no Console de gerenciamento da AWS. 

1. Pesquise o serviço de localização de cobranças por serviço na Amazon Web Services, Inc. 

1. Escolha **[\$1] Serviço de localização** 

1. Escolha **[\$1] Nome da região** 

Para saber mais, consulte [Gerenciamento de faturamento e custos](https://console.aws.amazon.com/costmanagement/home#/getting-started) no Console de gerenciamento da AWS. 

# Crie recursos com AWS CloudFormation
<a name="cloudformation"></a>

O Amazon Location Service é integrado com CloudFormation, um serviço que ajuda você a modelar e configurar seus AWS recursos para que você possa gastar menos tempo criando e gerenciando seus recursos e infraestrutura. Você cria um modelo que descreve todos os recursos da AWS desejados (como os recursos Amazon Location) e o CloudFormation fornece e configura esses recursos para você. 

Ao usar CloudFormation, você pode reutilizar seu modelo para configurar seus recursos de localização da Amazon de forma consistente e repetida. Descreva seus recursos uma vez e, em seguida, provisione os mesmos recursos repetidamente em várias AWS contas e regiões. 

## CloudFormation Modelos relacionados
<a name="cloudformation_templates"></a>

Para fornecer e configurar recursos para o Amazon Location e serviços relacionados, é preciso entender os [modelos CloudFormation](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/template-guide.html). Os modelos são arquivos de texto formatados em JSON ou YAML. Esses modelos descrevem os atributos que você deseja provisionar nas suas pilhas CloudFormation . Se você não estiver familiarizado com JSON ou YAML, você pode usar o Infrastructure Composer para ajudá-lo a começar a usar modelos. CloudFormation Para obter mais informações, consulte [Infrastructure Composer](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/infrastructure-composer-for-cloudformation.html) no *Guia do CloudFormation usuário*. 

O Amazon Location é compatível com a criação dos seguintes tipos de recursos no CloudFormation: 
+ [AWS::Location::Tracker](https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/aws-resource-location-tracker.html) 
+ [AWS: :Localização:: TrackerConsumer](https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/aws-resource-location-trackerconsumer.html) 
+ [AWS: :Localização:: GeofenceCollection](https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/aws-resource-location-geofencecollection.html) 

Para obter mais informações, incluindo exemplos de modelos JSON e YAML para recursos de localização da Amazon, consulte a referência do [tipo de recurso do Amazon Location Service na Referência](https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/AWS_Location.html) do *CloudFormation modelo*. 

## Saiba mais sobre CloudFormation
<a name="cloudformation_learn"></a>

Para saber mais sobre isso CloudFormation, consulte os seguintes recursos: 
+ [CloudFormation](https://aws.amazon.com/cloudformation) 
+ [CloudFormation Guia do usuário](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/Welcome.html) 
+ [CloudFormation API Reference](https://docs.aws.amazon.com/AWSCloudFormation/latest/APIReference/Welcome.html) 
+ [CloudFormation Guia do usuário da interface de linha de comando](https://docs.aws.amazon.com/cloudformation-cli/latest/userguide/what-is-cloudformation-cli.html) 

# Monitoramento e auditoria
<a name="monitoring-auditing"></a>

O monitoramento e a auditoria fornecem recursos para rastrear, monitorar e registrar em log as atividades em seu ambiente do Amazon Location Service. Com o Amazon CloudWatch e o CloudTrail da AWS, você pode garantir a confiabilidade, a segurança e a conformidade de seus aplicativos.

Essas ferramentas ajudam você a observar as métricas de desempenho dos recursos, detectar anomalias e registrar em log a atividade da API para fins de auditoria e solução de problemas. Use-os para aprimorar os insights operacionais, diagnosticar problemas e garantir a adesão aos padrões de conformidade.

**Topics**
+ [Monitore com a Amazon CloudWatch](cloudwatch.md)
+ [Monitore e registre com AWS CloudTrail](cloudtrail.md)

# Monitore com a Amazon CloudWatch
<a name="cloudwatch"></a>

A Amazon CloudWatch monitora seus AWS recursos e os aplicativos nos quais você executa quase AWS em tempo real. Você pode monitorar os recursos de localização da Amazon usando CloudWatch, que coleta dados brutos e processa métricas em estatísticas significativas quase em tempo real. Você pode visualizar informações históricas de até 15 meses ou pesquisar métricas para visualizar no CloudWatch console da Amazon para obter mais perspectivas sobre o desempenho de seu aplicativo ou serviço. Você também pode definir alarmes ao determinar limites e enviar notificações ou realizar ações quando esses limites são atingidos. 

 Para obter mais informações, consulte o [Guia CloudWatch do usuário da Amazon](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/)

**Topics**
+ [Métricas e dimensões do Amazon Location Service](#metrics-exported-to-cloudwatch)
+ [Ver indicadores do Amazon Location Service](#view-metrics)
+ [Crie CloudWatch alarmes para as métricas do Amazon Location Service](#create-alarms)
+ [Use CloudWatch para monitorar o uso em relação às cotas](#alarms-on-quotas)
+ [CloudWatch exemplos de métricas para Amazon Location Service](#example-alarms)

## Métricas e dimensões do Amazon Location Service
<a name="metrics-exported-to-cloudwatch"></a>

As métricas são pontos de dados ordenados por tempo que são exportados para o. CloudWatch Uma dimensão é um name/value par que identifica a métrica. Para obter mais informações, consulte [Uso de CloudWatch métricas](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/working_with_metrics.html) e [CloudWatch dimensões](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/cloudwatch_concepts.html#Dimension) no Guia CloudWatch do usuário da Amazon.

**nota**  
O resultado é aproximado por causa da arquitetura distribuída do Amazon Location Service. Na maioria dos casos, a contagem deve ser próxima da quantidade real de operações de API enviadas.

### Métricas do Amazon Location Service
<a name="service-metrics"></a>

A seguir estão as métricas para as quais o Amazon Location Service exporta CloudWatch no `AWS/Location` namespace.


| Métrica | Description | Dimensões | 
| --- | --- | --- | 
|  `CallCount`  |  O número de chamadas feitas para um determinado endpoint da API.  Estatística válida: soma Unidades: contagem  |  OperationName OperationName, ResourceName ApiKeyName, OperationName ApiKeyName, OperationName, ResourceName OperationName, OperationVersion OperationName, OperationVersion, ResourceName ApiKeyName, OperationName, OperationVersion ApiKeyName, OperationName, OperationVersion, ResourceName  | 
|  `ErrorCount`  |  O número de respostas de erro de chamadas feitas para um determinado endpoint de API. Estatística válida: soma Unidades: contagem  |  OperationName OperationName, ResourceName ApiKeyName, OperationName ApiKeyName, OperationName, ResourceName  | 
|  `SuccessCount`  |  O número de chamadas bem-sucedidas feitas para um determinado endpoint da API.  Estatística válida: soma Unidades: contagem  |  OperationName OperationName, ResourceName ApiKeyName, OperationName ApiKeyName, OperationName, ResourceName  | 
|  `CallLatency`  |  A quantidade de tempo que a operação leva para processar e retornar uma resposta quando uma chamada é feita para um determinado endpoint da API. Estatística válida: média Unidade: milissegundos  |  OperationName OperationName, ResourceName ApiKeyName, OperationName ApiKeyName, OperationName, ResourceName  | 

### Dimensões para métricas do Amazon Location Service
<a name="service-dimensions"></a>

Você pode usar as dimensões na tabela a seguir para filtrar métricas do Amazon Location Service.


| Dimensão | Description | 
| --- | --- | 
|  OperationName   |  Filtra as métricas do Amazon Location para operação de API com o nome da operação especificado.  | 
|  OperationName, ResourceName  |  Filtra as métricas do Amazon Location para operação de API com o nome da operação especificado e o nome do recurso.  | 
|  ApiKeyName, OperationName  |  Filtra as métricas do Amazon Location para operação de API com o nome da operação especificado, usando o nome da chave de API determinado.  | 
|  ApiKeyName, OperationName, ResourceName  |  Filtra as métricas do Amazon Location para operação de API com o nome da operação especificado, o nome do recurso e usando o nome da chave de API determinado.  | 
|  OperationName, OperationVersion  |  Filtra as métricas do Amazon Location para operação de API com o nome da operação especificado.  Mapas, lugares e rotas independentes do Amazon Location Service serão métricas de exportação para essa dimensão.   | 
|  OperationName, OperationVersion, ResourceName   |  Filtra as métricas do Amazon Location para operação de API com o nome da operação especificado, a versão e o nome do recurso do Amazon Location.  Mapas, lugares e rotas independentes do Amazon Location serão métricas de exportação para essa dimensão.   | 
|  ApiKeyName, OperationName, OperationVersion  |  Filtra as métricas do Amazon Location para operação de API com o nome da operação, a versão e usando o nome da chave de API determinado.  Mapas, lugares e rotas independentes do Amazon Location serão métricas de exportação para essa dimensão.   | 
|  ApiKeyName, OperationName, OperationVersion, ResourceName   |  Filtra as métricas do Amazon Location para operação de API com o nome da operação, a versão, o nome do recurso e usando o nome da chave de API determinado.  Mapas, lugares e rotas independentes do Amazon Location serão métricas de exportação para essa dimensão.   | 

## Ver indicadores do Amazon Location Service
<a name="view-metrics"></a>

Você pode visualizar as métricas do Amazon Location Service no Amazon CloudWatch console ou usando a Amazon CloudWatch API.

**Para visualizar métricas usando o CloudWatch console**

**Example**  

1. Abra o CloudWatch console em [https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/).

1. No painel de navegação, selecione **Métricas**.

1. Na **guia Todos os Indicadores**, escolha o namespace **Location**.

1. Selecione o tipo de indicador que você deseja visualizar.

1. Selecione um indicador para adicioná-lo ao gráfico.
Para obter mais informações, consulte [Exibir métricas disponíveis](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/viewing_metrics_with_cloudwatch.html) no *Guia CloudWatch do usuário da Amazon*. 

## Crie CloudWatch alarmes para as métricas do Amazon Location Service
<a name="create-alarms"></a>

Você pode usar CloudWatch para definir alarmes em suas métricas do Amazon Location Service. Por exemplo, você pode criar um alarme CloudWatch para enviar um e-mail sempre que ocorrer um pico na contagem de erros. 

Os tópicos a seguir fornecem uma visão geral de alto nível sobre como definir alarmes usando o CloudWatch. Para obter instruções detalhadas, consulte Como [usar alarmes](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch_Alarms.html) no *Guia do CloudWatch usuário da Amazon*. 

**Para definir alarmes usando o console CloudWatch **

**Example**  

1. Abra o CloudWatch console em [https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/).

1. No painel de navegação, selecione **Alarme**.

1. Escolha **Criar Alarm**.

1. Escolha **Selecionar métrica**.

1. Na guia **Todos os indicadores**, selecione o namespace **Location**.

1. Selecione uma categoria de indicador.

1. Encontre a linha com o indicador para o qual você deseja criar um alarme e marque a caixa de seleção ao lado dessa linha.

1. Escolha **Selecionar métrica**.

1. Em **Indicador**, preencha os valores.

1. Especifique as **Condições** do alarme.

1. Escolha **Próximo**.

1. Se você quiser enviar uma notificação quando as condições do alarme forem atendidas:
   + Em **Acionador do estado do alarme**, selecione o estado do alarme para solicitar o envio de uma notificação.
   + Em **Selecione um tópico do SNS**, escolha **Criar novo tópico** para criar um novo tópico do Amazon Simple Notification Service (Amazon SNS). Insira o nome do tópico e o e-mail para o qual enviar a notificação. 
   + Em **Enviar uma notificação para** inserir endereços de e-mail adicionais para os quais enviar a notificação.
   + Escolha **Adicionar notificação**. Essa lista é salva e aparece no campo para alarmes futuros.

1. Ao concluir, escolha **Next (Avançar)**.

1. Insira um nome e uma descrição para o alarme e selecione **Avançar**.

1. Confirme os detalhes do alarme e escolha **Avançar**.

**nota**  
Se você criar um novo tópico do Amazon SNS, o endereço de e-mail deverá ser verificado para que recebam notificações. Se o e-mail não for verificado, a notificação não será recebida quando um alarme for iniciado por uma mudança de estado.

Para obter mais informações sobre como definir alarmes usando o CloudWatch console, consulte [Criar um alarme que envia e-mail](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch_Alarms.html) no *Guia do CloudWatch usuário da Amazon*. 

## Use CloudWatch para monitorar o uso em relação às cotas
<a name="alarms-on-quotas"></a>

Você pode criar CloudWatch alarmes da Amazon para notificá-lo quando a utilização de uma determinada cota exceder um limite configurável. Isso permite que você reconheça quando está próximo dos limites de cota e adapte sua utilização para evitar custos excessivos ou solicite um aumento de cota, se necessário. 

*Para obter informações sobre como usar CloudWatch para monitorar cotas, consulte [Visualizando suas cotas de serviço e definindo alarmes no Guia do usuário](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Quotas-Visualize-Alarms.html) da Amazon. CloudWatch *

## CloudWatch exemplos de métricas para Amazon Location Service
<a name="example-alarms"></a>

Você pode usar a [GetMetricData](https://docs.aws.amazon.com/AmazonCloudWatch/latest/APIReference/API_GetMetricData.html)API para recuperar métricas para Amazon Location. 
+ Por exemplo, você pode monitorar `CallCount` e definir um alarme para quando ocorrer uma queda no número. 

  O monitoramento dos indicadores `CallCount` para `SendDeviceLocation` pode ajudar a dar uma perspectiva sobre os ativos rastreados. Se a `CallCount` cair, significa que os ativos rastreados, como uma frota de caminhões, pararam de enviar suas localizações atuais. Configurar um alarme para isso pode ajudar a notificá-lo de que um problema ocorreu.
+ Em outro exemplo, você pode monitorar `ErrorCount` e definir um alarme para quando ocorrer um aumento no número.

  Os rastreadores devem estar associados a coleções de geocercas para que as localizações dos dispositivos sejam avaliadas em relação às geocercas. Se você tem uma frota de dispositivos que exige atualizações contínuas de localização, ver o valor `CallCount` para `BatchEvaluateGeofence` ou `BatchPutDevicePosition` cair para zero indica que as atualizações não estão mais fluindo.

A seguir está um exemplo de saída [GetMetricData](https://docs.aws.amazon.com/AmazonCloudWatch/latest/APIReference/API_GetMetricData.html)com as métricas para `CallCount` e `ErrorCount` para a criação de recursos de mapa.

```
{
"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"
      }
    }
  ]
}
```

# Monitore e registre com AWS CloudTrail
<a name="cloudtrail"></a>

AWS CloudTrail é um serviço que fornece um registro das ações realizadas por um usuário, função ou AWS serviço. CloudTrail registra todas as chamadas de API como eventos. Você pode usar o Amazon Location Service com CloudTrail para monitorar suas chamadas de API, que incluem chamadas do console do Amazon Location Service e chamadas de AWS SDK para as operações de API do Amazon Location Service. 

CloudTrail é ativado automaticamente quando você cria sua AWS conta. Quando a atividade ocorre no Amazon Location Service, essa atividade é registrada em um CloudTrail evento junto com outros eventos do AWS serviço no **histórico de eventos**. Você pode ver, pesquisar e baixar o histórico de eventos dos últimos 90 dias por AWS região.

Para obter mais informações sobre CloudTrail, consulte o [Guia AWS CloudTrail do usuário](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/). Não há CloudTrail cobrança pela visualização do **histórico de eventos**.

Para registros contínuos de eventos em sua AWS conta nos últimos 90 dias, incluindo eventos do Amazon Location Service, crie uma trilha ou um armazenamento de dados [CloudTrail Lake](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-lake.html).

**CloudTrail trilhas**

Uma trilha permite CloudTrail entregar arquivos de log para um bucket do Amazon S3. Quando você cria uma trilha em Console de gerenciamento da AWS, a trilha se aplica a todas as AWS regiões. A trilha registra eventos de todas as regiões na AWS partição e entrega os arquivos de log ao bucket do S3 que você especificar. Além disso, você pode configurar outros AWS serviços para analisar e agir com base nos dados de eventos coletados nos CloudTrail registros. 

Para obter mais informações sobre como criar uma trilha, consulte [Visão geral da criação de uma trilha](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-create-and-update-a-trail.html). 

Para obter uma lista de serviços e integrações CloudTrail compatíveis, consulte [Serviços e integrações CloudTrail compatíveis](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-aws-service-specific-topics.html#cloudtrail-aws-service-specific-topics-integrations).

Você pode entregar uma cópia dos seus eventos de gerenciamento contínuos para o bucket do Amazon S3 sem nenhum custo CloudTrail criando uma trilha. No entanto, há cobranças de armazenamento do Amazon S3. 

Para obter mais informações sobre CloudTrail preços, consulte [AWS CloudTrail preços](https://aws.amazon.com/cloudtrail/pricing/).

Para receber informações sobre a definição de preços do Amazon S3, consulte [Definição de preços do Amazon S3](https://aws.amazon.com/s3/pricing/).

**CloudTrail Armazenamentos de dados de eventos em Lake**

CloudTrail O Lake permite que você execute consultas baseadas em SQL em seus eventos. Os eventos são agregados em *armazenamentos de dados de eventos*, que são coleções imutáveis de eventos baseados nos critérios selecionados com a aplicação de [seletores de eventos avançados](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-lake-concepts.html#adv-event-selectors). Os seletores que aplicados a um armazenamento de dados de eventos controlam quais eventos persistem e estão disponíveis para consulta. 

Para obter mais informações sobre o CloudTrail Lake, consulte [Trabalhando com o AWS CloudTrail Lake](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-lake.html).

CloudTrail Os armazenamentos e consultas de dados de eventos em Lake incorrem em custos. Ao criar um armazenamento de dados de eventos, você escolhe a [opção de preço](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-lake-manage-costs.html#cloudtrail-lake-manage-costs-pricing-option) que deseja usar para ele. A opção de preço determina o custo para a ingestão e para o armazenamento de eventos, e o período de retenção padrão e máximo para o armazenamento de dados de eventos. 

Para obter mais informações sobre CloudTrail preços, consulte [AWS CloudTrail preços](https://aws.amazon.com/cloudtrail/pricing/).

**Topics**
+ [Eventos de gerenciamento de localização da Amazon em CloudTrail](#cloudtrail-management-events)
+ [Eventos de dados de localização da Amazon em CloudTrail](#cloudtrail-data-events)
+ [Saiba mais sobre entradas do arquivo de log do Amazon Location Service](#cloudtrail-log-entries)
+ [Exemplo: entrada de arquivo de CloudTrail log para um evento de gerenciamento de localização da Amazon](#cloudtrail-management-event-example)
+ [Exemplo: entrada de arquivo de CloudTrail log para um evento de dados de localização da Amazon](#cloudtrail-data-event-example)

## Eventos de gerenciamento de localização da Amazon em CloudTrail
<a name="cloudtrail-management-events"></a>

Você pode visualizar os eventos de gerenciamento de localização da Amazon em seu histórico de CloudTrail eventos. Esses eventos incluem todas as chamadas de API que gerenciam recursos e configurações do Amazon Location. Para obter uma lista completa das ações permitidas, consulte as [referências de API do Amazon Location Service](https://docs.aws.amazon.com/location/latest/APIReference/Welcome.html). 

## Eventos de dados de localização da Amazon em CloudTrail
<a name="cloudtrail-data-events"></a>

 Os eventos de dados fornecem informações sobre as operações realizadas diretamente em um recurso. Esses eventos, também conhecidos como operações de plano de dados, podem ser de alto volume. Por padrão, CloudTrail não registra eventos de dados e o Histórico de CloudTrail eventos não os registra. São geradas cobranças adicionais ao habilitar eventos de dados. Para obter mais informações sobre CloudTrail preços, consulte os [ CloudTrailpreços da AWS](https://aws.amazon.com/cloudtrail/pricing/). 

 Você pode escolher quais tipos de recursos de localização da Amazon registram eventos de dados usando o CloudTrail console, o AWS CLI ou as operações de CloudTrail API. Para consultar instruções sobre como habilitar e gerenciar eventos de dados, acesse [Registrar eventos de dados em log com o Console de Gerenciamento da AWS](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/logging-data-events-with-cloudtrail.html#logging-data-events-console) e [Registrar eventos de dados em log com a Interface da linha de comando da AWS](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/logging-data-events-with-cloudtrail.html#creating-data-event-selectors-with-the-AWS-CLI). 

A tabela a seguir lista os tipos de recursos do Amazon Location para os quais você pode registrar eventos de dados em log:


**Eventos de dados permitidos no Amazon Location**  

| Tipo de evento de dados (console) | valor resources.type | Dados APIs registrados em CloudTrail | 
| --- | --- | --- | 
| Mapas geográficos | AWS::GeoMaps::Provider | Veja a referência da [GeoMaps API da](https://docs.aws.amazon.com/location/latest/APIReference/Welcome.html#Welcome_Amazon_Location_Service_Maps) Amazon | 
| Locais geográficos | AWS::GeoPlaces::Provider | Veja a referência da [GeoPlaces API da](https://docs.aws.amazon.com/location/latest/APIReference/Welcome.html#Welcome_Amazon_Location_Service_Places) Amazon | 
| Rotas geográficas | AWS::GeoRoutes::Provider | Veja a referência da [GeoRoutes API da](https://docs.aws.amazon.com/location/latest/APIReference/Welcome.html#Welcome_Amazon_Location_Service_Routes) Amazon | 

**nota**  
A Amazon Location não publica CloudTrail eventos para os seguintes GeoMaps APIs: `GetStyleDescriptor``GetGlyphs`, `GetSprites` e. Eles APIs são gratuitos e não exigem autenticação. 

 É possível configurar seletores de eventos avançados para filtrar eventos por `eventName`, `readOnly` e `resources.ARN`. Assim, você registra somente os eventos que considerar mais importantes. Para obter mais informações, consulte [ AdvancedFieldSelector ](https://docs.aws.amazon.com/awscloudtrail/latest/APIReference/API_AdvancedFieldSelector.html). 

## Saiba mais sobre entradas do arquivo de log do Amazon Location Service
<a name="cloudtrail-log-entries"></a>

 Quando você configura uma trilha, CloudTrail entrega eventos como arquivos de log para um bucket do S3 que você especifica ou para o Amazon CloudWatch Logs. Para obter mais informações, consulte Como [trabalhar com arquivos de CloudTrail log](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-working-with-log-files.html) no Guia AWS CloudTrail do usuário. 

 CloudTrail os arquivos de log podem conter uma ou mais entradas de log. Cada evento representa uma única solicitação de qualquer origem e inclui informações sobre a operação solicitada, a data e a hora da operação, os parâmetros de solicitação, entre outros. 

**nota**  
CloudTrail os arquivos de log não são um rastreamento de pilha ordenado de chamadas de API. Eles não são exibidos em ordem cronológica. Para determinar a ordem das operações, use `[eventTime](https://docs.aws.amazon.com/awscloudtrail/latest/APIReference/API_Event.html)`. 

 Cada evento ou entrada de log contém informações sobre o solicitante. As informações de identidade ajudam a determinar: 
+ Se a solicitação foi feita com credenciais de usuário da raiz ou do .
+ Se a solicitação foi feita com credenciais de segurança temporárias de uma função ou de um usuário federado.
+ Se a solicitação foi feita por outro AWS serviço.

## Exemplo: entrada de arquivo de CloudTrail log para um evento de gerenciamento de localização da Amazon
<a name="cloudtrail-management-event-example"></a>

 O exemplo a seguir mostra uma entrada de CloudTrail registro para a `CreateTracker` operação, que cria um recurso de rastreador. 

```
{
    "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"
}
```

## Exemplo: entrada de arquivo de CloudTrail log para um evento de dados de localização da Amazon
<a name="cloudtrail-data-event-example"></a>

 O exemplo a seguir mostra uma entrada de CloudTrail registro da `Geocode` operação, que recupera coordenadas, endereços e outros detalhes sobre um local. 

```
{
  "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"
}
```

# Práticas recomendadas
<a name="integration-best-practice"></a>

A seguir estão algumas das práticas recomendadas para a integração com o Amazon Location Service.

## Gerenciamento de recursos
<a name="resource-best-practice"></a>

Para ajudar a gerenciar com eficiência os seus recursos de localização no Amazon Location Service, considere as seguintes práticas recomendadas:

**nota**  
As práticas recomendadas a seguir se aplicam aos recursos autônomos usados com a APIs v1. Os Mapas, Locais e Rotas v2 APIs não exigem a criação de recursos.
+ Use endpoints regionais que sejam fundamentais para a sua base de usuários esperada e para melhorar a experiência deles. Para obter mais informações sobre os endpoints da região, consulte [Regiões do Amazon Location](location-regions.md).
+ Para recursos que usam provedores de dados, como recursos de mapas e recursos de índice de local, lembre-se de seguir o contrato de termos de uso do provedor de dados específico. Para obter mais informações, consulte [Termos de uso e atribuição de dados](data-attribution.md).
+ Minimize a criação de recursos utilizando um recurso para cada configuração de mapa, índice de lugares, ou rotas. Em uma região, você normalmente precisa de apenas um recurso por provedor de dados ou estilo de mapa. A maioria dos aplicativos usa recursos existentes e não cria recursos em tempo de execução (run time).
+ Ao usar recursos diferentes em um único aplicativo, como um recurso de mapa e uma calculadora de rotas, use o mesmo provedor de dados em cada recurso para garantir que os dados se correspondam. Por exemplo, que uma geometria de rota que você cria com a sua calculadora de rotas esteja alinhada com as ruas no mapa desenhado pelo recurso de mapas.

## Faturamento e gerenciamento de custos
<a name="cost-best-practice"></a>

Para ajudar a gerenciar seus custos e seu faturamento, considere as seguintes práticas recomendadas:
+ Use ferramentas de monitoramento, como a Amazon CloudWatch, para rastrear seu uso de recursos. Você pode definir alertas que notificam você quando o uso estiver prestes a exceder os limites especificados. Para obter mais informações, consulte [Criação de um alarme de cobrança para monitorar suas AWS cobranças estimadas](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/monitor_estimated_charges_with_cloudwatch.html) no *Guia do CloudWatch usuário da Amazon*.

## Cotas e uso
<a name="quota-best-practice"></a>

Você Conta da AWS inclui cotas que definem um limite padrão para sua quantidade de uso. Você pode configurar alarmes para alertar você quando o seu uso estiver próximo do limite e solicitar um aumento a uma cota, quando precisar. Para obter mais informações sobre como trabalhar com cotas, consulte os tópicos a seguir.
+ [Gerenciar cotas com o Service Quotas](manage-quotas.md)
+ [Crie CloudWatch alarmes para as métricas do Amazon Location Service](cloudwatch.md#create-alarms)
+ [Visualizando suas cotas de serviço e definindo alarmes no Guia](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Quotas-Visualize-Alarms.html) do usuário da *Amazon CloudWatch *.

Você pode criar alarmes para avisar com antecedência quando você estiver perto de exceder seus limites. Recomendamos definir alarmes para cada cota em cada Região da AWS local em que você usa a Amazon Location. Por exemplo, você pode monitorar o seu uso da operação `SearchPlaceIndexForText` e criar um alarme quando você exceder 80% da sua cota atual.

Ao receber um aviso de alarme sobre sua cota, você deve decidir o que fazer. Talvez você esteja usando recursos adicionais porque a sua base de clientes cresceu. Nesse caso, talvez você queira solicitar um aumento da sua cota, como um aumento de 50% na cota para uma chamada pela API naquela região. Ou talvez haja um erro no seu serviço que leve você a fazer chamadas adicionais desnecessárias para o Amazon Location. Nesse caso, talvez você deva resolver o problema com a sua operadora.