Amazon Location을 사용한 장소 사전 조건 - Amazon Location Service
장소 색인 리소스 생성요청 인증

Amazon Location을 사용한 장소 사전 조건

지오코딩, 역방향 지오코딩 또는 장소 검색을 시작하기 전에 필수 단계를 따르세요.

장소 색인 리소스 생성

먼저 AWS 계정에서 장소 색인 리소스를 생성합니다.

장소 색인 리소스를 생성할 때 지오코딩, 역방향 지오코딩, 검색에 대한 쿼리를 지원하는 데 사용할 수 있는 데이터 제공자를 선택할 수 있습니다.

  1. Esri - 관심 지역의 Esri 범위에 대한 자세한 내용은 Esri 설명서의 Esri 지오코딩 범위를 참조하세요.

  2. HERE 기술 - 관심 지역의 HERE 범위에 대한 자세한 내용은 HERE 설명서의 HERE 지오코딩 범위를 참조하세요.

  3. Grab - Grab은 동남아시아에 대한 데이터만 제공합니다. Grab 범위에 대한 자세한 내용은 본 가이드의 대상 국가/리전 및 지역을 참조하세요.

이 작업을 위해 Amazon Location Service 콘솔, AWS CLI 또는 Amazon Location API를 사용할 수 있습니다.

Console

Amazon Location Service 콘솔을 사용하여 장소 색인 리소스를 생성하려면

  1. https://console.aws.amazon.com/location/에서 Amazon Location Service 콘솔을 엽니다.

  2. 왼쪽 탐색 창에서 장소 색인을 선택합니다.

  3. 장소 색인 생성을 선택합니다.

  4. 다음 입력란을 작성합니다.

    • 이름 – 장소 색인 리소스의 이름을 입력합니다. 예를 들어, ExamplePlaceIndex. 최대 100자입니다. 유효한 항목에는 영숫자 문자, 하이픈, 마침표 및 밑줄이 포함됩니다.

    • 설명 – 선택적 설명을 입력합니다.

  5. 데이터 공급자에서 장소 색인 리소스와 함께 사용할 데이터 공급자를 선택합니다.

    참고

    애플리케이션이 배송 차량 또는 직원 등 업무에서 사용하는 자산을 추적하거나 라우팅하는 경우 Esri를 지리적 위치 제공업체로 사용해서는 안 됩니다. 자세한 내용은 AWS 서비스 약관의 섹션 82를 참조하세요.

  6. 데이터 스토리지 옵션에서 장소 색인 리소스의 검색 결과를 저장할지 여부를 지정합니다.

  7. (선택 사항) 태그 아래에 태그 키 및 값을 입력합니다. 그러면 새 장소 색인 리소스에 태그가 추가됩니다. 자세한 내용을 알아보려면 리소스 태그 지정을 참조하세요.

  8. 장소 색인 생성을 선택합니다.

API

Amazon Location API를 사용하여 장소 색인 리소스를 만들려면

Amazon Location Places API의 CreatePlaceIndex 작업을 사용합니다.

다음 예시는 데이터 제공자 Esri를 사용하여 ExamplePlaceIndex라는 장소 색인 리소스를 생성하기 위한 API 요청입니다.

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

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

AWS CLI 명령을 사용하여 장소 색인 리소스를 만들려면

create-place-index 명령을 사용합니다.

다음 예시에서는 Esri를 데이터 제공자로 사용하여 ExamplePlaceIndex라는 장소 색인 리소스를 만듭니다.

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

청구는 사용량에 따라 달라집니다. 다른 AWS 서비스 사용 시 요금이 부과될 수 있습니다. 자세한 정보는 Amazon Location Service 가격을 참조하세요.

요청 인증

장소 색인 리소스를 생성하고 애플리케이션에 위치 기능을 구축할 준비가 되었으면 요청을 인증할 방법을 선택하세요.

  • 서비스에 액세스하는 방법을 알아보려면 Amazon Location Service 액세스를 참조하세요.

  • 익명 사용자가 있는 웹 사이트가 있는 경우 API 키 또는 Amazon Cognito를 사용하는 것이 좋습니다.

    예

    다음 예는 권한 부여를 위한 API 키 사용, AWS JavaScript SDK v3 사용 및 Amazon Location 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);