기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
역방향 지오코딩
역방향 지오코딩은 일련의 좌표를 주소, 지역, 업체명, 관심 장소 등 의미 있는 텍스트로 변환하는 프로세스입니다. 장소 색인 리소스를 사용하여 역방향 지오코딩 요청을 제출하고 역방향 지오코딩에서 검색된 데이터를 통합하여 웹 또는 모바일 애플리케이션용 지도에 데이터를 표시할 수 있습니다.
이 섹션에서는 간단한 역방향 지오코딩 요청을 보내는 방법을 안내합니다.
역방향 지오코딩
SearchPlaceIndexForPosition
작업을 사용하여 좌표 세트를 역방향 지오코딩하고 이를 의미 있는 주소, 관심 장소 또는 주소가 없는 일반적인 위치로 변환해 달라는 간단한 요청을 제출할 수 있습니다. 단순 요청에는 다음과 같은 필수 파라미터가 포함됩니다.
페이지당 최대 결과 수를 지정하려면 다음과 같은 선택적 파라미터를 추가합니다.
쿼리 결과에 사용할 기본 언어를 지정하려면 다음과 같은 선택적 파라미터를 사용하세요.
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
}
]
}