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.

Remarque : Si vous spécifiez ces trois mêmes types pour la fonction PLACES_COUNT, PLACES_COUNT renvoie une seule valeur contenant le nombre combiné pour les trois types.

Comme 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 GEOGRAPHY BigQuery, 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 les fenêtres d'affichage et les 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 place_ids (ARRAY<STRING>), où place_ids contient jusqu'à 250 ID de lieux pour chaque type.

    Remarque : Le tableau renvoyé contient une ligne par valeur types. Vous pouvez utiliser primary_types comme filtre, mais les résultats ne sont regroupés que par types.

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 `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 comportant trois lignes, une par type :