유형 필터 자세히 알아보기

Places Aggregate API에서 유형 필터를 사용하면 응답에 포함하거나 응답에서 생략할 장소 유형을 선택하여 검색에 집중할 수 있습니다. 장소의 기본 카테고리와 기타 세부정보에 대해 원하는 유형과 원하지 않는 유형의 목록을 만들 수 있습니다. 이렇게 하면 정확히 원하는 장소를 찾기 위한 특정 검색어를 만들 수 있습니다.

사용 가능한 장소 유형은 200개가 넘습니다. Places Aggregate API에서 지원하는 전체 목록은 Places API (New)의 장소 유형 아래에 있는 표 A를 참고하세요.

장소 유형의 작동 방식

장소에는 여러 장소 유형이 있을 수 있습니다.

  • 장소에는 기본 기능을 반영하는 기본 유형이 하나만 있을 수 있습니다. 하지만 경우에 따라 장소의 기본 유형이 지정되지 않을 수 있습니다.

  • 장소에는 보조 유형이 하나 이상 있을 수 있습니다. 보조 유형은 장소의 특징과 서비스에 관한 보충 정보를 제공하기 위해 장소에 적용되는 추가 카테고리입니다.

예를 들어 장소의 기본 유형을 restaurant로 지정할 수 있지만, 바 역할도 하고 음식 서비스도 제공하므로 보조 장소 유형을 bar, food 및 establishment로 지정할 수도 있습니다.

유형별 필터링

기본 유형별로 장소를 필터링하려면 요청에서 includedPrimaryTypes 및 excludedPrimaryTypes를 사용하세요. 필터는 장소의 기본 유형에만 적용됩니다. 예를 들어 restaurant의 includedPrimaryTypes 필터는 주로 음식점으로 기능하는 장소만 반환합니다.

기본 유형과 보조 유형으로 장소를 필터링하려면 요청에서 includedTypes 및 excludedTypes를 사용하세요. 필터는 두 유형 모두에 적용됩니다. 예를 들어 includedTypes가 bar인 경우 기본 유형 또는 보조 유형이 bar인 장소를 반환합니다.