역방향 지오코딩

역방향 지오코딩은 일련의 좌표를 주소, 지역, 업체명, 관심 장소 등 의미 있는 텍스트로 변환하는 프로세스입니다. 장소 색인 리소스를 사용하여 역방향 지오코딩 요청을 제출하고 역방향 지오코딩에서 검색된 데이터를 통합하여 웹 또는 모바일 애플리케이션용 지도에 데이터를 표시할 수 있습니다.

이 섹션에서는 간단한 역방향 지오코딩 요청을 보내는 방법을 안내합니다.

역방향 지오코딩

SearchPlaceIndexForPosition 작업을 사용하여 좌표 세트를 역방향 지오코딩하고 이를 의미 있는 주소, 관심 장소 또는 주소가 없는 일반적인 위치로 변환해 달라는 간단한 요청을 제출할 수 있습니다. 단순 요청에는 다음과 같은 필수 파라미터가 포함됩니다.

• Position – 주소, 관심 장소 또는 일반 위치로 변환하려는 좌표 세트. 형식 [longitude,latitude]을 사용하여 정의됩니다.

페이지당 최대 결과 수를 지정하려면 다음과 같은 선택적 파라미터를 추가합니다.

• MaxResults – 쿼리 응답에 반환되는 최대 결과 수를 제한합니다.

쿼리 결과에 사용할 기본 언어를 지정하려면 다음과 같은 선택적 파라미터를 사용하세요.

• Language – 결과를 렌더링하는 데 사용되는 언어 코드입니다. 값은 유효한 BCP 47 언어 코드여야 합니다. 예를 들어, 영어의 경우en.

참고

Language이 지정되지 않았거나 또는 결과에 지정된 언어가 지원되지 않는 경우, 해당 결과에 대한 파트너의 기본 언어가 사용됩니다.

AWS CLI 또는 Amazon 위치 API를 사용할 수 있습니다.

API

다음은 장소 색인 리소스에서 위치 [122.3394 ExamplePlaceIndex, 47.6159] 근처의 의미 있는 주소, 관심 장소 또는 일반적인 위치를 검색하기 위한 SearchPlaceIndexForPosition 요청입니다.

POST /places/v0/indexes/ExamplePlaceIndex/search/position
Content-type: application/json

{
   "Position": [-122.3394,47.6159],
   "MaxResults": 5,
   "Language": "de"
}

AWS CLI

다음 예제는 장소 색인 리소스에서 의미 있는 주소 ExamplePlaceIndex, 관심 장소 또는 위치 근처의 일반적인 위치를 검색하는 search-place-index-for-position 명령입니다 [122.3394, 47.6159].

aws location \
    search-place-index-for-position \
        --index-name ExamplePlaceIndex \
        --position -122.3394 47.6159 \
        --max-results 5 \
        --language de

응답의 예

다음은 Amazon Location Places API에서 SearchPlaceIndexForPosition 작업을 호출할 때의 응답의 예입니다. 결과는 관련 장소와 요청 요약을 반환합니다. 파트너로 Esri 또는 Here를 선택하면 두 개의 응답이 표시됩니다.

Example request

POST /places/v0/indexes/ExamplePlaceIndex/search/position
Content-type: application/json

{
   "Position": [-122.3394,47.6159],
   "MaxResults": 1
}

Example response (Esri)

{
    "Results": [
        {
            "Place": {
                "AddressNumber": "2111",
                "Country": "USA",
                "Geometry": {
                    "Point": [
                        -122.33937999999995,
                        47.61591000000004
                    ]
                },
                "Interpolated": false,
                "Label": "The Spheres, 2111 7th Ave, Seattle, WA, 98121, USA",
                "Municipality": "Seattle",
                "Neighborhood": "Belltown",
                "PostalCode": "98121",
                "Region": "Washington",
                "SubRegion": "King County"
            },
            "Distance": 1.8685861313438727
        }
    ],
    "Summary": {
        "DataSource": "Esri",
        "MaxResults": 1,
        "Position": [
            -122.3394,
            47.6159
        ]
    }
}

Example response (HERE)

{
    "Summary": {
        "Position": [
            -122.3394,
            47.6159
        ],
        "MaxResults": 1,
        "DataSource": "Here"
    },
    "Results": [
        {
            "Place": {
                "Label": "2111 7th Ave, Seattle, WA 98121-5114, United States",
                "Geometry": {
                    "Point": [
                        -122.33938,
                        47.61591
                    ]
                },
                "AddressNumber": "2111",
                "Street": "7th Ave",
                "Neighborhood": "Belltown",
                "Municipality": "Seattle",
                "SubRegion": "King",
                "Region": "Washington",
                "Country": "USA",
                "PostalCode": "98121-5114",
                "Interpolated": false,
                "TimeZone": {
                    "Name": "America/Los_Angeles",
                    "Offset": -28800
                }
            },
            "PlaceId": "AQAAAIAADsn2T3KdrRWeaXLeVEyjNx_JfeTsMB0NVCEAnAZoJ-o3nqdlJZAdgcT2oWi1w9pS4wXXOk3O1vsKlGsPyHjV4EJxsu289i3hVO_BUPgP7SFoWAi8BW2v7LvAjQ5NfUPy7a1v9ajT3feIqcUZszWSTqKbJHFYvQqW7wdqhpQq3Wy-et39ZQDWSPLZUzgcjN-6VD2gyKkH0Po7gSm8YSJNSQ",
            "Distance": 1.868586125090601
        }
    ]
}