PLACES_COUNT_PER_TYPE-Funktion

Die Funktion PLACES_COUNT_PER_TYPE gibt eine Tabelle mit der Anzahl für jeden Ortstyp zurück, der für die 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 Parameter geography akzeptiert einen Wert, der durch den BigQuery-Datentyp GEOGRAPHY definiert wird. Dieser unterstützt Punkte, Linienzüge und Polygone.

      Beispiele für die Verwendung verschiedener Arten von Suchgebieten, z. B. Viewports und Linien, finden Sie unter PLACES_COUNT-Funktion.

    • Erforderlich: Der types-Filterparameter, mit dem die Ortstypen angegeben werden, nach denen gesucht werden soll.

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

  • Liefert:

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

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

In diesem Beispiel suchen Sie nach allen Restaurants, Cafés und Bars im angegebenen Suchgebiet, das als Polygon in New York City definiert ist.

Für den Parameter types kann ein Array von STRING-Werten angegeben werden, die die Ortstypen angeben, nach denen gesucht werden soll. Eine vollständige Liste der möglichen Werte finden Sie in Tabelle A und Tabelle B unter Ortstypen.

In diesem Beispiel wird auch die BigQuery-Funktion ST_GEOGFROMTEXT verwendet, um einen GEOGRAPHY-Wert 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 `maps-platform-analytics-hub.sample_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 für jeden Typ:

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