Amazon Location Service - Getting Started with First Map App

` em seu HTML para conter o mapa. Você pode estilizar `

` em seu CSS para definir dimensões conforme necessário para sua aplicação. Você deve baixar o arquivo CSS,`style.css`, do nosso GitHub repositório. Isso ajudará você a se concentrar na lógica de negócios. Salve os arquivos `style.css` e `index.html` na mesma pasta. Baixe o `style.css` arquivo em [GitHub](https://github.com/aws-geospatial/amazon-location-samples-js/blob/quick_start_sample_js/quick-start/style.css). ```

``` #### Adicionar detalhes da chave de API e AWS da região Adicione a chave de API que você criou [Usar chaves de API para se autenticar](using-apikeys.md) a esse arquivo, junto com a AWS região em que a chave foi criada. ``` ..... .....

``` ### Adicionar um mapa à aplicação Nesta seção, vamos adicionar recursos de mapa à aplicação. Antes de começar, seus arquivos devem estar nesta estrutura de pastas. Se ainda não tiver feito isso, baixe o `style.css` arquivo em [GitHub](https://github.com/aws-geospatial/amazon-location-samples-js/blob/quick_start_sample_js/quick-start/style.css). ``` |---FirstApp [Folder] |-------------- index.html [File] |-------------- style.css [File] ``` #### Criar uma função para inicializar o mapa Para configurar seu mapa, crie a função `initializeMap(...)` depois da linha `//Add functions`. Escolha uma localização central inicial e um nível de zoom. Neste exemplo, definimos o centro do mapa como Vancouver, Canadá, com nível de zoom 10. Adicione controles de navegação para facilitar o zoom. ``` /** * Initializes the map with the specified style and color scheme. */ function initializeMap(mapStyle = "Standard", colorScheme = "Dark") { const styleUrl = `https://maps.geo.${AWS_REGION}.amazonaws.com/v2/styles/${mapStyle}/descriptor?key=${API_KEY}&color-scheme=${colorScheme}`; const map = new maplibregl.Map({ container: 'map', // The ID of the map container style: styleUrl, // The style URL for the map center: [-123.116226, 49.246292], // Starting center coordinates zoom: 10, // Initial zoom level validateStyle: false // Disable style validation }); return map; // Return the initialized map } ``` #### Inicializar o mapa Chame `initializeMap(...)` para inicializar o mapa. Você também pode inicializá-lo com seu estilo e esquema de cores preferidos após a função `initializeMap`. Para obter mais opções de estilo, consulte [AWS estilos e recursos do mapa](map-styles.md). ``` // Step 1: Setup API Key and AWS Region const API_KEY = "Your_API_Key"; const AWS_REGION = "Region_where_you_created_API_Key"; // Step 2.1 Add maps to application // Step 2.2 initialize the map const map = initializeMap("Standard","Light"); // Step 3: Add places features to application ``` Abra `index.html` em um navegador para ver o mapa em ação. #### Adicionar controle de navegação Como opção, você pode adicionar controles de navegação (zoom e rotação) ao mapa. Faça isso depois de chamar `initializeMap(...)`. ``` // Step 2.1 initialize the map const map = initializeMap("Standard","Light"); // Step 2.2 Add navigation controls to the map map.addControl(new maplibregl.NavigationControl()); // Step 3: Add places features to application ``` #### Revisar o código do mapa Parabéns\$1 Sua primeira aplicação está pronta para usar um mapa. Em um navegador, abra `index.html`. Verifique se `style.css` está na mesma pasta que `index.html`. O arquivo HTML final deve estar assim: ``` Amazon Location Service - Getting Started with First Map App

