Função PLACES_COUNT_PER_TYPE

A função PLACES_COUNT_PER_TYPE retorna uma tabela de contagens para cada tipo de lugar especificado na função. Por exemplo, se você pesquisar os tipos doctor, hospital e pharmacy, a resposta vai conter uma tabela com uma linha separada para cada tipo.

Como a função PLACES_COUNT_PER_TYPE retorna uma tabela, chame-a usando uma cláusula FROM.

• Parâmetros de entrada:

  • Obrigatório: O geography parâmetro de filtro que especifica a área de pesquisa. O parâmetro geography usa um valor definido pelo tipo de dados GEOGRAPHY do BigQuery, que oferece suporte a pontos, linhas e polígonos.

    Para exemplos de uso de diferentes tipos de regiões geográficas de pesquisa, como janelas de visualização e linhas, consulte a PLACES_COUNT função.

  • Obrigatório: o types parâmetro de filtro que especifica os tipos de lugar a serem pesquisados.

  • Opcional: outros parâmetros de filtro para refinar a pesquisa.

• Retorna:

  • Uma tabela com uma linha por valor de types. A tabela contém as colunas type (STRING), count (INT64) e place_ids (ARRAY<STRING>), em que place_ids contém até 250 IDs de lugar para cada type.

Exemplo: retornar a contagem de restaurantes, cafés e bares

Neste exemplo, você pesquisa todos os restaurantes, cafés e bares em funcionamento na área de pesquisa especificada, definida como um polígono na cidade de Nova York.

O parâmetro types usa uma matriz de valores STRING que especificam os tipos de lugar a serem pesquisados. Para conferir a lista completa de valores possíveis, consulte Tipos de lugar.

Este exemplo também usa a função ST_GEOGFROMTEXT do BigQuery para retornar um valor GEOGRAPHY de um polígono.

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 `PROJECT_NAME.places_insights___us.PLACES_COUNT_PER_TYPE`(
  JSON_OBJECT(
      'types', ["restaurant", "cafe", "bar"],
      'geography', geo,
      'business_status', ['OPERATIONAL']
      )
);

Essa função retorna uma tabela com três linhas, uma por tipo:

Exemplo: retornar contagens por tipo filtradas por marca

O exemplo a seguir usa o filtro brand_ids para recuperar contagens de tipos de marcas específicas, como a Starbucks com o ID "1413758728321880760":

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 `PROJECT_NAME.places_insights___us.PLACES_COUNT_PER_TYPE`(
  JSON_OBJECT(
      'types', ["cafe", "restaurant"],
      'geography', geo,
      'brand_ids', ["1413758728321880760"], -- Filter for Starbucks
      'business_status', ['OPERATIONAL']
      )
);