기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
지오코딩
지오코딩은 주소, 지역, 업체명, 관심 장소 등의 텍스트를 지리적 좌표 세트로 변환하는 프로세스입니다. 장소 색인 리소스를 사용하여 지오코딩 요청을 제출하고 지오코딩에서 검색된 데이터를 통합하여 웹 또는 모바일 애플리케이션용 지도에 데이터를 표시할 수 있습니다.
이 섹션에서는 간단한 지오코딩 요청을 보내는 방법, 그리고 선택적 사양과 함께 지오코딩 요청을 보내는 방법을 안내합니다.
지오코딩
주소를 좌표 세트로 변환하는 SearchPlaceIndexForText 작업을 사용하여 간단한 지오코딩 요청을 제출할 수 있습니다. 단순 요청에는 다음과 같은 필수 파라미터가 포함됩니다.
-
Text– 좌표 세트로 변환할 주소, 이름, 도시 또는 지역. 예를 들어, 문자열Any Town.
페이지당 최대 결과 수를 지정하려면 다음과 같은 선택적 파라미터를 사용하세요.
-
MaxResults– 쿼리 응답에 반환되는 최대 결과 수를 제한합니다.
AWS CLI 또는 Amazon 위치 API를 사용할 수 있습니다.
위치 주변 지오코드
지오코딩할 때 다음과 같은 선택적 파라미터를 사용하여 지정된 위치 근처를 지오코딩할 수 있습니다.
-
BiasPosition– 주변에서 검색하려는 위치. 이렇게 하면 주어진 위치와 가장 가까운 결과를 검색하여 검색 범위를 좁힐 수 있습니다.[longitude, latitude]과 같이 정의됩니다.
다음 예는 위치 색인 리소스에서 위치 [-123.4567, 45.6789] 근처의 Any Town이라는 주소, 이름, 도시 또는 지역을 검색하기 위한 SearchPlaceIndexForText 요청입니다.
POST /places/v0/indexes/ExamplePlaceIndex/search/text Content-type: application/json { "Text": "Any Town", "BiasPosition": [-123.4567,45.6789] }
경계 상자 내의 지오코드
다음과 같은 선택적 파라미터를 사용하여 경계 상자 내에서 지오코딩하여 결과 범위를 지정된 경계 내의 좌표로 좁힐 수 있습니다.
-
FilterBBox– 상자 경계 내의 좌표로 결과를 필터링하도록 지정하는 경계 상자.[LongitudeSW, LatitudeSW, LongitudeNE, LatitudeNE]과 같이 정의됩니다.참고
요청은
FilterBBox및BiasPosition파라미터를 모두 포함할 수 없습니다. 요청에서 두 파라미터를 모두 지정하면ValidationException오류가 반환됩니다.
다음 예는 경계 상자 내에서 Any Town이라는 주소, 이름, 도시 또는 지역을 검색하기 위한 SearchPlaceIndexForText 요청입니다. 경계 상자는 다음과 같습니다.
-
남서쪽 모서리의 경도는 -124.1450입니다. -
남서쪽 모서리의 위도는 41.7045입니다. -
북동쪽 모서리의 경도는 -124.1387입니다. -
북동쪽 모서리의 위도는 41.7096입니다.
POST /places/v0/indexes/ExamplePlaceIndex/search/text Content-type: application/json { "Text": "Any Town", "FilterBBox": [-124.1450,41.7045,-124.1387,41.7096] }
국가 내 지오코드
다음과 같은 선택적 파라미터를 사용하여 지정한 하나 이상의 국가 내에서 지오코딩할 수 있습니다.
-
FilterCountries– 지오코딩하려는 국가 또는 지역. ISO 31663문자 국가 코드를 사용하여 요청 한 번으로 최대 100개의 국가를 정의할 수 있습니다. 예를 들어, 오스트레일리아의 경우 AUS을 사용합니다.
다음 예는 독일과 프랑스의 Any Town이라는 주소, 이름, 도시 또는 지역을 검색하기 위한 SearchPlaceIndexForText 요청입니다.
POST /places/v0/indexes/ExamplePlaceIndex/search/text Content-type: application/json { "Text": "Any Town", "FilterCountries": ["DEU","FRA"] }
카테고리별 필터링
다음과 같은 선택적 파라미터를 사용하여 지오코드 요청에서 반환되는 카테고리를 필터링할 수 있습니다.
-
FilterCategories– 쿼리에 반환하려는 결과의 카테고리. 단일 요청에 최대 5개의 카테고리를 지정할 수 있습니다. 카테고리 섹션에서 Amazon Location Service 카테고리 목록을 찾을 수 있습니다. 예를 들어, 쿼리에 반환 호텔만 지정하도록Hotel을 지정할 수 있습니다.
다음 예는 미국의 Hometown Coffee라는 커피숍을 검색하기 위한 SearchPlaceIndexForText 요청입니다.
POST /places/v0/indexes/ExamplePlaceIndex/search/text Content-type: application/json { "Text": "Hometown Coffee", "FilterCategories": ["Coffee Shop"], "FilterCountries": ["USA"] }
카테고리 필터링에 대한 자세한 내용은 장소 카테고리 및 필터링 결과을 참조하세요.
기본 언어의 지오코드
선택적 Language 파라미터를 사용하여 검색 결과에 대한 언어 기본 설정을 할 수 있습니다. 예를 들어, 100 Main
St, Anytown, USA에 대한 검색 결과가 기본적으로 100 Main St, Any Town,
USA로 반환될 수 있습니다. 그러나 fr로서 Language을 선택하면 결과가 대신 100 Rue
Principale, Any Town, États-Unis으로 반환될 수 있습니다.
-
Language– 쿼리 결과를 렌더링하는 데 사용할 언어 코드입니다. 값은 유효한 BCP 47언어 코드여야 합니다. 예를 들어, 영어의 경우 en.
참고
Language이 지정되지 않았거나 또는 결과에 지정된 언어가 지원되지 않는 경우, 해당 결과에 대한 파트너의 기본 언어가 사용됩니다.
다음 예는 de으로 지정된 기본 언어로 Any Town라는 장소를 검색하기 위한 SearchPlaceIndexforText 요청입니다.
POST /places/v0/indexes/ExamplePlaceIndex/search/text Content-type: application/json { "Text": "Any Town", "Language": "de" }
응답의 예
다음은 Amazon Location Places API에서 SearchPlaceIndexForText 작업을 호출할 때의 응답의 예입니다. 결과에는 관련 장소와 요청 요약이 포함됩니다. 파트너로 Esri 또는 Here를 선택하면 두 개의 응답이 표시됩니다.
