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.

Comme la fonction PLACES_COUNT_PER_TYPE renvoie un tableau, appelez-la à l'aide d'une clause FROM.

• Paramètres d'entrée :

  • Obligatoire : geography paramètre de filtre qui spécifie la zone de recherche. Le paramètre geography prend une valeur définie par le type de données BigQuery GEOGRAPHY , qui accepte les points, les chaînes de lignes et les polygones.

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

  • Obligatoire : 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 :

  • Un tableau avec une ligne par valeur types. Le tableau contient les colonnes type (STRING), count (INT64) et place_ids (ARRAY<STRING>), où 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 prend 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 `PROJECT_NAME.places_insights___us.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 :

Exemple : Renvoyer les décomptes par type filtrés par marque

L'exemple suivant utilise le filtre brand_ids pour récupérer les décomptes de types pour des marques spécifiques, telles que Starbucks avec l'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']
      )
);