Estabelece pré-requisitos usando Amazon Location - Amazon Location Service
Criação de um recurso de índice de localAutenticando suas solicitações

Estabelece pré-requisitos usando Amazon Location

Antes de começar a geocodificar, reverter a geocodificação ou pesquisar lugares, siga as etapas de pré-requisito:

Criação de um recurso de índice de local

Comece criando um recurso de índice de local em sua conta da AWS.

Ao criar um recurso de índice de local você pode escolher entre os provedores de dados disponíveis para ser compatível com consultas de geocodificação, geocodificação reversa e pesquisas:

  1. Esri: para obter mais informações sobre a abrangência da Esri em sua região de interesse, consulte a abrangência de geocodificação da Esri na documentação da Esri.

  2. HERE Technologies: para obter mais informações sobre a abrangência da HERE em sua região de interesse, consulte a abrangência de geocodificação da HERE na documentação da HERE.

  3. Grab: o Grab fornece dados somente do Sudeste Asiático. Para obter mais informações sobre a cobertura do Grab, consulte Países/regiões e área de cobertura neste guia.

Isso pode ser feito usando o console do Amazon Location Service, a AWS CLI, ou as APIs do Amazon Location.

Console

Para criar um recurso de índice de local usando o console do Amazon Location Service

  1. Abra o console do Amazon Location Service em https://console.aws.amazon.com/location/.

  2. No painel de navegação, escolha Índices de localização.

  3. Escolha Criar índice de localização.

  4. Preencha as seguintes caixas:

    • Nome: insira um nome para o recurso de índice de local. Por exemplo, ExamplePlaceIndex. Máximo de 100 caracteres. Entradas válidas incluem caracteres alfanuméricos, hifens, pontos e sublinhados.

    • Descrição: Insira uma descrição opcional.

  5. Em Provedores de dados, escolha um provedor de dados disponível para usar com seu recurso de índice de local.

    nota

    Se a aplicação estiver rastreando ou roteando os ativos que você usa em sua empresa, como veículos de entrega ou funcionários, você não deverá usar a Esri como provedor de geolocalização. Consulte a seção 82 dos Termos de serviço da AWS para obter mais detalhes.

  6. Em Opções de armazenamento de dados, especifique se você pretende armazenar os resultados da pesquisa do seu recurso de índice de local.

  7. (Opcional) Em Tags, insira uma tag Chave e Valor. Isso adiciona uma tag ao seu novo recurso de índice de local. Para obter mais informações, consulte Marcar seus recursos.

  8. Escolha Criar índice de localização.

API

Para criar um recurso de índice de localusando as APIs do Amazon Location

Use a operação CreatePlaceIndex das APIs de localização do Amazon Location.

O exemplo a seguir é uma solicitação de API para criar um recurso de índice de local chamado ExamplePlaceIndex usando o provedor de dados Esri.

POST /places/v0/indexes
Content-type: application/json

{
   "DataSource": "Esri",
   "DataSourceConfiguration": { 
      "IntendedUse": "SingleUse"
   },
   "Description": "string",
   "IndexName": "ExamplePlaceIndex",
   "Tags": { 
      "Tag1" : "Value1" 
   }
}
AWS CLI

Para criar um recurso de índice de local usando comandos AWS CLI

Use o comando create-place-index.

O exemplo a seguir cria um recurso de índice de local chamado ExamplePlaceIndex usando a Esri como provedor de dados. 

aws location \
  create-place-index \
  --data-source "Esri" \
  --description "Example place index" \
  --index-name "ExamplePlaceIndex" \
  --tags Tag1=Value1
nota

O faturamento depende do seu uso. Você pode incorrer em taxas pelo uso de outros serviços da AWS. Para obter mais informações, consulte os preços do Amazon Location Service.

Autenticando suas solicitações

Depois de criar um recurso de índice de local e estiver pronto para começar a criar recursos de localização em seu aplicativo, escolha como você autenticaria suas solicitações:

  • Para explorar as formas para acessar os serviços, consulte Acessando o Amazon Location Service.

  • Se você tem um site com usuários anônimos, talvez queira usar chaves de API ou o Amazon Cognito.

    Exemplo

    O exemplo a seguir mostra o uso de uma chave de API para autorização, usando o AWS JavaScript SDK v3 e o Amazon Location Auxiliar de autenticação em JavaScript.

    import { LocationClient, SearchPlaceIndexForTextCommand } from "@aws-sdk/client-location";
import { withAPIKey } from "@aws/amazon-location-utilities-auth-helper";

const apiKey = "v1.public.your-api-key-value"; // API key

// Create an authentication helper instance using an API key
const authHelper = await withAPIKey(apiKey);

const client = new LocationClient({
  region: "<region>", // region containing Cognito pool
  ...authHelper.getLocationClientConfig(), // Provides configuration required to make requests to Amazon Location
});

const input = {
  IndexName: "ExamplePlaceIndex",
  Text: "Anyplace",
  BiasPosition: [-123.4567, 45.6789]
};

const command = new SearchPlaceIndexForTextCommand(input);

const response = await client.send(command);