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 값의 배열을 사용합니다. 가능한 값의 전체 목록은 장소 유형을 참고하세요.

이 예에서는 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 `places_insights___us___sample.PLACES_COUNT_PER_TYPE`(
  JSON_OBJECT(
      'types', ["restaurant", "cafe", "bar"],
      'geography', geo,
      'business_status', ['OPERATIONAL']
      )
);

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