Pré-requisitos

Antes de começar a calcular as rotas, siga as etapas de pré-requisito:

Criar um recurso de calculadora de rotas

Antes de calcular uma rota, crie um recurso de calculadora de rotas em sua conta AWS.

Ao criar um recurso de calculadora de rotas, você pode escolher entre os provedores de dados disponíveis:

1. Esri – para obter mais informações sobre a cobertura da Esri na região de seu interesse, consulte Detalhes da Esri sobre redes de ruas e cobertura de trânsito.

2. HERE Technologies – para obter informações adicionais sobre a cobertura da HERE em sua região de interesse, consulte Cobertura de roteamento de carros da HERE e Cobertura de roteamento de caminhões da HERE.

3. Grab — Para obter mais informações sobre a cobertura do Grab, consulte Países/regiões e área de cobertura.

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.

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 calculadora de rotas usando o console do Amazon Location

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

2. No painel de navegação à esquerda, selecione Calculadoras de rotas.

3. Escolha Criar calculadora de rotas.

4. Preencha as seguintes caixas:

   • Nome – insira um nome para o recurso da calculadora de rotas. Por exemplo, ExampleCalculator. Máximo de 100 caracteres. Entradas válidas incluem caracteres alfanuméricos, hifens, pontos e sublinhados.

   • Descrição – insira uma descrição opcional.

5. Para Provedores de dados, escolha um Provedor de dados para usar como calculadora de rotas.

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

7. Escolha Criar calculadora de rotas.

API

Para criar um recurso de calculadora de rotas usando as APIs do Amazon Location

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

O exemplo a seguir é uma solicitação de API para criar um recurso de calculadora de rotas chamado ExampleCalculatorusando o provedor de dados Esri.

POST /routes/v0/calculators
Content-type: application/json

{
   "CalculatorName": "ExampleCalculator",
   "DataSource": "Esri",
   "Description": "string",
   "Tags": { 
      "Tag1" : "Value1" 
   }
}

AWS CLI

Para criar um recurso de calculadora de rotas usando comandos do AWS CLI

Use o comando create-route-calculator.

O exemplo a seguir cria um recurso de calculadora de rotas chamado ExampleCalculatorusando a Esri como provedor de dados.

aws location \
  create-route-calculator \
  --calculator-name "ExampleCalculator" \
  --data-source "Esri" \
  --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 calculadora de rotas 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, o AWS JavaScript SDK v3 e o Amazon Location. JavaScript Auxiliar de autenticação

  import { LocationClient, CalculateRouteCommand } 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 = {
    CalculatorName: "ExampleCalculator",
    DeparturePosition: [-123.4567, 45.6789],
    DestinationPosition: [-123.123, 45.234],
  };
  
  const command = new CalculateRouteCommand(input);
  
  const response = await client.send(command);