``` ### Adicionar locais à aplicação Nesta seção, vamos configurar recursos de locais à aplicação. Baixe o JavaScript arquivo em GitHub, [https://github.com/aws-geospatial/amazon-location-samples-js/blob/quick_start_sample_js/quick-start/utils.js](https://github.com/aws-geospatial/amazon-location-samples-js/blob/quick_start_sample_js/quick-start/utils.js). Antes de começar, seus arquivos devem estar nesta estrutura de pastas: ``` |---FirstApp [Folder] |-------------- index.html [File] |-------------- style.css [File] |-------------- utils.js [File] ``` #### Criar função para criar GeoPlaces Para adicionar funcionalidades de pesquisa, inicialize a classe `GeoPlaces` usando `AuthHelper` e `AmazonLocationClient`. Adicione a função `getGeoPlaces(map)` a seguir antes da tag `` em `index.html`. ``` /** * Gets a GeoPlaces instance for Places operations. */ function getGeoPlaces(map) { const authHelper = amazonLocationClient.withAPIKey(API_KEY, AWS_REGION); // Authenticate using the API key and AWS region const locationClient = new amazonLocationClient.GeoPlacesClient(authHelper.getClientConfig()); // Create a GeoPlaces client const geoPlaces = new GeoPlaces(locationClient, map); // Create GeoPlaces instance return geoPlaces; // Return the GeoPlaces instance } ``` #### Criar função para adicionar a caixa de pesquisa à aplicação Adicione as funções `addSearchBox(map, geoPlaces)`, `renderPopup(feature)` e `createPopup(feature)` antes da tag `` em `index.html` para concluir a configuração da funcionalidade de pesquisa. ``` /** * Adds search box to the map. */ function addSearchBox(map, geoPlaces) { const searchBox = new MaplibreGeocoder(geoPlaces, { maplibregl, showResultsWhileTyping: true, // Show results while typing debounceSearch: 300, // Debounce search requests limit: 30, // Limit number of results popuprender: renderPopup, // Function to render popup reverseGeocode: true, // Enable reverse geocoding zoom: 14, // Zoom level on result selection placeholder: "Search text or nearby (lat,long)" // Placeholder text for search box. }); // Add the search box to the map map.addControl(searchBox, 'top-left'); // Event listener for when a search result is selected searchBox.on('result', async (event) => { const { id, result_type } = event.result; // Get result ID and type if (result_type === "Place") { // Check if the result is a place const placeResults = await geoPlaces.searchByPlaceId(id); // Fetch details for the selected place if (placeResults.features.length) { createPopup(placeResults.features[0]).addTo(map); // Create and add popup for the place } } }); } /** * Renders the popup content for a given feature. */ function renderPopup(feature) { return ` `; } /** * Creates a popup for a given feature and sets its position. */ function createPopup(feature) { return new maplibregl.Popup({ offset: 30 }) // Create a new popup .setLngLat(feature.geometry.coordinates) // Set the popup position .setHTML(renderPopup(feature)); // Set the popup content } ``` #### Adicionar caixa de pesquisa à aplicação Crie um objeto `GeoPlaces` chamando `getGeoPlaces(map)`, conforme definido na Seção 3.1, depois chame `addSearchBox(map, geoPlaces)` para adicionar a caixa de pesquisa à aplicação. ``` // Step 2: Add maps to application // Step 2.1 initialize the map const map = initializeMap("Standard","Light"); // Step 2.2 Add navigation controls to the map map.addControl(new maplibregl.NavigationControl()); // Step 3: Add places feature to application // Step 3.1: Get GeoPlaces instance. It will be used for adding search box and map click functionality const geoPlaces = getGeoPlaces(map); // Step 3.2: Add search box to the map addSearchBox(map, geoPlaces); ``` A pesquisa de local está pronta para ser usada. Abra `index.html` em um navegador para vê-la em ação. #### Adicionar função para mostrar pop-up quando o usuário clicar no mapa Crie uma função `addMapClick(map, geoPlaces)` para exibir um pop-up quando o usuário clicar no mapa. Adicione essa função logo antes da tag ``. ``` /** * Sets up reverse geocoding on map click events. */ function addMapClick(map, geoPlaces) { map.on('click', async ({ lngLat }) => { // Listen for click events on the map const response = await geoPlaces.reverseGeocode({ query: [lngLat.lng, lngLat.lat], limit: 1, click: true }); // Perform reverse geocoding if (response.features.length) { // If there are results const clickMarker = new maplibregl.Marker({ color: "orange" }); // Create a marker const feature = response.features[0]; // Get the clicked feature const clickedPopup = createPopup(feature); // Create popup for the clicked feature clickMarker.setLngLat(feature.geometry.coordinates) // Set marker position .setPopup(clickedPopup) // Attach popup to marker .addTo(map); // Add marker to the map clickedPopup.on('close', () => clickMarker.remove()).addTo(map); // Remove marker when popup is closed } }); } ``` #### Chamar função para adicionar atributo de clique no mapa Para ativar a ação de clique no mapa, chame `addMapClick(map, geoPlaces)` depois da linha que contém `addSearchBox(map, geoPlaces)`. ``` // Step 3: Add places feature to application // Step 3.1: Get GeoPlaces instance. It will be used for adding search box and map click functionality const geoPlaces = getGeoPlaces(map); // Step 3.2: Add search box to the map addSearchBox(map, geoPlaces); // Step 3.3: Setup map click functionality addMapClick(map, geoPlaces); ``` #### Revisar a aplicação de Mapas e Locais Parabéns\$1 Sua primeira aplicação está pronta para usar Mapas e Locais. Em um navegador, abra `index.html`. Verifique se `style.css` e `utils.js` estão na mesma pasta com `index.html`. O arquivo HTML final deve estar assim: ``` Amazon Location Service - Getting Started with First Map App

``` ### Explorar mais Você concluiu o tutorial de início rápido e deve ter uma ideia de como o Amazon Location Service é usado para criar aplicativos. Para aproveitar melhor o Amazon Location, você pode conferir os seguintes recursos: + **Detalhes da sugestão de consulta**: estenda a classe `GeoPlaces` ou use uma abordagem semelhante a `ReverseGeocode` para obter mais detalhes sobre os resultados retornados pela API `Suggestion`. + **Escolha a API certa para as necessidades da sua empresa**: para determinar a melhor API do Amazon Location para suas necessidades, confira este recurso: [Escolher a API certa](choose-an-api.md). + **Consulte os guias de “instruções” do Amazon Location**: acesse o [Guia do desenvolvedor do Amazon Location Service](https://docs.aws.amazon.com/location/) para encontrar tutoriais e mais recursos. + **Documentação e informações sobre o produto**: para ver a documentação completa, acesse o [Guia do desenvolvedor do Amazon Location Service](https://docs.aws.amazon.com/location/). Para saber mais sobre o produto, acesse a página do [produto Amazon Location Service](https://aws.amazon.com/location). # Criar sua primeira aplicação de Geocercas e Rastreadores Nesta seção, você criará uma aplicação que demonstra os principais atributos do uso das geocercas e rastreadores do Amazon Location. Os aplicativos demonstram como um rastreador e uma cerca geográfica interagem usando uma combinação dos recursos Lambda AWS IoT e Amazon Location. Escolha a plataforma iOS ou Android para começar. Antes de começar a criar a aplicação, siga os procedimentos em [Usar o console do Amazon Location Service para se autenticar](set-up-auth.md) para conceder o acesso apropriado. **Topics** + [Criar uma aplicação do iOS](ios-geofence-app.md) + [Criar um aplicativo Android](android-geofence-app.md) # Criar uma aplicação do iOS Siga estes procedimentos para criar uma aplicação para iOS usando o Amazon Location Service. Clone os arquivos do projeto de [GitHub](https://github.com/aws-geospatial/amazon-location-samples-ios/tree/main/tracking-with-geofence-notifications). ## Criar recursos do Amazon Location para sua aplicação Você pode gerar recursos do Amazon Location Service quando sua AWS conta estiver pronta. Esses recursos serão essenciais para a execução dos trechos de código fornecidos. **nota** Se você ainda não criou uma AWS conta, [crie uma AWS conta](https://portal.aws.amazon.com/billing/signup#/start/email). Para começar, você precisará criar um ID de banco de identidades do Amazon Cognito, use o seguinte procedimento: 1. No AWS console, navegue até o serviço Amazon Cognito, selecione **grupos de identidades** no menu do lado esquerdo e selecione **Criar grupo de identidades**. 1. Verifique se a opção **Acesso de convidado** está marcada e pressione **Avançar** para continuar. 1. Escolha um perfil do IAM existente ou crie um novo. 1. Insira o nome do banco de identidades e certifique-se de que o banco de identidades tenha acesso aos recursos de `(geo)` do Amazon Location para o mapa e o rastreador que você criará no próximo procedimento. 1. Agora você precisa criar e estilizar um mapa no console de localização da AWS Amazon, use o seguinte procedimento: 1. Navegue até a [seção Mapas](https://console.aws.amazon.com/location/maps/home) do console do Amazon Location e selecione **Criar mapa** para visualizar os estilos de mapa disponíveis. 1. Dê um **nome** e uma **descrição** ao novo recurso de mapa. Registre o nome que você atribuir ao recurso de mapa, conforme ele será usado posteriormente no tutorial. 1. Ao escolher um estilo de mapa, considere o provedor de dados do mapa. Consulte a seção 82 dos [Termos de serviço da AWS](https://aws.amazon.com/service-terms) para obter mais detalhes. 1. Aceite os [Termos e condições do Amazon Location](https://aws.amazon.com/service-terms/#:~:text=82.%20Amazon%20Location%20Service) e selecione **Criar mapa**. Após criar o mapa, você pode interagir com ele ampliando, reduzindo o zoom ou fazendo uma panorâmica em qualquer direção. Para criar um rastreador usando o console do Amazon Location 1. Abra o console do [Amazon Location Service](https://console.aws.amazon.com/location/). 1. No painel de navegação à esquerda, selecione **Rastreadores**. 1. Selecione **Criar rastreador**. 1. Preencha os campos obrigatórios: 1. Em **Filtragem de posições**, escolha a opção que melhor se adequa à forma como você pretende usar seu recurso de rastreador. Se você não definir a filtragem de posição, a configuração padrão será. TimeBased Para obter mais informações, consulte Trackers neste guia e PositionFiltering na Amazon Location Service Trackers API Reference. 1. Escolha **Criar rastreador** para finalizar. ## Criar uma coleção de geocercas Quando for criar uma coleção de geocercas, você pode usar o console, a API ou a CLI. Os procedimentos a seguir demonstram esse processo. Para criar uma coleção de geocercas usando o console Amazon Location: 1. Abra o console do Amazon Location Service em https://console.aws.amazon.com/location/. 1. No painel de navegação à esquerda, selecione Coleções de geocercas. 1. Selecione Criar coleção de geocercas. 1. Forneça um nome e uma descrição para a coleção. 1. Em EventBridge regra com CloudWatch como destino, você pode criar uma EventBridge regra opcional para começar a reagir aos eventos de delimitação geográfica. Isso permite que o Amazon Location publique eventos no Amazon CloudWatch Logs. 1. Selecione Criar coleção de geocercas. Crie uma coleção de cercas geográficas usando a localização da Amazon: APIs Use a CreateGeofenceCollection operação da Amazon Location Geofences APIs. O exemplo a seguir usa uma solicitação de API para criar uma coleção de geocercas chamada `GOECOLLECTION_NAME`. ``` POST /geofencing/v0/collections Content-type: application/json { "CollectionName": "GOECOLLECTION_NAME", "Description": "Geofence collection 1 for shopping center", "Tags": { "Tag1" : "Value1" } } ``` Crie uma coleção de cercas geográficas usando AWS CLI os comandos: Use o comando create-geofence-collection. O exemplo a seguir usa uma AWS CLI para criar uma coleção de geocercas chamada `GOECOLLECTION_NAME`. ``` aws location \ create-geofence-collection \ --collection-name "GOECOLLECTION_NAME" \ --description "Shopping center geofence collection" \ --tags Tag1=Value1 ``` ## Vincule um rastreador a uma coleção de geocercas Para vincular um rastreador a uma coleção de geocercas, você pode usar o console, a API ou a CLI. Os procedimentos a seguir demonstram esse processo. Vincular um recurso de rastreador a uma coleção de geocercas usando o console do Amazon Location Service: 1. Abra o console do Amazon Location. 1. No painel de navegação à esquerda, selecione **Rastreadores**. 1. Em **Rastreadores de dispositivos**, selecione o link do nome do rastreador de destino. 1. Em **Coleções de geocercas vinculadas**, selecione **Vincular coleção de geocercas**. 1. Na janela **Coleção de geocercas vinculadas**, selecione uma coleção de geocercas no menu suspenso. 1. Escolha **Vincular**. 1. Depois de vincular o recurso de rastreador, ele receberá um status de Ativo. Vincule um recurso rastreador a uma coleção de cercas geográficas usando a localização da Amazon: APIs Use a `` AsssociateTrackerConsumer operação dos Amazon Location Trackers APIs. O exemplo a seguir usa uma solicitação de API ExampleTracker associada a uma coleção de cercas geográficas usando seu Amazon Resource Name (ARN). ``` POST /tracking/v0/trackers/ExampleTracker/consumers Content-type: application/json { "ConsumerArn": "arn:aws:geo:us-west-2:123456789012:geofence-collection/GOECOLLECTION_NAME" } ``` Vincule um recurso de rastreador a uma coleção de geocercas usando comandos da AWS CLI : Use o comando `associate-tracker-consumer `. O exemplo a seguir usa um AWS CLI para criar uma coleção de geofence chamada. `GOECOLLECTION_NAME` ``` aws location \ associate-tracker-consumer \ --consumer-arn "arn:aws:geo:us-west-2:123456789012:geofence-collection/GOECOLLECTION_NAME" \ --tracker-name "ExampleTracker" ``` ## Use o AWS Lambda com o MQTT Crie uma função do Lambda: Para criar uma conexão entre AWS IoT Core o Amazon Location Service, você precisa de uma AWS Lambda função para processar mensagens encaminhadas por EventBridge CloudWatch eventos. Essa função extrairá todos os dados posicionais, os formatará para o Amazon Location Service e os enviará por meio da API do rastreador do Amazon Location. Você pode criar essa função por meio do AWS Lambda console ou usar o AWS Command Line Interface (AWS CLI) ou AWS Lambda APIs o. Para criar uma função do Lambda que publique atualizações de posição no Amazon Location usando o console: 1. Abra o AWS Lambda console em https://console.aws.amazon.com/lambda/. 1. No painel de navegação à esquerda, selecione Funções. 1. Selecione Criar função e confirme se Autor do zero está selecionado. 1. Preencha as seguintes caixas: + um nome de Função + para a opção **Runtime**, selecione Node.js 16.x. 1. Selecione Criar função. 1. Selecione a guia Código para abrir o editor. 1. Substitua o código do espaço reservado em index.js pelo seguinte: ``` const AWS = require('aws-sdk') const iot = new AWS.Iot(); exports.handler = function(event) { console.log("event===>>>", JSON.stringify(event)); var param = { endpointType: "iot:Data-ATS" }; iot.describeEndpoint(param, function(err, data) { if (err) { console.log("error===>>>", err, err.stack); // an error occurred } else { var endp = data['endpointAddress']; const iotdata = new AWS.IotData({endpoint: endp}); const trackerEvent = event["detail"]["EventType"]; const src = event["source"]; const time = event["time"]; const gfId = event["detail"]["GeofenceId"]; const resources = event["resources"][0]; const splitResources = resources.split("."); const geofenceCollection = splitResources[splitResources.length - 1]; const coordinates = event["detail"]["Position"]; const deviceId = event["detail"]["DeviceId"]; console.log("deviceId===>>>", deviceId); const msg = { "trackerEventType" : trackerEvent, "source" : src, "eventTime" : time, "geofenceId" : gfId, "coordinates": coordinates, "geofenceCollection": geofenceCollection }; const params = { topic: `${deviceId}/tracker`, payload: JSON.stringify(msg), qos: 0 }; iotdata.publish(params, function(err, data) { if (err) { console.log("error===>>>", err, err.stack); // an error occurred } else { console.log("Ladmbda triggered===>>>", trackerEvent); // successful response } }); } }); } ``` 1. Selecione Implantar para salvar a função atualizada. 1. Escolha a guia Configuração. 1. Na seção Acionadores, escolha Adicionar acionador. 1. Selecione EventBridge (CloudWatch Eventos) no campo Fonte. 1. Selecione a opção de rádio “Regras existentes”. 1. Insira o nome da regra assim `AmazonLocationMonitor-GEOFENCECOLLECTION\$1NAME`. 1. Clique no botão Adicionar. 1. Isso também anexará `Resource-based policy statements` (declarações de políticas baseadas em recursos) na guia de permissões Cliente de teste MQTT 1. Abra a [https://console.aws.amazon.com/iot/](https://console.aws.amazon.com/iot/). 1. No painel de navegação, escolha Cliente de teste MQTT. 1. Você verá uma seção intitulada **Cliente de teste MQTT**, na qual você pode configurar sua conexão MQTT. 1. Depois de definir as configurações necessárias, clique no botão **Connect** para estabelecer uma conexão com o broker MQTT usando os parâmetros fornecidos. 1. Anote o valor do Endpoint. Uma vez conectado, você pode assinar os tópicos do MQTT ou publicar mensagens nos tópicos usando os respectivos campos de entrada fornecidos na interface do cliente de teste do MQTT. Em seguida, você anexará a Política do MQTT: 1. No menu do lado esquerdo, em **Gerenciar**, expanda a opção **Segurança** e clique em **Políticas**. 1. Clique no botão **Criar política**. 1. Insira um nome de política. 1. Em **Documento de política**, selecione a guia **JSON**. 1. Copie e cole a política mostrada abaixo, mas certifique-se de atualizar todos os elementos com seu `REGION` e `ACCOUNT_ID`: ``` { "Version": "2012-10-17", "Statement": [ { "Action": [ "iot:Connect", "iot:Publish", "iot:Subscribe", "iot:Receive" ], "Resource": [ "arn:aws:iot:REGION:ACCOUNT_ID:client/${cognito-identity.amazonaws.com:sub}", "arn:aws:iot:REGION:ACCOUNT_ID:topic/${cognito-identity.amazonaws.com:sub}", "arn:aws:iot:REGION:ACCOUNT_ID:topicfilter/${cognito-identity.amazonaws.com:sub}/", "arn:aws:iot:REGION:ACCOUNT_ID:topic/${cognito-identity.amazonaws.com:sub}/tracker" ], "Effect": "Allow" } ] } ``` 1. Selecione o botão **Criar** para finalizar. ## Configurar o código de exemplo da aplicação Para configurar o código de exemplo, você deve ter as seguintes ferramentas instaladas: + Git + XCode 15.3 ou posterior + Simulador iOS 16 ou posterior Use este procedimento para configurar o código da aplicação de exemplo: 1. [Clone o repositório git a partir desta URL: https://github.com/aws-geospatial/amazon-location-samples-ios/-. tree/main/tracking with-geofence-notifications](https://github.com/aws-geospatial/amazon-location-samples-ios/tree/main/tracking-with-geofence-notifications) 1. Abra o arquivo de projeto `AWSLocationSampleApp.xcodeproj`. 1. Aguarde o término do processo de resolução do pacote. 1. **Opcional**: no menu de navegação do projeto, renomeie `ConfigTemplate.xcconfig` para `Config.xcconfig` e preencha os seguintes valores: ``` IDENTITY_POOL_ID = `YOUR_IDENTITY_POOL_ID` MAP_NAME = `YOUR_MAP_NAME` TRACKER_NAME = `YOUR_TRACKER_NAME` WEBSOCKET_URL = `YOUR_MQTT_TEST_CLIENT_ENDPOINT` GEOFENCE_ARN = `YOUR_GEOFENCE_COLLECTION_NAME` ``` ## Usar a aplicação de exemplo Depois de configurar o código de amostra, agora você pode executar a aplicação em um simulador iOS ou em um dispositivo físico. 1. Compile e execute o código. 1. A aplicação solicitará permissões de localização e notificação. Você precisa permiti-los. 1. Toque no botão `Configuração do Cognito`. 1. Se não preencheu os valores no arquivo `Config.xcconfig`, você precisa preencher o campo com os valores dos recursos que você criou anteriormente na tela de configuração. ``` IDENTITY_POOL_ID = `YOUR_IDENTITY_POOL_ID` MAP_NAME = `YOUR_MAP_NAME` TRACKER_NAME = `YOUR_TRACKER_NAME` WEBSOCKET_URL = `YOUR_MQTT_TEST_CLIENT_ENDPOINT` GEOFENCE_ARN = `YOUR_GEOFENCE_COLLECTION_NAME` ``` 1. Salvar a configuração 1. Agora você pode ver as opções de filtro para tempo, distância e precisão. Use-os conforme sua necessidade. 1. Vá para a guia `Rastreamento` na aplicação e você verá o mapa e o botão `Iniciar rastreamento`. 1. Se você instalou A aplicação em um simulador, talvez queira simular mudanças de localização. Isso pode ser feito em Atributos -> opção do menu Localização. Por exemplo, selecione Atributos -> Localização -> Freeway Drive. 1. Toque no botão `Iniciar rastreamento`. Você deve ver os pontos de rastreamento no mapa. 1. A aplicação também está rastreando os locais em segundo plano. Portanto, quando você move a aplicação em segundo plano, ela solicita sua permissão para continuar rastreando no modo de segundo plano. 1. Você pode interromper o rastreamento tocando no botão `Parar rastreamento`. # Criar um aplicativo Android Siga estes procedimentos para criar uma aplicação para iOS usando o Amazon Location Service. Clone os arquivos do projeto de [GitHub](https://github.com/aws-geospatial/amazon-location-samples-android/tree/main/tracking-with-geofence-notifications). ## Criar recursos do Amazon Location para sua aplicação Você pode gerar recursos do Amazon Location Service quando sua AWS conta estiver pronta. Esses recursos serão essenciais para a execução dos trechos de código fornecidos. **nota** Se você ainda não criou uma AWS conta, [crie uma AWS conta](https://portal.aws.amazon.com/billing/signup#/start/email). Para começar, você precisará criar um ID de banco de identidades do Amazon Cognito, use o seguinte procedimento: 1. No AWS console, navegue até o serviço Amazon Cognito, selecione **grupos de identidades** no menu do lado esquerdo e selecione **Criar grupo de identidades**. 1. Verifique se a opção **Acesso de convidado** está marcada e pressione **Avançar** para continuar. 1. Escolha um perfil do IAM existente ou crie um novo. 1. Insira o nome do banco de identidades e certifique-se de que o banco de identidades tenha acesso aos recursos de `(geo)` do Amazon Location para o mapa e o rastreador que você criará no próximo procedimento. 1. Agora você precisa criar e estilizar um mapa no console de localização da AWS Amazon, use o seguinte procedimento: 1. Navegue até a [seção Mapas](https://console.aws.amazon.com/location/maps/home) do console do Amazon Location e selecione **Criar mapa** para visualizar os estilos de mapa disponíveis. 1. Dê um **nome** e uma **descrição** ao novo recurso de mapa. Registre o nome que você atribuir ao recurso de mapa, conforme ele será usado posteriormente no tutorial. 1. Ao escolher um estilo de mapa, considere o provedor de dados do mapa. Consulte a seção 82 dos [Termos de serviço da AWS](https://aws.amazon.com/service-terms) para obter mais detalhes. 1. Aceite os [Termos e condições do Amazon Location](https://aws.amazon.com/service-terms/#:~:text=82.%20Amazon%20Location%20Service) e selecione **Criar mapa**. Após criar o mapa, você pode interagir com ele ampliando, reduzindo o zoom ou fazendo uma panorâmica em qualquer direção. Para criar um rastreador usando o console do Amazon Location 1. Abra o console do [Amazon Location Service](https://console.aws.amazon.com/location/). 1. No painel de navegação à esquerda, selecione **Rastreadores**. 1. Selecione **Criar rastreador**. 1. Preencha os campos obrigatórios: 1. Em **Filtragem de posições**, escolha a opção que melhor se adequa à forma como você pretende usar seu recurso de rastreador. Se você não definir a filtragem de posição, a configuração padrão será. TimeBased Para obter mais informações, consulte Trackers neste guia e PositionFiltering na Amazon Location Service Trackers API Reference. 1. Escolha **Criar rastreador** para finalizar. ## Criar uma coleção de geocercas Quando for criar uma coleção de geocercas, você pode usar o console, a API ou a CLI. Os procedimentos a seguir demonstram esse processo. Para criar uma coleção de geocercas usando o console Amazon Location: 1. Abra o console do Amazon Location Service em https://console.aws.amazon.com/location/. 1. No painel de navegação à esquerda, selecione Coleções de geocercas. 1. Selecione Criar coleção de geocercas. 1. Forneça um nome e uma descrição para a coleção. 1. Em EventBridge regra com CloudWatch como destino, você pode criar uma EventBridge regra opcional para começar a reagir aos eventos de delimitação geográfica. Isso permite que o Amazon Location publique eventos no Amazon CloudWatch Logs. 1. Selecione Criar coleção de geocercas. Crie uma coleção de cercas geográficas usando a localização da Amazon: APIs Use a CreateGeofenceCollection operação da Amazon Location Geofences APIs. O exemplo a seguir usa uma solicitação de API para criar uma coleção de geocercas chamada `GOECOLLECTION_NAME`. ``` POST /geofencing/v0/collections Content-type: application/json { "CollectionName": "GOECOLLECTION_NAME", "Description": "Geofence collection 1 for shopping center", "Tags": { "Tag1" : "Value1" } } ``` Crie uma coleção de cercas geográficas usando AWS CLI os comandos: Use o comando create-geofence-collection. O exemplo a seguir usa uma AWS CLI para criar uma coleção de geocercas chamada `GOECOLLECTION_NAME`. ``` aws location \ create-geofence-collection \ --collection-name "GOECOLLECTION_NAME" \ --description "Shopping center geofence collection" \ --tags Tag1=Value1 ``` ## Vincule um rastreador a uma coleção de geocercas Para vincular um rastreador a uma coleção de geocercas, você pode usar o console, a API ou a CLI. Os procedimentos a seguir demonstram esse processo. Vincular um recurso de rastreador a uma coleção de geocercas usando o console do Amazon Location Service: 1. Abra o console do Amazon Location. 1. No painel de navegação à esquerda, selecione **Rastreadores**. 1. Em **Rastreadores de dispositivos**, selecione o link do nome do rastreador de destino. 1. Em **Coleções de geocercas vinculadas**, selecione **Vincular coleção de geocercas**. 1. Na janela **Coleção de geocercas vinculadas**, selecione uma coleção de geocercas no menu suspenso. 1. Escolha **Vincular**. 1. Depois de vincular o recurso de rastreador, ele receberá um status de Ativo. Vincule um recurso rastreador a uma coleção de cercas geográficas usando a localização da Amazon: APIs Use a `` AsssociateTrackerConsumer operação dos Amazon Location Trackers APIs. O exemplo a seguir usa uma solicitação de API que se ExampleTracker associa a uma coleção de cercas geográficas usando seu Amazon Resource Name (ARN). ``` POST /tracking/v0/trackers/ExampleTracker/consumers Content-type: application/json { "ConsumerArn": "arn:aws:geo:us-west-2:123456789012:geofence-collection/GOECOLLECTION_NAME" } ``` Vincule um recurso de rastreador a uma coleção de geocercas usando comandos da AWS CLI : Use o comando `associate-tracker-consumer `. O exemplo a seguir usa um AWS CLI para criar uma coleção de geofence chamada. `GOECOLLECTION_NAME` ``` aws location \ associate-tracker-consumer \ --consumer-arn "arn:aws:geo:us-west-2:123456789012:geofence-collection/GOECOLLECTION_NAME" \ --tracker-name "ExampleTracker" ``` ## Use o AWS Lambda com o MQTT Crie uma função do Lambda: Para criar uma conexão entre AWS IoT Core o Amazon Location Service, você precisa de uma AWS Lambda função para processar mensagens encaminhadas por EventBridge CloudWatch eventos. Essa função extrairá todos os dados posicionais, os formatará para o Amazon Location Service e os enviará por meio da API do rastreador do Amazon Location. Você pode criar essa função por meio do AWS Lambda console ou usar o AWS Command Line Interface (AWS CLI) ou AWS Lambda APIs o. Para criar uma função do Lambda que publique atualizações de posição no Amazon Location usando o console: 1. Abra o AWS Lambda console em https://console.aws.amazon.com/lambda/. 1. No painel de navegação à esquerda, selecione Funções. 1. Selecione Criar função e confirme se Autor do zero está selecionado. 1. Preencha as seguintes caixas: + um nome de Função + para a opção **Runtime**, selecione Node.js 16.x. 1. Selecione Criar função. 1. Selecione a guia Código para abrir o editor. 1. Substitua o código do espaço reservado em index.js pelo seguinte: ``` const AWS = require('aws-sdk') const iot = new AWS.Iot(); exports.handler = function(event) { console.log("event===>>>", JSON.stringify(event)); var param = { endpointType: "iot:Data-ATS" }; iot.describeEndpoint(param, function(err, data) { if (err) { console.log("error===>>>", err, err.stack); // an error occurred } else { var endp = data['endpointAddress']; const iotdata = new AWS.IotData({endpoint: endp}); const trackerEvent = event["detail"]["EventType"]; const src = event["source"]; const time = event["time"]; const gfId = event["detail"]["GeofenceId"]; const resources = event["resources"][0]; const splitResources = resources.split("."); const geofenceCollection = splitResources[splitResources.length - 1]; const coordinates = event["detail"]["Position"]; const deviceId = event["detail"]["DeviceId"]; console.log("deviceId===>>>", deviceId); const msg = { "trackerEventType" : trackerEvent, "source" : src, "eventTime" : time, "geofenceId" : gfId, "coordinates": coordinates, "geofenceCollection": geofenceCollection }; const params = { topic: `${deviceId}/tracker`, payload: JSON.stringify(msg), qos: 0 }; iotdata.publish(params, function(err, data) { if (err) { console.log("error===>>>", err, err.stack); // an error occurred } else { console.log("Ladmbda triggered===>>>", trackerEvent); // successful response } }); } }); } ``` 1. Selecione Implantar para salvar a função atualizada. 1. Escolha a guia Configuração. 1. Na seção Acionadores, escolha Adicionar acionador. 1. Selecione EventBridge (CloudWatch Eventos) no campo Fonte. 1. Selecione a opção de rádio “Regras existentes”. 1. Insira o nome da regra assim `AmazonLocationMonitor-GEOFENCECOLLECTION\$1NAME`. 1. Clique no botão Adicionar. 1. Isso também anexará `Resource-based policy statements` (declarações de políticas baseadas em recursos) na guia de permissões Cliente de teste MQTT 1. Abra a [https://console.aws.amazon.com/iot/](https://console.aws.amazon.com/iot/). 1. No painel de navegação, escolha Cliente de teste MQTT. 1. Você verá uma seção intitulada **Cliente de teste MQTT**, na qual você pode configurar sua conexão MQTT. 1. Depois de definir as configurações necessárias, clique no botão **Connect** para estabelecer uma conexão com o broker MQTT usando os parâmetros fornecidos. 1. Anote o valor do endpoint. Uma vez conectado, você pode assinar os tópicos do MQTT ou publicar mensagens nos tópicos usando os respectivos campos de entrada fornecidos na interface do cliente de teste do MQTT. Em seguida, você anexará a Política do MQTT: 1. No menu do lado esquerdo, em **Gerenciar**, expanda a opção **Segurança** e clique em **Políticas**. 1. Clique no botão **Criar política**. 1. Insira um nome de política. 1. Em **Documento de política**, selecione a guia **JSON**. 1. Copie e cole a política mostrada abaixo, mas certifique-se de atualizar todos os elementos com seu `REGION` e `ACCOUNT_ID`: ``` { "Version": "2012-10-17", "Statement": [ { "Action": [ "iot:Connect", "iot:Publish", "iot:Subscribe", "iot:Receive" ], "Resource": [ "arn:aws:iot:REGION:ACCOUNT_ID:client/${cognito-identity.amazonaws.com:sub}", "arn:aws:iot:REGION:ACCOUNT_ID:topic/${cognito-identity.amazonaws.com:sub}", "arn:aws:iot:REGION:ACCOUNT_ID:topicfilter/${cognito-identity.amazonaws.com:sub}/", "arn:aws:iot:REGION:ACCOUNT_ID:topic/${cognito-identity.amazonaws.com:sub}/tracker" ], "Effect": "Allow" } ] } ``` **nota** Registre o nome da política e o nome do tópico para usar no próximo procedimento. 1. Selecione o botão **Criar** para finalizar. Depois de concluir o procedimento anterior, agora você atualizará as permissões para a função de convidado da seguinte forma: 1. Navegue até o Amazon Cognito e abra seu banco de identidades. Em seguida, vá para o acesso do usuário e selecione a função de convidado. 1. Clique nas políticas de permissão para ativar a edição. ``` { 'Version': '2012-10-17 ', 'Statement': [ { 'Action': [ 'geo:GetMap*', 'geo:BatchUpdateDevicePosition', 'geo:BatchEvaluateGeofences', 'iot:Subscribe', 'iot:Publish', 'iot:Connect', 'iot:Receive', 'iot:AttachPrincipalPolicy', 'iot:AttachPolicy', 'iot:DetachPrincipalPolicy', 'iot:DetachPolicy' ], 'Resource': [ 'arn:aws:geo:us-east-1:{USER_ID}:map/{MAP_NAME}', 'arn:aws:geo:us-east-1:{USER_ID}:tracker/{TRACKER_NAME}', 'arn:aws:geo:us-east-1:{USER_ID}:geofence-collection/{GEOFENCE_COLLECTION_NAME}', 'arn:aws:iot:us-east-1:{USER_ID}:client/${cognito-identity.amazonaws.com:sub}', 'arn:aws:iot:us-east-1:{USER_ID}:topic/${cognito-identity.amazonaws.com:sub}', 'arn:aws:iot:us-east-1:{USER_ID}:topicfilter/${cognito-identity.amazonaws.com:sub}/*', 'arn:aws:iot:us-east-1:{USER_ID}:topic/${cognito-identity.amazonaws.com:sub}/tracker' ], 'Effect': 'Allow' }, { 'Condition': { 'StringEquals': { 'cognito-identity.amazonaws.com:sub': '${cognito-identity.amazonaws.com:sub}' } }, 'Action': [ 'iot:AttachPolicy', 'iot:DetachPolicy', 'iot:AttachPrincipalPolicy', 'iot:DetachPrincipalPolicy' ], 'Resource': [ '*' ], 'Effect': 'Allow' } ] } ``` 1. Com as mudanças de política acima, todos os AWS recursos necessários agora estão configurados adequadamente para o aplicativo. ## Configurar o código de exemplo da aplicação 1. Abra o Android Studio e selecione **Novo** e, em seguida, **Projeto no controle de versão**. 1. Navegue até o menu **Arquivo** no canto superior esquerdo do Android Studio. 1. No menu suspenso, selecione “Novo”. 1. Escolha “Projeto no controle de versão”. 1. Insira o URL do repositório na caixa de diálogo exibida, localize o campo marcado como “URL”. 1. Copie e cole o seguinte URL do aplicativo de amostra nesse campo: [https://github.com/aws-geospatial/amazon-location-samples-android.git](https://github.com/aws-geospatial/amazon-location-samples-android.git) 1. Decida em qual diretório você deseja clonar o repositório. Use o diretório padrão ou opte por um local personalizado. 1. Depois de definir o URL do repositório e as preferências do diretório, clique no botão “Clonar”. O Android Studio continuará clonando o repositório no local especificado. 1. Agora você clonou a aplicação em sua máquina e pode começar a usá-lo. ## Usar a aplicação de exemplo Para usar a amostra, siga estes procedimentos: + **Crie um `custom.properties`**: Para configurar seu arquivo `custom.properties`, siga estas etapas: 1. Abra o seu editor de texto ou IDE de preferência. 1. Criar um novo arquivo. 1. Salve o arquivo com o nome `custom.properties`. 1. Atualize o `custom.properties` com o exemplo de código a seguir e substitua o `MQTT_END_POINT`, `POLICY_NAME`, `GEOFENCE_COLLECTION_NAME` e `TOPIC_TRACKER` pelos valores reais: ``` MQTT_END_POINT=xxxxxxxxxxxxx-xxx.xxx.us-east-1.amazonaws.com POLICY_NAME=xxxxxxxxx GEOFENCE_COLLECTION_NAME=xxxxxxxxxxxxxxxxx TOPIC_TRACKER=xxxxxxxxxx ``` 1. Limpe e reconstrua o projeto. Após isso, você poderá executar o projeto. + **Faça login**: Para fazer login na aplicação, siga as etapas abaixo: 1. Pressione o botão **Entrar**. 1. Forneça um **ID do banco de identidades**, um **nome do rastreador** e um **nome do mapa**. 1. Pressione **Entrar** novamente para finalizar. + **Gerenciar filtros**: Abra a tela de configuração e faça o seguinte: 1. Alterne os filtros on/off usando a interface do switch. 1. Atualize os filtros de tempo e distância quando necessário. + **Operações de rastreamento:** Abra a tela de rastreamento e faça o seguinte: + Você pode iniciar e interromper o rastreamento em primeiro plano, segundo plano ou no modo de economia de bateria pressionando os respectivos botões.