science Sản phẩm hoặc tính năng này đang trong giai đoạn Thử nghiệm (trước khi phát hành công khai). Các sản phẩm và tính năng chưa phát hành công khai có thể được hỗ trợ hạn chế và các thay đổi đối với các sản phẩm và tính năng chưa phát hành công khai có thể không tương thích với các phiên bản chưa phát hành công khai khác. Sản phẩm/dịch vụ ở giai đoạn trước khi phát hành rộng rãi tuân theo Điều khoản dành riêng cho dịch vụ của Nền tảng Google Maps. Để biết thêm thông tin, hãy xem nội dung mô tả về giai đoạn ra mắt. Đăng ký để thử nghiệm Thông tin chi tiết về địa điểm!
Sử dụng bộ sưu tập để sắp xếp ngăn nắp các trang
Lưu và phân loại nội dung dựa trên lựa chọn ưu tiên của bạn.
Hàm PLACES_COUNT_PER_TYPE trả về một bảng số lượt truy cập cho từng loại địa điểm được chỉ định cho hàm. Ví dụ: nếu bạn tìm kiếm các loại doctor, hospital và pharmacy, thì phản hồi sẽ chứa một bảng có một hàng riêng cho từng loại.
Vì hàm PLACES_COUNT_PER_TYPE trả về một bảng, hãy gọi hàm này bằng mệnh đề FROM.
Tham số đầu vào:
Bắt buộc: Tham số bộ lọcgeography chỉ định khu vực tìm kiếm. Tham số geography nhận một giá trị do kiểu dữ liệu BigQuery GEOGRAPHY xác định, hỗ trợ các điểm, chuỗi đường và đa giác.
Để xem ví dụ về cách sử dụng các loại khu vực địa lý tìm kiếm, chẳng hạn như khung hiển thị và đường kẻ, hãy xem hàm PLACES_COUNT.
Bắt buộc: Tham số bộ lọctypes chỉ định các loại địa điểm cần tìm.
Không bắt buộc: Các tham số bộ lọc bổ sung để tinh chỉnh nội dung tìm kiếm.
Trả về:
Một bảng có một hàng cho mỗi giá trị types. Bảng này chứa các cột type (STRING), count (INT64) và sample_place_ids (ARRAY<STRING>), trong đó sample_place_ids chứa tối đa 250 mã địa điểm cho mỗi type.
Ví dụ: Số lượt trả về của nhà hàng, quán cà phê và quán bar
Trong ví dụ này, bạn tìm kiếm tất cả nhà hàng, quán cà phê và quán bar đang hoạt động trong khu vực tìm kiếm được chỉ định, được xác định là một đa giác ở Thành phố New York.
Tham số types nhận một mảng các giá trị STRING chỉ định các loại địa điểm cần tìm kiếm. Để xem danh sách đầy đủ các giá trị có thể có, hãy xem Bảng A và Bảng B tại Các loại địa điểm.
Ví dụ này cũng sử dụng hàm BigQuery ST_GEOGFROMTEXT để trả về giá trị GEOGRAPHY từ một đa giác.
[null,null,["Cập nhật lần gần đây nhất: 2025-07-17 UTC."],[],[],null,["The `PLACES_COUNT_PER_TYPE` function returns a table of counts for each place\n**type** specified to the function. For example, if you search for the types\n`doctor`, `hospital`, and `pharmacy` the response contains a table with a\nseparate row for each type.\n| **Note:** If you specify these same three types to the `PLACES_COUNT` function, `PLACES_COUNT` returns a single value containing the combined count for all three types.\n\nBecause the `PLACES_COUNT_PER_TYPE` function returns a table, call it using a\n`FROM` clause.\n\n- Input parameters:\n\n - **Required** : The `geography` [filter parameter](/maps/documentation/placesinsights/experimental/filter-params) that\n specifies the search area. The `geography` parameter takes a value\n defined by the BigQuery\n [`GEOGRAPHY`](https://cloud.google.com/bigquery/docs/reference/standard-sql/data-types#geography_type)\n data type, which supports points, linestrings, and polygons.\n\n For examples of using different types of search geographies, such as\n viewports and lines, see [`PLACES_COUNT`\n function](/maps/documentation/placesinsights/experimental/places-count).\n - **Required** : The `types` [filter parameter](/maps/documentation/placesinsights/experimental/filter-params) that\n specifies the place types to search for.\n\n - **Optional** : Additional [filter](/maps/documentation/placesinsights/experimental/filter-params) parameters to refine\n your search.\n\n- Returns:\n\n - A table with one row per `types` value. The table contains the columns `type` (`STRING`) and `count` (`INT64`).\n\nExample: Return count of restaurant, cafes, and bars\n\nIn this example, you search for all operational restaurant, cafe, and bars in\nthe specified search area defined as a polygon in New York City.\n\nThe `types` parameter takes an array of `STRING` values specifying the place\ntypes to search for. For the complete list of possible values, see Table A and\nTable B at [Places types](/maps/documentation/places/web-service/place-types).\n\nThis example also uses the BigQuery\n[`ST_GEOGFROMTEXT`](https://cloud.google.com/bigquery/docs/reference/standard-sql/geography_functions#st_geogfromtext)\nfunction to return a `GEOGRAPHY` value from a polygon. \n\n```googlesql\nDECLARE geo GEOGRAPHY;\nSET geo = ST_GEOGFROMTEXT('''POLYGON((-73.985708 40.75773,-73.993324 40.750298,\n -73.9857 40.7484,-73.9785 40.7575,\n -73.985708 40.75773))'''); -- NYC viewport\n\nSELECT * FROM `maps-platform-analytics-hub.sample_places_insights_us.PLACES_COUNT_PER_TYPE`(\n JSON_OBJECT(\n 'types', [\"restaurant\", \"cafe\", \"bar\"],\n 'geography', geo,\n 'business_status', ['OPERATIONAL']\n )\n);\n```\n\nThis function returns a table with three rows, one per type:"]]