Fonction PLACES_COUNT_PER_TYPE

La fonction PLACES_COUNT_PER_TYPE renvoie un tableau de décomptes pour chaque type de lieu spécifié dans la fonction. Par exemple, si vous recherchez les types doctor, hospital et pharmacy, la réponse contient un tableau avec une ligne distincte pour chaque type.

Étant donné que la fonction PLACES_COUNT_PER_TYPE renvoie une table, appelez-la à l'aide d'une clause FROM.

• Paramètres d'entrée :

  • Obligatoire : le paramètre de filtre geography qui spécifie la zone de recherche. Le paramètre geography accepte une valeur définie par le type de données BigQuery GEOGRAPHY, qui est compatible avec les points, les linestrings et les polygones.

    Pour obtenir des exemples d'utilisation de différents types de zones géographiques de recherche, telles que des fenêtres d'affichage et des lignes, consultez la fonction PLACES_COUNT.

  • Obligatoire : le paramètre de filtre types qui spécifie les types de lieux à rechercher.

  • Facultatif : paramètres de filtre supplémentaires pour affiner votre recherche.

• Renvoie :

  • Table comportant une ligne par valeur types. La table contient les colonnes type (STRING), count (INT64) et sample_place_ids (ARRAY<STRING>), où sample_place_ids contient jusqu'à 250 ID de lieux pour chaque type.

Exemple : renvoyer le nombre de restaurants, de cafés et de bars

Dans cet exemple, vous recherchez tous les restaurants, cafés et bars ouverts dans la zone de recherche spécifiée, définie comme un polygone à New York.

Le paramètre types accepte un tableau de valeurs STRING spécifiant les types de lieux à rechercher. Pour obtenir la liste complète des valeurs possibles, consultez Types de lieux.

Cet exemple utilise également la fonction BigQuery ST_GEOGFROMTEXT pour renvoyer une valeur GEOGRAPHY à partir d'un polygone.

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']
      )
);

Cette fonction renvoie un tableau avec trois lignes, une par type :