PLACES_COUNT_PER_TYPE-Funktion

Die Funktion PLACES_COUNT_PER_TYPE gibt eine Tabelle mit Zählungen für jeden Ortstyp zurück, der der Funktion angegeben wurde. Wenn Sie beispielsweise nach den Typen doctor, hospital und pharmacy suchen, enthält die Antwort eine Tabelle mit einer separaten Zeile für jeden Typ.

Da die Funktion PLACES_COUNT_PER_TYPE eine Tabelle zurückgibt, rufen Sie sie mit einer FROM-Klausel auf.

  • Eingabeparameter:

    • Erforderlich: Der geography Filterparameter, der den Suchbereich angibt. Der geography Parameter verwendet einen Wert der durch den BigQuery GEOGRAPHY Datentyp definiert wird. Dieser unterstützt Punkte, Linienzüge und Polygone.

      Beispiele für die Verwendung verschiedner Arten von Suchbereichen wie Viewports und Linien finden Sie unter PLACES_COUNT Funktion.

    • Erforderlich: Der types Filterparameter, der die zu suchenden Ortstypen angibt.

    • Optional: Zusätzliche Filterparameter, um die Suche einzugrenzen.

  • Liefert:

    • Eine Tabelle mit einer Zeile pro types-Wert. Die Tabelle enthält die Spalten type (STRING), count (INT64) und place_ids (ARRAY<STRING>), wobei place_ids bis zu 250 Orts-IDs für jeden type enthält.

Beispiel: Anzahl von Restaurants, Cafés und Bars zurückgeben

In diesem Beispiel suchen Sie nach allen geöffneten Restaurants, Cafés und Bars im angegebenen Suchbereich, der als Polygon in New York City definiert ist.

Der Parameter types verwendet ein Array von STRING-Werten, die die zu suchenden Ortstypen angeben. Die vollständige Liste der möglichen Werte finden Sie unter Ortstypen.

In diesem Beispiel wird auch die BigQuery ST_GEOGFROMTEXT Funktion verwendet, um einen GEOGRAPHYWert aus einem Polygon zurückzugeben.

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

Diese Funktion gibt eine Tabelle mit drei Zeilen zurück, eine pro Typ:

Ergebnisse für die Funktion „Places Count Type“ in New York City.