GetPlace - Amazon Location Service
사용 사례요청 이해응답 이해

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

GetPlace

GetPlace는 고유한 PlaceId를 사용하여 장소에 대한 세부 정보를 검색합니다. 요청은 시간대 데이터 또는 음소 및 언어 현지화 등과 같은 추가 기능에 대한 선택적 파라미터를 지원합니다. API는 주소, 좌표, 비즈니스 세부 정보, 연락 방법 및 시간대 정보와 같은 정보를 반환합니다.

참고

결과가 저장되면 더 높은 스토리지 요금 계층으로 요금이 청구됩니다. IntendedUse 파라미터를 사용하여 결과가 일회용인지 저장용인지 지정합니다. 저장된 결과와 관련된 비용 세부 정보는 Places 요금 섹션을 참조하세요.

자세한 내용은 Amazon Location Service API 참조의 GetPlace 섹션을 참조하세요.

이 API에 대한 요청, 응답, cURL 및 CLI 명령의 예는 GetPlace 사용 방법을 참조하세요.

사용 사례

  • 저장된 데이터 새로 고침: 저장된 데이터를 정기적으로 새로 고쳐 애플리케이션이 정확한 최신 정보를 제공하도록 합니다. GetPlace API를 사용하여 비즈니스 및 장소에 대한 세부 정보를 업데이트하여 사용자에게 최신 정보를 제공합니다. 예를 들어, 사용자 신뢰 및 애플리케이션 기능을 개선하기 위해 현지 레스토랑 또는 상점에 대한 영업 시간, 연락처 세부 정보 및 사용자 리뷰를 새로 고칩니다.

  • 미리 입력 제안 후 장소 세부 정보 검색: GetPlace API를 자동 완성 또는 제안 기능과 통합하여 사용자 경험을 개선합니다. 사용자가 주소, 비즈니스 이름 또는 관심 지점을 입력하면 제안을 통해 관련 장소를 제공하며, GetPlace를 사용하면 선택한 후 더 자세한 정보에 액세스할 수 있습니다.

요청 이해

GetPlace API 요청에는 PlaceId와 같은 특정 파라미터가 필요하며 추가 기능 또는 언어 현지화를 위한 선택적 파라미터를 지원합니다. 이러한 파라미터는 언어, 용도 및 지리적 컨텍스트에 따라 결과를 조정하는 데 도움이 됩니다. 자세한 내용은 GetPlace API 참조를 참조하세요.

요청은 다음 주요 파라미터를 수용합니다.

인증

다른 인증 방법을 사용하는 경우 Key 파라미터는 선택 사항입니다.

  • Key: 권한 부여를 위한 API 키입니다.

자세한 내용은 Amazon Location Service로 인증 섹션을 참조하세요.

쿼리

장소 정보를 검색하기 위한 고유 식별자를 정의합니다.

  • PlaceId: 장소의 고유 식별자입니다(필수).

자세한 내용은 쿼리 및 편향 섹션을 참조하세요.

국제화 및 현지화

언어를 사용자 지정하고 결과에 정치적 견해를 적용하는 옵션입니다.

  • Language: 결과의 언어를 지정합니다.

  • PoliticalView: 지역 클레임을 반영하는 정치적 견해를 적용합니다.

자세한 내용은 현지화 및 국제화 섹션을 참조하세요.

추가 기능

시간대 세부 정보와 같은 추가 데이터를 요청합니다.

  • AdditionalFeatures: 시간대 또는 음소 세부 정보와 같은 추가 정보를 요청하는 옵션입니다.

자세한 내용은 기타 기능 섹션을 참조하세요.

응답 이해

GetPlace API의 응답에는 주소, 좌표, 비즈니스 세부 정보와 같은 기본 데이터 뿐만 아니라 요청 파라미터를 기반으로 하는 추가 데이터도 포함됩니다. 액세스 제한, 시간대 및 발음을 위한 음소 세부 정보와 같은 정보도 제공할 수 있습니다. 자세한 내용은 GetPlace API 참조를 참조하세요.

응답에는 다음 주요 데이터가 포함됩니다.

주소 및 관련 세부 정보

위치에 대한 전체 주소 세부 정보를 제공합니다.

  • Address: 국가, 리전 및 우편 번호를 포함한 전체 주소 정보입니다.

  • PostalCodeDetails: 우편 번호 및 권한에 대한 추가 정보입니다.

장소 유형 및 범주

장소의 유형과 범주를 설명합니다.

  • BusinessChains: 연결된 비즈니스 체인에 대한 정보입니다.

  • Categories: 음식점 또는 소매점과 같이 장소가 속한 범주입니다.

  • PlaceType: 관심 지점 또는 지역성과 같은 장소의 유형입니다.

추가 세부 정보

요청에 지정된 대로 장소에 대한 추가 데이터를 제공합니다.

  • Contacts: 전화번호, 이메일 및 웹 사이트를 포함한 연락 방법입니다.

  • OpeningHours: 업무 시간 또는 액세스 시간입니다.

  • AccessPoints: 액세스 포인트의 지리적 좌표(경도 및 위도)입니다.

  • Phonemes: 다양한 주소 구성 요소에 대한 발음입니다.

  • TimeZone: 오프셋을 포함한 시간대 정보입니다.