请求参数

本文对 Places Insights API。我们将逐一介绍每种方法，并提供数据洞见和最佳建议 帮助您使用此工具来满足地理位置数据需求。

借助 Places Insights API，您可以执行多项关键功能：

  • 计算地点数：确定与特定查询字词相匹配的地点的数量 例如营业地点类型、营业状态、价位和评分。
  • 检索地点详情：获取符合 指定过滤条件，然后使用 Places API。
  • 灵活过滤：应用全面的过滤条件，获得精准的数据分析。 可用的过滤条件包括：
    • 地理区域（圆形、区域或自定义多边形）
    • 地点类型
    • 营业状态
    • 价位
    • 分级范围

必需参数

本部分介绍了向 Places Insights API。每个请求都必须提供以下信息：

  • 一种数据分析。
  • 位置过滤条件和类型过滤条件。

数据分析

指定要计算的数据分析类型。数据分析类型 支持：

  • INSIGHT_COUNT：返回符合过滤条件的地点数量。
  • INSIGHT_PLACES：返回符合过滤条件的地点 ID。

注意：如果选择此选项，Places Insights API 会返回地点 ID 仅当 count 不超过 100 时。

过滤

指定用于过滤地点的条件。您必须至少指定 LocationFilter和TypeFilter。

位置过滤条件

位置过滤条件可以是以下类型之一：

  • circle：将区域定义为具有中心和半径的圆。
  • region：将区域定义为区域。
  • custom_area：将区域定义为自定义多边形。
圆形

如果您选择以圆形表示的地理区域，则需要提供center 和 radius。中心可以是纬度和经度，也可以是地点 圆心的 ID。

  • 中心：
    • lat_lng：圆心的纬度和经度。纬度 必须是介于 -90 到 90 之间的数字（含 -90 和 90）。经度必须是数字 介于 -180（含）到 180（含）之间。
    • place：圆心的地点 ID。请注意， 位置。此字符串必须以 places/ 前缀开头。
  • radius：圆的半径（以米为单位）。此数字必须为正数。
区域

您可以使用 place 参数将区域定义为区域。使用地点 ID 代表某个地理区域（例如，由 多边形）。例如，佛罗里达州坦帕市的地点 ID 为 places/ChIJ4dG5s4K3wogRY7SWr4kTX6c。

不支持的区域类型
establishment place_of_worship
floor post_box
food postal_code_suffix
general_contractor room
geocode street_address
health street_number
intersection sublocality_level_5
landmark subpremise

您可以使用 Geocoding API 调用中的 types 字段来确定 与地点 ID 相关联的位置或地址的类型，例如它是否是 城市、社区或国家/地区。

自定义区域

使用坐标定义自定义多边形的面积。

您可以访问 https://geojson.io/ 绘制自定义多边形并 将这些坐标输入到请求中一个多边形必须至少包含 4 个 坐标，其中第一个坐标和最后一个坐标是相同的。除了 第一个坐标和最后一个坐标，不得有其他任何重复的坐标。 例如：

"coordinates":[
   {
      "latitude":37.776,
      "longitude":-122.666
   },
   {
      "latitude":37.130,
      "longitude":-121.898
   },
   {
      "latitude":37.326,
      "longitude":-121.598
   },
   {
      "latitude":37.912,
      "longitude":-122.247
   },
   {
      "latitude":37.776,
      "longitude":-122.666
   }
]

类型过滤条件

指定要包含或排除的地点类型。要同时获取 Places Insights API 支持的次要地点类型，请参阅表格 A“地点类型”指南（适用于 Places API） （新）。必须至少包含一个 included_types 或 included_primary_types 类型 已包含在内。

  • included_types：包含的地点类型的列表。
  • excluded_types：排除的地点类型列表。
  • included_primary_types：包含的主要地点类型的列表。
  • excluded_primary_types：排除的主要地点类型列表。

要详细了解类型过滤器和地点类型的工作原理，请访问有关类型的更多信息 过滤器。

可选参数

其余三个过滤条件是可选的：

  • operating_status：指定要包含或排除的地点的状态。 默认按 operating_status: OPERATING_STATUS_OPERATIONAL 过滤 （一个具体值）。
  • price_levels：指定地点的价位。默认为 no 过滤（结果中包含所有价位）。
  • rating_filter：指定地点的评分范围。默认值为 no 过滤（结果中包含所有评分）。

营业状态

根据运营状态（例如运营状态或临时状态）进行过滤 已关闭）。

价格水平

按价位（例如免费、中等或昂贵）进行过滤。

“评分”过滤器

根据平均用户评分过滤地点。这两个字段 可选属性，因此如果省略，它们也默认为包含地点 没有评分的广告

  • min_rating：最低平均用户评分（1.0 到 5.0 之间）。
  • max_rating：最高平均用户评分（1.0 到 5.0 之间）。