PLACES_COUNT_PER_TYPE 함수

PLACES_COUNT_PER_TYPE 함수는 함수에 지정된 각 장소 유형의 개수 테이블을 반환합니다. 예를 들어 doctor, hospital, pharmacy 유형을 검색하면 각 유형에 대한 별도의 행이 포함된 테이블이 응답에 포함됩니다.

PLACES_COUNT_PER_TYPE 함수는 테이블을 반환하므로 FROM 절을 사용하여 호출합니다.

• 입력 매개변수:

  • 필수: 검색 영역을 지정하는 geography 필터 매개변수입니다. geography 매개변수는 점, 유도선, 다각형을 지원하는 BigQuery GEOGRAPHY 데이터 유형으로 정의된 값을 사용합니다.

    뷰포트, 선과 같은 다양한 유형의 검색 지리정보를 사용하는 예는 PLACES_COUNT 함수를 참고하세요.

  • 필수: 검색할 장소 유형을 지정하는 types 필터 매개변수입니다.

  • 선택사항: 검색을 세부적으로 조정하는 추가 필터 매개변수입니다.

• 반환:

• types 값당 하나의 행이 있는 테이블 이 테이블에는 type (STRING), count (INT64), sample_place_ids(ARRAY<STRING>) 열이 포함되어 있으며, 여기서 sample_place_ids에는 각 type에 최대 250개의 장소 ID가 포함됩니다.

예: 레스토랑, 카페, 바의 개수 반환

이 예에서는 뉴욕시의 다각형으로 정의된 지정된 검색 영역에서 운영 중인 모든 레스토랑, 카페, 바를 검색합니다.

types 매개변수는 검색할 장소 유형을 지정하는 STRING 값의 배열을 사용합니다. 가능한 값의 전체 목록은 장소 유형의 표 A와 표 B를 참고하세요.

이 예에서는 BigQuery ST_GEOGFROMTEXT 함수를 사용하여 다각형에서 GEOGRAPHY 값을 반환합니다.

DECLARE geo GEOGRAPHY;
SET geo = ST_GEOGFROMTEXT('''POLYGON((-73.985708 40.75773,-73.993324 40.750298,
                                      -73.9857 40.7484,-73.9785 40.7575,
                                      -73.985708 40.75773))''');  -- NYC viewport

SELECT * FROM `maps-platform-analytics-hub.sample_places_insights_us.PLACES_COUNT_PER_TYPE`(
  JSON_OBJECT(
      'types', ["restaurant", "cafe", "bar"],
      'geography', geo,
      'business_status', ['OPERATIONAL']
      )
);

이 함수는 유형별로 하나씩 세 개의 행이 있는 테이블을 반환합니다.