기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다. # Get Place 사용 방법 이 섹션에는 Get Place API 사용 방법을 안내하는 다양한 방법과 예제가 포함되어 있습니다. **Topics** + [PlaceId에 대한 결과를 가져오는 방법](how-to-get-place-by-id.md) + [PlaceId에 대한 연락처를 가져오는 방법](how-to-get-contacts-by-place-id.md) + [PlaceId의 시간대를 가져오는 방법](how-to-get-timezone-by-place-id.md) + [특정 언어로 PlaceId에 대한 세부 정보를 가져오는 방법](how-to-get-place-details-language-place-id.md) + [장소 ID의 보조 주소를 가져오는 방법](how-to-get-secondary-addresses-placeid.md) # PlaceId에 대한 결과를 가져오는 방법 GetPlace API는 고유한 PlaceId를 사용하여 장소에 대한 세부 정보를 검색하여 애플리케이션이 지정된 위치에 대한 포괄적인 세부 정보에 액세스할 수 있도록 합니다. ## 잠재적 사용 사례 + **매장 위치 검색:** PlaceId를 사용하여 사용자 경험을 개선하고 효율적인 리소스 관리를 위해 다양한 매장 위치에 대한 세부 정보를 가져옵니다. + **액세스 관련 장소 세부 정보:** 이전 쿼리에서 반환된 다른 PlaceId를 사용하여 식별된 장소의 세부 정보를 가져옵니다. ## 예제 ### PlaceId를 사용하여 Get Place ------ #### [ Sample request ] ``` https://places.geo.eu-central-1.amazonaws.com/v2/place/AQAAAFUAcrFHu947JATTY9gIGcfNlNVzD3UftkkI9ayJjtquaC7IquYz-_FFnJnzJSQ7JePd-sY0MSpA64V0w4aXLc-lB2fZLJKk6uoAMSgtwvwxzg1fvPxFM9zXsx77EaLXarl7F4gSPTyQ6fiEnj0b0ipOXpnOoIsP?key=Your_Key ``` ------ #### [ Sample response ] ``` { "PlaceId": "", "PlaceType": "PointOfInterest", "Title": "London Eye", "Address": { "Label": "London Eye, County Hall, Westminster Bridge Road, London, SE1 7, United Kingdom", "Country": { "Code2": "GB", "Code3": "GBR", "Name": "United Kingdom" }, "Region": { "Name": "England" }, "SubRegion": { "Code": "LDN", "Name": "London" }, "Locality": "London", "District": "Waterloo", "PostalCode": "SE1 7", "Street": "County Hall, Westminster Bridge Road", "StreetComponents": [ { "BaseName": "County Hall, Westminster Bridge Road", "Language": "en-GB" } ] }, "Position": [ -0.11953, 51.50336 ], "Categories": [ { "Id": "tourist_attraction", "Name": "Tourist Attraction", "LocalizedName": "Tourist Attraction", "Primary": true }, { "Id": "landmark-attraction", "Name": "Landmark-Attraction", "LocalizedName": "Landmark-Attraction", "Primary": false }, { "Id": "residential_area-building", "Name": "Residential Area-Building", "LocalizedName": "Residential Area/Building", "Primary": false } ] } ``` ------ #### [ cURL ] ``` curl --request GET \ --url 'https://places.geo.eu-central-1.amazonaws.com/v2/place/AQAAAFUAcrFHu947JATTY9gIGcfNlNVzD3UftkkI9ayJjtquaC7IquYz-_FFnJnzJSQ7JePd-sY0MSpA64V0w4aXLc-lB2fZLJKk6uoAMSgtwvwxzg1fvPxFM9zXsx77EaLXarl7F4gSPTyQ6fiEnj0b0ipOXpnOoIsP?key=Your_Key&language=en' ``` ------ #### [ AWS CLI ] ``` export PLACEID=AQAAAFUAcrFHu947JATTY9gIGcfNlNVzD3UftkkI9ayJjtquaC7IquYz-_FFnJnzJSQ7JePd-sY0MSpA64V0w4aXLc-lB2fZLJKk6uoAMSgtwvwxzg1fvPxFM9zXsx77EaLXarl7F4gSPTyQ6fiEnj0b0ipOXpnOoIs aws geo-places get-place --key ${YourKey} --place-id ${PLACEID} ``` ------ # PlaceId에 대한 연락처를 가져오는 방법 **참고** `ap-southeast-1` 및의 고객의 경우 `Contacts` 필드를 사용할 수 없으므로 `ap-southeast-5`이 사용 사례는 지원되지 않습니다. 자세한 내용은 [GetPlace API 참조](https://docs.aws.amazon.com/location/latest/APIReference/API_geoplaces_GetPlace.html)를 참조하세요. GetPlace API를 사용하면 특정 PlaceId와 연결된 연락처 정보를 검색하여 전화번호 및 웹 사이트 URL 등과 같은 세부 정보를 제공할 수 있습니다. ## 가능한 사용 사례 + **저장된 PlaceId에 대한 추가 연락처 정보 가져오기:** 연락처 데이터에 액세스하여 저장된 장소 세부 정보를 개선합니다. + **Autocomplete에서 주소에 대한 연락처 세부 정보 검색:** Autocomplete API의 PlaceId를 사용하여 특정 연락처 세부 정보를 가져옵니다. ## 예제 ### PlaceId에 대한 연락처 가져오기 ------ #### [ Sample request ] ``` https://places.geo.eu-central-1.amazonaws.com/v2/place/AQAAAFUAcrFHu947JATTY9gIGcfNlNVzD3UftkkI9ayJjtquaC7IquYz-_FFnJnzJSQ7JePd-sY0MSpA64V0w4aXLc-lB2fZLJKk6uoAMSgtwvwxzg1fvPxFM9zXsx77EaLXarl7F4gSPTyQ6fiEnj0b0ipOXpnOoIsP?additional-features=Contact&key=Your_Key ``` ------ #### [ Sample response ] ``` { "PlaceId": "AQAAAFUAcrFHu947JATTY9gIGcfNlNVzD3UftkkI9ayJjtquaC7IquYz-_FFnJnzJSQ7JePd-sY0MSpA64V0w4aXLc-lB2fZLJKk6uoAMSgtwvwxzg1fvPxFM9zXsx77EaLXarl7F4gSPTyQ6fiEnj0b0ipOXpnOoIsP", "PlaceType": "PointOfInterest", "Title": "London Eye", "Address": { "Label": "London Eye, County Hall, Westminster Bridge Road, London, SE1 7, United Kingdom", "Country": { "Code2": "GB", "Code3": "GBR", "Name": "United Kingdom" }, "Region": { "Name": "England" }, "SubRegion": { "Code": "LDN", "Name": "London" }, "Locality": "London", "District": "Waterloo", "PostalCode": "SE1 7", "Street": "County Hall, Westminster Bridge Road", "StreetComponents": [ { "BaseName": "County Hall, Westminster Bridge Road", "Language": "en-GB" } ] }, "Position": [ -0.11953, 51.50336 ], "Categories": [ { "Id": "tourist_attraction", "Name": "Tourist Attraction", "LocalizedName": "Tourist Attraction", "Primary": true }, { "Id": "landmark-attraction", "Name": "Landmark-Attraction", "LocalizedName": "Landmark-Attraction", "Primary": false }, { "Id": "residential_area-building", "Name": "Residential Area-Building", "LocalizedName": "Residential Area/Building", "Primary": false } ], "Contacts": { "Phones": [ { "Value": "+44870500600" }, { "Value": "+448709908883" } ], "Websites": [ { "Value": "http://www.londoneye.com" } ] } } ``` ------ #### [ cURL ] ``` curl --request GET \ --url 'https://places.geo.eu-central-1.amazonaws.com/v2/place/AQAAAFUAcrFHu947JATTY9gIGcfNlNVzD3UftkkI9ayJjtquaC7IquYz-_FFnJnzJSQ7JePd-sY0MSpA64V0w4aXLc-lB2fZLJKk6uoAMSgtwvwxzg1fvPxFM9zXsx77EaLXarl7F4gSPTyQ6fiEnj0b0ipOXpnOoIsP?key=Your_Key&additional-features=Contact&language=en' ``` ------ #### [ AWS CLI ] ``` export PLACEID=AQAAAFUAcrFHu947JATTY9gIGcfNlNVzD3UftkkI9ayJjtquaC7IquYz-_FFnJnzJSQ7JePd-sY0MSpA64V0w4aXLc-lB2fZLJKk6uoAMSgtwvwxzg1fvPxFM9zXsx77EaLXarl7F4gSPTyQ6fiEnj0b0ipOXpnOoIsP aws geo-places get-place --key ${YourKey} --place-id ${PLACEID} --additional-features "Contact" --language "en" ``` ------ # PlaceId의 시간대를 가져오는 방법 GetPlace API를 사용하면 특정 PlaceId와 연결된 연락처 정보를 검색하여 전화번호, 시간대 및 웹 사이트 URL 등과 같은 세부 정보를 제공할 수 있습니다. ## 가능한 사용 사례 + **저장된 PlaceId에 대한 추가 시간대 정보 가져오기:** 매장 PlaceId를 사용하여 세계 시계를 생성합니다. + **Autocomplete에서 주소의 시간대 세부 정보 검색:** PlaceId의 일광 절약 시간을 추적합니다. ## 예제 ### PlaceId의 시간대 가져오기 ------ #### [ Sample request ] ``` https://places.geo.eu-central-1.amazonaws.com/v2/place/AQAAAFUAcrFHu947JATTY9gIGcfNlNVzD3UftkkI9ayJjtquaC7IquYz-_FFnJnzJSQ7JePd-sY0MSpA64V0w4aXLc-lB2fZLJKk6uoAMSgtwvwxzg1fvPxFM9zXsx77EaLXarl7F4gSPTyQ6fiEnj0b0ipOXpnOoIsP?additional-features=TimeZone&key=Your_Key ``` ------ #### [ Sample response ] ``` { "PlaceId": "", "PlaceType": "PointOfInterest", "Title": "London Eye", "Address": { "Label": "London Eye, County Hall, Westminster Bridge Road, London, SE1 7, United Kingdom", "Country": { "Code2": "GB", "Code3": "GBR", "Name": "United Kingdom" }, "Region": { "Name": "England" }, "SubRegion": { "Code": "LDN", "Name": "London" }, "Locality": "London", "District": "Waterloo", "PostalCode": "SE1 7", "Street": "County Hall, Westminster Bridge Road", "StreetComponents": [ { "BaseName": "County Hall, Westminster Bridge Road", "Language": "en-GB" } ] }, "Position": [ -0.11953, 51.50336 ], "Categories": [ { "Id": "tourist_attraction", "Name": "Tourist Attraction", "LocalizedName": "Tourist Attraction", "Primary": true }, { "Id": "landmark-attraction", "Name": "Landmark-Attraction", "LocalizedName": "Landmark-Attraction", "Primary": false }, { "Id": "residential_area-building", "Name": "Residential Area-Building", "LocalizedName": "Residential Area/Building", "Primary": false } ], "TimeZone": { "Name": "Europe/London", "Offset": "+01:00", "OffsetSeconds": 3600 } } ``` ------ #### [ cURL ] ``` curl --request GET \ --url 'https://places.geo.eu-central-1.amazonaws.com/v2/place/AQAAAFUAcrFHu947JATTY9gIGcfNlNVzD3UftkkI9ayJjtquaC7IquYz-_FFnJnzJSQ7JePd-sY0MSpA64V0w4aXLc-lB2fZLJKk6uoAMSgtwvwxzg1fvPxFM9zXsx77EaLXarl7F4gSPTyQ6fiEnj0b0ipOXpnOoIsP?key=Your_Key&=TimeZone' ``` ------ #### [ AWS CLI ] ``` export PLACEID=AQAAAFUAcrFHu947JATTY9gIGcfNlNVzD3UftkkI9ayJjtquaC7IquYz-_FFnJnzJSQ7JePd-sY0MSpA64V0w4aXLc-lB2fZLJKk6uoAMSgtwvwxzg1fvPxFM9zXsx77EaLXarl7F4gSPTyQ6fiEnj0b0ipOXpnOoIsP aws geo-places get-place --key ${YourKey} \ --place-id ${PLACEID} \ --additional-features "TimeZone" ``` ------ # 특정 언어로 PlaceId에 대한 세부 정보를 가져오는 방법 이 기능을 사용하면 BCP47-compliant 코드에서 선호하는 응답 언어를 선택할 수 있습니다. 이름 변형을 기반으로 쿼리 언어를 감지하고 일치하지 않는 토큰 및 모호한 사례에 선호 언어를 사용합니다. 요청된 언어가 명시되지 않은 경우 Places API는 국가가 사용하는 언어로 결과를 제공하지만 다른 리전에서 리전 언어의 우선 순위를 지정합니다. 일부 주소 요소를 요청된 언어로 사용할 수 없는 경우 대안으로 Places API는 기본 언어로 주소를 반환합니다. ## 가능한 사용 사례 + **PlaceId 세부 정보 추가:** 저장된 장소 ID에 대해 지정된 언어로 세부 정보를 추가합니다. + **Autocomplete에서 주소에 대한 PlaceId 세부 정보 검색:** 저장된 PlaceId에 대한 특정 언어로 추가 세부 정보를 가져옵니다. ## 예제 ### 특정 언어로 PlaceId에 대한 세부 정보 가져오기 ------ #### [ Sample request ] ``` https://places.geo.eu-central-1.amazonaws.com/v2/place/AQAAAFUAY0R_4qfQ9LZ0j6lpOggbNLAQ31TRf-sESER_bKKjCar9FF6A3UA0HrYWa4yfeUN5V0qkk6NmdrI3y7fB7PZ4vfuo-Z8Wd-u-01an4KNvWaqfYmEh14s22yCV9Nb1yMXl4-HTfpX5D-jWQT14FEIBqoiuKwLq?language=EN&key=Your_Key ``` ------ #### [ Sample response ] ``` { "PlaceId": "", "PlaceType": "PointOfInterest", "Title": "Parking Area", "Address": { "Label": "Parking Area, Al Nahda Sharjah, United Arab Emirates", "Country": { "Code2": "AE", "Code3": "ARE", "Name": "United Arab Emirates" }, "SubRegion": { "Name": "Sharjah" }, "Locality": "Sharjah", "District": "Al Nahda" }, "Position": [ 55.3733, 25.30388 ], "Categories": [ { "Id": "parking_lot", "Name": "Parking Lot", "LocalizedName": "Parking Lot", "Primary": true } ], "Contacts": { "Phones": [ { "Value": "+971507766189" } ] }, "AccessPoints": [ { "Position": [ 55.37348, 25.30398 ] } ] } ``` ------ #### [ cURL ] ``` curl --request GET \ --url 'https://places.geo.eu-central-1.amazonaws.com/v2/place/AQAAAFUAY0R_4qfQ9LZ0j6lpOggbNLAQ31TRf-sESER_bKKjCar9FF6A3UA0HrYWa4yfeUN5V0qkk6NmdrI3y7fB7PZ4vfuo-Z8Wd-u-01an4KNvWaqfYmEh14s22yCV9Nb1yMXl4-HTfpX5D-jWQT14FEIBqoiuKwLq?language=EN&key=Your_Key` ``` ------ #### [ AWS CLI ] ``` export PLACEID=AQAAAFUAcrFHu947JATTY9gIGcfNlNVzD3UftkkI9ayJjtquaC7IquYz-_FFnJnzJSQ7JePd-sY0MSpA64V0w4aXLc-lB2fZLJKk6uoAMSgtwvwxzg1fvPxFM9zXsx77EaLXarl7F4gSPTyQ6fiEnj0b0ipOXpnOoIsP aws geo-places get-place --key ${YourKey} \ --place-id ${PLACEID} \ --language "en" ``` ------ # 장소 ID의 보조 주소를 가져오는 방법 **참고** `ap-southeast-1` 및의 고객의 경우 `SecondaryAddresses` 필드를 사용할 수 없으므로 `ap-southeast-5`이 사용 사례는 지원되지 않습니다. 자세한 내용은 [GetPlace API 참조](https://docs.aws.amazon.com/location/latest/APIReference/API_geoplaces_GetPlace.html)를 참조하세요. `SecondaryAddresses` API 명령을 사용하면 기본 주소 아래에 있는 모든 보조 주소를 검색할 수 있습니다. 또한 `QueryText` 파라미터 내에 보조 단위가 있는 경우 지오코드는 해당 보조 단위도 반환합니다. ## 가능한 사용 사례 **기본 주소 아래에 있는 모든 보조 주소를 검색합니다.** 이는 주소 양식 완성 사용 사례에서 보다 정확한 위치 정보가 포함된 보다 정확한 보조 주소를 선택하는 데 사용할 수 있습니다. ## 장소 ID의 보조 주소 가져오기 ------ #### [ Sample request ] ``` https://places.geo.eu-central-1.amazonaws.com/v2/place/AQAAAGAAY8Dw_tn6pyN_R5E9_mfwAP5h9Rd5E_xY2CyyRHpX2wolGeK8O3IY13k5xeHmF4To445fCLg0x3GPnTZnCuUWXbfg9SKpijUskj-xf6jNC_3CUSabHVKy-Or51xHTd3KNi6idTkrfeQOjZOkXZ5TaoXsg0GHGMWqs-sZhmr8npQc?additional-features=SecondaryAddresses&key=Your_Key ``` ------ #### [ Sample response ] ``` { "PlaceId": "", "PlaceType": "PointAddress", "Title": "910 Beach Ave, Vancouver, BC V6Z 2W7, Canada", "Address": { "Label": "910 Beach Ave, Vancouver, BC V6Z 2W7, Canada", "Country": { "Code2": "CA", "Code3": "CAN", "Name": "Canada" }, "Region": { "Code": "BC", "Name": "British Columbia" }, "SubRegion": { "Name": "Metro Vancouver" }, "Locality": "Vancouver", "District": "Downtown Vancouver", "PostalCode": "V6Z 2W7", "Street": "Beach Ave", "StreetComponents": [ { "BaseName": "Beach", "Type": "Ave", "TypePlacement": "AfterBaseName", "TypeSeparator": " ", "Language": "en" } ], "AddressNumber": "910" }, "Position": [ -123.13325, 49.27542 ], "MapView": [ -123.13377, 49.2741, -123.13087, 49.27599 ], "SecondaryAddresses": [ { "PlaceId": "", "PlaceType": "SecondaryAddress", "Title": "101-910 Beach Ave, Vancouver, BC V6Z 2W7, Canada", "Address": { "Label": "101-910 Beach Ave, Vancouver, BC V6Z 2W7, Canada", "SecondaryAddressComponents": [ { "Number": "101" } ] }, "Position": [ -123.1334, 49.27532 ] }, { "PlaceId": "", "PlaceType": "SecondaryAddress", "Title": "102-910 Beach Ave, Vancouver, BC V6Z 2W7, Canada", "Address": { "Label": "102-910 Beach Ave, Vancouver, BC V6Z 2W7, Canada", "SecondaryAddressComponents": [ { "Number": "102" } ] }, "Position": [ -123.1334, 49.27532 ] }, ... ] } ``` ------ #### [ cURL ] ``` curl ‐‐request GET \ ‐‐url 'https://places.geo.eu-central-1.amazonaws.com/v2/place/AQAAAGAAY8Dw_tn6pyN_R5E9_mfwAP5h9Rd5E_xY2CyyRHpX2wolGeK8O3IY13k5xeHmF4To445fCLg0x3GPnTZnCuUWXbfg9SKpijUskj-xf6jNC_3CUSabHVKy-Or51xHTd3KNi6idTkrfeQOjZOkXZ5TaoXsg0GHGMWqs-sZhmr8npQc?key=Your_Key&additional-features=SecondaryAddresses' ``` ------ #### [ AWS CLI ] ``` export PLACEID=AQAAAGAAY8Dw_tn6pyN_R5E9_mfwAP5h9Rd5E_xY2CyyRHpX2wolGeK8O3IY13k5xeHmF4To445fCLg0x3GPnTZnCuUWXbfg9SKpijUskj-xf6jNC_3CUSabHVKy-Or51xHTd3KNi6idTkrfeQOjZOkXZ5TaoXsg0GHGMWqs-sZhmr8npQc aws geo-places get-place ‐‐key ${YourKey} \ ‐‐place-id ${PLACEID} \ ‐‐additional-features "SecondaryAddresses" ``` ------