Função PLACES_COUNT_PER_TYPE

A função PLACES_COUNT_PER_TYPE retorna uma tabela de contagens para cada tipo de lugar especificado para a 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 parâmetro de filtro geography que especifica a área de pesquisa. O parâmetro geography usa um valor definido pelo tipo de dados GEOGRAPHY do BigQuery, que aceita pontos, cadeias de 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 função PLACES_COUNT.

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

  • Opcional: outros parâmetros de filtro para refinar sua 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 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: